ms_subdomain_constants() WordPress Function
The ms_subdomain_constants() function is used to set up the constants used by WordPress when installed on a subdomain. This function will only work if the WordPress installation is on a subdomain of the main domain. The function defines the following constants: SUBDOMAIN_INSTALL: True DOMAIN_CURRENT_SITE: The domain of the WordPress installation PATH_CURRENT_SITE: The path of the WordPress installation SITE_ID_CURRENT_SITE: The site ID of the WordPress installation BLOG_ID_CURRENT_SITE: The blog ID of the WordPress installation
ms_subdomain_constants() #
Defines Multisite subdomain constants and handles warnings and notices.
Description
VHOST is deprecated in favor of SUBDOMAIN_INSTALL, which is a bool.
On first call, the constants are checked and defined. On second call, we will have translations loaded and can trigger warnings easily.
Source
File: wp-includes/ms-default-constants.php
function ms_subdomain_constants() { static $subdomain_error = null; static $subdomain_error_warn = null; if ( false === $subdomain_error ) { return; } if ( $subdomain_error ) { $vhost_deprecated = sprintf( /* translators: 1: VHOST, 2: SUBDOMAIN_INSTALL, 3: wp-config.php, 4: is_subdomain_install() */ __( 'The constant %1$s <strong>is deprecated</strong>. Use the boolean constant %2$s in %3$s to enable a subdomain configuration. Use %4$s to check whether a subdomain configuration is enabled.' ), '<code>VHOST</code>', '<code>SUBDOMAIN_INSTALL</code>', '<code>wp-config.php</code>', '<code>is_subdomain_install()</code>' ); if ( $subdomain_error_warn ) { trigger_error( __( '<strong>Conflicting values for the constants VHOST and SUBDOMAIN_INSTALL.</strong> The value of SUBDOMAIN_INSTALL will be assumed to be your subdomain configuration setting.' ) . ' ' . $vhost_deprecated, E_USER_WARNING ); } else { _deprecated_argument( 'define()', '3.0.0', $vhost_deprecated ); } return; } if ( defined( 'SUBDOMAIN_INSTALL' ) && defined( 'VHOST' ) ) { $subdomain_error = true; if ( SUBDOMAIN_INSTALL !== ( 'yes' === VHOST ) ) { $subdomain_error_warn = true; } } elseif ( defined( 'SUBDOMAIN_INSTALL' ) ) { $subdomain_error = false; define( 'VHOST', SUBDOMAIN_INSTALL ? 'yes' : 'no' ); } elseif ( defined( 'VHOST' ) ) { $subdomain_error = true; define( 'SUBDOMAIN_INSTALL', 'yes' === VHOST ); } else { $subdomain_error = false; define( 'SUBDOMAIN_INSTALL', false ); define( 'VHOST', 'no' ); } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.0.0 | Introduced. |