michaeluno / admin-page-framework

development/factory/_common/form/field_type/AdminPageFramework_FieldType_export.php

Spacing +35 added lines, -35 removed lines

@@ -51,7 +51,7 @@ 
     /**
      * Defines the field type slugs used for this field type.
      */
-    public $aFieldTypeSlugs = array( 'export', );
+    public $aFieldTypeSlugs = array( 'export',);
 
     /**
      * Defines the default key-values of this field type.
@@ -59,9 +59,9 @@ 
      * @remark $_aDefaultKeys holds shared default key-values defined in the base class.
      */
     protected $aDefaultKeys = array(
-        'data'          => null,        // ( array|string|object ) This is for the export field type. Do not set a value here.
-        'format'        => 'json',      // ( string ) for the export field type. Do not set a default value here. Currently array, json, and text are supported.
-        'file_name'     => null,        // ( string ) for the export field type. Do not set a default value here.
+        'data'          => null, // ( array|string|object ) This is for the export field type. Do not set a value here.
+        'format'        => 'json', // ( string ) for the export field type. Do not set a default value here. Currently array, json, and text are supported.
+        'file_name'     => null, // ( string ) for the export field type. Do not set a default value here.
         'attributes'    => array(
             'class' => 'button button-primary',
         ),
@@ -106,14 +106,14 @@ 
     protected function getField( $aField ) {
 
         /* Set the transient data to export - If the value is not an array and the export data is set. */
-        if ( isset( $aField['data'] ) ) {
-            $this->setTransient( md5( "{$aField['class_name']}_{$aField['input_id']}" ), $aField['data'], 60*2 ); // 2 minutes.
+        if ( isset( $aField[ 'data' ] ) ) {
+            $this->setTransient( md5( "{$aField[ 'class_name' ]}_{$aField[ 'input_id' ]}" ), $aField[ 'data' ], 60 * 2 ); // 2 minutes.
         }
 
         /* Set some required values */
-        $aField['attributes']['name']   = "__export[submit][{$aField['input_id']}]";
-        $aField['file_name']            = $aField['file_name'] ? $aField['file_name'] : $this->_generateExportFileName( $aField['option_key'] ? $aField['option_key'] : $aField['class_name'], $aField['format'] );
-        $aField['label']                = $aField['label'] ? $aField['label'] : $this->oMsg->get( 'export' );
+        $aField[ 'attributes' ][ 'name' ]   = "__export[submit][{$aField[ 'input_id' ]}]";
+        $aField[ 'file_name' ]            = $aField[ 'file_name' ] ? $aField[ 'file_name' ] : $this->_generateExportFileName( $aField[ 'option_key' ] ? $aField[ 'option_key' ] : $aField[ 'class_name' ], $aField[ 'format' ] );
+        $aField[ 'label' ]                = $aField[ 'label' ] ? $aField[ 'label' ] : $this->oMsg->get( 'export' );
 
         return parent::getField( $aField );
 
@@ -129,42 +129,42 @@ 
 
         $_aAttributes = array( 'type' => 'hidden' );
         return
-            "<input " . $this->getAttributes(
+            "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][input_id]",
-                    'value' => $aField['input_id'],
+                    'name' => "__export[{$aField[ 'input_id' ]}][input_id]",
+                    'value' => $aField[ 'input_id' ],
                 ) + $_aAttributes
-            ) . "/>"
-            . "<input " . $this->getAttributes(
+            )."/>"
+            . "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][field_id]",
-                    'value' => $aField['field_id'],
+                    'name' => "__export[{$aField[ 'input_id' ]}][field_id]",
+                    'value' => $aField[ 'field_id' ],
                 ) + $_aAttributes
-            ) . "/>"
-            . "<input " . $this->getAttributes(
+            )."/>"
+            . "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][section_id]",
-                    'value' => isset( $aField['section_id'] ) && $aField['section_id'] != '_default' ? $aField['section_id'] : '',
+                    'name' => "__export[{$aField[ 'input_id' ]}][section_id]",
+                    'value' => isset( $aField[ 'section_id' ] ) && $aField[ 'section_id' ] != '_default' ? $aField[ 'section_id' ] : '',
                 ) + $_aAttributes
-            ) . "/>"
-            . "<input " . $this->getAttributes(
+            )."/>"
+            . "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][file_name]",
-                    'value' => $aField['file_name'],
+                    'name' => "__export[{$aField[ 'input_id' ]}][file_name]",
+                    'value' => $aField[ 'file_name' ],
                 ) + $_aAttributes
-            ) . "/>"
-            . "<input " . $this->getAttributes(
+            )."/>"
+            . "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][format]",
-                    'value' => $aField['format'],
+                    'name' => "__export[{$aField[ 'input_id' ]}][format]",
+                    'value' => $aField[ 'format' ],
                 ) + $_aAttributes
-            ) . "/>"
-            . "<input " . $this->getAttributes(
+            )."/>"
+            . "<input ".$this->getAttributes(
                 array(
-                    'name' => "__export[{$aField['input_id']}][transient]",
-                    'value' => isset( $aField['data'] ),
+                    'name' => "__export[{$aField[ 'input_id' ]}][transient]",
+                    'value' => isset( $aField[ 'data' ] ),
                 ) + $_aAttributes
-            ) . "/>"
+            )."/>"
             ;
     }
 
@@ -178,7 +178,7 @@ 
          * @since 2.1.5 Moved from the AdminPageFramework_FormField class.
          * @internal
          */
-        private function _generateExportFileName( $sOptionKey, $sExportFormat='json' ) {
+        private function _generateExportFileName( $sOptionKey, $sExportFormat = 'json' ) {
 
             switch ( trim( strtolower( $sExportFormat ) ) ) {
                 case 'text': // for plain text.
@@ -193,7 +193,7 @@ 
                     break;
             }
 
-            return $sOptionKey . '_' . date("Ymd") . '.' . $sExt;
+            return $sOptionKey.'_'.date( "Ymd" ).'.'.$sExt;
 
         }
 

development/factory/_common/form/field_type/AdminPageFramework_FieldType_select.php

Spacing +4 added lines, -4 removed lines

@@ -102,7 +102,7 @@ 
     /**
      * Defines the field type slugs used for this field type.
      */
-    public $aFieldTypeSlugs = array( 'select', );
+    public $aFieldTypeSlugs = array( 'select',);
 
     /**
      * Defines the default key-values of this field type.
@@ -114,7 +114,7 @@ 
             'select'    => array(
                 'size'          => 1,
                 'autofocusNew'  => null,
-                'multiple'      => null,    // set 'multiple' for multiple selections. If 'is_multiple' is set, it takes the precedence.
+                'multiple'      => null, // set 'multiple' for multiple selections. If 'is_multiple' is set, it takes the precedence.
                 'required'      => null,
             ),
             'optgroup'  => array(),
@@ -154,12 +154,12 @@ 
     protected function getField( $aField ) {
 
         $_oSelectInput = new AdminPageFramework_Input_select( $aField[ 'attributes' ] );
-        if ( $aField[ 'is_multiple' ]  ) {
+        if ( $aField[ 'is_multiple' ] ) {
             $_oSelectInput->setAttribute( array( 'select', 'multiple' ), 'multiple' );
         }
         return
             $aField[ 'before_label' ]
-            . "<div " . $this->getLabelContainerAttributes( $aField, 'admin-page-framework-input-label-container admin-page-framework-select-label' ) . ">"
+            . "<div ".$this->getLabelContainerAttributes( $aField, 'admin-page-framework-input-label-container admin-page-framework-select-label' ).">"
                 . "<label for='{$aField[ 'input_id' ]}'>"
                     . $aField[ 'before_input' ]
                     . $_oSelectInput->get( $aField[ 'label' ] )

development/factory/_common/form/field_type/AdminPageFramework_FieldType_media.php

Spacing +19 added lines, -19 removed lines

@@ -57,7 +57,7 @@ 
     /**
      * Defines the field type slugs used for this field type.
      */
-    public $aFieldTypeSlugs = array( 'media', );
+    public $aFieldTypeSlugs = array( 'media',);
 
     /**
      * Defines the default key-values of this field type.
@@ -91,7 +91,7 @@ 
         return
             $this->_getScript_MediaUploader(
                 "admin_page_framework"
-            ) . PHP_EOL
+            ).PHP_EOL
             . $this->_getScript_RegisterCallbacks();
     }
 
@@ -159,7 +159,7 @@ 
             $_sInsertFromURL         = esc_js( $this->oMsg->get( 'insert_from_url' ) );
 
             // If the WordPress version is 3.4.x or below
-            if ( ! function_exists( 'wp_enqueue_media' ) ) {
+            if ( !function_exists( 'wp_enqueue_media' ) ) {
                 return <<<JAVASCRIPTS
                     /**
                      * Bind/rebinds the thickbox script the given selector element.
@@ -400,10 +400,10 @@ 
             // Do not include the escaping character (backslash) in the heredoc variable declaration
             // because the minifier script will parse it and the <<<JAVASCRIPTS and JAVASCRIPTS; parts are converted to double quotes (")
             // which causes the PHP syntax error.
-            $_sButtonHTML       = '"' . $this->_getUploaderButtonHTML_Media( $sInputID, $aButtonAttributes, $bExternalSource ) . '"';
-            $_sRpeatable        = $this->getAOrB( ! empty( $abRepeatable ), 'true', 'false' );
+            $_sButtonHTML       = '"'.$this->_getUploaderButtonHTML_Media( $sInputID, $aButtonAttributes, $bExternalSource ).'"';
+            $_sRpeatable        = $this->getAOrB( !empty( $abRepeatable ), 'true', 'false' );
             $_sExternalSource   = $this->getAOrB( $bExternalSource, 'true', 'false' );
-            $_sScript                = <<<JAVASCRIPTS
+            $_sScript = <<<JAVASCRIPTS
 if ( jQuery( 'a#select_media_{$sInputID}' ).length == 0 ) {
     jQuery( 'input#{$sInputID}' ).after( $_sButtonHTML );
 }
@@ -416,7 +416,7 @@ 
                     . '/* <![CDATA[ */'
                     . $_sScript
                     . '/* ]]> */'
-                . "</script>". PHP_EOL;
+                . "</script>".PHP_EOL;
 
         }
             /**
@@ -427,19 +427,19 @@ 
              */
             private function _getUploaderButtonHTML_Media( $sInputID, array $aButtonAttributes, $bExternalSource ) {
 
-                $_bIsLabelSet = isset( $aButtonAttributes['data-label'] ) && $aButtonAttributes['data-label'];
+                $_bIsLabelSet = isset( $aButtonAttributes[ 'data-label' ] ) && $aButtonAttributes[ 'data-label' ];
                 $_aAttributes = $this->_getFormattedUploadButtonAttributes_Media(
                     $sInputID,
                     $aButtonAttributes,
                     $_bIsLabelSet,
                     $bExternalSource
                 );
-                return "<a " . $this->getAttributes( $_aAttributes ) . ">"
+                return "<a ".$this->getAttributes( $_aAttributes ).">"
                         . $this->getAOrB(
                             $_bIsLabelSet,
-                            $_aAttributes['data-label'],
+                            $_aAttributes[ 'data-label' ],
                             $this->getAOrB(
-                                strrpos( $_aAttributes['class'], 'dashicons' ),
+                                strrpos( $_aAttributes[ 'class' ], 'dashicons' ),
                                 '',
                                 $this->oMsg->get( 'select_file' )
                             )
@@ -455,26 +455,26 @@ 
                  */
                 private function _getFormattedUploadButtonAttributes_Media( $sInputID, array $aButtonAttributes, $_bIsLabelSet, $bExternalSource ) {
 
-                    $_aAttributes           = array(
+                    $_aAttributes = array(
                             'id'        => "select_media_{$sInputID}",
                             'href'      => '#',
-                            'data-uploader_type'            => ( string ) function_exists( 'wp_enqueue_media' ),    //  ? 1 : 0,
-                            'data-enable_external_source'   => ( string ) ( bool ) $bExternalSource,    //  ? 1 : 0,
+                            'data-uploader_type'            => ( string ) function_exists( 'wp_enqueue_media' ), //  ? 1 : 0,
+                            'data-enable_external_source'   => ( string ) ( bool ) $bExternalSource, //  ? 1 : 0,
                         )
                         + $aButtonAttributes
                         + array(
                             'title'     => $_bIsLabelSet
-                                ? $aButtonAttributes['data-label']
+                                ? $aButtonAttributes[ 'data-label' ]
                                 : $this->oMsg->get( 'select_file' ),
                             'data-label' => null,
                         );
-                    $_aAttributes['class']  = $this->getClassAttribute(
+                    $_aAttributes[ 'class' ] = $this->getClassAttribute(
                         'select_media button button-small ',
                         $this->getAOrB(
-                            trim( $aButtonAttributes['class'] ),
-                            $aButtonAttributes['class'],
+                            trim( $aButtonAttributes[ 'class' ] ),
+                            $aButtonAttributes[ 'class' ],
                             $this->getAOrB(
-                                ! $_bIsLabelSet && version_compare( $GLOBALS['wp_version'], '3.8', '>=' ),
+                                !$_bIsLabelSet && version_compare( $GLOBALS[ 'wp_version' ], '3.8', '>=' ),
                                 'dashicons dashicons-portfolio',
                                 ''
                             )

development/factory/_common/form/field_type/AdminPageFramework_FieldType__nested.php

Spacing +5 added lines, -5 removed lines

@@ -66,16 +66,16 @@ 
      */
     protected function getField( $aField ) {
 
-        $_oCallerForm   = $aField[ '_caller_object' ];
+        $_oCallerForm = $aField[ '_caller_object' ];
 
         $_aInlineMixedOutput = array();
-        foreach( $this->getAsArray( $aField[ 'content' ] ) as $_aChildFieldset ) {
+        foreach ( $this->getAsArray( $aField[ 'content' ] ) as $_aChildFieldset ) {
 
             if ( is_scalar( $_aChildFieldset ) ) {
                 continue;
             }
 
-            if ( ! $this->isNormalPlacement( $_aChildFieldset ) ) {
+            if ( !$this->isNormalPlacement( $_aChildFieldset ) ) {
                 continue;
             }
 
@@ -91,12 +91,12 @@ 
             $_oFieldset = new AdminPageFramework_Form_View___Fieldset(
                 $_aChildFieldset,
                 $_oCallerForm->aSavedData,
-                $_oCallerForm->getFieldErrors(),    // @todo Generate field errors. $this->aErrors,
+                $_oCallerForm->getFieldErrors(), // @todo Generate field errors. $this->aErrors,
                 $_oCallerForm->aFieldTypeDefinitions,
                 $_oCallerForm->oMsg,
                 $_oCallerForm->aCallbacks // field output element callables.
             );
-            $_aInlineMixedOutput[] = $_oFieldset->get(); // field output
+            $_aInlineMixedOutput[ ] = $_oFieldset->get(); // field output
 
 
         }

development/factory/_common/form/field_type/AdminPageFramework_FieldType_hidden.php

Indentation +1 added lines, -1 removed lines

@@ -66,7 +66,7 @@
                     . ( $aField[ 'label' ]
                         ? "<span " . $this->getLabelContainerAttributes( $aField, 'admin-page-framework-input-label-string' ) . ">"
                             . $aField[ 'label' ]
-                          . "</span>"
+                            . "</span>"
                         : ""
                     )
                     . "<input " . $this->getAttributes( $aField[ 'attributes' ] ) . " />"

Spacing +5 added lines, -5 removed lines

@@ -59,21 +59,21 @@
     protected function getField( $aField ) {
 
         return
-            $aField['before_label']
+            $aField[ 'before_label' ]
             . "<div class='admin-page-framework-input-label-container'>"
                 . "<label for='{$aField[ 'input_id' ]}'>"
                     . $aField[ 'before_input' ]
                     . ( $aField[ 'label' ]
-                        ? "<span " . $this->getLabelContainerAttributes( $aField, 'admin-page-framework-input-label-string' ) . ">"
+                        ? "<span ".$this->getLabelContainerAttributes( $aField, 'admin-page-framework-input-label-string' ).">"
                             . $aField[ 'label' ]
                           . "</span>"
                         : ""
                     )
-                    . "<input " . $this->getAttributes( $aField[ 'attributes' ] ) . " />"
-                    . $aField['after_input']
+                    . "<input ".$this->getAttributes( $aField[ 'attributes' ] )." />"
+                    . $aField[ 'after_input' ]
                 . "</label>"
             . "</div>"
-            . $aField['after_label'];
+            . $aField[ 'after_label' ];
 
     }
 

development/factory/_common/form/_model/AdminPageFramework_Form_Model___FieldTypeRegistration.php

Indentation +1 added lines, -1 removed lines

@@ -43,7 +43,7 @@
                 call_user_func_array(
                     $aFieldTypeDefinition[ 'hfFieldSetTypeSetter' ],
                     array( $sStructureType )
-               );
+                );
             }
 
             if ( is_callable( $aFieldTypeDefinition[ 'hfFieldLoader' ] ) ) {

development/factory/_common/form/_model/formatter/AdminPageFramework_Form_Model___FormatSectionsets.php

Spacing +11 added lines, -11 removed lines

@@ -63,9 +63,9 @@ 
         }
 
         $_aSectionsets = $this->_getSectionsetsFormatted(
-            array(),                // section-sets array to modify - new formatted items will be stored here
-            $this->aSectionsets,    // parsing section-sets
-            array(),                // section path - empty for root
+            array(), // section-sets array to modify - new formatted items will be stored here
+            $this->aSectionsets, // parsing section-sets
+            array(), // section path - empty for root
             $this->sCapability      // capability
         );
 
@@ -82,10 +82,10 @@ 
          */
         private function _getSectionsetsFormatted( $_aNewSectionsets, $aSectionsetsToParse, $aSectionPath, $sCapability ) {
 
-            foreach( $aSectionsetsToParse as $_sSectionPath => $_aSectionset ) {
+            foreach ( $aSectionsetsToParse as $_sSectionPath => $_aSectionset ) {
 
                 // The '_default' section can be empty so do not check `if ( empty( $_aSectionset ) )` here.
-                if ( ! is_array( $_aSectionset ) ) {
+                if ( !is_array( $_aSectionset ) ) {
                     continue;
                 }
 
@@ -116,7 +116,7 @@ 
 
                 // 3.7.0+ For nested sections
                 $_aNewSectionsets = $this->_getNestedSections(
-                    $_aNewSectionsets,  // sectionset array to modify
+                    $_aNewSectionsets, // sectionset array to modify
                     $_aSectionset,
                     $_aSectionPath, // section path
                     $_aSectionset[ 'capability' ]
@@ -133,15 +133,15 @@ 
              */
             private function _getNestedSections( $aSectionsetsToEdit, $aSectionset, $aSectionPath, $sCapability ) {
 
-                if ( ! $this->_hasNestedSections( $aSectionset ) ) {
+                if ( !$this->_hasNestedSections( $aSectionset ) ) {
                     return $aSectionsetsToEdit;
                 }
 
                 // Recursive call
                 return $this->_getSectionsetsFormatted(
-                        $aSectionsetsToEdit,          // section-sets array to modify - new formatted items will be stored here
-                        $aSectionset[ 'content' ],    // parsing section-sets
-                        $aSectionPath,                // section path - empty for root
+                        $aSectionsetsToEdit, // section-sets array to modify - new formatted items will be stored here
+                        $aSectionset[ 'content' ], // parsing section-sets
+                        $aSectionPath, // section path - empty for root
                         $sCapability                  // capability
                     );
 
@@ -154,7 +154,7 @@ 
                 private function _hasNestedSections( $aSectionset ) {
 
                     $aSectionset = $aSectionset + array( 'content' => null );
-                    if ( ! is_array( $aSectionset[ 'content' ] ) ) {
+                    if ( !is_array( $aSectionset[ 'content' ] ) ) {
                         return false;
                     }
                     $_aContents  = $aSectionset[ 'content' ];

development/factory/_common/form/_model/formatter/AdminPageFramework_Form_Model___Format_Fieldset.php

Spacing +40 added lines, -40 removed lines

@@ -28,38 +28,38 @@ 
     static public $aStructure = array(
 
         // Required Keys
-        'field_id'                  => null,    // (string)
-        'section_id'                => null,    // (string)
+        'field_id'                  => null, // (string)
+        'section_id'                => null, // (string)
 
         // Optional Keys
-        'type'                      => null,    // (string) (3.8.0+ Became okay to omit.)
-        'section_title'             => null,    // This will be assigned automatically in the formatting method.
-        'page_slug'                 => null,    // This will be assigned automatically in the formatting method.
-        'tab_slug'                  => null,    // This will be assigned automatically in the formatting method.
-        'option_key'                => null,    // This will be assigned automatically in the formatting method.
-        'class_name'                => null,    // Stores the instantiated class name. Used by the export field type. Also a third party custom field type uses it.
+        'type'                      => null, // (string) (3.8.0+ Became okay to omit.)
+        'section_title'             => null, // This will be assigned automatically in the formatting method.
+        'page_slug'                 => null, // This will be assigned automatically in the formatting method.
+        'tab_slug'                  => null, // This will be assigned automatically in the formatting method.
+        'option_key'                => null, // This will be assigned automatically in the formatting method.
+        'class_name'                => null, // Stores the instantiated class name. Used by the export field type. Also a third party custom field type uses it.
         'capability'                => null,
         'title'                     => null,
         'tip'                       => null,
         'description'               => null,
-        'error_message'             => null,    // error message for the field
+        'error_message'             => null, // error message for the field
         'before_label'              => null,
         'after_label'               => null,
         'if'                        => true,
-        'order'                     => null,    // do not set the default number here for this key.
+        'order'                     => null, // do not set the default number here for this key.
         'default'                   => null,
         'value'                     => null,
-        'help'                      => null,    // 2.1.0
-        'help_aside'                => null,    // 2.1.0
-        'repeatable'                => null,    // 2.1.3
-        'sortable'                  => null,    // 2.1.3
-        'show_title_column'         => true,    // 3.0.0
-        'hidden'                    => null,    // 3.0.0
+        'help'                      => null, // 2.1.0
+        'help_aside'                => null, // 2.1.0
+        'repeatable'                => null, // 2.1.3
+        'sortable'                  => null, // 2.1.3
+        'show_title_column'         => true, // 3.0.0
+        'hidden'                    => null, // 3.0.0
 
-        'placement'                 => 'normal',    // 3.8.0 (string) accepts either 'section_title', 'field_title', or 'normal'
+        'placement'                 => 'normal', // 3.8.0 (string) accepts either 'section_title', 'field_title', or 'normal'
 
         // @todo    Examine why an array is not set but null here for the attributes argument.
-        'attributes'                => null,    // 3.0.0 - the array represents the attributes of input tag
+        'attributes'                => null, // 3.0.0 - the array represents the attributes of input tag
         'class'                     => array(   // 3.3.1
             'fieldrow'  =>  array(),
             'fieldset'  =>  array(),
@@ -67,29 +67,29 @@ 
             'field'     =>  array(),
         ),
 
-        'save'                      => true,    // 3.6.0
-        'content'                   => null,    // 3.6.1 - (string) An overriding field-set output.
+        'save'                      => true, // 3.6.0
+        'content'                   => null, // 3.6.1 - (string) An overriding field-set output.
 
-        'show_debug_info'           => null,    // 3.8.8+  (boolean) whether to show debug information such as field definition tool-tips. This value is inherited from the section definition argument of the same name. Not setting a value here as it is determined with another calculated value.
+        'show_debug_info'           => null, // 3.8.8+  (boolean) whether to show debug information such as field definition tool-tips. This value is inherited from the section definition argument of the same name. Not setting a value here as it is determined with another calculated value.
 
         // Internal Keys
-        '_fields_type'              => null,    // @deprecated  3.7.0, 3.0.0 - an internal key that indicates the fields type such as page, meta box for pages, meta box for posts, or taxonomy.
-        '_structure_type'           => null,    // 3.7.0
-        '_caller_object'            => null,    // 3.4.0 (object) stores the object of the caller class. The object is referenced when creating nested fields.
-
-        '_section_path'             => '',      // 3.7.0 (string) Stores the section path that indicates the structural address of the nested section. e.g. my_section|nested_one
-        '_section_path_array'       => '',      // 3.7.0 (array) An array version of the above section path.
-        '_nested_depth'             => 0,       // 3.4.0 (integer) stores the level of the nesting depth. This is mostly used for debugging by checking if the field is a nested field or not.
-        '_subsection_index'         => null,    // 3.7.0 Passed to the `field_definition_{...}` filter hook callbacks.
-        '_section_repeatable'       => false,   // @deprecated
-        '_is_section_repeatable'    => false,   // 3.8.0 (boolean) Whether the belonging section is repeatable or not.
-
-        '_field_path'               => '',      // 3.7.0 (string) Stores the field path that indicates the structural location of the field. This is relative to the belonging section.
+        '_fields_type'              => null, // @deprecated  3.7.0, 3.0.0 - an internal key that indicates the fields type such as page, meta box for pages, meta box for posts, or taxonomy.
+        '_structure_type'           => null, // 3.7.0
+        '_caller_object'            => null, // 3.4.0 (object) stores the object of the caller class. The object is referenced when creating nested fields.
+
+        '_section_path'             => '', // 3.7.0 (string) Stores the section path that indicates the structural address of the nested section. e.g. my_section|nested_one
+        '_section_path_array'       => '', // 3.7.0 (array) An array version of the above section path.
+        '_nested_depth'             => 0, // 3.4.0 (integer) stores the level of the nesting depth. This is mostly used for debugging by checking if the field is a nested field or not.
+        '_subsection_index'         => null, // 3.7.0 Passed to the `field_definition_{...}` filter hook callbacks.
+        '_section_repeatable'       => false, // @deprecated
+        '_is_section_repeatable'    => false, // 3.8.0 (boolean) Whether the belonging section is repeatable or not.
+
+        '_field_path'               => '', // 3.7.0 (string) Stores the field path that indicates the structural location of the field. This is relative to the belonging section.
         '_field_path_array'         => array(), // 3.7.0 (array) An array version of the above field path.
-        '_parent_field_path'        => '',      // 3.8.0 (string)
+        '_parent_field_path'        => '', // 3.8.0 (string)
         '_parent_field_path_array'  => array(), // 3.8.0 (array)
 
-        '_is_title_embedded'        => false,   // 3.8.0 (boolean) whether the field title is in the fieldset element, not in the table th element. This becomes `true` for `section_title` fields and fields with the `placement` argument with the value of `section_title` or `field_title`.
+        '_is_title_embedded'        => false, // 3.8.0 (boolean) whether the field title is in the fieldset element, not in the table th element. This becomes `true` for `section_title` fields and fields with the `placement` argument with the value of `section_title` or `field_title`.
 
     );
 
@@ -166,14 +166,14 @@ 
             array(
                 '_fields_type'           => $this->sStructureType, // @deprecated 3.7.0 backward-compatibility
                 '_structure_type'        => $this->sStructureType,
-                '_caller_object'         => $this->oCallerObject,  // 3.4.1+ Stores the caller form object.
-                '_subsection_index'      => $this->iSubSectionIndex,  // 3.7.0+
+                '_caller_object'         => $this->oCallerObject, // 3.4.1+ Stores the caller form object.
+                '_subsection_index'      => $this->iSubSectionIndex, // 3.7.0+
             )
             + $this->aFieldset,
             array(
                 'capability'             => $this->sCapability,
                 'section_id'             => '_default',
-                '_section_repeatable'    => $this->bIsSectionRepeatable,   // @deprecated  3.8.0   This was not used.
+                '_section_repeatable'    => $this->bIsSectionRepeatable, // @deprecated  3.8.0   This was not used.
                 '_is_section_repeatable' => $this->bIsSectionRepeatable,
             )
             + self::$aStructure
@@ -294,12 +294,12 @@ 
 
             );
 
-            foreach( $aNestedFieldsets as $_isIndex => &$_aNestedFieldset ) {
+            foreach ( $aNestedFieldsets as $_isIndex => &$_aNestedFieldset ) {
 
                 // The inline-mixed type has a string element.
                 if ( is_scalar( $_aNestedFieldset ) ) {
                     $_aNestedFieldset = array(
-                        'field_id'              => $aParentFieldset[ 'field_id' ] . '_' . uniqid(),
+                        'field_id'              => $aParentFieldset[ 'field_id' ].'_'.uniqid(),
                         'content'               => $_aNestedFieldset,
                     );
                 }

development/factory/_common/form/_model/formatter/AdminPageFramework_Form_Model___FormatSectionset.php

Spacing +27 added lines, -27 removed lines

@@ -34,47 +34,47 @@ 
         // Optional
         'page_slug'         => null,
         'tab_slug'          => null,
-        'section_tab_slug'  => null,    // 3.0.0+
+        'section_tab_slug'  => null, // 3.0.0+
         'title'             => null,
         'description'       => null,
         'capability'        => null,
         'if'                => true,
-        'order'             => null,    // do not set the default number here because incremented numbers will be added when registering the sections.
+        'order'             => null, // do not set the default number here because incremented numbers will be added when registering the sections.
         'help'              => null,
         'help_aside'        => null,
-        'repeatable'        => false,   // (boolean|array) 3.0.0+
-        'sortable'          => false,   // (boolean|array) 3.6.0+
+        'repeatable'        => false, // (boolean|array) 3.0.0+
+        'sortable'          => false, // (boolean|array) 3.6.0+
         'attributes'        => array(   // 3.3.1+
-            'class'         => null,    // set null to avoid undefined index warnings.
-            'style'         => null,    // set null to avoid undefined index warnings.
+            'class'         => null, // set null to avoid undefined index warnings.
+            'style'         => null, // set null to avoid undefined index warnings.
             'tab'           => array(),
         ),
         'class'             => array(    // 3.3.1+
             'tab'           => array(),
         ),
-        'hidden'            => false,    // 3.3.1+
-        'collapsible'       => false,    // 3.4.0+ (boolean|array) For the array structure see the $aStructure_CollapsibleArguments property.
-        'save'              => true,     // 3.6.0+
+        'hidden'            => false, // 3.3.1+
+        'collapsible'       => false, // 3.4.0+ (boolean|array) For the array structure see the $aStructure_CollapsibleArguments property.
+        'save'              => true, // 3.6.0+
 
-        'content'           => null,     // 3.6.1+  (string) An overriding section-set output.
+        'content'           => null, // 3.6.1+  (string) An overriding section-set output.
 
-        'tip'               => null,     // 3.7.0  (string) Tool tip HTML strings.
+        'tip'               => null, // 3.7.0  (string) Tool tip HTML strings.
 
         // Internal
-        '_fields_type'      => null,     // @deprecated 3.7.0+ Use the `_structure_type` instead. 3.0.0+ - same as the one of the field definition array. Used to insert debug info at the bottom of sections.
-        '_structure_type'   => null,     // 3.7.0+
-        '_is_first_index'   => false,    // 3.4.0+ (boolean) indicates whether it is the first item of the sub-sections (for repeatable sections).
-        '_is_last_index'    => false,    // 3.4.0+ (boolean) indicates whether it is the last item of the sub-sections (for repeatable sections).
+        '_fields_type'      => null, // @deprecated 3.7.0+ Use the `_structure_type` instead. 3.0.0+ - same as the one of the field definition array. Used to insert debug info at the bottom of sections.
+        '_structure_type'   => null, // 3.7.0+
+        '_is_first_index'   => false, // 3.4.0+ (boolean) indicates whether it is the first item of the sub-sections (for repeatable sections).
+        '_is_last_index'    => false, // 3.4.0+ (boolean) indicates whether it is the last item of the sub-sections (for repeatable sections).
 
-        '_section_path'         => '',       // 3.7.0+ (string) e.g. my_section|nested_section
-        '_section_path_array'   => '',       // 3.7.0+ (array) an array version of the above section_path argument. Numerically indexed.
-        '_nested_depth'         => 0,        // 3.7.0+ (integer) the nested level of the section
+        '_section_path'         => '', // 3.7.0+ (string) e.g. my_section|nested_section
+        '_section_path_array'   => '', // 3.7.0+ (array) an array version of the above section_path argument. Numerically indexed.
+        '_nested_depth'         => 0, // 3.7.0+ (integer) the nested level of the section
 
         // 3.6.0+ - (object) the caller framework factory object. This allows the framework to access the factory property when rendering the section.
         // 3.7.0+  It no longer stores a factory object but a form object.
         '_caller_object'    => null,
 
-        'show_debug_info'   => null,    // 3.8.8+ (boolean) Whether to display debug information. Inherits the page/in-page-tab setting (actually the factory property value of `$bShowDebugInfo` which gets updated by the page/tab setting).
+        'show_debug_info'   => null, // 3.8.8+ (boolean) Whether to display debug information. Inherits the page/in-page-tab setting (actually the factory property value of `$bShowDebugInfo` which gets updated by the page/tab setting).
 
     );
 
@@ -93,7 +93,7 @@ 
 
     public $oCaller             = null;
 
-    public $bShowDebugInfo      = true;     // 3.8.8+
+    public $bShowDebugInfo      = true; // 3.8.8+
 
     /**
      * Sets up properties.
@@ -107,7 +107,7 @@ 
             $this->sCapability,
             $this->iCountOfElements,
             $this->oCaller,
-            $this->bShowDebugInfo,      // 3.8.8+
+            $this->bShowDebugInfo, // 3.8.8+
         );
         $this->aSectionset          = $_aParameters[ 0 ];
         $this->sSectionPath         = $_aParameters[ 1 ];
@@ -115,7 +115,7 @@ 
         $this->sCapability          = $_aParameters[ 3 ];
         $this->iCountOfElements     = $_aParameters[ 4 ];
         $this->oCaller              = $_aParameters[ 5 ];
-        $this->bShowDebugInfo       = $_aParameters[ 6 ];   // 3.8.8+
+        $this->bShowDebugInfo       = $_aParameters[ 6 ]; // 3.8.8+
 
     }
 
@@ -130,16 +130,16 @@ 
         $_aSectionPath = explode( '|', $this->sSectionPath );
         $_aSectionset  = $this->uniteArrays(
             array(
-                '_fields_type'          => $this->sStructureType,   // @deprecated  3.7.0+
-                '_structure_type'       => $this->sStructureType,   // 3.7.0+
-                '_section_path'         => $this->sSectionPath,     // 3.7.0+
+                '_fields_type'          => $this->sStructureType, // @deprecated  3.7.0+
+                '_structure_type'       => $this->sStructureType, // 3.7.0+
+                '_section_path'         => $this->sSectionPath, // 3.7.0+
                 '_section_path_array'   => $_aSectionPath,
-                '_nested_depth'         => count( $_aSectionPath ) - 1,    // 3.7.0+ - zero base
+                '_nested_depth'         => count( $_aSectionPath ) - 1, // 3.7.0+ - zero base
             )
             + $this->aSectionset
             + array(
                 'capability'        => $this->sCapability,
-                'show_debug_info'   => $this->bShowDebugInfo,   // 3.8.8+
+                'show_debug_info'   => $this->bShowDebugInfo, // 3.8.8+
             ),
             self::$aStructure
         );