__return_true() WP 3.0.0

Просто возвращает true. Вспомогательная функция WordPress.

Полезна для использования в фильтрах, чтобы вернуть true.

Хуков нет.

Возвращает

Логическое 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()

Список изменений

Код return true: wp-includes/functions.php ^{WP 5.4}

<?php
function __return_true() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
	return true;
}

Cвязанные функции

Из метки: __return (функции помощники)

Еще из раздела: Вспомогательные