avoid_blog_page_permalink_collision( array $data, array $postarr )

Avoids a collision between a site slug and a permalink slug.

Description

In a subdirectory installation this will make sure that a site and a post do not use the same subdirectory by checking for a site with the same name as a new post.

Parameters

$data

(array) (Required) An array of post data.

$postarr

(array) (Required) An array of posts. Not currently used.

Return

(array) The new array of post data after checking for collisions.

Source

File: wp-admin/includes/ms.php 

function avoid_blog_page_permalink_collision( $data, $postarr ) {
	if ( is_subdomain_install() ) {
		return $data;
	}
	if ( 'page' !== $data['post_type'] ) {
		return $data;
	}
	if ( ! isset( $data['post_name'] ) || '' === $data['post_name'] ) {
		return $data;
	}
	if ( ! is_main_site() ) {
		return $data;
	}

	$post_name = $data['post_name'];
	$c         = 0;
	while ( $c < 10 && get_id_from_blogname( $post_name ) ) {
		$post_name .= mt_rand( 1, 10 );
		$c ++;
	}
	if ( $post_name != $data['post_name'] ) {
		$data['post_name'] = $post_name;
	}
	return $data;
}

Uses

Uses Description
wp-includes/functions.php: is_main_site()

Determine whether a site is the main site of the current network.
wp-includes/ms-load.php: is_subdomain_install()

Whether a subdomain configuration is enabled.
wp-includes/ms-blogs.php: get_id_from_blogname()

Retrieves a sites ID given its (subdomain or directory) slug.

Changelog

Version Description
3.0.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/avoid_blog_page_permalink_collision