add_site_meta() — это функция в WordPress, которая добавляет новое метаполе к указанному сайту в многосайтовой сети (Multisite Network). Метаполя сайтов используются для хранения дополнительной информации о сайтах, такой как настройки, пользовательские данные и метаданные.
add_site_meta( $site_id, $meta_key, $meta_value, $unique )- $site_id (int): ID сайта, к которому добавляется метаполе.
- $meta_key (string): Уникальный ключ метаполя.
- $meta_value (mixed): Значение метаполя.
- $unique (bool, необязательный): Опциональный параметр, указывающий, следует ли предотвращать добавление дублирующихся значений. По умолчанию
false.
Зачем использовать add_site_meta()?
- Позволяет добавлять пользовательские данные к сайтам, такие как настройки, пользовательские данные и метаданные.
- Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для сайтов в сети.
- Используется для управления сайтами и добавления дополнительной информации для модерации и отображения.
Примеры использования
Добавление кастомного поля к сайту
Добавим кастомное поле с уникальным ключом и значением к сайту.
$site_id = 1; // ID сайта
$meta_key = 'admin_email';
$meta_value = '[email protected]';
add_site_meta( $site_id, $meta_key, $meta_value );Этот код добавляет кастомное поле с ключом ‘admin_email’ и значением ‘[email protected]‘ к сайту с ID 1.
Использование в темах и плагинах
Функция add_site_meta() часто используется в разработке тем и плагинов для добавления и хранения дополнительной информации о сайтах в сети, что делает её мощным инструментом для расширения функциональности WordPress.
Сохранение метаданных сайта из формы
Рассмотрим пример, когда данные добавляются из формы в плагине или теме:
function save_custom_site_meta( $site_id ) {
if ( isset( $_POST['custom_field'] ) ) {
$custom_field_value = sanitize_text_field( $_POST['custom_field'] );
add_site_meta( $site_id, 'custom_field_key', $custom_field_value );
}
}
add_action( 'network_admin_edit_site', 'save_custom_site_meta' );Этот код сохраняет данные, отправленные из формы в сетевой админке, в качестве кастомного поля у нового или отредактированного сайта.
Заключение
Функция add_site_meta() предоставляет разработчикам WordPress мощный инструмент для добавления и хранения дополнительной информации о сайтах в сети. Правильное использование add_site_meta() помогает создавать более функциональные и гибкие темы и плагины, улучшая управление сайтами и пользовательский опыт в многосайтовой сети WordPress.