Советы сайта sovet-kak.ru: wp-includes/lib.php
Если вы занимаетесь разработкой сайтов на WordPress, то вы наверняка знакомы с файлом wp-includes/lib.php. Этот файл - очень важная часть ядра WordPress, отвечающая за множество функций.
Как использовать wp-includes/lib.php
Для начала вы должны знать, что подключать файл wp-includes/lib.php напрямую в своих скриптах нежелательно. Лучше всего воспользоваться функциями, предоставляемыми WordPress. Но если вам всё же необходим доступ к определенной функции из wp-includes/lib.php, то сделать это можно следующим образом:
if ( ! function_exists( 'название_функции' ) ) {
require_once ABSPATH . 'wp-includes/lib.php';
}
Примеры функций из wp-includes/lib.php
wp_parse_args()
Функция wp_parse_args() принимает на вход массив параметров и массив значений по умолчанию для этих параметров и возвращает новый массив, в котором значения по умолчанию заменены на значения из первого массива. Например:
$args = array(
'name' => 'John Doe',
'age' => 30,
);
$defaults = array(
'name' => 'Anonymous',
'age' => 0,
'sex' => 'unknown',
);
$args = wp_parse_args( $args, $defaults );
// $args теперь содержит следующие значения:
// array(
// 'name' => 'John Doe',
// 'age' => 30,
// 'sex' => 'unknown',
// );
wp_kses_post()
Функция wp_kses_post() принимает на вход строку и удаляет все HTML теги из нее, оставляя только текст и разрешенные атрибуты (например, href и src). Это полезно, если вы хотите дополнительно очистить текст, перед тем как его вывести на экран. Например:
$text = "<script>alert('Hello world!');</script>";
echo wp_kses_post( $text );
// на экран будет выведено:
// alert('Hello world!');
wp_filter_nohtml_kses()
Функция wp_filter_nohtml_kses() аналогична wp_kses_post(), но не разрешает использование HTML-атрибутов. Она полезна, если вы хотите оставить только текст и удалить все HTML-коды полностью. Например:
$text = "<p>Hello world!</p><a href='http://example.com'>Example</a>";
echo wp_filter_nohtml_kses( $text );
// на экран будет выведено:
// Hello world!Example
Заключение
Сам wp-includes/lib.php очень большой файл, содержащий множество функций, необходимых для корректной работы WordPress. Следование советам, приведенным в этой статье, поможет вам использовать его функции наиболее эффективно и безопасно.