wp_normalize_site_data( array $data ): array
Normalizes data for a site prior to inserting or updating in the database.
Parameters
-
$data
array Required -
Associative array of site data passed to the respective function.
See wp_insert_site() for the possibly included data.More Arguments from wp_insert_site( ... $data )
Data for the new site that should be inserted.
domain
stringSite domain. Default empty string.path
stringSite path. Default'/'
.network_id
intThe site's network ID. Default is the current network ID.registered
stringWhen the site was registered, in SQL datetime format. Default is the current time.last_updated
stringWhen the site was last updated, in SQL datetime format. Default is the value of $registered.public
intWhether the site is public. Default 1.archived
intWhether the site is archived. Default 0.mature
intWhether the site is mature. Default 0.spam
intWhether the site is spam. Default 0.deleted
intWhether the site is deleted. Default 0.lang_id
intThe site's language ID. Currently unused. Default 0.user_id
intUser ID for the site administrator. Passed to thewp_initialize_site
hook.title
stringSite title. Default is 'Site %d' where %d is the site ID. Passed to thewp_initialize_site
hook.options
arrayCustom option $key => $value pairs to use. Default empty array. Passed to thewp_initialize_site
hook.meta
arrayCustom site metadata $key => $value pairs to use. Default empty array.
Passed to thewp_initialize_site
hook.
Return
array Normalized site data.
Source
File: wp-includes/ms-site.php
.
View all references
function wp_normalize_site_data( $data ) {
// Sanitize domain if passed.
if ( array_key_exists( 'domain', $data ) ) {
$data['domain'] = trim( $data['domain'] );
$data['domain'] = preg_replace( '/\s+/', '', sanitize_user( $data['domain'], true ) );
if ( is_subdomain_install() ) {
$data['domain'] = str_replace( '@', '', $data['domain'] );
}
}
// Sanitize path if passed.
if ( array_key_exists( 'path', $data ) ) {
$data['path'] = trailingslashit( '/' . trim( $data['path'], '/' ) );
}
// Sanitize network ID if passed.
if ( array_key_exists( 'network_id', $data ) ) {
$data['network_id'] = (int) $data['network_id'];
}
// Sanitize status fields if passed.
$status_fields = array( 'public', 'archived', 'mature', 'spam', 'deleted' );
foreach ( $status_fields as $status_field ) {
if ( array_key_exists( $status_field, $data ) ) {
$data[ $status_field ] = (int) $data[ $status_field ];
}
}
// Strip date fields if empty.
$date_fields = array( 'registered', 'last_updated' );
foreach ( $date_fields as $date_field ) {
if ( ! array_key_exists( $date_field, $data ) ) {
continue;
}
if ( empty( $data[ $date_field ] ) || '0000-00-00 00:00:00' === $data[ $date_field ] ) {
unset( $data[ $date_field ] );
}
}
return $data;
}
Changelog
Version | Description |
---|---|
5.1.0 | Introduced. |