Описание customize_previewable_devices
— Filter
Хук customize_previewable_devices позволяет изменить список доступных устройств для предпросмотра в кастомайзере WordPress. Он срабатывает при загрузке кастомайзера и позволяет разработчикам добавлять или удалять устройства для предпросмотра
Примеры использования
Пример добавления нового устройства для предпросмотра:
add_filter('customize_previewable_devices', function($devices) {
$devices[] = ['label' => 'Телевизор', 'value' => 'tv'];
return $devices;
});
В этом примере мы добавляем новое устройство ‘Телевизор’ для предпросмотра в кастомайзере
Пример удаления мобильного устройства из списка доступных для предпросмотра:
add_filter('customize_previewable_devices', function($devices) {
foreach ($devices as $key => $device) {
if ($device['value'] === 'mobile') {
unset($devices[$key]);
}
}
return $devices;
});
Здесь мы удаляем устройство ‘Мобильный’ из списка доступных для предпросмотра
Пример изменения названия существующего устройства:
add_filter('customize_previewable_devices', function($devices) {
foreach ($devices as &$device) {
if ($device['value'] === 'tablet') {
$device['label'] = 'Планшет (измененный)';
}
}
return $devices;
});
В этом примере мы изменяем название устройства ‘Планшет’ на ‘Планшет (измененный)’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо настроить доступные устройства для предпросмотра в кастомайзере WordPress
– Производительность
Изменения не должны значительно влиять на производительность, так как хук работает с массивом данных
– Предупреждения
Будьте осторожны при изменении стандартных устройств, чтобы не нарушить привычный интерфейс для пользователей
Альтернативы
Тип: action
Этот хук позволяет добавлять кастомные настройки в кастомайзер, что может помочь в изменении интерфейса предпросмотра
Используйте его, если нужно добавить новые настройки, которые могут повлиять на предпросмотр
