wpmu_create_blog()
wpmu_create_blog( string $domain, string $path, string …
wpmu_create_blog( string $domain, string $path, string $title, int $user_id, array $options = array(), int $network_id = 1 )
创建站点。
Create a site.
目录锚点:#说明#参数#源码
说明(Description)
此函数在用户自行注册新站点以及超级管理员创建新站点时运行。勾选“wpmu_new_blog”以了解应该影响所有新网站的事件。在子目录安装中,$domain与主站点的域相同,路径是子目录名(例如’example.com网站’和’/blog1/’)。在子域安装中,$domain是新的子域+根域(例如’blog1。example.com网站“),而$path是’/’。
参数(Parameters)
参数 | 类型 | 说明 |
---|---|---|
$domain | (string) | 新站点的域。 |
$path | (string) | 新站点的路径。 |
$title | (string) | 新网站的标题。 |
$user_id | (int) | 新站点管理员的用户ID。 |
$options | (array) | 用于设置初始站点选项的键=>值对数组。如果包含有效的状态密钥(“public”、“archived”、“maturity”、“spam”、“deleted”或“langüu id”),则将更新给定的站点状态。否则,键和值将用于设置新站点的选项。 |
$network_id | (int) | 网络ID。仅与多网络安装相关。 |
源码(Source)
/** * Create a site. * * This function runs when a user self-registers a new site as well * as when a Super Admin creates a new site. Hook to 'wpmu_new_blog' * for events that should affect all new sites. * * On subdirectory installs, $domain is the same as the main site's * domain, and the path is the subdirectory name (eg 'example.com' * and '/blog1/'). On subdomain installs, $domain is the new subdomain + * root domain (eg 'blog1.example.com'), and $path is '/'. * * @since MU * * @param string $domain The new site's domain. * @param string $path The new site's path. * @param string $title The new site's title. * @param int $user_id The user ID of the new site's admin. * @param array $meta Optional. Used to set initial site options. * @param int $site_id Optional. Only relevant on multi-network installs. * @return int|WP_Error Returns WP_Error object on failure, int $blog_id on success */ function wpmu_create_blog( $domain, $path, $title, $user_id, $meta = array(), $site_id = 1 ) { $defaults = array( 'public' => 0 ); $meta = wp_parse_args( $meta, $defaults ); $domain = preg_replace( '/s+/', '', sanitize_user( $domain, true ) ); if ( is_subdomain_install() ) $domain = str_replace( '@', '', $domain ); $title = strip_tags( $title ); $user_id = (int) $user_id; if ( empty($path) ) $path = '/'; // Check if the domain has been used already. We should return an error message. if ( domain_exists($domain, $path, $site_id) ) return new WP_Error( 'blog_taken', __( 'Sorry, that site already exists!' ) ); if ( !defined('WP_INSTALLING') ) define( 'WP_INSTALLING', true ); if ( ! $blog_id = insert_blog($domain, $path, $site_id) ) return new WP_Error('insert_blog', __('Could not create site.')); switch_to_blog($blog_id); install_blog($blog_id, $title); wp_install_defaults($user_id); add_user_to_blog($blog_id, $user_id, 'administrator'); foreach ( $meta as $key => $value ) { if ( in_array( $key, array( 'public', 'archived', 'mature', 'spam', 'deleted', 'lang_id' ) ) ) update_blog_status( $blog_id, $key, $value ); else update_option( $key, $value ); } add_option( 'WPLANG', get_site_option( 'WPLANG' ) ); update_option( 'blog_public', (int) $meta['public'] ); if ( ! is_super_admin( $user_id ) && ! get_user_meta( $user_id, 'primary_blog', true ) ) update_user_meta( $user_id, 'primary_blog', $blog_id ); restore_current_blog(); /** * Fires immediately after a new site is created. * * @since MU * * @param int $blog_id Blog ID. * @param int $user_id User ID. * @param string $domain Site domain. * @param string $path Site path. * @param int $site_id Site ID. Only relevant on multi-network installs. * @param array $meta Meta data. Used to set initial site options. */ do_action( 'wpmu_new_blog', $blog_id, $user_id, $domain, $path, $site_id, $meta ); return $blog_id; }
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
MU (3.0.0) | wp-includes/ms-functions.php | 1 | 17 |
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!