__return_true() WP 3.0.0
Просто возвращает true. Вспомогательная функция WordPress.
Полезна для использования в фильтрах, чтобы вернуть true.
Все подобны функции:
__return_false() — возвращает логическое false.
__return_true() — возвращает логическое true.
__return_empty_array() — возвращает пустой массив: array().
__return_zero() — возвращает число 0.
__return_null() — возвращает NULL.
__return_empty_string() — возвращает пустую строку: ''.
Эта функция считается внутренней для использования самим ядром. Не рекомендуется использовать эту функцию в своем коде.
Хуков нет.
Возвращает
Логическое true.
Использование
__return_true();
Примеры
#1 Вернем true в фильтре
Допустим, у нас есть фильтр 'custom_menu_order' он отвечает за возможность произвольной сортировки административного меню, по умолчанию выключен. Нам нужно его включить, для этого пропишем такой код в functions.php или в плагин:
add_filter( 'custom_menu_order', '__return_true' );
Возможность сортировки включена, теперь можно отсортировать меню:
add_filter( 'menu_order', 'my_menu_order' );
function my_menu_order( $menu_order ) {
return array( 'index.php', 'edit.php', 'edit.php?post_type=page', 'edit-comments.php' );
}
#2 другие способы записать __return_true
// пример анонимной функции (php 5.3+)
add_filter( 'show_admin_bar', function(){ return true; } );
// или так, с регистрацией функции
add_filter( 'show_admin_bar', 'my_return_function' );
function my_return_function(){
return true;
}Заметки
- Смотрите: __return_false()
Список изменений
| С версии 3.0.0 | Введена. |
Код __return_true() return true WP 5.6.2
function __return_true() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
return true;
}