acf_add_customizer_section

acf_add_customizer_section( $section = '' )

Adds a customizer section.
Call this function before or inside the init hook.

Arguments

• $section = '' String|Array As a string: the name of the Customizer section.
  Array argument values:

  • title (mandatory) String.

  • storage_type (optional) String
    choose one of theme_mod (default), option, post, term
option will save the field values in the wp options table – just like an ACF options page.
    theme_mod will save the field value as a theme mod. Use get_field( 'field_selector', $post_id ) in the frontend.
    post and term will save the values in the currently displayed post or term meta.

  • post_id (optional) String.
    Defaults to sanitized title argument for theme_mod and option storage types.
    Omit if you choose post or term storage type.

  • active_callback (optional) callable
    If storage type is post or term the default is a function which returns whether the current page is a post or a term archive page.
    see also https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • panel (optional) null|String.
    Parent panel ID. Default null see https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • capability (optional) String. Default: 'edit_theme_options'
    see https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • theme_supports (optional) array
    Default: array()
    see https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • description (optional) String
    Default: ''
    see https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • priority (optional) integer
    Default: 160
    see https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

  • description_hidden (optional) Boolean
    Default: false
    see (https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/)

Return Value

$section_id String If you did not specify a post_id, this will be the second argument to pass to get_field().

Examples

Post meta

acf_add_customizer_section(array(
    'title'        => 'Some Post Meta',
    'storage_type' => 'post',
));

Theme mod

// in the init hook
acf_add_customizer_section(array(
    'title'        => 'Mod the Theme',
    'storage_type' => 'theme_mod',
    'post_id'      => 'acf_theme_mod',
));

// in your theme
the_field('acf_field_selector','acf_theme_mod');