Функция WP_ROBOTS() │ WP 5.7.0

Функция WP_ROBOTS() отвечает за отображение мета-тега robots, когда это необходимо. Она собирает инструкции для роботов, используя фильтр wp_robots. После этого инструкции очищаются, и мета-тег robots выводится, если есть хотя бы одна актуальная инструкция.

Хуки функции

• wp_robots

Возврат

Функция ничего не возвращает (null).

Использование

wp_robots();

Примеры

Пример 1: Добавление пользовательской инструкции в мета-тег robots

Этот пример демонстрирует, как добавить инструкцию follow к уже существующим инструкциям мета-тега robots.

Чтобы добавить свои собственные инструкции, вам необходимо использовать хук wp_robots. Он принимает массив, где ключом будет название инструкции, а значением — ее значение.

add_filter( 'wp_robots', 'my_wp_robots_add_follow' );

function my_wp_robots_add_follow( $robots ) {
    $robots['follow'] = true;

    return $robots;
}

Изменения в версии

• С версии 5.7.0 — введена функция.
• С версии 5.7.1 — больше не запрещает появление специфических инструкций вместе.

Код функции WP_ROBOTS()

Функция расположена в файле wp-includes/robots-template.php.

function wp_robots() {
    /**
     * Фильтрует инструкции, которые будут включены в мета-тег 'robots'.
     *
     * Мета-тег будет включен только при необходимости.
     *
     * @since 5.7.0
     *
     * @param array $robots Ассоциативный массив инструкций. Каждый ключ должен быть названием
     *                      инструкции, а соответствующее значение — это строка, которая будет
     *                      испо��ьзоваться как значение для инструкции, или логическое значение true,
     *                      если это логическая инструкция, то есть без значения.
     */
    $robots = apply_filters( 'wp_robots', array() );

    $robots_strings = array();
    foreach ( $robots as $directive => $value ) {
        if ( is_string( $value ) ) {
            // Если значение — это строка, добавляем его как значение для инструкции.
            $robots_strings[] = "{$directive}:{$value}";
        } elseif ( $value ) {
            // В противном случае добавляем инструкцию, если она истинна.
            $robots_strings[] = $directive;
        }
    }

    if ( empty( $robots_strings ) ) {
        return;
    }

    echo "n";
}

Другие связанные функции

• wp_old_slug_redirect()
• add_theme_support()
• bloginfo()
• body_class()
• current_theme_supports()
• get_custom_header_markup()
• get_custom_logo()
• get_header_image()
• get_header_image_tag()
• get_header_textcolor()
• get_header_video_url()
• get_page_template()
• get_page_templates()
• get_post_class()
• get_query_template()
• get_stylesheet()
• get_template()
• get_theme_mod()
• get_theme_mods()
• get_theme_root()
• has_custom_logo()
• has_header_image()
• has_header_video()
• header_image()
• is_child_theme()
• is_header_video_active()
• post_class()
• register_nav_menu()
• register_nav_menus()
• register_theme_directory()
• remove_theme_mod()
• remove_theme_mods()
• remove_theme_support()
• search_theme_directories()
• set_theme_mod()
• single_month_title()
• the_custom_header_markup()
• the_custom_logo()
• the_header_video_url()
• the_search_query()
• unregister_nav_menu()
• wp_body_open()
• wp_custom_css_cb()
• wp_footer()
• wp_get_archives()
• wp_get_document_title()
• wp_get_theme()
• wp_get_themes()
• wp_head()
• wp_is_mobile()
• wp_nav_menu()
• wp_site_icon()
• wp_title()

Теперь у вас есть четкое понимание функции WP_ROBOTS() и того, как ее использовать в своем проекте на WordPress!