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
Використання не знайдено.