ms_subdomain_constants

The timeline below displays how wordpress function ms_subdomain_constants has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 */
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(sprintf(
                /* translators: 1: VHOST, 2: SUBDOMAIN_INSTALL */
                __('<strong>Conflicting values for the constants %1$s and %2$s.</strong> The value of %2$s will be assumed to be your subdomain configuration setting.'),
                '<code>VHOST</code>',
                '<code>SUBDOMAIN_INSTALL</code>'
            ) . ' ' . $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');
    }
}

WordPress Version: 5.5

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 */
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');
    }
}

WordPress Version: 4.6

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 *
 * @staticvar bool $subdomain_error
 * @staticvar bool $subdomain_error_warn
 */
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');
    }
}

WordPress Version: 4.5

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 *
 * @staticvar bool $subdomain_error
 * @staticvar bool $subdomain_error_warn
 */
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', $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');
    }
}

WordPress Version: 4.3

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 *
 * @staticvar bool $subdomain_error
 * @staticvar bool $subdomain_error_warn
 */
function ms_subdomain_constants()
{
    static $subdomain_error = null;
    static $subdomain_error_warn = null;
    if (false === $subdomain_error) {
        return;
    }
    if ($subdomain_error) {
        $vhost_deprecated = __('The constant <code>VHOST</code> <strong>is deprecated</strong>. Use the boolean constant <code>SUBDOMAIN_INSTALL</code> in wp-config.php to enable a subdomain configuration. Use is_subdomain_install() to check whether a subdomain configuration is enabled.');
        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', $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');
    }
}

WordPress Version: 4.0

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 */
function ms_subdomain_constants()
{
    static $subdomain_error = null;
    static $subdomain_error_warn = null;
    if (false === $subdomain_error) {
        return;
    }
    if ($subdomain_error) {
        $vhost_deprecated = __('The constant <code>VHOST</code> <strong>is deprecated</strong>. Use the boolean constant <code>SUBDOMAIN_INSTALL</code> in wp-config.php to enable a subdomain configuration. Use is_subdomain_install() to check whether a subdomain configuration is enabled.');
        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', $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');
    }
}

WordPress Version: 3.7

/**
 * Defines Multisite subdomain constants and handles warnings and notices.
 *
 * 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.
 *
 * @since 3.0.0
 */
function ms_subdomain_constants()
{
    static $error = null;
    static $error_warn = false;
    if (false === $error) {
        return;
    }
    if ($error) {
        $vhost_deprecated = __('The constant <code>VHOST</code> <strong>is deprecated</strong>. Use the boolean constant <code>SUBDOMAIN_INSTALL</code> in wp-config.php to enable a subdomain configuration. Use is_subdomain_install() to check whether a subdomain configuration is enabled.');
        if ($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', $vhost_deprecated);
        }
        return;
    }
    if (defined('SUBDOMAIN_INSTALL') && defined('VHOST')) {
        if (SUBDOMAIN_INSTALL == ('yes' == VHOST)) {
            $error = true;
        } else {
            $error = $error_warn = true;
        }
    } elseif (defined('SUBDOMAIN_INSTALL')) {
        define('VHOST', SUBDOMAIN_INSTALL ? 'yes' : 'no');
    } elseif (defined('VHOST')) {
        $error = true;
        define('SUBDOMAIN_INSTALL', 'yes' == VHOST);
    } else {
        define('SUBDOMAIN_INSTALL', false);
        define('VHOST', 'no');
    }
}