osCommerce / oscommerce2

catalog/includes/third_party/PasswordHash.php

Doc Comments +19 added lines

@@ -35,6 +35,10 @@ 
 	var $portable_hashes;
 	var $random_state;
 
+	/**
+	 * @param integer $iteration_count_log2
+	 * @param boolean $portable_hashes
+	 */
 	function __construct($iteration_count_log2, $portable_hashes)
 	{
 		$this->itoa64 = './0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
@@ -50,6 +54,9 @@ 
 			$this->random_state .= getmypid();
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	function get_random_bytes($count)
 	{
 		$output = '';
@@ -84,6 +91,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	function encode64($input, $count)
 	{
 		$output = '';
@@ -107,6 +117,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_private($input)
 	{
 		$output = '$P$';
@@ -155,6 +168,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_extended($input)
 	{
 		$count_log2 = min($this->iteration_count_log2 + 8, 24);
@@ -173,6 +189,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_blowfish($input)
 	{
 		# This one needs to use a different order of characters and a

catalog/admin/includes/functions/general.php

Doc Comments +20 added lines

@@ -221,6 +221,9 @@ 
     return $image;
   }
 
+  /**
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -333,6 +336,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]);
 
@@ -429,6 +437,9 @@ 
     return $def_state;
   }
 
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     $uprid = $prid;
     if ( (is_array($params)) && (!strstr($prid, '{')) ) {
@@ -729,6 +740,9 @@ 
 
 ////
 // Sets the status of a banner
+  /**
+   * @param integer $status
+   */
   function tep_set_banner_status($banners_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -803,6 +817,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');
 
@@ -1252,6 +1269,9 @@ 
 
 ////
 // Wrapper function for round() for php3 compatibility
+  /**
+   * @return double
+   */
   function tep_round($value, $precision) {
     return round($value, $precision);
   }

catalog/includes/functions/general.php

Doc Comments +14 added lines

@@ -79,6 +79,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 = '';
@@ -246,6 +249,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);
@@ -425,6 +431,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');
 
@@ -918,6 +929,9 @@ 
 
 ////
 // Return a product ID with attributes
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     if (is_numeric($prid)) {
       $uprid = (int)$prid;

catalog/includes/OSC/OM/HTML.php

Doc Comments +19 added lines

@@ -90,6 +90,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'])) {
@@ -162,6 +166,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) . '"';
@@ -183,6 +190,9 @@ 
         return $selection;
     }
 
+    /**
+     * @param string $name
+     */
     public static function checkboxField($name, $value = '', $checked = false, $parameters = '')
     {
         return static::selectionField($name, 'checkbox', $value, $checked, $parameters);
@@ -193,6 +203,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) . '"';
@@ -312,6 +327,10 @@ 
         return $field;
     }
 
+    /**
+     * @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/includes/functions/banner.php

Doc Comments +6 added lines

@@ -16,6 +16,9 @@ 
 
 ////
 // Sets the status of a banner
+  /**
+   * @param integer $status
+   */
   function tep_set_banner_status($banners_id, $status) {
     $OSCOM_Db = Registry::get('Db');
 
@@ -106,6 +109,9 @@ 
 
 ////
 // Check to see if a banner exists
+  /**
+   * @param string $action
+   */
   function tep_banner_exists($action, $identifier) {
     $OSCOM_Db = Registry::get('Db');
 

catalog/includes/classes/osc_template.php

Doc Comments +4 added lines

@@ -74,6 +74,10 @@
       return $this->_code;
     }
 
+    /**
+     * @param string $block
+     * @param string $group
+     */
     function addBlock($block, $group) {
       $this->_blocks[$group][] = $block;
     }

catalog/includes/OSC/OM/Mail.php

Doc Comments +18 added lines

@@ -24,6 +24,9 @@ 
               $content_transfer_encoding = '7bit',
               $charset = 'utf-8';
 
+    /**
+     * @param string $subject
+     */
     public function __construct($to_email_address = null, $to = null, $from_email_address = null, $from = null, $subject = null)
     {
         if (!empty($to_email_address)) {
@@ -91,6 +94,9 @@ 
         $this->subject = $subject;
     }
 
+    /**
+     * @param string $text
+     */
     public function setBody($text, $html = null)
     {
         $this->setBodyPlain($text);
@@ -124,6 +130,9 @@ 
         $this->charset = $charset;
     }
 
+    /**
+     * @param string $key
+     */
     public function addHeader($key, $value)
     {
         if ((strpos($key, "\n") !== false) || (strpos($key, "\r") !== false)) {
@@ -377,6 +386,9 @@ 
         ini_restore('sendmail_from');
     }
 
+    /**
+     * @param string $file
+     */
     protected function get_mime_type($file)
     {
         $ext = substr($file, strrpos($file, '.') + 1);
@@ -400,6 +412,9 @@ 
         }
     }
 
+    /**
+     * @param string $boundary
+     */
     protected function build_attachment($attachment, $boundary)
     {
         return '--' . $boundary . "\n" .
@@ -409,6 +424,9 @@ 
                 $attachment['data'] . "\n\n";
     }
 
+    /**
+     * @param string $boundary
+     */
     protected function build_image($image, $boundary)
     {
         return '--' . $boundary . "\n" .