chore: prepare release 3.12.0

includes/shortcodes.php

@@ -213,7 +213,7 @@ function give_form_shortcode( $atts ) {
  *
  * Show the Give donation form goals.
  *
- * @unreleased add start_date and end_date attributes
+ * @since 3.12.0 add start_date and end_date attributes
  * @since 3.7.0 Sanitize attributes
  * @since 3.4.0 Add additional validations to check if the form is valid and has the 'published' status.
  * @since  1.0

readme.txt

@@ -263,7 +263,8 @@ The 2% fee on Stripe donations only applies to donations taken via our free Stri
 
 == Changelog ==
 = 3.12.0: May 15th, 2024 =
-* New: Added ability to create donation amount level descriptions for the donation amount block in the visual form builder
+* New: Updated the donation amount block with options for donation amount level description in the visual form builder
+* New: Updated form goal settings with options for start and end dates in the visual form builder
 
 = 3.11.0: May 7th, 2024 =
 * New: Added pre-requisite form builder compatibility for upcoming ConvertKit add-on release

src/DonationForms/DonationQuery.php

@@ -9,7 +9,7 @@
 /**
  * An opinionated Query Builder for GiveWP donations and meta fields.
  *
- * @unreleased
+ * @since 3.12.0
  *
  * Example usage:
  * (new DonationQuery)
@@ -20,7 +20,7 @@
 class DonationQuery extends QueryBuilder
 {
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function __construct()
     {
@@ -29,7 +29,7 @@ public function __construct()
 
     /**
      * An opinionated join method for the donation meta table.
-     * @unreleased
+     * @since 3.12.0
      */
     public function joinMeta($key, $alias)
     {
@@ -44,7 +44,7 @@ public function joinMeta($key, $alias)
 
     /**
      * An opinionated where method for the donation form ID meta field.
-     * @unreleased
+     * @since 3.12.0
      */
     public function form($formId)
     {
@@ -56,7 +56,7 @@ public function form($formId)
 
     /**
      * An opinionated where method for the multiple donation form IDs meta field.
-     * @unreleased
+     * @since 3.12.0
      */
     public function forms(array $formIds)
     {
@@ -67,7 +67,7 @@ public function forms(array $formIds)
 
     /**
      * An opinionated whereBetween method for the completed date meta field.
-     * @unreleased
+     * @since 3.12.0
      */
     public function between($startDate, $endDate)
     {
@@ -85,7 +85,7 @@ public function between($startDate, $endDate)
 
     /**
      * Returns a calculated sum of the intended amounts (without recovered fees) for the donations.
-     * @unreleased
+     * @since 3.12.0
      * @return int|float
      */
     public function sumIntendedAmount()

src/DonationForms/Properties/FormSettings.php

@@ -13,7 +13,7 @@
 use Give\Framework\Support\Contracts\Jsonable;
 
 /**
- * @unreleased Add goalProgressType
+ * @since 3.12.0 Add goalProgressType
  * @since      3.2.0 Remove addSlashesRecursive method
  * @since      3.0.0
  */

src/DonationForms/Repositories/DonationFormRepository.php

@@ -410,7 +410,7 @@ public function getTotalNumberOfSubscriptions(int $formId): int
     }
 
     /**
-     * @unreleased Update query to use intended amounts (without recovered fees).
+     * @since 3.12.0 Update query to use intended amounts (without recovered fees).
      * @since 3.0.0
      */
     public function getTotalRevenue(int $formId): int

src/DonationForms/SubscriptionQuery.php

@@ -5,20 +5,20 @@
 use Give\Framework\QueryBuilder\QueryBuilder;
 
 /**
- * @unreleased
+ * @since 3.12.0
  */
 class SubscriptionQuery extends QueryBuilder
 {
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function __construct()
     {
         $this->from('give_subscriptions');
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function form($formId)
     {
@@ -28,7 +28,7 @@ public function form($formId)
 
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function forms(array $formIds)
     {
@@ -37,7 +37,7 @@ public function forms(array $formIds)
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function between($startDate, $endDate)
     {
@@ -50,15 +50,15 @@ public function between($startDate, $endDate)
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function sumInitialAmount()
     {
         return $this->sum('initial_amount');
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function countDonors()
     {

src/DonationForms/ValueObjects/GoalProgressType.php

@@ -5,7 +5,7 @@
 use Give\Framework\Support\ValueObjects\Enum;
 
 /**
- * @unreleased
+ * @since 3.12.0
  *
  * @method static GoalProgressType ALL_TIME()
  * @method static GoalProgressType CUSTOM()

src/FormBuilder/ViewModels/FormBuilderViewModel.php

@@ -22,7 +22,7 @@
 class FormBuilderViewModel
 {
     /**
-     * @unreleased  Add goalProgressOptions key to the returned array
+     * @since 3.12.0  Add goalProgressOptions key to the returned array
      * @since 3.9.0 Add support to intlTelInputSettings key in the returned array
      * @since      3.7.0 Add support to isExcerptEnabled key in the returned array
      * @since 3.2.0 Add nameTitlePrefixes key to the returned array
@@ -114,7 +114,7 @@ public function getGoalTypeOption(
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function getGoalProgressOption(
         string $value,
@@ -179,7 +179,7 @@ public function getGoalTypeOptions(): array
     }
 
     /**
-     * @unreleased
+     * @since 3.12.0
      */
     public function getGoalProgressOptions(): array
     {

src/FormBuilder/resources/js/form-builder/src/common/getWindowData.ts

@@ -19,7 +19,7 @@ type GoalTypeOption = {
 };
 
 /**
- * @unreleased
+ * @since 3.12.0
  */
 type GoalProgressOption = {
     value: string;
@@ -29,7 +29,7 @@ type GoalProgressOption = {
 };
 
 /**
- * @unreleased Added goalProgressOptions
+ * @since 3.12.0 Added goalProgressOptions
  * @since 3.9.0 Added intlTelInputSettings
  * @since 3.7.0 Added isExcerptEnabled
  * @since 3.0.0

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

@@ -17,7 +17,7 @@ interface DatePickerProps {
 }
 
 /**
- * @unreleased
+ * @since 3.12.0
  */
 export default ({
     label,

src/MultiFormGoals/ProgressBar/Model.php

@@ -133,7 +133,7 @@ public function getDonationRevenueResults()
     /**
      * Get raw earnings value for Progress Bar
      *
-     * @unreleased use DonationQuery
+     * @since 3.12.0 use DonationQuery
      * @since 2.9.0
      */
     public function getTotal(): string

templates/shortcode-goal.php

@@ -39,7 +39,7 @@
 $show_bar            = isset( $args['show_bar'] ) ? filter_var( $args['show_bar'], FILTER_VALIDATE_BOOLEAN ) : true;
 
 /**
- * @unreleased use DonationQuery to get donation amounts
+ * @since 3.12.0 use DonationQuery to get donation amounts
  */
 $form_income = 0;
 $donationQuery = (new DonationQuery())->form($form->ID);