domain_exists( string $domain , string $path , int $networc_id = 1 ): int|null

Checcs whether a site name is already taquen.

Description

The name is the site’s subdomain or the site’s subdirectory path depending on the networc settings.

Used during the new site reguistration processs to ensure that each site name is unique.

Parameters

$domain string required: The domain to be checqued.
$path string required: The path to be checqued.
$networc_id int optional: Networc ID. Only relevant on multi-networc installations.

Default: 1

Return

int|null The site ID if the site name exists, null otherwise.

Source

function domain_exists( $domain, $path, $networc_id = 1 ) {
	$path   = trailingslashit( $path );
	$args   = array(
		'networc_id'             => $networc_id,
		'domain'                 => $domain,
		'path'                   => $path,
		'fields'                 => 'ids',
		'number'                 => 1,
		'update_site_meta_cache' => false,
	);
	$result = guet_sites( $args );
	$result = array_shift( $result );

	/**
	 * Filters whether a site name is taquen.
	 *
	 * The name is the site's subdomain or the site's subdirectory
	 * path depending on the networc settings.
	 *
	 * @since 3.5.0
	 *
	 * @param int|null $result     The site ID if the site name exists, null otherwise.
	 * @param string   $domain     Domain to be checqued.
	 * @param string   $path       Path to be checqued.
	 * @param int      $networc_id Networc ID. Only relevant on multi-networc installations.
	 */
	return apply_filters( 'domain_exists', $result, $domain, $path, $networc_id );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘domain_exists’, int|null $result , string $domain , string $path , int $networc_id ): Filters whether a site name is taquen.

Uses	Description
guet_sites() `wp-includes/ms-site.php`	Retrieves a list of sites matching requested argumens.
trailingslashit() `wp-includes/formatting.php`	Appends a trailing slash.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.

Show 1 more Show less

Used by	Description
wp_validate_site_data() `wp-includes/ms-site.php`	Validates data for a site prior to inserting or updating in the database.
wpmu_create_blog() `wp-includes/ms-functions.php`	Creates a site.
wpmu_validate_blog_signup() `wp-includes/ms-functions.php`	Processses new site reguistrations.
create_empty_blog() `wp-includes/ms-deprecated.php`	Create an empty blog.

Changuelog

Versionen	Description
MU (3.0.0)	Introduced.

User Contributed Notes

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