flyntwp / flynt

lib/Utils/Options.php

<?php

namespace Flynt\Utils;

use ACFComposer;

class Options
{
    const OPTION_TYPES = [
        'translatable' => [
            'title' => 'Translatable Options',
            'icon' => 'dashicons-translation',
            'translatable' => true
        ],
        'global' => [
            'title' => 'Global Options',
            'icon' => 'dashicons-admin-site',
            'translatable' => false
        ]
    ];

    protected static $initialized = false;

    protected static $optionPages = [];

    protected static $registeredOptions = [];

    protected static function init()
    {
        if (static::$initialized) {
            return;
        } else {
            static::$initialized = true;
        }

        add_action('current_screen', function ($currentScreen) {
            $currentScreenId = strtolower($currentScreen->id);
            foreach (static::OPTION_TYPES as $optionType => $option) {
                $isTranslatable = $option['translatable'];
                // NOTE: because the first subpage starts with toplevel instead (there is no overview page)
                $toplevelPageId = strtolower('toplevel_page_' . $optionType);
                $menuTitle = static::$optionPages[$optionType]['menu_title'];
                // NOTE: all other subpages have the parent menu-title in front instead
                $subPageId = strtolower(
                    sanitize_title($menuTitle) . '_page_' . $optionType
                );
                $isCurrentPage =
                    StringHelpers::startsWith(
                        $toplevelPageId,
                        $currentScreenId
                    ) ||
                    StringHelpers::startsWith($subPageId, $currentScreenId);
                if (!$isTranslatable && $isCurrentPage) {
                    // set acf field values to default language
                    add_filter(
                        'acf/settings/current_language',
                        'Flynt\Utils\Options::getDefaultAcfLanguage',
                        101
                    );
                    // hide language selector in admin bar
                    add_action('wp_before_admin_bar_render', function () {
                        $adminBar = $GLOBALS['wp_admin_bar'];
                        $adminBar->remove_menu('WPML_ALS');
                    });
                }
            }
        });
    }

    protected static function createOptionPage($optionType)
    {
        if (empty(static::$optionPages[$optionType])) {
            $option = static::OPTION_TYPES[$optionType];
            $title = _x($option['title'], 'title', 'flynt');
            $slug = ucfirst($optionType) . 'Options';

            acf_add_options_page([

The function acf_add_options_page was not found. Maybe you did not declare it correctly or list all dependencies?

                'page_title'  => $title,
                'menu_title'  => $title,
                'redirect'    => true,
                'menu_slug'   => $slug,
                'icon_url'    => $option['icon']
            ]);

            static::$optionPages[$optionType] = [
                'menu_slug' => $slug,
                'menu_title' => $title
            ];
        }
        return static::$optionPages[$optionType];
    }

    protected static function createOptionSubPage($optionType, $optionCategory = "Default")
    {
        if (empty(static::$optionPages[$optionType]['sub_pages'][$optionCategory])) {
            $optionPage = static::createOptionPage($optionType);
            $categoryTitle = _x($optionCategory, 'title', 'flynt');
            $categorySlug = implode('-', [$optionPage['menu_slug'], $optionCategory]);
            $pageConfig = [
                'page_title' => $optionPage['menu_title'] . ': ' . $categoryTitle,
                'menu_title' => $categoryTitle,
                'redirect' => true,
                'menu_slug' => $categorySlug,
                'parent_slug' => $optionPage['menu_slug']
            ];
            acf_add_options_page($pageConfig);

The function acf_add_options_page was not found. Maybe you did not declare it correctly or list all dependencies?

            static::$optionPages[$optionType]['sub_pages'][
                $optionCategory
            ] = [
                'menu_slug' => $categorySlug,
                'menu_title' => $categoryTitle
            ];
            $fieldGroup = ACFComposer\ResolveConfig::forFieldGroup([
                'name' => $categorySlug,
                'title' => $categoryTitle,
                'style' => 'seamless',
                'fields' => [],
                'location' => [
                    [
                        [
                            'param' => 'options_page',
                            'operator' => '==',
                            'value' => $categorySlug
                        ]
                    ]
                ]
            ]);
            acf_add_local_field_group($fieldGroup);

The function acf_add_local_field_group was not found. Maybe you did not declare it correctly or list all dependencies?

        }
    }


    // ============
    // PUBLIC API
    // ============
    public static function getTranslatable($scope, $fieldName = null)
    {
        return self::get('translatable', $scope, $fieldName);
    }

    public static function getGlobal($scope, $fieldName = null)
    {
        return self::get('global', $scope, $fieldName);
    }

    /**
     * Get option(s) from a sub page.
     *
     * Returns an option of a sub page. If no field name is provided it will get all option of that sub page.
     * Parameters are expected to be camelCase.
     *
     * @since 0.2.0 introduced as a replacement for OptionPages::getOption and OptionPages::getOptions
     * @since 0.2.2 added check for required hooks to have run to alert of timing issues when used incorrectly
     *
     * @param string $optionType Type of option page. Either global or translatable.
     * @param string $scope Scope of the option.
     * @param string|null $fieldName (optional) Name of the field to get.
     * @return mixed The value of the option or array of options. False if subpage doesn't exist or no option was found.
     **/
    public static function get($optionType, $scope, $fieldName = null)
    {
        if (!static::checkRequiredHooks($optionType, $scope, $fieldName)) {
            return false;
        }

        // convert parameters
        $optionType = lcfirst($optionType);
        $scope = ucfirst($scope);

        if (!isset(static::OPTION_TYPES[$optionType])) {
            return false;
        }

        $prefix = implode('_', [$optionType, $scope, '']);
        $isTranslatable = static::OPTION_TYPES[$optionType]['translatable'];
        if (empty($fieldName)) {
            $optionNames = ((static::$registeredOptions[$optionType] ?? [])[$scope] ?? []);
            return array_combine(
                $optionNames,
                array_map(function ($optionName) use ($prefix, $isTranslatable) {
                    $fieldKey = $prefix . $optionName;
                    return static::getOptionField($fieldKey, $isTranslatable);
                }, $optionNames)
            );
        } else {
            $fieldKey = $prefix . $fieldName;
            return static::getOptionField($fieldKey, $isTranslatable);
        }
    }

    public static function addTranslatable($scope, $fields, $category = 'Default')
    {
        static::addOptions($scope, $fields, 'translatable', $category);
    }

    public static function addGlobal($scope, $fields, $category = 'Default')
    {
        static::addOptions($scope, $fields, 'global', $category);
    }

    public static function addOptions($scope, $fields, $type, $category = 'Default')
    {
        static::createOptionSubPage($type, $category);
        $fieldGroupTitle = StringHelpers::splitCamelCase($scope);
        $optionsPageSlug = self::$optionPages[$type]['sub_pages'][$category]['menu_slug'];
        $fieldGroupName = implode('_', [$type, $scope]);
        static::addOptionsFieldGroup(
            $fieldGroupName,
            $fieldGroupTitle,
            $optionsPageSlug,
            $fields
        );
        static::registerOptionNames($type, $scope, $fields);
    }

    protected static function registerOptionNames($type, $scope, $fields)
    {
        static::$registeredOptions[$type] = static::$registeredOptions[$type] ?? [];
        static::$registeredOptions[$type] = static::$registeredOptions[$type] ?? [];
        static::$registeredOptions[$type][$scope] = array_column($fields, 'name');
        return static::$registeredOptions;
    }

    protected static function addOptionsFieldGroup($name, $title, $optionsPageSlug, $fields)
    {
        $fieldGroup = ACFComposer\ResolveConfig::forFieldGroup(
            [
                'name' => $name,
                'title' => $title,
                'fields' => array_merge([
                    [
                        'label' => $title,
                        'name' => '',
                        'type' => 'accordion',
                        'placement' => 'left',
                        'endpoint' => false,
                    ]
                ], $fields),
                'style' => 'seamless',
                'location' => [
                    [
                        [
                            'param' => 'options_page',
                            'operator' => '==',
                            'value' => $optionsPageSlug
                        ]
                    ]
                ]
            ]
        );
        $fieldGroup['fields'] = static::prefixFields($fieldGroup['fields'], $name);
        foreach ($fieldGroup['fields'] as $field) {
            acf_add_local_field(array_merge($field, [

The function acf_add_local_field was not found. Maybe you did not declare it correctly or list all dependencies?

                'parent' => 'group_' . $optionsPageSlug,
            ]));
        }
    }

    protected static function prefixFields($fields, $prefix)
    {
        return array_map(function ($field) use ($prefix) {
            $field['name'] = $prefix . '_' . $field['name'];
            return $field;
        }, $fields);
    }

    protected static function checkRequiredHooks($optionType, $scope, $fieldName)
    {
        if (did_action('acf/init') < 1) {
            $parameters = "${optionType}, ${scope}, ";
            $parameters .= isset($fieldName) ? $fieldName : 'NULL';
            trigger_error("Could not get option/s for [${parameters}]. Required hooks have not yet been executed! Please make sure to run `Options::get()` after the `acf/init` action is finished.", E_USER_WARNING);
            return false;
        }
        return true;
    }

    protected static function getOptionField($key, $translatable)
    {
        if ($translatable) {
            $option = get_field('field_' . $key, 'option');

The function get_field was not found. Maybe you did not declare it correctly or list all dependencies?

        } else {
            // switch to default language to get global options
            add_filter('acf/settings/current_language', 'Flynt\Utils\Options::getDefaultAcfLanguage', 100);

            $option = get_field('field_' . $key, 'option');

            remove_filter('acf/settings/current_language', 'Flynt\Utils\Options::getDefaultAcfLanguage', 100);
        }

        return $option;
    }

    public static function getDefaultAcfLanguage()
    {
        return acf_get_setting('default_language');

The function acf_get_setting was not found. Maybe you did not declare it correctly or list all dependencies?

    }
}