customize_loaded_components
Дозволяє видалити базові компоненти Кастомайзера WordPress, наприклад, секції: меню, віджети.
Видалені з масиву назви секцій не будуть ініціалізовані в кастомайзері.
ВАЖЛИВО. Цей фільтр спрацьовує під час події ‘plugins_loaded’ , тому він повинен бути використаний у плагіні і не може бути використаний пізніше цієї події, наприклад, десь у файлі теми functions.php .
Використання
add_filter( 'customize_loaded_components', 'wp_kama_customize_loaded_components_filter', 10, 2); /** * Function for `customize_loaded_components` filter-hook. * * @param string[] $components Array of core components to load. * @param WP_Customize_Manager $manager WP_Customize_Manager instance. * * @return string[] */ function wp_kama_customize_loaded_components_filter( $components, $manager ){ // Filter... return $components; }
-
$components
(масив) Масив компонентів ядра, які потрібно підключити до кастомайзера.
Array ( [0] => widgets [1] => nav_menus )
-
$that
(WP_Customize_Manager) - Примірник WP_Customize_Manager.
Приклади
#1 Видалимо секції «віджети» та «меню» з налаштування (Customizer).
## Видаляє секції «віджети» та «меню» з налаштування (Customizer). add_filter( 'customize_loaded_components', 'remove_core_customizer_components' ); function remove_core_customizer_components( $components ){ foreach( [ 'nav_menus', 'widgets' ] as $key ){ $i = array_search($key, $components); if ( false !== $i ) unset($components[$i]); } return $components; }
список змін
З версії 4.4.0 | Введено. |
Де викликається хук
customize_loaded_components
Де використовується хук у WordPress
Використання не знайдено.