amarkal / amarkal-settings

functions.php

<?php

For compatibility and reusability of your code, PSR1 recommends that a file should introduce either new symbols (like classes, functions, etc.) or have side-effects (like outputting something, or including other files), but not both at the same time. The first symbol is defined on line 22 and the first side effect is on line 16.

/**
 * WordPress Settings
 *
 * Add setting pages with Amarkal UI components to your WordPress theme or 
 * plugin.
 *
 * @package   amarkal-settings
 * @depends   amarkal-ui
 * @author    Askupa Software <hello@askupasoftware.com>
 * @link      https://github.com/askupasoftware/amarkal-settings
 * @copyright 2017 Askupa Software
 */

// Prevent direct file access
defined( 'ABSPATH' ) or die( 'No script kiddies please!' );

Using logical operators such as or instead of || is generally not recommended.

/**
 * Prevent loading the library more than once
 */
if( defined( 'AMARKAL_SETTINGS' ) ) return false;
define( 'AMARKAL_SETTINGS', true );

if(!function_exists('amarkal_add_settings_page'))
{
    /**
     * Add a new settings page
     *
     * @param [array] $args

The doc-type [array] could not be parsed: Unknown type name "" at position 0. [(view supported doc-types)

     * @return void
     */
    function amarkal_add_settings_page( $args )
    {
        $manager = Amarkal\Settings\Manager::get_instance();
        return $manager->add_settings_page($args);
    }
}

if(!function_exists('amarkal_get_settings_page'))
{
    /**
     * Get a settings page instance
     *
     * @param string $slug
     * @return Amarkal\Settings\SettingsPage
     */
    function amarkal_get_settings_page( $slug )
    {
        $manager = Amarkal\Settings\Manager::get_instance();
        return $manager->get_settings_page($slug);
    }
}

if(!function_exists('amarkal_get_settings_value'))
{
    /**
     * Get the value of the given settings field
     *
     * @param string $slug
     * @param string $field_name
     * @return any
     */
    function amarkal_get_settings_value( $slug, $field_name )
    {
        $manager = Amarkal\Settings\Manager::get_instance();
        $page = $manager->get_settings_page($slug);
        return $page->get_field_value($field_name);
    }
}

if(!function_exists('amarkal_get_settings_values'))
{
    /**
     * Get all the values for the given settings page as an array
     *
     * @param string $slug
     * @return array
     */
    function amarkal_get_settings_values( $slug )
    {
        $manager = Amarkal\Settings\Manager::get_instance();
        $page = $manager->get_settings_page($slug);
        return $page->get_field_values();
    }
}