WIP

Author: lukeholder

CHANGELOG-WIP.md

@@ -1,7 +1,7 @@
 # WIP Release notes for Commerce 5.6
 
 ### Store Management
-- Added a new "Use Payment Currency Rate Snapshot" store setting. Payment currency rates are now snapshotted when an order is completed, and when this setting is enabled, subsequent partial payments use the snapshotted exchange rates instead of current rates.
+- Added a new "Use Payment Currency Rate Snapshot" store setting. Payment currency rates are now snapshotted when an order is completed, and when this setting is enabled, subsequent payments use the snapshotted exchange rates instead of current rates.
 - Snapshotted payment currency rates are now displayed in the Transactions tab on order edit pages, with a comparison to current rates.
 
 ### Extensibility

src/elements/Order.php

@@ -1115,7 +1115,7 @@ class Order extends Element implements HasStoreInterface
     public ?int $storedTotalQty = null;
 
     /**
-     * The payment currency rates at the time the order was completed. Used to lock in exchange rates for partial payments.
+     * The payment currency rates at the time the order was completed. Used to lock in exchange rates for subsequent payments.
      * Stored as an associative array keyed by currency ISO code, e.g. ['EUR' => 0.85, 'GBP' => 0.73]
      *
      * @var array|null
@@ -1842,7 +1842,7 @@ public function markAsComplete(): bool
         $this->estimatedBillingAddressId = null;
         $this->orderCompletedEmail = $this->getEmail();
 
-        // Capture all payment currency rates for partial payments
+        // Capture all payment currency rates for subsequent payments
         $paymentCurrencies = Plugin::getInstance()->getPaymentCurrencies()
             ->getAllPaymentCurrencies($this->getStore()->id);
         if ($paymentCurrencies->isNotEmpty()) {

src/models/Store.php

@@ -621,7 +621,7 @@ public function setUsesSnapshotPaymentCurrencyRate(bool|string $usesSnapshotPaym
     }
 
     /**
-     * Whether to use the snapshotted payment currency rate on order completion for subsequent partial payments.
+     * Whether to use the snapshotted payment currency rate on order completion for subsequent payments.
      *
      * @param bool $parse
      * @return bool|string

src/templates/orders/_transactions.twig

@@ -13,8 +13,8 @@
     'Show snapshotted payment currency rates',
     'Snapshotted Rate',
     'Status',
-    'These exchange rates were captured when the order was completed and are used for subsequent partial payments.',
-    'These exchange rates were captured when the order was completed and are used for subsequent partial payments. This behavior is controlled by the {link}Use Payment Currency Rate Snapshot{endlink} store setting.',
+    'These exchange rates were captured when the order was completed and are used for subsequent payments.',
+    'These exchange rates were captured when the order was completed and are used for subsequent payments. This behavior is controlled by the {link}Use Payment Currency Rate Snapshot{endlink} store setting.',
     'Type',
 ]) %}
 
@@ -35,12 +35,12 @@
         </p>
         <div id="snapshotted-payment-currency-rates" class="hidden">
             {% if currentUser.admin %}
-                <p class="light">{{ 'These exchange rates were captured when the order was completed and are used for subsequent partial payments. This behavior is controlled by the {link}Use Payment Currency Rate Snapshot{endlink} store setting.'|t('commerce', {
+                <p class="light">{{ 'These exchange rates were captured when the order was completed and are used for subsequent payments. This behavior is controlled by the {link}Use Payment Currency Rate Snapshot{endlink} store setting.'|t('commerce', {
                     link: '<a href="' ~ url('commerce/settings/stores/' ~ order.store.id) ~ '">',
                     endlink: '</a>'
                 })|raw }}</p>
             {% else %}
-                <p class="light">{{ 'These exchange rates were captured when the order was completed and are used for subsequent partial payments.'|t('commerce') }}</p>
+                <p class="light">{{ 'These exchange rates were captured when the order was completed and are used for subsequent payments.'|t('commerce') }}</p>
             {% endif %}
             {% set currentPaymentCurrencies = craft.commerce.paymentCurrencies.getAllPaymentCurrencies(order.store.id) %}
             <table class="data fullwidth">

src/templates/settings/stores/_edit.twig

@@ -236,7 +236,7 @@
 
         {{ forms.booleanMenuField({
             label: 'Use Payment Currency Rate Snapshot'|t('commerce'),
-            instructions: 'Payment currency exchange rates are captured when an order is completed. When this setting is enabled, these snapshotted rates are used for subsequent partial payments on the order, ensuring consistent pricing even if exchange rates change.'|t('commerce'),
+            instructions: 'Payment currency exchange rates are captured when an order is completed. When this setting is enabled, these snapshotted rates are used for subsequent payments on the order, ensuring consistent pricing even if exchange rates change.'|t('commerce'),
             id: 'usesSnapshotPaymentCurrencyRate',
             name: 'usesSnapshotPaymentCurrencyRate',
             value: store.getUsesSnapshotPaymentCurrencyRate(false),