bin add missing comment blocks (autogenerated)
authorEileen McNaughton <eileen@fuzion.co.nz>
Sat, 24 May 2014 03:14:18 +0000 (15:14 +1200)
committerEileen McNaughton <eileen@fuzion.co.nz>
Sat, 24 May 2014 03:14:18 +0000 (15:14 +1200)
14 files changed:
CRM/Contact/Form/Search/Custom/ContribSYBNT.php
api/v3/Generic.php
bin/ContributionProcessor.php
bin/cli.class.php
bin/deprecated/CiviReportMail.php
bin/deprecated/ParticipantProcessor.php
bin/deprecated/RespondentProcessor.php
bin/deprecated/UpdateAddress.php
bin/deprecated/UpdateGreeting.php
bin/deprecated/UpdateMembershipRecord.php
bin/deprecated/UpdateMembershipReminderDate.php
bin/deprecated/UpdatePledgeRecord.php
bin/deprecated/action.cronjob.php
bin/givi

index a07b5c3f60226e5cd375df6ee527e45de4f76964..5eee5ea65be1ee0fe6f70e1ca86ac9b65473b16d 100644 (file)
@@ -112,6 +112,9 @@ class CRM_Contact_Form_Search_Custom_ContribSYBNT implements CRM_Contact_Form_Se
     // @TODO: Add rule to ensure that exclusion dates are not in the inclusion range
   }
 
+  /**
+   * @return mixed
+   */
   function count() {
     $sql = $this->all();
 
index 78ca31f209854982387d239439c73ad52b321fff..d274ce532121abf8af78aa1754206fc400826a80 100644 (file)
@@ -205,6 +205,9 @@ function civicrm_api3_generic_getvalue($apiRequest) {
   return civicrm_api3_create_error("missing param return=field you want to read the value of", array('error_type' => 'mandatory_missing', 'missing_param' => 'return'));
 }
 
+/**
+ * @param $params
+ */
 function _civicrm_api3_generic_getrefcount_spec(&$params) {
   $params['id']['api.required'] = 1;
 }
index f46c458c4ed8ed5d70ab8281ac95fa74df679d08..3451e1b545d3ad5311297287e0d751342b1e925c 100644 (file)
@@ -136,6 +136,12 @@ class CiviContributeProcessor {
     ),
   );
 
+  /**
+   * @param $paymentProcessor
+   * @param $paymentMode
+   * @param $start
+   * @param $end
+   */
   static
   function paypal($paymentProcessor, $paymentMode, $start, $end) {
     $url = "{$paymentProcessor['url_api']}nvp";
@@ -236,6 +242,12 @@ class CiviContributeProcessor {
     } while ($result['l_errorcode0'] == '11002');
   }
 
+  /**
+   * @param $paymentProcessor
+   * @param $paymentMode
+   * @param $start
+   * @param $end
+   */
   static
   function google($paymentProcessor, $paymentMode, $start, $end) {
     require_once "CRM/Contribute/BAO/Contribution/Utils.php";
index a821dc21e6e24d5dae40f8584f1c2cb59775994a..c9215ec8619acbab2a66e44fecfc3482abc4ba0f 100644 (file)
@@ -59,6 +59,9 @@ class civicrm_cli {
 
   var $_errors = array();
 
+  /**
+   * @return bool
+   */
   public function initialize() {
     if (!$this->_accessing_from_cli()) {
       return FALSE;
@@ -84,6 +87,9 @@ class civicrm_cli {
     }
   }
 
+  /**
+   * @return bool
+   */
   public function callApi() {
     require_once 'api/api.php';
 
@@ -110,6 +116,9 @@ class civicrm_cli {
     return TRUE;
   }
 
+  /**
+   * @return bool
+   */
   private function _parseOptions() {
     $args = $_SERVER['argv'];
     // remove the first argument, which is the name
@@ -181,6 +190,9 @@ class civicrm_cli {
     return TRUE;
   }
 
+  /**
+   * @return bool
+   */
   private function _bootstrap() {
     // so the configuration works with php-cli
     $_SERVER['PHP_SELF'] = "/index.php";
@@ -207,12 +219,12 @@ class civicrm_cli {
     CRM_Core_ClassLoader::singleton()->register();
 
     $this->_config = CRM_Core_Config::singleton();
-    
+
     // HTTP_HOST will be 'localhost' unless overwritten with the -s argument.
     // Now we have a Config object, we can set it from the Base URL.
     if ($_SERVER['HTTP_HOST'] == 'localhost') {
         $_SERVER['HTTP_HOST'] = preg_replace(
-                '!^https?://([^/]+)/$!i', 
+                '!^https?://([^/]+)/$!i',
                 '$1',
                 $this->_config->userFrameworkBaseURL);
     }
@@ -246,6 +258,9 @@ class civicrm_cli {
     return TRUE;
   }
 
+  /**
+   * @return bool
+   */
   private function _validateOptions() {
     $required = $this->_required_arguments;
     while (list(, $var) = each($required)) {
@@ -260,12 +275,20 @@ class civicrm_cli {
     return TRUE;
   }
 
+  /**
+   * @param $value
+   *
+   * @return string
+   */
   private function _sanitize($value) {
     // restrict user input - we should not be needing anything
     // other than normal alpha numeric plus - and _.
     return trim(preg_replace('#^[^a-zA-Z0-9\-_=/]$#', '', $value));
   }
 
+  /**
+   * @return string
+   */
   private function _getUsage() {
     $out = "Usage: cli.php -e entity -a action [-u user] [-s site] [--output] [PARAMS]\n";
     $out .= "  entity is the name of the entity, e.g. Contact, Event, etc.\n";
@@ -277,6 +300,9 @@ class civicrm_cli {
     return ts($out);
   }
 
+  /**
+   * @param $error
+   */
   private function _log($error) {
     // fixme, this should call some CRM_Core_Error:: function
     // that properly logs
@@ -292,6 +318,9 @@ class civicrm_cli {
 class civicrm_cli_csv_exporter extends civicrm_cli {
   var $separator = ',';
 
+  /**
+   *
+   */
   function __construct() {
     $this->_required_arguments = array('entity');
     parent::initialize();
@@ -335,6 +364,9 @@ class civicrm_cli_csv_file extends civicrm_cli {
   var $header;
   var $separator = ',';
 
+  /**
+   *
+   */
   function __construct() {
     $this->_required_arguments = array('entity','file');
     $this->_additional_arguments = array('f' => 'file');
@@ -375,6 +407,11 @@ class civicrm_cli_csv_file extends civicrm_cli {
   }
 
   /* return a params as expected */
+  /**
+   * @param $data
+   *
+   * @return array
+   */
   function convertLine($data) {
     $params = array();
     foreach ($this->header as $i => $field) {
@@ -397,6 +434,9 @@ class civicrm_cli_csv_file extends civicrm_cli {
  **/
 
 class civicrm_cli_csv_importer extends civicrm_cli_csv_file {
+  /**
+   * @param $params
+   */
   function processline($params) {
     $result = civicrm_api($this->_entity, 'Create', $params);
     if ($result['is_error']) {
@@ -415,6 +455,9 @@ class civicrm_cli_csv_importer extends civicrm_cli_csv_file {
  **/
 
 class civicrm_cli_csv_deleter extends civicrm_cli_csv_file {
+  /**
+   * @param $params
+   */
   function processline($params) {
     $result = civicrm_api($this->_entity, 'Delete', $params);
     if ($result['is_error']) {
index 75516f49e7e4290c4a728fb068240f1333ffbfda..b5a99bdb91a0dbd12ed31f67e9cf3423c48e7b7f 100644 (file)
@@ -30,6 +30,9 @@
  * recipients mentioned for that report
  */
 class CiviReportMail {
+  /**
+   *
+   */
   function __construct() {
     $this->initialize();
 
index ea33f26754618f68e99cc58d292fc737d46d6fb7..9086e50fb60731fde2e4f04674fadb4ed16d3585 100644 (file)
 
 require_once '../civicrm.config.php';
 require_once 'CRM/Core/Config.php';
+
+/**
+ * Class CRM_ParticipantProcessor
+ */
 class CRM_ParticipantProcessor {
+  /**
+   *
+   */
   function __construct() {
     $config = CRM_Core_Config::singleton();
 
index 37194c3646bb868e289ad0b526d588677e40d52f..c17e8ef1bd8f18305663db648d130173e37a0a4c 100644 (file)
 
 require_once '../civicrm.config.php';
 require_once 'CRM/Core/Config.php';
+
+/**
+ * Class CRM_RespondentProcessor
+ */
 class CRM_RespondentProcessor {
+  /**
+   *
+   */
   function __construct() {
     $config = CRM_Core_Config::singleton();
 
index 767f503106f252dfeacecb5813975dcc8467098d..27ca82ca51a7fd5bb54f796621cd85fd2e15273d 100644 (file)
@@ -132,6 +132,13 @@ function run() {
   processContacts($config, $processGeocode, $parseStreetAddress, $start, $end);
 }
 
+/**
+ * @param $config
+ * @param $processGeocode
+ * @param $parseStreetAddress
+ * @param null $start
+ * @param null $end
+ */
 function processContacts(&$config, $processGeocode, $parseStreetAddress, $start = NULL, $end = NULL) {
   // build where clause.
   $clause = array('( c.id = a.contact_id )');
index 331a73ee6e8dfdf1fd87deb20463e4cd61011062..c7004cd7d6be763ba254904e42e9bd5fe6d5371b 100644 (file)
  * IMPORTANT: You must first create valid option value before using via admin interface.
  * Check option lists for Email Greetings, Postal Greetings and Addressee
  */
+
+/**
+ * Class CRM_UpdateGreeting
+ */
 class CRM_UpdateGreeting {
+  /**
+   *
+   */
   function __construct() {
     $this->initialize();
 
index fe6787be934d0c003117a28b3c5d95ab94e7c176..ec6cf569ba1ce85ec29b6c840d900a765c59cd07 100644 (file)
  *
  * Save the file as UpdateMembershipRecord.php prior to running this script.
  */
+
+/**
+ * Class CRM_UpdateMembershipRecord
+ */
 class CRM_UpdateMembershipRecord {
+  /**
+   *
+   */
   function __construct() {
     // you can run this program either from an apache command, or from the cli
     if (php_sapi_name() == "cli") {
index 5e21faf49a82c29e0f882a748771a489b3542281..427424414437e6b3ce0fe8f0717aa5b127359a40 100644 (file)
  * This file updates the Reminder dates of all valid membership records.
  *
  */
+
+/**
+ * Class CRM_UpdateMembershipReminderDate
+ */
 class CRM_UpdateMembershipReminderDate {
+  /**
+   *
+   */
   function __construct() {
     // you can run this program either from an apache command, or from the cli
     if (php_sapi_name() == "cli") {
index c64ee715f9a17c991ecf19bbb8705578c8fb5d4b..eafc94cb9e9e65f50789c62612c48dd0a149bf99 100644 (file)
 
 require_once '../civicrm.config.php';
 require_once 'CRM/Core/Config.php';
+
+/**
+ * Class CRM_UpdatePledgeRecord
+ */
 class CRM_UpdatePledgeRecord {
+  /**
+   *
+   */
   function __construct() {
     $config = CRM_Core_Config::singleton();
     // this does not return on failure
@@ -49,6 +56,11 @@ class CRM_UpdatePledgeRecord {
     CRM_Core_Error::debug_log_message('UpdatePledgeRecord.php');
   }
 
+  /**
+   * @param bool $sendReminders
+   *
+   * @throws Exception
+   */
   public function updatePledgeStatus($sendReminders = FALSE) {
 
     // *** Uncomment the next line if you want automated reminders to be sent
index 6c752914878172fe3586a3ce49dd87c233c52f87..7d432b9c66a77cb814500aef76a72f67e3b053fe 100644 (file)
 
 /*
  */
+
+/**
+ * Class CRM_Cron_Action
+ */
 class CRM_Cron_Action {
+  /**
+   *
+   */
   function __construct() {
     // you can run this program either from an apache command, or from the cli
     if (php_sapi_name() == "cli") {
@@ -57,6 +64,9 @@ class CRM_Cron_Action {
     $config = CRM_Core_Config::singleton();
   }
 
+  /**
+   * @param null $now
+   */
   public function run($now = NULL) {
     require_once 'CRM/Core/BAO/ActionSchedule.php';
     CRM_Core_BAO_ActionSchedule::processQueue($now);
index c0f3f5c07fd2a310fa461e4aeeb6f814046748f9..2ea009ce9dd5bafe59f9eaa2fdfca7811e2ec32e 100755 (executable)
--- a/bin/givi
+++ b/bin/givi
 class DirStack {
   protected $dirs;
 
+  /**
+   * @param array $dirs
+   */
   function __construct($dirs = array()) {
     $this->dirs = $dirs;
   }
 
+  /**
+   * @param $dir
+   *
+   * @throws Exception
+   */
   function push($dir) {
     $this->dirs[] = getcwd();
     if (!chdir($dir)) {
@@ -66,6 +74,9 @@ class PullRequest {
 
   protected $data;
 
+  /**
+   * @return mixed
+   */
   public function getNumber() {
     return $this->data->number;
   }
@@ -85,6 +96,9 @@ class PullRequest {
   }
 }
 
+/**
+ * Class Givi
+ */
 class Givi {
 
   /**
@@ -167,6 +181,9 @@ class Givi {
    */
   protected $dirStack;
 
+  /**
+   *
+   */
   function __construct() {
     $this->dirStack = new DirStack();
     $this->repos = array(
@@ -178,6 +195,11 @@ class Givi {
     );
   }
 
+  /**
+   * @param $args
+   *
+   * @throws Exception
+   */
   function main($args) {
     if (!$this->parseOptions($args)) {
       printf("Error parsing arguments\n");
@@ -350,6 +372,11 @@ class Givi {
     echo "local branches.\n";
   }
 
+  /**
+   * @param null $baseBranch
+   *
+   * @return bool
+   */
   function doCheckoutAll($baseBranch = NULL) {
     if (!$baseBranch) {
       return $this->returnError("Missing <branch>\n");
@@ -366,6 +393,9 @@ class Givi {
     return TRUE;
   }
 
+  /**
+   * @return bool
+   */
   function doStatusAll() {
     foreach ($this->repos as $repo => $relPath) {
       $this->run($repo, $relPath, 'git', 'status');
@@ -373,6 +403,11 @@ class Givi {
     return TRUE;
   }
 
+  /**
+   * @param null $baseBranch
+   *
+   * @return bool
+   */
   function doBegin($baseBranch = NULL) {
     if (!$baseBranch) {
       return $this->returnError("Missing <base-branch>\n");
@@ -400,6 +435,12 @@ class Givi {
     return TRUE;
   }
 
+  /**
+   * @param null $baseBranch
+   *
+   * @return bool
+   * @throws Exception
+   */
   function doResume($baseBranch = NULL) {
     if (!$baseBranch) {
       return $this->returnError("Missing <base-branch>\n");
@@ -426,6 +467,11 @@ class Givi {
     return TRUE;
   }
 
+  /**
+   * @param null $baseBranch
+   *
+   * @return bool
+   */
   function doReview($baseBranch = NULL) {
     if (! $this->doCheckoutAll($baseBranch)) {
       return FALSE;
@@ -491,6 +537,12 @@ class Givi {
   }
   */
 
+  /**
+   * @param $newBranchRepo
+   * @param $newBranchNames
+   *
+   * @return bool
+   */
   function doPush($newBranchRepo, $newBranchNames) {
     if (!$newBranchRepo) {
       return $this->returnError("Missing <remote>\n");
@@ -608,6 +660,12 @@ class Givi {
     return $branches;
   }
 
+  /**
+   * @param $repoName
+   * @param $branchName
+   *
+   * @return string
+   */
   function filterBranchName($repoName, $branchName) {
     if ($branchName == '') {
       return '';
@@ -645,6 +703,11 @@ class Givi {
     return $repos;
   }
 
+  /**
+   * @param $message
+   *
+   * @return bool
+   */
   function returnError($message) {
     echo "\nERROR: ", $message, "\n\n";
     $this->doHelp();
@@ -652,7 +715,16 @@ class Givi {
   }
 }
 
+/**
+ * Class HttpClient
+ */
 class HttpClient {
+  /**
+   * @param $url
+   * @param $file
+   *
+   * @return bool
+   */
   static function download($url, $file) {
     // PHP native client is unreliable PITA for HTTPS
     if (exec("which wget")) {
@@ -665,6 +737,11 @@ class HttpClient {
     return TRUE;
   }
 
+  /**
+   * @param $url
+   *
+   * @return mixed
+   */
   static function getJson($url) {
     $file = tempnam(sys_get_temp_dir(), 'givi-json-');
     HttpClient::download($url, $file);