+--------------------------------------------------------------------+
| CiviCRM version 4.6 |
+--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2014 |
+ | Copyright CiviCRM LLC (c) 2004-2015 |
+--------------------------------------------------------------------+
| This file is a part of CiviCRM. |
| |
/**
*
* @package CiviCRM_Hook
- * @copyright CiviCRM LLC (c) 2004-2014
+ * @copyright CiviCRM LLC (c) 2004-2015
* $Id: $
*
*/
private $commonCiviModules = array();
/**
- * Constructor and getter for the singleton instance
+ * Constructor and getter for the singleton instance.
*
* @param bool $fresh
*
}
/**
- * Invoke hooks
+ * Invoke hooks.
*
* @param int $numParams
* Number of parameters to pass to the hook.
}
/**
- * This hook retrieves links from other modules and injects it into
+ * This hook retrieves links from other modules and injects it into.
* the view contact tabs
*
* @param string $op
}
/**
- * This hook is called before a db write on a custom table
+ * This hook is called after a db write on a custom table.
*
* @param string $op
* The type of operation being performed.
}
/**
- * This hook is called when building the menu table
+ * This hook is called when building the menu table.
*
* @param array $files
* The current set of files to process.
}
/**
- * Determine how many other records refer to a given record
+ * Determine how many other records refer to a given record.
*
* @param CRM_Core_DAO $dao
* The item for which we want a reference count.
* - name: string, eg "sql:civicrm_email:contact_id"
* - type: string, eg "sql"
* - count: int, eg "5" if there are 5 email addresses that refer to $dao
- * @return void
+ *
+ * @return mixed
+ * Return is not really intended to be used.
*/
public static function referenceCounts($dao, &$refCounts) {
return self::singleton()->invoke(2, $dao, $refCounts,
}
/**
- * This hook is called when building the amount structure for a Contribution or Event Page
+ * This hook is called when building the amount structure for a Contribution or Event Page.
*
* @param int $pageType
* Is this a contribution or event page.
}
/**
- * This hook is called when rendering the contact summary
+ * This hook is called when rendering the contact summary.
*
* @param int $contactID
* The contactID for whom the summary is being rendered
*
* Definition will look like this:
*
- * function hook_civicrm_alterPaymentProcessorParams($paymentObj,
- * &$rawParams, &$cookedParams);
+ * function hook_civicrm_alterPaymentProcessorParams(
+ * $paymentObj,
+ * &$rawParams,
+ * &$cookedParams
+ * );
*
- * @param string $paymentObj
- * instance of payment class of the payment processor invoked (e.g., 'CRM_Core_Payment_Dummy')
+ * @param CRM_Core_Payment $paymentObj
+ * Instance of payment class of the payment processor invoked (e.g., 'CRM_Core_Payment_Dummy')
+ * See discussion in CRM-16224 as to whether $paymentObj should be passed by reference.
* @param array &$rawParams
* array of params as passed to to the processor
* @param array &$cookedParams
* params after the processor code has translated them into its own key/value pairs
*
* @return mixed
+ * This return is not really intended to be used.
*/
public static function alterPaymentProcessorParams(
$paymentObj,
}
/**
- * This hook is called when membership status is being calculated
+ * This hook is called when membership status is being calculated.
*
* @param array $membershipStatus
* Membership status details as determined - alter if required.
}
/**
- * This hook is called when rendering the Manage Case screen
+ * This hook is called when rendering the Manage Case screen.
*
* @param int $caseID
* The case ID.
}
/**
- * @param $recordBAO
- * @param int $recordID
- * @param $isActive
- *
- * @return mixed
- */
- public static function enableDisable($recordBAO, $recordID, $isActive) {
- return self::singleton()->invoke(3, $recordBAO, $recordID, $isActive,
- self::$_nullObject, self::$_nullObject, self::$_nullObject,
- 'civicrm_enableDisable'
- );
- }
-
- /**
- * This hooks allows to change option values
+ * This hooks allows to change option values.
*
* @param array $options
* Associated array of option values / id
}
/**
- * This hook is called before record is exported as CSV
+ * This hook is called before record is exported as CSV.
*
* @param string $exportTempTable
* Name of the temporary export table used during export.
}
/**
- * Hook definition for altering the generation of Mailing Labels
+ * Hook definition for altering the generation of Mailing Labels.
*
* @param array $args
* An array of the args in the order defined for the tcpdf multiCell api call.
}
/**
- * This hooks allows alteration of generated page content
+ * This hooks allows alteration of generated page content.
*
* @param $content
* Previously generated content.
}
/**
- * This hook collects the trigger definition from all components
+ * This hook collects the trigger definition from all components.
*
* @param $info
* @param string $tableName
}
/**
- * This hook is called when Settings specifications are loaded
+ * This hook is called when Settings specifications are loaded.
*
* @param array $settingsFolders
* List of paths from which to derive metadata
}
/**
- * This hook is called for declaring managed entities via API
+ * This hook is called for declaring managed entities via API.
*
* @param array[] $entityTypes
* List of entity types; each entity-type is an array with keys:
}
/**
- * This hook is called while preparing a profile form
+ * This hook is called while preparing a profile form.
*
* @param string $name
* @return mixed
}
/**
- * This hook is called while validating a profile form submission
+ * This hook is called while validating a profile form submission.
*
* @param string $name
* @return mixed
}
/**
- * This hook is called processing a valid profile form submission
+ * This hook is called processing a valid profile form submission.
*
* @param string $name
* @return mixed
/**
- * This hook is called before encoding data in barcode
+ * This hook is called before encoding data in barcode.
*
* @param array $data
* Associated array of values available for encoding.
}
/**
- * This hook is called while viewing contact dashboard
+ * This hook is called while viewing contact dashboard.
*
* @param array $availableDashlets
* List of dashlets; each is formatted per api/v3/Dashboard
}
/**
- * Generate a default CRUD URL for an entity
+ * Generate a default CRUD URL for an entity.
*
* @param array $spec
* With keys:.