chore: prepare for release 3.4.0

give.php

@@ -6,7 +6,7 @@
  * Description: The most robust, flexible, and intuitive way to accept donations on WordPress.
  * Author: GiveWP
  * Author URI: https://givewp.com/
- * Version: 3.3.1
+ * Version: 3.4.0
  * Requires at least: 6.0
  * Requires PHP: 7.2
  * Text Domain: give
@@ -403,7 +403,7 @@ private function setup_constants()
     {
         // Plugin version.
         if (!defined('GIVE_VERSION')) {
-            define('GIVE_VERSION', '3.3.1');
+            define('GIVE_VERSION', '3.4.0');
         }
 
         // Plugin Root File.
@@ -497,7 +497,7 @@ public function display_old_recurring_compatibility_notice()
      *
      * Runs on plugin activation and performs initial setup.
      *
-     * @unreleased check if installing in WP multisite
+     * @since 3.4.0 check if installing in WP multisite
      * @since 2.33.3 set network_wide parameter to true, enabling installing in WP multisite
      * @since 1.0.0
      */

includes/install.php

@@ -210,7 +210,7 @@ function give_on_create_blog($blog_id, $user_id, $domain, $path, $site_id, $meta
 /**
  * Drop Give's custom tables when a mu site is deleted.
  *
- * @unreleased updated implementation to query all give_* tables
+ * @since 3.4.0 updated implementation to query all give_* tables
  * @since  1.4.3
  *
  * @param array $tables The tables to drop.

includes/shortcodes.php

@@ -132,7 +132,7 @@ function give_donation_history( $atts, $content = false ) {
  *
  * Show the Give donation form.
  *
- * @unreleased Add additional validations to check if the form is valid and has the 'published' status.
+ * @since 3.4.0 Add additional validations to check if the form is valid and has the 'published' status.
  * @since 2.30.0 Add short-circuit filter to allow for custom output.
  * @since  1.0
  *
@@ -210,7 +210,7 @@ function give_form_shortcode( $atts ) {
  *
  * Show the Give donation form goals.
  *
- * @unreleased Add additional validations to check if the form is valid and has the 'published' status.
+ * @since 3.4.0 Add additional validations to check if the form is valid and has the 'published' status.
  * @since  1.0
  *
  * @param  array $atts Shortcode attributes.

readme.txt

@@ -5,7 +5,7 @@ Tags: donation, donate, recurring donations, fundraising, crowdfunding
 Requires at least: 6.0
 Tested up to: 6.4
 Requires PHP: 7.2
-Stable tag: 3.3.1
+Stable tag: 3.4.0
 License: GPLv3
 License URI: http://www.gnu.org/licenses/gpl-3.0.html
 
@@ -262,6 +262,24 @@ The 2% fee on Stripe donations only applies to donations taken via our free Stri
 10. Use almost any payment gateway integration with GiveWP through our add-ons or by creating your own add-on.
 
 == Changelog ==
+= 3.4.0: February 8th, 2024 =
+* Fix: Resolved several issues with the billing address block including dynamically requiring certain fields and allowing state/county field input
+* Fix: Resolved an issue with multi step form layout where the title was missing on the first step when show header was disabled
+* Fix: Resolved errors when adding/removing a sub-site in a WP multisite environment (open-source contribution by @Genevieve-K)
+* Fix: Resolved an issue with form modals and some gateways that redirect offsite to display the confirmation page after a donation
+* Fix: Resolved a fields api compatability issue with showInReceipt metaKey
+* Fix: Resolved a nonce validation issue with translated values (open-source contribution by @Genevieve-K)
+* Fix: Resolved a PHP 8 compatability issue with the system info page (open-source contribution by @JeromeBeckett)
+* Fix: Resolved several styling issues with the form modal block
+* Fix: Updated Stripe connect redirect to be limited to specific pages
+* New: Added form migration step for the GiveWP Gift Aid add-on
+* New: Added new filter `givewp_stripe_payment_element_appearance_options` to modify the Stripe Payment Element gateway appearance options
+* New: Added donation form processing lifecycle actions for more programmatic control over form processing
+* Enhancement: Made donation list table programmatically extendable (open-source contribution by @pulsovi)
+* Enhancement: Improved the flexibility of donation confirmation page detail values to allow sanitized html
+* Enhancement: Added new filter to the gateways block to control visibility
+* Enhancement: Made several improvements to the give importer for third-parties and admin
+
 = 3.3.1: January 23rd, 2024 =
 * Fix: Resolved an issue checking for the GiveWP Funds and Designations add-on information during form migrations  
 

src/DonationForms/Actions/ConvertDonationFormBlocksToFieldsApi.php

@@ -291,7 +291,7 @@ protected function createNodeFromDonorNameBlock(BlockModel $block): Node
     }
 
     /**
-     * @unreleased updated fields to add optional rules last so they can be dynamically validated.
+     * @since 3.4.0 updated fields to add optional rules last so they can be dynamically validated.
      * @since 3.0.0
      */
     protected function createNodeFromBillingAddressBlock(BlockModel $block): Node

src/DonationForms/Blocks/DonationFormBlock/Controllers/BlockRenderController.php

@@ -88,7 +88,7 @@ private function getViewUrl(DonationForm $donationForm, string $embedId): string
     }
 
     /**
-     * @unreleased
+     * @since 3.4.0
      */
     private function getFormViewUrl(DonationForm $donationForm): string
     {

src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/ModalForm.tsx

@@ -15,7 +15,7 @@ type ModalFormProps = {
 };
 
 /**
- * @unreleased
+ * @since 3.4.0
  * @since 3.2.0 include types. update BEM classnames.
  * @since 3.0.0
  */

src/DonationForms/Blocks/DonationFormBlock/resources/app/index.tsx

@@ -19,12 +19,12 @@ type DonationFormBlockAppProps = {
 };
 
 /**
- * @unreleased
+ * @since 3.4.0
  */
 const inlineRedirectRoutes = ['donation-confirmation-receipt-view'];
 
 /**
- * @unreleased
+ * @since 3.4.0
  */
 const isRedirect = (url: string) => {
     const redirectUrl = new URL(url);
@@ -34,7 +34,7 @@ const isRedirect = (url: string) => {
 }
 
 /**
- * @unreleased add logic for inline redirects.
+ * @since 3.4.0 add logic for inline redirects.
  * @since 3.2.0 replace form format reveal with new tab.
  * @since 3.0.0
  */

src/DonationForms/Controllers/DonateController.php

@@ -33,7 +33,7 @@ public function donate(DonateControllerData $formData, PaymentGateway $gateway)
         /**
          * Fires at the start of donation form processing, before any data is processed.
          *
-         * @unreleased
+         * @since 3.4.0
          *
          * @param  DonateControllerData  $formData
          * @param  string  $gatewayId
@@ -67,7 +67,7 @@ public function donate(DonateControllerData $formData, PaymentGateway $gateway)
             /**
              * Fires after a donation is created during donation form processing.
              *
-             * @unreleased
+             * @since 3.4.0
              *
              * @param  Donation  $donation
              * @param  Subscription|null  $subscription
@@ -112,7 +112,7 @@ public function donate(DonateControllerData $formData, PaymentGateway $gateway)
             /**
              * Fires after a donation is created during donation form processing.
              *
-             * @unreleased
+             * @since 3.4.0
              *
              * @param  Donation  $donation
              * @param  Subscription|null  $subscription
@@ -133,7 +133,7 @@ public function donate(DonateControllerData $formData, PaymentGateway $gateway)
             /**
              * Fires after a subscription is created during donation form processing.
              *
-             * @unreleased
+             * @since 3.4.0
              *
              * @param  Subscription  $subscription
              * @param  Donation  $donation
@@ -194,7 +194,7 @@ private function getOrCreateDonor(
             /**
              * Fires after a donor is created during donation form processing.
              *
-             * @unreleased
+             * @since 3.4.0
              *
              * @param  Donor  $donor
              * @param  int  $formId

src/DonationForms/Controllers/DonationConfirmationReceiptViewController.php

@@ -30,7 +30,7 @@ public function show(DonationConfirmationReceiptViewRouteData $data): string
         /**
          * Fires before the donation confirmation receipt view is rendered.
          *
-         * @unreleased
+         * @since 3.4.0
          *
          * @param Donation $donation
          */

src/DonationForms/Listeners/StoreCustomFields.php

@@ -56,7 +56,7 @@ function (Field $field) use ($customFields, $donation, $subscription) {
         /**
          * Fires after custom fields have been stored/processed
          *
-         * @unreleased
+         * @since 3.4.0
          *
          * @param DonationForm $form
          * @param array $customFields

src/DonationForms/Properties/FormSettings.php

@@ -183,37 +183,37 @@ class FormSettings implements Arrayable, Jsonable
     public $pdfSettings;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsImageUrl;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsImageStyle;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsLogoUrl;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsLogoPosition;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsSectionStyle;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @var string
      */
     public $designSettingsTextFieldStyle;

src/DonationForms/ValueObjects/DesignSettingsImageStyle.php

@@ -5,7 +5,7 @@
 use Give\Framework\Support\ValueObjects\Enum;
 
 /**
- * @unreleased
+ * @since 3.4.0
  *
  * @method static DonationFormErrorTypes BACKGROUND()
  * @method static DonationFormErrorTypes COVER()

src/DonationForms/ValueObjects/DesignSettingsLogoPosition.php

@@ -5,7 +5,7 @@
 use Give\Framework\Support\ValueObjects\Enum;
 
 /**
- * @unreleased
+ * @since 3.4.0
  *
  * @method static DesignSettingsLogoPosition LEFT()
  * @method static DesignSettingsLogoPosition CENTER()

src/DonationForms/ValueObjects/DesignSettingsSectionStyle.php

@@ -5,7 +5,7 @@
 use Give\Framework\Support\ValueObjects\Enum;
 
 /**
- * @unreleased
+ * @since 3.4.0
  *
  * @method static DesignSettingsSectionStyle DEFAULT()
  * @method static DesignSettingsSectionStyle BORDER()

src/DonationForms/ValueObjects/DesignSettingsTextFieldStyle.php

@@ -5,7 +5,7 @@
 use Give\Framework\Support\ValueObjects\Enum;
 
 /**
- * @unreleased
+ * @since 3.4.0
  * @method static DesignSettingsTextFieldStyle DEFAULT()
  * @method static DesignSettingsTextFieldStyle BOX()
  * @method static DesignSettingsTextFieldStyle LINE()

src/DonationForms/ViewModels/DonationFormViewModel.php

@@ -433,7 +433,7 @@ private function enqueueFormApp()
     }
 
     /**
-     * @unreleased
+     * @since 3.4.0
      */
     private function updateDesignSettingsClassNames(array &$classNames)
     {

src/DonationForms/resources/app/form/MultiStepForm/components/StepsWrapper.tsx

@@ -7,7 +7,7 @@ import {StepObject} from '@givewp/forms/app/form/MultiStepForm/types';
 import getCurrentStepObject from '@givewp/forms/app/form/MultiStepForm/utilities/getCurrentStepObject';
 
 /**
- * @unreleased updated with steps props and showStepsHeader conditional
+ * @since 3.4.0 updated with steps props and showStepsHeader conditional
  * @since 3.0.0
  */
 export default function StepsWrapper({steps, children}: {steps: StepObject[]; children: ReactNode}) {

src/DonationForms/resources/app/form/MultiStepForm/store/index.tsx

@@ -9,7 +9,7 @@ const StoreContextDispatch = createContext(null);
 StoreContextDispatch.displayName = 'DonationFormMultiStepStateDispatch';
 
 /**
- * @unreleased removed showHeader in favor of DonationFormSettings context
+ * @since 3.4.0 removed showHeader in favor of DonationFormSettings context
  * @since 3.0.0
  */
 export type MultiStepFormContextState = {

src/DonationForms/resources/app/utilities/setDesignSettings.ts

@@ -1,7 +1,7 @@
 import {FormSettings} from '@givewp/form-builder/types';
 
 /**
- * @unreleased
+ * @since 3.4.0
  */
 function updateDesignSettingsClassName(root: HTMLElement, block, element) {
     root.classList.forEach((className) => {
@@ -14,7 +14,7 @@ function updateDesignSettingsClassName(root: HTMLElement, block, element) {
 
 /**
  * @note currently not in use
- * @unreleased
+ * @since 3.4.0
  */
 export default function setDesignSettings(root: HTMLElement, settings: FormSettings) {
     if (settings['designSettingsSectionStyle']) {

src/DonationForms/resources/registrars/templates/groups/BillingAddress.tsx

@@ -43,7 +43,7 @@ async function getStates(url, country) {
 /**
  * This component is used to dynamically update the state field based on the country value
  *
- * @unreleased Set current state value to the state input field
+ * @since 3.4.0 Set current state value to the state input field
  * @since 3.0.0
  */
 function StateFieldContainer({
@@ -202,7 +202,7 @@ function StateFieldContainer({
 }
 
 /**
- * @unreleased Update city and zip components before rendering to display required asterisk
+ * @since 3.4.0 Update city and zip components before rendering to display required asterisk
  * @since 3.0.0
  */
 export default function BillingAddress({

src/DonationForms/resources/registrars/templates/layouts/DonationReceipt.tsx

@@ -17,7 +17,7 @@ const SecureBadge = () => {
 
 /**
  *
- * @unreleased updated to render value using Interweave
+ * @since 3.4.0 updated to render value using Interweave
  * @since 3.0.0
  */
 const Details = ({id, heading, details}: {id: string; heading: string; details: ReceiptDetail[]}) =>

src/DonationForms/resources/registrars/templates/layouts/HeaderTextWrapper.tsx

@@ -1,5 +1,5 @@
 /**
- * @unreleased
+ * @since 3.4.0
  */
 export default function HeaderTextWrapper({children}) {
     const {designSettingsImageStyle} = window.givewp.form.hooks.useDonationFormSettings();

src/Donations/Endpoints/ListDonations.php

@@ -13,7 +13,7 @@
 use WP_REST_Response;
 
 /**
- * @unreleased The class is extendable
+ * @since 3.4.0 The class is extendable
  */
 class ListDonations extends Endpoint
 {
@@ -33,7 +33,7 @@ class ListDonations extends Endpoint
     protected $listTable;
 
     /**
-     * @unreleased
+     * @since 3.4.0
      * @access public
      */
     public function __construct(DonationsListTable $listTable)
@@ -220,7 +220,7 @@ public function getTotalDonationsCount(): int
     }
 
     /**
-     * @unreleased Make this method protected so it can be extended
+     * @since 3.4.0 Make this method protected so it can be extended
      * @since 3.2.0 Updated query to account for possible null and empty values for _give_payment_mode meta
      * @since 2.24.0 Remove joins as it uses ModelQueryBuilder and change clauses to use attach_meta
      * @since      2.21.0

src/FormBuilder/resources/js/form-builder/src/components/settings/DesignSettings/index.tsx

@@ -8,7 +8,7 @@ type DesignSettings = {
 };
 
 /**
- * @unreleased
+ * @since 3.4.0
  */
 export default function DesignSettings({title, description, children}: DesignSettings) {
     return (