BTHAB-293: Allow extension to update membership minimum

CRM/MembershipExtras/API/PaymentSchedule/Base.php

@@ -41,7 +41,8 @@ protected function getInstalments(array $membershipTypes, array $nonMembershipPr
     $endDate = !empty($this->params['end_date']) ? new DateTime($this->params['end_date']) : NULL;
     $membershipInstalmentsSchedule = new CRM_MembershipExtras_Service_MembershipInstalmentsSchedule(
       $membershipTypes,
-      $this->params['schedule']
+      $this->params['schedule'],
+      $this->params['contact_id'] ?? NULL
     );
 
     if (!empty($nonMembershipPriceFieldValues)) {

CRM/MembershipExtras/API/PaymentSchedule/PriceValues.php

@@ -72,8 +72,8 @@ private function processPriceFieldValues() {
       $this->membershipTypes[] = $membershipType;
     }
 
-    if (empty($membershipTypes)) {
-      new API_Exception(ts('At least one price field items must be of type membership'));
+    if (empty($this->membershipTypes)) {
+      throw  new API_Exception(ts('At least one price field items must be of type membership'));
     }
   }
 

CRM/MembershipExtras/Hook/CustomDispatch/CalculateMembershipMinimumFee.php

@@ -0,0 +1,45 @@
+<?php
+
+use Civi\Core\Event\GenericHookEvent;
+
+/**
+ * Class CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee
+ */
+class CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee {
+
+  const NAME = 'me.membership.calculate_minimum_fee';
+
+  /**
+   * Membership Types.
+   *
+   * @var array
+   */
+  private array $membershipTypes;
+
+  /**
+   * Contact ID.
+   *
+   * @var int
+   */
+  private $contactID;
+
+  /**
+   * CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee constructor.
+   *
+   * @param array $membershipTypes
+   * @param int $contactID
+   */
+  public function __construct(&$membershipTypes, $contactID) {
+    $this->membershipTypes =& $membershipTypes;
+    $this->contactID = $contactID;
+  }
+
+  /**
+   * Dispatches event.
+   */
+  public function dispatch() {
+    $event = GenericHookEvent::create(['contactID' => $this->contactID, 'membershipTypes' => &$this->membershipTypes]);
+    Civi::dispatcher()->dispatch(self::NAME, $event);
+  }
+
+}

CRM/MembershipExtras/Hook/Pre/MembershipPaymentPlanProcessor/AbstractProcessor.php

@@ -5,6 +5,7 @@
 use CRM_MembershipExtras_Service_MembershipInstalmentAmountCalculator as InstalmentAmountCalculator;
 use CRM_MembershipExtras_Service_MembershipTypeDurationCalculator as MembershipTypeDurationCalculator;
 use CRM_MembershipExtras_Service_MembershipTypeDatesCalculator as MembershipTypeDatesCalculator;
+use CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee as CalculateMembershipMinimumFeeHook;
 use CRM_MembershipExtras_Service_MembershipPeriodType_RollingPeriodTypeCalculator as RollingPeriodTypeCalculator;
 
 class CRM_MembershipExtras_Hook_Pre_MembershipPaymentPlanProcessor_AbstractProcessor {
@@ -86,6 +87,7 @@ protected function assignInstalmentDetails() {
   }
 
   protected function getInstalmentAmountCalculator(array $membershipTypes, $periodType = 'rolling') {
+    (new CalculateMembershipMinimumFeeHook($membershipTypes, $this->params['contact_id']))->dispatch();
     if ($periodType == 'fixed') {
       $calculator = new FixedPeriodTypeCalculator($membershipTypes);
       $calculator->setStartDate(new DateTime($this->getMembership()['start_date']));

CRM/MembershipExtras/Job/OfflineAutoRenewal/PaymentPlan.php

@@ -3,6 +3,7 @@
 use CRM_MembershipExtras_Service_MembershipEndDateCalculator as MembershipEndDateCalculator;
 use CRM_MembershipExtras_SettingsManager as SettingsManager;
 use CRM_MembershipExtras_Hook_CustomDispatch_PostOfflineAutoRenewal as PostOfflineAutoRenewalDispatcher;
+use CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee as CalculateMembershipMinimumFeeHook;
 
 /**
  * Renews a payment plan.
@@ -416,11 +417,14 @@ private function getMembershipMinimumFeeFromLineItem($lineItem, $priceFieldValue
       $membershipTypeID = $priceFieldValue['membership_type_id'];
     }
 
-    $membershipType = civicrm_api3('MembershipType', 'getsingle', [
-      'id' => $membershipTypeID,
-    ]);
+    /**
+     * @var CRM_Member_DAO_MembershipType[]
+     */
+    $membershipTypes = [CRM_Member_BAO_MembershipType::findById($membershipTypeID)];
+    $contactId = $this->currentRecurringContribution['contact_id'];
+    (new CalculateMembershipMinimumFeeHook($membershipTypes, $contactId ?? NULL))->dispatch();
 
-    return $membershipType['minimum_fee'];
+    return $membershipTypes[0]->minimum_fee;
   }
 
   /**

CRM/MembershipExtras/Page/InstalmentSchedule.php

@@ -28,6 +28,7 @@ private function assignInstalments() {
     $params['payment_method'] = CRM_Utils_Request::retrieve('payment_method', 'Int');
     $params['start_date'] = CRM_Utils_Request::retrieve('start_date', 'String');
     $params['join_date'] = CRM_Utils_Request::retrieve('join_date', 'String');
+    $params['contact_id'] = CRM_Utils_Request::retrieve('contact_id', 'Int');
 
     try {
       $result = civicrm_api3('PaymentSchedule', $action, $params);

CRM/MembershipExtras/Service/MembershipInstalmentsSchedule.php

@@ -4,6 +4,7 @@
 use CRM_MembershipExtras_Service_MembershipInstalmentAmountCalculator as InstalmentAmountCalculator;
 use CRM_MembershipExtras_Service_MembershipPeriodType_FixedPeriodTypeCalculator as FixedPeriodTypeCalculator;
 use CRM_MembershipExtras_Service_MembershipPeriodType_RollingPeriodTypeCalculator as RollingPeriodCalculator;
+use CRM_MembershipExtras_Hook_CustomDispatch_CalculateMembershipMinimumFee as CalculateMembershipMinimumFeeHook;
 use CRM_MembershipExtras_Hook_CustomDispatch_CalculateContributionReceiveDate as CalculateContributionReceiveDateDispatcher;
 use CRM_MembershipExtras_Helper_InstalmentSchedule as InstalmentScheduleHelper;
 
@@ -70,19 +71,26 @@ class CRM_MembershipExtras_Service_MembershipInstalmentsSchedule {
    */
   private $installmentReceiveDateCalculator;
 
+  /**
+   * @var int|null
+   */
+  private $contactID;
+
   /**
    * CRM_MembershipExtras_Service_MembershipTypeInstalment constructor.
    *
    * @param array $membershipTypes
    * @param string $schedule
+   * @param int|null $contactID
    *
    * @throws CRM_MembershipExtras_Exception_InvalidMembershipTypeInstalment
    */
-  public function __construct(array $membershipTypes, string $schedule) {
+  public function __construct(array $membershipTypes, string $schedule, int|null $contactID = NULL) {
     $this->membershipInstalmentTaxAmountCalculator = new CRM_MembershipExtras_Service_MembershipInstalmentTaxAmountCalculator();
     $this->installmentReceiveDateCalculator = new CRM_MembershipExtras_Service_InstalmentReceiveDateCalculator();
     $this->membershipTypes = $membershipTypes;
     $this->schedule = $schedule;
+    $this->contactID = $contactID;
     $this->validateMembershipTypeForInstalment();
   }
 
@@ -208,6 +216,7 @@ private function calculateInstalmentAmount() {
    *
    */
   private function getInstalmentAmountCalculator() {
+    (new CalculateMembershipMinimumFeeHook($this->membershipTypes, $this->contactID))->dispatch();
     if ($this->membershipTypes[0]->period_type == 'fixed') {
       $fixedPeriodTypCalculator = new FixedPeriodTypeCalculator($this->membershipTypes);
       $fixedPeriodTypCalculator->setStartDate($this->startDate);

js/paymentPlanToggler.js

@@ -14,6 +14,9 @@ function paymentPlanToggler(togglerValue, currencySymbol) {
       preventPaymentTabLinkAction();
       toggleNumOfTermsField();
       preventMultiFormSubmission();
+      window.isPaymentPlanTabActive = isPaymentPlanTabActive;
+      window.isPriceSetSelected = isPriceSetSelected;
+      window.getSelectedPriceFieldValues = getSelectedPriceFieldValues;
     });
 
     /**
@@ -108,7 +111,7 @@ function paymentPlanToggler(togglerValue, currencySymbol) {
         assignFirstContributionReceiveDate();
       });
 
-      $('#payment_plan_schedule, #payment_instrument_id, #start_date, #end_date').change(() => {
+      $('#payment_plan_schedule, #payment_instrument_id, #start_date, #end_date, #contact_id').change(() => {
         if (!isPaymentPlanTabActive()) {
           return;
         }
@@ -172,11 +175,14 @@ function paymentPlanToggler(togglerValue, currencySymbol) {
      */
     function generateInstalmentSchedule(isPriceSet, startDate) {
       let schedule = $('#payment_plan_schedule').val();
+      const searchParams = new URLSearchParams(window.location.search);
+      const cid = $('#contact_id').val() ?? searchParams.get('cid');
       let params = {
         schedule: schedule,
         start_date: startDate,
         join_date: $('#join_date').val(),
         payment_method: $('#payment_instrument_id').val(),
+        contact_id: cid,
       };
       if (isPriceSet) {
         let selectedPriceFieldValues = getSelectedPriceFieldValues();

tests/phpunit/CRM/MembershipExtras/Hook/Pre/MembershipPaymentPlanProcessor/LineItemTest.php

@@ -183,6 +183,7 @@ private function mockParams($membershipPeriodType, $membershipTypeDuration, $mem
       'contribution_id' => $contribution['id'],
       'entity_table' => 'civicrm_membership',
       'entity_id' => $this->membership['id'],
+      'contact_id' => $contact['id'],
     ];
   }