INFRA-132 - Misc
authorTim Otten <totten@civicrm.org>
Tue, 20 Jan 2015 04:03:41 +0000 (20:03 -0800)
committerTim Otten <totten@civicrm.org>
Tue, 20 Jan 2015 04:03:41 +0000 (20:03 -0800)
25 files changed:
CRM/Contact/BAO/Contact.php
CRM/Contact/Form/Contact.php
CRM/Core/BAO/Address.php
CRM/Core/BAO/CustomField.php
CRM/Core/BAO/CustomGroup.php
CRM/Core/BAO/Discount.php
CRM/Core/BAO/OptionValue.php
CRM/Core/BAO/Setting.php
CRM/Core/BAO/Tag.php
CRM/Core/Form.php
CRM/Core/Payment/BaseIPN.php
CRM/Core/Payment/PayPalImpl.php
CRM/Core/Permission/WordPress.php
CRM/Event/BAO/Participant.php
api/api.php
api/v3/Address.php
api/v3/Case.php
api/v3/ContributionRecur.php
api/v3/Email.php
api/v3/GroupNesting.php
api/v3/LineItem.php
api/v3/MailingEventQueue.php
api/v3/MembershipType.php
api/v3/ParticipantPayment.php
api/v3/SurveyRespondant.php

index 8c1731f84c6075a6081eb8bf67194db524f80a3c..e556aa0690097cc97ca3a33ddfbb78fe49437ecd 100644 (file)
@@ -3133,7 +3133,7 @@ LEFT JOIN civicrm_address add2 ON ( add1.master_id = add2.id )
    * @param int $contactId
    *
    * @return array
-   *  Dates - ('created_date' => $, 'modified_date' => $)
+   *   Dates - ('created_date' => $, 'modified_date' => $)
    */
   public static function getTimestamps($contactId) {
     $timestamps = CRM_Core_DAO::executeQuery(
@@ -3301,7 +3301,7 @@ LEFT JOIN civicrm_address add2 ON ( add1.master_id = add2.id )
    * @param array $props
    *   whatever is known about this dao object.
    *
-   * @return Array|bool
+   * @return array|bool
    */
   public static function buildOptions($fieldName, $context = NULL, $props = array()) {
     $params = array();
index cb7122d0a4dc7305d41789de17313677bbc97ad4..7e6ef24df5397faff621060c8b1ce0817c7eace3 100644 (file)
@@ -1066,7 +1066,7 @@ class CRM_Contact_Form_Contact extends CRM_Core_Form {
    * @param array $fields
    *   The hierarchical value representation of this location.
    *
-   * @return boolean
+   * @return bool
    *   true if data exists, false otherwise
    */
   public static function blockDataExists(&$fields) {
index 093c72bd5e3cf3cd320f19a974a1f41ff70d38c5..d6866ad381560052f058124596a8a7d09e6977f7 100644 (file)
@@ -405,8 +405,7 @@ class CRM_Core_BAO_Address extends CRM_Core_DAO_Address {
    * @param array $params
    *   (reference ) an assoc array of name/value pairs.
    *
-   * @return boolean
-   *
+   * @return bool
    */
   public static function dataExists(&$params) {
     //check if location type is set if not return false
@@ -1251,7 +1250,7 @@ SELECT is_primary,
    * @param array $props
    *   whatever is known about this dao object.
    *
-   * @return Array|bool
+   * @return array|bool
    */
   public static function buildOptions($fieldName, $context = NULL, $props = array()) {
     $params = array();
index 9e00a723930b7229e71aac4c7a4aef68805993cd..8bd142da0a899bed25bafe0a15c4c2ab7498643f 100644 (file)
@@ -700,8 +700,7 @@ class CRM_Core_BAO_CustomField extends CRM_Core_DAO_CustomField {
    *   The custom field ID.
    *
    * @return CRM_Core_DAO_CustomField
-   *   $field  the field object
-   * public
+   *   The field object.
    */
   public static function getFieldObject($fieldID) {
     $field = new CRM_Core_DAO_CustomField();
@@ -1920,8 +1919,8 @@ SELECT $columnName
    * @param int $newGroupID
    *   FK to civicrm_custom_group.
    *
-   * @return array(
-   * string) or TRUE
+   * @return array
+   *   array(string) or TRUE
    */
   public static function _moveFieldValidate($fieldID, $newGroupID) {
     $errors = array();
index c65935f198517b10f153f2605747b40e088a3a89..0cee4a3381386113ae4671a8231ced9c69f8250a 100644 (file)
@@ -651,7 +651,7 @@ ORDER BY civicrm_custom_group.weight,
    *
    * @param bool $getCount
    *
-   * @return boolean
+   * @return bool
    *   does this entity have data in this custom table
    */
   static public function customGroupDataExistsForEntity($entityID, $table, $getCount = FALSE) {
@@ -1242,9 +1242,8 @@ ORDER BY civicrm_custom_group.weight,
    * @param bool $force
    *   whether to force the deletion, even if there are custom fields.
    *
-   * @return boolean
+   * @return bool
    *   false if field exists for this group, true if group gets deleted.
-   *
    */
   public static function deleteGroup($group, $force = FALSE) {
 
@@ -1695,8 +1694,7 @@ ORDER BY civicrm_custom_group.weight,
    * @param array $removeCustomFieldTypes
    *   Remove custom fields of a type eg: array("Individual") ;.
    *
-   *
-   * @return boolean
+   * @return bool
    *   false if it matches else true
    */
   public static function checkCustomField($customFieldId, &$removeCustomFieldTypes) {
index 496b8cf21d44b3c79f4b44e27cdf0f1dc55c9d5d..325dabb7f104d90dbfc94f383d13eb1f45d1943a 100644 (file)
@@ -47,7 +47,7 @@ class CRM_Core_BAO_Discount extends CRM_Core_DAO_Discount {
    * @param int $entityId
    * @param string $entityTable
    *
-   * @return boolean
+   * @return bool
    */
   public static function del($entityId, $entityTable) {
     // delete all discount records with the selected discounted id
index e29148c0df816aa72f74502069dc20cde9c2430d..f0ce92cbfccaac8b67a306082005ccdff2289716 100644 (file)
@@ -231,7 +231,7 @@ class CRM_Core_BAO_OptionValue extends CRM_Core_DAO_OptionValue {
    *
    * @param int $optionValueId
    *
-   * @return boolean
+   * @return bool
    *
    */
   public static function del($optionValueId) {
index 250e1e1aaf72e38516ae6d20ab1e3f22d576234d..ada8d3eecc842f3bdc5664a67530d88e634d49d2 100644 (file)
@@ -79,7 +79,7 @@ class CRM_Core_BAO_Setting extends CRM_Core_DAO_Setting {
    * @param int $domainID
    * @param bool $force
    *
-   * @return boolean
+   * @return bool
    *   true if item is already in cache
    */
   public static function inCache(
@@ -637,14 +637,14 @@ class CRM_Core_BAO_Setting extends CRM_Core_DAO_Setting {
    *
    * @return array
    *   the following information as appropriate for each setting
-   * - name
-   * - type
-   * - default
-   * - add (CiviCRM version added)
-   * - is_domain
-   * - is_contact
-   * - description
-   * - help_text
+   *   - name
+   *   - type
+   *   - default
+   *   - add (CiviCRM version added)
+   *   - is_domain
+   *   - is_contact
+   *   - description
+   *   - help_text
    */
   public static function getSettingSpecification(
     $componentID = NULL,
@@ -1111,7 +1111,7 @@ AND domain_id = %3
   /**
    * Civicrm_setting didn't exist before 4.1.alpha1 and this function helps taking decisions during upgrade
    *
-   * @return boolean
+   * @return bool
    */
   public static function isUpgradeFromPreFourOneAlpha1() {
     if (CRM_Core_Config::isUpgradeMode()) {
index 68f3b316f25cc8a54a9b9b445e0ed72fa80c3c53..730fd8d3afb9e6b0f200557667855aed06540e31 100644 (file)
@@ -319,7 +319,7 @@ class CRM_Core_BAO_Tag extends CRM_Core_DAO_Tag {
    * @param int $id
    *   Tag id.
    *
-   * @return boolean
+   * @return bool
    */
   public static function del($id) {
     // since this is a destructive operation, lets make sure
@@ -408,7 +408,7 @@ class CRM_Core_BAO_Tag extends CRM_Core_DAO_Tag {
    * @param array $params
    *   (reference ) an assoc array of name/value pairs.
    *
-   * @return boolean
+   * @return bool
    */
   public static function dataExists(&$params) {
     // Disallow empty values except for the number zero.
index 4f35d1ab3b26783393928f20ccc0505ef287b81f..7d868d19160703b55ca842467426416404bd9951 100644 (file)
@@ -409,7 +409,7 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
   /**
    * Performs the server side validation
    * @since     1.0
-   * @return boolean
+   * @return bool
    *   true if no error found
    * @throws    HTML_QuickForm_Error
    */
@@ -643,7 +643,7 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
   /**
    * Boolean function to determine if this is a one form page
    *
-   * @return boolean
+   * @return bool
    */
   public function isSimpleForm() {
     return $this->_state->getType() & (CRM_Core_State::START | CRM_Core_State::FINISH);
@@ -1570,7 +1570,7 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
    *   - cid from the url if the caller has ACL permission to view
    *   - fallback is logged in user (or ? NULL if no logged in user) (@todo wouldn't 0 be more intuitive?)
    *
-   * @return NULL|integer
+   * @return NULL|int
    */
   public function getContactID() {
     $tempID = CRM_Utils_Request::retrieve('cid', 'Positive', $this);
index f0f04990092c7fbdebab845764bbc67d93b4819a..dd66874cd257ec8f49284f13eb0978ab49046455 100644 (file)
@@ -86,7 +86,7 @@ class CRM_Core_Payment_BaseIPN {
    *   Boolean Return FALSE if the relevant objects don't exist.
    * @param int $paymentProcessorID
    *   Id of the payment processor ID in use.
-   * @return boolean
+   * @return bool
    */
   public function validateData(&$input, &$ids, &$objects, $required = TRUE, $paymentProcessorID = NULL) {
 
@@ -135,7 +135,7 @@ class CRM_Core_Payment_BaseIPN {
    * @param int $paymentProcessorID
    * @param array $error_handling
    *
-   * @return boolean
+   * @return bool
    */
   public function loadObjects(&$input, &$ids, &$objects, $required, $paymentProcessorID, $error_handling = NULL) {
     if (empty($error_handling)) {
@@ -185,7 +185,7 @@ class CRM_Core_Payment_BaseIPN {
    * @param array $objects
    * @param object $transaction
    * @param array $input
-   * @return boolean
+   * @return bool
    */
   public function failed(&$objects, &$transaction, $input = array()) {
     $contribution = &$objects['contribution'];
@@ -265,7 +265,7 @@ class CRM_Core_Payment_BaseIPN {
    * Handled pending contribution status
    * @param array $objects
    * @param object $transaction
-   * @return boolean
+   * @return bool
    */
   public function pending(&$objects, &$transaction) {
     $transaction->commit();
index 2ab4853b2a1c98c2068f04d722cdcb324efe205a..4404f71034358896dc756cee1fe4afebf472ef73 100644 (file)
@@ -426,7 +426,7 @@ class CRM_Core_Payment_PayPalImpl extends CRM_Core_Payment {
    * @param string $method
    *   Method to check for.
    *
-   * @return boolean
+   * @return bool
    */
   public function isSupported($method = 'cancelSubscription') {
     if ($this->_paymentProcessor['payment_processor_type'] != 'PayPal') {
index 663644d7b5927053d5be7977db79a8304c6a81c6..97cbf01c1bf5c73abd1d040105cbeaf83265f1c1 100644 (file)
@@ -43,7 +43,7 @@ class CRM_Core_Permission_WordPress extends CRM_Core_Permission_Base {
    * @param string $str
    *   The permission to check.
    *
-   * @return boolean
+   * @return bool
    *   true if yes, else false
    */
   public function check($str) {
index 32a611db0b901008d223772e0928c5f0f2a8b9f4..6c49c109fe310402e198697674c56602985878d2 100644 (file)
@@ -2167,7 +2167,7 @@ WHERE (li.entity_table = 'civicrm_participant' AND li.entity_id = {$participantI
    * @param array $props
    *   whatever is known about this dao object.
    *
-   * @return Array|bool
+   * @return array|bool
    */
   public static function buildOptions($fieldName, $context = NULL, $props = array()) {
     $params = array('condition' => array());
index 3d526247ecd93104440d27614136f34df86cea95..9425c81057f3784d785ba656636f93b572045aca 100644 (file)
@@ -89,7 +89,7 @@ function _civicrm_api3_api_getfields(&$apiRequest) {
  *
  * @param $result
  *
- * @return boolean
+ * @return bool
  *   true if error, false otherwise
  */
 function civicrm_error($result) {
index 65ae3b95ff4ce5d74bc80f2d30da6dc06f8b01aa..6cc1bfdc1e5b58bd37a02afd3c9932e8faa4e984 100644 (file)
@@ -142,13 +142,11 @@ function civicrm_api3_address_delete($params) {
  *
  * @param mixed[] (reference ) input parameters
  *
- * {@example AddressGet.php 0}
  * @param array $params
  *   An associative array of name/value pairs.
  *
  * @return array
  *   details of found addresses else error
- * {@getfields address_get}
  */
 function civicrm_api3_address_get(&$params) {
   return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params, TRUE, 'Address');
index c8aa5ca9a780586df7b9c183243755892dd30ddd..bb551985a78871b4055dc3006023c2285d8ee9d1 100644 (file)
@@ -368,7 +368,7 @@ function civicrm_api3_case_update($params) {
  * 'move_to_trash' => bool (defaults to false)
  *
  * @throws API_Exception
- * @return boolean
+ * @return bool
  *   true if success, else false
  */
 function civicrm_api3_case_delete($params) {
index 08b69df2d1f071d1f84d04fe9ae49ad386ed68e8..6b82a8a660aaa51da573a3e6752fc5b9758dd9f4 100644 (file)
@@ -43,7 +43,6 @@
  *
  * @return array
  *   api result array
- * {@getfields contribution_recur_create}
  */
 function civicrm_api3_contribution_recur_create($params) {
   return _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -73,7 +72,6 @@ function _civicrm_api3_contribution_recur_create_spec(&$params) {
  *
  * @return array
  *   API result Array of matching contribution_recurs
- * {@getfields contribution_recur_get}
  */
 function civicrm_api3_contribution_recur_get($params) {
   return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -85,7 +83,7 @@ function civicrm_api3_contribution_recur_get($params) {
  * @param array $params
  *   (reference) array containing id of the recurring contribution.
  *
- * @return boolean
+ * @return bool
  *   returns true is successfully cancelled
  */
 function civicrm_api3_contribution_recur_cancel($params) {
@@ -105,8 +103,6 @@ function civicrm_api3_contribution_recur_cancel($params) {
  *
  * @return array
  *   API result array
- *                message otherwise
- * {@getfields contribution_recur_delete}
  */
 function civicrm_api3_contribution_recur_delete($params) {
   return _civicrm_api3_basic_delete(_civicrm_api3_get_BAO(__FUNCTION__), $params);
index 34636e58e8a35404c69db46e909bfd283a89dd45..f4d16f4de42f19b0a077712519934d28cbb38d11 100644 (file)
@@ -46,7 +46,6 @@
  *
  * @return array
  *   API result array
- * {@getfields email_create}
  */
 function civicrm_api3_email_create($params) {
   return _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -73,9 +72,8 @@ function _civicrm_api3_email_create_spec(&$params) {
  *
  * @example EmailDelete.php Standard Delete Example
  *
- * @return boolean
+ * @return bool
  *   | error  true if successfull, error otherwise
- * {@getfields email_delete}
  */
 function civicrm_api3_email_delete($params) {
   return _civicrm_api3_basic_delete(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -94,7 +92,6 @@ function civicrm_api3_email_delete($params) {
  *
  * @return array
  *   api result array
- * {@getfields email_get}
  */
 function civicrm_api3_email_get($params) {
 
index a6643f1af55311ef93dd020138318df7c902fca7..c0bf9d7e6aa3d6146399618ffdb2759a2a413418 100644 (file)
@@ -60,7 +60,6 @@ function civicrm_api3_group_nesting_get($params) {
  *
  * @return array
  *   TBD
- * {@getfields GroupNesting_create
  * @todo Work out the return value.
  */
 function civicrm_api3_group_nesting_create($params) {
index e26cc62d434d3e90ae3168266ec6d37e2c4110ec..77095c305b510b478b8725cbe97bfde82e1ef73f 100644 (file)
@@ -44,7 +44,6 @@
  *
  * @return array
  *   api result array
- * {@getfields line_item_create}
  */
 function civicrm_api3_line_item_create($params) {
   $params = CRM_Contribute_BAO_Contribution::checkTaxAmount($params, TRUE);
@@ -75,7 +74,6 @@ function _civicrm_api3_line_item_create_spec(&$params) {
  *
  * @return array
  *   Array of matching line_items
- * {@getfields line_item_get}
  */
 function civicrm_api3_line_item_get($params) {
   return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -93,7 +91,6 @@ function civicrm_api3_line_item_get($params) {
  *
  * @return array
  *   API result array
- * {@getfields line_item_delete}
  */
 function civicrm_api3_line_item_delete($params) {
   return _civicrm_api3_basic_delete(_civicrm_api3_get_BAO(__FUNCTION__), $params);
index adada75eb31d70dedf42daf20098b3f49bae2148..366312366779d1bc2f65dc8ea9c7e1c3e5e26da4 100644 (file)
  * $Id$
  *
  */
+
 /**
  * Handle a confirm event
  *
  * @param array $params
  *   Associative array of property.
- *                       name/value pairs to insert in new 'survey'
  *
  * @throws Exception
  * @return array
  *   api result array
- * {@getfields mailing_event_confirm_create}
  */
 function civicrm_api3_mailing_event_queue_create($params) {
   if (!array_key_exists('id', $params) && !array_key_exists('email_id', $params) && !array_key_exists('phone_id', $params)) {
index 2ba0b8a8f7f15c49e4f9ea64dc7cca7dd7a7dcec..483fb710f789c640e389b86db2f827d908fe0b55 100644 (file)
@@ -100,7 +100,7 @@ function civicrm_api3_membership_type_get($params) {
  *
  * @param array $params
  *
- * @return boolean
+ * @return bool
  *   true if success, else false
  */
 function civicrm_api3_membership_type_delete($params) {
index be5ff03ba830885cbd78fcfaa1544eff315210c8..d71dbc9999562f9faf283bd410dc3d4bec1739aa 100644 (file)
  *
  * @param array $params
  *   An associative array of name/value property values of civicrm_participant_payment.
- * @example ParticipantPaymentCreate.php
- * {@example ParticipantPaymentCreate.php 0}
  *
  * @return array
  *   Array of newly created payment property values.
- * {@getfields ParticipantPayment_create}
  */
 function civicrm_api3_participant_payment_create($params) {
 
index 11cd9170de39f83edc64c73f9ab54aba7d1a7ce4..86da40035e528eeb974cad4bc1bdfb880e7d2f38 100644 (file)
@@ -48,7 +48,6 @@ function _civicrm_api3_survey_respondant_deprecation() {
  *   (reference ) input parameters.
  *
  * @return array
- *  contribution_id of created or updated record
  */
 function civicrm_api3_survey_respondant_get(&$params) {