acf_add_options_sub_page()

Обзор

Эта функция добавляет дополнительную страницу опций на боковую панель wp-admin.

Все данные, сохраненные на странице параметров, являются глобальными. Это означает, что он не привязан к какому-либо конкретному посту или странице, но сохраняется в таблице wp_options.

Требования

  • ACF версии 5.0.0 или выше
  • Эта функция должна быть вызвана до экшена admin_menu (приоритет 99), поскольку в этот момент страницы настроек добавляются в WordPress.

Параметры

<?php acf_add_options_sub_page($page); ?>
  • $page (смешанный) Заголовка для страницы опций или массив параметров. Если не заполнено, то будут использоваться настройки по-умолчанию.

Параметр acf_add_options_sub_page() аналогичны параметрам acf_add_options_page(), кроме одного нюанса. Параметр «parent_slug» не может быть пустым.

По умолчанию, для параметра «parent_slug» установлено значение «acf-options» (страница опций по-умолчанию). Вы конечно можете поменять ее на любую другую страницу из панели администратора.

Посмотрите весь список параметров.

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

Базовая страница с опциями

В этом примере показано, как создать дополнительную страницу с опциями под названием «Social». Следующий код должен быть в помещен в файл functions.php. Помните, вызывая эту функцию без установленного«parent_slug», будет использоваться значение по умолчанию. Кроме того, если страница опций по-умолчанию еще не существует, она будет добавлена.

if( function_exists('acf_add_options_sub_page') ) {

	acf_add_options_sub_page('Social');
	
}

Кастомизация страницы с опциями

В этом примере показано, как создать настраиваемую страницу опций и сохранить данные в переменной для последующего использования.

if( function_exists('acf_add_options_page') ) {
 	
 	// добавляем родителя
	$parent = acf_add_options_page(array(
		'page_title' 	=> 'Основные настройки',
		'menu_title' 	=> 'Основные настройки',
		'redirect' 		=> false
	));
	
	
	// добавляем дочернюю страницу
	acf_add_options_sub_page(array(
		'page_title' 	=> 'Социальные сети',
		'menu_title' 	=> 'Социальные сети',
		'parent_slug' 	=> $parent['menu_slug'],
	));
	
}

Похожие