+--------------------------------------------------------------------+
| CiviCRM version 4.6 |
+--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2014 |
+ | Copyright CiviCRM LLC (c) 2004-2015 |
+--------------------------------------------------------------------+
| This file is a part of CiviCRM. |
| |
| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+ */
/**
*
* @package CRM
- * @copyright CiviCRM LLC (c) 2004-2014
+ * @copyright CiviCRM LLC (c) 2004-2015
* $Id$
*
*/
require_once 'packages/When/When.php';
+/**
+ * Class CRM_Core_BAO_RecurringEntity
+ */
class CRM_Core_BAO_RecurringEntity extends CRM_Core_DAO_RecurringEntity {
const RUNNING = 1;
public static $status = NULL;
- static $_recurringEntityHelper =
- array(
+ static $_recurringEntityHelper
+ = array(
'civicrm_event' => array(
'helper_class' => 'CRM_Event_DAO_Event',
'delete_func' => 'delete',
- 'pre_delete_func' => 'CRM_Event_Form_ManageEvent_Repeat::checkRegistrationForEvents'
+ 'pre_delete_func' => 'CRM_Event_Form_ManageEvent_Repeat::checkRegistrationForEvents',
),
'civicrm_activity' => array(
'helper_class' => 'CRM_Activity_DAO_Activity',
'delete_func' => 'delete',
- 'pre_delete_func' => ''
- )
+ 'pre_delete_func' => '',
+ ),
);
- static $_dateColumns =
- array(
+ static $_dateColumns
+ = array(
'civicrm_event' => array(
'dateColumns' => array('start_date'),
'excludeDateRangeColumns' => array('start_date', 'end_date'),
- 'intervalDateColumns' => array('end_date')
+ 'intervalDateColumns' => array('end_date'),
),
'civicrm_activity' => array(
'dateColumns' => array('activity_date_time'),
- )
+ ),
);
- static $_tableDAOMapper =
- array(
+ static $_tableDAOMapper
+ = array(
'civicrm_event' => 'CRM_Event_DAO_Event',
'civicrm_price_set_entity' => 'CRM_Price_DAO_PriceSetEntity',
'civicrm_uf_join' => 'CRM_Core_DAO_UFJoin',
'civicrm_activity_contact' => 'CRM_Activity_DAO_ActivityContact',
);
- static $_updateSkipFields =
- array(
+ static $_updateSkipFields
+ = array(
'civicrm_event' => array('start_date', 'end_date'),
'civicrm_tell_friend' => array('entity_id'),
'civicrm_pcp_block' => array('entity_id'),
'civicrm_activity' => array('activity_date_time'),
);
- static $_linkedEntitiesInfo =
- array(
+ static $_linkedEntitiesInfo
+ = array(
'civicrm_tell_friend' => array(
'entity_id_col' => 'entity_id',
- 'entity_table_col' => 'entity_table'
+ 'entity_table_col' => 'entity_table',
),
'civicrm_price_set_entity' => array(
'entity_id_col' => 'entity_id',
),
'civicrm_pcp_block' => array(
'entity_id_col' => 'entity_id',
- 'entity_table_col' => 'entity_table'
+ 'entity_table_col' => 'entity_table',
),
);
+ /**
+ * Getter for status.
+ *
+ * @return string
+ */
public static function getStatus() {
return self::$status;
}
+ /**
+ * Setter for status.
+ *
+ * @param string $status
+ */
public static function setStatus($status) {
self::$status = $status;
}
/**
- * Save records in civicrm_recujrring_entity table
+ * Save records in civicrm_recurring_entity table.
*
* @param array $params
- * Reference array contains the values submitted by the form .
- *
- * @static
+ * Reference array contains the values submitted by the form.
*
* @return object
*/
public static function add(&$params) {
- if (CRM_Utils_Array::value('id', $params)) {
+ if (!empty($params['id'])) {
CRM_Utils_Hook::pre('edit', 'RecurringEntity', $params['id'], $params);
}
else {
$daoRecurringEntity->find(TRUE);
$result = $daoRecurringEntity->save();
- if (CRM_Utils_Array::value('id', $params)) {
+ if (!empty($params['id'])) {
CRM_Utils_Hook::post('edit', 'RecurringEntity', $daoRecurringEntity->id, $daoRecurringEntity);
}
else {
* @param string $entityTable
* Name of the entity table .
*
- * @static
*
* @return object
*/
public static function quickAdd($parentId, $entityId, $entityTable) {
- $params =
- array(
+ $params
+ = array(
'parent_id' => $parentId,
'entity_id' => $entityId,
- 'entity_table' => $entityTable
+ 'entity_table' => $entityTable,
);
return self::add($params);
}
/**
- * This function updates the mode column in the civicrm_recurring_entity table
+ * This function updates the mode column in the civicrm_recurring_entity table.
*
* @param int $mode
* Mode of the entity to cascade changes across parent/child relations eg 1 - only this entity, 2 - this and the following entities, 3 - All the entity .
}
/**
- * This function generates all new entities based on object vars
+ * This function generates all new entities based on object vars.
*
* @return array
*/
}
/**
- * Generate new DAOs and along with entries in civicrm_recurring_entity table
+ * Generate new DAOs and along with entries in civicrm_recurring_entity table.
*
* @return array
*/
$recursionDates[$count][$col] = CRM_Utils_Date::processDate($newDate->format('Y-m-d H:i:s'));
}
if ($exRangeStart) {
- $exRangeStartDate = CRM_Utils_Date::processDate($recursionDates[$count][$exRangeStart], NULL, FALSE, 'Ymd');
- $exRangeEndDate = CRM_Utils_Date::processDate($recursionDates[$count][$exRangeEnd], NULL, FALSE, 'Ymd');
+ $exRangeStartDate = CRM_Utils_Date::processDate(CRM_Utils_Array::value($exRangeStart, $recursionDates[$count]), NULL, FALSE, 'Ymd');
+ $exRangeEndDate = CRM_Utils_Date::processDate(CRM_Utils_Array::value($exRangeEnd, $recursionDates[$count]), NULL, FALSE, 'Ymd');
}
foreach ($this->excludeDates as $exDate) {
}
/**
- * This function gets all the children for a particular parent entity
+ * This function gets all the children for a particular parent entity.
*
* @param int $parentId
* Parent entity id .
* @param int $initiatorId
* The instance where this function is invoked from .
*
- * @static
*
* @return array
* an array of child ids
$query .= " AND entity_id != " . ($initiatorId ? "%3" : "%1");
}
- if ($mode == '1') { // MODE = SINGLE
+ // MODE = SINGLE
+ if ($mode == '1') {
$query .= " AND entity_id = %3";
}
- elseif ($mode == '2') { // MODE = FUTURE
+ // MODE = FUTURE
+ elseif ($mode == '2') {
$recurringEntityID = CRM_Core_DAO::singleValueQuery("SELECT id FROM civicrm_recurring_entity WHERE entity_id = %3 AND entity_table = %2", $queryParams);
if ($recurringEntityID) {
$query .= $includeParent ? " AND id >= %4" : " AND id > %4";
* @param int $mode
* 1. retrieve only one entity. 2. retrieve all future entities in the repeating set. 3. all entities in the repeating set. .
*
- * @static
*
* @return array
* array of connected ids
}
/**
- * This function gets the parent for the entity id passed to it
+ * This function gets the parent for the entity id passed to it.
*
* @param int $entityId
* Entity ID .
* @param bool $includeParent
* Include parent in result set .
*
- * @static
*
* @return int
* unsigned $parentId Parent ID
if (!$includeParent) {
$query .= " AND parent_id != %1";
}
- $parentId =
- CRM_Core_DAO::singleValueQuery($query,
+ $parentId
+ = CRM_Core_DAO::singleValueQuery($query,
array(
1 => array($entityId, 'Integer'),
2 => array($entityTable, 'String'),
}
/**
- * This function copies the information from parent entity and creates other entities with same information
+ * This function copies the information from parent entity and creates other entities with same information.
*
* @param string $entityTable
* Entity table name .
* @param bool $createRecurringEntity
* If to create a record in recurring_entity table .
*
- * @static
*
* @return object
*/
* @param object $event
* An object of /Civi/Core/DAO/Event/PostUpdate containing dao object that was just updated .
*
- * @static
*
* @return void
*/
* @param object $event
* An object of /Civi/Core/DAO/Event/PostUpdate containing dao object that was just inserted .
*
- * @static
*
* @return void
*/
// linked entity doesn't exist. lets create them
$newCriteria = array(
$idCol => $val['id'],
- $tableCol => $val['table']
+ $tableCol => $val['table'],
);
$linkedObj = CRM_Core_BAO_RecurringEntity::copyCreateEntity($obj->__table,
array('id' => $obj->id),
* @param object $event
* An object of /Civi/Core/DAO/Event/PostUpdate containing dao object that was just deleted .
*
- * @static
*
* @return void
*/
* This function deletes main entity and related linked entities from recurring-entity table
*
* @param int $entityId
- * Entity id .
+ * Entity id
* @param string $entityTable
- * Name of the entity table .
+ * Name of the entity table
*
- * @static
*
- * @return boolean|object Returns either boolean value or CRM_Core_DAO_RecurringEntity object
+ * @return bool|CRM_Core_DAO_RecurringEntity
*/
static public function delEntity($entityId, $entityTable, $isDelLinkedEntities = FALSE) {
if (empty($entityId) || empty($entityTable)) {
}
/**
- * This function maps values posted from form to civicrm_action_schedule columns
+ * This function maps values posted from form to civicrm_action_schedule columns.
*
* @param array $formParams
* And array of form values posted .
*/
public function mapFormValuesToDB($formParams = array()) {
$dbParams = array();
- if (CRM_Utils_Array::value('used_for', $formParams)) {
+ if (!empty($formParams['used_for'])) {
$dbParams['used_for'] = $formParams['used_for'];
}
- if (CRM_Utils_Array::value('entity_id', $formParams)) {
+ if (!empty($formParams['entity_id'])) {
$dbParams['entity_value'] = $formParams['entity_id'];
}
- if (CRM_Utils_Array::value('repetition_start_date', $formParams)) {
- if (CRM_Utils_Array::value('repetition_start_date_display', $formParams)) {
+ if (!empty($formParams['repetition_start_date'])) {
+ if (!empty($formParams['repetition_start_date_display'])) {
$repetitionStartDate = $formParams['repetition_start_date_display'];
}
else {
$repetitionStartDate = $formParams['repetition_start_date'];
}
- if (CRM_Utils_Array::value('repetition_start_date_time', $formParams)) {
+ if (!empty($formParams['repetition_start_date_time'])) {
$repetitionStartDate = $repetitionStartDate . " " . $formParams['repetition_start_date_time'];
}
$repetition_start_date = new DateTime($repetitionStartDate);
$dbParams['start_action_date'] = CRM_Utils_Date::processDate($repetition_start_date->format('Y-m-d H:i:s'));
}
- if (CRM_Utils_Array::value('repetition_frequency_unit', $formParams)) {
+ if (!empty($formParams['repetition_frequency_unit'])) {
$dbParams['repetition_frequency_unit'] = $formParams['repetition_frequency_unit'];
}
- if (CRM_Utils_Array::value('repetition_frequency_interval', $formParams)) {
+ if (!empty($formParams['repetition_frequency_interval'])) {
$dbParams['repetition_frequency_interval'] = $formParams['repetition_frequency_interval'];
}
//For Repeats on:(weekly case)
if ($formParams['repetition_frequency_unit'] == 'week') {
- if (CRM_Utils_Array::value('start_action_condition', $formParams)) {
+ if (!empty($formParams['start_action_condition'])) {
$repeats_on = CRM_Utils_Array::value('start_action_condition', $formParams);
$dbParams['start_action_condition'] = implode(",", array_keys($repeats_on));
}
//For Repeats By:(monthly case)
if ($formParams['repetition_frequency_unit'] == 'month') {
if ($formParams['repeats_by'] == 1) {
- if (CRM_Utils_Array::value('limit_to', $formParams)) {
+ if (!empty($formParams['limit_to'])) {
$dbParams['limit_to'] = $formParams['limit_to'];
}
}
//For "Ends" - After:
if ($formParams['ends'] == 1) {
- if (CRM_Utils_Array::value('start_action_offset', $formParams)) {
+ if (!empty($formParams['start_action_offset'])) {
$dbParams['start_action_offset'] = $formParams['start_action_offset'];
}
}
//For "Ends" - On:
if ($formParams['ends'] == 2) {
- if (CRM_Utils_Array::value('repeat_absolute_date', $formParams)) {
+ if (!empty($formParams['repeat_absolute_date'])) {
$dbParams['absolute_date'] = CRM_Utils_Date::processDate($formParams['repeat_absolute_date']);
}
}
* @param int $scheduleReminderId
* Primary key of civicrm_action_schedule table .
*
- * @static
*
* @return object
*/
}
$dao = CRM_Core_DAO::executeQuery($query,
array(
- 1 => array($scheduleReminderId, 'Integer')
+ 1 => array($scheduleReminderId, 'Integer'),
)
);
$dao->fetch();
}
/**
- * wrapper of getScheduleReminderDetailsById function
+ * wrapper of getScheduleReminderDetailsById function.
*
* @param int $scheduleReminderId
* Primary key of civicrm_action_schedule table .
$r->count($scheduleReminderDetails['start_action_offset']);
}
- if (CRM_Utils_Array::value('absolute_date', $scheduleReminderDetails)) {
+ if (!empty($scheduleReminderDetails['absolute_date'])) {
$absoluteDate = CRM_Utils_Date::setDateDefaults($scheduleReminderDetails['absolute_date']);
$endDate = new DateTime($absoluteDate[0] . ' ' . $absoluteDate[1]);
$endDate->modify('+1 day');
/**
- * This function gets time difference between the two datetime object
+ * This function gets time difference between the two datetime object.
*
* @param DateTime $startDate
* Start Date .
* @param DateTime $endDate
* End Date .
*
- * @static
*
* @return object
* DateTime object which contain time difference
}
/**
- * This function gets all columns from civicrm_action_schedule on the basis of event id
+ * This function gets all columns from civicrm_action_schedule on the basis of event id.
*
* @param int $entityId
* Entity ID .
* @param string $used_for
* Specifies for which entity type it's used for .
*
- * @static
*
* @return object
*/
}
$params = array(
1 => array($entityId, 'Integer'),
- 2 => array($used_for, 'String')
+ 2 => array($used_for, 'String'),
);
$dao = CRM_Core_DAO::executeQuery($query, $params);
$dao->fetch();
}
/**
- * Update mode column in civicrm_recurring_entity table for event related tabs
+ * Update mode column in civicrm_recurring_entity table for event related tabs.
*
* @param int $entityId
* Event id .
}
else {
CRM_Core_Session::setStatus('Could not update mode for linked entities');
- return;
+ return NULL;
}
$entityTable = $linkedEntityTable;
$params = array(
'entity_id' => $entityId,
- 'entity_table' => $mainEntityTable
+ 'entity_table' => $mainEntityTable,
);
$defaults = array();
CRM_Core_DAO::commonRetrieve($dao, $params, $defaults);
- if (CRM_Utils_Array::value('id', $defaults)) {
+ if (!empty($defaults['id'])) {
$result['entityId'] = $defaults['id'];
$result['entityTable'] = $entityTable;
}
}
return $result;
}
+
}