Функция allow_subdomain_install() в WordPress: Назначение и Примеры

Функция allow_subdomain_install() в WordPress проверяет, возможна ли установка мультисайтовой сети на основе поддоменов. Она возвращает логическое значение (true или false), в зависимости от того, разрешена ли установка мультисайта с использованием поддоменов для текущей конфигурации.

allow_subdomain_install(): bool

Возвращаемое значение

• (bool) Возвращает true, если установка сети на поддоменах разрешена, и false — если нет.

В WordPress есть два основных типа структур мультисайтов:

1. Сеть на подкаталогах: Все сайты сети добавляются в виде подкаталогов основного домена. Например, если основной домен — example.com, то сайт в сети будет иметь адрес example.com/site1.
2. Сеть на поддоменах: Все сайты сети добавляются как поддомены основного домена, например, site1.example.com.

Функция allow_subdomain_install() помогает определить, может ли текущая установка WordPress поддерживать структуру сети на поддоменах.

Как работает функция

Функция allow_subdomain_install() проверяет, можно ли использовать поддомены для сети на основе нескольких условий:

• Основной URL сайта не содержит пути (например, https://example.com подходит, а https://example.com/blog — нет).
• Основной домен не является localhost.
• Основной домен не является IP-адресом (например, 127.0.0.1).

Если одно из условий не соблюдено, функция возвращает false, иначе — true.

Проверка возможности установки на поддоменах

Простой способ проверить, доступна ли установка мультисайта на поддоменах:

if (allow_subdomain_install()) {
    echo 'Установка сети на поддоменах разрешена!';
} else {
    echo 'Установка сети на поддоменах запрещена. Используйте структуру на подкаталогах.';
}

Логирование результатов проверки в консоль

При разработке или настройке мультисайта может быть полезно вывести результаты проверки в лог или консоль:

$is_subdomain_install_allowed = allow_subdomain_install();
error_log('Subdomain install allowed: ' . ($is_subdomain_install_allowed ? 'Yes' : 'No'));

Комбинирование с другими функциями WordPress

Функция allow_subdomain_install() может использоваться в сочетании с другими функциями, например, для отображения настройки в панели администратора:

add_action('admin_notices', function() {
    if (!allow_subdomain_install()) {
        echo '<div class="notice notice-warning"><p>Поддомены недоступны для текущей установки. Рекомендуется использовать подкаталоги.</p></div>';
    }
});

Этот пример добавляет уведомление в панели администратора, если структура сети на поддоменах недоступна.

Заключение

Функция allow_subdomain_install() — это удобный инструмент для проверки возможности установки мультисайтовой сети на поддоменах в WordPress. Она помогает заранее настроить структуру сети и избежать ошибок при установке.