pH7Software / pH7-Social-Dating-CMS

_protected/app/system/modules/video/models/VideoModel.php

Doc Comments +29 added lines

@@ -12,6 +12,9 @@ 
 class VideoModel extends VideoCoreModel
 {
 
+    /**
+     * @param string $sThumb
+     */
     public function addAlbum($iProfileId, $sTitle, $sDescription, $sThumb, $sCreatedDate, $iApproved = 1)
     {
         $rStmt = Db::getInstance()->prepare('INSERT INTO' . Db::prefix('AlbumsVideos') . '(profileId, name, description, thumb, createdDate, approved)
@@ -26,6 +29,13 @@ 
         return $rStmt->execute();
     }
 
+    /**
+     * @param string $iProfileId
+     * @param integer $iAlbumId
+     * @param string $sFile
+     * @param string $sThumb
+     * @param string $sCreatedDate
+     */
     public function addVideo($iProfileId, $iAlbumId, $sTitle, $sDescription, $sFile, $sThumb, $sDuration, $sCreatedDate, $iApproved = 1)
     {
         $rStmt = Db::getInstance()->prepare('INSERT INTO' . Db::prefix('Videos') . '(profileId, albumId, title, description, file, thumb, duration, createdDate, approved)
@@ -51,6 +61,9 @@ 
         return $rStmt->execute();
     }
 
+    /**
+     * @param string $iProfileId
+     */
     public function getAlbumsName($iProfileId)
     {
         $this->cache->start(self::CACHE_GROUP, 'albumName' . $iProfileId, static::CACHE_TIME);
@@ -68,6 +81,13 @@ 
         return $oData;
     }
 
+    /**
+     * @param string $iProfileId
+     * @param string $iAlbumId
+     * @param string $iVideoId
+     * @param integer $iOffset
+     * @param integer $iLimit
+     */
     public function video($iProfileId, $iAlbumId, $iVideoId = null, $iApproved = 1, $iOffset, $iLimit)
     {
         $this->cache->start(self::CACHE_GROUP, 'video' . $iProfileId . $iAlbumId . $iVideoId . $iApproved . $iOffset . $iLimit, static::CACHE_TIME);
@@ -134,6 +154,9 @@ 
         return $iData;
     }
 
+    /**
+     * @param integer $iAlbumId
+     */
     public function updateAlbum($iProfileId, $iAlbumId, $sTitle, $sDescription, $sUpdatedDate)
     {
         $rStmt = Db::getInstance()->prepare('UPDATE' . Db::prefix('AlbumsVideos') . 'SET name =:name, description =:description, updatedDate =:updatedDate
@@ -147,6 +170,12 @@ 
         return $rStmt->execute();
     }
 
+    /**
+     * @param string $iProfileId
+     * @param integer $iAlbumId
+     * @param integer $iVideoId
+     * @param string $sUpdatedDate
+     */
     public function updateVideo($iProfileId, $iAlbumId, $iVideoId, $sTitle, $sDescription, $sUpdatedDate)
     {
         $rStmt = Db::getInstance()->prepare('UPDATE' . Db::prefix('Videos') . 'SET title =:title, description =:description, updatedDate =:updatedDate

_protected/framework/Cache/Cache.class.php

Doc Comments +9 added lines, -9 removed lines

@@ -44,7 +44,7 @@ 
      * Enabled/Disabled the cache.
      *
      * @param boolean $bIsEnable
-     * @return object this
+     * @return Cache this
      */
     public function enabled($bIsEnable)
     {
@@ -59,7 +59,7 @@ 
      * If you do not use this method, a default directory will be created.
      *
      * @param string $sCacheDir
-     * @return object this
+     * @return Cache this
      * @throws \PH7\Framework\Error\CException\PH7InvalidArgumentException An explanatory message if the directory does not exist.
      */
     public function setCacheDir($sCacheDir)
@@ -76,7 +76,7 @@ 
      * Sets the cache prefix.
      *
      * @param string $sPrefix
-     * @return object this
+     * @return Cache this
      */
     public function setPrefix($sPrefix)
     {
@@ -88,7 +88,7 @@ 
      * Sets the time expire cache.
      *
      * @param integer $iExpire (the time with the 'touch' function).
-     * @return object this
+     * @return Cache this
      */
     public function setExpire($iExpire)
     {
@@ -104,7 +104,7 @@ 
      * @param string $sGroup The Group Cache (This creates a folder).
      * @param string $sId (The ID for the file).
      * @param integer $iTtl Cache lifetime in seconds. If NULL, the file never expires.
-     * @return object this
+     * @return Cache this
      */
     public function start($sGroup, $sId, $iTtl)
     {
@@ -162,7 +162,7 @@ 
      * Puts the data in the cache.
      *
      * @param string $sData
-     * @return string (object | null) If the cache is disabled, returns null otherwise returns a this object.
+     * @return null|Cache (object | null) If the cache is disabled, returns null otherwise returns a this object.
      */
     public function put($sData)
     {
@@ -176,7 +176,7 @@ 
     /**
      * Clear the cache.
      *
-     * @return object this
+     * @return Cache this
      */
     public function clear()
     {
@@ -263,7 +263,7 @@ 
      *
      * @access private
      * @param boolean $bPrint
-     * @return mixed (boolean | string) Returns TRUE or a string if successful, FALSE otherwise.
+     * @return string (boolean | string) Returns TRUE or a string if successful, FALSE otherwise.
      */
     private function _read($bPrint)
     {
@@ -324,7 +324,7 @@ 
      *
      * If the folder cache does not exist, it creates a folder.
      * @access private
-     * @return object this
+     * @return Cache this
      */
     private function _checkCacheDir()
     {

_protected/framework/Compress/Compress.class.php

Doc Comments +3 added lines

@@ -68,6 +68,9 @@
         $this->_bIsGoogleClosure = (bool) Config::getInstance()->values['cache']['enable.js.closure_compiler_service'];
     }
 
+    /**
+     * @param string $sPhp
+     */
     public function parsePhp($sPhp)
     {
         $sPhp = preg_replace('#/\*.*+\*#', '', $sPhp); # Removing PHP comments

_protected/framework/File/File.class.php

Doc Comments +9 added lines, -5 removed lines

@@ -120,6 +120,7 @@ 
      * Check if file exists.
      *
      * @param mixed (array | string) $mFile
+     * @param string $mFile
      * @return boolean TRUE if file exists, FALSE otherwise.
      */
     public function existFile($mFile)
@@ -273,6 +274,7 @@ 
      *
      * @param mixed (string | array) $mDir
      * @param integer (octal) $iMode Default: 0777
+     * @param string $mDir
      * @return void
      * @throws \PH7\Framework\File\Exception If the file cannot be created.
      */
@@ -321,7 +323,7 @@ 
      *
      * @param string $sFrom File or directory.
      * @param string $sTo File or directory.
-     * @return mixed (integer | boolean) Returns the last line on success, and FALSE on failure.
+     * @return string|false (integer | boolean) Returns the last line on success, and FALSE on failure.
      */
     public function systemCopy($sFrom, $sTo)
     {
@@ -363,7 +365,7 @@ 
      *
      * @param string $sFrom File or directory.
      * @param string $sTo File or directory.
-     * @return mixed (integer | boolean) Returns the last line on success, and FALSE on failure.
+     * @return string|false (integer | boolean) Returns the last line on success, and FALSE on failure.
      */
     public function systemRename($sFrom, $sTo)
     {
@@ -417,6 +419,7 @@ 
      * Get the creation/modification time of a file in the Unix timestamp.
      *
      * @param string Full path of the file.
+     * @param string $sFile
      * @return mixed (integer | boolean) Returns the time the file was last modified, or FALSE if it not found.
      */
     public function getModifTime($sFile)
@@ -430,6 +433,7 @@ 
      *
      * @static
      * @param string Full path of the file.
+     * @param string $sFile
      * @return integer Returns the latest modification time of the file in Unix timestamp.
      */
     public static function version($sFile)
@@ -441,7 +445,7 @@ 
      * Delay script execution.
      *
      * @param integer $iSleep Halt time in seconds. Optional parameter, default value is 5.
-     * @return mixed (integer | boolean) Returns "0" on success, or "false" on error.
+     * @return integer (integer | boolean) Returns "0" on success, or "false" on error.
      */
     public function sleep($iSleep = null)
     {
@@ -681,7 +685,7 @@ 
      * Get the URL contents (For URLs, it is better to use CURL because it is faster than file_get_contents function).
      *
      * @param string $sUrl URL to be read contents.
-     * @return mixed (string | boolean) Return the result content on success, FALSE on failure.
+     * @return string (string | boolean) Return the result content on success, FALSE on failure.
      */
     public function getUrlContents($sUrl)
     {
@@ -754,7 +758,7 @@ 
      * Create a recurive directory iterator for a given directory.
      *
      * @param string $sPath
-     * @return string The directory.
+     * @return \RecursiveDirectoryIterator The directory.
      */
     public function getDirIterator($sPath)
     {

_protected/framework/Geo/Map/Api.class.php

Doc Comments +2 added lines, -2 removed lines

@@ -217,7 +217,7 @@ 
     }
 
     /**
-     * @return mixed
+     * @return boolean
      */
     public function getEnableGeolocation()
     {
@@ -445,7 +445,7 @@ 
      *
      * @param string $address an address
      *
-     * @return array array with precision, lat & lng
+     * @return string array with precision, lat & lng
      */
     public function geocoding($address)
     {

_protected/framework/Http/Http.class.php

Doc Comments +3 added lines, -2 removed lines

@@ -91,7 +91,7 @@ 
     /**
      * @static
      * @param integer $iStatus The "code" for the HTTP status
-     * @return mixed (string | boolean) $iStatus Returns the "HTTP status code" if found otherwise returns "false"
+     * @return integer (string | boolean) $iStatus Returns the "HTTP status code" if found otherwise returns "false"
      */
     public static function getStatusCodes($iStatus)
     {
@@ -129,6 +129,7 @@ 
      *
      * @static
      * @param mixed (string | array) $mHeaders Headers to send.
+     * @param string $mHeaders
      * @throws \PH7\Framework\Http\Exception
      */
     public static function setHeaders($mHeaders)
@@ -188,7 +189,7 @@ 
      * @static
      * @param string $sUsr
      * @param string $sPwd
-     * @return boolean TRUE if the authentication is correct, otherwise FALSE.
+     * @return null|boolean TRUE if the authentication is correct, otherwise FALSE.
      */
     public static function requireAuth($sUsr, $sPwd)
     {

_protected/framework/Layout/Form/Engine/PFBC/Form.class.php

Doc Comments +15 added lines

@@ -283,6 +283,10 @@ 
      }
 
     /*This method restores the serialized form instance.*/
+
+    /**
+     * @param string $id
+     */
     private static function recover($id)
     {
         if(!empty($_SESSION['pfbc'][$id]['form']))
@@ -483,6 +487,10 @@ 
 
     /*Valldation errors are saved in the session after the form submission, and will be displayed to the user
     when redirected back to the form.*/
+
+    /**
+     * @param string $id
+     */
     public static function setError($id, $messages, $element = '')
     {
         if (!is_array($messages))
@@ -496,11 +504,18 @@ 
     }
 
     /*setSuccess*/
+
+    /**
+     * @param string $id
+     */
     public static function setSuccess($id, $message, $element = '')
     {
          return (new Design)->setFlashMsg($message, Design::SUCCESS_TYPE);
     }
 
+    /**
+     * @param string $id
+     */
     public static function setSessionValue($id, $element, $value)
     {
         $_SESSION['pfbc'][$id]['values'][$element] = $value;

_protected/framework/Layout/Html/Design.class.php

Doc Comments +8 added lines, -3 removed lines

@@ -253,6 +253,11 @@ 
         }
     }
 
+    /**
+     * @param string $sModule
+     * @param string $sController
+     * @param string $sAction
+     */
     public function url($sModule, $sController, $sAction, $sVars = null, $bClear = true)
     {
         $sUrl = Uri::get($sModule, $sController, $sAction, $sVars, $bClear);
@@ -514,7 +519,7 @@ 
      * @internal If it's an IPv6, show only the beginning, otherwise it would be too long in the template.
      * @param string $sIp IP address. Default NULL
      * @param boolean $bPrint Print or Return the HTML code. Default TRUE
-     * @return mixed (string | void)
+     * @return null|string (string | void)
      */
     public function ip($sIp = null, $bPrint = true)
     {
@@ -531,7 +536,7 @@ 
      * Show the geolocation of the user (with link that points to the Country controller).
      *
      * @param boolean $bPrint Print or Return the HTML code. Default TRUE
-     * @return mixed (string | void)
+     * @return null|string (string | void)
      */
     public function geoIp($bPrint = true)
     {
@@ -563,7 +568,7 @@ 
     /**
      * Get the User Avatar.
      *
-     * @param string $sUername
+     * @param string $sUsername
      * @param string $sSex
      * @param integer $iSize
      * @return void Html contents. URL avatar default 150px or the user avatar.

_protected/framework/Math/Measure/Weight.class.php

Doc Comments +1 added lines, -1 removed lines

@@ -35,7 +35,7 @@
      * @see get()
      *
      * @param boolean $bPrint Default FALSE
-     * @return void
+     * @return null|string
      */
     public function display($bPrint = false)
     {