__return_true() полезна в тех случаях, когда для работы фильтра или хука требуется вернуть значение true. С ее помощью можно сократить код, просто передавая эту функцию в фильтр без необходимости создавать дополнительную функцию с возвратом true.
__return_true(): trueВозвращаемое значение
- true: функция возвращает логическое
true.
Пример 1: Включение возможности сортировки меню в административной панели
Допустим, нужно включить произвольную сортировку административного меню, используя фильтр custom_menu_order, который по умолчанию отключен. Мы можем активировать сортировку, добавив следующий код в functions.php:
add_filter('custom_menu_order', '__return_true');
После этого порядок меню можно настроить, используя другой фильтр menu_order:
add_filter('menu_order', 'my_custom_menu_order');
function my_custom_menu_order($menu_order) {
return array('index.php', 'edit.php', 'edit.php?post_type=page', 'upload.php');
}
Этот код устанавливает порядок пунктов меню, начиная с панели управления и продолжая страницами, записями и медиафайлами.
Пример 2: Отключение административной панели на фронтенде
Чтобы скрыть административную панель для неадминистраторов на фронтенде сайта, используйте фильтр show_admin_bar, возвращая true для администраторов. Если вы хотите, чтобы панель отображалась только на определенных страницах, фильтр можно настроить так:
add_filter('show_admin_bar', '__return_true');
Пример 3: Активация функциональности, требующей true
Если требуется активировать функциональность, требующую логическое true, __return_true() обеспечивает более короткий и простой способ:
add_filter('custom_theme_support', '__return_true');
Альтернативные способы
__return_true() также можно заменить аналогичными способами для возврата true, например, при необходимости создания собственной функции или при использовании анонимной функции:
// Анонимная функция
add_filter('show_admin_bar', function() { return true; });
// Собственная функция обратного вызова
add_filter('show_admin_bar', 'return_true_function');
function return_true_function() {
return true;
}
Эти способы позволяют аналогично возвращать значение true, предоставляя гибкость при модификации логики фильтра.
Другие функции WordPress __return_*
В WordPress существует ряд аналогичных вспомогательных функций, позволяющих возвращать другие значения:
__return_false()— возвращаетfalse.__return_empty_array()— возвращает пустой массив[].__return_empty_string()— возвращает пустую строку"".__return_zero()— возвращает число0.__return_null()— возвращаетnull.
Заключение
Функция __return_true() — это полезный инструмент, который помогает легко возвращать значение true в фильтрах и хуках WordPress. Она упрощает код, улучшает его читаемость и позволяет сократить количество функций, необходимых для базовых задач, таких как активация или включение определенной функциональности.