Страница с опциями (Options Page)

Обзор

Страница с опциями позволяет добавлять дополнительные страниц в панель администратора WP и использовать всю мощь полей ACF! Каждая страница администратора может быть полностью настроена (см. Примеры кода ниже). Также можно создать дочерние (вложенные) страницы.

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

Демо

Требования

  • ACF версии 5.0.0 или выше
  • Активная функция «Страница с опциями». Доступно в ACF PRO (платная версия)

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

Базовое

Чтобы создать страницу с опциями, просто откройте файл functions.php и добавьте следующую строку кода:

if( function_exists('acf_add_options_page') ) {
	
	acf_add_options_page();
	
}

Если не передавать параметры в эту функцию, страница настроек по умолчанию будет добавлена на вашу боковую панель wp-admin.

Продвинутое

В этом примере показано, как создать страницу опций с дочерними элементами и дополнительными настройками.

if( function_exists('acf_add_options_page') ) {
	
	acf_add_options_page(array(
		'page_title' 	=> 'Основные настройки',
		'menu_title'	=> 'Настройки темы',
		'menu_slug' 	=> 'theme-general-settings',
		'capability'	=> 'edit_posts',
		'redirect'		=> false
	));
	
	acf_add_options_sub_page(array(
		'page_title' 	=> 'Настройки шапки',
		'menu_title'	=> 'Шапка',
		'parent_slug'	=> 'theme-general-settings',
	));
	
	acf_add_options_sub_page(array(
		'page_title' 	=> 'Настройки подвала',
		'menu_title'	=> 'Подвал',
		'parent_slug'	=> 'theme-general-settings',
	));
	
}

В шаблоне

Все API функции ACF можно использовать с полями «Страницы опций». Однако, требуется второй параметр. Это похоже на установку $post_id для выбора определенного поста. В этом примере показано, как получить значения для страницу с опциями. Прочитайте также: Получение значения для страницы с опциями.

<?php the_field('header_title', 'option'); ?>

Примечание

В версии ACF 4 страница с опциями добавляется автоматически. Однако, это не так в ACF PRO. Если вы работаете с ACF PRO, вам нужно будет добавить страницу опций вручную, используя приведенный выше код.

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

Похожие