INFRA-132 - Remove extra newlines from the bottom of docblocks
[civicrm-core.git] / CRM / Member / BAO / MembershipType.php
index 4d5f1033683258e06cf8b76fae37ebbbb89849f7..3c96443ea137a8bff0797893ecaacfb5c92b645e 100644 (file)
@@ -44,21 +44,22 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
   /**
    * Class constructor
    */
-  function __construct() {
+  public function __construct() {
     parent::__construct();
   }
 
   /**
    * Fetch object based on array of properties
    *
-   * @param array $params   (reference ) an assoc array of name/value pairs
-   * @param array $defaults (reference ) an assoc array to hold the flattened values
+   * @param array $params
+   *   (reference ) an assoc array of name/value pairs.
+   * @param array $defaults
+   *   (reference ) an assoc array to hold the flattened values.
    *
    * @return CRM_Member_BAO_MembershipType object
-   * @access public
    * @static
    */
-  static function retrieve(&$params, &$defaults) {
+  public static function retrieve(&$params, &$defaults) {
     $membershipType = new CRM_Member_DAO_MembershipType();
     $membershipType->copyValues($params);
     if ($membershipType->find(TRUE)) {
@@ -71,28 +72,32 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
   /**
    * Update the is_active flag in the db
    *
-   * @param int      $id        id of the database record
-   * @param boolean  $is_active value we want to set the is_active field
+   * @param int $id
+   *   Id of the database record.
+   * @param bool $is_active
+   *   Value we want to set the is_active field.
    *
-   * @return Object             DAO object on sucess, null otherwise
+   * @return Object
+   *   DAO object on sucess, null otherwise
    * @static
    */
-  static function setIsActive($id, $is_active) {
+  public static function setIsActive($id, $is_active) {
     return CRM_Core_DAO::setFieldValue('CRM_Member_DAO_MembershipType', $id, 'is_active', $is_active);
   }
 
   /**
    * Add the membership types
    *
-   * @param array $params reference array contains the values submitted by the form
-   * @param array $ids array contains the id (deprecated)
+   * @param array $params
+   *   Reference array contains the values submitted by the form.
+   * @param array $ids
+   *   Array contains the id (deprecated).
    *
-   * @access public
    * @static
    *
    * @return object
    */
-  static function add(&$params, $ids = array()) {
+  public static function add(&$params, $ids = array()) {
     $id = CRM_Utils_Array::value('id', $params, CRM_Utils_Array::value('membershipType', $ids));
     if (!$id) {
       if (!isset($params['is_active'])) {
@@ -139,7 +144,7 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    * @return bool|mixed
    * @static
    */
-  static function del($membershipTypeId) {
+  public static function del($membershipTypeId) {
     //check dependencies
     $check      = FALSE;
     $status     = array();
@@ -190,10 +195,11 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
   /**
    * Convert membership Type's 'start day' & 'rollover day' to human readable formats.
    *
-   * @param array $membershipType an array of membershipType-details.
+   * @param array $membershipType
+   *   An array of membershipType-details.
    * @static
    */
-  static function convertDayFormat(&$membershipType) {
+  public static function convertDayFormat(&$membershipType) {
     $periodDays = array(
       'fixed_period_start_day',
       'fixed_period_rollover_day',
@@ -236,7 +242,7 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    * @return array
    * @static
    */
-  static function getMembershipTypes($public = TRUE) {
+  public static function getMembershipTypes($public = TRUE) {
     $membershipTypes = array();
     $membershipType = new CRM_Member_DAO_MembershipType();
     $membershipType->is_active = 1;
@@ -260,7 +266,7 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    * @return array|null
    * @static
    */
-  static function getMembershipTypeDetails($membershipTypeId) {
+  public static function getMembershipTypeDetails($membershipTypeId) {
     $membershipTypeDetails = array();
 
     $membershipType = new CRM_Member_DAO_MembershipType();
@@ -279,13 +285,18 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
   /**
    * Calculate start date and end date for new membership
    *
-   * @param int $membershipTypeId membership type id
-   * @param date $joinDate member since ( in mysql date format )
-   * @param date $startDate start date ( in mysql date format )
+   * @param int $membershipTypeId
+   *   Membership type id.
+   * @param date $joinDate
+   *   Member since ( in mysql date format ).
+   * @param date $startDate
+   *   Start date ( in mysql date format ).
    * @param null $endDate
-   * @param int $numRenewTerms how many membership terms are being added to end date (default is 1)
+   * @param int $numRenewTerms
+   *   How many membership terms are being added to end date (default is 1).
    *
-   * @return array associated array with  start date, end date and join date for the membership
+   * @return array
+   *   associated array with  start date, end date and join date for the membership
    * @static
    */
   public static function getDatesForMembershipType($membershipTypeId, $joinDate = NULL, $startDate = NULL, $endDate = NULL, $numRenewTerms = 1) {
@@ -384,8 +395,8 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
         // Check if we are on or after rollover day of the month - CRM-10585
         // If so, set fixed_period_rollover TRUE so we increment end_date month below.
         $dateParts = explode('-', $actualStartDate);
-        if ($dateParts[2] >= $membershipTypeDetails['fixed_period_rollover_day']){
-          $fixed_period_rollover = True;
+        if ($dateParts[2] >= $membershipTypeDetails['fixed_period_rollover_day']) {
+          $fixed_period_rollover = TRUE;
         }
 
         // Start date is always first day of actualStartDate month
@@ -458,12 +469,15 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    *
    * @param int $membershipId
    * @param $changeToday
-   * @param int $membershipTypeID - if provided, overrides the membership type of the $membershipID membership
-   * @param int  $numRenewTerms    how many membership terms are being added to end date (default is 1)
+   * @param int $membershipTypeID
+   *   If provided, overrides the membership type of the $membershipID membership.
+   * @param int $numRenewTerms
+   *   How many membership terms are being added to end date (default is 1).
    *
    * CRM-7297 Membership Upsell - Added $membershipTypeID param to facilitate calculations of dates when membership type changes
    *
-   * @return Array array fo the start date, end date and join date of the membership
+   * @return Array
+   *   array fo the start date, end date and join date of the membership
    * @static
    */
   public static function getRenewalDatesForMembershipType($membershipId, $changeToday = NULL, $membershipTypeID = NULL, $numRenewTerms = 1) {
@@ -499,7 +513,7 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
       $date  = explode('-', $date);
       $logStartDate = date('Y-m-d', mktime(0, 0, 0,
           (double) $date[1],
-          (double)($date[2] + 1),
+          (double) ($date[2] + 1),
           (double) $date[0]
         ));
 
@@ -511,12 +525,13 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
       switch ($membershipTypeDetails['duration_unit']) {
         case 'year':
           //need to check if the upsell is from rolling to fixed and adjust accordingly
-          if ($membershipTypeDetails['period_type'] == 'fixed' && $oldPeriodType == 'rolling' ) {
+          if ($membershipTypeDetails['period_type'] == 'fixed' && $oldPeriodType == 'rolling') {
             $month = substr($membershipTypeDetails['fixed_period_start_day'], 0, strlen($membershipTypeDetails['fixed_period_start_day']) - 2);
             $day = substr($membershipTypeDetails['fixed_period_start_day'], -2);
             $year += 1;
-          } else {
-          $year = $year + ($numRenewTerms * $membershipTypeDetails['duration_interval']);
+          }
+          else {
+            $year = $year + ($numRenewTerms * $membershipTypeDetails['duration_interval']);
           }
           break;
 
@@ -566,12 +581,14 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    * Retrieve all Membership Types associated
    * with an Organization
    *
-   * @param int $orgID  Id of Organization
+   * @param int $orgID
+   *   Id of Organization.
    *
-   * @return Array array of the details of membership types
+   * @return Array
+   *   array of the details of membership types
    * @static
    */
-  static function getMembershipTypesByOrg($orgID) {
+  public static function getMembershipTypesByOrg($orgID) {
     $membershipTypes = array();
     $dao = new CRM_Member_DAO_MembershipType();
     $dao->member_of_contact_id = $orgID;
@@ -588,10 +605,11 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    *
    * @param array membership types
    *
-   * @return Array array of the details of membership types with Member of Contact id
+   * @return Array
+   *   array of the details of membership types with Member of Contact id
    * @static
    */
-  static function getMemberOfContactByMemTypes($membershipTypes) {
+  public static function getMemberOfContactByMemTypes($membershipTypes) {
     $memTypeOrgs = array();
     if (empty($membershipTypes)) {
       return $memTypeOrgs;
@@ -612,7 +630,7 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    *
    * @return array
    */
-  static function getMembershipTypeOrganization($membershipTypeId = NULL) {
+  public static function getMembershipTypeOrganization($membershipTypeId = NULL) {
     $allmembershipTypes = array();
 
     $membershipType = new CRM_Member_DAO_MembershipType();
@@ -632,19 +650,19 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
    * Funtion to retrieve organization and associated membership
    * types
    *
-   * @return array arrays of organization and membership types
+   * @return array
+   *   arrays of organization and membership types
    *
    * @static
-   * @access public
    */
-  static function getMembershipTypeInfo() {
+  public static function getMembershipTypeInfo() {
     if (!self::$_membershipTypeInfo) {
       $orgs = $types = array();
 
       $query = 'SELECT memType.id, memType.name, memType.member_of_contact_id, c.sort_name
         FROM civicrm_membership_type memType INNER JOIN civicrm_contact c ON c.id = memType.member_of_contact_id
         WHERE memType.is_active = 1 ';
-      $dao = CRM_Core_DAO::executeQuery( $query );
+      $dao = CRM_Core_DAO::executeQuery($query);
       while ($dao->fetch()) {
         $orgs[$dao->member_of_contact_id] = $dao->sort_name;
         $types[$dao->member_of_contact_id][$dao->id] = $dao->name;
@@ -739,12 +757,12 @@ class CRM_Member_BAO_MembershipType extends CRM_Member_DAO_MembershipType {
   /** This function updates all price field value for quick config
    * price set which has membership type
    *
-   *  @param  integer      membership type id
+   * @param  integer      membership type id
    *
-   *  @param  integer      financial type id
+   * @param  integer      financial type id
    */
-  static function updateAllPriceFieldValue($membershipTypeId, $params) {
-    if (!empty($params['minimum_fee'])){
+  public static function updateAllPriceFieldValue($membershipTypeId, $params) {
+    if (!empty($params['minimum_fee'])) {
       $amount = $params['minimum_fee'];
     }
     else {
@@ -780,4 +798,3 @@ AND cps.is_quick_config = 1 AND cps.name != 'default_membership_type_amount'";
     CRM_Core_DAO::executeQuery($query, $queryParams);
   }
 }
-