Описание функции wp_add_dashboard_widget()
Функция wp_add_dashboard_widget() позволяет разработчикам добавлять пользовательские виджеты на панель управления WordPress. Это позволяет расширять функциональность панели, предоставляя администратору доступ к важной информации или действиям непосредственно на главной странице админки.
Функция используется в контексте разработки тем и плагинов, чтобы улучшить пользовательский интерфейс администрирования
Параметры
$widget_id
Тип: string
Обязательный: Да
Описание: Уникальный идентификатор виджета
Возможные значения:
$widget_name
Тип: string
Обязательный: Да
Описание: Название виджета, отображаемое в интерфейсе
Возможные значения:
$callback
Тип: callable
Обязательный: Да
Описание: Функция обратного вызова, которая выводит содержимое виджета
Возможные значения:
$control_callback
Тип: callable
Обязательный: Нет
По умолчанию: null
Описание: Функция обратного вызова для управления виджетом (необязательно)
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
• Функция успешно добавляет виджет в панель управления
• В случае ошибок, таких как дублирование widget_id, будет вызвано предупреждение
Примеры использования
Добавление простого виджета на панель управления
wp_add_dashboard_widget('my_custom_widget', 'Мой пользовательский виджет', 'my_widget_content');
function my_widget_content() {
echo 'Содержимое виджета';
}
Виджет будет отображать текст ‘Содержимое виджета’
Добавление виджета с функцией управления
wp_add_dashboard_widget('my_custom_widget', 'Управляемый виджет', 'my_widget_content');
function my_widget_content() {
echo 'Содержимое виджета';
}
function my_widget_control() {
// Код управления виджетом
}
Функция управления может содержать настройки виджета
Безопасность
Валидация входных данных: Необходимо проверять уникальность widget_id
Санитизация: Функции обратного вызова должны обрабатывать вывод данных
Рекомендации: Используйте esc_html() для вывода текстовых данных в виджете
— Связанные функции
Удаляет виджет с панели управления
Хук для настройки панели управления
— Примечания
– Ограничения
Необходимо избегать дублирования идентификаторов виджетов
– Частые проблемы
- Предупреждения о дублирующихся widget_id
- Некорректное отображение данных при ошибках в callback
