michaeluno / admin-page-framework

development/factory/_abstract/_controller/AdminPageFramework_Resource_Base.php

Doc Comments +4 added lines

@@ -232,6 +232,8 @@ 
      * @remark      The meta box class may be instantiated multiple times so prevent echoing the same styles multiple times.
      * @parameter   string      $sIDPrefix   The id selector embedded in the script tag.
      * @parameter   string      $sClassName  The class name that identify the call group. This is important for the meta-box class because it can be instantiated multiple times in one particular page.
+     * @param string $sIDPrefix
+     * @param string $sClassName
      */
     protected function _printCommonStyles( $sIDPrefix, $sClassName ) {
 
@@ -315,6 +317,8 @@ 
      * @remark      The meta box class may be instantiated multiple times so prevent echoing the same styles multiple times.
      * @parametr    string      $sIDPrefix      The id selector embedded in the script tag.
      * @parametr    string      $sClassName     The class name that identify the call group. This is important for the meta-box class because it can be instantiated multiple times in one particular page.
+     * @param string $sIDPrefix
+     * @param string $sClassName
      */
     protected function _printCommonScripts( $sIDPrefix, $sClassName ) {
         

Spacing +45 added lines, -45 removed lines

@@ -36,19 +36,19 @@ 
     
         /* The system internal keys. */
         'sSRC'          => null,
-        'aPostTypes'    => array(),     // for meta box class
+        'aPostTypes'    => array(), // for meta box class
         'sPageSlug'     => null,    
         'sTabSlug'      => null,
-        'sType'         => null,        // script or style
+        'sType'         => null, // script or style
         
         /* The below keys are for users. */
         'handle_id'     => null,
         'dependencies'  => array(),
-        'version'       => false,       // although the type should be string, the wp_enqueue_...() functions want false as the default value.
-        'translation'   => array(),     // only for scripts
-        'in_footer'     => false,       // only for scripts
-        'media'         => 'all',       // only for styles     
-        'attributes'    => array(),     // 3.3.0+ - the attribute array
+        'version'       => false, // although the type should be string, the wp_enqueue_...() functions want false as the default value.
+        'translation'   => array(), // only for scripts
+        'in_footer'     => false, // only for scripts
+        'media'         => 'all', // only for styles     
+        'attributes'    => array(), // 3.3.0+ - the attribute array
         
     );    
       
@@ -59,7 +59,7 @@ 
      * @remark      This value should be overridden in an extended class.
      * @internal
      */
-    protected $_sClassSelector_Style    = 'admin-page-framework-style';
+    protected $_sClassSelector_Style = 'admin-page-framework-style';
     
     /**
      * Stores the class selector used to the class-specific script.
@@ -68,7 +68,7 @@ 
      * @remark      This value should be overridden in an extended class.
      * @internal
      */    
-    protected $_sClassSelector_Script   = 'admin-page-framework-script';
+    protected $_sClassSelector_Script = 'admin-page-framework-script';
       
     /**
      * Stores hand IDs by resource url to look up handle id and add custom arguments.
@@ -142,8 +142,8 @@ 
      * @internal
      */
     
-    public function _forceToEnqueueStyle( $sSRC, $aCustomArgs=array() ) {}
-    public function _forceToEnqueueScript( $sSRC, $aCustomArgs=array() ) {}
+    public function _forceToEnqueueStyle( $sSRC, $aCustomArgs = array() ) {}
+    public function _forceToEnqueueScript( $sSRC, $aCustomArgs = array() ) {}
     
     /**
      * A helper function for the _replyToEnqueueScripts() and the `_replyToEnqueueStyle()` methods.
@@ -204,7 +204,7 @@ 
                     }
                     
                     $_sAttributes   = $this->getAttributes( $_aAttributes );
-                    $_sModifiedURL  = $sSanitizedURL . "' " . rtrim( $_sAttributes, "'\"" );    // '"
+                    $_sModifiedURL  = $sSanitizedURL."' ".rtrim( $_sAttributes, "'\"" ); // '"
 
                     return $_sModifiedURL;                    
                     
@@ -252,19 +252,19 @@ 
          */
         private function _getStyleTag( $oCaller, $sIDPrefix ) {
             
-            $_sStyle     = $this->addAndApplyFilters( 
+            $_sStyle = $this->addAndApplyFilters( 
                 $oCaller, 
                 array(
-                    "style_common_admin_page_framework",            // 3.2.1+
+                    "style_common_admin_page_framework", // 3.2.1+
                     "style_common_{$this->oProp->sClassName}",
                 ), 
                 AdminPageFramework_CSS::getDefaultCSS() 
             );
-            $_sStyle     = $this->isDebugMode()
+            $_sStyle = $this->isDebugMode()
                 ? trim( $_sStyle )
                 : $this->minifyCSS( $_sStyle );
             if ( $_sStyle ) {
-                echo "<style type='text/css' id='" . esc_attr( $sIDPrefix ) . "'>"
+                echo "<style type='text/css' id='".esc_attr( $sIDPrefix )."'>"
                         . $_sStyle
                     . "</style>";
             }
@@ -278,20 +278,20 @@ 
          */        
         private function _getIEStyleTag( $oCaller, $sIDPrefix ) {
                 
-            $_sStyleIE   = $this->addAndApplyFilters( 
+            $_sStyleIE = $this->addAndApplyFilters( 
                 $oCaller, 
                 array(
-                    "style_ie_common_admin_page_framework",         // 3.2.1+
+                    "style_ie_common_admin_page_framework", // 3.2.1+
                     "style_ie_common_{$this->oProp->sClassName}", 
                 ),
                 AdminPageFramework_CSS::getDefaultCSSIE() 
             );
             
-            $_sStyleIE   = $this->isDebugMode()
+            $_sStyleIE = $this->isDebugMode()
                 ? trim( $_sStyleIE )
                 : $this->minifyCSS( $_sStyleIE );
             return $_sStyleIE
-                ? "<!--[if IE]><style type='text/css' id='" . esc_attr( $sIDPrefix . "-ie" ) . "'>"
+                ? "<!--[if IE]><style type='text/css' id='".esc_attr( $sIDPrefix."-ie" )."'>"
                         . $_sStyleIE
                     . "</style><![endif]-->"
                 : '';
@@ -324,14 +324,14 @@ 
         $_sScript = $this->addAndApplyFilters( 
             $this->oProp->_getCallerObject(), 
             array(
-                "script_common_admin_page_framework",       // 3.2.1+
+                "script_common_admin_page_framework", // 3.2.1+
                 "script_common_{$this->oProp->sClassName}", 
             ),
             AdminPageFramework_Property_Base::$_sDefaultScript 
         );
         $_sScript = trim( $_sScript );
         if ( $_sScript ) {
-            echo "<script type='text/javascript' id='" . esc_attr( $sIDPrefix ) . "'>"
+            echo "<script type='text/javascript' id='".esc_attr( $sIDPrefix )."'>"
                     . $_sScript
                 . "</script>";
         }
@@ -348,7 +348,7 @@ 
      */
     protected function _printClassSpecificStyles( $sIDPrefix ) {
            
-        $_oCaller   = $this->oProp->_getCallerObject();     
+        $_oCaller = $this->oProp->_getCallerObject();     
         echo $this->_getClassSpecificStyleTag( $_oCaller, $sIDPrefix );
         echo $this->_getClassSpecificIEStyleTag( $_oCaller, $sIDPrefix );
         
@@ -376,7 +376,7 @@ 
                 ? trim( $_sStyle )
                 : $this->minifyCSS( $_sStyle );
             if ( $_sStyle ) {
-                return "<style type='text/css' id='" . esc_attr( "{$sIDPrefix}-{$this->oProp->sClassName}_{$_iCallCount}" ) . "'>"
+                return "<style type='text/css' id='".esc_attr( "{$sIDPrefix}-{$this->oProp->sClassName}_{$_iCallCount}" )."'>"
                         . $_sStyle
                     . "</style>";
                 $_iCallCount++;
@@ -402,7 +402,7 @@ 
                 ? trim( $_sStyleIE )
                 : $this->minifyCSS( $_sStyleIE );
             if ( $_sStyleIE ) {
-                return "<!--[if IE]><style type='text/css' id='" . esc_attr( "{$sIDPrefix}-ie-{$this->oProp->sClassName}_{$_iCallCountIE}" ) . "'>" 
+                return "<!--[if IE]><style type='text/css' id='".esc_attr( "{$sIDPrefix}-ie-{$this->oProp->sClassName}_{$_iCallCountIE}" )."'>" 
                         . $_sStyleIE
                     . "</style><![endif]-->";
                 $_iCallCountIE++;
@@ -430,7 +430,7 @@ 
         );
         $_sScript = trim( $_sScript );
         if ( $_sScript ) {
-            echo "<script type='text/javascript' id='" . esc_attr( "{$sIDPrefix}-{$this->oProp->sClassName}_{$_iCallCount}" ) . "'>" 
+            echo "<script type='text/javascript' id='".esc_attr( "{$sIDPrefix}-{$this->oProp->sClassName}_{$_iCallCount}" )."'>" 
                     . $_sScript
                 . "</script>"; 
             $_iCallCount++;
@@ -454,12 +454,12 @@ 
     public function _replyToAddStyle() {
     
         $_oCaller = $this->oProp->_getCallerObject();     
-        if ( ! $_oCaller->_isInThePage() ) {
+        if ( !$_oCaller->_isInThePage() ) {
             return; 
         }
         
         $this->_printCommonStyles( 'admin-page-framework-style-common', get_class() );
-        $this->_printClassSpecificStyles( $this->_sClassSelector_Style . '-' . $this->oProp->sStructureType );
+        $this->_printClassSpecificStyles( $this->_sClassSelector_Style.'-'.$this->oProp->sStructureType );
  
     }
     /**
@@ -474,12 +474,12 @@ 
     public function _replyToAddScript() {
 
         $_oCaller = $this->oProp->_getCallerObject();     
-        if ( ! $_oCaller->_isInThePage() ) { 
+        if ( !$_oCaller->_isInThePage() ) { 
             return; 
         }
         
         $this->_printCommonScripts( 'admin-page-framework-script-common', get_class() );
-        $this->_printClassSpecificScripts( $this->_sClassSelector_Script . '-' . $this->oProp->sStructureType );
+        $this->_printClassSpecificScripts( $this->_sClassSelector_Script.'-'.$this->oProp->sStructureType );
         
     }        
     
@@ -494,28 +494,28 @@ 
     protected function _enqueueSRC( $aEnqueueItem ) {
         
         // For styles
-        if ( 'style' === $aEnqueueItem['sType'] ) {
+        if ( 'style' === $aEnqueueItem[ 'sType' ] ) {
             wp_enqueue_style( 
-                $aEnqueueItem['handle_id'], 
-                $aEnqueueItem['sSRC'], 
-                $aEnqueueItem['dependencies'], 
-                $aEnqueueItem['version'], 
-                $aEnqueueItem['media']
+                $aEnqueueItem[ 'handle_id' ], 
+                $aEnqueueItem[ 'sSRC' ], 
+                $aEnqueueItem[ 'dependencies' ], 
+                $aEnqueueItem[ 'version' ], 
+                $aEnqueueItem[ 'media' ]
             );
             return;
         }
 
         // For scripts
         wp_enqueue_script( 
-            $aEnqueueItem['handle_id'], 
-            $aEnqueueItem['sSRC'], 
-            $aEnqueueItem['dependencies'], 
-            $aEnqueueItem['version'], 
-            did_action( 'admin_body_class' ) ? true : $aEnqueueItem['in_footer'] 
+            $aEnqueueItem[ 'handle_id' ], 
+            $aEnqueueItem[ 'sSRC' ], 
+            $aEnqueueItem[ 'dependencies' ], 
+            $aEnqueueItem[ 'version' ], 
+            did_action( 'admin_body_class' ) ? true : $aEnqueueItem[ 'in_footer' ] 
         );
     
-        if ( $aEnqueueItem['translation'] ) {
-            wp_localize_script( $aEnqueueItem['handle_id'], $aEnqueueItem['handle_id'], $aEnqueueItem['translation'] );
+        if ( $aEnqueueItem[ 'translation' ] ) {
+            wp_localize_script( $aEnqueueItem[ 'handle_id' ], $aEnqueueItem[ 'handle_id' ], $aEnqueueItem[ 'translation' ] );
         }
         
     }
@@ -531,7 +531,7 @@ 
      * @internal
      */    
     public function _replyToEnqueueStyles() {        
-        foreach( $this->oProp->aEnqueuingStyles as $_sKey => $_aEnqueuingStyle ) {
+        foreach ( $this->oProp->aEnqueuingStyles as $_sKey => $_aEnqueuingStyle ) {
             $this->_enqueueSRCByCondition( $_aEnqueuingStyle );
             unset( $this->oProp->aEnqueuingStyles[ $_sKey ] );
         }
@@ -548,7 +548,7 @@ 
      * @internal
      */
     public function _replyToEnqueueScripts() {     
-        foreach( $this->oProp->aEnqueuingScripts as $_sKey => $_aEnqueuingScript ) {
+        foreach ( $this->oProp->aEnqueuingScripts as $_sKey => $_aEnqueuingScript ) {
             $this->_enqueueSRCByCondition( $_aEnqueuingScript );     
             unset( $this->oProp->aEnqueuingScripts[ $_sKey ] );
         }

Braces +4 added lines, -4 removed lines

@@ -235,7 +235,7 @@ 
      */
     protected function _printCommonStyles( $sIDPrefix, $sClassName ) {
 
-        if ( self::$_bCommonStyleLoaded ) { 
+        if ( self::$_bCommonStyleLoaded ) {
             return; 
         }
         self::$_bCommonStyleLoaded = true;
@@ -474,7 +474,7 @@ 
     public function _replyToAddScript() {
 
         $_oCaller = $this->oProp->_getCallerObject();     
-        if ( ! $_oCaller->_isInThePage() ) { 
+        if ( ! $_oCaller->_isInThePage() ) {
             return; 
         }
         
@@ -530,7 +530,7 @@ 
      * @since       3.2.0   Changed it unset the enqueued item so that the method can be called multiple times.
      * @internal
      */    
-    public function _replyToEnqueueStyles() {        
+    public function _replyToEnqueueStyles() {
         foreach( $this->oProp->aEnqueuingStyles as $_sKey => $_aEnqueuingStyle ) {
             $this->_enqueueSRCByCondition( $_aEnqueuingStyle );
             unset( $this->oProp->aEnqueuingStyles[ $_sKey ] );
@@ -547,7 +547,7 @@ 
      * @since       3.2.0   Changed it unset the enqueued item so that the method can be called multiple times.
      * @internal
      */
-    public function _replyToEnqueueScripts() {     
+    public function _replyToEnqueueScripts() {
         foreach( $this->oProp->aEnqueuingScripts as $_sKey => $_aEnqueuingScript ) {
             $this->_enqueueSRCByCondition( $_aEnqueuingScript );     
             unset( $this->oProp->aEnqueuingScripts[ $_sKey ] );

development/factory/_abstract/_view/AdminPageFramework_PageLoadInfo_Base.php

Doc Comments +1 added lines, -1 removed lines

@@ -109,7 +109,7 @@
          * Converts bytes to HR.
          *
          * @access private
-         * @param mixed $bytes
+         * @param mixed $nBytes
          * @remark This is influenced by the work of Mike Jolley.
          * @see http://mikejolley.com/projects/wp-page-load-stats/
          */

Spacing +9 added lines, -9 removed lines

@@ -19,7 +19,7 @@ 
     
     function __construct( $oProp, $oMsg ) {
         
-        if ( $oProp->bIsAdminAjax || ! $oProp->bIsAdmin ) {
+        if ( $oProp->bIsAdminAjax || !$oProp->bIsAdmin ) {
             return;
         }     
         
@@ -58,7 +58,7 @@ 
         self::$_bLoadedPageLoadInfo = true;     
         
         $_nSeconds                 = timer_stop( 0 );
-        $_nQueryCount             = get_num_queries();
+        $_nQueryCount = get_num_queries();
         $_nMemoryUsage             = round( $this->_convertBytesToHR( memory_get_usage() ), 2 );
         $_nMemoryPeakUsage         = round( $this->_convertBytesToHR( memory_get_peak_usage() ), 2 );
         $_nMemoryLimit             = round( $this->_convertBytesToHR( $this->_convertToNumber( WP_MEMORY_LIMIT ) ), 2 );
@@ -67,10 +67,10 @@ 
         return $sFooterHTML
             . "<div id='admin-page-framework-page-load-stats'>"
                 . "<ul>"
-                    . "<li>" . sprintf( $this->oMsg->get( 'queries_in_seconds' ), $_nQueryCount, $_nSeconds ) . "</li>"
-                    . "<li>" . sprintf( $this->oMsg->get( 'out_of_x_memory_used' ), $_nMemoryUsage, $_nMemoryLimit, round( ( $_nMemoryUsage / $_nMemoryLimit ), 2 ) * 100 . '%' ) . "</li>"
-                    . "<li>" . sprintf( $this->oMsg->get( 'peak_memory_usage' ), $_nMemoryPeakUsage ) . "</li>"
-                    . "<li>" . sprintf( $this->oMsg->get( 'initial_memory_usage' ), $_sInitialMemoryUsage ) . "</li>"
+                    . "<li>".sprintf( $this->oMsg->get( 'queries_in_seconds' ), $_nQueryCount, $_nSeconds )."</li>"
+                    . "<li>".sprintf( $this->oMsg->get( 'out_of_x_memory_used' ), $_nMemoryUsage, $_nMemoryLimit, round( ( $_nMemoryUsage / $_nMemoryLimit ), 2 ) * 100.'%' )."</li>"
+                    . "<li>".sprintf( $this->oMsg->get( 'peak_memory_usage' ), $_nMemoryPeakUsage )."</li>"
+                    . "<li>".sprintf( $this->oMsg->get( 'initial_memory_usage' ), $_sInitialMemoryUsage )."</li>"
                 . "</ul>"
             . "</div>";
         
@@ -88,8 +88,8 @@ 
          */
         private function _convertToNumber( $nSize ) {
             
-            $_nReturn     = substr( $nSize, 0, -1 );
-            switch( strtoupper( substr( $nSize, -1 ) ) ) {
+            $_nReturn = substr( $nSize, 0, -1 );
+            switch ( strtoupper( substr( $nSize, -1 ) ) ) {
                 case 'P':
                     $_nReturn *= 1024;
                 case 'T':
@@ -118,7 +118,7 @@ 
             $_nLog = log( $nBytes, 1024 );
             $_iPower = ( int ) $_nLog;
             $_iSize = pow( 1024, $_nLog - $_iPower );
-            return $_iSize . $_aUnits[ $_iPower ];
+            return $_iSize.$_aUnits[ $_iPower ];
         }
 
 }
\ No newline at end of file

development/factory/_abstract/AdminPageFramework_Factory_Controller.php

Doc Comments +2 added lines, -2 removed lines

@@ -187,7 +187,7 @@ 
      * @access      public
      * @remark      The actual registration will be performed in the `_replyToRegisterSettings()` method with the `admin_menu` hook.
      * @remark      The `$oForm` property should be created in each extended class.
-     * @param       array|string        $aSection       the section array. If a string is passed, it is considered as a target page slug that will be used as a page slug element from the next call so that the element can be omitted.
+     * @param       array|string        $aSectionset       the section array. If a string is passed, it is considered as a target page slug that will be used as a page slug element from the next call so that the element can be omitted.
      * <h4>Section Definition Array</h4>
      * <ul>
      *      <li>**section_id** - (string) the section ID. Avoid using non-alphabetic characters except underscore and numbers.</li>
@@ -299,7 +299,7 @@ 
      * @since        3.0.0   The scope changed to public to indicate the users will use.
      * @return       void
      * @remark       The $oForm property should be created in each extended class.
-     * @param        array|string       $asField        A field definition array or a string of the target section id.
+     * @param        array|string       $asFieldset        A field definition array or a string of the target section id.
     * <h4>Built-in Field Types</h4>
     * <ul>
     *       <li>**text** - a normal field to enter text input.</li>

Braces +3 added lines, -3 removed lines

@@ -169,7 +169,7 @@ 
      */    
     public function addSettingSections( /* $aSection1, $aSection2=null, $_and_more=null */ ) {
         
-        foreach( func_get_args() as $_asSectionset ) { 
+        foreach( func_get_args() as $_asSectionset ) {
             $this->addSettingSection( $_asSectionset ); 
         }
         
@@ -238,7 +238,7 @@ 
      */
     public function addSettingSection( $aSectionset ) {
         
-        if ( ! is_array( $aSectionset ) ) { 
+        if ( ! is_array( $aSectionset ) ) {
             return; 
         }
         
@@ -271,7 +271,7 @@ 
     * @return       void
     */ 
     public function addSettingFields( /* $aField1, $aField2=null, $_and_more=null */ ) {
-        foreach( func_get_args() as $_aFieldset ) { 
+        foreach( func_get_args() as $_aFieldset ) {
             $this->addSettingField( $_aFieldset ); 
         }
     }    

Indentation +276 added lines, -276 removed lines

@@ -258,18 +258,18 @@ 
     }     
         
     /**
-    * Adds form fields.
-    * 
-    * It inserts the given field definition arrays into the class property and later they are parsed when fields are registered. The field definition array requires specific keys. Refer to the parameter section of this method.
-    * 
-    * @since        2.0.0
-    * @since        3.5.3       Removed the parameter declarations as they are caught with the func_get_args().
-    * @remark       Accepts variadic parameters; the number of accepted parameters are not limited to three.
-    * @param        array       the field definition array.
-    * @param        array       (optional) another field array.
-    * @param        array       (optional) add more field arrays to the next parameters as many as necessary.
-    * @return       void
-    */ 
+     * Adds form fields.
+     * 
+     * It inserts the given field definition arrays into the class property and later they are parsed when fields are registered. The field definition array requires specific keys. Refer to the parameter section of this method.
+     * 
+     * @since        2.0.0
+     * @since        3.5.3       Removed the parameter declarations as they are caught with the func_get_args().
+     * @remark       Accepts variadic parameters; the number of accepted parameters are not limited to three.
+     * @param        array       the field definition array.
+     * @param        array       (optional) another field array.
+     * @param        array       (optional) add more field arrays to the next parameters as many as necessary.
+     * @return       void
+     */ 
     public function addSettingFields( /* $aField1, $aField2=null, $_and_more=null */ ) {
         foreach( func_get_args() as $_aFieldset ) { 
             $this->addSettingField( $_aFieldset ); 
@@ -300,248 +300,248 @@ 
      * @return       void
      * @remark       The $oForm property should be created in each extended class.
      * @param        array|string       $asField        A field definition array or a string of the target section id.
-    * <h4>Built-in Field Types</h4>
-    * <ul>
-    *       <li>**text** - a normal field to enter text input.</li>
-    *       <li>**password** - a masked text input field.</li>
-    *       <li>**textarea** - a text input field with multiple lines. It supports rich text editor.</li>
-    *       <li>**radio** - a set of radio buttons that lets the user pick an option.</li>
-    *       <li>**checkbox** - a check box that lets the user enable/disable an item.</li>
-    *       <li>**select** - a drop-down list that lest the user pick one or more item(s) from a list.</li>
-    *       <li>**hidden** - a hidden field that will be useful to insert invisible values.</li>
-    *       <li>**file** - a file uploader that lets the user upload files.</li>
-    *       <li>**image** - a custom text field with the image uploader script that lets the user set the image URL.</li>
-    *       <li>**media** - a custom text field with the media uploader script that lets the user set the file URL.</li>
-    *       <li>**color** - a custom text field with the color picker script.</li>
-    *       <li>**submit** - a submit button that lets the user send the form.</li>
-    *       <li>**export** - a custom submit field that lets the user export the stored data.</li>
-    *       <li>**import** - a custom combination field of the file and the submit fields that let the user import data.</li>
-    *       <li>**posttype** - a check-list of post types enabled on the site.</li>
-    *       <li>**taxonomy** - a set of check-lists of taxonomies enabled on the site in a tabbed box.</li>
-    *       <li>**size** - a combination field of the text and the select fields that let the user set sizes with a selectable unit.</li>
-    *       <li>**section_title** - [3.0.0+] a text field type that will be placed in the section title so that it lets the user set the section title. Note that only one field with this field type is allowed per a section.</li>
-    *       <li>**system** - [3.3.0+] a custom textara field that displays the system information including the PHP settings, the framework version, MySQL version etc.</li>
-    * </ul>
-    * <h4>Field Definition Array</h4>
-    * <ul>
-    *       <li>**field_id** - ( required, string) the field ID. Avoid using non-alphabetic characters except underscore and numbers.</li>
-    *       <li>**type** - ( required, string) the type of the field. The supported types are listed below.</li>
-    *       <li>**section_id** - (optional, string) the section ID that the field belongs to. If not set, the internal `_default` section ID will be assigned.</li>
-    *       <li>**title** - (optional, string) the title of the section.</li>
-    *       <li>**description** - (optional, string) the description of the field which is inserted into the after the input field tag.</li>
-    *       <li>**tip** - (optional, string) the tip for the field which is displayed when the mouse is hovered over the field title.</li>
-    *       <li>**capability** - (optional, string) the <a href="http://codex.wordpress.org/Roles_and_Capabilities">access level</a> of the section. If the page visitor does not have sufficient capability, the section will be invisible to them.</li>
-    *       <li>**error_message** - (optional, string) the error message to display above the input field.</li>
-    *       <li>**before_field** - (optional, string) the HTML string to insert before the input field output.</li>
-    *       <li>**after_field** - (optional, string) the HTML string to insert after the input field output.</li>
-    *       <li>**if** - (optional, boolean) if the passed value is false, the section will not be registered.</li>
-    *       <li>**order** - (optional, integer) the order number of the section. The higher the number is, the lower the position it gets.</li>
-    *       <li>**label** - (optional, string) the text label(s) associated with and displayed along with the input field. Some input types can ignore this key.</li>
-    *       <li>**default** - (optional, string|array) the default value(s) assigned to the input tag's value attribute.</li>
-    *       <li>**value** - (optional, string|array) the value(s) assigned to the input tag's `value` attribute to override the default and the stored value.</li>
-    *       <li>**delimiter** - (optional, string) the HTML string that delimits multiple elements. This is available if the <var>label</var> key is passed as array. It will be enclosed in inline-block elements so the passed HTML string should not contain block elements.</li>
-    *       <li>**before_input** - (optional, string) the HTML string inserted right before the input tag. It will be enclosed in the <code>label</code> tag so the passed HTML string should not contain block elements.</li>
-    *       <li>**after_input** - (optional, string) the HTML string inserted right after the input tag. It will be enclosed in the <code>label</code> tag so the passed HTML string should not contain block elements.</li>
-    *       <li>**label_min_width** - (optional, string) the inline style property of the `min-width` of the label tag for the field. If the unit is not specified, 'px' is applied. Default: `120`. e.g. `100%`</li> 
-    *       <li>**help** - (optional, string) the help description added to the contextual help tab.</li>
-    *       <li>**help_aside** - (optional, string) the additional help description for the side bar of the contextual help tab.</li>
-    *       <li>**repeatable** - [3.0.0+] (optional, array|boolean) whether the fields should be repeatable. If it yields true, the plus and the minus buttons appear next to each field that lets the user add/remove the fields. Optionally an setting array can be passed.
-    *           <h5>Repeatable Fields Setting Array</h5>
-    *           <ul>
-    *                 <li>**max** - the allowed maximum number of fields to be repeated.</li>
-    *                 <li>**min** - the allowed minimum number of fields to be repeated.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**sortable** - [3.0.0+] (optional, boolean) whether the fields should be sortable. If it yields true, the fields will be enclosed in a draggable box.
-    *       <li>**attributes** - [3.0.0+] (optional, array) holds key-value pairs representing the attribute and its property. Note that some field types have specific keys in the first dimensions. e.g. `array( 'class' => 'my_custom_class_selector', 'style' => 'background-color:#777', 'size' => 20, )` Every field holds the following nested attribute definition arrays.
-    *           <ul>
-    *               <li>**fieldrow** - the `td` tag element containing the field output.</li>
-    *               <li>**fieldset** - the `fieldset` tag element containing the field output.</li>
-    *               <li>**fields** - the `div` tag element containing the sub-fields and the main field.</li>
-    *               <li>**field** - the `div` tag element containing each field.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**show_title_column** - [3.0.0+] (optional, boolean) If true, the field title column will be omitted from the output.</li>
-    *       <li>**hidden** - [3.0.0+] (optional, boolean) If true, the entire field row output will be invisible with the inline style attribute of `style="display:none"`.</li>
-    *       <li>**save** - [3.6.0+] (optional, boolean) If `false`, the field value will not be saved. Default: `true`</li>
-    *       <li>**content** - (optional, string) [3.6.1+] a custom section output.</li>
-    * </ul>
-    * 
-    * <h4>Field Type Specific Arguments</h4>
-    * <p>Each field type uses specific array arguments.</p>
-    * <ul>
-    *       <li>**text** - a text input field which allows the user to type text.</li>
-    *       <li>**password** - a password input field which allows the user to type text.</li>
-    *       <li>**number, range** - HTML5 input field types. Some browsers do not support these.</li>
-    *       <li>**textarea** - a textarea input field. The following array keys are supported.
-    *           <ul>
-    *               <li>**rich** - [2.1.2+] (optional, array) to make it a rich text editor pass a non-empty value. It accept a setting array of the <code>_WP_Editors</code> class defined in the core.
-    * For more information, see the argument section of <a href="http://codex.wordpress.org/Function_Reference/wp_editor" target="_blank">this page</a>.
-    *               </li>
-    *           </ul>
-    *       </li>
-    *       <li>**radio** - a radio button input field.</li>
-    *       <li>**checkbox** - a check box input field.</li>
-    *           <ul>
-    *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *           </ul>
-    *       <li>**select** - a drop-down input field.
-    *           <ul>
-    *               <li>**is_multiple** - (optional, boolean) if this is set to true, the `multiple` attribute will be inserted into the field input tag, which enables the multiple selections for the user.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**size** - a size input field. This is a combination of number and select fields.
-    *           <ul>
-    *               <li>
-    *                   **units** - (optional, array) defines the units to show. e.g. `array( 'px' => 'px', '%' => '%', 'em' => 'em'  )` 
-    *                   Default: `array( 'px' => 'px', '%' => '%', 'em' => 'em', 'ex' => 'ex', 'in' => 'in', 'cm' => 'cm', 'mm' => 'mm', 'pt' => 'pt', 'pc' => 'pc' )`
-    *               </li>
-    *               <li>**is_multiple** - (optional, boolean) if this is set to true, the `multiple` attribute will be inserted into the field input tag, which enables the multiple selections for the user.</li>
-    *               <li>**attributes** - [3.0.0+] (optional, array) The attributes array of this field type has four initial keys: size, unit, optgroup, and option and they have a regular attribute array in each.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**hidden** - a hidden input field.</li>
-    *       <li>**file** - a file upload input field.</li>
-    *       <li>**submit** - a submit button input field.
-    *           <ul>
-    *               <li>**href** - (optional, string) the url(s) linked to the submit button.</li>
-    *               <li>**redirect_url** - (optional, string) the url(s) redirected to after submitting the input form.</li>
-    *               <li>**reset** - [2.1.2+] (optional, boolean|string|array) the option key to delete. Set 1 for the entire option. [3.5.3+] In order to reset a particular field that belongs to a section, set an array representing the dimensional keys such as `array( 'my_sectio_id', 'my_field_id' )`.</li>
-    *               <li>**email** - [3.3.0+] (optional, array) Coming soon...
-    *                   <ul>
-    *                       <li>**to** - (string|array) the email address to send the email to. For multiple email addressed, set comma delimited items.</li>
-    *                       <li>**subject** - (string|array) the email title.</li>
-    *                       <li>**message** - (string|array) the email body text.</li>
-    *                       <li>**attachments** - (string|array) the file path.</li>
-    *                       <li>**name** - (string|array) the sender name.</li>
-    *                       <li>**from** - (string|array) the sender email.</li>
-    *                       <li>**is_html** - (boolean|array) indicates whether the message should be sent as an html or plain text.</li>
-    *                   </ul>
-    *               </li>
-    *           </ul>
-    *       </li>
-    *       <li>**import** - an import input field. This is a custom file and submit field.
-    *           <ul>
-    *               <li>**option_key** - (optional, string) the option table key to save the importing data.</li>
-    *               <li>**format** - (optional, string) the import format. json, or array is supported. Default: array</li>
-    *               <li>**is_merge** - (optional, boolean) [2.0.5+] determines whether the imported data should be merged with the existing options.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**export** - an export input field. This is a custom submit field.
-    *           <ul>
-    *               <li>**file_name** - (optional, string) the file name to download.</li>
-    *               <li>**format** - (optional, string) the format type. array, json, or text is supported. Default: array.</li>
-    *               <li>**data** - (optional, string|array|object ) the data to export.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**image** - an image input field. This is a custom text field with an attached JavaScript script.
-    *           <ul>
-    *               <li>**show_preview** - (optional, boolean) if this is set to false, the image preview will be disabled.</li>
-    *               <li>**attributes_to_store** - [2.1.3+] (optional, array) the array of the attribute names of the image to save. If this is set, the field will be an array with the specified attributes. The supported attributes are, 'title', 'alt', 'width', 'height', 'caption', 'id', 'align', and 'link'. Note that for external URLs, ID will not be captured. e.g. `'attributes_to_store' => array( 'id', 'caption', 'description' )`</li>
-    *               <li>**allow_external_source** - [2.1.3+] (optional, boolean) whether external URL can be set via the uploader.</li>
-    *               <li>**attributes** - [3.0.0+] (optional, array) The attributes array of this field type has three keys: input, button, and preview and they have a regular attribute array in each.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**media** - [2.1.3+] a media input field. This is a custom text field with an attached JavaScript script.
-    *           <ul>
-    *               <li>**attributes_to_store** - [2.1.3+] (optional, array) the array of the attribute names of the image to save. If this is set, the field will be an array with the specified attributes. The supported attributes are, 'id', 'caption', and 'description'. Note that for external URLs, ID will not be captured. e.g. `'attributes_to_store' => array( 'id', 'caption', 'description' )`</li>
-    *               <li>**allow_external_source** - [2.1.3+] (optional, boolean) whether external URL can be set via the uploader.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**color** - a color picker input field. This is a custom text field with a JavaScript script.</li>
-    *       <li>**taxonomy** - a taxonomy check list. This is a set of check boxes listing a specified taxonomy. This does not accept to create multiple fields by passing an array of labels.
-    *           <ul>
-    *               <li>**taxonomy_slugs** - (optional, array) the taxonomy slug to list.</li>
-    *               <li>**max_width** - (optional, string) the inline style property value of `max-width` of this element. Include the unit such as px, %. Default: 100%</li>
-    *               <li>**height** - (optional, string) the inline style property value of `height` of this element. Include the unit such as px, %. Default: 250px</li>
-    *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *               <li>**label_no_term_found** - [3.3.2+] (optional, string) The label to display when no term is found. Default: `No Term Found`.</li>
-    *               <li>**label_list_title** - [3.3.2+] (optional, string) The heading title string for a term list. Default: `''`. Insert an HTML custom string right before the list starts.</li>
-    *               <li>**query** - [3.3.2+] (optional, array) the query array to search terms. For more details, see the argument of the [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters) function.
-    *                   <ul>
-    *                       <li>child_of - (integer) The parent term ID. All the descendant terms such as child's child term will be listed. default: `0`</li>
-    *                       <li>parent   - (integer) The direct parent term ID. Only the first level children will be listed. default: ``</li>
-    *                       <li>orderby - (string) The type of how the term list should be ordered by. Either `ID`, `term_id`, or `name` can be accepted. Default: `name`.</li>
-    *                       <li>order - (string) The order of the list. `ASC` or `DESC`. Default: `ASC`.</li>
-    *                       <li>hide_empty - (boolean) whether to show the terms with no post associated. Default: `false`.</li>
-    *                       <li>hierarchical - (boolean) whether to show the terms as a hierarchical tree. Default: `true`</li>
-    *                       <li>number - (integer) The maximum number of the terms to show. 0 for no limit. Default: `0`.</li>
-    *                       <li>pad_counts - (boolean) whether to sum up the post counts with the child post counts. Default: `false`</li>
-    *                       <li>exclude - (string|array) Comma separated term IDs or an array to exclude from the list. for example `1` will remove the 'Uncategorized' category from the list. </li>
-    *                       <li>exclude_tree - (integer) For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters)..</li>
-    *                       <li>include - (string|array) Comma separated term IDs to include in the list.</li>
-    *                       <li>fields - (string) Default: `all`. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>slug - (string) Default: ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>get - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>name__like - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>description__like - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>offset - (integer) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                       <li>search - (string) The search keyword to get the term with. Default ``.</li>
-    *                       <li>cache_domain - (string) Default:`core`. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
-    *                   </ul>
-    *               </li>
-    *               <li>**queries** - [3.3.2+] (optional, array) Allows to set a query argument for each taxonomy. The array key must be the taxonomy slug and the value is the query argument array.</li>
-    *           </ul>
-    *           <h4>Example</h4>
-    * <pre><code>array(  
-    *     'field_id'              => 'taxonomy_custom_queries',
-    *     'title'                 => __( 'Custom Taxonomy Queries', 'admin-page-framework-demo' ),
-    *     'type'                  => 'taxonomy',
-    *     'description'           => 
-    *         array(
-    *             __( 'With the <code>query</code> argument array, you can customize how the terms should be retrieved.', 'admin-page-framework-demo' ),
-    *             sprintf( __( 'For the structure and the array key specifications, refer to the parameter section of the <a href="%1$s" target="_blank">get_term()</a> function.', 'admin-page-framework-demo' ), 'http://codex.wordpress.org/Function_Reference/get_terms#Parameters' ),
-    *         ),
-    *     
-    *     // (required)   Determines which taxonomies should be listed
-    *     'taxonomy_slugs'        => $aTaxnomies = get_taxonomies( '', 'names' ),    
-    *         
-    *     // (optional) This defines the default query argument. For the structure and supported arguments, see http://codex.wordpress.org/Function_Reference/get_terms#Parameters
-    *     'query'                 => array(
-    *         'depth'     => 2,
-    *         'orderby'   => 'term_id',       // accepts 'ID', 'term_id', or 'name'
-    *         'order'     => 'DESC',
-    *         // 'exclude'   => '1', // removes the 'Uncategorized' category.
-    *         // 'search' => 'PHP',   // the search keyward
-    *         // 'parent'    => 9,    // only show terms whose direct parent ID is 9.
-    *         // 'child_of'  => 8,    // only show child terms of the term ID of 8.
-    *     ),
-    *     // (optional) This allows to set a query argument for each taxonomy. 
-    *     // Note that each element will be merged with the above default 'query' argument array. 
-    *     // So unset keys here will be overridden by the default argument array above. 
-    *     'queries'               => array(
-    *         // taxonomy slug => query argument array
-    *         'category'  =>  array(
-    *             'depth'     => 2,
-    *             'orderby'   => 'term_id',  
-    *             'order'     => 'DESC',
-    *             'exclude'   => array( 1 ), 
-    *         ),
-    *         'post_tag'  => array(
-    *             'orderby'   => 'name',
-    *             'order'     => 'ASC',
-    *             // 'include'   => array( 4, ), // term ids
-    *         ),
-    *     ), 
-    * ),
-    * </code></pre>
-    *       </li>
-    *       <li>**posttype** - a post-type check list. This is a set of check boxes listing post type slugs.
-    *           <ul>
-    *               <li>**slugs_to_remove** - (optional, array) the post type slugs not to be listed. e.g.`array( 'revision', 'attachment', 'nav_menu_item' )`</li>
-    *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
-    *           </ul>
-    *       </li>
-    *       <li>**system** - [3.3.0+] a custom textara field that displays system information.
-    *           <ul>
-    *               <li>**data** - (optional, array) an associative array ta that holds the data to display.</li>
-    *               <li>**print_type** - [3.3.6+] (optional, integer) Indicates how the data array should be displayed. 1: readable array representation. 2. the output of the print_r() function. Default: `1`.</li>
-    *           </ul>
-    *       </li>
-    * </ul>    
+     * <h4>Built-in Field Types</h4>
+     * <ul>
+     *       <li>**text** - a normal field to enter text input.</li>
+     *       <li>**password** - a masked text input field.</li>
+     *       <li>**textarea** - a text input field with multiple lines. It supports rich text editor.</li>
+     *       <li>**radio** - a set of radio buttons that lets the user pick an option.</li>
+     *       <li>**checkbox** - a check box that lets the user enable/disable an item.</li>
+     *       <li>**select** - a drop-down list that lest the user pick one or more item(s) from a list.</li>
+     *       <li>**hidden** - a hidden field that will be useful to insert invisible values.</li>
+     *       <li>**file** - a file uploader that lets the user upload files.</li>
+     *       <li>**image** - a custom text field with the image uploader script that lets the user set the image URL.</li>
+     *       <li>**media** - a custom text field with the media uploader script that lets the user set the file URL.</li>
+     *       <li>**color** - a custom text field with the color picker script.</li>
+     *       <li>**submit** - a submit button that lets the user send the form.</li>
+     *       <li>**export** - a custom submit field that lets the user export the stored data.</li>
+     *       <li>**import** - a custom combination field of the file and the submit fields that let the user import data.</li>
+     *       <li>**posttype** - a check-list of post types enabled on the site.</li>
+     *       <li>**taxonomy** - a set of check-lists of taxonomies enabled on the site in a tabbed box.</li>
+     *       <li>**size** - a combination field of the text and the select fields that let the user set sizes with a selectable unit.</li>
+     *       <li>**section_title** - [3.0.0+] a text field type that will be placed in the section title so that it lets the user set the section title. Note that only one field with this field type is allowed per a section.</li>
+     *       <li>**system** - [3.3.0+] a custom textara field that displays the system information including the PHP settings, the framework version, MySQL version etc.</li>
+     * </ul>
+     * <h4>Field Definition Array</h4>
+     * <ul>
+     *       <li>**field_id** - ( required, string) the field ID. Avoid using non-alphabetic characters except underscore and numbers.</li>
+     *       <li>**type** - ( required, string) the type of the field. The supported types are listed below.</li>
+     *       <li>**section_id** - (optional, string) the section ID that the field belongs to. If not set, the internal `_default` section ID will be assigned.</li>
+     *       <li>**title** - (optional, string) the title of the section.</li>
+     *       <li>**description** - (optional, string) the description of the field which is inserted into the after the input field tag.</li>
+     *       <li>**tip** - (optional, string) the tip for the field which is displayed when the mouse is hovered over the field title.</li>
+     *       <li>**capability** - (optional, string) the <a href="http://codex.wordpress.org/Roles_and_Capabilities">access level</a> of the section. If the page visitor does not have sufficient capability, the section will be invisible to them.</li>
+     *       <li>**error_message** - (optional, string) the error message to display above the input field.</li>
+     *       <li>**before_field** - (optional, string) the HTML string to insert before the input field output.</li>
+     *       <li>**after_field** - (optional, string) the HTML string to insert after the input field output.</li>
+     *       <li>**if** - (optional, boolean) if the passed value is false, the section will not be registered.</li>
+     *       <li>**order** - (optional, integer) the order number of the section. The higher the number is, the lower the position it gets.</li>
+     *       <li>**label** - (optional, string) the text label(s) associated with and displayed along with the input field. Some input types can ignore this key.</li>
+     *       <li>**default** - (optional, string|array) the default value(s) assigned to the input tag's value attribute.</li>
+     *       <li>**value** - (optional, string|array) the value(s) assigned to the input tag's `value` attribute to override the default and the stored value.</li>
+     *       <li>**delimiter** - (optional, string) the HTML string that delimits multiple elements. This is available if the <var>label</var> key is passed as array. It will be enclosed in inline-block elements so the passed HTML string should not contain block elements.</li>
+     *       <li>**before_input** - (optional, string) the HTML string inserted right before the input tag. It will be enclosed in the <code>label</code> tag so the passed HTML string should not contain block elements.</li>
+     *       <li>**after_input** - (optional, string) the HTML string inserted right after the input tag. It will be enclosed in the <code>label</code> tag so the passed HTML string should not contain block elements.</li>
+     *       <li>**label_min_width** - (optional, string) the inline style property of the `min-width` of the label tag for the field. If the unit is not specified, 'px' is applied. Default: `120`. e.g. `100%`</li> 
+     *       <li>**help** - (optional, string) the help description added to the contextual help tab.</li>
+     *       <li>**help_aside** - (optional, string) the additional help description for the side bar of the contextual help tab.</li>
+     *       <li>**repeatable** - [3.0.0+] (optional, array|boolean) whether the fields should be repeatable. If it yields true, the plus and the minus buttons appear next to each field that lets the user add/remove the fields. Optionally an setting array can be passed.
+     *           <h5>Repeatable Fields Setting Array</h5>
+     *           <ul>
+     *                 <li>**max** - the allowed maximum number of fields to be repeated.</li>
+     *                 <li>**min** - the allowed minimum number of fields to be repeated.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**sortable** - [3.0.0+] (optional, boolean) whether the fields should be sortable. If it yields true, the fields will be enclosed in a draggable box.
+     *       <li>**attributes** - [3.0.0+] (optional, array) holds key-value pairs representing the attribute and its property. Note that some field types have specific keys in the first dimensions. e.g. `array( 'class' => 'my_custom_class_selector', 'style' => 'background-color:#777', 'size' => 20, )` Every field holds the following nested attribute definition arrays.
+     *           <ul>
+     *               <li>**fieldrow** - the `td` tag element containing the field output.</li>
+     *               <li>**fieldset** - the `fieldset` tag element containing the field output.</li>
+     *               <li>**fields** - the `div` tag element containing the sub-fields and the main field.</li>
+     *               <li>**field** - the `div` tag element containing each field.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**show_title_column** - [3.0.0+] (optional, boolean) If true, the field title column will be omitted from the output.</li>
+     *       <li>**hidden** - [3.0.0+] (optional, boolean) If true, the entire field row output will be invisible with the inline style attribute of `style="display:none"`.</li>
+     *       <li>**save** - [3.6.0+] (optional, boolean) If `false`, the field value will not be saved. Default: `true`</li>
+     *       <li>**content** - (optional, string) [3.6.1+] a custom section output.</li>
+     * </ul>
+     * 
+     * <h4>Field Type Specific Arguments</h4>
+     * <p>Each field type uses specific array arguments.</p>
+     * <ul>
+     *       <li>**text** - a text input field which allows the user to type text.</li>
+     *       <li>**password** - a password input field which allows the user to type text.</li>
+     *       <li>**number, range** - HTML5 input field types. Some browsers do not support these.</li>
+     *       <li>**textarea** - a textarea input field. The following array keys are supported.
+     *           <ul>
+     *               <li>**rich** - [2.1.2+] (optional, array) to make it a rich text editor pass a non-empty value. It accept a setting array of the <code>_WP_Editors</code> class defined in the core.
+     * For more information, see the argument section of <a href="http://codex.wordpress.org/Function_Reference/wp_editor" target="_blank">this page</a>.
+     *               </li>
+     *           </ul>
+     *       </li>
+     *       <li>**radio** - a radio button input field.</li>
+     *       <li>**checkbox** - a check box input field.</li>
+     *           <ul>
+     *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *           </ul>
+     *       <li>**select** - a drop-down input field.
+     *           <ul>
+     *               <li>**is_multiple** - (optional, boolean) if this is set to true, the `multiple` attribute will be inserted into the field input tag, which enables the multiple selections for the user.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**size** - a size input field. This is a combination of number and select fields.
+     *           <ul>
+     *               <li>
+     *                   **units** - (optional, array) defines the units to show. e.g. `array( 'px' => 'px', '%' => '%', 'em' => 'em'  )` 
+     *                   Default: `array( 'px' => 'px', '%' => '%', 'em' => 'em', 'ex' => 'ex', 'in' => 'in', 'cm' => 'cm', 'mm' => 'mm', 'pt' => 'pt', 'pc' => 'pc' )`
+     *               </li>
+     *               <li>**is_multiple** - (optional, boolean) if this is set to true, the `multiple` attribute will be inserted into the field input tag, which enables the multiple selections for the user.</li>
+     *               <li>**attributes** - [3.0.0+] (optional, array) The attributes array of this field type has four initial keys: size, unit, optgroup, and option and they have a regular attribute array in each.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**hidden** - a hidden input field.</li>
+     *       <li>**file** - a file upload input field.</li>
+     *       <li>**submit** - a submit button input field.
+     *           <ul>
+     *               <li>**href** - (optional, string) the url(s) linked to the submit button.</li>
+     *               <li>**redirect_url** - (optional, string) the url(s) redirected to after submitting the input form.</li>
+     *               <li>**reset** - [2.1.2+] (optional, boolean|string|array) the option key to delete. Set 1 for the entire option. [3.5.3+] In order to reset a particular field that belongs to a section, set an array representing the dimensional keys such as `array( 'my_sectio_id', 'my_field_id' )`.</li>
+     *               <li>**email** - [3.3.0+] (optional, array) Coming soon...
+     *                   <ul>
+     *                       <li>**to** - (string|array) the email address to send the email to. For multiple email addressed, set comma delimited items.</li>
+     *                       <li>**subject** - (string|array) the email title.</li>
+     *                       <li>**message** - (string|array) the email body text.</li>
+     *                       <li>**attachments** - (string|array) the file path.</li>
+     *                       <li>**name** - (string|array) the sender name.</li>
+     *                       <li>**from** - (string|array) the sender email.</li>
+     *                       <li>**is_html** - (boolean|array) indicates whether the message should be sent as an html or plain text.</li>
+     *                   </ul>
+     *               </li>
+     *           </ul>
+     *       </li>
+     *       <li>**import** - an import input field. This is a custom file and submit field.
+     *           <ul>
+     *               <li>**option_key** - (optional, string) the option table key to save the importing data.</li>
+     *               <li>**format** - (optional, string) the import format. json, or array is supported. Default: array</li>
+     *               <li>**is_merge** - (optional, boolean) [2.0.5+] determines whether the imported data should be merged with the existing options.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**export** - an export input field. This is a custom submit field.
+     *           <ul>
+     *               <li>**file_name** - (optional, string) the file name to download.</li>
+     *               <li>**format** - (optional, string) the format type. array, json, or text is supported. Default: array.</li>
+     *               <li>**data** - (optional, string|array|object ) the data to export.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**image** - an image input field. This is a custom text field with an attached JavaScript script.
+     *           <ul>
+     *               <li>**show_preview** - (optional, boolean) if this is set to false, the image preview will be disabled.</li>
+     *               <li>**attributes_to_store** - [2.1.3+] (optional, array) the array of the attribute names of the image to save. If this is set, the field will be an array with the specified attributes. The supported attributes are, 'title', 'alt', 'width', 'height', 'caption', 'id', 'align', and 'link'. Note that for external URLs, ID will not be captured. e.g. `'attributes_to_store' => array( 'id', 'caption', 'description' )`</li>
+     *               <li>**allow_external_source** - [2.1.3+] (optional, boolean) whether external URL can be set via the uploader.</li>
+     *               <li>**attributes** - [3.0.0+] (optional, array) The attributes array of this field type has three keys: input, button, and preview and they have a regular attribute array in each.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**media** - [2.1.3+] a media input field. This is a custom text field with an attached JavaScript script.
+     *           <ul>
+     *               <li>**attributes_to_store** - [2.1.3+] (optional, array) the array of the attribute names of the image to save. If this is set, the field will be an array with the specified attributes. The supported attributes are, 'id', 'caption', and 'description'. Note that for external URLs, ID will not be captured. e.g. `'attributes_to_store' => array( 'id', 'caption', 'description' )`</li>
+     *               <li>**allow_external_source** - [2.1.3+] (optional, boolean) whether external URL can be set via the uploader.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**color** - a color picker input field. This is a custom text field with a JavaScript script.</li>
+     *       <li>**taxonomy** - a taxonomy check list. This is a set of check boxes listing a specified taxonomy. This does not accept to create multiple fields by passing an array of labels.
+     *           <ul>
+     *               <li>**taxonomy_slugs** - (optional, array) the taxonomy slug to list.</li>
+     *               <li>**max_width** - (optional, string) the inline style property value of `max-width` of this element. Include the unit such as px, %. Default: 100%</li>
+     *               <li>**height** - (optional, string) the inline style property value of `height` of this element. Include the unit such as px, %. Default: 250px</li>
+     *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *               <li>**label_no_term_found** - [3.3.2+] (optional, string) The label to display when no term is found. Default: `No Term Found`.</li>
+     *               <li>**label_list_title** - [3.3.2+] (optional, string) The heading title string for a term list. Default: `''`. Insert an HTML custom string right before the list starts.</li>
+     *               <li>**query** - [3.3.2+] (optional, array) the query array to search terms. For more details, see the argument of the [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters) function.
+     *                   <ul>
+     *                       <li>child_of - (integer) The parent term ID. All the descendant terms such as child's child term will be listed. default: `0`</li>
+     *                       <li>parent   - (integer) The direct parent term ID. Only the first level children will be listed. default: ``</li>
+     *                       <li>orderby - (string) The type of how the term list should be ordered by. Either `ID`, `term_id`, or `name` can be accepted. Default: `name`.</li>
+     *                       <li>order - (string) The order of the list. `ASC` or `DESC`. Default: `ASC`.</li>
+     *                       <li>hide_empty - (boolean) whether to show the terms with no post associated. Default: `false`.</li>
+     *                       <li>hierarchical - (boolean) whether to show the terms as a hierarchical tree. Default: `true`</li>
+     *                       <li>number - (integer) The maximum number of the terms to show. 0 for no limit. Default: `0`.</li>
+     *                       <li>pad_counts - (boolean) whether to sum up the post counts with the child post counts. Default: `false`</li>
+     *                       <li>exclude - (string|array) Comma separated term IDs or an array to exclude from the list. for example `1` will remove the 'Uncategorized' category from the list. </li>
+     *                       <li>exclude_tree - (integer) For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters)..</li>
+     *                       <li>include - (string|array) Comma separated term IDs to include in the list.</li>
+     *                       <li>fields - (string) Default: `all`. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>slug - (string) Default: ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>get - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>name__like - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>description__like - (string) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>offset - (integer) Default ``. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                       <li>search - (string) The search keyword to get the term with. Default ``.</li>
+     *                       <li>cache_domain - (string) Default:`core`. For more details see [get_terms()](http://codex.wordpress.org/Function_Reference/get_terms#Parameters).</li>
+     *                   </ul>
+     *               </li>
+     *               <li>**queries** - [3.3.2+] (optional, array) Allows to set a query argument for each taxonomy. The array key must be the taxonomy slug and the value is the query argument array.</li>
+     *           </ul>
+     *           <h4>Example</h4>
+     * <pre><code>array(  
+     *     'field_id'              => 'taxonomy_custom_queries',
+     *     'title'                 => __( 'Custom Taxonomy Queries', 'admin-page-framework-demo' ),
+     *     'type'                  => 'taxonomy',
+     *     'description'           => 
+     *         array(
+     *             __( 'With the <code>query</code> argument array, you can customize how the terms should be retrieved.', 'admin-page-framework-demo' ),
+     *             sprintf( __( 'For the structure and the array key specifications, refer to the parameter section of the <a href="%1$s" target="_blank">get_term()</a> function.', 'admin-page-framework-demo' ), 'http://codex.wordpress.org/Function_Reference/get_terms#Parameters' ),
+     *         ),
+     *     
+     *     // (required)   Determines which taxonomies should be listed
+     *     'taxonomy_slugs'        => $aTaxnomies = get_taxonomies( '', 'names' ),    
+     *         
+     *     // (optional) This defines the default query argument. For the structure and supported arguments, see http://codex.wordpress.org/Function_Reference/get_terms#Parameters
+     *     'query'                 => array(
+     *         'depth'     => 2,
+     *         'orderby'   => 'term_id',       // accepts 'ID', 'term_id', or 'name'
+     *         'order'     => 'DESC',
+     *         // 'exclude'   => '1', // removes the 'Uncategorized' category.
+     *         // 'search' => 'PHP',   // the search keyward
+     *         // 'parent'    => 9,    // only show terms whose direct parent ID is 9.
+     *         // 'child_of'  => 8,    // only show child terms of the term ID of 8.
+     *     ),
+     *     // (optional) This allows to set a query argument for each taxonomy. 
+     *     // Note that each element will be merged with the above default 'query' argument array. 
+     *     // So unset keys here will be overridden by the default argument array above. 
+     *     'queries'               => array(
+     *         // taxonomy slug => query argument array
+     *         'category'  =>  array(
+     *             'depth'     => 2,
+     *             'orderby'   => 'term_id',  
+     *             'order'     => 'DESC',
+     *             'exclude'   => array( 1 ), 
+     *         ),
+     *         'post_tag'  => array(
+     *             'orderby'   => 'name',
+     *             'order'     => 'ASC',
+     *             // 'include'   => array( 4, ), // term ids
+     *         ),
+     *     ), 
+     * ),
+     * </code></pre>
+     *       </li>
+     *       <li>**posttype** - a post-type check list. This is a set of check boxes listing post type slugs.
+     *           <ul>
+     *               <li>**slugs_to_remove** - (optional, array) the post type slugs not to be listed. e.g.`array( 'revision', 'attachment', 'nav_menu_item' )`</li>
+     *               <li>**select_all_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select All` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *               <li>**select_none_button** - [3.3.0+] (optional, array) pass `true` to enable the `Select None` button. To set a custom label, set the text such as `__( 'Check All', 'test-domain' )`. Default: `true`.</li>
+     *           </ul>
+     *       </li>
+     *       <li>**system** - [3.3.0+] a custom textara field that displays system information.
+     *           <ul>
+     *               <li>**data** - (optional, array) an associative array ta that holds the data to display.</li>
+     *               <li>**print_type** - [3.3.6+] (optional, integer) Indicates how the data array should be displayed. 1: readable array representation. 2. the output of the print_r() function. Default: `1`.</li>
+     *           </ul>
+     *       </li>
+     * </ul>    
      */     
     public function addSettingField( $asFieldset ) {
         if ( method_exists( $this->oForm, 'addField' ) ) {
@@ -626,28 +626,28 @@ 
     }
     
     /**
-    * Sets the given message to be displayed in the next page load. 
-    * 
-    * This is used to inform users about the submitted input data, such as "Updated successfully." or "Problem occurred." etc. 
-    * and normally used in validation callback methods.
-    * 
-    * <h4>Example</h4>
-    * `
-    * if ( ! $bVerified ) {
-    *       $this->setFieldErrors( $aErrors );     
-    *       $this->setSettingNotice( 'There was an error in your input.' );
-    *       return $aOldPageOptions;
-    * }
-    * `
-    *
-    * @since        3.0.4     
-    * @access       public
-    * @param        string      $sMessage       the text message to be displayed.
-    * @param        string      $sType          (optional) the type of the message, either "error" or "updated"  is used.
-    * @param        array       $asAttributes   (optional) the tag attribute array applied to the message container HTML element. If a string is given, it is used as the ID attribute value.
-    * @param        boolean     $bOverride      (optional) If true, only one message will be shown in the next page load. false: do not override when there is a message of the same id. true: override the previous one.
-    * @return       void
-    */      
+     * Sets the given message to be displayed in the next page load. 
+     * 
+     * This is used to inform users about the submitted input data, such as "Updated successfully." or "Problem occurred." etc. 
+     * and normally used in validation callback methods.
+     * 
+     * <h4>Example</h4>
+     * `
+     * if ( ! $bVerified ) {
+     *       $this->setFieldErrors( $aErrors );     
+     *       $this->setSettingNotice( 'There was an error in your input.' );
+     *       return $aOldPageOptions;
+     * }
+     * `
+     *
+     * @since        3.0.4     
+     * @access       public
+     * @param        string      $sMessage       the text message to be displayed.
+     * @param        string      $sType          (optional) the type of the message, either "error" or "updated"  is used.
+     * @param        array       $asAttributes   (optional) the tag attribute array applied to the message container HTML element. If a string is given, it is used as the ID attribute value.
+     * @param        boolean     $bOverride      (optional) If true, only one message will be shown in the next page load. false: do not override when there is a message of the same id. true: override the previous one.
+     * @return       void
+     */      
     public function setSettingNotice( $sMessage, $sType='error', $asAttributes=array(), $bOverride=true ) {
         $this->oForm->setSubmitNotice(
             $sMessage,

Spacing +11 added lines, -11 removed lines

@@ -43,7 +43,7 @@ 
      * @return      array|string
      * @since       DEVVER
      */
-    public function getMessage( $sKey='' ) {
+    public function getMessage( $sKey = '' ) {
         return $this->oMsg->get( $sKey );
     }
        
@@ -63,7 +63,7 @@ 
      * @return      array       The array holing the queued items.
      * @internal
      */
-    public function enqueueStyles( $aSRCs, $_vArg2=null ) {} 
+    public function enqueueStyles( $aSRCs, $_vArg2 = null ) {} 
     
     /**
      * Enqueues a style of the given source.
@@ -83,7 +83,7 @@ 
      * @return      string      The style handle ID. If the passed url is not a valid url string, an empty string will be returned.
      * @internal
      */
-    public function enqueueStyle( $sSRC, $_vArg2=null ) {}
+    public function enqueueStyle( $sSRC, $_vArg2 = null ) {}
     
     /**
      * Enqueues scripts by the given sources.
@@ -104,7 +104,7 @@ 
      * @return      array        The array holding the queued items.
      * @internal
      */    
-    public function enqueueScripts( $aSRCs, $_vArg2=null ) {}
+    public function enqueueScripts( $aSRCs, $_vArg2 = null ) {}
     /**
      * Enqueues a script by the given source.
      *  
@@ -136,7 +136,7 @@ 
      * @return      string      The script handle ID. If the passed url is not a valid url string, an empty string will be returned.
      * @internal
      */    
-    public function enqueueScript( $sSRC, $_vArg2=null ) {}    
+    public function enqueueScript( $sSRC, $_vArg2 = null ) {}    
     
     /*
      * Help Pane
@@ -154,7 +154,7 @@ 
      * @since       2.1.0
      * @remark      This method just adds the given text into the class property. The actual registration will be performed with the `replyToRegisterHelpTabTextForMetaBox()` method.
      */ 
-    public function addHelpText( $sHTMLContent, $sHTMLSidebarContent="" ) {
+    public function addHelpText( $sHTMLContent, $sHTMLSidebarContent = "" ) {
         if ( method_exists( $this->oHelpPane, '_addHelpText' ) ) {
             $this->oHelpPane->_addHelpText( $sHTMLContent, $sHTMLSidebarContent );
         }
@@ -190,7 +190,7 @@ 
      */    
     public function addSettingSections( /* $aSection1, $aSection2=null, $_and_more=null */ ) {
         
-        foreach( func_get_args() as $_asSectionset ) { 
+        foreach ( func_get_args() as $_asSectionset ) { 
             $this->addSettingSection( $_asSectionset ); 
         }
         
@@ -261,7 +261,7 @@ 
      */
     public function addSettingSection( $aSectionset ) {
         
-        if ( ! is_array( $aSectionset ) ) { 
+        if ( !is_array( $aSectionset ) ) { 
             return; 
         }
         
@@ -294,7 +294,7 @@ 
     * @return       void
     */ 
     public function addSettingFields( /* $aField1, $aField2=null, $_and_more=null */ ) {
-        foreach( func_get_args() as $_aFieldset ) { 
+        foreach ( func_get_args() as $_aFieldset ) { 
             $this->addSettingField( $_aFieldset ); 
         }
     }    
@@ -671,7 +671,7 @@ 
     * @param        boolean     $bOverride      (optional) If true, only one message will be shown in the next page load. false: do not override when there is a message of the same id. true: override the previous one.
     * @return       void
     */      
-    public function setSettingNotice( $sMessage, $sType='error', $asAttributes=array(), $bOverride=true ) {
+    public function setSettingNotice( $sMessage, $sType = 'error', $asAttributes = array(), $bOverride = true ) {
         $this->oForm->setSubmitNotice(
             $sMessage,
             $sType,
@@ -690,7 +690,7 @@ 
      * @param       string      $sType If empty, the method will check if a message exists in all types. Otherwise, it checks the existence of a message of the specified type.
      * @return      boolean     True if a setting notice is set; otherwise, false.
      */
-    public function hasSettingNotice( $sType='' ) {
+    public function hasSettingNotice( $sType = '' ) {
         return $this->oForm->hasSubmitNotice( $sType );
     }
 

development/factory/_abstract/form/_model/formatter/AdminPageFramework_Form_Model___Format_CollapsibleSection.php

Doc Comments +2 added lines

@@ -77,6 +77,8 @@
     }
         /**
          * @since       3.6.0
+         * @param boolean $abCollapsible
+         * @param string $sTitle
          * @return      array
          */
         private function _getArguments( $abCollapsible, $sTitle, array $aSection ) {

Braces +1 added lines, -1 removed lines

@@ -114,7 +114,7 @@
              */
             private function _getToggleAllButtonArgument( $sToggleAll, array $aSection ) {
                 
-                if ( ! $aSection[ 'repeatable' ] ) {            
+                if ( ! $aSection[ 'repeatable' ] ) {
                     return $sToggleAll;
                 }
                 

Spacing +13 added lines, -13 removed lines

@@ -23,12 +23,12 @@ 
      * @since       3.6.0       Moved from `AdminPageFramework_FormDefinition`.
      */
     static public $aStructure = array(
-        'title'                     => null,        // (string)  the section title will be assigned by default in the section formatting method.
-        'is_collapsed'              => true,        // (boolean) whether it is already collapsed or expanded
-        'toggle_all_button'         => null,        // (boolean|string|array) the position of where to display the toggle-all button that toggles the folding state of all collapsible sections. Accepts the following values. 'top-right', 'top-left', 'bottom-right', 'bottom-left'. If true is passed, the default 'top-right' will be used. To not to display, do not set any or pass `false` or `null`.
-        'collapse_others_on_expand' => true,        // (boolean) whether the other collapsible sections should be folded when the section is unfolded.
-        'container'                 => 'sections',  // (string) the container element that collapsible styling gets applied to. Either 'sections' or 'section' is accepted.
-        'type'                      => 'box',       // DEVVER+  (string)  supported types 'box', 'button' Default: `box`. The `button` type is only supported when the `container` argument is `section`.
+        'title'                     => null, // (string)  the section title will be assigned by default in the section formatting method.
+        'is_collapsed'              => true, // (boolean) whether it is already collapsed or expanded
+        'toggle_all_button'         => null, // (boolean|string|array) the position of where to display the toggle-all button that toggles the folding state of all collapsible sections. Accepts the following values. 'top-right', 'top-left', 'bottom-right', 'bottom-left'. If true is passed, the default 'top-right' will be used. To not to display, do not set any or pass `false` or `null`.
+        'collapse_others_on_expand' => true, // (boolean) whether the other collapsible sections should be folded when the section is unfolded.
+        'container'                 => 'sections', // (string) the container element that collapsible styling gets applied to. Either 'sections' or 'section' is accepted.
+        'type'                      => 'box', // DEVVER+  (string)  supported types 'box', 'button' Default: `box`. The `button` type is only supported when the `container` argument is `section`.
     );   
     
     public $abCollapsible = false;
@@ -41,7 +41,7 @@ 
      * @remark      The framework will not pass this parameter when formatting a section definition array.
      * It will be passed when the framework is rendering a form table to generate collapsible elements.
      */
-    public $aSection      = array();
+    public $aSection = array();
     
     /**
      * Sets up properties.
@@ -84,14 +84,14 @@ 
             
             $_aCollapsible = $this->getAsArray( $this->abCollapsible ) + array(
                 'title'     => $sTitle,
-            ) +  self::$aStructure;
+            ) + self::$aStructure;
             
             $_aCollapsible[ 'toggle_all_button' ] = implode( 
                 ',', 
                 $this->getAsArray( $_aCollapsible[ 'toggle_all_button' ] ) 
             );
             
-            if ( ! empty( $aSection ) ) {
+            if ( !empty( $aSection ) ) {
                 $_aCollapsible[ 'toggle_all_button' ] = $this->_getToggleAllButtonArgument( 
                     $_aCollapsible[ 'toggle_all_button' ], 
                     $aSection
@@ -115,7 +115,7 @@ 
              */
             private function _getToggleAllButtonArgument( $sToggleAll, array $aSection ) {
                 
-                if ( ! $aSection[ 'repeatable' ] ) {            
+                if ( !$aSection[ 'repeatable' ] ) {            
                     return $sToggleAll;
                 }
                 
@@ -125,13 +125,13 @@ 
                 }
                 
                 // Disable the toggle all button for middle sub-sections in repeatable sections.
-                if ( ! $aSection[ '_is_first_index' ] && ! $aSection[ '_is_last_index' ] ) {
+                if ( !$aSection[ '_is_first_index' ] && !$aSection[ '_is_last_index' ] ) {
                     return 0;
                 }            
                 
                 $_aToggleAll = $this->getAOrB(
-                    true === $sToggleAll || 1 ===  $sToggleAll, // evaluate
-                    array( 'top-right', 'bottom-right' ),   // if true
+                    true === $sToggleAll || 1 === $sToggleAll, // evaluate
+                    array( 'top-right', 'bottom-right' ), // if true
                     explode( ',', $sToggleAll ) // if false
                 );            
                 $_aToggleAll = $this->getAOrB(

development/factory/_abstract/form/_model/formatter/AdminPageFramework_Form_Model___FormatFieldsets.php

Doc Comments +2 added lines

@@ -98,6 +98,7 @@ 
          * @since       DEVVER      Moved from `AdminPageFramework_FormDefinition`. Changed the name from `formatFields()`.
          * Added the `$aSectionsets` parameter.
          * @retuen      array
+         * @param string $sCapability
          */
         private function _getFieldsetsFormatted( array $aFieldsets, array $aSectionsets, $sCapability ) {
 
@@ -271,6 +272,7 @@ 
              * 
              * @since       3.0.0
              * @since       DEVVER          Moved from `AdminPageFramework_FormDefinition`. Changed the name from `formatField()`.
+             * @param integer $iCountOfElements
              * @return      array|void      An array of formatted field definition array. If required keys are not set, nothing will be returned. 
              */
             private function _getFieldsetFormatted( $aFieldset, $aSectionsets, $sCapability, $iCountOfElements, $iSubSectionIndex, $bIsSectionRepeatable, $oCallerObject ) {

Spacing +13 added lines, -13 removed lines

@@ -102,10 +102,10 @@ 
         private function _getFieldsetsFormatted( array $aFieldsets, array $aSectionsets, $sCapability ) {
 
             $_aNewFieldsets = array();
-            foreach( $aFieldsets as $_sSectionPath => $_aItems ) {
+            foreach ( $aFieldsets as $_sSectionPath => $_aItems ) {
 
                 // If the section is not set, skip.
-                if ( ! isset( $aSectionsets[ $_sSectionPath ] ) ) {               
+                if ( !isset( $aSectionsets[ $_sSectionPath ] ) ) {               
                     continue;
                 }
 
@@ -114,7 +114,7 @@ 
                     $_aItems,
                     $this->getElement(  // 3.6.0+ Get the section's capability
                         $aSectionsets, 
-                        array( $_sSectionPath, 'capability', ),
+                        array( $_sSectionPath, 'capability',),
                         $sCapability
                     ),
                     $aSectionsets
@@ -175,16 +175,16 @@ 
                  */
                 private function _getNormalFieldsetsFormatted( $aItems, $sCapability, $aSectionsets, $_abSectionRepeatable ) {
                     
-                    $_aNewItems     = array();
-                    foreach( $aItems as $_sFieldID => $_aFieldset ) {
+                    $_aNewItems = array();
+                    foreach ( $aItems as $_sFieldID => $_aFieldset ) {
                         
                         // Insert the formatted field definition array. The fields count is needed to set each order value.
-                        $_aFieldset        = $this->_getFieldsetFormatted(
+                        $_aFieldset = $this->_getFieldsetFormatted(
                             $_aFieldset, 
                             $aSectionsets,
                             $sCapability, 
                             count( $_aNewItems ), // count of elements - zero based
-                            null,   // sub-section index
+                            null, // sub-section index
                             $_abSectionRepeatable,
                             $this->oCallerForm
                         );
@@ -203,7 +203,7 @@ 
                  * @return      boolean
                  */
                 private function _isSubSections( $aItems, $_abSectionRepeatable ) {
-                    if ( ! empty( $_abSectionRepeatable ) ) {
+                    if ( !empty( $_abSectionRepeatable ) ) {
                         return true;
                     }
                     return ( boolean ) count( $this->getIntegerKeyElements( $aItems ) );
@@ -214,9 +214,9 @@ 
                 private function _getSubSectionsFormatted( $aItems, $sCapability, $aSectionsets, $_abSectionRepeatable ) {
                              
                     $_aNewFieldset = array();
-                    foreach( $this->numerizeElements( $aItems ) as $_iSubSectionIndex => $_aFieldsets ) {
+                    foreach ( $this->numerizeElements( $aItems ) as $_iSubSectionIndex => $_aFieldsets ) {
                                       
-                        foreach( $_aFieldsets as $_aFieldset ) {
+                        foreach ( $_aFieldsets as $_aFieldset ) {
                             $_iCountElement = count( $this->getElementAsArray( $_aNewFieldset, $_iSubSectionIndex ) );
                             $_aFieldset     = $this->_getFieldsetFormatted( 
                                 $_aFieldset, 
@@ -230,7 +230,7 @@ 
                             if ( empty( $_aFieldset ) ) {
                                 continue;
                             }
-                            $_aNewFieldset[ $_iSubSectionIndex ][ $_aFieldset['field_id'] ] = $_aFieldset;
+                            $_aNewFieldset[ $_iSubSectionIndex ][ $_aFieldset[ 'field_id' ] ] = $_aFieldset;
                         }
                         uasort( $_aNewFieldset[ $_iSubSectionIndex ], array( $this, 'sortArrayByKey' ) );
                         
@@ -257,7 +257,7 @@ 
                 }
                 
                 $_aSortedFields = array();
-                foreach( $aSectionsets as $_sSectionPath => $_aSecitonset ) { 
+                foreach ( $aSectionsets as $_sSectionPath => $_aSecitonset ) { 
                     if ( isset( $aFieldsets[ $_sSectionPath ] ) ) {
                         $_aSortedFields[ $_sSectionPath ] = $aFieldsets[ $_sSectionPath ];
                     }
@@ -275,7 +275,7 @@ 
              */
             private function _getFieldsetFormatted( $aFieldset, $aSectionsets, $sCapability, $iCountOfElements, $iSubSectionIndex, $bIsSectionRepeatable, $oCallerObject ) {
 
-                if ( ! isset( $aFieldset[ 'field_id' ], $aFieldset[ 'type' ] ) ) { 
+                if ( !isset( $aFieldset[ 'field_id' ], $aFieldset[ 'type' ] ) ) { 
                     return; 
                 }
 

Braces +3 added lines, -3 removed lines

@@ -105,7 +105,7 @@ 
             foreach( $aFieldsets as $_sSectionPath => $_aItems ) {
 
                 // If the section is not set, skip.
-                if ( ! isset( $aSectionsets[ $_sSectionPath ] ) ) {               
+                if ( ! isset( $aSectionsets[ $_sSectionPath ] ) ) {
                     continue;
                 }
 
@@ -257,7 +257,7 @@ 
                 }
                 
                 $_aSortedFields = array();
-                foreach( $aSectionsets as $_sSectionPath => $_aSecitonset ) { 
+                foreach( $aSectionsets as $_sSectionPath => $_aSecitonset ) {
                     if ( isset( $aFieldsets[ $_sSectionPath ] ) ) {
                         $_aSortedFields[ $_sSectionPath ] = $aFieldsets[ $_sSectionPath ];
                     }
@@ -275,7 +275,7 @@ 
              */
             private function _getFieldsetFormatted( $aFieldset, $aSectionsets, $sCapability, $iCountOfElements, $iSubSectionIndex, $bIsSectionRepeatable, $oCallerObject ) {
 
-                if ( ! isset( $aFieldset[ 'field_id' ], $aFieldset[ 'type' ] ) ) { 
+                if ( ! isset( $aFieldset[ 'field_id' ], $aFieldset[ 'type' ] ) ) {
                     return; 
                 }
 

development/factory/_abstract/form/_view/attribute/AdminPageFramework_Form_View___Attribute_Field.php

Doc Comments -1 removed lines

@@ -30,7 +30,6 @@
      * Returns the field container attribute array.
      * 
      * @remark      Formatting each sub-field should be performed prior to callign this method.
-     * @param       array       $aField     The (sub-)field definition array. This should have been formatted already.
      * @return      array       The generated field container attribute array.
      * @internal   
      * @since       3.5.3

Spacing +3 added lines, -3 removed lines

@@ -24,7 +24,7 @@ 
      * 
      * @since       3.6.0
      */
-    public $sContext    = 'field'; 
+    public $sContext = 'field'; 
 
     /**
      * Returns the field container attribute array.
@@ -41,10 +41,10 @@ 
 
         return array(
             'id'            => $this->aArguments[ '_field_container_id' ],
-            'data-type'     => $this->aArguments[ 'type' ],   // referred by the repeatable field JavaScript script.
+            'data-type'     => $this->aArguments[ 'type' ], // referred by the repeatable field JavaScript script.
             // @deprecated 3.6.0 
             // 'data-id_model' => $this->aArguments[ '_fields_container_id_model' ], // 3.3.1+
-            'class'         => "admin-page-framework-field admin-page-framework-field-" . $this->aArguments[ 'type' ]
+            'class'         => "admin-page-framework-field admin-page-framework-field-".$this->aArguments[ 'type' ]
                 . $this->getAOrB(
                     $this->aArguments[ 'attributes' ][ 'disabled' ],
                     ' disabled',

development/factory/_abstract/form/_view/fieldset/AdminPageFramework_Form_View___Fieldset___FieldError.php

Doc Comments +1 added lines

@@ -60,6 +60,7 @@
          * 
          * @since       3.1.0
          * @since       DEVVER      Moved from `AdminPageFramework_Form_View___Fieldset`.
+         * @param string $sHeadingMessage
          * @return      string      The error string message. An empty value if not found.
          */
         private function _getFieldError( $aErrors, $aSectionPath, $aFieldPath, $sHeadingMessage ) {

Spacing +1 added lines, -1 removed lines

@@ -65,7 +65,7 @@
         private function _getFieldError( $aErrors, $aSectionPath, $aFieldPath, $sHeadingMessage ) {
 
             // If this field has a section and the error element is set
-            $_aErrorPath   = array_merge( $aSectionPath, $aFieldPath );
+            $_aErrorPath = array_merge( $aSectionPath, $aFieldPath );
             if ( $this->_hasFieldError( $aErrors, $_aErrorPath ) ) {
                 return "<span class='field-error'>*&nbsp;"
                         . $sHeadingMessage

development/factory/_abstract/form/_view/fieldset/AdminPageFramework_Form_View___Fieldset_Base.php

Doc Comments +2 added lines

@@ -176,6 +176,7 @@ 
      * Returns the repeatable fields script.
      * 
      * @since 2.1.3
+     * @param string $sFieldsContainerID
      */
     protected function _getRepeaterFieldEnablerScript( $sFieldsContainerID, $iFieldCount, $aSettings ) {
 
@@ -222,6 +223,7 @@ 
      * Returns the sortable fields script.
      * 
      * @since 3.0.0
+     * @param string $sFieldsContainerID
      */    
     protected function _getSortableFieldEnablerScript( $sFieldsContainerID ) {        
     

Indentation +1 added lines, -1 removed lines

@@ -189,7 +189,7 @@
         $_sButtons              = 
             "<div class='admin-page-framework-repeatable-field-buttons' {$_sSettingsAttributes} >"
                 . "<a class='repeatable-field-remove-button button-secondary repeatable-field-button button button-small {$_sDashiconMinus}' href='#' title='{$_sRemove}' {$_sVisibility} data-id='{$sFieldsContainerID}'>"
-                  . ( $_bDashiconSupported ? '' : '-' )
+                    . ( $_bDashiconSupported ? '' : '-' )
                 . "</a>"
                 . "<a class='repeatable-field-add-button button-secondary repeatable-field-button button button-small {$_sDashiconPlus}' href='#' title='{$_sAdd}' data-id='{$sFieldsContainerID}'>" 
                     . ( $_bDashiconSupported ? '' : '+' )

Braces +2 added lines, -2 removed lines

@@ -159,7 +159,7 @@ 
                 self::$_bIsLoadedSScripts_Widget = true;
             }
             
-            if ( self::$_bIsLoadedSScripts ) { 
+            if ( self::$_bIsLoadedSScripts ) {
                 return; 
             }
             self::$_bIsLoadedSScripts = true;
@@ -223,7 +223,7 @@ 
      * 
      * @since 3.0.0
      */    
-    protected function _getSortableFieldEnablerScript( $sFieldsContainerID ) {        
+    protected function _getSortableFieldEnablerScript( $sFieldsContainerID ) {
     
         $_sScript = <<<JAVASCRIPTS
     jQuery( document ).ready( function() {

Spacing +10 added lines, -10 removed lines

@@ -68,7 +68,7 @@ 
      * @param       object      $oMsg                   An object storing the system messages.
      * @param       array       $aCallbacks             An array storing the form-field specific callbacks.     
      */
-    public function __construct( &$aField, $aOptions, $aErrors, &$aFieldTypeDefinitions, &$oMsg, array $aCallbacks=array() ) {
+    public function __construct( &$aField, $aOptions, $aErrors, &$aFieldTypeDefinitions, &$oMsg, array $aCallbacks = array() ) {
 
         // @todo Investigate why the first parameter is passed by reference. 
 
@@ -79,13 +79,13 @@ 
         $this->aErrors                  = $this->getAsArray( $aErrors );
         $this->oMsg                     = $oMsg;
         $this->aCallbacks               = $aCallbacks + array(
-            'hfID'              => null,    // the input id attribute
-            'hfTagID'           => null,    // the fieldset/field row container id attribute
-            'hfName'            => null,    // the input name attribute
-            'hfNameFlat'        => null,    // the flat input name attribute                
+            'hfID'              => null, // the input id attribute
+            'hfTagID'           => null, // the fieldset/field row container id attribute
+            'hfName'            => null, // the input name attribute
+            'hfNameFlat'        => null, // the flat input name attribute                
             'hfInputName'       => null,
             'hfInputNameFlat'   => null,
-            'hfClass'           => null,    // the class attribute
+            'hfClass'           => null, // the class attribute
         );        
         
         // 2. Load necessary JavaScript scripts.
@@ -152,9 +152,9 @@ 
          * @since   3.2.0   Added the `$sFieldsType` parameter.
          * @internal
          */
-        private function _loadScripts( $sStructureType='' ) {
+        private function _loadScripts( $sStructureType = '' ) {
 
-            if ( 'widget' === $sStructureType && ! self::$_bIsLoadedSScripts_Widget ) {
+            if ( 'widget' === $sStructureType && !self::$_bIsLoadedSScripts_Widget ) {
                 new AdminPageFramework_Form_View___Script_Widget;
                 self::$_bIsLoadedSScripts_Widget = true;
             }
@@ -183,7 +183,7 @@ 
         $_sRemove               = $this->oMsg->get( 'remove' );
         $_sVisibility           = $iFieldCount <= 1 ? " style='visibility: hidden;'" : "";
         $_sSettingsAttributes   = $this->generateDataAttributes( ( array ) $aSettings );
-        $_bDashiconSupported    = false;     // version_compare( $GLOBALS['wp_version'], '3.8', '>=' );
+        $_bDashiconSupported    = false; // version_compare( $GLOBALS['wp_version'], '3.8', '>=' );
         $_sDashiconPlus         = $_bDashiconSupported ? 'dashicons dashicons-plus' : '';
         $_sDashiconMinus        = $_bDashiconSupported ? 'dashicons dashicons-minus' : '';
         $_sButtons              = 
@@ -196,7 +196,7 @@ 
                 . "</a>"                
             . "</div>";
         $_aJSArray              = json_encode( $aSettings );
-        $_sButtonsHTML          = '"' . $_sButtons . '"';
+        $_sButtonsHTML          = '"'.$_sButtons.'"';
         $_sScript               = <<<JAVASCRIPTS
 jQuery( document ).ready( function() {
     var _nodePositionIndicators = jQuery( '#{$sFieldsContainerID} .admin-page-framework-field .repeatable-field-buttons' );

development/factory/_abstract/form/_view/generator/field/AdminPageFramework_Form_View___Generate_Field_Base.php

Doc Comments -1 removed lines

@@ -23,7 +23,6 @@
      * @internal
      * @since       3.5.3
      * @since       3.6.0       Moved from `AdminPageFramework_FormDefinition`.
-     * @param       array       $aFieldset     a field definition array.
      * @return      boolean
      */
     protected function _isSectionSet() {