Функция add_comments_page() в WordPress с примерами.

Функция add_comments_page() в WordPress предназначена для добавления дочернего элемента и страницы к меню «Комментарии» в админ-панели. Эта функция позволяет разработчикам плагинов и тем интегрировать собственные страницы управления комментариями в стандартное меню WordPress, облегчая доступ к дополнительным инструментам и настройкам.

add_comments_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )

• $page_title (string) — Заголовок страницы, который отображается в браузере и в заголовке страницы в админ-панели.
• $menu_title (string) — Название пункта меню, которое будет отображаться в админ-панели WordPress.
• $capability (string) — Способность (capability), необходимая для доступа к этой странице. Например, manage_options для доступа администратора.
• $menu_slug (string) — Уникальный идентификатор для страницы меню, используемый в URL.
• $function (callable) — Функция, которая будет вызываться для отображения содержимого страницы. Если не указана, страница будет пустой.
• $position (int, опционально) — С версии 5.3.0. Приоритет вывода ссылки на страницу в меню. По умолчанию страница добавляется последней. Чем меньше значение, тем выше приоритет и раньше будет отображаться ссылка на вашу страницу.

Пример использования функции add_comments_page()

Для добавления страницы управления комментариями в админ-панель, вы можете использовать следующую реализацию:

<?php
// Хук для добавления страницы при инициализации
add_action( 'admin_menu', 'genius_custom_comments_page' );

function genius_custom_comments_page() {
    // Добавление страницы управления комментариями
    add_comments_page(
        'Мои комментарии',        // Заголовок страницы
        'Мои комментарии',        // Название пункта меню
        'manage_options',         // Способность для доступа
        'genius-custom-comments',    // Уникальный идентификатор для страницы
        'genius_custom_comments_page_callback' // Функция для отображения содержимого
    );
}

// Функция для отображения содержимого страницы
function genius_custom_comments_page_callback() {
    ?>
    <div class="wrap">
        <h1>Мои комментарии</h1>
        <p>Здесь вы можете управлять своими комментариями.</p>
        <!-- Дополнительный код для управления комментариями -->
    </div>
    <?php
}

Пояснение к коду

1. Хук admin_menu: Мы используем этот хук для добавления страницы в админ-панель при инициализации. Это гарантирует, что функция genius_custom_comments_page() будет вызвана в нужное время.
2. Функция genius_custom_comments_page(): Эта функция вызывает add_comments_page(), добавляя новую страницу в админ-панель. Параметры указывают заголовок страницы, название пункта меню, требуемую способность, уникальный идентификатор и функцию для отображения содержимого.
3. Функция genius_custom_comments_page_callback(): Эта функция выводит HTML-контент для страницы. Здесь вы можете добавить любой код, необходимый для управления комментариями.

Дополнительная информация

Функция add_comments_page() добавляет дочерний элемент в меню «Комментарии», что аналогично работе функции add_submenu_page(), но с первым параметром $parent_slug, установленным в edit-comments.php.

Хотя использование add_comments_page() может показаться редким, так как чаще применяются функции add_options_page() или add_submenu_page(), она остается полезным инструментом для специфичных случаев, когда необходимо создать дочернюю страницу в меню «Комментарии».

Заключение

Функция add_comments_page() предоставляет разработчикам WordPress гибкий инструмент для добавления пользовательских страниц в меню управления комментариями. Это позволяет улучшить функциональность вашего плагина или темы, обеспечивая удобный доступ к дополнительным инструментам и настройкам.