Описание pre_get_sites
— Filter
Хук pre_get_sites позволяет модифицировать запрос, который получает список сайтов в мультисайтовой установке WordPress. Он срабатывает перед выполнением запроса и позволяет изменять параметры запроса, что может быть полезно для настройки отображения сайтов
Примеры использования
Пример фильтрации сайтов по домену:
add_filter('pre_get_sites', function($query) {
$query->domain = 'example.com';
return $query;
});
В этом примере мы фильтруем сайты, чтобы получить только те, которые находятся на домене ‘example.com’.
Пример изменения количества получаемых сайтов:
add_filter('pre_get_sites', function($query) {
$query->number = 5;
return $query;
});
Здесь мы изменяем запрос так, чтобы получать только 5 сайтов вместо стандартного значения.
Пример сортировки сайтов по ID:
add_filter('pre_get_sites', function($query) {
$query->orderby = 'id';
$query->order = 'ASC';
return $query;
});
В этом примере мы изменяем порядок получения сайтов, чтобы они сортировались по ID в порядке возрастания.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить параметры запроса для получения сайтов в мультисайтовой установке
– Производительность
Изменения, вносимые через этот хук, могут повлиять на производительность, если запросы становятся слишком сложными
– Предупреждения
Обратите внимание на то, чтобы изменения не нарушали логику работы мультисайтовой сети
Альтернативы
Тип: function
Функция, которая используется для получения сайтов, с возможностью передачи параметров напрямую
Используйте её для более быстрого получения сайтов, если вам не нужен фильтр
