osCommerce / oscommerce2

catalog/includes/OSC/OM/OSCOM.php

Doc Comments +13 added lines

@@ -32,6 +32,9 @@ 
         ErrorHandler::initialize();
     }
 
+    /**
+     * @return string
+     */
     public static function getVersion()
     {
         if (!isset(static::$version)) {
@@ -117,6 +120,9 @@ 
         return $OSCOM_Site->hasPage() && $OSCOM_Site->getPage()->isRPC();
     }
 
+    /**
+     * @param string $parameters
+     */
     public static function link($page, $parameters = null, $connection = 'NONSSL', $add_session_id = true, $search_engine_safe = true)
     {
         global $request_type;
@@ -324,6 +330,10 @@ 
         }
     }
 
+    /**
+     * @param string $file
+     * @param string $group
+     */
     public static function loadConfigFile($file, $group)
     {
         $cfg = [];
@@ -354,6 +364,9 @@ 
         return static::$cfg['global'][$key];
     }
 
+    /**
+     * @param string $key
+     */
     public static function configExists($key, $group = null)
     {
         if (!isset($group)) {

Unused Use Statements -1 removed lines

@@ -10,7 +10,6 @@
 
 use OSC\OM\DateTime;
 use OSC\OM\ErrorHandler;
-use OSC\OM\FileSystem;
 use OSC\OM\HTML;
 use OSC\OM\HTTP;
 use OSC\OM\Registry;

catalog/product_info.php

Unused Use Statements -1 removed lines

@@ -12,7 +12,6 @@
 
   use OSC\OM\HTML;
   use OSC\OM\OSCOM;
-  use OSC\OM\Registry;
 
   require('includes/application_top.php');
 

catalog/admin/includes/modules/dashboard/d_admin_logins.php

Unused Use Statements -1 removed lines

@@ -10,7 +10,6 @@
   Released under the GNU General Public License
 */
 
-  use OSC\OM\HTML;
   use OSC\OM\OSCOM;
   use OSC\OM\Registry;
 

catalog/admin/includes/modules/dashboard/d_orders.php

Unused Use Statements -1 removed lines

@@ -10,7 +10,6 @@
   Released under the GNU General Public License
 */
 
-  use OSC\OM\HTML;
   use OSC\OM\OSCOM;
   use OSC\OM\Registry;
 

catalog/admin/includes/modules/security_check/extended/admin_backup_directory_listing.php

Doc Comments +3 added lines

@@ -32,6 +32,9 @@
       return MODULE_SECURITY_CHECK_EXTENDED_EXT_DIRECTORY_LISTING_HTTP_200;
     }
 
+    /**
+     * @param string $url
+     */
     function getHttpRequest($url) {
       $server = parse_url($url);
 

catalog/admin/includes/modules/security_check/extended/admin_backup_file.php

Doc Comments +3 added lines

@@ -32,6 +32,9 @@
       return MODULE_SECURITY_CHECK_EXTENDED_EXT_DIRECTORY_LISTING_HTTP_200;
     }
 
+    /**
+     * @param string $url
+     */
     function getHttpRequest($url) {
       $server = parse_url($url);
 

catalog/includes/OSC/OM/HTML.php

Doc Comments +20 added lines

@@ -103,6 +103,10 @@ 
         return $image;
     }
 
+    /**
+     * @param string $name
+     * @param string $action
+     */
     public static function form($name, $action, $method = 'post', $parameters = '', array $flags = [])
     {
         if (!isset($flags['tokenize']) || !is_bool($flags['tokenize'])) {
@@ -175,6 +179,9 @@ 
         return static::inputField($name, null, $parameters, 'file', false);
     }
 
+    /**
+     * @param string $type
+     */
     protected static function selectionField($name, $type, $value = '', $checked = false, $parameters = '')
     {
         $selection = '<input type="' . static::output($type) . '" name="' . static::output($name) . '"';
@@ -196,6 +203,9 @@ 
         return $selection;
     }
 
+    /**
+     * @param string $name
+     */
     public static function checkboxField($name, $value = '', $checked = false, $parameters = '')
     {
         return static::selectionField($name, 'checkbox', $value, $checked, $parameters);
@@ -206,6 +216,11 @@ 
         return static::selectionField($name, 'radio', $value, $checked, $parameters);
     }
 
+    /**
+     * @param string $name
+     * @param integer $width
+     * @param integer $height
+     */
     public static function textareaField($name, $width, $height, $text = '', $parameters = '', $reinsert_value = true, $class = 'form-control')
     {
         $field = '<textarea name="' . static::output($name) . '" cols="' . static::output($width) . '" rows="' . static::output($height) . '"';
@@ -325,6 +340,11 @@ 
         return $field;
     }
 
+    /**
+     * @param string $title
+     * @param string $icon
+     * @param string $link
+     */
     public static function button($title = null, $icon = null, $link = null, $params = null, $class = null)
     {
         $types = ['submit', 'button', 'reset'];

catalog/admin/includes/functions/general.php

Doc Comments +38 added lines

@@ -124,6 +124,9 @@ 
 
   }
 
+  /**
+   * @param string $raw_datetime
+   */
   function tep_datetime_short($raw_datetime) {
     if ( ($raw_datetime == '0000-00-00 00:00:00') || ($raw_datetime == '') ) return false;
 
@@ -261,6 +264,9 @@ 
     return $image;
   }
 
+  /**
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -373,6 +379,11 @@ 
     return $geo_zone_id;
   }
 
+  /**
+   * @param boolean $html
+   * @param string $boln
+   * @param string $eoln
+   */
   function tep_address_format($address_format_id, $address, $html, $boln, $eoln) {
     $Qaddress = Registry::get('Db')->get('address_format', 'address_format', ['address_format_id' => (int)$address_format_id]);
 
@@ -469,6 +480,9 @@ 
     return $def_state;
   }
 
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     $uprid = $prid;
     if ( (is_array($params)) && (!strstr($prid, '{')) ) {
@@ -576,6 +590,9 @@ 
 ////
 // Wrapper for class_exists() function
 // This function is not available in all PHP versions so we test it before using it.
+  /**
+   * @param string $class_name
+   */
   function tep_class_exists($class_name) {
     if (function_exists('class_exists')) {
       return class_exists($class_name);
@@ -771,6 +788,9 @@ 
 
 ////
 // Sets the status of a banner
+  /**
+   * @param integer $status
+   */
   function tep_set_banner_status($banners_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -845,6 +865,9 @@ 
 
 ////
 // Sets the status of a product on special
+  /**
+   * @param integer $status
+   */
   function tep_set_specials_status($specials_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -1261,6 +1284,11 @@ 
     return $value;
   }
 
+  /**
+   * @param string $to_name
+   * @param string $email_subject
+   * @param string $email_text
+   */
   function tep_mail($to_name, $to_email_address, $email_subject, $email_text, $from_email_name, $from_email_address) {
     if (SEND_EMAILS != 'true') return false;
 
@@ -1312,6 +1340,9 @@ 
 
 ////
 // Wrapper function for round() for php3 compatibility
+  /**
+   * @return double
+   */
   function tep_round($value, $precision) {
     return round($value, $precision);
   }
@@ -1454,6 +1485,10 @@ 
 
 ////
 // Return a random value
+  /**
+   * @param integer $min
+   * @param integer $max
+   */
   function tep_rand($min = null, $max = null) {
     static $seeded;
 
@@ -1469,6 +1504,9 @@ 
   }
 
 // nl2br() prior PHP 4.2.0 did not convert linefeeds on all OSs (it only converted \n)
+  /**
+   * @param string[] $from
+   */
   function tep_convert_linefeeds($from, $to, $string) {
       return str_replace($from, $to, $string);
   }

catalog/includes/functions/general.php

Doc Comments +29 added lines

@@ -78,6 +78,9 @@ 
 
 ////
 // Break a word in a string if it is longer than a specified length ($len)
+  /**
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -245,6 +248,9 @@ 
 
 ////
 // Wrapper function for round()
+  /**
+   * @return double
+   */
   function tep_round($number, $precision) {
     if (strpos($number, '.') && (strlen(substr($number, strpos($number, '.')+1)) > $precision)) {
       $number = substr($number, 0, strpos($number, '.') + 1 + $precision + 1);
@@ -424,6 +430,11 @@ 
 ////
 // Return a formatted address
 // TABLES: address_format
+  /**
+   * @param boolean $html
+   * @param string $boln
+   * @param string $eoln
+   */
   function tep_address_format($address_format_id, $address, $html, $boln, $eoln) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -952,6 +963,9 @@ 
 
 ////
 // Return a product ID with attributes
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     if (is_numeric($prid)) {
       $uprid = (int)$prid;
@@ -1033,6 +1047,11 @@ 
 // $from_email_adress The eMail address of the sender,
 //                    e.g. info@mytepshop.com
 
+  /**
+   * @param string $to_name
+   * @param string $email_subject
+   * @param string $email_text
+   */
   function tep_mail($to_name, $to_email_address, $email_subject, $email_text, $from_email_name, $from_email_address) {
     if (SEND_EMAILS != 'true') return false;
 
@@ -1092,6 +1111,9 @@ 
     return tep_count_modules(MODULE_SHIPPING_INSTALLED);
   }
 
+  /**
+   * @param integer $length
+   */
   function tep_create_random_value($length, $type = 'mixed') {
     if ( ($type != 'mixed') && ($type != 'chars') && ($type != 'digits')) $type = 'mixed';
 
@@ -1247,6 +1269,10 @@ 
 
 ////
 // Return a random value
+  /**
+   * @param integer $min
+   * @param integer $max
+   */
   function tep_rand($min = null, $max = null) {
 
     if (isset($min) && isset($max)) {
@@ -1366,6 +1392,9 @@ 
   }
 
 // Convert linefeeds
+  /**
+   * @param string[] $from
+   */
   function tep_convert_linefeeds($from, $to, $string) {
       return str_replace($from, $to, $string);
   }