get_subdirectory_reserved_names(): string[]

Retrieves a list of reserved site on a sub-directory Multisite installation.

Contents

Return

string[] Array of reserved names.

Top ↑

Source

File: wp-includes/ms-functions.php. View all references 

function get_subdirectory_reserved_names() {
	$names = array(
		'page',
		'comments',
		'blog',
		'files',
		'feed',
		'wp-admin',
		'wp-content',
		'wp-includes',
		'wp-json',
		'embed',
	);

	/**
	 * Filters reserved site names on a sub-directory Multisite installation.
	 *
	 * @since 3.0.0
	 * @since 4.4.0 'wp-admin', 'wp-content', 'wp-includes', 'wp-json', and 'embed' were added
	 *              to the reserved names list.
	 *
	 * @param string[] $subdirectory_reserved_names Array of reserved names.
	 */
	return apply_filters( 'subdirectory_reserved_names', $names );
}

View on Trac View on GitHub

Top ↑

Hooks

Top ↑

Top ↑

Uses

Uses
Uses Description
apply_filters() wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Top ↑

Changelog

Changelog
Version Description
4.4.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Daniyal Ahmed (a11n) —

    Allow “/blog” in multsite network :

    function mod_subdirectory_reserved_names() {
    $names = array(
        'page', 'comments', 'files', 'feed', 'wp-admin',
        'wp-content', 'wp-includes', 'wp-json', 'embed'
    );
}
add_filter( "subdirectory_reserved_names", "mod_subdirectory_reserved_names");
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Kolya Korobochkin —

    Here is better solution to modify this list of reserved names. Solution by daniyalahmedk not working for 2 reasons:

    1. The function not returning anything. There is no return state in the function and WordPress get null as result of this function (not array with words).
    2. Function not accepting args. This means all other plugins/code changes will be replaced.
    /**
 * Modify reserved names for sites.
 *
 * @param $names array List of reserved names for sites.
 *
 * @return array Updated list of reserved names for sites.
 */
function change_subdirectory_reserved_names( $names ) {
	$position = array_search( 'blog', $names );

	if( $position ) {
		unset( $names[$position] );
	}

	return $names;
}
add_filter( 'subdirectory_reserved_names', 'change_subdirectory_reserved_names' );

You must log in before being able to contribute a note or feedback.