codesoup/acf-options

Manage ACF options using custom post types with instance key support for WordPress

1.0.0 2025-12-05 12:16 UTC

Requires

• php: >=8.1.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^0.7.0
• php-parallel-lint/php-console-highlighter: ^0.5.0
• php-parallel-lint/php-parallel-lint: ^1.3.1
• phpcompatibility/phpcompatibility-wp: *
• wp-coding-standards/wpcs: *

Suggests

• advanced-custom-fields/advanced-custom-fields-pro: Required for ACF location rules and field management

GPL-3.0-or-later

• Code Soup

• wordpress
• options
• Settings
• acf
• custom-post-type
• composer-package
• acf-pro

README

Composer package for managing WordPress options pages using ACF and custom post type. Data is stored and retrieved from post_content field and does not use the wp_options table. Supports multiple instances and capability-based access control.

In case you use custom capabilities make sure you create and assign capability to Administrator role otherwise options page will not be visible/accessible. You can use plugin like User Role Editor to manage custom capabilites and roles.

Requirements

• PHP >= 8.1
• WordPress >= 6.0
• Advanced Custom Fields

Installation

Via Composer

composer require codesoup/acf-options

As WordPress Plugin from GitHub

1. Download the plugin as a ZIP file from GitHub

2. Extract the ZIP file to your WordPress plugins directory

3. Activate the plugin

4. Add required create/register_page code to your functions.php

Usage

Example 1: Create and retrieve in same file

use CodeSoup\ACFOptions\Manager;

$manager = Manager::create( 'my_instance_key' );

$manager->register_page(
    array(
        'id'         => 'general',
        'title'      => 'General Settings',
        'capability' => 'manage_options',
    )
);

$manager->init();

// Retrieve options
$options = $manager->get_options( 'general' );

Example 2: Retrieve existing instance from different file

// In functions.php or plugin init
$manager = \CodeSoup\ACFOptions\Manager::create( 'my_instance_key' );
$manager->register_page(
    array(
        'id'         => 'general',
        'title'      => 'General Settings',
        'capability' => 'manage_footer_options', // Custom wp_capability
    )
);
$manager->init();

// In template file eg: header.php
$manager = \CodeSoup\ACFOptions\Manager::get( 'my_instance_key' );
$options = $manager->get_options( 'general' );

Configuration

Available options with defaults:

$manager = Manager::create(
    'my_instance_key',
    array(
        'post_type'     => 'codesoup_options',         // {my_instance_key}_options
        'prefix'        => 'codesoup-',                // {my_instance_key}-options-
        'menu_position' => 50,                         // 99
        'menu_icon'     => 'dashicons-admin-settings', // dashicons-admin-generic
        'menu_label'    => 'Site Options',             // ACF Options
    )
);

ACF Field Groups

Assign field groups using the ACF Options location rule.

API

Static Methods

• create( string $instance_key, array $config = [] ): Manager
• get( string $instance_key ): ?Manager
• get_all(): array
• destroy( string $instance_key ): bool

Instance Methods

• register_page( array $args ): void
• init(): void
• get_options( string $page_id ): array

License

GPLv3