Manager::get_field_value() - Code Metrics - Inspection of "Added a new API method" - amarkal/amarkal-settings - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 99bbd9...6ab302 )

by Askupa

created 2017-07-16 17:04 UTC

Manager::get_field_value() A

↳ Parent: Manager

Complexity

Conditions	3
Paths	3

Size

Total Lines	16
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	3
eloc	7
nc	3
nop	1
dl	0
loc	16
rs	9.4285
c	0
b	0
f	0

<?php

namespace Amarkal\Settings;

class Manager
{
    /**
     * @var Singleton The reference to *Singleton* instance of this class
     */
    private static $instance;
    
    private $pages = array();
    
    private $child_pages = array();
    
    /**
     * Returns the *Singleton* instance of this class.
     *
     * @return Singleton The *Singleton* instance.
     */
    public static function get_instance()
    {
        if( null === static::$instance ) 
class YourClass
{
    private static $someVariable;

    public static function getSomeVariable()
    {
        return static::$someVariable;
    }
}
        {
            static::$instance = new static();
class YourClass
{
    private static $someVariable;

    public static function getSomeVariable()
    {
        return static::$someVariable;
    }
}
        }
        return static::$instance;
class YourClass
{
    private static $someVariable;

    public static function getSomeVariable()
    {
        return static::$someVariable;
    }
}
    }
    
    /**
     * Add a page to the admin menu.
     * 
     * @param array $args
     * @throws \RuntimeException
     */
    public function add_page($args)
    {
        $slug = $args['slug'];
        if(array_key_exists($slug,$this->pages))
        {
            throw new \RuntimeException("A page with slug '$slug' has already been registered");
        }
        $this->pages[$slug] = new Page($args);
    }
    
    /**
     * Get a page from the set of registered pages.
     * 
     * @param string $slug
     * @return Page
     * @throws \RuntimeException If no page was found for the given slug
     */
    public function get_page($slug)
    {
        if(!array_key_exists($slug,$this->pages))
        {
            throw new \RuntimeException("The page '$slug' does not exist");
        }
        return $this->pages[$slug];
    }
    
    /**
     * Add a child setting page.
     * 
     * @param array $args
     */
    public function add_child_page($args)
    {
        $parent_slug = $args['parent_slug'];
        if(!array_key_exists($parent_slug, $this->child_pages))
        {
            $this->child_pages[$parent_slug] = array();
        }
        $this->child_pages[$parent_slug][$args['slug']] = new ChildPage($args);
    }
    
    /**
     * Get a child page from the set of registered child pages.
     * 
     * @param string $slug
     * @param string $parent_slug
     * @return ChildPage
     * @throws \RuntimeException If no child page was found for the given slug/parent_slug
     */
    public function get_child_page($slug, $parent_slug)
    {
        if(!array_key_exists($parent_slug, $this->child_pages) ||
           !array_key_exists($slug, $this->child_pages[$parent_slug]))
        {
            throw new \RuntimeException("The child page '$slug' does not exist for the parent '$parent_slug'");
        }
        return $this->child_pages[$parent_slug][$slug];
    }

    /**
     * Get the value of the given field.
     *
     * @param [string] $field_name

     * @return mixed
     */
    public function get_field_value($field_name)
    {
        foreach($this->child_pages as $parent_slug => $child_pages)
        {
            try
            {
                return $this->get_field_value_for_parent($parent_slug, $field_name);
            }
            catch(\RuntimeException $e)
            {
                continue;
            }
        }

        \trigger_error("Can't find a component with the name <b>$field_name</b>");
    }

    /**
     * Get the value of a field within a parent page.
     *
     * @param [string] $parent_slug

     * @param [string] $field_name

     * @throws RuntimeException if no field was found with the given name
     * @return mixed
     */
    public function get_field_value_for_parent($parent_slug, $field_name)
    {
        foreach($this->child_pages[$parent_slug] as $cp)
        {
            try 
            {
                $component = $cp->get_component($field_name);
                $value = \get_option($field_name, $component->default);
                return $value;
            }
            catch(\RuntimeException $e)
            {
                continue;
            }
        }
        throw new \RuntimeException("Can't find a component with the name <b>$field_name</b>");
    }
    
    /**
     * Register styles & scripts to be enqueued by settings child pages
     */
    public function register_scripts()
    {
        \wp_register_style('amarkal-settings', \Amarkal\Core\Utility::path_to_url(__DIR__.'/assets/css/dist/amarkal-settings.min.css'));
        \wp_register_script('amarkal-settings',\Amarkal\Core\Utility::path_to_url(__DIR__.'/assets/js/dist/amarkal-settings.min.js'),array('amarkal-ui'));
    }
    
    /**
     * Private constructor to prevent instantiation
     */
    private function __construct() 
    {
        $this->init();
    }
    
    /**
     * Register scripts and initiate the request handler.
     */
    private function init()
    {
        \add_action('admin_init',array($this,'register_scripts'));
        
        $rh = RequestHandler::get_instance();
        $rh->init();
    }
}

1			<?php
2
3			namespace Amarkal\Settings;
4
5			class Manager
6			{
7			/**
8			* @var Singleton The reference to Singleton instance of this class
9			*/
10			private static $instance;
11
12			private $pages = array();
13
14			private $child_pages = array();
15
16			/**
17			* Returns the Singleton instance of this class.
18			*
19			* @return Singleton The Singleton instance.
20			*/
21			public static function get_instance()
22			{
23			if( null === static::$instance )
			0 ignored issues – show Bug introduced 2017-05-01 19:09 UTC by Report Bug Copy Issue Report Since `$instance` is declared private, accessing it with `static` will lead to errors in possible sub-classes; consider using `self`, or increasing the visibility of `$instance` to at least protected. Let’s assume you have a class which uses late-static binding: class YourClass { private static $someVariable; public static function getSomeVariable() { return static::$someVariable; } } The code above will run fine in your PHP runtime. However, if you now create a sub-class and call the `getSomeVariable()` on that sub-class, you will receive a runtime error: class YourSubClass extends YourClass { } YourSubClass::getSomeVariable(); // Will cause an access error. In the case above, it makes sense to update `SomeClass` to use `self` instead: class SomeClass { private static $someVariable; public static function getSomeVariable() { return self::$someVariable; // self works fine with private. } } Loading history...
24			{
25			static::$instance = new static();
			0 ignored issues – show Documentation Bug introduced 2017-04-17 00:18 UTC by Report Bug Copy Issue Report It seems like `new static()` of type `this<Amarkal\Settings\Manager>` is incompatible with the declared type `object<Amarkal\Settings\Singleton>` of property `$instance`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history... Bug introduced 2017-05-01 19:09 UTC by Report Bug Copy Issue Report Since `$instance` is declared private, accessing it with `static` will lead to errors in possible sub-classes; consider using `self`, or increasing the visibility of `$instance` to at least protected. Let’s assume you have a class which uses late-static binding: class YourClass { private static $someVariable; public static function getSomeVariable() { return static::$someVariable; } } The code above will run fine in your PHP runtime. However, if you now create a sub-class and call the `getSomeVariable()` on that sub-class, you will receive a runtime error: class YourSubClass extends YourClass { } YourSubClass::getSomeVariable(); // Will cause an access error. In the case above, it makes sense to update `SomeClass` to use `self` instead: class SomeClass { private static $someVariable; public static function getSomeVariable() { return self::$someVariable; // self works fine with private. } } Loading history...
26			}
27			return static::$instance;
			0 ignored issues – show Bug introduced 2017-05-01 19:09 UTC by Report Bug Copy Issue Report Since `$instance` is declared private, accessing it with `static` will lead to errors in possible sub-classes; consider using `self`, or increasing the visibility of `$instance` to at least protected. Let’s assume you have a class which uses late-static binding: class YourClass { private static $someVariable; public static function getSomeVariable() { return static::$someVariable; } } The code above will run fine in your PHP runtime. However, if you now create a sub-class and call the `getSomeVariable()` on that sub-class, you will receive a runtime error: class YourSubClass extends YourClass { } YourSubClass::getSomeVariable(); // Will cause an access error. In the case above, it makes sense to update `SomeClass` to use `self` instead: class SomeClass { private static $someVariable; public static function getSomeVariable() { return self::$someVariable; // self works fine with private. } } Loading history... Bug Compatibility introduced 2017-05-01 19:09 UTC by Report Bug Copy Issue Report The expression `static::$instance;` of type `Amarkal\Settings\Manager...rkal\Settings\Singleton` adds the type `Amarkal\Settings\Manager` to the return on line 27 which is incompatible with the return type documented by `Amarkal\Settings\Manager::get_instance` of type `Amarkal\Settings\Singleton`. Loading history...
28			}
29
30			/**
31			* Add a page to the admin menu.
32			*
33			* @param array $args
34			* @throws \RuntimeException
35			*/
36			public function add_page($args)
37			{
38			$slug = $args['slug'];
39			if(array_key_exists($slug,$this->pages))
40			{
41			throw new \RuntimeException("A page with slug '$slug' has already been registered");
42			}
43			$this->pages[$slug] = new Page($args);
44			}
45
46			/**
47			* Get a page from the set of registered pages.
48			*
49			* @param string $slug
50			* @return Page
51			* @throws \RuntimeException If no page was found for the given slug
52			*/
53			public function get_page($slug)
54			{
55			if(!array_key_exists($slug,$this->pages))
56			{
57			throw new \RuntimeException("The page '$slug' does not exist");
58			}
59			return $this->pages[$slug];
60			}
61
62			/**
63			* Add a child setting page.
64			*
65			* @param array $args
66			*/
67			public function add_child_page($args)
68			{
69			$parent_slug = $args['parent_slug'];
70			if(!array_key_exists($parent_slug, $this->child_pages))
71			{
72			$this->child_pages[$parent_slug] = array();
73			}
74			$this->child_pages[$parent_slug][$args['slug']] = new ChildPage($args);
75			}
76
77			/**
78			* Get a child page from the set of registered child pages.
79			*
80			* @param string $slug
81			* @param string $parent_slug
82			* @return ChildPage
83			* @throws \RuntimeException If no child page was found for the given slug/parent_slug
84			*/
85			public function get_child_page($slug, $parent_slug)
86			{
87			if(!array_key_exists($parent_slug, $this->child_pages) \|\|
88			!array_key_exists($slug, $this->child_pages[$parent_slug]))
89			{
90			throw new \RuntimeException("The child page '$slug' does not exist for the parent '$parent_slug'");
91			}
92			return $this->child_pages[$parent_slug][$slug];
93			}
94
95			/**
96			* Get the value of the given field.
97			*
98			* @param [string] $field_name
			0 ignored issues – show Documentation introduced 2017-07-16 17:05 UTC by Report Bug Copy Issue Report The doc-type `[string]` could not be parsed: Unknown type name "" at position 0. [(view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
99			* @return mixed
100			*/
101			public function get_field_value($field_name)
102			{
103			foreach($this->child_pages as $parent_slug => $child_pages)
104			{
105			try
106			{
107			return $this->get_field_value_for_parent($parent_slug, $field_name);
108			}
109			catch(\RuntimeException $e)
110			{
111			continue;
112			}
113			}
114
115			\trigger_error("Can't find a component with the name <b>$field_name</b>");
116			}
117
118			/**
119			* Get the value of a field within a parent page.
120			*
121			* @param [string] $parent_slug
			0 ignored issues – show Documentation introduced 2017-07-16 17:05 UTC by Report Bug Copy Issue Report The doc-type `[string]` could not be parsed: Unknown type name "" at position 0. [(view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
122			* @param [string] $field_name
			0 ignored issues – show Documentation introduced 2017-07-16 17:05 UTC by Report Bug Copy Issue Report The doc-type `[string]` could not be parsed: Unknown type name "" at position 0. [(view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
123			* @throws RuntimeException if no field was found with the given name
124			* @return mixed
125			*/
126			public function get_field_value_for_parent($parent_slug, $field_name)
127			{
128			foreach($this->child_pages[$parent_slug] as $cp)
129			{
130			try
131			{
132			$component = $cp->get_component($field_name);
133			$value = \get_option($field_name, $component->default);
134			return $value;
135			}
136			catch(\RuntimeException $e)
137			{
138			continue;
139			}
140			}
141			throw new \RuntimeException("Can't find a component with the name <b>$field_name</b>");
142			}
143
144			/**
145			* Register styles & scripts to be enqueued by settings child pages
146			*/
147			public function register_scripts()
148			{
149			\wp_register_style('amarkal-settings', \Amarkal\Core\Utility::path_to_url(__DIR__.'/assets/css/dist/amarkal-settings.min.css'));
150			\wp_register_script('amarkal-settings',\Amarkal\Core\Utility::path_to_url(__DIR__.'/assets/js/dist/amarkal-settings.min.js'),array('amarkal-ui'));
151			}
152
153			/**
154			* Private constructor to prevent instantiation
155			*/
156			private function __construct()
157			{
158			$this->init();
159			}
160
161			/**
162			* Register scripts and initiate the request handler.
163			*/
164			private function init()
165			{
166			\add_action('admin_init',array($this,'register_scripts'));
167
168			$rh = RequestHandler::get_instance();
169			$rh->init();
170			}
171			}

amarkal / amarkal-settings

Push — master ( 99bbd9...6ab302 )

Manager::get_field_value() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like