osCommerce / oscommerce2

catalog/admin/includes/classes/email.php

Doc Comments +6 added lines

@@ -82,6 +82,7 @@ 
  * it. This can then be given as the first
  * argument of the the functions
  * add_html_image() or add_attachment().
+ * @param string $filename
  */
 
     function get_file($filename) {
@@ -153,6 +154,7 @@ 
  * Adds a html part to the mail.
  * Also replaces image names with
  * content-id's.
+ * @param string $text
  */
 
     function add_html($html, $text = NULL, $images_dir = NULL) {
@@ -165,6 +167,7 @@ 
 /**
  * Adds an image to the list of embedded
  * images.
+ * @param string $file
  */
 
     function add_html_image($file, $name = '', $c_type='application/octet-stream') {
@@ -239,6 +242,9 @@ 
 
 /* HPDL PHP3 */
 //    function &add_alternative_part(&$obj) {
+    /**
+     * @param null|mime $obj
+     */
     function add_alternative_part(&$obj) {
       $params['content_type'] = 'multipart/alternative';
 

catalog/admin/includes/classes/language.php

Doc Comments +3 added lines

@@ -70,6 +70,9 @@
       $this->set_language($lng);
     }
 
+    /**
+     * @param string $language
+     */
     function set_language($language) {
       if ( (tep_not_null($language)) && (isset($this->catalog_languages[$language])) ) {
         $this->language = $this->catalog_languages[$language];

catalog/admin/includes/classes/logger.php

Doc Comments +4 added lines

@@ -45,6 +45,10 @@
       return '<span class="smallText">Parse Time: ' . $this->timer_total . 's</span>';
     }
 
+    /**
+     * @param string $message
+     * @param string $type
+     */
     function write($message, $type) {
       error_log(strftime(STORE_PARSE_DATE_TIME_FORMAT) . ' [' . $type . '] ' . $message . "\n", 3, STORE_PAGE_PARSE_TIME_LOG);
     }

catalog/admin/includes/functions/compatibility.php

Doc Comments +12 added lines

@@ -55,6 +55,10 @@ 
   }
 
   if (!function_exists('checkdnsrr')) {
+
+    /**
+     * @param string $type
+     */
     function checkdnsrr($host, $type) {
       if(tep_not_null($host) && tep_not_null($type)) {
         @exec("nslookup -type=" . escapeshellarg($type) . " " . escapeshellarg($host), $output);
@@ -74,6 +78,11 @@ 
  */
 
   if ( !function_exists('http_build_query') && (PHP_VERSION >= 4)) {
+
+    /**
+     * @param string $numeric_prefix
+     * @param string $arg_separator
+     */
     function http_build_query($formdata, $numeric_prefix = null, $arg_separator = null) {
 // If $formdata is an object, convert it to an array
       if ( is_object($formdata) ) {
@@ -125,6 +134,9 @@ 
     }
 
 // Helper function
+    /**
+     * @param string $name
+     */
     function http_build_query_helper($array, $name, $arg_separator) {
       $tmp = array();
 

catalog/admin/includes/functions/database.php

Doc Comments +13 added lines

@@ -32,6 +32,10 @@ 
     return mysqli_close($$link);
   }
 
+  /**
+   * @param integer $errno
+   * @param string $error
+   */
   function tep_db_error($query, $errno, $error) {
     global $logger;
 
@@ -55,6 +59,9 @@ 
     return $result;
   }
 
+  /**
+   * @param string $table
+   */
   function tep_db_perform($table, $data, $action = 'insert', $parameters = '', $link = 'db_link') {
     reset($data);
     if ($action == 'insert') {
@@ -205,6 +212,9 @@ 
       return mysql_error($link);
     }
 
+    /**
+     * @param string $charset
+     */
     function mysqli_set_charset($link, $charset) {
       if ( function_exists('mysql_set_charset') ) {
         return mysql_set_charset($charset, $link);
@@ -235,6 +245,9 @@ 
       return mysql_error($link);
     }
 
+    /**
+     * @param integer $type
+     */
     function mysqli_fetch_array($query, $type) {
       return mysql_fetch_array($query, $type);
     }

catalog/admin/includes/functions/general.php

Doc Comments +45 added lines

@@ -167,6 +167,9 @@ 
 
   }
 
+  /**
+   * @param string $raw_datetime
+   */
   function tep_datetime_short($raw_datetime) {
     if ( ($raw_datetime == '0000-00-00 00:00:00') || ($raw_datetime == '') ) return false;
 
@@ -277,6 +280,10 @@ 
     return $image;
   }
 
+  /**
+   * @param string $string
+   * @param integer $len
+   */
   function tep_break_string($string, $len, $break_char = '-') {
     $l = 0;
     $output = '';
@@ -334,6 +341,9 @@ 
     }
   }
 
+  /**
+   * @param string $component
+   */
   function tep_browser_detect($component) {
     global $HTTP_USER_AGENT;
 
@@ -379,6 +389,11 @@ 
     return $geo_zone_name;
   }
 
+  /**
+   * @param boolean $html
+   * @param string $boln
+   * @param string $eoln
+   */
   function tep_address_format($address_format_id, $address, $html, $boln, $eoln) {
     $address_format_query = tep_db_query("select address_format as format from " . TABLE_ADDRESS_FORMAT . " where address_format_id = '" . (int)$address_format_id . "'");
     $address_format = tep_db_fetch_array($address_format_query);
@@ -476,6 +491,9 @@ 
     return $state_prov_code;
   }
 
+  /**
+   * @param string $params
+   */
   function tep_get_uprid($prid, $params) {
     $uprid = $prid;
     if ( (is_array($params)) && (!strstr($prid, '{')) ) {
@@ -573,6 +591,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);
@@ -732,6 +753,9 @@ 
 
 ////
 // Sets the status of a banner
+  /**
+   * @param string $status
+   */
   function tep_set_banner_status($banners_id, $status) {
     if ($status == '1') {
       return tep_db_query("update " . TABLE_BANNERS . " set status = '1', expires_impressions = NULL, expires_date = NULL, date_status_change = NULL where banners_id = '" . $banners_id . "'");
@@ -768,6 +792,9 @@ 
 
 ////
 // Sets the status of a product on special
+  /**
+   * @param string $status
+   */
   function tep_set_specials_status($specials_id, $status) {
     if ($status == '1') {
       return tep_db_query("update " . TABLE_SPECIALS . " set status = '1', expires_date = NULL, date_status_change = NULL where specials_id = '" . (int)$specials_id . "'");
@@ -1018,6 +1045,9 @@ 
     tep_db_query("delete from " . TABLE_ORDERS_TOTAL . " where orders_id = '" . (int)$order_id . "'");
   }
 
+  /**
+   * @param string $cache_block
+   */
   function tep_reset_cache_block($cache_block) {
     global $cache_blocks;
 
@@ -1161,6 +1191,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;
 
@@ -1213,6 +1248,9 @@ 
 
 ////
 // Wrapper function for round() for php3 compatibility
+  /**
+   * @return double
+   */
   function tep_round($value, $precision) {
     return round($value, $precision);
   }
@@ -1329,6 +1367,10 @@ 
 
 ////
 // Return a random value
+  /**
+   * @param integer $min
+   * @param integer $max
+   */
   function tep_rand($min = null, $max = null) {
     static $seeded;
 
@@ -1352,6 +1394,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) {
     if ((PHP_VERSION < "4.0.5") && is_array($from)) {
       return preg_replace('/(' . implode('|', $from) . ')/', $to, $string);

catalog/admin/includes/functions/html_output.php

Doc Comments +22 added lines

@@ -109,6 +109,9 @@ 
 ////
 // The HTML form submit button wrapper function
 // Outputs a button in the selected language
+  /**
+   * @param string $image
+   */
   function tep_image_submit($image, $alt = '', $parameters = '') {
     global $language;
 
@@ -176,6 +179,9 @@ 
 
 ////
 // Output a form
+  /**
+   * @param string $name
+   */
   function tep_draw_form($name, $action, $parameters = '', $method = 'post', $params = '') {
     $form = '<form name="' . tep_output_string($name) . '" action="';
     if (tep_not_null($parameters)) {
@@ -238,6 +244,9 @@ 
 
 ////
 // Output a selection field - alias function for tep_draw_checkbox_field() and tep_draw_radio_field()
+  /**
+   * @param string $type
+   */
   function tep_draw_selection_field($name, $type, $value = '', $checked = false, $compare = '') {
     global $HTTP_GET_VARS, $HTTP_POST_VARS;
 
@@ -256,6 +265,9 @@ 
 
 ////
 // Output a form checkbox field
+  /**
+   * @param string $name
+   */
   function tep_draw_checkbox_field($name, $value = '', $checked = false, $compare = '') {
     return tep_draw_selection_field($name, 'checkbox', $value, $checked, $compare);
   }
@@ -269,6 +281,10 @@ 
 ////
 // Output a form textarea field
 // The $wrap parameter is no longer used in the core xhtml template
+  /**
+   * @param string $name
+   * @param string|false $wrap
+   */
   function tep_draw_textarea_field($name, $wrap, $width, $height, $text = '', $parameters = '', $reinsert_value = true) {
     global $HTTP_GET_VARS, $HTTP_POST_VARS;
 
@@ -365,6 +381,12 @@ 
 
 ////
 // Output a jQuery UI Button
+  /**
+   * @param string $title
+   * @param string $icon
+   * @param string $link
+   * @param string $priority
+   */
   function tep_draw_button($title = null, $icon = null, $link = null, $priority = null, $params = null) {
     static $button_counter = 1;
 

catalog/ext/modules/payment/inpay/inpay_functions.php

Doc Comments +5 added lines

@@ -12,6 +12,11 @@
 /* Ensure the http_build_query is defined */

 

 if (!function_exists('http_build_query')) { 

+
+    /**
+     * @param string $prefix
+     * @param string $sep
+     */
     function http_build_query($data, $prefix='', $sep='', $key='') { 

         $ret = array(); 

         foreach ((array)$data as $k => $v) { 

catalog/includes/apps/paypal/modules/DP/DP.php

Doc Comments +3 added lines

@@ -69,6 +69,9 @@
       return $this->doMigrationCheck($this->_pm_code) || $this->doMigrationCheck($this->_pm_pf_code);
     }
 
+    /**
+     * @param string $class
+     */
     function doMigrationCheck($class) {
       if ( file_exists(DIR_FS_CATALOG . 'includes/modules/payment/' . $class . '.php') ) {
         if ( !class_exists($class) ) {