Функция WP_INSTALL_DEFAULTS() │ WP 2.1.0
Функция wp_install_defaults() создает начальный контент для нового сайта на WordPress. С ее помощью добавляются такие элементы, как категории, записи и страницы.
Что добавляет эта функция?
- Категория "Без категории" (Uncategorized);
- Первая запись (с комментарием);
- Первая страница;
- Страница Политики конфиденциальности;
- Стандартные виджеты для темы по умолчанию.
Главная цель этой функции состоит в том, что вы можете переопределить ее в своем плагине, чтобы указать, какой контент добавлять на только что установленный сайт.
Глобальные переменные:
global $wpdb— объект базы данных WordPress.global $wp_rewrite— компонент перезаписи URL в WordPress.global $table_prefix— префикс таблиц базы данных.
Важные моменты
- Возвращает:
null— ничего (null).
Использование
wp_install_defaults( $user_id );
Параметры
$user_id(int) (обязательный) — ID пользователя.
Примеры
Пример 1: Опции по умолчанию для сайта
Этот пример показывает, как добавить опции по умолчанию на новый сайт. Для этого нужно создать плагин с следующим содержимым:
Замечания
- Глобальная переменная
global $wpdb— объект абстракции базы данных WordPress. - Глобальная переменная
global $wp_rewrite— компонент перезаписи URL. - Глобальная переменная
global $table_prefix— префикс таблиц базы данных.
Изменения
- С версии 2.1.0 — введена в WordPress.
Код функции wp_install_defaults()
Функция wp_install_defaults() на самом деле делает множество шагов для настройки нового сайта. Вот некоторые части кода:
function wp_install_defaults( $user_id ) {
global $wpdb, $wp_rewrite, $table_prefix;
// Добавление категории по умолчанию
$cat_name = __( 'Uncategorized' );
$cat_slug = sanitize_title( _x( 'Uncategorized', 'Default category slug' ) );
$cat_id = 1;
// Вставка категории в таблицы базы данных
$wpdb->insert(
$wpdb->terms,
array(
'term_id' => $cat_id,
'name' => $cat_name,
'slug' => $cat_slug,
'term_group' => 0,
)
);
$wpdb->insert(
$wpdb->term_taxonomy,
array(
'term_id' => $cat_id,
'taxonomy' => 'category',
'description' => '',
'parent' => 0,
'count' => 1,
)
);
$cat_tt_id = $wpdb->insert_id;
// Добавление первой записи
$now = current_time( 'mysql' );
$first_post = "n" . __( 'Welcome to WordPress. This is your first post. Edit or delete it, then start writing!' ) . "
n";
$wpdb->insert(
$wpdb->posts,
array(
'post_author' => $user_id,
'post_date' => $now,
'post_content' => $first_post,
'post_title' => __( 'Hello world!' ),
'post_type' => 'post',
'comment_count' => 1,
)
);
// Вставка первой страницы
$first_page = "nThis is an example page.
n";
$wpdb->insert(
$wpdb->posts,
array(
'post_author' => $user_id,
'post_date' => $now,
'post_content' => $first_page,
'post_title' => __( 'Sample Page' ),
'post_type' => 'page',
)
);
}
Этот код создает категорию, запись и страницу, которые необходимы для работы вашего нового сайта. Пожалуйста, обратите внимание, что небольшие детали могут изменяться в зависимости от настроек вашего веб-сайта и версии WordPress.
Заключение
Функция wp_install_defaults() предлагает удобный способ настройки базового контента для вашего нового сайта на WordPress. С ее помощью вы можете легко настроить несколько настроек и добавить контент в одном месте.