michaeluno / admin-page-framework

development/factory/admin_page/_model/format/AdminPageFramework_Format_InPageTab.php

Spacing +9 added lines, -9 removed lines

@@ -31,15 +31,15 @@
         'page_slug'         => null,
         'tab_slug'          => null,
         'title'             => null,
-        'order'             => 10,      // (integer)
-        'show_in_page_tab'  => true,    // 3.6.0+ (boolean)
-        'parent_tab_slug'   => null,    // this needs to be set if the above show_in_page_tab is false so that the framework can mark the parent tab to be active when the hidden page is accessed.
-        'url'               => null,    // 3.5.0+ This allows the user set custom link.
-        'disabled'          => null,    // 3.5.10+ (boolean) If true, the link will be unlinked.
-        'attributes'        => null,    // 3.5.10+ (array) Applies to the navigation tab bar element.    
-        'capability'        => null,    // 3.6.0+ (string)
-        'if'                => true,    // 3.6.0+ (boolean)
-        'show_debug_info'   => null,    // 3.8.8+ (boolean, optional) Whether to show debug information. If not set, the existent `bShowDebugInfo` property value will be used. The initial value here is `null` as the default value will be assigned in the formatting method.
+        'order'             => 10, // (integer)
+        'show_in_page_tab'  => true, // 3.6.0+ (boolean)
+        'parent_tab_slug'   => null, // this needs to be set if the above show_in_page_tab is false so that the framework can mark the parent tab to be active when the hidden page is accessed.
+        'url'               => null, // 3.5.0+ This allows the user set custom link.
+        'disabled'          => null, // 3.5.10+ (boolean) If true, the link will be unlinked.
+        'attributes'        => null, // 3.5.10+ (array) Applies to the navigation tab bar element.    
+        'capability'        => null, // 3.6.0+ (string)
+        'if'                => true, // 3.6.0+ (boolean)
+        'show_debug_info'   => null, // 3.8.8+ (boolean, optional) Whether to show debug information. If not set, the existent `bShowDebugInfo` property value will be used. The initial value here is `null` as the default value will be assigned in the formatting method.
     );
     
     /**

development/factory/page_meta_box/AdminPageFramework_MetaBox_Page.php

Spacing +2 added lines, -2 removed lines

@@ -24,12 +24,12 @@
      * @since       3.0.0
      * @deprecated  3.7.0      Use     `AdminPageFramework_PageMetaBox` instead.
      */
-    public function __construct( $sMetaBoxID, $sTitle, $asPageSlugs=array(), $sContext='normal', $sPriority='default', $sCapability='manage_options', $sTextDomain='admin-page-framework' ) {
+    public function __construct( $sMetaBoxID, $sTitle, $asPageSlugs = array(), $sContext = 'normal', $sPriority = 'default', $sCapability = 'manage_options', $sTextDomain = 'admin-page-framework' ) {
                         
         parent::__construct( $sMetaBoxID, $sTitle, $asPageSlugs, $sContext, $sPriority, $sCapability, $sTextDomain );
         
         $this->oUtil->showDeprecationNotice( 
-            'The class, ' . __CLASS__ . ',', // deprecated item
+            'The class, '.__CLASS__.',', // deprecated item
             'AdminPageFramework_PageMetaBox' // alternative
         );
         

development/factory/_common/utility/AdminPageFramework_Debug.php

Doc Comments +5 added lines, -1 removed lines

@@ -177,6 +177,7 @@ 
          * Determines the log file path.
          * @since       3.5.3 
          * @internal    
+         * @param string|null $bsFilePath
          * @return      string      The path of the file to log the contents.
          */
         static private function _getLogFilePath( $bsFilePath, $sCallerClass ) {
@@ -213,6 +214,8 @@ 
          * Returns the heading part of a log item.
          * @since       3.5.3
          * @internal
+         * @param double $fCurrentTimeStamp
+         * @param double $nElapsed
          * @return      string      the heading part of a log item.
          */
         static private function _getLogHeadingLine( $fCurrentTimeStamp, $nElapsed, $sCallerClass, $sCallerFunction ) {
@@ -411,7 +414,6 @@ 
                 /**
                  * @return      string
                  * @param       scalar      $sScalar        
-                 * @param       integer     $iCharLimit     Character length limit to truncate.
                  * @since       3.8.9
                  */
                 static private function _getLegibleScalar( $sScalar ) {
@@ -441,6 +443,7 @@ 
                         
                     }                
                     /**
+                     * @param string $sString
                      * @return      string
                      */
                     static private function _getLegibleString( $sString, $iCharLimit=200 ) {
@@ -485,6 +488,7 @@ 
     
         /**
          * Performs `array_map()` recursively.
+         * @param string[] $oCallable
          * @return      array.
          * @since       3.8.9
          */

Spacing +45 added lines, -45 removed lines

@@ -33,7 +33,7 @@ 
      * @param       string          $sFilePath      The file path for a log file.
      * @return      void
      */
-    static public function dump( $asArray, $sFilePath=null ) {
+    static public function dump( $asArray, $sFilePath = null ) {
         echo self::get( $asArray, $sFilePath );
     }    
         /**
@@ -44,7 +44,7 @@ 
          * @since unknown
          * @deprecated      3.2.0
          */
-        static public function dumpArray( $asArray, $sFilePath=null ) {
+        static public function dumpArray( $asArray, $sFilePath = null ) {
             self::dump( $asArray, $sFilePath );
         }    
     
@@ -53,7 +53,7 @@ 
      * @since       3.8.9
      * @return      string
      */
-    static public function getDetails( $mValue, $bEscape=true ) {    
+    static public function getDetails( $mValue, $bEscape = true ) {    
         $_sValueWithDetails = self::_getArrayRepresentationSanitized(
             self::_getLegible( $mValue )
         );
@@ -96,7 +96,7 @@ 
      * @param       string          $sFilePath      The file path for a log file.
      * @param       boolean         $bEscape        Whether to escape characters.
      */
-    static public function get( $asArray, $sFilePath=null, $bEscape=true ) {
+    static public function get( $asArray, $sFilePath = null, $bEscape = true ) {
 
         if ( $sFilePath ) {
             self::log( $asArray, $sFilePath );     
@@ -118,8 +118,8 @@ 
          * @since       3.0.0 Changed the $bEncloseInTag parameter to bEscape.
          * @deprecated  3.2.0
          */
-        static public function getArray( $asArray, $sFilePath=null, $bEscape=true ) {
-            self::showDeprecationNotice( __CLASS__ .'::' . __FUNCTION__,  __CLASS__ .'::get()' );
+        static public function getArray( $asArray, $sFilePath = null, $bEscape = true ) {
+            self::showDeprecationNotice( __CLASS__.'::'.__FUNCTION__, __CLASS__.'::get()' );
             return self::get( $asArray, $sFilePath, $bEscape );
         }      
             
@@ -141,18 +141,18 @@ 
      * @param       string      $sFilePath      The log file path.
      * @return      void
      **/
-    static public function log( $mValue, $sFilePath=null ) {
+    static public function log( $mValue, $sFilePath = null ) {
                 
         static $_fPreviousTimeStamp = 0;
         
         $_oCallerInfo       = debug_backtrace();
         $_sCallerFunction   = self::getElement(
-            $_oCallerInfo,  // subject array
+            $_oCallerInfo, // subject array
             array( 1, 'function' ), // key
             ''      // default
         );                        
-        $_sCallerClass      = self::getElement(
-            $_oCallerInfo,  // subject array
+        $_sCallerClass = self::getElement(
+            $_oCallerInfo, // subject array
             array( 1, 'class' ), // key
             ''      // default
         );           
@@ -162,11 +162,11 @@ 
             self::_getLogFilePath( $sFilePath, $_sCallerClass ), 
             self::_getLogHeadingLine( 
                 $_fCurrentTimeStamp,
-                round( $_fCurrentTimeStamp - $_fPreviousTimeStamp, 3 ),     // elapsed time
+                round( $_fCurrentTimeStamp - $_fPreviousTimeStamp, 3 ), // elapsed time
                 $_sCallerClass,
                 $_sCallerFunction
-            ) . PHP_EOL
-            . self::_getLegible( $mValue ) . PHP_EOL . PHP_EOL,
+            ).PHP_EOL
+            . self::_getLegible( $mValue ).PHP_EOL.PHP_EOL,
             FILE_APPEND 
         );     
         
@@ -187,9 +187,9 @@ 
             }
             // Return a generated default log path.
             if ( true === $bsFilePath ) {
-                return WP_CONTENT_DIR . DIRECTORY_SEPARATOR . basename( get_class() ) . '_' . date( "Ymd" ) . '.log';
+                return WP_CONTENT_DIR.DIRECTORY_SEPARATOR.basename( get_class() ).'_'.date( "Ymd" ).'.log';
             }
-            return WP_CONTENT_DIR . DIRECTORY_SEPARATOR . basename( get_class() ) . '_' . basename( $sCallerClass ) . '_' . date( "Ymd" ) . '.log';
+            return WP_CONTENT_DIR.DIRECTORY_SEPARATOR.basename( get_class() ).'_'.basename( $sCallerClass ).'_'.date( "Ymd" ).'.log';
             
         }
             /**
@@ -198,7 +198,7 @@ 
              * @internal
              */
             static private function _createFile( $sFilePath ) {
-                if ( ! $sFilePath || true === $sFilePath ) {
+                if ( !$sFilePath || true === $sFilePath ) {
                     return false;
                 }
                 if ( file_exists( $sFilePath ) ) {
@@ -230,11 +230,11 @@ 
             $_nMicroseconds     = str_pad( round( ( $_nNow - floor( $_nNow ) ) * 10000 ), 4, '0' );
             
             $_aOutput           = array(
-                date( "Y/m/d H:i:s", $_nNow ) . '.' . $_nMicroseconds,
+                date( "Y/m/d H:i:s", $_nNow ).'.'.$_nMicroseconds,
                 self::_getFormattedElapsedTime( $nElapsed ),
                 $_iPageLoadID,
                 AdminPageFramework_Registry::getVersion(),
-                $sCallerClass . '::' . $sCallerFunction,
+                $sCallerClass.'::'.$sCallerFunction,
                 current_filter(),
                 self::getCurrentURL(),
             );
@@ -252,22 +252,22 @@ 
                 $_aElapsedParts     = explode( ".", ( string ) $nElapsed );
                 $_sElapsedFloat     = str_pad(
                     self::getElement(
-                        $_aElapsedParts,  // subject array
+                        $_aElapsedParts, // subject array
                         1, // key
                         0      // default
                     ),      
                     3, 
                     '0'
                 );
-                $_sElapsed          = self::getElement(
-                    $_aElapsedParts,  // subject array
-                    0,  // key
+                $_sElapsed = self::getElement(
+                    $_aElapsedParts, // subject array
+                    0, // key
                     0   // default
                 );                                   
-                $_sElapsed          = strlen( $_sElapsed ) > 1 
-                    ? '+' . substr( $_sElapsed, -1, 2 ) 
-                    : ' ' . $_sElapsed;
-                return $_sElapsed . '.' . $_sElapsedFloat;
+                $_sElapsed = strlen( $_sElapsed ) > 1 
+                    ? '+'.substr( $_sElapsed, -1, 2 ) 
+                    : ' '.$_sElapsed;
+                return $_sElapsed.'.'.$_sElapsedFloat;
             
             }
         /**
@@ -277,8 +277,8 @@ 
          * @since       3.0.3   Changed the default log location and file name.
          * @deprecated  3.1.0   Use the `log()` method instead.
          */
-        static public function logArray( $asArray, $sFilePath=null ) {
-            self::showDeprecationNotice( __CLASS__ .'::' . __FUNCTION__,  __CLASS__ .'::log()' );
+        static public function logArray( $asArray, $sFilePath = null ) {
+            self::showDeprecationNotice( __CLASS__.'::'.__FUNCTION__, __CLASS__.'::log()' );
             self::log( $asArray, $sFilePath );     
         }      
         
@@ -313,7 +313,7 @@ 
          */
         static private function _getObjectName( $mItem ) {
             if ( is_object( $mItem ) ) {
-                return '(object) ' . get_class( $mItem );
+                return '(object) '.get_class( $mItem );
             }
             return $mItem;
         }
@@ -325,8 +325,8 @@ 
          */
         static private function _getLegible( $mValue ) {                
             if ( is_array( $mValue ) ) {            
-                return '(array, length: ' . count( $mValue ).') ' 
-                    . print_r( self::_getLegibleArray( $mValue ) , true );
+                return '(array, length: '.count( $mValue ).') ' 
+                    . print_r( self::_getLegibleArray( $mValue ), true );
             }
             return print_r( self::_getLegibleValue( $mValue ), true );
         }
@@ -339,16 +339,16 @@ 
         static private function _getLegibleCallable( $asoCallable ) {
             
             if ( is_string( $asoCallable ) ) {
-                return '(callable) ' . $asoCallable;
+                return '(callable) '.$asoCallable;
             }
             if ( is_object( $asoCallable ) ) {
-                return '(callable) ' . get_class( $asoCallable );
+                return '(callable) '.get_class( $asoCallable );
             }
             $_sSubject = is_object( $asoCallable[ 0 ] )
                 ? get_class( $asoCallable[ 0 ] )
                 : ( string ) $asoCallable[ 0 ];
 
-            return '(callable) ' . $_sSubject . '::' . ( string ) $asoCallable[ 1 ];
+            return '(callable) '.$_sSubject.'::'.( string ) $asoCallable[ 1 ];
             
         }        
         /**
@@ -361,8 +361,8 @@ 
             if ( method_exists( $oObject, '__toString' ) ) {
                 return ( string ) $oObject;
             }
-            return '(object) ' . get_class( $oObject ) . ' ' 
-                . count( get_object_vars( $oObject ) ) . ' properties.';
+            return '(object) '.get_class( $oObject ).' ' 
+                . count( get_object_vars( $oObject ) ).' properties.';
             
         } 
         /**
@@ -400,12 +400,12 @@ 
                         return '(null)';
                     }                    
                     if ( is_object( $mNonScalar ) ) {
-                        return '(' . $_sType . ') ' . get_class( $mNonScalar );
+                        return '('.$_sType.') '.get_class( $mNonScalar );
                     }
                     if ( is_array( $mNonScalar ) ) {
-                        return '(' . $_sType . ') ' . count( $mNonScalar ) . ' elements';
+                        return '('.$_sType.') '.count( $mNonScalar ).' elements';
                     }
-                    return '(' . $_sType . ') ' . ( string ) $mNonScalar;
+                    return '('.$_sType.') '.( string ) $mNonScalar;
                     
                 }
                 /**
@@ -417,11 +417,11 @@ 
                 static private function _getLegibleScalar( $sScalar ) {
                  
                     if ( is_bool( $sScalar ) ) {
-                        return '(boolean) ' . ( $sScalar ? 'true' : 'false' );
+                        return '(boolean) '.( $sScalar ? 'true' : 'false' );
                     }                 
                     return is_string( $sScalar )
                         ? self::_getLegibleString( $sScalar )
-                        : '(' . gettype( $sScalar ) . ', length: ' . self::_getValueLength( $sScalar ) .  ') ' . $sScalar;
+                        : '('.gettype( $sScalar ).', length: '.self::_getValueLength( $sScalar ).') '.$sScalar;
                 }
                     /**
                      * Returns a length of a value.
@@ -443,7 +443,7 @@ 
                     /**
                      * @return      string
                      */
-                    static private function _getLegibleString( $sString, $iCharLimit=200 ) {
+                    static private function _getLegibleString( $sString, $iCharLimit = 200 ) {
                     
                         static $_iMBSupport;
                         $_iMBSupport    = isset( $_iMBSupport ) ? $_iMBSupport : ( integer ) function_exists( 'mb_strlen' );
@@ -452,8 +452,8 @@ 
                         
                         $_iCharLength   = call_user_func_array( $_aStrLenMethod[ $_iMBSupport ], array( $sString ) );
                         return $_iCharLength <= $iCharLimit
-                            ? '(string, length: ' . $_iCharLength . ') ' . $sString
-                            : '(string, length: ' . $_iCharLength . ') ' . call_user_func_array( $_aSubstrMethod[ $_iMBSupport ], array( $sString, 0, $iCharLimit ) )
+                            ? '(string, length: '.$_iCharLength.') '.$sString
+                            : '(string, length: '.$_iCharLength.') '.call_user_func_array( $_aSubstrMethod[ $_iMBSupport ], array( $sString, 0, $iCharLimit ) )
                                 . '...';
                         
                     }
@@ -466,7 +466,7 @@ 
          * @return      array
          * @internal
          */
-        static private function _getSliceByDepth( array $aSubject, $iDepth=0 ) {
+        static private function _getSliceByDepth( array $aSubject, $iDepth = 0 ) {
 
             foreach ( $aSubject as $_sKey => $_vValue ) {
                 if ( is_array( $_vValue ) ) {

Braces +4 added lines, -4 removed lines

@@ -53,7 +53,7 @@ 
      * @since       3.8.9
      * @return      string
      */
-    static public function getDetails( $mValue, $bEscape=true ) {    
+    static public function getDetails( $mValue, $bEscape=true ) {
         $_sValueWithDetails = self::_getArrayRepresentationSanitized(
             self::_getLegible( $mValue )
         );
@@ -323,8 +323,8 @@ 
          * @since       3.8.9
          * @return      string
          */
-        static private function _getLegible( $mValue ) {                
-            if ( is_array( $mValue ) ) {            
+        static private function _getLegible( $mValue ) {
+            if ( is_array( $mValue ) ) {
                 return '(array, length: ' . count( $mValue ).') ' 
                     . print_r( self::_getLegibleArray( $mValue ) , true );
             }
@@ -502,7 +502,7 @@ 
              * @return      mixed       A modified value.
              * @since       3.8.9
              */
-            static private function _getArrayMappedNested( $mItem ) {            
+            static private function _getArrayMappedNested( $mItem ) {
                 return is_array( $mItem ) 
                     ? array_map( array( __CLASS__, '_getArrayMappedNested' ), $mItem ) 
                     : call_user_func( self::$_oCurrentCallableForArrayMapRecursive, $mItem );