Совет Как

Советы сайта 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. Следование советам, приведенным в этой статье, поможет вам использовать его функции наиболее эффективно и безопасно.