From 8adc13337a1289e1a30f52dc9ec632c9b543d0d9 Mon Sep 17 00:00:00 2001 From: Jon Waldstein Date: Tue, 15 Aug 2023 16:19:39 -0400 Subject: [PATCH] chore: replace all @since 0.*.0 tags with @since 3.0.0 --- .../ConvertConsentBlockToFieldsApi.php | 6 +-- .../ConvertDonationAmountBlockToFieldsApi.php | 6 +-- .../ConvertDonationFormBlocksToFieldsApi.php | 24 ++++++------ .../ConvertQueryDataToDonationForm.php | 2 +- ...nateControllerDonationCreatedListeners.php | 2 +- ...ControllerSubscriptionCreatedListeners.php | 2 +- src/DonationForms/Actions/GenerateAuthUrl.php | 4 +- .../GenerateDonateRouteSignatureArgs.php | 2 +- .../Actions/GenerateDonateRouteUrl.php | 4 +- ...GenerateDonationConfirmationReceiptUrl.php | 2 +- ...onationConfirmationReceiptViewRouteUrl.php | 4 +- .../GenerateDonationFormPreviewRouteUrl.php | 4 +- ...GenerateDonationFormValidationRouteUrl.php | 4 +- .../GenerateDonationFormViewRouteUrl.php | 4 +- .../SanitizeDonationFormPreviewRequest.php | 2 +- .../StoreBackwardsCompatibleFormMeta.php | 12 +++--- .../Blocks/DonationFormBlock/Block.php | 2 +- .../Controllers/BlockRenderController.php | 8 ++-- .../DataTransferObjects/BlockAttributes.php | 4 +- .../resources/app/Components/ModalForm.tsx | 2 +- .../resources/app/Components/RevealForm.tsx | 2 +- .../DonationFormBlock/resources/app/index.tsx | 2 +- .../DonationFormBlock/resources/block.ts | 2 +- .../resources/editor/Edit.tsx | 4 +- .../editor/components/BlockPreview.tsx | 2 +- .../resources/editor/components/Logo.tsx | 2 +- .../editor/components/ModalPreview.tsx | 2 +- .../editor/components/RevealPreview.tsx | 2 +- .../resources/editor/hooks/useFormOptions.ts | 4 +- .../resources/editor/hooks/usePostState.ts | 2 +- .../Controllers/DonateController.php | 8 ++-- ...ationConfirmationReceiptViewController.php | 4 +- .../DonationFormViewController.php | 4 +- .../AuthenticationData.php | 4 +- .../DonateControllerData.php | 30 +++++++-------- .../DonateFormRouteData.php | 12 +++--- .../DataTransferObjects/DonateRouteData.php | 6 +-- ...nationConfirmationReceiptViewRouteData.php | 6 +-- .../DonationFormGoalData.php | 8 ++-- .../DonationFormPreviewRouteData.php | 4 +- .../DonationFormQueryData.php | 2 +- .../DonationFormViewRouteData.php | 4 +- .../LegacyPurchaseFormData.php | 6 +-- .../DataTransferObjects/UserData.php | 4 +- .../ValidationRouteData.php | 12 +++--- .../DonationFormFieldErrorsException.php | 4 +- .../Factories/DonationFormFactory.php | 2 +- .../ClassicFormDesign/ClassicFormDesign.php | 12 +++--- .../ClassicFormDesign/js/layouts/Goal.tsx | 4 +- .../ClassicFormDesign/js/layouts/Header.tsx | 4 +- .../DeveloperFormDesign.php | 6 +-- .../MultiStepFormDesign.php | 12 +++--- .../AddRedirectUrlsToGatewayData.php | 4 +- .../Listeners/StoreCustomFields.php | 12 +++--- ...TemporarilyReplaceLegacySuccessPageUri.php | 4 +- ...eSubscriptionWithLegacyParentPaymentId.php | 2 +- src/DonationForms/Models/DonationForm.php | 20 +++++----- src/DonationForms/Properties/FormSettings.php | 8 ++-- .../Repositories/DonationFormRepository.php | 38 +++++++++---------- .../Routes/AuthenticationRoute.php | 6 +-- src/DonationForms/Routes/DonateRoute.php | 8 ++-- .../Routes/DonateRouteSignature.php | 14 +++---- src/DonationForms/Routes/ValidationRoute.php | 6 +-- src/DonationForms/Rules/ArrayRule.php | 10 ++--- .../Rules/AuthenticationRule.php | 6 +-- .../Rules/BillingAddressCityRule.php | 8 ++-- .../Rules/BillingAddressStateRule.php | 8 ++-- .../Rules/BillingAddressZipRule.php | 8 ++-- src/DonationForms/Rules/DonationTypeRule.php | 10 ++--- src/DonationForms/Rules/GatewayRule.php | 8 ++-- src/DonationForms/Rules/Max.php | 4 +- src/DonationForms/Rules/Min.php | 4 +- src/DonationForms/Rules/Size.php | 12 +++--- .../Rules/SubscriptionFrequencyRule.php | 6 +-- .../Rules/SubscriptionInstallmentsRule.php | 6 +-- .../Rules/SubscriptionPeriodRule.php | 10 ++--- src/DonationForms/ServiceProvider.php | 22 +++++------ .../Shortcodes/GiveFormShortcode.php | 2 +- .../ValueObjects/DonationFormMetaKeys.php | 2 +- .../ValueObjects/DonationFormStatus.php | 2 +- src/DonationForms/ValueObjects/GoalType.php | 2 +- .../ValueObjects/RegistrationOptions.php | 2 +- .../DonationConfirmationReceiptViewModel.php | 18 ++++----- .../ViewModels/DonationFormViewModel.php | 36 +++++++++--------- .../resources/app/DonationFormApp.tsx | 4 +- .../resources/app/errors/FormRequestError.ts | 2 +- .../resources/app/fields/SectionNode.tsx | 2 +- .../resources/app/form/Header.tsx | 4 +- .../MultiStepForm/components/HeaderStep.tsx | 2 +- .../MultiStepForm/components/NextButton.tsx | 2 +- .../components/PreviousButton.tsx | 2 +- .../MultiStepForm/components/StepForm.tsx | 2 +- .../form/MultiStepForm/components/Steps.tsx | 2 +- .../components/StepsPagination.tsx | 2 +- .../MultiStepForm/components/StepsWrapper.tsx | 4 +- .../MultiStepForm/components/SubmitButton.tsx | 2 +- .../MultiStepForm/hooks/useCurrentStep.ts | 2 +- .../MultiStepForm/hooks/useGetGatewayById.ts | 2 +- .../MultiStepForm/hooks/usePreviousValue.ts | 2 +- .../MultiStepForm/hooks/useSetNextStep.ts | 2 +- .../MultiStepForm/hooks/useSetPreviousStep.ts | 2 +- .../app/form/MultiStepForm/index.tsx | 4 +- .../app/form/MultiStepForm/store/index.tsx | 2 +- .../app/form/MultiStepForm/store/reducer.ts | 4 +- .../app/form/MultiStepForm/types/index.ts | 4 +- .../utilities/getCurrentStepObject.ts | 2 +- .../utilities/getSectionFieldNames.tsx | 2 +- .../app/hooks/useCurrencyFormatter.ts | 2 +- .../resources/app/hooks/useDonationSummary.ts | 2 +- .../app/hooks/useVisibilityCondition.ts | 6 +-- .../app/store/donation-summary/index.tsx | 4 +- .../app/store/donation-summary/reducer.ts | 10 ++--- .../app/store/form-settings/index.tsx | 2 +- .../resources/app/store/index.tsx | 2 +- .../resources/app/store/reducer.ts | 4 +- .../resources/app/templates/index.tsx | 18 ++++----- .../utilities/ConvertFieldAPIRulesToJoi.ts | 12 +++--- .../app/utilities/PrepareFormData.ts | 2 +- .../app/utilities/amountFormatter.ts | 2 +- .../buildRegisterValidationOptions.ts | 2 +- .../utilities/conditionOperatorFunctions.js | 2 +- .../app/utilities/convertValuesToFormData.ts | 2 +- .../utilities/getDefaultValuesFromSections.ts | 2 +- .../resources/app/utilities/groups.ts | 18 ++++----- .../app/utilities/handleValidationRequest.ts | 2 +- .../app/utilities/isRouteInlineRedirect.ts | 2 +- .../app/utilities/mountWindowData.ts | 4 +- .../resources/app/utilities/postData.ts | 2 +- .../resources/app/utilities/postFormData.ts | 2 +- .../DonationConfirmationReceiptApp.tsx | 8 ++-- .../resources/registrars/gateways/index.ts | 14 +++---- .../templates/elements/DonationSummary.tsx | 4 +- .../fields/Amount/CurrencySwitcher.tsx | 14 +++---- .../templates/fields/Amount/CustomAmount.tsx | 8 ++-- .../fields/Amount/DonationAmountCurrency.tsx | 2 +- .../fields/Amount/DonationAmountLevels.tsx | 6 +-- .../getAmountLevelsWithCurrencySettings.tsx | 2 +- .../templates/fields/Amount/index.tsx | 6 +-- .../registrars/templates/fields/Checkbox.tsx | 4 +- .../registrars/templates/fields/Gateways.tsx | 14 +++---- .../templates/groups/BillingAddress.tsx | 10 ++--- .../DonationAmountCurrencySwitcherMessage.tsx | 8 ++-- .../DonationAmount/DonationAmountMessage.tsx | 2 +- .../DonationAmount/FixedAmountMessage.tsx | 2 +- .../FixedAmountRecurringMessage.tsx | 2 +- .../templates/groups/DonationAmount/index.tsx | 2 +- .../DonationAmount/subscriptionPeriod.ts | 14 +++---- .../groups/DonationAmount/useDonationType.ts | 2 +- .../templates/layouts/DonationReceipt.tsx | 8 ++-- .../layouts/DonationSummaryItems.tsx | 4 +- .../templates/layouts/FieldError.tsx | 2 +- .../templates/layouts/FieldLabel.tsx | 2 +- .../registrars/templates/layouts/Goal.tsx | 2 +- .../registrars/templates/layouts/Header.tsx | 2 +- .../templates/layouts/HeaderDescription.tsx | 2 +- .../templates/layouts/HeaderTitle.tsx | 2 +- src/DonationForms/resources/styles/global.css | 2 +- src/DonationForms/resources/types.ts | 8 ++-- .../Controllers/DonationDetailsController.php | 4 +- .../Views/DonationDetailsView.php | 16 ++++---- src/Donations/ServiceProviderV3.php | 2 +- .../Controllers/DonorDetailsController.php | 8 ++-- .../CustomFields/Views/DonorDetailsView.php | 16 ++++---- src/Donors/ServiceProviderV3.php | 2 +- ...ertGlobalDefaultOptionsToDefaultBlocks.php | 8 ++-- ...acyNotificationToEmailNotificationData.php | 2 +- .../DequeueAdminScriptsInFormBuilder.php | 6 +-- .../DequeueAdminStylesInFormBuilder.php | 6 +-- .../Actions/UpdateDonorCommentsMeta.php | 4 +- .../Actions/UpdateEmailSettingsMeta.php | 4 +- .../Actions/UpdateEmailTemplateMeta.php | 6 +-- .../Actions/UpdateFormGridMeta.php | 4 +- .../FormBuilderResourceController.php | 12 +++--- .../EmailNotificationData.php | 4 +- .../Actions/ApplyPreviewTemplateTags.php | 12 +++--- .../Actions/BuildEmailPreview.php | 2 +- .../Actions/GetEmailNotificationByType.php | 4 +- .../Controllers/SendEmailPreview.php | 4 +- .../Routes/RegisterEmailPreviewRoutes.php | 2 +- src/FormBuilder/FormBuilderRouteBuilder.php | 12 +++--- src/FormBuilder/Routes/CreateFormRoute.php | 2 +- src/FormBuilder/Routes/EditFormRoute.php | 2 +- .../Routes/RegisterFormBuilderPageRoute.php | 14 +++---- .../Routes/RegisterFormBuilderRestRoutes.php | 8 ++-- src/FormBuilder/ServiceProvider.php | 2 +- .../FormBuilderRestRouteConfig.php | 2 +- .../ViewModels/FormBuilderViewModel.php | 16 ++++---- .../src/blocks/fields/donor-comments/Edit.tsx | 4 +- .../blocks/fields/donor-comments/index.tsx | 2 +- .../blocks/fields/donor-comments/settings.tsx | 4 +- .../src/common/getDefaultBlockAttributes.ts | 2 +- .../src/common/parseMissingBlocks.ts | 2 +- .../form-builder/src/common/registerBlocks.ts | 6 +-- .../src/common/revertMissingBlocks.ts | 2 +- .../src/components/forks/BlockTypesList.tsx | 2 +- .../settings/ControlForPopover/index.tsx | 4 +- .../PopoverContentWithTemplateTags/index.tsx | 8 ++-- .../src/containers/BlockEditorContainer.tsx | 2 +- .../src/hooks/useFieldNameValidator.ts | 14 +++---- .../form-builder/src/hooks/usePopoverState.ts | 2 +- .../src/stores/form-state/index.tsx | 6 +-- .../src/stores/form-state/reducer.ts | 8 ++-- .../field-settings/FieldSettingsHOC.tsx | 4 +- .../MetaKeyTextControl/index.tsx | 6 +-- .../src/supports/field-settings/index.tsx | 2 +- .../field-settings/normalizeFieldSettings.ts | 2 +- .../src/supports/field-settings/slots.ts | 2 +- .../field-settings/updateBlockTypes.ts | 2 +- .../src/types/formPageSettings.ts | 2 +- .../js/form-builder/src/types/formSettings.ts | 2 +- .../js/form-builder/src/types/formState.ts | 2 +- .../resources/js/registrars/blocks/index.ts | 14 +++---- .../Concerns/Blocks/BlockFactory.php | 2 +- .../DonationSummarySettings.php | 4 +- src/FormMigration/ServiceProvider.php | 3 +- src/FormMigration/Steps/FormFields.php | 4 +- src/FormMigration/functions.php | 2 +- src/Framework/Blocks/BlockCollection.php | 24 ++++++------ src/Framework/Blocks/BlockModel.php | 16 ++++---- .../Actions/CreateValidatorFromFormFields.php | 2 +- src/Framework/FieldsAPI/Amount.php | 16 ++++---- src/Framework/FieldsAPI/BillingAddress.php | 12 +++--- src/Framework/FieldsAPI/Consent.php | 32 ++++++++-------- src/Framework/FieldsAPI/DonationAmount.php | 12 +++--- src/Framework/FieldsAPI/DonationForm.php | 18 ++++----- src/Framework/FieldsAPI/Password.php | 2 +- src/Framework/FieldsAPI/PaymentGateways.php | 4 +- .../DonationForm/CurrencySwitcherSetting.php | 20 +++++----- .../Contracts/FormDesignInterface.php | 6 +-- .../Exceptions/OverflowException.php | 2 +- src/Framework/FormDesigns/FormDesign.php | 12 +++--- .../Registrars/FormDesignRegistrar.php | 14 +++---- src/Framework/FormDesigns/ServiceProvider.php | 2 +- .../PaymentGateways/Traits/HasRequest.php | 4 +- .../GenerateConfirmationPageReceipt.php | 30 +++++++-------- src/Framework/Receipts/DonationReceipt.php | 6 +-- .../Receipts/DonationReceiptBuilder.php | 4 +- .../Receipts/Properties/ReceiptDetail.php | 4 +- .../Properties/ReceiptDetailCollection.php | 8 ++-- .../Receipts/Properties/ReceiptSettings.php | 6 +-- src/Framework/Routes/Route.php | 2 +- src/Framework/Routes/RouteListener.php | 4 +- src/Framework/Routes/Router.php | 18 ++++----- .../Scripts/Concerns/HasScriptAssetFile.php | 6 +-- .../Actions/TransformTemplateTags.php | 2 +- .../TemplateTags/DonationTemplateTags.php | 6 +-- .../PayPalStandardGateway.php | 2 +- .../PayPalCommerce/PayPalCommerceGateway.php | 2 +- .../PayPalCommerceSubscriptionModule.php | 2 +- .../Gateways/ServiceProvider.php | 12 +++--- .../Gateways/Stripe/LegacyStripeAdapter.php | 6 +-- .../DataTransferObjects/StripeGatewayData.php | 2 +- .../StripePaymentIntentData.php | 6 +-- .../StripePaymentElementGateway.php | 6 +-- .../StripePaymentElementRepository.php | 22 +++++------ .../Decorators/SubscriptionModelDecorator.php | 12 +++--- .../Webhooks/Listeners/ChargeRefunded.php | 6 +-- .../Listeners/CustomerSubscriptionCreated.php | 6 +-- .../Listeners/CustomerSubscriptionDeleted.php | 6 +-- .../Listeners/InvoicePaymentFailed.php | 8 ++-- .../Listeners/InvoicePaymentSucceeded.php | 12 +++--- .../Listeners/PaymentIntentPaymentFailed.php | 6 +-- .../Listeners/PaymentIntentSucceeded.php | 6 +-- .../StripeWebhookListenerRepository.php | 6 +-- .../stripePaymentElementGateway.tsx | 4 +- .../TestGatewaySubscriptionModule.php | 6 +-- src/Promotions/ServiceProviderV3.php | 2 +- 267 files changed, 825 insertions(+), 826 deletions(-) diff --git a/src/DonationForms/Actions/ConvertConsentBlockToFieldsApi.php b/src/DonationForms/Actions/ConvertConsentBlockToFieldsApi.php index eb910f2e61..fbe3c8b99a 100644 --- a/src/DonationForms/Actions/ConvertConsentBlockToFieldsApi.php +++ b/src/DonationForms/Actions/ConvertConsentBlockToFieldsApi.php @@ -8,7 +8,7 @@ class ConvertConsentBlockToFieldsApi { /** - * @since 0.5.0 + * @since 3.0.0 */ public function __invoke(BlockModel $block, int $blockIndex) { @@ -25,7 +25,7 @@ public function __invoke(BlockModel $block, int $blockIndex) } /** - * @since 0.5.0 + * @since 3.0.0 * * @return void */ @@ -40,7 +40,7 @@ private function setGlobalAttributes(Consent $field) } /** - * @since 0.5.0 + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/Actions/ConvertDonationAmountBlockToFieldsApi.php b/src/DonationForms/Actions/ConvertDonationAmountBlockToFieldsApi.php index 7d114d0839..c59c5b7f5d 100644 --- a/src/DonationForms/Actions/ConvertDonationAmountBlockToFieldsApi.php +++ b/src/DonationForms/Actions/ConvertDonationAmountBlockToFieldsApi.php @@ -27,7 +27,7 @@ class ConvertDonationAmountBlockToFieldsApi { /** - * @since 0.3.0 + * @since 3.0.0 * * @throws EmptyNameException * @throws NameCollisionException @@ -116,7 +116,7 @@ public function __invoke(BlockModel $block, string $currency): DonationAmount } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws EmptyNameException */ @@ -161,7 +161,7 @@ protected function getRecurringAmountPeriodField(BlockModel $block): Field } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function mergePeriodOptionsWithOneTime(array $options): array { diff --git a/src/DonationForms/Actions/ConvertDonationFormBlocksToFieldsApi.php b/src/DonationForms/Actions/ConvertDonationFormBlocksToFieldsApi.php index dec5492bd6..1b3217e959 100644 --- a/src/DonationForms/Actions/ConvertDonationFormBlocksToFieldsApi.php +++ b/src/DonationForms/Actions/ConvertDonationFormBlocksToFieldsApi.php @@ -30,7 +30,7 @@ use WP_User; /** - * @since 0.1.0 + * @since 3.0.0 */ class ConvertDonationFormBlocksToFieldsApi { @@ -44,10 +44,10 @@ class ConvertDonationFormBlocksToFieldsApi protected $currency; /** - * @since 0.6.0 return DonationForm Node - * @since 0.4.0 conditionally append blocks if block has inner blocks. Add blockIndex to inner blocks node converter. + * @since 3.0.0 return DonationForm Node + * @since 3.0.0 conditionally append blocks if block has inner blocks. Add blockIndex to inner blocks node converter. * @since 0.3.3 conditionally append blocks if block has inner blocks - * @since 0.1.0 + * @since 3.0.0 * * @throws TypeNotSupported|NameCollisionException */ @@ -86,7 +86,7 @@ static function ($node) { /** * @since 0.3.3 remove innerBlock appending - * @since 0.1.0 + * @since 3.0.0 */ protected function convertTopLevelBlockToSection(BlockModel $block, int $blockIndex): Section { @@ -97,7 +97,7 @@ protected function convertTopLevelBlockToSection(BlockModel $block, int $blockIn /** * @unlreased add `givewp_donation_form_block_converted_to_node` action hook - * @since 0.1.0 + * @since 3.0.0 * * @throws EmptyNameException|NameCollisionException * @@ -119,7 +119,7 @@ protected function convertInnerBlockToNode(BlockModel $block, int $blockIndex) } /** - * @since 0.5.0 Add support to billing address field + * @since 3.0.0 Add support to billing address field * @since 0.4.0 add blockIndex for unique field names, add filter `givewp_donation_form_block_render` filters * @since 0.1.0 * @@ -246,7 +246,7 @@ protected function createNodeFromBlockWithUniqueAttributes(BlockModel $block, in } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function createNodeFromDonorNameBlock(BlockModel $block): Node { @@ -288,7 +288,7 @@ protected function createNodeFromDonorNameBlock(BlockModel $block): Node } /** - * @since 0.5.0 + * @since 3.0.0 */ protected function createNodeFromBillingAddressBlock(BlockModel $block): Node { @@ -341,7 +341,7 @@ protected function createNodeFromBillingAddressBlock(BlockModel $block): Node } /** - * @since 0.2.0 + * @since 3.0.0 * * @throws NameCollisionException * @throws EmptyNameException @@ -352,7 +352,7 @@ protected function createNodeFromAmountBlock(BlockModel $block): Node } /** - * @since 0.5.0 + * @since 3.0.0 */ protected function createNodeFromConsentBlock(BlockModel $block, int $blockIndex): Node { @@ -360,7 +360,7 @@ protected function createNodeFromConsentBlock(BlockModel $block, int $blockIndex } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function mapGenericBlockAttributesToNode(Node $node, BlockModel $block): Node { diff --git a/src/DonationForms/Actions/ConvertQueryDataToDonationForm.php b/src/DonationForms/Actions/ConvertQueryDataToDonationForm.php index 5e1181a660..7b8a165438 100644 --- a/src/DonationForms/Actions/ConvertQueryDataToDonationForm.php +++ b/src/DonationForms/Actions/ConvertQueryDataToDonationForm.php @@ -12,7 +12,7 @@ class ConvertQueryDataToDonationForm { /** - * @since 0.1.0 + * @since 3.0.0 * * @param object $queryObject */ diff --git a/src/DonationForms/Actions/DispatchDonateControllerDonationCreatedListeners.php b/src/DonationForms/Actions/DispatchDonateControllerDonationCreatedListeners.php index f43c82c95d..f4ef3e570f 100644 --- a/src/DonationForms/Actions/DispatchDonateControllerDonationCreatedListeners.php +++ b/src/DonationForms/Actions/DispatchDonateControllerDonationCreatedListeners.php @@ -10,7 +10,7 @@ class DispatchDonateControllerDonationCreatedListeners { /** - * @since 0.3.0 + * @since 3.0.0 */ public function __invoke(DonateControllerData $formData, Donation $donation) { diff --git a/src/DonationForms/Actions/DispatchDonateControllerSubscriptionCreatedListeners.php b/src/DonationForms/Actions/DispatchDonateControllerSubscriptionCreatedListeners.php index d94b7da11a..c25665744e 100644 --- a/src/DonationForms/Actions/DispatchDonateControllerSubscriptionCreatedListeners.php +++ b/src/DonationForms/Actions/DispatchDonateControllerSubscriptionCreatedListeners.php @@ -9,7 +9,7 @@ class DispatchDonateControllerSubscriptionCreatedListeners { /** - * @since 0.3.0 + * @since 3.0.0 */ public function __invoke(DonateControllerData $formData, Subscription $subscription, Donation $donation) { diff --git a/src/DonationForms/Actions/GenerateAuthUrl.php b/src/DonationForms/Actions/GenerateAuthUrl.php index 455ad07f2f..29a86902a8 100644 --- a/src/DonationForms/Actions/GenerateAuthUrl.php +++ b/src/DonationForms/Actions/GenerateAuthUrl.php @@ -7,12 +7,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.1.0 + * @since 3.0.0 */ class GenerateAuthUrl { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(): string { diff --git a/src/DonationForms/Actions/GenerateDonateRouteSignatureArgs.php b/src/DonationForms/Actions/GenerateDonateRouteSignatureArgs.php index 2909d00ba8..c672026743 100644 --- a/src/DonationForms/Actions/GenerateDonateRouteSignatureArgs.php +++ b/src/DonationForms/Actions/GenerateDonateRouteSignatureArgs.php @@ -7,7 +7,7 @@ class GenerateDonateRouteSignatureArgs { /** - * @since 0.4.0 + * @since 3.0.0 */ public function __invoke(DonateRouteSignature $signature, string $signatureId): array { diff --git a/src/DonationForms/Actions/GenerateDonateRouteUrl.php b/src/DonationForms/Actions/GenerateDonateRouteUrl.php index 9f79c7e4d3..63634459e2 100644 --- a/src/DonationForms/Actions/GenerateDonateRouteUrl.php +++ b/src/DonationForms/Actions/GenerateDonateRouteUrl.php @@ -7,12 +7,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.1.0 + * @since 3.0.0 */ class GenerateDonateRouteUrl { /** - * @since 0.1.0 + * @since 3.0.0 * * @return string * diff --git a/src/DonationForms/Actions/GenerateDonationConfirmationReceiptUrl.php b/src/DonationForms/Actions/GenerateDonationConfirmationReceiptUrl.php index 00699adfd1..3aa073ca97 100644 --- a/src/DonationForms/Actions/GenerateDonationConfirmationReceiptUrl.php +++ b/src/DonationForms/Actions/GenerateDonationConfirmationReceiptUrl.php @@ -8,7 +8,7 @@ class GenerateDonationConfirmationReceiptUrl { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(Donation $donation, string $originUrl, string $embedId = ''): string { diff --git a/src/DonationForms/Actions/GenerateDonationConfirmationReceiptViewRouteUrl.php b/src/DonationForms/Actions/GenerateDonationConfirmationReceiptViewRouteUrl.php index f174e8a33a..96b520904e 100644 --- a/src/DonationForms/Actions/GenerateDonationConfirmationReceiptViewRouteUrl.php +++ b/src/DonationForms/Actions/GenerateDonationConfirmationReceiptViewRouteUrl.php @@ -6,12 +6,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.1.0 + * @since 3.0.0 */ class GenerateDonationConfirmationReceiptViewRouteUrl { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(string $receiptId): string { diff --git a/src/DonationForms/Actions/GenerateDonationFormPreviewRouteUrl.php b/src/DonationForms/Actions/GenerateDonationFormPreviewRouteUrl.php index a5edf466ac..2af842085f 100644 --- a/src/DonationForms/Actions/GenerateDonationFormPreviewRouteUrl.php +++ b/src/DonationForms/Actions/GenerateDonationFormPreviewRouteUrl.php @@ -6,12 +6,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.1.0 + * @since 3.0.0 */ class GenerateDonationFormPreviewRouteUrl { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(int $formId): string { diff --git a/src/DonationForms/Actions/GenerateDonationFormValidationRouteUrl.php b/src/DonationForms/Actions/GenerateDonationFormValidationRouteUrl.php index 1ae6266c6b..d4a4bb0cc2 100644 --- a/src/DonationForms/Actions/GenerateDonationFormValidationRouteUrl.php +++ b/src/DonationForms/Actions/GenerateDonationFormValidationRouteUrl.php @@ -7,12 +7,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.4.0 + * @since 3.0.0 */ class GenerateDonationFormValidationRouteUrl { /** - * @since 0.4.0 + * @since 3.0.0 * * @return string * diff --git a/src/DonationForms/Actions/GenerateDonationFormViewRouteUrl.php b/src/DonationForms/Actions/GenerateDonationFormViewRouteUrl.php index ce62ba147a..2f00dee9c9 100644 --- a/src/DonationForms/Actions/GenerateDonationFormViewRouteUrl.php +++ b/src/DonationForms/Actions/GenerateDonationFormViewRouteUrl.php @@ -6,12 +6,12 @@ use Give\Framework\Routes\Route; /** - * @since 0.1.0 + * @since 3.0.0 */ class GenerateDonationFormViewRouteUrl { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(int $formId): string { diff --git a/src/DonationForms/Actions/SanitizeDonationFormPreviewRequest.php b/src/DonationForms/Actions/SanitizeDonationFormPreviewRequest.php index 00128d0fd1..2b04a3e1b6 100644 --- a/src/DonationForms/Actions/SanitizeDonationFormPreviewRequest.php +++ b/src/DonationForms/Actions/SanitizeDonationFormPreviewRequest.php @@ -5,7 +5,7 @@ class SanitizeDonationFormPreviewRequest { /** - * @since 0.6.0 + * @since 3.0.0 */ public function __invoke($var) { diff --git a/src/DonationForms/Actions/StoreBackwardsCompatibleFormMeta.php b/src/DonationForms/Actions/StoreBackwardsCompatibleFormMeta.php index eff4e75f16..cb9a9eb35f 100644 --- a/src/DonationForms/Actions/StoreBackwardsCompatibleFormMeta.php +++ b/src/DonationForms/Actions/StoreBackwardsCompatibleFormMeta.php @@ -12,7 +12,7 @@ class StoreBackwardsCompatibleFormMeta { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(DonationForm $donationForm) { @@ -22,8 +22,8 @@ public function __invoke(DonationForm $donationForm) } /** - * @since 0.3.0 update with dynamic values from amount field - * @since 0.1.0 + * @since 3.0.0 update with dynamic values from amount field + * @since 3.0.0 */ public function storeDonationLevels(DonationForm $donationForm) { @@ -60,7 +60,7 @@ public function storeDonationLevels(DonationForm $donationForm) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function storeDonationGoal(DonationForm $donationForm) { @@ -87,7 +87,7 @@ public function storeDonationGoal(DonationForm $donationForm) } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function saveSingleFormMeta($formId, $metaKey, $metaValue) { @@ -95,7 +95,7 @@ protected function saveSingleFormMeta($formId, $metaKey, $metaValue) } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function storeRecurringMetaKeys(DonationForm $donationForm) { diff --git a/src/DonationForms/Blocks/DonationFormBlock/Block.php b/src/DonationForms/Blocks/DonationFormBlock/Block.php index 4fdd9c67ec..790d5e0e10 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/Block.php +++ b/src/DonationForms/Blocks/DonationFormBlock/Block.php @@ -8,7 +8,7 @@ class Block { /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/Blocks/DonationFormBlock/Controllers/BlockRenderController.php b/src/DonationForms/Blocks/DonationFormBlock/Controllers/BlockRenderController.php index 139549c79b..02a6c235a8 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/Controllers/BlockRenderController.php +++ b/src/DonationForms/Blocks/DonationFormBlock/Controllers/BlockRenderController.php @@ -13,7 +13,7 @@ class BlockRenderController { /** - * @since 0.5.0 replace iframe with root element for react + * @since 3.0.0 replace iframe with root element for react * @since 0.1.0 * * @return string|null @@ -50,7 +50,7 @@ public function render(array $attributes) /** * If the page loads with our receipt route listener args then we need to render the receipt. * - * @since 0.1.0 + * @since 3.0.0 */ protected function shouldDisplayDonationConfirmationReceipt(string $embedId): bool { @@ -72,7 +72,7 @@ protected function shouldDisplayDonationConfirmationReceipt(string $embedId): bo * Get the iframe URL. * This could either be the donation form view or the donation confirmation receipt view. * - * @since 0.1.0 + * @since 3.0.0 */ private function getViewUrl(DonationForm $donationForm, string $embedId): string { @@ -90,7 +90,7 @@ private function getViewUrl(DonationForm $donationForm, string $embedId): string * Load embed givewp script to resize iframe * @see https://github.com/davidjbradshaw/iframe-resizer * - * @since 0.5.0 load app scripts + * @since 3.0.0 load app scripts * @since 0.1.0 */ private function loadEmbedScript() diff --git a/src/DonationForms/Blocks/DonationFormBlock/DataTransferObjects/BlockAttributes.php b/src/DonationForms/Blocks/DonationFormBlock/DataTransferObjects/BlockAttributes.php index c6dc2efd0d..8d6ebb546a 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/DataTransferObjects/BlockAttributes.php +++ b/src/DonationForms/Blocks/DonationFormBlock/DataTransferObjects/BlockAttributes.php @@ -26,7 +26,7 @@ class BlockAttributes implements Arrayable public $openFormButton; /** - * @since 0.1.0 + * @since 3.0.0 */ public static function fromArray(array $array): BlockAttributes { @@ -41,7 +41,7 @@ public static function fromArray(array $array): BlockAttributes } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/ModalForm.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/ModalForm.tsx index 05e2c4a815..a644615538 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/ModalForm.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/ModalForm.tsx @@ -3,7 +3,7 @@ import {createPortal} from 'react-dom'; import IframeResizer from 'iframe-resizer-react'; /** - * @since 0.5.0 + * @since 3.0.0 */ export default function ModalForm({dataSrc, embedId, openFormButton}) { const [isOpen, setIsOpen] = useState(false); diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/RevealForm.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/RevealForm.tsx index 18e6fd1297..97ddbb0ff5 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/RevealForm.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/app/Components/RevealForm.tsx @@ -2,7 +2,7 @@ import {useState} from '@wordpress/element'; import IframeResizer from 'iframe-resizer-react'; /** - * @since 0.5.0 + * @since 3.0.0 */ export default function RevealForm({dataSrc, embedId, openFormButton}) { const [isRevealed, setIsRevealed] = useState(false); diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/app/index.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/app/index.tsx index 463c714e42..a2e34f9a4c 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/app/index.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/app/index.tsx @@ -6,7 +6,7 @@ import IframeResizer from 'iframe-resizer-react'; import './styles/index.scss'; /** - * @since 0.5.0 + * @since 3.0.0 */ function DonationFormBlockApp({formFormat, dataSrc, embedId, openFormButton}) { if (formFormat === 'reveal') { diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/block.ts b/src/DonationForms/Blocks/DonationFormBlock/resources/block.ts index cb91ca1835..4988d3afbe 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/block.ts +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/block.ts @@ -4,7 +4,7 @@ import Edit from './editor/Edit'; import GiveIcon from './Icon'; /** - * @since 0.1.0 + * @since 3.0.0 */ registerBlockType(schema as BlockConfiguration, { icon: GiveIcon, diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/Edit.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/Edit.tsx index 31f489572b..8b6f529dcd 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/Edit.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/Edit.tsx @@ -12,8 +12,8 @@ import BlockPreview from './components/BlockPreview'; import './styles/index.scss'; /** - * @since 0.5.0 Render block preview in the editor. - * @since 0.1.0 + * @since 3.0.0 Render block preview in the editor. + * @since 3.0.0 */ export default function Edit({clientId, attributes, setAttributes}: BlockEditProps) { const {formId, blockId, formFormat, openFormButton} = attributes; diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/BlockPreview.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/BlockPreview.tsx index bf5bab8ede..8604f2e35b 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/BlockPreview.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/BlockPreview.tsx @@ -11,7 +11,7 @@ interface BlockPreviewProps { } /** - * @since 0.5.0 + * @since 3.0.0 */ export default function BlockPreview({clientId, formId, formFormat, openFormButton}: BlockPreviewProps) { // @ts-ignore diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/Logo.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/Logo.tsx index 77e48d4695..5e3a736f43 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/Logo.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/Logo.tsx @@ -3,7 +3,7 @@ import logo from '../images/givewp-logo.svg'; /** * - * @since 0.1.0 + * @since 3.0.0 */ export default function Logo() { return
diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/ModalPreview.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/ModalPreview.tsx index 39012778b4..3b5985a836 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/ModalPreview.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/ModalPreview.tsx @@ -3,7 +3,7 @@ import {createPortal} from 'react-dom'; import IframeResizer from 'iframe-resizer-react'; /** - * @since 0.5.0 + * @since 3.0.0 */ export default function ModalPreview({enableIframe, formId, openFormButton}) { const [isOpen, setIsOpen] = useState(false); diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/RevealPreview.tsx b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/RevealPreview.tsx index 4845dc2b0d..23db13bf41 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/RevealPreview.tsx +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/components/RevealPreview.tsx @@ -2,7 +2,7 @@ import {useState} from '@wordpress/element'; import IframeResizer from 'iframe-resizer-react'; /** - * @since 0.5.0 + * @since 3.0.0 */ export default function RevealPreview({enableIframe, formId, openFormButton}: any) { const [isRevealed, setIsRevealed] = useState(false); diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/useFormOptions.ts b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/useFormOptions.ts index 0606213349..dca3768dde 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/useFormOptions.ts +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/useFormOptions.ts @@ -4,8 +4,8 @@ import type {Post} from '@wordpress/core-data/src/entity-types'; import type {Option} from '../types'; /** - * @since 0.5.0 filter v3 forms by rendered excerpt. - * @since 0.1.0 + * @since 3.0.0 filter v3 forms by rendered excerpt. + * @since 3.0.0 */ export default function useFormOptions(): {formOptions: Option[] | []; isResolving: boolean} { const {forms, isResolving} = useSelect((select) => { diff --git a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/usePostState.ts b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/usePostState.ts index 73ec099f2a..73cef541af 100644 --- a/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/usePostState.ts +++ b/src/DonationForms/Blocks/DonationFormBlock/resources/editor/hooks/usePostState.ts @@ -1,7 +1,7 @@ import {useSelect} from '@wordpress/data'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function usePostState(): { isSaving: boolean, isDisabled: boolean } { const isSaving = useSelect((select) => { diff --git a/src/DonationForms/Controllers/DonateController.php b/src/DonationForms/Controllers/DonateController.php index 31d09d6c7c..947993595d 100644 --- a/src/DonationForms/Controllers/DonateController.php +++ b/src/DonationForms/Controllers/DonateController.php @@ -12,7 +12,7 @@ use Give\PaymentGateways\Actions\GetGatewayDataFromRequest; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonateController { @@ -20,8 +20,8 @@ class DonateController * First we create a donation and/or subscription, then move on to the gateway processing * * @since 0.3.3 use gateway controllers - * @since 0.3.0 add support for subscriptions - * @since 0.1.0 + * @since 3.0.0 add support for subscriptions + * @since 3.0.0 * * @return void * @throws Exception|PaymentGatewayException @@ -77,7 +77,7 @@ public function donate(DonateControllerData $formData, PaymentGateway $gateway) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param int|null $userId * @param string $donorEmail diff --git a/src/DonationForms/Controllers/DonationConfirmationReceiptViewController.php b/src/DonationForms/Controllers/DonationConfirmationReceiptViewController.php index 7a064906ad..e6ae9d647e 100644 --- a/src/DonationForms/Controllers/DonationConfirmationReceiptViewController.php +++ b/src/DonationForms/Controllers/DonationConfirmationReceiptViewController.php @@ -13,7 +13,7 @@ class DonationConfirmationReceiptViewController /** * This renders the donation confirmation receipt view. * - * @since 0.1.0 + * @since 3.0.0 */ public function show(DonationConfirmationReceiptViewRouteData $data): string { @@ -31,7 +31,7 @@ public function show(DonationConfirmationReceiptViewRouteData $data): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @return Donation|null */ diff --git a/src/DonationForms/Controllers/DonationFormViewController.php b/src/DonationForms/Controllers/DonationFormViewController.php index 44b9e74b9b..520914985b 100644 --- a/src/DonationForms/Controllers/DonationFormViewController.php +++ b/src/DonationForms/Controllers/DonationFormViewController.php @@ -12,7 +12,7 @@ class DonationFormViewController /** * This renders the donation form view. * - * @since 0.1.0 + * @since 3.0.0 */ public function show(DonationFormViewRouteData $data): string { @@ -31,7 +31,7 @@ public function show(DonationFormViewRouteData $data): string /** * This renders the donation form preview * - * @since 0.1.0 + * @since 3.0.0 */ public function preview(DonationFormPreviewRouteData $data): string { diff --git a/src/DonationForms/DataTransferObjects/AuthenticationData.php b/src/DonationForms/DataTransferObjects/AuthenticationData.php index f5683cae0b..eaf28d871b 100644 --- a/src/DonationForms/DataTransferObjects/AuthenticationData.php +++ b/src/DonationForms/DataTransferObjects/AuthenticationData.php @@ -3,7 +3,7 @@ namespace Give\DonationForms\DataTransferObjects; /** - * @since 0.1.0 + * @since 3.0.0 */ class AuthenticationData { @@ -19,7 +19,7 @@ class AuthenticationData /** * Convert data from request into DTO * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $request): AuthenticationData { diff --git a/src/DonationForms/DataTransferObjects/DonateControllerData.php b/src/DonationForms/DataTransferObjects/DonateControllerData.php index a0ae51e70a..206b36e541 100644 --- a/src/DonationForms/DataTransferObjects/DonateControllerData.php +++ b/src/DonationForms/DataTransferObjects/DonateControllerData.php @@ -126,9 +126,9 @@ class DonateControllerData public $comment; /** - * @since 0.7.0 added support for comment property - * @since 0.7.0 added support for anonymous - * @since 0.5.0 Add support billing address field + * @since 3.0.0 added support for comment property + * @since 3.0.0 added support for anonymous + * @since 3.0.0 Add support billing address field * @since 0.1.0 */ public function toDonation(int $donorId): Donation @@ -154,9 +154,9 @@ public function toDonation(int $donorId): Donation } /** - * @since 0.7.0 added support for comment property - * @since 0.7.0 added support for anonymous - * @since 0.5.0 Add support billing address field + * @since 3.0.0 added support for comment property + * @since 3.0.0 added support for anonymous + * @since 3.0.0 Add support billing address field * @since 0.3.0 */ public function toInitialSubscriptionDonation(int $donorId, int $subscriptionId): Donation @@ -183,7 +183,7 @@ public function toInitialSubscriptionDonation(int $donorId, int $subscriptionId) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getSuccessUrl(Donation $donation): string { @@ -193,7 +193,7 @@ public function getSuccessUrl(Donation $donation): string } /** - * @since 0.1.0 + * @since 3.0.0 * * TODO: add params to route for flash message */ @@ -203,7 +203,7 @@ public function getCancelUrl(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getDonationConfirmationReceiptViewRouteUrl(Donation $donation): string { @@ -211,7 +211,7 @@ public function getDonationConfirmationReceiptViewRouteUrl(Donation $donation): } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getDonationConfirmationReceiptUrl(Donation $donation): string { @@ -219,7 +219,7 @@ public function getDonationConfirmationReceiptUrl(Donation $donation): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getDonationForm(): DonationForm { @@ -232,7 +232,7 @@ public function getDonationForm(): DonationForm * * TODO: figure out a less static way of doing this * - * @since 0.1.0 + * @since 3.0.0 */ public function getCustomFields(): array { @@ -269,7 +269,7 @@ public function getCustomFields(): array } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ @@ -296,7 +296,7 @@ public function amount(): Money } /** - * @since 0.4.0 + * @since 3.0.0 */ public function getGateway(): PaymentGateway { @@ -304,7 +304,7 @@ public function getGateway(): PaymentGateway } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getBillingAddress(): BillingAddress { diff --git a/src/DonationForms/DataTransferObjects/DonateFormRouteData.php b/src/DonationForms/DataTransferObjects/DonateFormRouteData.php index 74d51042e8..f17a21d3a3 100644 --- a/src/DonationForms/DataTransferObjects/DonateFormRouteData.php +++ b/src/DonationForms/DataTransferObjects/DonateFormRouteData.php @@ -9,7 +9,7 @@ use WP_Error; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonateFormRouteData implements Arrayable { @@ -41,7 +41,7 @@ class DonateFormRouteData implements Arrayable /** * Convert data from request into DTO * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $requestData): DonateFormRouteData { @@ -61,7 +61,7 @@ public static function fromRequest(array $requestData): DonateFormRouteData * compares the request against the individual fields, * their types and validation rules. * - * @since 0.5.0 Add support for billing address field + * @since 3.0.0 Add support for billing address field * @since 0.1.0 * * @throws DonationFormFieldErrorsException @@ -98,7 +98,7 @@ public function validated(): DonateControllerData } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getRequestData(): array { @@ -110,7 +110,7 @@ public function getRequestData(): array * and converts them into a WP_Error object that is attached to the * exception and delivered back to the client via JSON. * - * @since 0.1.0 + * @since 3.0.0 * * @param array $errors * @@ -128,7 +128,7 @@ private function throwDonationFormFieldErrorsException(array $errors) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/DonationForms/DataTransferObjects/DonateRouteData.php b/src/DonationForms/DataTransferObjects/DonateRouteData.php index da90f73de9..a8507bade1 100644 --- a/src/DonationForms/DataTransferObjects/DonateRouteData.php +++ b/src/DonationForms/DataTransferObjects/DonateRouteData.php @@ -6,7 +6,7 @@ use Give\Framework\PaymentGateways\Log\PaymentGatewayLog; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonateRouteData { @@ -26,7 +26,7 @@ class DonateRouteData /** * Convert data from request into DTO * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $request): DonateRouteData { @@ -40,7 +40,7 @@ public static function fromRequest(array $request): DonateRouteData } /** - * @since 0.4.0 + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/DataTransferObjects/DonationConfirmationReceiptViewRouteData.php b/src/DonationForms/DataTransferObjects/DonationConfirmationReceiptViewRouteData.php index 4c2a76b39c..e5853db2da 100644 --- a/src/DonationForms/DataTransferObjects/DonationConfirmationReceiptViewRouteData.php +++ b/src/DonationForms/DataTransferObjects/DonationConfirmationReceiptViewRouteData.php @@ -5,7 +5,7 @@ use function strlen; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationConfirmationReceiptViewRouteData { @@ -16,7 +16,7 @@ class DonationConfirmationReceiptViewRouteData /** * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $request): DonationConfirmationReceiptViewRouteData { @@ -32,7 +32,7 @@ public static function fromRequest(array $request): DonationConfirmationReceiptV /** * The receipt ID is a md5 hash which has a 32 character length. * - * @since 0.1.0 + * @since 3.0.0 */ public static function isReceiptIdValid(string $receiptId): bool { diff --git a/src/DonationForms/DataTransferObjects/DonationFormGoalData.php b/src/DonationForms/DataTransferObjects/DonationFormGoalData.php index a82854be36..1ef466940c 100644 --- a/src/DonationForms/DataTransferObjects/DonationFormGoalData.php +++ b/src/DonationForms/DataTransferObjects/DonationFormGoalData.php @@ -8,7 +8,7 @@ use Give\Framework\Support\Contracts\Arrayable; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationFormGoalData implements Arrayable { @@ -34,7 +34,7 @@ class DonationFormGoalData implements Arrayable public $targetAmount; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(int $formId, FormSettings $formSettings) { @@ -46,7 +46,7 @@ public function __construct(int $formId, FormSettings $formSettings) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getCurrentAmount(): int { @@ -65,7 +65,7 @@ public function getCurrentAmount(): int } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/DonationForms/DataTransferObjects/DonationFormPreviewRouteData.php b/src/DonationForms/DataTransferObjects/DonationFormPreviewRouteData.php index 2f8d90623c..b23e871975 100644 --- a/src/DonationForms/DataTransferObjects/DonationFormPreviewRouteData.php +++ b/src/DonationForms/DataTransferObjects/DonationFormPreviewRouteData.php @@ -6,7 +6,7 @@ use Give\Framework\Blocks\BlockCollection; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationFormPreviewRouteData { @@ -30,7 +30,7 @@ class DonationFormPreviewRouteData * * @param array{form-id: string, form-settings: string, form-blocks: string} $request * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $request): self { diff --git a/src/DonationForms/DataTransferObjects/DonationFormQueryData.php b/src/DonationForms/DataTransferObjects/DonationFormQueryData.php index e9bdc16ebe..0c7f370ffb 100644 --- a/src/DonationForms/DataTransferObjects/DonationFormQueryData.php +++ b/src/DonationForms/DataTransferObjects/DonationFormQueryData.php @@ -49,7 +49,7 @@ class DonationFormQueryData /** * Convert data from object to Donation Form * - * @since 0.1.0 + * @since 3.0.0 * * @param object $queryObject * diff --git a/src/DonationForms/DataTransferObjects/DonationFormViewRouteData.php b/src/DonationForms/DataTransferObjects/DonationFormViewRouteData.php index 45596e6d40..d52c4b5f01 100644 --- a/src/DonationForms/DataTransferObjects/DonationFormViewRouteData.php +++ b/src/DonationForms/DataTransferObjects/DonationFormViewRouteData.php @@ -3,7 +3,7 @@ namespace Give\DonationForms\DataTransferObjects; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationFormViewRouteData { @@ -14,7 +14,7 @@ class DonationFormViewRouteData /** * - * @since 0.1.0 + * @since 3.0.0 */ public static function fromRequest(array $request): DonationFormViewRouteData { diff --git a/src/DonationForms/DataTransferObjects/LegacyPurchaseFormData.php b/src/DonationForms/DataTransferObjects/LegacyPurchaseFormData.php index 3548520828..bffeb70e7b 100644 --- a/src/DonationForms/DataTransferObjects/LegacyPurchaseFormData.php +++ b/src/DonationForms/DataTransferObjects/LegacyPurchaseFormData.php @@ -8,7 +8,7 @@ /** * This DTO extracts the complexity of supplying an array for use in give_set_purchase_session() * - * @since 0.1.0 + * @since 3.0.0 */ class LegacyPurchaseFormData { @@ -22,7 +22,7 @@ class LegacyPurchaseFormData public $donor; /** - * @since 0.1.0 + * @since 3.0.0 * * @param array{donation: Donation, donor: Donation} $array * @return LegacyPurchaseFormData @@ -40,7 +40,7 @@ public static function fromArray(array $array): LegacyPurchaseFormData /** * Returns shape needed for give_set_purchase_session() * - * @since 0.1.0 + * @since 3.0.0 */ public function toPurchaseData(): array { diff --git a/src/DonationForms/DataTransferObjects/UserData.php b/src/DonationForms/DataTransferObjects/UserData.php index b1d9c24f86..956455acb7 100644 --- a/src/DonationForms/DataTransferObjects/UserData.php +++ b/src/DonationForms/DataTransferObjects/UserData.php @@ -3,7 +3,7 @@ namespace Give\DonationForms\DataTransferObjects; /** - * @since 0.4.0 + * @since 3.0.0 */ class UserData { @@ -25,7 +25,7 @@ class UserData /** * Convert data from user into DTO * - * @since 0.4.0 + * @since 3.0.0 */ public static function fromUser(\WP_User $user): UserData { diff --git a/src/DonationForms/DataTransferObjects/ValidationRouteData.php b/src/DonationForms/DataTransferObjects/ValidationRouteData.php index 7521bc1175..eaddf78563 100644 --- a/src/DonationForms/DataTransferObjects/ValidationRouteData.php +++ b/src/DonationForms/DataTransferObjects/ValidationRouteData.php @@ -10,7 +10,7 @@ use WP_Error; /** - * @since 0.4.0 + * @since 3.0.0 */ class ValidationRouteData implements Arrayable { @@ -26,7 +26,7 @@ class ValidationRouteData implements Arrayable /** * Convert data from request into DTO * - * @since 0.4.0 + * @since 3.0.0 */ public static function fromRequest(array $requestData): self { @@ -42,7 +42,7 @@ public static function fromRequest(array $requestData): self * compares the request against the individual fields, * their types and validation rules. * - * @since 0.4.0 + * @since 3.0.0 * * @throws DonationFormFieldErrorsException */ @@ -71,7 +71,7 @@ public function validate(): JsonResponse } /** - * @since 0.4.0 + * @since 3.0.0 */ public function getRequestData(): array { @@ -83,7 +83,7 @@ public function getRequestData(): array * and converts them into a WP_Error object that is attached to the * exception and delivered back to the client via JSON. * - * @since 0.4.0 + * @since 3.0.0 * * @param array $errors * @@ -101,7 +101,7 @@ private function throwDonationFormFieldErrorsException(array $errors) } /** - * @since 0.4.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/DonationForms/Exceptions/DonationFormFieldErrorsException.php b/src/DonationForms/Exceptions/DonationFormFieldErrorsException.php index 7c2235c88c..6ddfb313f5 100644 --- a/src/DonationForms/Exceptions/DonationFormFieldErrorsException.php +++ b/src/DonationForms/Exceptions/DonationFormFieldErrorsException.php @@ -17,7 +17,7 @@ class DonationFormFieldErrorsException extends \Exception implements LoggableExc protected $error; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(WP_Error $error, Throwable $previous = null) { @@ -26,7 +26,7 @@ public function __construct(WP_Error $error, Throwable $previous = null) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getError(): WP_Error { diff --git a/src/DonationForms/Factories/DonationFormFactory.php b/src/DonationForms/Factories/DonationFormFactory.php index 2ce060a1fd..b551e15fe8 100644 --- a/src/DonationForms/Factories/DonationFormFactory.php +++ b/src/DonationForms/Factories/DonationFormFactory.php @@ -11,7 +11,7 @@ class DonationFormFactory extends ModelFactory { /** - * @since 0.1.0 + * @since 3.0.0 */ public function definition(): array { diff --git a/src/DonationForms/FormDesigns/ClassicFormDesign/ClassicFormDesign.php b/src/DonationForms/FormDesigns/ClassicFormDesign/ClassicFormDesign.php index 77ee9bf1d2..8e4105fd0d 100644 --- a/src/DonationForms/FormDesigns/ClassicFormDesign/ClassicFormDesign.php +++ b/src/DonationForms/FormDesigns/ClassicFormDesign/ClassicFormDesign.php @@ -5,12 +5,12 @@ use Give\Framework\FormDesigns\FormDesign; /** - * @since 0.1.0 + * @since 3.0.0 */ class ClassicFormDesign extends FormDesign { /** - * @since 0.1.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function name(): string { @@ -26,7 +26,7 @@ public static function name(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function css(): string { @@ -34,7 +34,7 @@ public function css(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function js(): string { @@ -42,7 +42,7 @@ public function js(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function dependencies(): array { diff --git a/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Goal.tsx b/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Goal.tsx index 8367b8db1b..7493076a97 100644 --- a/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Goal.tsx +++ b/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Goal.tsx @@ -4,7 +4,7 @@ import {GoalProps} from '@givewp/forms/propTypes'; const GoalTemplate = window.givewp.form.templates.layouts.goal; /** - * @since 0.1.0 + * @since 3.0.0 */ const FormStats = ({totalRevenue, goalTargetAmount, totalCountValue, totalCountLabel}) => { return ( @@ -26,7 +26,7 @@ const FormStats = ({totalRevenue, goalTargetAmount, totalCountValue, totalCountL }; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function Goal(props: GoalProps) { const {targetAmountFormatted, totalRevenueFormatted, totalCountValue, totalCountLabel} = props; diff --git a/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Header.tsx b/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Header.tsx index 5e472a4376..e58c851bba 100644 --- a/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Header.tsx +++ b/src/DonationForms/FormDesigns/ClassicFormDesign/js/layouts/Header.tsx @@ -1,7 +1,7 @@ import {__} from '@wordpress/i18n'; /** - * @since 0.1.0 + * @since 3.0.0 */ const SecureBadge = () => { return ( @@ -13,7 +13,7 @@ const SecureBadge = () => { }; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function Header({Title, Description, Goal}) { return ( diff --git a/src/DonationForms/FormDesigns/DeveloperFormDesign/DeveloperFormDesign.php b/src/DonationForms/FormDesigns/DeveloperFormDesign/DeveloperFormDesign.php index 2917cdffd1..8fe8413167 100644 --- a/src/DonationForms/FormDesigns/DeveloperFormDesign/DeveloperFormDesign.php +++ b/src/DonationForms/FormDesigns/DeveloperFormDesign/DeveloperFormDesign.php @@ -5,12 +5,12 @@ use Give\Framework\FormDesigns\FormDesign; /** - * @since 0.1.0 + * @since 3.0.0 */ class DeveloperFormDesign extends FormDesign { /** - * @since 0.1.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function name(): string { diff --git a/src/DonationForms/FormDesigns/MultiStepFormDesign/MultiStepFormDesign.php b/src/DonationForms/FormDesigns/MultiStepFormDesign/MultiStepFormDesign.php index 1259f86124..a21bc0eb16 100644 --- a/src/DonationForms/FormDesigns/MultiStepFormDesign/MultiStepFormDesign.php +++ b/src/DonationForms/FormDesigns/MultiStepFormDesign/MultiStepFormDesign.php @@ -5,14 +5,14 @@ use Give\Framework\FormDesigns\FormDesign; /** - * @since 0.4.0 + * @since 3.0.0 */ class MultiStepFormDesign extends FormDesign { protected $isMultiStep = true; /** - * @since 0.4.0 + * @since 3.0.0 */ public static function id(): string { @@ -20,7 +20,7 @@ public static function id(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public static function name(): string { @@ -28,7 +28,7 @@ public static function name(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public function css(): string { @@ -36,7 +36,7 @@ public function css(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public function js(): string { @@ -44,7 +44,7 @@ public function js(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public function dependencies(): array { diff --git a/src/DonationForms/Listeners/AddRedirectUrlsToGatewayData.php b/src/DonationForms/Listeners/AddRedirectUrlsToGatewayData.php index 7100296f4b..c93bbeac93 100644 --- a/src/DonationForms/Listeners/AddRedirectUrlsToGatewayData.php +++ b/src/DonationForms/Listeners/AddRedirectUrlsToGatewayData.php @@ -12,8 +12,8 @@ class AddRedirectUrlsToGatewayData * * This is necessary so gateways can use this value in both legacy and next gen donation forms. * - * @since 0.3.0 move to an action - * @since 0.1.0 + * @since 3.0.0 move to an action + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/Listeners/StoreCustomFields.php b/src/DonationForms/Listeners/StoreCustomFields.php index fb14c5338b..b2a4554c4f 100644 --- a/src/DonationForms/Listeners/StoreCustomFields.php +++ b/src/DonationForms/Listeners/StoreCustomFields.php @@ -17,8 +17,8 @@ class StoreCustomFields * schema settings to the request. Once a field has passed validation, we can determine * its storage location from the fields api. This Action is designed to be triggered post-validation. * - * @since 0.6.0 added support for field scopes and file uploads - * @since 0.1.0 + * @since 3.0.0 added support for field scopes and file uploads + * @since 3.0.0 * * @return void * @throws NameCollisionException @@ -55,7 +55,7 @@ function (Field $field) use ($customFields, $donation) { } /** - * @since 0.6.0 + * @since 3.0.0 * @return array|null */ protected function handleFileUpload(File $field) @@ -68,7 +68,7 @@ protected function handleFileUpload(File $field) } /** - * @since 0.6.0 + * @since 3.0.0 */ protected function storeAsDonorMeta(int $donorId, string $metaKey, $value) { @@ -76,7 +76,7 @@ protected function storeAsDonorMeta(int $donorId, string $metaKey, $value) } /** - * @since 0.6.0 + * @since 3.0.0 */ protected function storeAsDonationMeta(int $donationId, string $metaKey, $value) { @@ -84,7 +84,7 @@ protected function storeAsDonationMeta(int $donationId, string $metaKey, $value) } /** - * @since 0.6.0 + * @since 3.0.0 */ protected function persistFieldScope(Field $field, $value, Donation $donation) { diff --git a/src/DonationForms/Listeners/TemporarilyReplaceLegacySuccessPageUri.php b/src/DonationForms/Listeners/TemporarilyReplaceLegacySuccessPageUri.php index a74f784546..626066a2a7 100644 --- a/src/DonationForms/Listeners/TemporarilyReplaceLegacySuccessPageUri.php +++ b/src/DonationForms/Listeners/TemporarilyReplaceLegacySuccessPageUri.php @@ -15,9 +15,9 @@ class TemporarilyReplaceLegacySuccessPageUri * * This is a temporary solution until we can update the gateway api to support the new receipt urls. * - * @since 0.3.0 move logic to an action + * @since 3.0.0 move logic to an action * - * @since 0.1.0 + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/Listeners/UpdateSubscriptionWithLegacyParentPaymentId.php b/src/DonationForms/Listeners/UpdateSubscriptionWithLegacyParentPaymentId.php index 8089e9b7b5..8945cc6ddb 100644 --- a/src/DonationForms/Listeners/UpdateSubscriptionWithLegacyParentPaymentId.php +++ b/src/DonationForms/Listeners/UpdateSubscriptionWithLegacyParentPaymentId.php @@ -4,7 +4,7 @@ class UpdateSubscriptionWithLegacyParentPaymentId { /** - * @since 0.3.0 + * @since 3.0.0 */ public function __invoke(int $subscriptionId, int $donationId) { diff --git a/src/DonationForms/Models/DonationForm.php b/src/DonationForms/Models/DonationForm.php index ef8e93eb27..9a185cd457 100644 --- a/src/DonationForms/Models/DonationForm.php +++ b/src/DonationForms/Models/DonationForm.php @@ -19,7 +19,7 @@ use Give\Framework\Models\ModelQueryBuilder; /** - * @since 0.1.0 + * @since 3.0.0 * * @property int $id * @property string $title @@ -45,7 +45,7 @@ class DonationForm extends Model implements ModelCrud, ModelHasFactory ]; /** - * @since 0.1.0 + * @since 3.0.0 * @return DonationFormFactory */ public static function factory(): DonationFormFactory @@ -56,7 +56,7 @@ public static function factory(): DonationFormFactory /** * Find donation form by ID * - * @since 0.1.0 + * @since 3.0.0 * * @param int $id * @@ -68,7 +68,7 @@ public static function find($id) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param array $attributes * @@ -85,7 +85,7 @@ public static function create(array $attributes): DonationForm } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void * @@ -101,7 +101,7 @@ public function save() } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws Exception */ @@ -111,7 +111,7 @@ public function delete() } /** - * @since 0.1.0 + * @since 3.0.0 * * @return ModelQueryBuilder */ @@ -121,7 +121,7 @@ public static function query(): ModelQueryBuilder } /** - * @since 0.1.0 + * @since 3.0.0 * * @param object $object */ @@ -132,8 +132,8 @@ public static function fromQueryBuilderObject($object): DonationForm /** * - * @since 0.6.0 return DonationForm node; throw NameCollisionException - * @since 0.1.0 + * @since 3.0.0 return DonationForm node; throw NameCollisionException + * @since 3.0.0 * @throws NameCollisionException */ public function schema(): Form diff --git a/src/DonationForms/Properties/FormSettings.php b/src/DonationForms/Properties/FormSettings.php index 7fa3e3af1b..f56e8c3523 100644 --- a/src/DonationForms/Properties/FormSettings.php +++ b/src/DonationForms/Properties/FormSettings.php @@ -157,7 +157,7 @@ class FormSettings implements Arrayable, Jsonable public $offlineDonationsInstructions; /** - * @since 0.1.0 + * @since 3.0.0 */ public static function fromArray(array $array): self { @@ -221,7 +221,7 @@ public static function fromArray(array $array): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function fromJson(string $json): self { @@ -232,7 +232,7 @@ public static function fromJson(string $json): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { @@ -240,7 +240,7 @@ public function toArray(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toJson($options = 0): string { diff --git a/src/DonationForms/Repositories/DonationFormRepository.php b/src/DonationForms/Repositories/DonationFormRepository.php index 45396b39d9..81bac6b405 100644 --- a/src/DonationForms/Repositories/DonationFormRepository.php +++ b/src/DonationForms/Repositories/DonationFormRepository.php @@ -23,7 +23,7 @@ use Give\Log\Log; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationFormRepository { @@ -33,7 +33,7 @@ class DonationFormRepository private $paymentGatewayRegister; /** - * @since 0.1.0 + * @since 3.0.0 * * @var string[] */ @@ -44,7 +44,7 @@ class DonationFormRepository ]; /** - * @since 0.1.0 + * @since 3.0.0 * * @param PaymentGatewayRegister $paymentGatewayRegister */ @@ -56,7 +56,7 @@ public function __construct(PaymentGatewayRegister $paymentGatewayRegister) /** * Get Donation Form By ID * - * @since 0.1.0 + * @since 3.0.0 * * @return DonationForm|null */ @@ -69,7 +69,7 @@ public function getById(int $id) /** * - * @since 0.1.0 + * @since 3.0.0 * * @return void * @throws Exception|InvalidArgumentException @@ -145,7 +145,7 @@ public function insert(DonationForm $donationForm) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param DonationForm $donationForm * @@ -210,7 +210,7 @@ public function update(DonationForm $donationForm) } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws Exception */ @@ -244,7 +244,7 @@ public function delete(DonationForm $donationForm): bool } /** - * @since 0.1.0 + * @since 3.0.0 * * @param DonationForm $donationForm * @@ -260,7 +260,7 @@ private function validateProperties(DonationForm $donationForm) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return ModelQueryBuilder */ @@ -318,7 +318,7 @@ public function getEnabledPaymentGateways($formId): array } /** - * @since 0.4.0 + * @since 3.0.0 */ public function getDefaultEnabledGatewayId(int $formId): string { @@ -328,7 +328,7 @@ public function getDefaultEnabledGatewayId(int $formId): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getFormDataGateways(int $formId): array { @@ -355,7 +355,7 @@ public function getFormDataGateways(int $formId): array /** * - * @since 0.1.0 + * @since 3.0.0 */ public function getTotalNumberOfDonors(int $formId): int { @@ -371,7 +371,7 @@ public function getTotalNumberOfDonors(int $formId): int } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getTotalNumberOfDonations(int $formId): int { @@ -383,7 +383,7 @@ public function getTotalNumberOfDonations(int $formId): int } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getTotalRevenue(int $formId): int { @@ -401,9 +401,9 @@ public function getTotalRevenue(int $formId): int } /** - * @since 0.6.0 return DonationFormNode; throw NameCollisionException - * @since 0.4.0 append formId to first section instead of last with multistep in mind. - * @since 0.1.0 + * @since 3.0.0 return DonationFormNode; throw NameCollisionException + * @since 3.0.0 append formId to first section instead of last with multistep in mind. + * @since 3.0.0 * @throws NameCollisionException */ public function getFormSchemaFromBlocks(int $formId, BlockCollection $blocks): DonationFormNode @@ -443,7 +443,7 @@ function ($value, Closure $fail, string $key, array $values) use ($formId) { } /** - * @since 0.1.0 + * @since 3.0.0 */ public function isLegacyForm(int $formId): bool { @@ -455,7 +455,7 @@ public function isLegacyForm(int $formId): bool /** * Get gateway form settings and handle any exceptions. * - * @since 0.2.0 + * @since 3.0.0 */ private function getGatewayFormSettings(int $formId, PaymentGateway $gateway): array { diff --git a/src/DonationForms/Routes/AuthenticationRoute.php b/src/DonationForms/Routes/AuthenticationRoute.php index 9b66ab0d7d..e6124f1aab 100644 --- a/src/DonationForms/Routes/AuthenticationRoute.php +++ b/src/DonationForms/Routes/AuthenticationRoute.php @@ -9,14 +9,14 @@ use WP_User; /** - * @since 0.4.0 + * @since 3.0.0 */ class AuthenticationRoute { use HandleHttpResponses; /** - * @since 0.4.0 + * @since 3.0.0 * * @return void */ @@ -34,7 +34,7 @@ public function __invoke(array $request) } /** - * @since 0.4.0 + * @since 3.0.0 */ protected function authenticate(AuthenticationData $auth): WP_User { diff --git a/src/DonationForms/Routes/DonateRoute.php b/src/DonationForms/Routes/DonateRoute.php index fe6dbcde1e..6e0885b2da 100644 --- a/src/DonationForms/Routes/DonateRoute.php +++ b/src/DonationForms/Routes/DonateRoute.php @@ -13,7 +13,7 @@ use WP_Error; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonateRoute { @@ -25,7 +25,7 @@ class DonateRoute private $donateController; /** - * @since 0.1.0 + * @since 3.0.0 * * @param DonateController $donateController */ @@ -35,7 +35,7 @@ public function __construct(DonateController $donateController) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -71,7 +71,7 @@ public function __invoke(array $request) } /** - * @since 0.3.0 + * @since 3.0.0 */ private function logError( string $type, diff --git a/src/DonationForms/Routes/DonateRouteSignature.php b/src/DonationForms/Routes/DonateRouteSignature.php index 35de88cf8e..872f5c15b6 100644 --- a/src/DonationForms/Routes/DonateRouteSignature.php +++ b/src/DonationForms/Routes/DonateRouteSignature.php @@ -3,7 +3,7 @@ namespace Give\DonationForms\Routes; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonateRouteSignature { @@ -17,7 +17,7 @@ class DonateRouteSignature public $expiration; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(string $name, string $expiration = null) { @@ -27,7 +27,7 @@ public function __construct(string $name, string $expiration = null) /** - * @since 0.1.0 + * @since 3.0.0 */ private function generateSignatureString(string $name, string $expiration): string { @@ -35,7 +35,7 @@ private function generateSignatureString(string $name, string $expiration): stri } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -45,7 +45,7 @@ public function toString(): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -57,7 +57,7 @@ public function toHash(): string /** * Create expiration timestamp * - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -68,7 +68,7 @@ public function createExpirationTimestamp(): string /** - * @since 0.1.0 + * @since 3.0.0 */ public function isValid(string $suppliedSignature): bool { diff --git a/src/DonationForms/Routes/ValidationRoute.php b/src/DonationForms/Routes/ValidationRoute.php index 997aa73f4a..07d231578e 100644 --- a/src/DonationForms/Routes/ValidationRoute.php +++ b/src/DonationForms/Routes/ValidationRoute.php @@ -11,14 +11,14 @@ use WP_Error; /** - * @since 0.4.0 + * @since 3.0.0 */ class ValidationRoute { use HandleHttpResponses; /** - * @since 0.4.0 + * @since 3.0.0 */ public function __invoke(array $request): bool { @@ -45,7 +45,7 @@ public function __invoke(array $request): bool } /** - * @since 0.4.0 + * @since 3.0.0 */ private function logError( string $type, diff --git a/src/DonationForms/Rules/ArrayRule.php b/src/DonationForms/Rules/ArrayRule.php index eadb2629d4..2f5b99874a 100644 --- a/src/DonationForms/Rules/ArrayRule.php +++ b/src/DonationForms/Rules/ArrayRule.php @@ -19,7 +19,7 @@ public function __construct($useSanitizer = false) } /** - * @since 0.7.0 + * @since 3.0.0 */ public static function id(): string { @@ -27,7 +27,7 @@ public static function id(): string } /** - * @since 0.7.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -35,7 +35,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.7.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { @@ -45,7 +45,7 @@ public function __invoke($value, Closure $fail, string $key, array $values) } /** - * @since 0.7.0 + * @since 3.0.0 */ public function sanitize($value): string { @@ -53,7 +53,7 @@ public function sanitize($value): string } /** - * @since 0.7.0 + * @since 3.0.0 */ public function serializeOption() { diff --git a/src/DonationForms/Rules/AuthenticationRule.php b/src/DonationForms/Rules/AuthenticationRule.php index 9d262dc903..e2aff33b68 100644 --- a/src/DonationForms/Rules/AuthenticationRule.php +++ b/src/DonationForms/Rules/AuthenticationRule.php @@ -8,7 +8,7 @@ class AuthenticationRule implements ValidationRule { /** - * @since 0.2.0 + * @since 3.0.0 */ public static function id(): string { @@ -16,7 +16,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -24,7 +24,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/BillingAddressCityRule.php b/src/DonationForms/Rules/BillingAddressCityRule.php index 421b12b20f..c270791c69 100644 --- a/src/DonationForms/Rules/BillingAddressCityRule.php +++ b/src/DonationForms/Rules/BillingAddressCityRule.php @@ -6,12 +6,12 @@ use Give\Vendors\StellarWP\Validation\Contracts\ValidationRule; /** - * @since 0.5.0 + * @since 3.0.0 */ class BillingAddressCityRule implements ValidationRule { /** - * @since 0.5.0 + * @since 3.0.0 */ public static function id(): string { @@ -19,7 +19,7 @@ public static function id(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -27,7 +27,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.5.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/BillingAddressStateRule.php b/src/DonationForms/Rules/BillingAddressStateRule.php index 0b848f9161..c394f8ea9a 100644 --- a/src/DonationForms/Rules/BillingAddressStateRule.php +++ b/src/DonationForms/Rules/BillingAddressStateRule.php @@ -5,12 +5,12 @@ use Give\Vendors\StellarWP\Validation\Contracts\ValidationRule; /** - * @since 0.5.0 + * @since 3.0.0 */ class BillingAddressStateRule implements ValidationRule { /** - * @since 0.5.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -26,7 +26,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.5.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/BillingAddressZipRule.php b/src/DonationForms/Rules/BillingAddressZipRule.php index cb79b47637..88353207d8 100644 --- a/src/DonationForms/Rules/BillingAddressZipRule.php +++ b/src/DonationForms/Rules/BillingAddressZipRule.php @@ -6,12 +6,12 @@ use Give\Vendors\StellarWP\Validation\Contracts\ValidationRule; /** - * @since 0.5.0 + * @since 3.0.0 */ class BillingAddressZipRule implements ValidationRule { /** - * @since 0.5.0 + * @since 3.0.0 */ public static function id(): string { @@ -19,7 +19,7 @@ public static function id(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -27,7 +27,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.5.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/DonationTypeRule.php b/src/DonationForms/Rules/DonationTypeRule.php index 382ad13880..707e612389 100644 --- a/src/DonationForms/Rules/DonationTypeRule.php +++ b/src/DonationForms/Rules/DonationTypeRule.php @@ -11,7 +11,7 @@ class DonationTypeRule implements ValidationRule, ValidatesOnFrontEnd, Sanitizer { /** - * @since 0.2.0 + * @since 3.0.0 */ public static function id(): string { @@ -19,7 +19,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -27,7 +27,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { @@ -48,7 +48,7 @@ public function __invoke($value, Closure $fail, string $key, array $values) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function sanitize($value): DonationType { @@ -56,7 +56,7 @@ public function sanitize($value): DonationType } /** - * @since 0.3.0 + * @since 3.0.0 */ public function serializeOption() { diff --git a/src/DonationForms/Rules/GatewayRule.php b/src/DonationForms/Rules/GatewayRule.php index 81f9c54e9b..e28af19605 100644 --- a/src/DonationForms/Rules/GatewayRule.php +++ b/src/DonationForms/Rules/GatewayRule.php @@ -10,7 +10,7 @@ class GatewayRule implements ValidationRule, ValidatesOnFrontEnd { /** - * @since 0.4.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -26,7 +26,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.4.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { @@ -50,7 +50,7 @@ public function __invoke($value, Closure $fail, string $key, array $values) } /** - * @since 0.4.0 + * @since 3.0.0 */ public function serializeOption() { diff --git a/src/DonationForms/Rules/Max.php b/src/DonationForms/Rules/Max.php index 482a5c5b50..beb9d8b77e 100644 --- a/src/DonationForms/Rules/Max.php +++ b/src/DonationForms/Rules/Max.php @@ -10,7 +10,7 @@ class Max extends \Give\Vendors\StellarWP\Validation\Rules\Max { /** - * @since 0.2.0 + * @since 3.0.0 */ public function sanitize($value) { @@ -28,7 +28,7 @@ public function sanitize($value) /** * @inheritDoc * - * @since 0.2.0 + * @since 3.0.0 **/ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/Min.php b/src/DonationForms/Rules/Min.php index 3df7f1b75a..2669d2cce4 100644 --- a/src/DonationForms/Rules/Min.php +++ b/src/DonationForms/Rules/Min.php @@ -10,7 +10,7 @@ class Min extends \Give\Vendors\StellarWP\Validation\Rules\Min { /** - * @since 0.2.0 + * @since 3.0.0 */ public function sanitize($value) { @@ -28,7 +28,7 @@ public function sanitize($value) /** * @inheritDoc * - * @since 0.2.0 + * @since 3.0.0 **/ public function __invoke($value, Closure $fail, string $key, array $values) { diff --git a/src/DonationForms/Rules/Size.php b/src/DonationForms/Rules/Size.php index 93278b6df6..9a2cb2b15a 100644 --- a/src/DonationForms/Rules/Size.php +++ b/src/DonationForms/Rules/Size.php @@ -25,7 +25,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __construct($size) { @@ -50,7 +50,7 @@ public function sanitize($value) } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -62,7 +62,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { @@ -82,7 +82,7 @@ public function __invoke($value, Closure $fail, string $key, array $values) } /** - * @since 0.2.0 + * @since 3.0.0 * * @return numeric */ @@ -92,7 +92,7 @@ public function serializeOption() } /** - * @since 0.2.0 + * @since 3.0.0 * * @return numeric */ @@ -102,7 +102,7 @@ public function getSize() } /** - * @since 0.2.0 + * @since 3.0.0 * * @param numeric $size * diff --git a/src/DonationForms/Rules/SubscriptionFrequencyRule.php b/src/DonationForms/Rules/SubscriptionFrequencyRule.php index b0b75d31f1..f15ed84f05 100644 --- a/src/DonationForms/Rules/SubscriptionFrequencyRule.php +++ b/src/DonationForms/Rules/SubscriptionFrequencyRule.php @@ -10,7 +10,7 @@ class SubscriptionFrequencyRule implements ValidationRule, ValidatesOnFrontEnd { /** - * @since 0.2.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -26,7 +26,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values): bool { diff --git a/src/DonationForms/Rules/SubscriptionInstallmentsRule.php b/src/DonationForms/Rules/SubscriptionInstallmentsRule.php index 37193988be..8676a86abf 100644 --- a/src/DonationForms/Rules/SubscriptionInstallmentsRule.php +++ b/src/DonationForms/Rules/SubscriptionInstallmentsRule.php @@ -10,7 +10,7 @@ class SubscriptionInstallmentsRule implements ValidationRule, ValidatesOnFrontEn { /** - * @since 0.2.0 + * @since 3.0.0 */ public static function id(): string { @@ -18,7 +18,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -26,7 +26,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values): bool { diff --git a/src/DonationForms/Rules/SubscriptionPeriodRule.php b/src/DonationForms/Rules/SubscriptionPeriodRule.php index c198e6273c..e0b422b2cf 100644 --- a/src/DonationForms/Rules/SubscriptionPeriodRule.php +++ b/src/DonationForms/Rules/SubscriptionPeriodRule.php @@ -12,7 +12,7 @@ class SubscriptionPeriodRule implements ValidationRule, ValidatesOnFrontEnd, San { /** - * @since 0.2.0 + * @since 3.0.0 */ public static function id(): string { @@ -20,7 +20,7 @@ public static function id(): string } /** - * @since 0.2.0 + * @since 3.0.0 */ public static function fromString(string $options = null): ValidationRule { @@ -28,7 +28,7 @@ public static function fromString(string $options = null): ValidationRule } /** - * @since 0.2.0 + * @since 3.0.0 */ public function __invoke($value, Closure $fail, string $key, array $values) { @@ -50,7 +50,7 @@ public function __invoke($value, Closure $fail, string $key, array $values) } /** - * @since 0.3.0 + * @since 3.0.0 * @return SubscriptionPeriod|null */ public function sanitize($value) @@ -63,7 +63,7 @@ public function sanitize($value) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function serializeOption() { diff --git a/src/DonationForms/ServiceProvider.php b/src/DonationForms/ServiceProvider.php index 3d37567fbb..f2dd0be613 100644 --- a/src/DonationForms/ServiceProvider.php +++ b/src/DonationForms/ServiceProvider.php @@ -70,27 +70,27 @@ public function boot() } /** - * @since 0.1.0 + * @since 3.0.0 */ private function registerRoutes() { /** - * @since 0.1.0 + * @since 3.0.0 */ Route::post('donate', DonateRoute::class); /** - * @since 0.4.0 + * @since 3.0.0 */ Route::post('validate', ValidationRoute::class); /** - * @since 0.4.0 + * @since 3.0.0 */ Route::post('authenticate', AuthenticationRoute::class); /** - * @since 0.1.0 + * @since 3.0.0 */ Route::get('donation-form-view', static function (array $request) { $routeData = DonationFormViewRouteData::fromRequest($request); @@ -99,7 +99,7 @@ private function registerRoutes() }); /** - * @since 0.1.0 + * @since 3.0.0 */ Route::get('donation-confirmation-receipt-view', static function (array $request) { $routeData = DonationConfirmationReceiptViewRouteData::fromRequest($request); @@ -109,7 +109,7 @@ private function registerRoutes() /** - * @since 0.1.0 + * @since 3.0.0 */ Route::post('donation-form-view-preview', static function () { $requestData = (new SanitizeDonationFormPreviewRequest())($_REQUEST); @@ -120,7 +120,7 @@ private function registerRoutes() } /** - * @since 0.3.0 + * @since 3.0.0 */ private function dispatchDonateControllerListeners() { @@ -142,7 +142,7 @@ private function dispatchDonateControllerListeners() } /** - * @since 0.1.0 + * @since 3.0.0 */ private function registerFormDesigns() { @@ -161,7 +161,7 @@ private function registerFormDesigns() } /** - * @since 0.4.0 + * @since 3.0.0 */ protected function registerSingleFormPage() { @@ -169,7 +169,7 @@ protected function registerSingleFormPage() } /** - * @since 0.5.0 + * @since 3.0.0 */ protected function registerShortcodes() { diff --git a/src/DonationForms/Shortcodes/GiveFormShortcode.php b/src/DonationForms/Shortcodes/GiveFormShortcode.php index 592d851a4f..19ad33ad01 100644 --- a/src/DonationForms/Shortcodes/GiveFormShortcode.php +++ b/src/DonationForms/Shortcodes/GiveFormShortcode.php @@ -8,7 +8,7 @@ class GiveFormShortcode { /** - * @since 0.5.0 + * @since 3.0.0 */ public function __invoke(string $output, array $atts): string { diff --git a/src/DonationForms/ValueObjects/DonationFormMetaKeys.php b/src/DonationForms/ValueObjects/DonationFormMetaKeys.php index 9708e09cb8..9a4f375d80 100644 --- a/src/DonationForms/ValueObjects/DonationFormMetaKeys.php +++ b/src/DonationForms/ValueObjects/DonationFormMetaKeys.php @@ -6,7 +6,7 @@ use Give\Framework\Support\ValueObjects\EnumInteractsWithQueryBuilder; /** - * @since 0.1.0 + * @since 3.0.0 * * @method static DonationFormMetaKeys SETTINGS() * @method static DonationFormMetaKeys FIELDS() diff --git a/src/DonationForms/ValueObjects/DonationFormStatus.php b/src/DonationForms/ValueObjects/DonationFormStatus.php index 41196bc831..873883989e 100644 --- a/src/DonationForms/ValueObjects/DonationFormStatus.php +++ b/src/DonationForms/ValueObjects/DonationFormStatus.php @@ -5,7 +5,7 @@ use Give\Framework\Support\ValueObjects\Enum; /** - * @since 0.1.0 + * @since 3.0.0 * * @method static DonationFormStatus PUBLISHED() * @method static DonationFormStatus FUTURE() diff --git a/src/DonationForms/ValueObjects/GoalType.php b/src/DonationForms/ValueObjects/GoalType.php index 01b9973842..c99b9e75d8 100644 --- a/src/DonationForms/ValueObjects/GoalType.php +++ b/src/DonationForms/ValueObjects/GoalType.php @@ -5,7 +5,7 @@ use Give\Framework\Support\ValueObjects\Enum; /** - * @since 0.1.0 + * @since 3.0.0 * * @method static GoalType AMOUNT() * @method static GoalType DONATIONS() diff --git a/src/DonationForms/ValueObjects/RegistrationOptions.php b/src/DonationForms/ValueObjects/RegistrationOptions.php index 5876ce65c5..65917c2a18 100644 --- a/src/DonationForms/ValueObjects/RegistrationOptions.php +++ b/src/DonationForms/ValueObjects/RegistrationOptions.php @@ -5,7 +5,7 @@ use Give\Framework\Support\ValueObjects\Enum; /** - * @since 0.1.0 + * @since 3.0.0 * * @method static RegistrationOptions NONE() * @method static RegistrationOptions REGISTRATION() diff --git a/src/DonationForms/ViewModels/DonationConfirmationReceiptViewModel.php b/src/DonationForms/ViewModels/DonationConfirmationReceiptViewModel.php index c6d7e1ab3b..2da076e3c9 100644 --- a/src/DonationForms/ViewModels/DonationConfirmationReceiptViewModel.php +++ b/src/DonationForms/ViewModels/DonationConfirmationReceiptViewModel.php @@ -12,7 +12,7 @@ use Give\Framework\Support\Scripts\Concerns\HasScriptAssetFile; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationConfirmationReceiptViewModel { @@ -24,7 +24,7 @@ class DonationConfirmationReceiptViewModel public $donation; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(Donation $donation) { @@ -32,7 +32,7 @@ public function __construct(Donation $donation) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getDonationForm(): DonationForm { @@ -40,7 +40,7 @@ public function getDonationForm(): DonationForm } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getReceipt(): DonationReceipt { @@ -50,7 +50,7 @@ public function getReceipt(): DonationReceipt } /** - * @since 0.1.0 + * @since 3.0.0 */ public function exports(): array { @@ -60,7 +60,7 @@ public function exports(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function formExports(): array { @@ -82,7 +82,7 @@ public function formExports(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function render(): string { @@ -134,7 +134,7 @@ class="givewp-donation-confirmation-receipt" } /** - * @since 0.1.0 + * @since 3.0.0 */ public function enqueueGlobalStyles(string $primaryColor, string $secondaryColor) { @@ -162,7 +162,7 @@ public function enqueueGlobalStyles(string $primaryColor, string $secondaryColor /** * Loads scripts in order: [Registrars, Designs, App] * - * @since 0.1.0 + * @since 3.0.0 * * @return void */ diff --git a/src/DonationForms/ViewModels/DonationFormViewModel.php b/src/DonationForms/ViewModels/DonationFormViewModel.php index 05ace1ed4b..8b7d45d90d 100644 --- a/src/DonationForms/ViewModels/DonationFormViewModel.php +++ b/src/DonationForms/ViewModels/DonationFormViewModel.php @@ -17,7 +17,7 @@ use Give\Helpers\Hooks; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationFormViewModel { @@ -41,7 +41,7 @@ class DonationFormViewModel private $donationFormRepository; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct( int $donationFormId, @@ -55,7 +55,7 @@ public function __construct( } /** - * @since 0.1.0 + * @since 3.0.0 */ public function designId(): string { @@ -63,7 +63,7 @@ public function designId(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function primaryColor(): string { @@ -71,7 +71,7 @@ public function primaryColor(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function secondaryColor(): string { @@ -79,7 +79,7 @@ public function secondaryColor(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function enqueueGlobalStyles() { @@ -108,7 +108,7 @@ public function enqueueGlobalStyles() } /** - * @since 0.1.0 + * @since 3.0.0 */ private function goalType(): GoalType { @@ -116,7 +116,7 @@ private function goalType(): GoalType } /** - * @since 0.1.0 + * @since 3.0.0 */ private function formStatsData(): array { @@ -136,8 +136,8 @@ private function formStatsData(): array } /** - * @since 0.6.0 update form object data to use DonationForm Node - * @since 0.1.0 + * @since 3.0.0 update form object data to use DonationForm Node + * @since 3.0.0 */ public function exports(): array { @@ -188,7 +188,7 @@ public function exports(): array * 5. Finally, call the specific WP function wp_print_footer_scripts() * - This will only print the footer scripts that are enqueued within our route. * - * @since 0.1.0 + * @since 3.0.0 */ public function render(bool $preview = false): string { @@ -234,8 +234,8 @@ class="">
/** * Loads scripts in order: [Registrars, Designs, Gateways, Block] * - * @since 0.4.0 Add support for custom form extensions - * @since 0.1.0 + * @since 3.0.0 Add support for custom form extensions + * @since 3.0.0 * * @return void */ @@ -248,7 +248,7 @@ private function enqueueFormScripts(int $formId, string $formDesignId) } /** - * @since 0.4.0 + * @since 3.0.0 * * @return FormDesign|null */ @@ -261,7 +261,7 @@ protected function getFormDesign(string $designId) } /** - * @since 0.5.0 + * @since 3.0.0 */ private function enqueueRegistrars() { @@ -290,7 +290,7 @@ private function enqueueRegistrars() } /** - * @since 0.5.0 + * @since 3.0.0 */ private function enqueueGateways(int $formId) { @@ -306,7 +306,7 @@ private function enqueueGateways(int $formId) } /** - * @since 0.5.0 + * @since 3.0.0 */ private function enqueueDesign(string $formDesignId) { @@ -333,7 +333,7 @@ private function enqueueDesign(string $formDesignId) } /** - * @since 0.5.0 + * @since 3.0.0 */ private function enqueueFormApp() { diff --git a/src/DonationForms/resources/app/DonationFormApp.tsx b/src/DonationForms/resources/app/DonationFormApp.tsx index f3c21d776f..f6f4de1b59 100644 --- a/src/DonationForms/resources/app/DonationFormApp.tsx +++ b/src/DonationForms/resources/app/DonationFormApp.tsx @@ -41,8 +41,8 @@ const initialState = { const formSettings = {...form.settings, ...getDonationFormNodeSettings(form)}; /** - * @since 0.6.0 add DonationFormSettingsProvider - * @since 0.1.0 + * @since 3.0.0 add DonationFormSettingsProvider + * @since 3.0.0 */ function App() { if (form.goal.isAchieved) { diff --git a/src/DonationForms/resources/app/errors/FormRequestError.ts b/src/DonationForms/resources/app/errors/FormRequestError.ts index bd77f8e399..5ddba2ad54 100644 --- a/src/DonationForms/resources/app/errors/FormRequestError.ts +++ b/src/DonationForms/resources/app/errors/FormRequestError.ts @@ -2,7 +2,7 @@ * This Error adds a property of errors, * so we can catch a types error and loop through all the errors from the server. * - * @since 0.1.0 + * @since 3.0.0 */ class FormRequestError extends Error { public errors: Array; diff --git a/src/DonationForms/resources/app/fields/SectionNode.tsx b/src/DonationForms/resources/app/fields/SectionNode.tsx index 27875c5544..5edb346961 100644 --- a/src/DonationForms/resources/app/fields/SectionNode.tsx +++ b/src/DonationForms/resources/app/fields/SectionNode.tsx @@ -12,7 +12,7 @@ const formTemplates = window.givewp.form.templates; /** * Determine which node template to render * - * @since 0.1.0 + * @since 3.0.0 */ export default function SectionNode({node}: {node: Node}) { const showNode = useVisibilityCondition(node.visibilityConditions); diff --git a/src/DonationForms/resources/app/form/Header.tsx b/src/DonationForms/resources/app/form/Header.tsx index fdf598c419..c2b0ea33df 100644 --- a/src/DonationForms/resources/app/form/Header.tsx +++ b/src/DonationForms/resources/app/form/Header.tsx @@ -13,7 +13,7 @@ const HeaderDescriptionTemplate = withTemplateWrapper(formTemplates.layouts.head const GoalTemplate = withTemplateWrapper(formTemplates.layouts.goal); /** - * @since 0.1.0 + * @since 3.0.0 */ const formatGoalAmount = (amount: number) => { return amountFormatter(form.currency, { @@ -22,7 +22,7 @@ const formatGoalAmount = (amount: number) => { }; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function Header() { return ( diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/HeaderStep.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/HeaderStep.tsx index 8fb4570972..27c2a160e0 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/HeaderStep.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/HeaderStep.tsx @@ -4,7 +4,7 @@ import {setCurrentStep} from '@givewp/forms/app/form/MultiStepForm/store/reducer import {useDonationFormMultiStepStateDispatch} from '@givewp/forms/app/form/MultiStepForm/store'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function HeaderStep() { const dispatchMultiStep = useDonationFormMultiStepStateDispatch(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/NextButton.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/NextButton.tsx index 174b0b4487..4da9fbf449 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/NextButton.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/NextButton.tsx @@ -10,7 +10,7 @@ import useGetGatewayById from '@givewp/forms/app/form/MultiStepForm/hooks/useGet const {validateUrl} = getWindowData(); /** - * @since 0.4.0 + * @since 3.0.0 */ export default function NextButton() { const {steps, currentStep} = useDonationFormMultiStepState(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/PreviousButton.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/PreviousButton.tsx index acb8861775..6c759a67c9 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/PreviousButton.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/PreviousButton.tsx @@ -3,7 +3,7 @@ import {useDonationFormMultiStepState} from '@givewp/forms/app/form/MultiStepFor import {ReactNode} from 'react'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function PreviousButton({children}: {children: ReactNode}) { const {currentStep} = useDonationFormMultiStepState(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/StepForm.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/StepForm.tsx index a72f320521..6e4fc1f9f1 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/StepForm.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/StepForm.tsx @@ -16,7 +16,7 @@ const formTemplates = window.givewp.form.templates; const MultiStepFormTemplate = withTemplateWrapper(formTemplates.layouts.multiStepForm); /** - * @since 0.4.0 + * @since 3.0.0 */ export default function StepForm({ currentStep, diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/Steps.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/Steps.tsx index f06567505c..fab4fa49e7 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/Steps.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/Steps.tsx @@ -5,7 +5,7 @@ import classNames from "classnames"; import StepsWrapper from "@givewp/forms/app/form/MultiStepForm/components/StepsWrapper"; /** - * @since 0.4.0 + * @since 3.0.0 * * This loops through the steps and lazy loads them using a waterfall approach. * Only current and previous steps are rendered. Obviously all previous steps are hidden. diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/StepsPagination.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/StepsPagination.tsx index 6c8b4cbd4c..75e46ae4f5 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/StepsPagination.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/StepsPagination.tsx @@ -6,7 +6,7 @@ import {setCurrentStep} from '@givewp/forms/app/form/MultiStepForm/store/reducer import classNames from 'classnames'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function StepsPagination() { const {steps, currentStep} = useDonationFormMultiStepState(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/StepsWrapper.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/StepsWrapper.tsx index 373ece4341..3e3ba1b090 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/StepsWrapper.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/StepsWrapper.tsx @@ -5,7 +5,7 @@ import {__} from "@wordpress/i18n"; import useCurrentStep from "@givewp/forms/app/form/MultiStepForm/hooks/useCurrentStep"; /** - * @since 0.4.0 + * @since 3.0.0 */ function StepsWrapperTitle() { const step = useCurrentStep(); @@ -14,7 +14,7 @@ function StepsWrapperTitle() { } /** - * @since 0.4.0 + * @since 3.0.0 */ export default function StepsWrapper({children}: { children: ReactNode }) { return ( diff --git a/src/DonationForms/resources/app/form/MultiStepForm/components/SubmitButton.tsx b/src/DonationForms/resources/app/form/MultiStepForm/components/SubmitButton.tsx index 8c4d8663c8..1339e47a6c 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/components/SubmitButton.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/components/SubmitButton.tsx @@ -1,7 +1,7 @@ import {__} from '@wordpress/i18n'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function SubmitButton({ isSubmitting, diff --git a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useCurrentStep.ts b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useCurrentStep.ts index ac0681f02a..fdc440779e 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useCurrentStep.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useCurrentStep.ts @@ -3,7 +3,7 @@ import getCurrentStepObject from '@givewp/forms/app/form/MultiStepForm/utilities import {StepObject} from '@givewp/forms/app/form/MultiStepForm/types'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function useCurrentStep(): StepObject { const {steps, currentStep} = useDonationFormMultiStepState(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useGetGatewayById.ts b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useGetGatewayById.ts index c62a93b9a9..8e78f3b785 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useGetGatewayById.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useGetGatewayById.ts @@ -2,7 +2,7 @@ import {useCallback} from 'react'; import {useDonationFormState} from '@givewp/forms/app/store'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function useGetGatewayById() { const {gateways} = useDonationFormState(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/hooks/usePreviousValue.ts b/src/DonationForms/resources/app/form/MultiStepForm/hooks/usePreviousValue.ts index 103f1ea460..61a50fd4dd 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/hooks/usePreviousValue.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/hooks/usePreviousValue.ts @@ -1,7 +1,7 @@ import {useEffect, useRef} from '@wordpress/element'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function usePrevious(value: T): T { const ref: any = useRef(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetNextStep.ts b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetNextStep.ts index b36b63ead5..23999cf1dc 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetNextStep.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetNextStep.ts @@ -6,7 +6,7 @@ import {FieldValues} from 'react-hook-form'; import {useCallback} from 'react'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function useSetNextStep() { const dispatchForm = useDonationFormStateDispatch(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetPreviousStep.ts b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetPreviousStep.ts index bcef0ee35f..e122ee4aa4 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetPreviousStep.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/hooks/useSetPreviousStep.ts @@ -3,7 +3,7 @@ import {setCurrentStep} from '@givewp/forms/app/form/MultiStepForm/store/reducer import {useCallback} from 'react'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function useSetPreviousStep() { const dispatchMultiStep = useDonationFormMultiStepStateDispatch(); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/index.tsx b/src/DonationForms/resources/app/form/MultiStepForm/index.tsx index ded33491c7..47944cb4af 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/index.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/index.tsx @@ -13,7 +13,7 @@ import {DonationSummaryProvider} from '@givewp/forms/app/store/donation-summary' const FormSectionTemplate = withTemplateWrapper(window.givewp.form.templates.layouts.section, 'section'); /** - * @since 0.4.0 + * @since 3.0.0 */ const convertSectionsToSteps = (sections: Section[], hasFirstStep: boolean) => { const totalSteps = hasFirstStep ? sections.length + 1 : sections.length; @@ -53,7 +53,7 @@ const convertSectionsToSteps = (sections: Section[], hasFirstStep: boolean) => { }; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function MultiStepForm({sections, showHeader}: {sections: Section[]; showHeader?: boolean}) { const steps = convertSectionsToSteps(sections, showHeader); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/store/index.tsx b/src/DonationForms/resources/app/form/MultiStepForm/store/index.tsx index eada87ed66..ebb7f787f3 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/store/index.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/store/index.tsx @@ -19,7 +19,7 @@ type PropTypes = { }; /** - * @since 0.4.0 + * @since 3.0.0 */ const DonationFormMultiStepStateProvider = ({initialState, children}: PropTypes) => { const [state, dispatch] = useReducer(reducer, initialState); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/store/reducer.ts b/src/DonationForms/resources/app/form/MultiStepForm/store/reducer.ts index 5fc0d31d38..51aac236c2 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/store/reducer.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/store/reducer.ts @@ -7,7 +7,7 @@ const SET_NEXT_STEP = 'set_next_step'; type Action = {type: typeof SET_CURRENT_STEP; step: T} | {type: typeof SET_NEXT_STEP; formValues: T}; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function reducer(state: MultiStepFormContextState, action: Action) { switch (action.type) { @@ -41,7 +41,7 @@ export default function reducer(state: MultiStepFormContextState, action: Act } /** - * @since 0.4.0 + * @since 3.0.0 */ export function setCurrentStep(step: number) { return { diff --git a/src/DonationForms/resources/app/form/MultiStepForm/types/index.ts b/src/DonationForms/resources/app/form/MultiStepForm/types/index.ts index a1ecb532de..87b226e393 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/types/index.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/types/index.ts @@ -2,7 +2,7 @@ import type {ReactElement} from 'react'; import {Section} from '@givewp/forms/types'; /** - * @since 0.4.0 + * @since 3.0.0 */ export type FormInputs = { FORM_ERROR: string; @@ -14,7 +14,7 @@ export type FormInputs = { }; /** - * @since 0.4.0 + * @since 3.0.0 */ export type StepObject = { id: number; diff --git a/src/DonationForms/resources/app/form/MultiStepForm/utilities/getCurrentStepObject.ts b/src/DonationForms/resources/app/form/MultiStepForm/utilities/getCurrentStepObject.ts index 8f9f175b73..01e9f9851e 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/utilities/getCurrentStepObject.ts +++ b/src/DonationForms/resources/app/form/MultiStepForm/utilities/getCurrentStepObject.ts @@ -1,7 +1,7 @@ import {StepObject} from "@givewp/forms/app/form/MultiStepForm/types"; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function getCurrentStepObject(steps: StepObject[], currentStep: number) { return steps?.find(({id}) => id === currentStep); diff --git a/src/DonationForms/resources/app/form/MultiStepForm/utilities/getSectionFieldNames.tsx b/src/DonationForms/resources/app/form/MultiStepForm/utilities/getSectionFieldNames.tsx index 8f35c92793..b5b72bbb38 100644 --- a/src/DonationForms/resources/app/form/MultiStepForm/utilities/getSectionFieldNames.tsx +++ b/src/DonationForms/resources/app/form/MultiStepForm/utilities/getSectionFieldNames.tsx @@ -1,7 +1,7 @@ import {Field, isField, Section} from '@givewp/forms/types'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function getSectionFieldNames(section: Section) { return section.reduceNodes( diff --git a/src/DonationForms/resources/app/hooks/useCurrencyFormatter.ts b/src/DonationForms/resources/app/hooks/useCurrencyFormatter.ts index 3e67380672..54a7a364c1 100644 --- a/src/DonationForms/resources/app/hooks/useCurrencyFormatter.ts +++ b/src/DonationForms/resources/app/hooks/useCurrencyFormatter.ts @@ -2,7 +2,7 @@ import {useMemo} from 'react'; import amountFormatter from '@givewp/forms/app/utilities/amountFormatter'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function useCurrencyFormatter(currency: Intl.NumberFormatOptions['currency'], options?: Intl.NumberFormatOptions) { return useMemo(() => amountFormatter(currency, options), [currency, navigator.language]); diff --git a/src/DonationForms/resources/app/hooks/useDonationSummary.ts b/src/DonationForms/resources/app/hooks/useDonationSummary.ts index 21b87f6ddf..6770683263 100644 --- a/src/DonationForms/resources/app/hooks/useDonationSummary.ts +++ b/src/DonationForms/resources/app/hooks/useDonationSummary.ts @@ -12,7 +12,7 @@ import { import {useCallback} from '@wordpress/element'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function useDonationSummary() { const {items, totals} = useDonationSummaryContext(); diff --git a/src/DonationForms/resources/app/hooks/useVisibilityCondition.ts b/src/DonationForms/resources/app/hooks/useVisibilityCondition.ts index a436b53463..f6972d7116 100644 --- a/src/DonationForms/resources/app/hooks/useVisibilityCondition.ts +++ b/src/DonationForms/resources/app/hooks/useVisibilityCondition.ts @@ -9,7 +9,7 @@ type WatchedFields = Map; * Adds visibility conditions to a field. The given conditions are watched and the hook returns true or false based on * whether the conditions are met. * - * @since 0.4.0 + * @since 3.0.0 */ export default function useVisibilityCondition(conditions: FieldCondition[]): boolean { const watchedFieldNames = useMemo(() => { @@ -44,7 +44,7 @@ export default function useVisibilityCondition(conditions: FieldCondition[]): bo /** * Returns true or false based on whether the conditions are met. * - * @since 0.4.0 + * @since 3.0.0 */ export function visibliityConditionsPass(conditions: FieldCondition[], watchedFields: WatchedFields): boolean { if (!conditions.length) { @@ -73,7 +73,7 @@ export function visibliityConditionsPass(conditions: FieldCondition[], watchedFi /** * A recursive reducer that returns a set of fields that are being watched by the conditions. * - * @since 0.4.0 + * @since 3.0.0 */ function watchFieldsReducer(fields: Set, condition: FieldCondition) { if (condition.type === 'basic') { diff --git a/src/DonationForms/resources/app/store/donation-summary/index.tsx b/src/DonationForms/resources/app/store/donation-summary/index.tsx index 163174e928..b7d699e97e 100644 --- a/src/DonationForms/resources/app/store/donation-summary/index.tsx +++ b/src/DonationForms/resources/app/store/donation-summary/index.tsx @@ -12,7 +12,7 @@ export type DonationTotals = {[key: string]: number}; export type DonationSummaryItems = {[key: string]: DonationSummaryLineItem}; /** - * @since 0.4.0 + * @since 3.0.0 */ export type DonationSummaryLineItem = { id: string; @@ -30,7 +30,7 @@ type PropTypes = { }; /** - * @since 0.4.0 + * @since 3.0.0 */ const DonationSummaryProvider = ({initialState = {items: {}, totals: {}}, children}: PropTypes) => { const [state, dispatch] = useImmerReducer(reducer, initialState); diff --git a/src/DonationForms/resources/app/store/donation-summary/reducer.ts b/src/DonationForms/resources/app/store/donation-summary/reducer.ts index e01c22f41e..dd475709b7 100644 --- a/src/DonationForms/resources/app/store/donation-summary/reducer.ts +++ b/src/DonationForms/resources/app/store/donation-summary/reducer.ts @@ -6,7 +6,7 @@ const ADD_AMOUNT_TO_TOTAL = 'add_amount_to_total'; const REMOVE_AMOUNT_FROM_TOTAL = 'remove_amount_from_total'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function reducer(draft, action) { switch (action.type) { @@ -31,7 +31,7 @@ export default function reducer(draft, action) { } /** - * @since 0.4.0 + * @since 3.0.0 */ export function addItem(item: DonationSummaryLineItem) { return { @@ -41,7 +41,7 @@ export function addItem(item: DonationSummaryLineItem) { } /** - * @since 0.4.0 + * @since 3.0.0 */ export function addAmountToTotal(itemId: string, amount: number) { return { @@ -52,7 +52,7 @@ export function addAmountToTotal(itemId: string, amount: number) { } /** - * @since 0.4.0 + * @since 3.0.0 */ export function removeAmountFromTotal(itemId: string) { return { @@ -62,7 +62,7 @@ export function removeAmountFromTotal(itemId: string) { } /** - * @since 0.4.0 + * @since 3.0.0 */ export function removeItem(itemId: string) { return { diff --git a/src/DonationForms/resources/app/store/form-settings/index.tsx b/src/DonationForms/resources/app/store/form-settings/index.tsx index 67383ddb4e..f0f02751c1 100644 --- a/src/DonationForms/resources/app/store/form-settings/index.tsx +++ b/src/DonationForms/resources/app/store/form-settings/index.tsx @@ -14,7 +14,7 @@ type PropTypes = { }; /** - * @since 0.6.0 + * @since 3.0.0 */ const DonationFormSettingsProvider = ({value, children}: PropTypes) => { return ( diff --git a/src/DonationForms/resources/app/store/index.tsx b/src/DonationForms/resources/app/store/index.tsx index 24de1dadc1..62520a683e 100644 --- a/src/DonationForms/resources/app/store/index.tsx +++ b/src/DonationForms/resources/app/store/index.tsx @@ -19,7 +19,7 @@ type PropTypes = { }; /** - * @since 0.4.0 + * @since 3.0.0 */ const DonationFormStateProvider = ({initialState, children}: PropTypes) => { const [state, dispatch] = useReducer(reducer, initialState); diff --git a/src/DonationForms/resources/app/store/reducer.ts b/src/DonationForms/resources/app/store/reducer.ts index 4502212d2a..05cf82f468 100644 --- a/src/DonationForms/resources/app/store/reducer.ts +++ b/src/DonationForms/resources/app/store/reducer.ts @@ -1,7 +1,7 @@ const UPDATE_DEFAULT_VALUES = 'update_default_values'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function reducer(state, action) { switch (action.type) { @@ -20,7 +20,7 @@ export default function reducer(state, action) { } /** - * @since 0.4.0 + * @since 3.0.0 */ export function setFormDefaultValues(values: object) { return { diff --git a/src/DonationForms/resources/app/templates/index.tsx b/src/DonationForms/resources/app/templates/index.tsx index 8cfe0a1ef6..b5e604afb6 100644 --- a/src/DonationForms/resources/app/templates/index.tsx +++ b/src/DonationForms/resources/app/templates/index.tsx @@ -5,21 +5,21 @@ import {Element, Field, Group} from '@givewp/forms/types'; /** * Get the active template from the window * - * @since 0.1.0 + * @since 3.0.0 */ const template = window.givewp.form.templates /** * Get the NodeWrapper from active template * - * @since 0.1.0 + * @since 3.0.0 */ const NodeWrapper = template.layouts.wrapper; /** * Find the names of nodeType and type based on the value of the template. * - * @since 0.1.0 + * @since 3.0.0 */ export function findTemplateKeys( templateValue: ReactNode @@ -46,7 +46,7 @@ export function findTemplateKeys( Template: FC, @@ -66,7 +66,7 @@ export function withTemplateWrapper( /** * A component version of withTemplateWrapper that uses the child component to determine the NodeWrapper props. * - * @since 0.1.0 + * @since 3.0.0 */ export function TemplateWrapper({children, htmlTag}: {children: JSX.Element; htmlTag?: keyof JSX.IntrinsicElements}) { const {nodeType, type} = useMemo(() => findTemplateKeys(children.type), []); @@ -81,7 +81,7 @@ export function TemplateWrapper({children, htmlTag}: {children: JSX.Element; htm /** * A hook version of withTemplateWrapper * - * @since 0.1.0 + * @since 3.0.0 */ export function useTemplateWrapper( Template: FC, @@ -92,21 +92,21 @@ export function useTemplateWrapper( } /** - * @since 0.1.0 + * @since 3.0.0 */ export function fieldTemplateExists(field: Field): boolean { return template.fields.hasOwnProperty(field.type); } /** - * @since 0.1.0 + * @since 3.0.0 */ export function elementTemplateExists(element: Element): boolean { return template.elements.hasOwnProperty(element.type); } /** - * @since 0.1.0 + * @since 3.0.0 */ export function groupTemplateExists(group: Group): boolean { return template.groups.hasOwnProperty(group.type); diff --git a/src/DonationForms/resources/app/utilities/ConvertFieldAPIRulesToJoi.ts b/src/DonationForms/resources/app/utilities/ConvertFieldAPIRulesToJoi.ts index b453c09245..f7565ef1cb 100644 --- a/src/DonationForms/resources/app/utilities/ConvertFieldAPIRulesToJoi.ts +++ b/src/DonationForms/resources/app/utilities/ConvertFieldAPIRulesToJoi.ts @@ -4,7 +4,7 @@ import {__, sprintf} from '@wordpress/i18n'; import conditionOperatorFunctions from '@givewp/forms/app/utilities/conditionOperatorFunctions'; /** - * @since 0.1.0 + * @since 3.0.0 */ const requiredMessage = sprintf( /* translators: base error message */ @@ -13,7 +13,7 @@ const requiredMessage = sprintf( ); /** - * @since 0.1.0 + * @since 3.0.0 */ export default function getJoiRulesForForm(form: Form): ObjectSchema { const joiRules = form.reduceNodes( @@ -33,7 +33,7 @@ export default function getJoiRulesForForm(form: Form): ObjectSchema { } /** - * @since 0.1.0 + * @since 3.0.0 */ function getJoiRulesForField(field: Field): AnySchema { let rules: AnySchema = convertFieldAPIRulesToJoi(field.validationRules); @@ -46,8 +46,8 @@ function getJoiRulesForField(field: Field): AnySchema { } /** - * @since 0.4.0 add support for excludeUnless rule with basic conditions; do not validate fields with no rules - * @since 0.1.0 + * @since 3.0.0 add support for excludeUnless rule with basic conditions; do not validate fields with no rules + * @since 3.0.0 */ function convertFieldAPIRulesToJoi(rules): AnySchema { let joiRules; @@ -133,7 +133,7 @@ function convertFieldAPIRulesToJoi(rules): AnySchema { } /** - * @since 0.2.0 + * @since 3.0.0 */ function getJoiRulesForAmountField(rules, joiRules): AnySchema { if (rules.hasOwnProperty('donationType')) { diff --git a/src/DonationForms/resources/app/utilities/PrepareFormData.ts b/src/DonationForms/resources/app/utilities/PrepareFormData.ts index 73c5beecd6..785149ac28 100644 --- a/src/DonationForms/resources/app/utilities/PrepareFormData.ts +++ b/src/DonationForms/resources/app/utilities/PrepareFormData.ts @@ -4,7 +4,7 @@ import {mapGroup, reduceGroup, walkGroup} from './groups'; /** * Receives the form data as provided directly from the server and mutates it to be ready for use by the React application * - * @since 0.1.0 + * @since 3.0.0 */ export default function prepareFormData(form: Form) { form.walkNodes = walkGroupNodes.bind(form); diff --git a/src/DonationForms/resources/app/utilities/amountFormatter.ts b/src/DonationForms/resources/app/utilities/amountFormatter.ts index 03601aadd1..f780e56208 100644 --- a/src/DonationForms/resources/app/utilities/amountFormatter.ts +++ b/src/DonationForms/resources/app/utilities/amountFormatter.ts @@ -3,7 +3,7 @@ export interface AmountFormatter { options?: Intl.NumberFormatOptions } /** - * @since 0.1.0 + * @since 3.0.0 */ export default function amountFormatter(currency: Intl.NumberFormatOptions['currency'], options?: Intl.NumberFormatOptions): Intl.NumberFormat { return new Intl.NumberFormat(navigator.language, { diff --git a/src/DonationForms/resources/app/utilities/buildRegisterValidationOptions.ts b/src/DonationForms/resources/app/utilities/buildRegisterValidationOptions.ts index 293b44a0ca..83e7939435 100644 --- a/src/DonationForms/resources/app/utilities/buildRegisterValidationOptions.ts +++ b/src/DonationForms/resources/app/utilities/buildRegisterValidationOptions.ts @@ -1,7 +1,7 @@ /** * Builds the expected registration options from the Field API validation rules * - * @since 0.1.0 + * @since 3.0.0 */ import {RegisterOptions} from 'react-hook-form'; diff --git a/src/DonationForms/resources/app/utilities/conditionOperatorFunctions.js b/src/DonationForms/resources/app/utilities/conditionOperatorFunctions.js index fbd7ee0013..db1640540f 100644 --- a/src/DonationForms/resources/app/utilities/conditionOperatorFunctions.js +++ b/src/DonationForms/resources/app/utilities/conditionOperatorFunctions.js @@ -1,7 +1,7 @@ /** * An object of functions for checking whether simple conditions are met. * - * @since 0.4.0 + * @since 3.0.0 */ const operatorFunctions = { '=': (a, b) => a == b, diff --git a/src/DonationForms/resources/app/utilities/convertValuesToFormData.ts b/src/DonationForms/resources/app/utilities/convertValuesToFormData.ts index 68722dfabf..794b53874e 100644 --- a/src/DonationForms/resources/app/utilities/convertValuesToFormData.ts +++ b/src/DonationForms/resources/app/utilities/convertValuesToFormData.ts @@ -1,5 +1,5 @@ /** - * @since 0.6.0 + * @since 3.0.0 */ export default function convertValuesToFormData(values: object): FormData { const formData = new FormData(); diff --git a/src/DonationForms/resources/app/utilities/getDefaultValuesFromSections.ts b/src/DonationForms/resources/app/utilities/getDefaultValuesFromSections.ts index e339af3ec3..8494a00c5d 100644 --- a/src/DonationForms/resources/app/utilities/getDefaultValuesFromSections.ts +++ b/src/DonationForms/resources/app/utilities/getDefaultValuesFromSections.ts @@ -1,7 +1,7 @@ /** * Returns default values from an array of field collection objects * - * @since 0.1.0 + * @since 3.0.0 * * @param sections * @return {*} diff --git a/src/DonationForms/resources/app/utilities/groups.ts b/src/DonationForms/resources/app/utilities/groups.ts index 384fc3167d..13c8ec44aa 100644 --- a/src/DonationForms/resources/app/utilities/groups.ts +++ b/src/DonationForms/resources/app/utilities/groups.ts @@ -3,7 +3,7 @@ import {Field, Group, isField, isGroup, Node} from '@givewp/forms/types'; /** * Finds the first node with a given name within a collection of nodes * - * @since 0.1.0 + * @since 3.0.0 */ export function findNode(name: string, nodes: Node[]): Node { let node; @@ -27,7 +27,7 @@ export function findNode(name: string, nodes: Node[]): Node { * Walks through a group's nodes and calls a callback for each node. If a filter is provided the callback only fires for * nodes which pass the filter. * - * @since 0.1.0 + * @since 3.0.0 */ export function walkGroup(group: Group, callback: (node: Node) => void, filter?: (node: Node) => boolean) { walkNodes(group.nodes, callback, filter); @@ -37,7 +37,7 @@ export function walkGroup(group: Group, callback: (node: Node) => void, filter?: * Maps through a Group's nodes and calls a callback for each node. If a filter is provided the callback only fires for * passing nodes. * - * @since 0.1.0 + * @since 3.0.0 */ export function mapGroup(group: Group, callback: (node: Node) => unknown, filter?: (node: Node) => boolean) { return mapNodes(group.nodes, callback, filter); @@ -45,7 +45,7 @@ export function mapGroup(group: Group, callback: (node: Node) => unknown, filter /** * Reduces a Group's nodes into a single value. If a filter is provided the callback only fires for passing nodes. - * @since 0.1.0 + * @since 3.0.0 */ export function reduceGroup( group: Group, @@ -59,7 +59,7 @@ export function reduceGroup( /** * Walks through a collection of nodes and calls a callback for each node. If a filter is provided the callback only fires for passing nodes. * - * @since 0.1.0 + * @since 3.0.0 */ export function walkNodes(nodes: Node[], callback: (node: Node) => void, filter?: (node: Node) => boolean) { nodes.forEach((node) => { @@ -77,7 +77,7 @@ export function walkNodes(nodes: Node[], callback: (node: Node) => void, filter? * Maps a collection of nodes to a new array of values. If a filter is provided the callback only fires for nodes which * pass. * - * @since 0.1.0 + * @since 3.0.0 */ export function mapNodes( nodes: Node[], @@ -100,7 +100,7 @@ export function mapNodes( /** * Reduces an array of nodes to a single value. If the filter is provided, only nodes which pass the filter will be used. * - * @since 0.1.0 + * @since 3.0.0 */ export function reduceNodes( nodes: Node[], @@ -124,7 +124,7 @@ export function reduceNodes( /** * Walks through an array of nodes, limited by fields, and calls a callback for each field. * - * @since 0.1.0 + * @since 3.0.0 */ export function walkFields(nodes: Node[], callback: (field: Field) => void) { walkNodes(nodes, callback, isField); @@ -133,7 +133,7 @@ export function walkFields(nodes: Node[], callback: (field: Field) => void) { /** * Reduces an array of nodes, limited by its fields, into a single value. * - * @since 0.1.0 + * @since 3.0.0 */ export function reduceFields( nodes: Parameters[0], diff --git a/src/DonationForms/resources/app/utilities/handleValidationRequest.ts b/src/DonationForms/resources/app/utilities/handleValidationRequest.ts index 1b38f9737d..3866958100 100644 --- a/src/DonationForms/resources/app/utilities/handleValidationRequest.ts +++ b/src/DonationForms/resources/app/utilities/handleValidationRequest.ts @@ -8,7 +8,7 @@ import postFormData from '@givewp/forms/app/utilities/postFormData'; import convertValuesToFormData from '@givewp/forms/app/utilities/convertValuesToFormData'; /** - * @since 0.4.0 + * @since 3.0.0 */ export default async function handleValidationRequest( validateUrl: string, diff --git a/src/DonationForms/resources/app/utilities/isRouteInlineRedirect.ts b/src/DonationForms/resources/app/utilities/isRouteInlineRedirect.ts index 59b4ca8442..cf96562b50 100644 --- a/src/DonationForms/resources/app/utilities/isRouteInlineRedirect.ts +++ b/src/DonationForms/resources/app/utilities/isRouteInlineRedirect.ts @@ -1,5 +1,5 @@ /** - * @since 0.1.0 + * @since 3.0.0 */ export default function isRouteInlineRedirect(redirectUrlParams: URLSearchParams, routes: string[]): boolean { return redirectUrlParams.has('givewp-route') && routes.includes(redirectUrlParams.get('givewp-route')); diff --git a/src/DonationForms/resources/app/utilities/mountWindowData.ts b/src/DonationForms/resources/app/utilities/mountWindowData.ts index 52bf72ad25..030959c642 100644 --- a/src/DonationForms/resources/app/utilities/mountWindowData.ts +++ b/src/DonationForms/resources/app/utilities/mountWindowData.ts @@ -7,8 +7,8 @@ import {useDonationFormSettings} from '@givewp/forms/app/store/form-settings'; * * This mounts data to the window object, so it can be accessed by form designs and add-ons * - * @since 0.4.0 add useDonationSummary - * @since 0.1.0 + * @since 3.0.0 add useDonationSummary + * @since 3.0.0 */ export default function mountWindowData(): void { window.givewp.form.hooks = { diff --git a/src/DonationForms/resources/app/utilities/postData.ts b/src/DonationForms/resources/app/utilities/postData.ts index 2720929025..f8bfd8be8b 100644 --- a/src/DonationForms/resources/app/utilities/postData.ts +++ b/src/DonationForms/resources/app/utilities/postData.ts @@ -1,5 +1,5 @@ /** - * @since 0.1.0 + * @since 3.0.0 * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#supplying_request_options */ export default async function postData(url: string, data: object = {}) { diff --git a/src/DonationForms/resources/app/utilities/postFormData.ts b/src/DonationForms/resources/app/utilities/postFormData.ts index 3e5e4844e2..942b488801 100644 --- a/src/DonationForms/resources/app/utilities/postFormData.ts +++ b/src/DonationForms/resources/app/utilities/postFormData.ts @@ -1,5 +1,5 @@ /** - * @since 0.6.0 + * @since 3.0.0 * * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#supplying_request_options */ diff --git a/src/DonationForms/resources/receipt/DonationConfirmationReceiptApp.tsx b/src/DonationForms/resources/receipt/DonationConfirmationReceiptApp.tsx index f200974c28..c452c9886c 100644 --- a/src/DonationForms/resources/receipt/DonationConfirmationReceiptApp.tsx +++ b/src/DonationForms/resources/receipt/DonationConfirmationReceiptApp.tsx @@ -14,7 +14,7 @@ const {receipt} = window.givewpDonationConfirmationReceiptExports; /** * This function is used to format the amount value. It also handles cased when there are additional details within the string. For example "$25.00 / month" * - * @since 0.3.0 + * @since 3.0.0 */ const getAmountFormatted = (value) => { const amount = parseFloat(value); @@ -31,7 +31,7 @@ const getAmountFormatted = (value) => { /** * Return readable value * - * @since 0.1.0 + * @since 3.0.0 */ const getDetailValue = (value) => { if (typeof value === 'string') { @@ -48,7 +48,7 @@ const getDetailValue = (value) => { /** * Prepare detail values before render * - * @since 0.1.0 + * @since 3.0.0 */ const prepareDetails = (details: ReceiptDetail[]) => { return details?.map(({label, value}) => ({ @@ -59,7 +59,7 @@ const prepareDetails = (details: ReceiptDetail[]) => { /** * - * @since 0.1.0 + * @since 3.0.0 */ function DonationConfirmationReceiptApp() { return ( diff --git a/src/DonationForms/resources/registrars/gateways/index.ts b/src/DonationForms/resources/registrars/gateways/index.ts index cfc6409c32..938d15b7db 100644 --- a/src/DonationForms/resources/registrars/gateways/index.ts +++ b/src/DonationForms/resources/registrars/gateways/index.ts @@ -3,7 +3,7 @@ import {Gateway, RegisteredGateway} from '@givewp/forms/types'; const {registeredGateways} = window.givewpDonationFormExports; /** - * @since 0.1.0 + * @since 3.0.0 */ interface GatewayRegistrar { register(gateway: Gateway): void; @@ -14,30 +14,30 @@ interface GatewayRegistrar { } /** - * @since 0.1.0 + * @since 3.0.0 */ export default class Registrar implements GatewayRegistrar { /** - * @since 0.1.0 + * @since 3.0.0 */ private gateways: Gateway[] = []; /** - * @since 0.1.0 + * @since 3.0.0 */ public get(id: string): Gateway | undefined { return this.gateways.find((gateway) => gateway.id === id); } /** - * @since 0.1.0 + * @since 3.0.0 */ public getAll(): Gateway[] { return this.gateways; } /** - * @since 0.1.0 + * @since 3.0.0 */ public register(gateway: Gateway): void { const registeredGateway = registeredGateways?.find(({id}) => id === gateway.id); @@ -61,7 +61,7 @@ export default class Registrar implements GatewayRegistrar { } /** - * @since 0.3.0 + * @since 3.0.0 */ private mapRegisteredGatewayToClientGateway(registeredGateway: RegisteredGateway, clientGateway: Gateway): void { for (const [key, value] of Object.entries(registeredGateway)) { diff --git a/src/DonationForms/resources/registrars/templates/elements/DonationSummary.tsx b/src/DonationForms/resources/registrars/templates/elements/DonationSummary.tsx index 79acc83959..679eef7abf 100644 --- a/src/DonationForms/resources/registrars/templates/elements/DonationSummary.tsx +++ b/src/DonationForms/resources/registrars/templates/elements/DonationSummary.tsx @@ -4,7 +4,7 @@ import {isSubscriptionPeriod, SubscriptionPeriod} from '../groups/DonationAmount import {createInterpolateElement} from '@wordpress/element'; /** - * @since 0.4.0 + * @since 3.0.0 */ const getDonationTotal = (totals: any, amount: any) => Number( @@ -18,7 +18,7 @@ const getDonationTotal = (totals: any, amount: any) => /** * @since 0.3.3 update subscription frequency label - * @since 0.1.0 + * @since 3.0.0 */ export default function DonationSummary() { const DonationSummaryItemsTemplate = window.givewp.form.templates.layouts.donationSummaryItems; diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/CurrencySwitcher.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/CurrencySwitcher.tsx index 0ff421a875..10213a7e53 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/CurrencySwitcher.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/CurrencySwitcher.tsx @@ -3,7 +3,7 @@ import {ChangeEvent, useMemo} from 'react'; import amountFormatter from '@givewp/forms/app/utilities/amountFormatter'; /** - * @since 0.6.0 + * @since 3.0.0 */ const convertCurrencySettingsToOptions = (currencySettings: CurrencySwitcherSetting[]): CurrencyOption[] => { return currencySettings.map(({id}) => { @@ -18,7 +18,7 @@ const convertCurrencySettingsToOptions = (currencySettings: CurrencySwitcherSett }; /** - * @since 0.6.0 + * @since 3.0.0 */ export type CurrencyOption = { id: string; @@ -28,7 +28,7 @@ export type CurrencyOption = { /** * Find the currency setting by currency id * - * @since 0.6.0 + * @since 3.0.0 */ export const getCurrencySetting = ( currency: string, @@ -38,14 +38,14 @@ export const getCurrencySetting = ( }; /** - * @since 0.6.0 + * @since 3.0.0 */ export const isBaseCurrency = (currencySetting: CurrencySwitcherSetting) => currencySetting.exchangeRate === 0; /** * Calculate the amount based on the currency exchange rate, taking into account the from and to currency values * - * @since 0.6.0 + * @since 3.0.0 */ export const calculateCurrencyAmount = ( amount: number, @@ -71,7 +71,7 @@ export const calculateCurrencyAmount = ( }; /** - * @since 0.6.0 + * @since 3.0.0 */ type CurrencySwitcherProps = { defaultCurrency: string; @@ -82,7 +82,7 @@ type CurrencySwitcherProps = { /** * The currency select and static component * - * @since 0.6.0 + * @since 3.0.0 */ function CurrencySwitcher({defaultCurrency, currencySettings, onSelect}: CurrencySwitcherProps) { const currencyOptions = useMemo( diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/CustomAmount.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/CustomAmount.tsx index b98b92f0ed..47e3b0f2b5 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/CustomAmount.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/CustomAmount.tsx @@ -3,8 +3,8 @@ import {__} from '@wordpress/i18n'; import CurrencyInput from 'react-currency-input-field'; /** - * @since 0.6.0 add value prop - * @since 0.2.0 + * @since 3.0.0 add value prop + * @since 3.0.0 */ type CustomAmountProps = { fieldError?: string; @@ -16,8 +16,8 @@ type CustomAmountProps = { }; /** - * @since 0.6.0 remove forwardRef and use state for value instead - * @since 0.2.0 + * @since 3.0.0 remove forwardRef and use state for value instead + * @since 3.0.0 */ const CustomAmount = ( {defaultValue, fieldError, currency, value, onValueChange}: CustomAmountProps diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountCurrency.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountCurrency.tsx index 3db92ca464..4227dcfc9f 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountCurrency.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountCurrency.tsx @@ -2,7 +2,7 @@ import {CurrencySwitcherSetting} from '@givewp/forms/types'; import CurrencySwitcher, {calculateCurrencyAmount} from './CurrencySwitcher'; /** - * @since 0.6.0 + * @since 3.0.0 */ export default function DonationAmountCurrency({currencySettings, onCurrencyAmountChange}: { currencySettings: CurrencySwitcherSetting[], diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountLevels.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountLevels.tsx index 6cbddc1a14..c8e3686c3e 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountLevels.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/DonationAmountLevels.tsx @@ -1,7 +1,7 @@ import classNames from 'classnames'; /** - * @since 0.2.0 + * @since 3.0.0 */ type DonationAmountLevelsProps = { name: string; @@ -11,8 +11,8 @@ type DonationAmountLevelsProps = { }; /** - * @since 0.6.0 rename to DonationAmountLevels - * @since 0.2.0 + * @since 3.0.0 rename to DonationAmountLevels + * @since 3.0.0 */ export default function DonationAmountLevels({ name, diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/getAmountLevelsWithCurrencySettings.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/getAmountLevelsWithCurrencySettings.tsx index f396f577ec..ff72fbf523 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/getAmountLevelsWithCurrencySettings.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/getAmountLevelsWithCurrencySettings.tsx @@ -4,7 +4,7 @@ import {isBaseCurrency} from './CurrencySwitcher'; /** * Convert level amounts to the selected currency and fallback to original values if no currency setting is found or exchange rate is 0. * - * @since 0.6.0 + * @since 3.0.0 */ export default function getAmountLevelsWithCurrencySettings( levels: number[], diff --git a/src/DonationForms/resources/registrars/templates/fields/Amount/index.tsx b/src/DonationForms/resources/registrars/templates/fields/Amount/index.tsx index 2b3544475b..980a6201ed 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Amount/index.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Amount/index.tsx @@ -7,9 +7,9 @@ import DonationAmountCurrency from './DonationAmountCurrency'; import DonationAmountLevels from './DonationAmountLevels'; /** - * @since 0.6.0 add currency settings - * @since 0.2.0 add display options for multi levels, fixed amount, and custom amount - * @since 0.1.0 + * @since 3.0.0 add currency settings + * @since 3.0.0 add display options for multi levels, fixed amount, and custom amount + * @since 3.0.0 */ export default function Amount({ name, diff --git a/src/DonationForms/resources/registrars/templates/fields/Checkbox.tsx b/src/DonationForms/resources/registrars/templates/fields/Checkbox.tsx index c00259d4b0..cd9c87e9b0 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Checkbox.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Checkbox.tsx @@ -1,8 +1,8 @@ import type {CheckboxProps} from '@givewp/forms/propTypes'; /** - * @since 0.7.0 added helpText - * @since 0.4.0 + * @since 3.0.0 added helpText + * @since 3.0.0 */ export default function Checkbox({Label, ErrorMessage, value, helpText, fieldError, inputProps}: CheckboxProps) { return ( diff --git a/src/DonationForms/resources/registrars/templates/fields/Gateways.tsx b/src/DonationForms/resources/registrars/templates/fields/Gateways.tsx index bac055bf45..bf43bcfbcc 100644 --- a/src/DonationForms/resources/registrars/templates/fields/Gateways.tsx +++ b/src/DonationForms/resources/registrars/templates/fields/Gateways.tsx @@ -6,7 +6,7 @@ import {useEffect, useMemo} from 'react'; import {createInterpolateElement} from '@wordpress/element'; /** - * @since 0.6.0 + * @since 3.0.0 */ function GatewayMissingMessage({currencyNotSupported}: {currencyNotSupported?: boolean}) { return ( @@ -25,7 +25,7 @@ function GatewayMissingMessage({currencyNotSupported}: {currencyNotSupported?: b } /** - * @since 0.1.0 + * @since 3.0.0 */ function GatewayFieldsErrorFallback({error, resetErrorBoundary}) { return ( @@ -45,7 +45,7 @@ function GatewayFieldsErrorFallback({error, resetErrorBoundary}) { } /** - * @since 0.6.0 + * @since 3.0.0 */ const TestModeNotice = () => { return ( @@ -74,8 +74,8 @@ const TestModeNotice = () => { }; /** - * @since 0.6.0 update to support currency switcher settings and test mode notice - * @since 0.1.0 + * @since 3.0.0 update to support currency switcher settings and test mode notice + * @since 3.0.0 */ export default function Gateways({isTestMode, defaultValue, inputProps, gateways}: GatewayFieldProps) { const {useFormState, useWatch, useFormContext, useDonationFormSettings} = window.givewp.form.hooks; @@ -141,8 +141,8 @@ export default function Gateways({isTestMode, defaultValue, inputProps, gateways } /** - * @since 0.6.0 replace index prop with defaultChecked - * @since 0.1.0 + * @since 3.0.0 replace index prop with defaultChecked + * @since 3.0.0 */ function GatewayOption({gateway, defaultChecked, inputProps}: GatewayOptionProps) { return ( diff --git a/src/DonationForms/resources/registrars/templates/groups/BillingAddress.tsx b/src/DonationForms/resources/registrars/templates/groups/BillingAddress.tsx index 0f76fef741..fdb35349fb 100644 --- a/src/DonationForms/resources/registrars/templates/groups/BillingAddress.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/BillingAddress.tsx @@ -6,7 +6,7 @@ import {useCallback} from '@wordpress/element'; import Label from '@givewp/form-builder/blocks/fields/settings/Label'; /** - * @since 0.5.0 + * @since 3.0.0 */ type StatesJsonResponse = { state_label: string; @@ -19,7 +19,7 @@ type StatesJsonResponse = { }; /** - * @since 0.5.0 + * @since 3.0.0 */ type State = { label: string; @@ -29,7 +29,7 @@ type State = { /** * Get states from the server based on the country value * - * @since 0.5.0 + * @since 3.0.0 */ async function getStates(url, country) { return await fetch(url, { @@ -44,7 +44,7 @@ async function getStates(url, country) { /** * This component is used to dynamically update the state field based on the country value * - * @since 0.5.0 + * @since 3.0.0 */ function StateFieldContainer({ apiUrl, @@ -199,7 +199,7 @@ function StateFieldContainer({ } /** - * @since 0.5.0 + * @since 3.0.0 */ export default function BillingAddress({ groupLabel, diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountCurrencySwitcherMessage.tsx b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountCurrencySwitcherMessage.tsx index 41b6e08fcc..7be0e962ca 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountCurrencySwitcherMessage.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountCurrencySwitcherMessage.tsx @@ -2,7 +2,7 @@ import {CurrencySwitcherSetting} from '@givewp/forms/types'; import {__} from '@wordpress/i18n'; /** - * @since 0.6.0 + * @since 3.0.0 */ type CurrencySwitcherMessageProps = { message: string; @@ -12,7 +12,7 @@ type CurrencySwitcherMessageProps = { }; /** - * @since 0.6.0 + * @since 3.0.0 */ type DonationAmountCurrencySwitcherMessageProps = { currencySettings: CurrencySwitcherSetting[]; @@ -20,7 +20,7 @@ type DonationAmountCurrencySwitcherMessageProps = { }; /** - * @since 0.6.0 + * @since 3.0.0 */ const CurrencySwitcherMessage = ({ message, @@ -46,7 +46,7 @@ const CurrencySwitcherMessage = ({ }; /** - * @since 0.6.0 + * @since 3.0.0 */ export default function DonationAmountCurrencySwitcherMessage({ currencySettings, diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountMessage.tsx b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountMessage.tsx index 75ced2a0d3..8ec66c9ca6 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountMessage.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/DonationAmountMessage.tsx @@ -4,7 +4,7 @@ import {isSubscriptionPeriod} from './subscriptionPeriod'; import {isDonationTypeSubscription} from '@givewp/forms/types'; /** - * @since 0.3.0 + * @since 3.0.0 */ export default function DonationAmountMessage({ isFixedAmount, diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountMessage.tsx b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountMessage.tsx index dc3a9e8c03..986fc2810e 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountMessage.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountMessage.tsx @@ -2,7 +2,7 @@ import {__} from "@wordpress/i18n"; import {createInterpolateElement} from "@wordpress/element"; /** - * @since 0.2.0 + * @since 3.0.0 */ export default function FixedAmountMessage({amount}: { amount: string }) { return
diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountRecurringMessage.tsx b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountRecurringMessage.tsx index bc787157e4..9ae165b44f 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountRecurringMessage.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/FixedAmountRecurringMessage.tsx @@ -4,7 +4,7 @@ import type {subscriptionPeriod} from './subscriptionPeriod'; import {SubscriptionPeriod} from './subscriptionPeriod'; /** - * @since 0.3.0 + * @since 3.0.0 */ export default function FixedAmountRecurringMessage({ isFixedAmount, diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/index.tsx b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/index.tsx index 1a74704708..b18f2ed0f8 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/index.tsx +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/index.tsx @@ -4,7 +4,7 @@ import useDonationType from './useDonationType'; import DonationAmountCurrencySwitcherMessage from './DonationAmountCurrencySwitcherMessage'; /** - * @since 0.3.0 + * @since 3.0.0 */ export default function DonationAmount({ fields: { diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/subscriptionPeriod.ts b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/subscriptionPeriod.ts index b56e6824e4..4e065fc476 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/subscriptionPeriod.ts +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/subscriptionPeriod.ts @@ -1,7 +1,7 @@ import {__} from '@wordpress/i18n'; /** - * @since 0.3.0 + * @since 3.0.0 */ type periodLabel = { singular: string; @@ -10,14 +10,14 @@ type periodLabel = { }; /** - * @since 0.3.0 + * @since 3.0.0 */ const capitalize = (text: string): string => { return text.toLowerCase().replace(/\w/, (firstLetter) => firstLetter.toUpperCase()); }; /** - * @since 0.3.0 + * @since 3.0.0 */ const subscriptionPeriodLabelLookup = { day: { @@ -48,12 +48,12 @@ const subscriptionPeriodLabelLookup = { }; /** - * @since 0.3.0 + * @since 3.0.0 */ type subscriptionPeriod = keyof typeof subscriptionPeriodLabelLookup; /** - * @since 0.3.0 + * @since 3.0.0 */ class SubscriptionPeriod { protected period: subscriptionPeriod; @@ -74,7 +74,7 @@ class SubscriptionPeriod { } /** - * @since 0.3.0 + * @since 3.0.0 */ class SubscriptionPeriodLabel { protected periodLabel: periodLabel; @@ -112,7 +112,7 @@ class SubscriptionPeriodLabel { } /** - * @since 0.3.0 + * @since 3.0.0 */ const isSubscriptionPeriod = (period: subscriptionPeriod): period is subscriptionPeriod => { return period in subscriptionPeriodLabelLookup; diff --git a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/useDonationType.ts b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/useDonationType.ts index 9e4086b47e..b1bd072880 100644 --- a/src/DonationForms/resources/registrars/templates/groups/DonationAmount/useDonationType.ts +++ b/src/DonationForms/resources/registrars/templates/groups/DonationAmount/useDonationType.ts @@ -2,7 +2,7 @@ import {useEffect} from '@wordpress/element'; import {isSubscriptionPeriod} from './subscriptionPeriod'; /** - * @since 0.3.0 + * @since 3.0.0 */ export default function useDonationType() { const {useWatch, useFormContext} = window.givewp.form.hooks; diff --git a/src/DonationForms/resources/registrars/templates/layouts/DonationReceipt.tsx b/src/DonationForms/resources/registrars/templates/layouts/DonationReceipt.tsx index d2b0043886..87d1756f79 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/DonationReceipt.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/DonationReceipt.tsx @@ -4,7 +4,7 @@ import {DonationReceiptProps} from '@givewp/forms/propTypes'; import {Interweave} from 'interweave'; /** - * @since 0.1.0 + * @since 3.0.0 */ const SecureBadge = () => { return ( @@ -17,7 +17,7 @@ const SecureBadge = () => { /** * - * @since 0.1.0 + * @since 3.0.0 */ const Details = ({id, heading, details}: { id: string; heading: string; details: ReceiptDetail[] }) => details?.length > 0 && ( @@ -36,8 +36,8 @@ const Details = ({id, heading, details}: { id: string; heading: string; details:
); /** - * @since 0.6.0 updated to use Interweave for rich text content - * @since 0.1.0 + * @since 3.0.0 updated to use Interweave for rich text content + * @since 3.0.0 */ export default function DonationReceipt({ heading, diff --git a/src/DonationForms/resources/registrars/templates/layouts/DonationSummaryItems.tsx b/src/DonationForms/resources/registrars/templates/layouts/DonationSummaryItems.tsx index d61e7609d6..931a41ecc5 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/DonationSummaryItems.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/DonationSummaryItems.tsx @@ -2,7 +2,7 @@ import {__} from '@wordpress/i18n'; import {ReactElement} from 'react'; /** - * @since 0.4.0 + * @since 3.0.0 */ export type LineItem = { id: string; @@ -12,7 +12,7 @@ export type LineItem = { }; /** - * @since 0.1.0 + * @since 3.0.0 */ const LineItem = ({id, label, value, description}: LineItem) => { return ( diff --git a/src/DonationForms/resources/registrars/templates/layouts/FieldError.tsx b/src/DonationForms/resources/registrars/templates/layouts/FieldError.tsx index b70d6b2ded..e570e48a74 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/FieldError.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/FieldError.tsx @@ -3,7 +3,7 @@ import type {FieldErrorProps} from '@givewp/forms/propTypes'; /** * Conditionally renders a field's error message if a message is present. * - * @since 0.1.0 + * @since 3.0.0 */ export default function FieldError({error}: FieldErrorProps) { if (!error) { diff --git a/src/DonationForms/resources/registrars/templates/layouts/FieldLabel.tsx b/src/DonationForms/resources/registrars/templates/layouts/FieldLabel.tsx index cbf6b473fe..9a19c2e5ce 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/FieldLabel.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/FieldLabel.tsx @@ -3,7 +3,7 @@ import type {FieldLabelProps} from '@givewp/forms/propTypes'; /** * The label for a field with the required indicator if applicable. * - * @since 0.1.0 + * @since 3.0.0 */ export default function FieldLabel({label, required}: FieldLabelProps) { return ( diff --git a/src/DonationForms/resources/registrars/templates/layouts/Goal.tsx b/src/DonationForms/resources/registrars/templates/layouts/Goal.tsx index d0ff98999d..c560b1e81d 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/Goal.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/Goal.tsx @@ -2,7 +2,7 @@ import {__} from '@wordpress/i18n'; import type {GoalProps} from '@givewp/forms/propTypes'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function Goal({ currentAmount, diff --git a/src/DonationForms/resources/registrars/templates/layouts/Header.tsx b/src/DonationForms/resources/registrars/templates/layouts/Header.tsx index d16353b554..fc0fdaec68 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/Header.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/Header.tsx @@ -1,7 +1,7 @@ import type {HeaderProps} from '@givewp/forms/propTypes'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function Header({Title, Description, Goal}: HeaderProps) { return ( diff --git a/src/DonationForms/resources/registrars/templates/layouts/HeaderDescription.tsx b/src/DonationForms/resources/registrars/templates/layouts/HeaderDescription.tsx index c4dd2bf5c5..3f6a9cd991 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/HeaderDescription.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/HeaderDescription.tsx @@ -1,7 +1,7 @@ import type {HeaderDescriptionProps} from '@givewp/forms/propTypes'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function HeaderDescription({text}: HeaderDescriptionProps) { return

{text}

; diff --git a/src/DonationForms/resources/registrars/templates/layouts/HeaderTitle.tsx b/src/DonationForms/resources/registrars/templates/layouts/HeaderTitle.tsx index 13dd0eea8a..76870db745 100644 --- a/src/DonationForms/resources/registrars/templates/layouts/HeaderTitle.tsx +++ b/src/DonationForms/resources/registrars/templates/layouts/HeaderTitle.tsx @@ -1,7 +1,7 @@ import type {HeaderTitleProps} from '@givewp/forms/propTypes'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function HeaderTitle({text}: HeaderTitleProps) { return

{text}

; diff --git a/src/DonationForms/resources/styles/global.css b/src/DonationForms/resources/styles/global.css index e2a453fbdd..0692cf8d31 100644 --- a/src/DonationForms/resources/styles/global.css +++ b/src/DonationForms/resources/styles/global.css @@ -4,7 +4,7 @@ * The main use for this file is to add dynamic css variables using wp_add_inline_style * We can also add wp global style here from wp_enqueue_global_styles as we see fit. * @see https://developer.wordpress.org/reference/functions/wp_add_inline_style/ -* @since 0.1.0 +* @since 3.0.0 */ body { diff --git a/src/DonationForms/resources/types.ts b/src/DonationForms/resources/types.ts index 4cb6842995..5f3acf56d1 100644 --- a/src/DonationForms/resources/types.ts +++ b/src/DonationForms/resources/types.ts @@ -17,7 +17,7 @@ export interface Currency { } /** - * @since 0.6.0 + * @since 3.0.0 */ export type CurrencySwitcherSetting = { id: string; @@ -158,21 +158,21 @@ export interface Group extends Node { /** * Recursively walk the group and its children for all nodes. * - * @since 0.1.0 + * @since 3.0.0 */ walkNodes(callback: (node: Node) => void, filter?: (node: Node) => boolean): void; /** * Recursively map the group and its children for all nodes. * - * @since 0.1.0 + * @since 3.0.0 */ mapNodes(callback: (node: Node) => void, filter?: (node: Node) => boolean): Node[]; /** * Recursively walk the group and its children for all nodes and reduce to a single value. * - * @since 0.1.0 + * @since 3.0.0 */ reduceNodes( callback: (accumulator: any, node: Node) => any, diff --git a/src/Donations/CustomFields/Controllers/DonationDetailsController.php b/src/Donations/CustomFields/Controllers/DonationDetailsController.php index e2d1b4f503..1ae1b4fcfe 100644 --- a/src/Donations/CustomFields/Controllers/DonationDetailsController.php +++ b/src/Donations/CustomFields/Controllers/DonationDetailsController.php @@ -9,12 +9,12 @@ /** * TODO: move into donations domain - * @since 0.1.0 + * @since 3.0.0 */ class DonationDetailsController { /** - * @since 0.1.0 + * @since 3.0.0 * * @param int $donationID * diff --git a/src/Donations/CustomFields/Views/DonationDetailsView.php b/src/Donations/CustomFields/Views/DonationDetailsView.php index 3f667c5516..3e4a0ea5bf 100644 --- a/src/Donations/CustomFields/Views/DonationDetailsView.php +++ b/src/Donations/CustomFields/Views/DonationDetailsView.php @@ -7,7 +7,7 @@ use Give\Framework\FieldsAPI\Types; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonationDetailsView { @@ -18,7 +18,7 @@ class DonationDetailsView protected $fields; /** - * @since 0.1.0 + * @since 3.0.0 * * @param Donation $donation * @param array|Field[] $fields @@ -30,7 +30,7 @@ public function __construct(Donation $donation, array $fields) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -43,7 +43,7 @@ public function render(): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -53,8 +53,8 @@ protected function getTitle(): string } /** - * @since 0.6.0 updated to conditionally display value and label - * @since 0.1.0 + * @since 3.0.0 updated to conditionally display value and label + * @since 3.0.0 * * @return string */ @@ -78,8 +78,8 @@ protected function getContents(): string } /** - * @since 0.6.0 updated to format file fields - * @since 0.1.0 + * @since 3.0.0 updated to format file fields + * @since 3.0.0 * * @param Field $field * diff --git a/src/Donations/ServiceProviderV3.php b/src/Donations/ServiceProviderV3.php index 71149fd230..7986d83602 100644 --- a/src/Donations/ServiceProviderV3.php +++ b/src/Donations/ServiceProviderV3.php @@ -6,7 +6,7 @@ use Give\ServiceProviders\ServiceProvider as ServiceProviderInterface; /** - * @since 0.4.0 + * @since 3.0.0 */ class ServiceProviderV3 implements ServiceProviderInterface { diff --git a/src/Donors/CustomFields/Controllers/DonorDetailsController.php b/src/Donors/CustomFields/Controllers/DonorDetailsController.php index 81622d8892..73754da18c 100644 --- a/src/Donors/CustomFields/Controllers/DonorDetailsController.php +++ b/src/Donors/CustomFields/Controllers/DonorDetailsController.php @@ -12,12 +12,12 @@ /** * TODO: move into donors domain - * @since 0.1.0 + * @since 3.0.0 */ class DonorDetailsController { /** - * @since 0.1.0 + * @since 3.0.0 */ public function show(Donor $donor): string { @@ -35,7 +35,7 @@ public function show(Donor $donor): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @param Donor $donor * @@ -57,7 +57,7 @@ protected function getUniqueDonationFormsForDonor(Donor $donor): array } /** - * @since 0.1.0 + * @since 3.0.0 * * @param DonationForm $form * diff --git a/src/Donors/CustomFields/Views/DonorDetailsView.php b/src/Donors/CustomFields/Views/DonorDetailsView.php index 1b02b25632..65bedec5a6 100644 --- a/src/Donors/CustomFields/Views/DonorDetailsView.php +++ b/src/Donors/CustomFields/Views/DonorDetailsView.php @@ -7,7 +7,7 @@ use Give\Framework\FieldsAPI\Types; /** - * @since 0.1.0 + * @since 3.0.0 */ class DonorDetailsView { @@ -18,7 +18,7 @@ class DonorDetailsView protected $fields; /** - * @since 0.1.0 + * @since 3.0.0 * * @param Donor $donor * @param Field[] $fields @@ -30,7 +30,7 @@ public function __construct(Donor $donor, array $fields) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -51,7 +51,7 @@ public function render(): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @return string */ @@ -61,8 +61,8 @@ protected function getTitle(): string } /** - * @since 0.6.0 updated to conditionally display value and label - * @since 0.1.0 + * @since 3.0.0 updated to conditionally display value and label + * @since 3.0.0 * * @return string */ @@ -86,8 +86,8 @@ protected function getTableRows(): string } /** - * @since 0.6.0 updated to format file fields - * @since 0.1.0 + * @since 3.0.0 updated to format file fields + * @since 3.0.0 * * @return mixed */ diff --git a/src/Donors/ServiceProviderV3.php b/src/Donors/ServiceProviderV3.php index f165471f47..bd722d3c71 100644 --- a/src/Donors/ServiceProviderV3.php +++ b/src/Donors/ServiceProviderV3.php @@ -8,7 +8,7 @@ use Give_Donor as LegacyDonor; /** - * @since 0.4.0 + * @since 3.0.0 */ class ServiceProviderV3 implements ServiceProviderInterface { diff --git a/src/FormBuilder/Actions/ConvertGlobalDefaultOptionsToDefaultBlocks.php b/src/FormBuilder/Actions/ConvertGlobalDefaultOptionsToDefaultBlocks.php index 7228bee15e..d3a1700519 100644 --- a/src/FormBuilder/Actions/ConvertGlobalDefaultOptionsToDefaultBlocks.php +++ b/src/FormBuilder/Actions/ConvertGlobalDefaultOptionsToDefaultBlocks.php @@ -9,12 +9,12 @@ * In v2 forms, there was a concept of "Default Options" in global GiveWP settings. * In v3 forms, we have "Default Blocks" instead. This action converts the global default options into default blocks. * - * @since 0.7.0 + * @since 3.0.0 */ class ConvertGlobalDefaultOptionsToDefaultBlocks { /** - * @since 0.7.0 + * @since 3.0.0 */ public function __invoke(DonationForm $form) { @@ -23,7 +23,7 @@ public function __invoke(DonationForm $form) } /** - * @since 0.7.0 + * @since 3.0.0 */ protected function handleDonorComments(DonationForm $form) { @@ -41,7 +41,7 @@ protected function handleDonorComments(DonationForm $form) } /** - * @since 0.7.0 + * @since 3.0.0 */ protected function handleAnonymousDonations(DonationForm $form) { diff --git a/src/FormBuilder/Actions/ConvertLegacyNotificationToEmailNotificationData.php b/src/FormBuilder/Actions/ConvertLegacyNotificationToEmailNotificationData.php index 1aa0241368..adc277dc8a 100644 --- a/src/FormBuilder/Actions/ConvertLegacyNotificationToEmailNotificationData.php +++ b/src/FormBuilder/Actions/ConvertLegacyNotificationToEmailNotificationData.php @@ -7,7 +7,7 @@ /** * Convert data from legacy configuration into DTO. * - * @since 0.4.0 + * @since 3.0.0 */ class ConvertLegacyNotificationToEmailNotificationData { diff --git a/src/FormBuilder/Actions/DequeueAdminScriptsInFormBuilder.php b/src/FormBuilder/Actions/DequeueAdminScriptsInFormBuilder.php index 721d432a41..73c057366f 100644 --- a/src/FormBuilder/Actions/DequeueAdminScriptsInFormBuilder.php +++ b/src/FormBuilder/Actions/DequeueAdminScriptsInFormBuilder.php @@ -8,12 +8,12 @@ * Since our form builder exists inside a WP admin page, it comes with a lot of baggage that we don't need. * This removes the unnecessary scripts before the page is loaded. * - * @since 0.1.0 + * @since 3.0.0 */ class DequeueAdminScriptsInFormBuilder { /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -35,7 +35,7 @@ public function __invoke() } /** - * @since 0.1.0 + * @since 3.0.0 * * @return bool */ diff --git a/src/FormBuilder/Actions/DequeueAdminStylesInFormBuilder.php b/src/FormBuilder/Actions/DequeueAdminStylesInFormBuilder.php index 149943494a..f83dc58d00 100644 --- a/src/FormBuilder/Actions/DequeueAdminStylesInFormBuilder.php +++ b/src/FormBuilder/Actions/DequeueAdminStylesInFormBuilder.php @@ -8,12 +8,12 @@ * Since our form builder exists inside a WP admin page, it comes with a lot of baggage that we don't need. * This removes the unnecessary styles before the page is loaded. * - * @since 0.1.0 + * @since 3.0.0 */ class DequeueAdminStylesInFormBuilder { /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -35,7 +35,7 @@ public function __invoke() } /** - * @since 0.1.0 + * @since 3.0.0 * * @return bool */ diff --git a/src/FormBuilder/Actions/UpdateDonorCommentsMeta.php b/src/FormBuilder/Actions/UpdateDonorCommentsMeta.php index d4dbe225bd..bbb3a382d9 100644 --- a/src/FormBuilder/Actions/UpdateDonorCommentsMeta.php +++ b/src/FormBuilder/Actions/UpdateDonorCommentsMeta.php @@ -7,12 +7,12 @@ /** * Update donor comments meta on backwards compatible form meta. * - * @since 0.7.0 + * @since 3.0.0 */ class UpdateDonorCommentsMeta { /** - * @since 0.7.0 + * @since 3.0.0 */ public function __invoke(DonationForm $form) { diff --git a/src/FormBuilder/Actions/UpdateEmailSettingsMeta.php b/src/FormBuilder/Actions/UpdateEmailSettingsMeta.php index 5e049d377c..b41ed23f82 100644 --- a/src/FormBuilder/Actions/UpdateEmailSettingsMeta.php +++ b/src/FormBuilder/Actions/UpdateEmailSettingsMeta.php @@ -7,12 +7,12 @@ /** * Update email settings on backwards compatible form meta. * - * @since 0.4.0 + * @since 3.0.0 */ class UpdateEmailSettingsMeta { /** - * @since 0.4.0 + * @since 3.0.0 * @param DonationForm $form */ public function __invoke(DonationForm $form) diff --git a/src/FormBuilder/Actions/UpdateEmailTemplateMeta.php b/src/FormBuilder/Actions/UpdateEmailTemplateMeta.php index 78b8a52383..8bb795c1b6 100644 --- a/src/FormBuilder/Actions/UpdateEmailTemplateMeta.php +++ b/src/FormBuilder/Actions/UpdateEmailTemplateMeta.php @@ -7,12 +7,12 @@ /** * Update email template options on backwards compatible form meta. * - * @since 0.4.0 + * @since 3.0.0 */ class UpdateEmailTemplateMeta { /** - * @since 0.4.0 + * @since 3.0.0 * @param DonationForm $form */ public function __invoke(DonationForm $form) @@ -33,7 +33,7 @@ public function __invoke(DonationForm $form) } /** - * @since 0.4.0 + * @since 3.0.0 * @param array $emails * @return array */ diff --git a/src/FormBuilder/Actions/UpdateFormGridMeta.php b/src/FormBuilder/Actions/UpdateFormGridMeta.php index 2a3eacff73..e2a63663aa 100644 --- a/src/FormBuilder/Actions/UpdateFormGridMeta.php +++ b/src/FormBuilder/Actions/UpdateFormGridMeta.php @@ -7,12 +7,12 @@ /** * Update email settings on backwards compatible form meta. * - * @since 0.6.0 + * @since 3.0.0 */ class UpdateFormGridMeta { /** - * @since 0.6.0 + * @since 3.0.0 * @param DonationForm $form */ public function __invoke(DonationForm $form) diff --git a/src/FormBuilder/Controllers/FormBuilderResourceController.php b/src/FormBuilder/Controllers/FormBuilderResourceController.php index aa5acbf3f8..77e7a89a15 100644 --- a/src/FormBuilder/Controllers/FormBuilderResourceController.php +++ b/src/FormBuilder/Controllers/FormBuilderResourceController.php @@ -17,8 +17,8 @@ class FormBuilderResourceController /** * Get the form builder instance * - * @since 0.6.0 add required block validation - * @since 0.1.0 + * @since 3.0.0 add required block validation + * @since 3.0.0 * * @param WP_REST_Request $request * @return WP_Error|WP_HTTP_Response|WP_REST_Response @@ -47,8 +47,8 @@ public function show(WP_REST_Request $request) /** * Update the form builder * - * @since 0.6.0 add required block validation - * @since 0.1.0 + * @since 3.0.0 add required block validation + * @since 3.0.0 * * @return WP_Error|WP_HTTP_Response|WP_REST_Response * @throws Exception @@ -104,7 +104,7 @@ public function update(WP_REST_Request $request) } /** - * @since 0.6.0 + * @since 3.0.0 * * @return string[] */ @@ -119,7 +119,7 @@ protected function getRequiredBlocks(): array } /** - * @since 0.6.0 + * @since 3.0.0 * * @return WP_Error|void */ diff --git a/src/FormBuilder/DataTransferObjects/EmailNotificationData.php b/src/FormBuilder/DataTransferObjects/EmailNotificationData.php index b5806cacc6..39643f5a87 100644 --- a/src/FormBuilder/DataTransferObjects/EmailNotificationData.php +++ b/src/FormBuilder/DataTransferObjects/EmailNotificationData.php @@ -5,7 +5,7 @@ use Give\FormBuilder\Actions\ConvertLegacyNotificationToEmailNotificationData; /** - * @since 0.4.0 + * @since 3.0.0 */ class EmailNotificationData { @@ -25,7 +25,7 @@ class EmailNotificationData public $defaultValues; /** - * @since 0.4.0 + * @since 3.0.0 * @param array $notification * @return EmailNotificationData */ diff --git a/src/FormBuilder/EmailPreview/Actions/ApplyPreviewTemplateTags.php b/src/FormBuilder/EmailPreview/Actions/ApplyPreviewTemplateTags.php index 9322e76360..0c82c7213f 100644 --- a/src/FormBuilder/EmailPreview/Actions/ApplyPreviewTemplateTags.php +++ b/src/FormBuilder/EmailPreview/Actions/ApplyPreviewTemplateTags.php @@ -5,12 +5,12 @@ /** * Apply preview template tags to email message. * - * @since 0.4.0 + * @since 3.0.0 */ class ApplyPreviewTemplateTags { /** - * @since 0.4.0 + * @since 3.0.0 * @param string $message * @return string */ @@ -24,7 +24,7 @@ public function __invoke($message): string } /** - * @since 0.4.0 + * @since 3.0.0 * @return array */ protected function getTags(): array @@ -64,7 +64,7 @@ protected function getTags(): array } /** - * @since 0.4.0 + * @since 3.0.0 * @return string */ protected function getEmailAccessLink(): string @@ -77,7 +77,7 @@ protected function getEmailAccessLink(): string } /** - * @since 0.4.0 + * @since 3.0.0 * @return string */ protected function getDonationHistoryLink(): string @@ -90,7 +90,7 @@ protected function getDonationHistoryLink(): string } /** - * @since 0.4.0 + * @since 3.0.0 * @return string */ protected function getSiteUrlLink(): string diff --git a/src/FormBuilder/EmailPreview/Actions/BuildEmailPreview.php b/src/FormBuilder/EmailPreview/Actions/BuildEmailPreview.php index b240bced0f..e52a3459f3 100644 --- a/src/FormBuilder/EmailPreview/Actions/BuildEmailPreview.php +++ b/src/FormBuilder/EmailPreview/Actions/BuildEmailPreview.php @@ -5,7 +5,7 @@ /** * Build email preview. * - * @since 0.4.0 + * @since 3.0.0 */ class BuildEmailPreview { diff --git a/src/FormBuilder/EmailPreview/Actions/GetEmailNotificationByType.php b/src/FormBuilder/EmailPreview/Actions/GetEmailNotificationByType.php index b45d43c7c5..ea77a8ed93 100644 --- a/src/FormBuilder/EmailPreview/Actions/GetEmailNotificationByType.php +++ b/src/FormBuilder/EmailPreview/Actions/GetEmailNotificationByType.php @@ -5,12 +5,12 @@ /** * Apply preview template tags to email message. * - * @since 0.4.0 + * @since 3.0.0 */ class GetEmailNotificationByType { /** - * @since 0.4.0 + * @since 3.0.0 * * @param $type * diff --git a/src/FormBuilder/EmailPreview/Controllers/SendEmailPreview.php b/src/FormBuilder/EmailPreview/Controllers/SendEmailPreview.php index 85b3479350..d5a65802a4 100644 --- a/src/FormBuilder/EmailPreview/Controllers/SendEmailPreview.php +++ b/src/FormBuilder/EmailPreview/Controllers/SendEmailPreview.php @@ -9,12 +9,12 @@ /** * Send email preview. * - * @since 0.4.0 + * @since 3.0.0 */ class SendEmailPreview { /** - * @since 0.4.0 + * @since 3.0.0 * * @param WP_REST_Request $request * diff --git a/src/FormBuilder/EmailPreview/Routes/RegisterEmailPreviewRoutes.php b/src/FormBuilder/EmailPreview/Routes/RegisterEmailPreviewRoutes.php index 880e8805be..1940bc7d9c 100644 --- a/src/FormBuilder/EmailPreview/Routes/RegisterEmailPreviewRoutes.php +++ b/src/FormBuilder/EmailPreview/Routes/RegisterEmailPreviewRoutes.php @@ -4,7 +4,7 @@ class RegisterEmailPreviewRoutes { /** - * @since 0.4.0 + * @since 3.0.0 */ public function __invoke() { diff --git a/src/FormBuilder/FormBuilderRouteBuilder.php b/src/FormBuilder/FormBuilderRouteBuilder.php index ace59ed85a..8a56eec977 100644 --- a/src/FormBuilder/FormBuilderRouteBuilder.php +++ b/src/FormBuilder/FormBuilderRouteBuilder.php @@ -12,7 +12,7 @@ class FormBuilderRouteBuilder protected $donationFormID; /** - * @since 0.1.0 + * @since 3.0.0 * * @param int|string $donationFormID */ @@ -22,7 +22,7 @@ protected function __construct($donationFormID) } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function makeCreateFormRoute(): self { @@ -31,7 +31,7 @@ public static function makeCreateFormRoute(): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function makeEditFormRoute(int $donationFormID): self { @@ -39,7 +39,7 @@ public static function makeEditFormRoute(int $donationFormID): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public function __toString() { @@ -47,7 +47,7 @@ public function __toString() } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getUrl(): string { @@ -62,7 +62,7 @@ public function getUrl(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function isRoute(): bool { diff --git a/src/FormBuilder/Routes/CreateFormRoute.php b/src/FormBuilder/Routes/CreateFormRoute.php index f46008c8ce..0a6b4b9ebc 100644 --- a/src/FormBuilder/Routes/CreateFormRoute.php +++ b/src/FormBuilder/Routes/CreateFormRoute.php @@ -16,7 +16,7 @@ class CreateFormRoute { /** - * @since 0.1.0 + * @since 3.0.0 * * @return void * @throws Exception diff --git a/src/FormBuilder/Routes/EditFormRoute.php b/src/FormBuilder/Routes/EditFormRoute.php index 34f9c04a30..9122287d43 100644 --- a/src/FormBuilder/Routes/EditFormRoute.php +++ b/src/FormBuilder/Routes/EditFormRoute.php @@ -10,7 +10,7 @@ class EditFormRoute { /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ diff --git a/src/FormBuilder/Routes/RegisterFormBuilderPageRoute.php b/src/FormBuilder/Routes/RegisterFormBuilderPageRoute.php index 8bce6b81aa..1139819b55 100644 --- a/src/FormBuilder/Routes/RegisterFormBuilderPageRoute.php +++ b/src/FormBuilder/Routes/RegisterFormBuilderPageRoute.php @@ -19,8 +19,8 @@ class RegisterFormBuilderPageRoute /** * Use add_submenu_page to register page within WP admin * - * @since 0.4.0 enqueue form builder styles - * @since 0.1.0 + * @since 3.0.0 enqueue form builder styles + * @since 3.0.0 * * @return void */ @@ -62,8 +62,8 @@ public function __invoke() /** * Render page with scripts * - * @since 0.4.0 Add support for custom form extensions - * @since 0.1.0 + * @since 3.0.0 Add support for custom form extensions + * @since 3.0.0 * * @return void */ @@ -100,7 +100,7 @@ public function renderPage() ->enqueue(); /** - * @since 0.4.0 + * @since 3.0.0 * Using `wp_enqueue_script` instead of `new EnqueueScript` for more control over dependencies. * The `EnqueueScript` class discovers the dependencies from the associated `asset.php` file, * which might include dependencies that are not supported in some version of WordPress. @@ -131,7 +131,7 @@ public function renderPage() * * @see https://github.com/Automattic/isolated-block-editor/blob/trunk/examples/wordpress-php/iso-gutenberg.php * - * @since 0.4.0 + * @since 3.0.0 */ public function loadGutenbergScripts() { @@ -148,7 +148,7 @@ public function loadGutenbergScripts() /** * Loop through the form builder js dependencies and check if they are registered before adding to enqueue_script. * - * @since 0.4.0 + * @since 3.0.0 */ protected function getRegisteredFormBuilderJsDependencies(array $formBuilderJsDependencies): array { diff --git a/src/FormBuilder/Routes/RegisterFormBuilderRestRoutes.php b/src/FormBuilder/Routes/RegisterFormBuilderRestRoutes.php index fb2723677d..ec6be07529 100644 --- a/src/FormBuilder/Routes/RegisterFormBuilderRestRoutes.php +++ b/src/FormBuilder/Routes/RegisterFormBuilderRestRoutes.php @@ -15,7 +15,7 @@ class RegisterFormBuilderRestRoutes protected $formBuilderResourceController; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct( FormBuilderResourceController $formBuilderResourceController @@ -24,7 +24,7 @@ public function __construct( } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -37,7 +37,7 @@ public function __invoke() /** * Get Request * - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -63,7 +63,7 @@ public function registerGetForm(string $namespace, string $route) /** * Post Request * - * @since 0.1.0 + * @since 3.0.0 * * @return void */ diff --git a/src/FormBuilder/ServiceProvider.php b/src/FormBuilder/ServiceProvider.php index bf4b0c1f3f..e85905a577 100644 --- a/src/FormBuilder/ServiceProvider.php +++ b/src/FormBuilder/ServiceProvider.php @@ -19,7 +19,7 @@ use Give\ServiceProviders\ServiceProvider as ServiceProviderInterface; /** - * @since 0.1.0 + * @since 3.0.0 */ class ServiceProvider implements ServiceProviderInterface { diff --git a/src/FormBuilder/ValueObjects/FormBuilderRestRouteConfig.php b/src/FormBuilder/ValueObjects/FormBuilderRestRouteConfig.php index 2281d39c27..9e31ba072b 100644 --- a/src/FormBuilder/ValueObjects/FormBuilderRestRouteConfig.php +++ b/src/FormBuilder/ValueObjects/FormBuilderRestRouteConfig.php @@ -3,7 +3,7 @@ namespace Give\FormBuilder\ValueObjects; /** - * @since 0.1.0 + * @since 3.0.0 */ class FormBuilderRestRouteConfig { diff --git a/src/FormBuilder/ViewModels/FormBuilderViewModel.php b/src/FormBuilder/ViewModels/FormBuilderViewModel.php index 53bbe53515..00c5284c61 100644 --- a/src/FormBuilder/ViewModels/FormBuilderViewModel.php +++ b/src/FormBuilder/ViewModels/FormBuilderViewModel.php @@ -19,7 +19,7 @@ class FormBuilderViewModel { /** - * @since 0.1.0 + * @since 3.0.0 */ public function storageData(int $donationFormId): array { @@ -71,7 +71,7 @@ public function storageData(int $donationFormId): array } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getEmailTemplateTags(array $tags = []): array { @@ -85,7 +85,7 @@ public function getEmailTemplateTags(array $tags = []): array } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getDonationConfirmationPageTemplateTags(): array { @@ -131,7 +131,7 @@ public function getDonationConfirmationPageTemplateTags(): array } /** - * @since 0.4.0 + * @since 3.0.0 */ public function jsPathFromPluginRoot(): string { @@ -139,7 +139,7 @@ public function jsPathFromPluginRoot(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public function jsPathToRegistrars(): string { @@ -147,7 +147,7 @@ public function jsPathToRegistrars(): string } /** - * @since 0.4.0 + * @since 3.0.0 */ public function jsDependencies(): array { @@ -157,7 +157,7 @@ public function jsDependencies(): array } /** - * @since 0.4.0 + * @since 3.0.0 */ public function getGateways(): array { @@ -183,7 +183,7 @@ public function getGateways(): array * as not to be too confusing. This array is used to prevent the user from creating meta keys that conflict with the * existing meta or field names. * - * @since 0.7.0 + * @since 3.0.0 */ protected function getDisallowedFieldNames(): array { diff --git a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/Edit.tsx b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/Edit.tsx index f79bb5b468..3230e0f53a 100644 --- a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/Edit.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/Edit.tsx @@ -2,7 +2,7 @@ import {TextareaControl} from '@wordpress/components'; import {BlockEditProps} from '@wordpress/blocks'; /** - * @since 0.7.0 + * @since 3.0.0 */ const Label = ({label, helpText}: { label: string; helpText: string }) => ( <> @@ -14,7 +14,7 @@ const Label = ({label, helpText}: { label: string; helpText: string }) => ( ); /** - * @since 0.7.0 + * @since 3.0.0 */ export default function Edit({attributes}: BlockEditProps) { const {label, description} = attributes; diff --git a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/index.tsx b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/index.tsx index ddb791b95c..550d2858a7 100644 --- a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/index.tsx @@ -3,7 +3,7 @@ import settings from './settings'; import {FieldBlock} from '@givewp/form-builder/types'; /** - * @since 0.7.0 + * @since 3.0.0 */ const field: FieldBlock = { name: 'givewp/donor-comments', diff --git a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/settings.tsx b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/settings.tsx index 4cbbc7b5bc..4694f99bda 100644 --- a/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/settings.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/blocks/fields/donor-comments/settings.tsx @@ -5,7 +5,7 @@ import Edit from './Edit'; import {GiveWPSupports} from '@givewp/form-builder/supports/types'; /** - * @since 0.7.0 + * @since 3.0.0 */ const givewp: GiveWPSupports = { fieldSettings: { @@ -27,7 +27,7 @@ const givewp: GiveWPSupports = { }; /** - * @since 0.7.0 + * @since 3.0.0 */ const settings: FieldBlock['settings'] = { title: __('Donor Comments', 'give'), diff --git a/src/FormBuilder/resources/js/form-builder/src/common/getDefaultBlockAttributes.ts b/src/FormBuilder/resources/js/form-builder/src/common/getDefaultBlockAttributes.ts index 495d1f7574..4e23a86a92 100644 --- a/src/FormBuilder/resources/js/form-builder/src/common/getDefaultBlockAttributes.ts +++ b/src/FormBuilder/resources/js/form-builder/src/common/getDefaultBlockAttributes.ts @@ -4,7 +4,7 @@ import blocksJson from '@givewp/form-builder/blocks.json'; * Gets the block attributes defined in our blocks.json file. * These can be used as our default block attributes. * - * @since 0.3.0 + * @since 3.0.0 */ const getDefaultBlockAttributes = (blockName: string) => { // @ts-ignore diff --git a/src/FormBuilder/resources/js/form-builder/src/common/parseMissingBlocks.ts b/src/FormBuilder/resources/js/form-builder/src/common/parseMissingBlocks.ts index 79bad87b0c..8aaad4358b 100644 --- a/src/FormBuilder/resources/js/form-builder/src/common/parseMissingBlocks.ts +++ b/src/FormBuilder/resources/js/form-builder/src/common/parseMissingBlocks.ts @@ -8,7 +8,7 @@ import {BlockInstance, getBlockType, getUnregisteredTypeHandlerName} from '@word * * @see https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/missing * - * @since 0.6.0 + * @since 3.0.0 */ export default function parseMissingBlocks(blocks: BlockInstance[]){ blocks.forEach((sectionBlock, sectionBlockIndex) => { diff --git a/src/FormBuilder/resources/js/form-builder/src/common/registerBlocks.ts b/src/FormBuilder/resources/js/form-builder/src/common/registerBlocks.ts index 8eca417c6a..6dd32c8a7e 100644 --- a/src/FormBuilder/resources/js/form-builder/src/common/registerBlocks.ts +++ b/src/FormBuilder/resources/js/form-builder/src/common/registerBlocks.ts @@ -6,7 +6,7 @@ import {__experimentalGetCoreBlocks} from '@wordpress/block-library'; * * @see https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/missing * - * @since 0.6.0 + * @since 3.0.0 */ const registerMissingBlock = () => { //TODO: should probably replace this with a custom block @@ -26,7 +26,7 @@ const registerMissingBlock = () => { const blockRegistrar = window.givewp.form.blocks; /** - * @since 0.4.0 + * @since 3.0.0 */ const supportOverrides: BlockSupports = { customClassName: false, @@ -34,7 +34,7 @@ const supportOverrides: BlockSupports = { }; /** - * @since 0.4.0 + * @since 3.0.0 */ export default function registerBlocks(): void { registerMissingBlock(); diff --git a/src/FormBuilder/resources/js/form-builder/src/common/revertMissingBlocks.ts b/src/FormBuilder/resources/js/form-builder/src/common/revertMissingBlocks.ts index 0d3cbaf8d5..10f0af12b9 100644 --- a/src/FormBuilder/resources/js/form-builder/src/common/revertMissingBlocks.ts +++ b/src/FormBuilder/resources/js/form-builder/src/common/revertMissingBlocks.ts @@ -5,7 +5,7 @@ import {BlockInstance, getBlockType, getUnregisteredTypeHandlerName} from '@word * * This is used to preserve the original block type definition when persisting the blocks to the database. * - * @since 0.6.0 + * @since 3.0.0 */ export default function revertMissingBlocks(blocks: BlockInstance[]) { blocks.forEach((sectionBlock, sectionBlockIndex) => { diff --git a/src/FormBuilder/resources/js/form-builder/src/components/forks/BlockTypesList.tsx b/src/FormBuilder/resources/js/form-builder/src/components/forks/BlockTypesList.tsx index 7e936100da..d394ed344a 100644 --- a/src/FormBuilder/resources/js/form-builder/src/components/forks/BlockTypesList.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/components/forks/BlockTypesList.tsx @@ -3,7 +3,7 @@ * * @see @wordpress/block-editor/src/components/block-types-list * - * @since 0.1.0 + * @since 3.0.0 * * Substantive changes: * - Updates the isDraggable prop in InserterListItem to account for isDisabled. diff --git a/src/FormBuilder/resources/js/form-builder/src/components/settings/ControlForPopover/index.tsx b/src/FormBuilder/resources/js/form-builder/src/components/settings/ControlForPopover/index.tsx index df3be69d3d..fada338bad 100644 --- a/src/FormBuilder/resources/js/form-builder/src/components/settings/ControlForPopover/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/components/settings/ControlForPopover/index.tsx @@ -6,7 +6,7 @@ import './styles.scss'; /** - * @since 0.6.0 + * @since 3.0.0 */ interface ControlForPopoverProps { id: string; @@ -18,7 +18,7 @@ interface ControlForPopoverProps { } /** - * @since 0.6.0 + * @since 3.0.0 */ export default function ControlForPopover({id, help, heading, children, onButtonClick, isButtonActive}: ControlForPopoverProps) { return ( diff --git a/src/FormBuilder/resources/js/form-builder/src/components/settings/PopoverContentWithTemplateTags/index.tsx b/src/FormBuilder/resources/js/form-builder/src/components/settings/PopoverContentWithTemplateTags/index.tsx index 808936c57b..3f4ff57367 100644 --- a/src/FormBuilder/resources/js/form-builder/src/components/settings/PopoverContentWithTemplateTags/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/components/settings/PopoverContentWithTemplateTags/index.tsx @@ -7,7 +7,7 @@ import {close as closeIcon, copy as copyIcon} from '@wordpress/icons'; import './styles.scss'; /** - * @since 0.6.0 + * @since 3.0.0 */ type TemplateTag = { id: string; @@ -15,7 +15,7 @@ type TemplateTag = { }; /** - * @since 0.6.0 + * @since 3.0.0 */ type PopoverContentWithTemplateTagsProps = { onClose?(): void; @@ -26,7 +26,7 @@ type PopoverContentWithTemplateTagsProps = { }; /** - * @since 0.6.0 + * @since 3.0.0 */ function CopyTagButton({textToCopy}) { const [isCopied, setCopied] = useState(false); @@ -50,7 +50,7 @@ function CopyTagButton({textToCopy}) { } /** - * @since 0.6.0 + * @since 3.0.0 */ export default function PopoverContentWithTemplateTags({ content, diff --git a/src/FormBuilder/resources/js/form-builder/src/containers/BlockEditorContainer.tsx b/src/FormBuilder/resources/js/form-builder/src/containers/BlockEditorContainer.tsx index 2f6cbff5d1..8a9f0ab8e7 100644 --- a/src/FormBuilder/resources/js/form-builder/src/containers/BlockEditorContainer.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/containers/BlockEditorContainer.tsx @@ -9,7 +9,7 @@ import parseMissingBlocks from '@givewp/form-builder/common/parseMissingBlocks'; /** - * @since 0.1.0 + * @since 3.0.0 */ export default function BlockEditorContainer() { const {blocks} = useFormState(); diff --git a/src/FormBuilder/resources/js/form-builder/src/hooks/useFieldNameValidator.ts b/src/FormBuilder/resources/js/form-builder/src/hooks/useFieldNameValidator.ts index 1c2fce38ec..a88d925d21 100644 --- a/src/FormBuilder/resources/js/form-builder/src/hooks/useFieldNameValidator.ts +++ b/src/FormBuilder/resources/js/form-builder/src/hooks/useFieldNameValidator.ts @@ -2,12 +2,12 @@ import {useSelect} from '@wordpress/data'; import {getWindowData} from "@givewp/form-builder/common"; /** - * @since 0.7.0 + * @since 3.0.0 */ const {disallowedFieldNames} = getWindowData(); /** - * @since 0.1.0 + * @since 3.0.0 * * @returns {*} */ @@ -20,8 +20,8 @@ export const hasFieldNameConflict = (fieldName: string, fieldNames: string[]) => }; /** - * @since 0.6.0 switch hyphens to underscores - * @since 0.1.0 + * @since 3.0.0 switch hyphens to underscores + * @since 3.0.0 * * @returns {`${*}-${number|number}`} */ @@ -36,7 +36,7 @@ export const getFieldNameSuggestion = (name, names) => { }; /** - * @since 0.1.0 + * @since 3.0.0 */ export const flattenBlocks = (block) => [block, ...block.innerBlocks.flatMap(flattenBlocks)]; @@ -73,8 +73,8 @@ const builtInFieldNames = [ * A hook for validating uniqueness of the 'fieldName' attribute. * When a conflict has been found, a new name suggestion will be generated and returned within the array * - * @since 0.6.0 name issue with name uniqueness not being reliable; switch hyphens to underscores - * @since 0.1.0 + * @since 3.0.0 name issue with name uniqueness not being reliable; switch hyphens to underscores + * @since 3.0.0 * * @return {function(fieldName: string): [isUnique: boolean, suggestedName: string]} */ diff --git a/src/FormBuilder/resources/js/form-builder/src/hooks/usePopoverState.ts b/src/FormBuilder/resources/js/form-builder/src/hooks/usePopoverState.ts index b7046b3b08..987f4c9172 100644 --- a/src/FormBuilder/resources/js/form-builder/src/hooks/usePopoverState.ts +++ b/src/FormBuilder/resources/js/form-builder/src/hooks/usePopoverState.ts @@ -1,7 +1,7 @@ import {useState} from '@wordpress/element'; /** - * @since 0.6.0 + * @since 3.0.0 */ export default function usePopoverState() { const [isOpen, setIsOpen] = useState(false); diff --git a/src/FormBuilder/resources/js/form-builder/src/stores/form-state/index.tsx b/src/FormBuilder/resources/js/form-builder/src/stores/form-state/index.tsx index 26da8838a5..a339d58bf1 100644 --- a/src/FormBuilder/resources/js/form-builder/src/stores/form-state/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/stores/form-state/index.tsx @@ -16,7 +16,7 @@ StoreContextDispatch.displayName = 'FormStateDispatch'; * * @see https://reactjs.org/docs/hooks-reference.html#usereducer * - * @since 0.1.0 + * @since 3.0.0 */ const FormStateProvider = ({initialState, children}: { initialState: FormState; children: ReactNode }) => { const [state, dispatch] = useReducer(formSettingsReducer, initialState); @@ -31,7 +31,7 @@ const FormStateProvider = ({initialState, children}: { initialState: FormState; /** * This is a convenient way of retrieving all the settings from the store as readOnly * - * @since 0.1.0 + * @since 3.0.0 * * @example * const {settings: {formTitle}} = useFormState(); @@ -41,7 +41,7 @@ const useFormState = () => useContext(StoreContext); /** * This is a convenient way of retrieving the "dispatch" function from our provider * - * @since 0.1.0 + * @since 3.0.0 * * @example * // retrieve the "dispatch" function diff --git a/src/FormBuilder/resources/js/form-builder/src/stores/form-state/reducer.ts b/src/FormBuilder/resources/js/form-builder/src/stores/form-state/reducer.ts index 214716564b..1156a41b86 100644 --- a/src/FormBuilder/resources/js/form-builder/src/stores/form-state/reducer.ts +++ b/src/FormBuilder/resources/js/form-builder/src/stores/form-state/reducer.ts @@ -5,7 +5,7 @@ const UPDATE_DIRTY = 'update_dirty'; /** * This reducer is used within the FormStateProvider for state management * - * @since 0.1.0 + * @since 3.0.0 */ export default function reducer(state, action) { switch (action.type) { @@ -37,7 +37,7 @@ export default function reducer(state, action) { } /** - * @since 0.1.0 + * @since 3.0.0 */ export function setFormSettings(settings) { return { @@ -47,7 +47,7 @@ export function setFormSettings(settings) { } /** - * @since 0.1.0 + * @since 3.0.0 */ export function setFormBlocks(blocks) { return { @@ -57,7 +57,7 @@ export function setFormBlocks(blocks) { } /** - * @since 0.2.0 + * @since 3.0.0 */ export function setIsDirty(isDirty: boolean) { return { diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/FieldSettingsHOC.tsx b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/FieldSettingsHOC.tsx index 4c23091476..3f683c6ef3 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/FieldSettingsHOC.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/FieldSettingsHOC.tsx @@ -17,7 +17,7 @@ import MetaKeyTextControl, {slugifyMeta} from '@givewp/form-builder/supports/fie /** * Higher Order Component that adds field settings to the inspector controls. * - * @since 0.6.0 + * @since 3.0.0 */ const FieldSettingsHOC = createHigherOrderComponent((BlockEdit) => { return (props) => { @@ -56,7 +56,7 @@ const generateEmailTag = (fieldName, storeAsDonorMeta) => { /** * Renders the field settings inspector controls. * - * @since 0.6.0 + * @since 3.0.0 */ function FieldSettingsEdit({attributes, setAttributes, fieldSettings}) { const validateFieldName = useFieldNameValidator(); diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/MetaKeyTextControl/index.tsx b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/MetaKeyTextControl/index.tsx index b8a72f6fc6..1fcc0553d5 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/MetaKeyTextControl/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/MetaKeyTextControl/index.tsx @@ -8,7 +8,7 @@ import styles from './styles.module.scss' * The text control for meta keys. The key can be optionally locked so the user has to explicitly decide to change it * after being warned. * - * @since 0.6.0 + * @since 3.0.0 */ export default function MetaKeyTextControl({value, lockValue, onChange, onBlur}) { const [isPopoverOpen, setIsPopoverOpen] = useState(false); @@ -51,7 +51,7 @@ export default function MetaKeyTextControl({value, lockValue, onChange, onBlur}) * Takes a string and returns a slugified version of it. This is not intended to be a general purpose slugify function * and is specific to meta keys. * - * @since 0.6.0 + * @since 3.0.0 */ export function slugifyMeta(value) { return value @@ -84,7 +84,7 @@ function EditButton({onClick}) { /** * The popover that allows the user to override the meta key. * - * @since 0.6.0 + * @since 3.0.0 */ function EditPopover({visible, onCancel, onConfirm}) { if ( ! visible ) { diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/index.tsx b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/index.tsx index fa071dacd4..1e77068046 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/index.tsx +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/index.tsx @@ -7,7 +7,7 @@ import {AfterDisplaySettingsFill, AfterFieldSettingsFill, DisplaySettingsFill, F /** * Registers the necessary hooks for supports the field settings * - * @since 0.6.0 + * @since 3.0.0 */ export default function registerHooks() { addFilter('editor.BlockEdit', 'givewp/supports/field-settings-hoc', FieldSettingsHOC); diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/normalizeFieldSettings.ts b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/normalizeFieldSettings.ts index 2e3d70dd97..99ad9cc7b6 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/normalizeFieldSettings.ts +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/normalizeFieldSettings.ts @@ -5,7 +5,7 @@ import {__} from '@wordpress/i18n'; * Takes in the "supports" settings for a field and normalizes them into a standard object. It is recommended to use * this function rather than the settings directly. * - * @since 0.6.0 + * @since 3.0.0 */ export default function normalizeFieldSettings(settings: FieldSettingsSupport | false): FieldSettings | null { if (settings === undefined || settings === false) { diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/slots.ts b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/slots.ts index a9661b6b90..0b72438625 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/slots.ts +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/slots.ts @@ -4,7 +4,7 @@ import {createSlotFill} from '@wordpress/components'; * Slots for used within the field settings inspector controls. This allows plugins and such to add further controls to * the inspector sections. * - * @since 0.6.0 + * @since 3.0.0 */ const {Slot: FieldSettingsSlot, Fill: FieldSettingsFill} = createSlotFill('GiveWP/FieldSettings/FieldSettingSlot'); diff --git a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/updateBlockTypes.ts b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/updateBlockTypes.ts index abbc2764a8..a4b2e20cd3 100644 --- a/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/updateBlockTypes.ts +++ b/src/FormBuilder/resources/js/form-builder/src/supports/field-settings/updateBlockTypes.ts @@ -4,7 +4,7 @@ import type {FieldAttributes} from './types'; /** * Adds attributes to the block types that support the field settings. * - * @since 0.6.0 + * @since 3.0.0 */ export default function updateBlockTypes(settings) { const fieldSettings = normalizeFieldSettings(settings.supports.givewp?.fieldSettings); diff --git a/src/FormBuilder/resources/js/form-builder/src/types/formPageSettings.ts b/src/FormBuilder/resources/js/form-builder/src/types/formPageSettings.ts index 7eac312a3f..6f5d276565 100644 --- a/src/FormBuilder/resources/js/form-builder/src/types/formPageSettings.ts +++ b/src/FormBuilder/resources/js/form-builder/src/types/formPageSettings.ts @@ -1,5 +1,5 @@ /** - * @since 0.1.0 + * @since 3.0.0 */ export type FormPageSettings = { isEnabled: boolean; diff --git a/src/FormBuilder/resources/js/form-builder/src/types/formSettings.ts b/src/FormBuilder/resources/js/form-builder/src/types/formSettings.ts index 38581af543..72b97c7182 100644 --- a/src/FormBuilder/resources/js/form-builder/src/types/formSettings.ts +++ b/src/FormBuilder/resources/js/form-builder/src/types/formSettings.ts @@ -2,7 +2,7 @@ import {FormStatus} from "@givewp/form-builder/types/formStatus"; import {EmailTemplateOption} from "@givewp/form-builder/types/emailTemplateOption"; /** - * @since 0.1.0 + * @since 3.0.0 */ export type FormSettings = { showHeader: boolean; diff --git a/src/FormBuilder/resources/js/form-builder/src/types/formState.ts b/src/FormBuilder/resources/js/form-builder/src/types/formState.ts index 38a0f22fe2..fea581a5e4 100644 --- a/src/FormBuilder/resources/js/form-builder/src/types/formState.ts +++ b/src/FormBuilder/resources/js/form-builder/src/types/formState.ts @@ -2,7 +2,7 @@ import type {FormSettings} from './formSettings'; import {BlockInstance} from '@wordpress/blocks'; /** - * @since 0.1.0 + * @since 3.0.0 */ export type FormState = { blocks: BlockInstance[]; diff --git a/src/FormBuilder/resources/js/registrars/blocks/index.ts b/src/FormBuilder/resources/js/registrars/blocks/index.ts index b75b8691c0..7b709957a7 100644 --- a/src/FormBuilder/resources/js/registrars/blocks/index.ts +++ b/src/FormBuilder/resources/js/registrars/blocks/index.ts @@ -1,7 +1,7 @@ import {BlockConfiguration} from '@wordpress/blocks'; /** - * @since 0.4.0 + * @since 3.0.0 */ export interface Block { name: string; @@ -9,7 +9,7 @@ export interface Block { } /** - * @since 0.4.0 + * @since 3.0.0 */ interface Registrar { register(name: string, settings: BlockConfiguration): void; @@ -20,30 +20,30 @@ interface Registrar { } /** - * @since 0.4.0 + * @since 3.0.0 */ export default class BlockRegistrar implements Registrar { /** - * @since 0.4.0 + * @since 3.0.0 */ private blocks: Block[] = []; /** - * @since 0.4.0 + * @since 3.0.0 */ public get(blockName: string): Block | undefined { return this.blocks.find(({name}) => name === blockName); } /** - * @since 0.4.0 + * @since 3.0.0 */ public getAll(): Block[] { return this.blocks; } /** - * @since 0.4.0 + * @since 3.0.0 */ public register(name, settings: BlockConfiguration): void { if (this.get(name)) { diff --git a/src/FormMigration/Concerns/Blocks/BlockFactory.php b/src/FormMigration/Concerns/Blocks/BlockFactory.php index 80f82abea4..4af18e2c2c 100644 --- a/src/FormMigration/Concerns/Blocks/BlockFactory.php +++ b/src/FormMigration/Concerns/Blocks/BlockFactory.php @@ -99,7 +99,7 @@ public static function billingAddress(array $attributes = []) } /** - * @since 0.7.0 + * @since 3.0.0 */ public static function donorComments(): BlockModel { diff --git a/src/FormMigration/DataTransferObjects/DonationSummarySettings.php b/src/FormMigration/DataTransferObjects/DonationSummarySettings.php index 9834f0bb54..2e7d43256b 100644 --- a/src/FormMigration/DataTransferObjects/DonationSummarySettings.php +++ b/src/FormMigration/DataTransferObjects/DonationSummarySettings.php @@ -5,7 +5,7 @@ /** * The `Sequoia` and `Classic` templates share a structure for Donation Summary settings. * - * @since 0.6.0 + * @since 3.0.0 */ class DonationSummarySettings { @@ -50,7 +50,7 @@ public function isEnabled(): bool } /** - * @since 0.6.0 + * @since 3.0.0 * * @note `give_donation_form_user_info` is presented as "Before payment fields". * @note `give_donation_form_before_submit` is the default location, presented as "After payment fields". diff --git a/src/FormMigration/ServiceProvider.php b/src/FormMigration/ServiceProvider.php index 44675937c8..554b9c5db0 100644 --- a/src/FormMigration/ServiceProvider.php +++ b/src/FormMigration/ServiceProvider.php @@ -2,7 +2,6 @@ namespace Give\FormMigration; -use Give\DonationForms\Models\DonationForm as DonationFormV3; use Give\DonationForms\V2\Models\DonationForm as DonationFormV2; use Give\FormMigration\Commands\MigrationCommand; use Give\FormMigration\Commands\TransferCommand; @@ -15,7 +14,7 @@ use WP_REST_Server; /** - * @since 0.1.0 + * @since 3.0.0 */ class ServiceProvider implements ServiceProviderInterface { diff --git a/src/FormMigration/Steps/FormFields.php b/src/FormMigration/Steps/FormFields.php index 42ca387223..181bb8358f 100644 --- a/src/FormMigration/Steps/FormFields.php +++ b/src/FormMigration/Steps/FormFields.php @@ -26,7 +26,7 @@ public function process() } /** - * @since 0.7.0 + * @since 3.0.0 */ protected function handleDonorComments() { @@ -38,7 +38,7 @@ protected function handleDonorComments() } /** - * @since 0.7.0 + * @since 3.0.0 */ protected function handleAnonymousDonations() { diff --git a/src/FormMigration/functions.php b/src/FormMigration/functions.php index 54b0d68df5..27141e56bc 100644 --- a/src/FormMigration/functions.php +++ b/src/FormMigration/functions.php @@ -9,7 +9,7 @@ * ex: givewp_migrated_form_id($formId); * ex: givewp_migrated_form_id($formId, $atts['id']); * - * @since 0.6.0 + * @since 3.0.0 * * @param $formId int $formId is used as an "output argument", meaning it is updated without needing to be returned. * @param $extraReference int[] Any additional references to update with the migrated form ID. diff --git a/src/Framework/Blocks/BlockCollection.php b/src/Framework/Blocks/BlockCollection.php index a2b6d1e9b3..4d35322742 100644 --- a/src/Framework/Blocks/BlockCollection.php +++ b/src/Framework/Blocks/BlockCollection.php @@ -12,7 +12,7 @@ class BlockCollection implements Arrayable protected $blocks; /** - * @since 0.1.0 + * @since 3.0.0 * * @param BlockModel[] $blocks */ @@ -22,7 +22,7 @@ public function __construct(array $blocks) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param BlockModel[] $blocks */ @@ -32,7 +32,7 @@ public static function make($blocks): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public static function fromJson($blocksJson): self { @@ -47,7 +47,7 @@ public static function fromJson($blocksJson): self } /** - * @since 0.1.0 + * @since 3.0.0 * * @return false|string */ @@ -57,7 +57,7 @@ public function toJson() } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { @@ -68,7 +68,7 @@ public function toArray(): array /** * @return BlockModel[] - * @since 0.1.0 + * @since 3.0.0 * */ public function getBlocks(): array @@ -77,7 +77,7 @@ public function getBlocks(): array } /** - * @since 0.4.0 + * @since 3.0.0 * * @return BlockModel|null */ @@ -98,7 +98,7 @@ public function findParentByChildName($blockName, int $blockIndex = 0) } /** - * @since 0.4.0 + * @since 3.0.0 * * @return BlockModel|BlockCollection|null */ @@ -131,7 +131,7 @@ private function findByNameRecursive(string $blockName, int $blockIndex = 0, str } /** - * @since 0.4.0 + * @since 3.0.0 */ public function insertBefore(string $blockName, BlockModel $block, int $blockIndex = 0): BlockCollection { @@ -150,7 +150,7 @@ public function insertBefore(string $blockName, BlockModel $block, int $blockInd } /** - * @since 0.4.0 + * @since 3.0.0 */ public function insertAfter(string $blockName, BlockModel $block, int $blockIndex = 0): BlockCollection { @@ -169,7 +169,7 @@ public function insertAfter(string $blockName, BlockModel $block, int $blockInde } /** - * @since 0.4.0 + * @since 3.0.0 */ public function prepend(BlockModel $block): BlockCollection { @@ -178,7 +178,7 @@ public function prepend(BlockModel $block): BlockCollection } /** - * @since 0.4.0 + * @since 3.0.0 */ public function append(BlockModel $block): BlockCollection { diff --git a/src/Framework/Blocks/BlockModel.php b/src/Framework/Blocks/BlockModel.php index 9aa36aa87e..11f8d4ccd3 100644 --- a/src/Framework/Blocks/BlockModel.php +++ b/src/Framework/Blocks/BlockModel.php @@ -5,7 +5,7 @@ use Give\Framework\Support\Contracts\Arrayable; /** - * @since 0.1.0 + * @since 3.0.0 * A structured model for a Gutenberg block. * Similar to WP_Block_Parser_Block, but without innerHTML or innerContent. * ... and without the HTML comments as structure. @@ -50,7 +50,7 @@ public function __construct( } /** - * @since 0.1.0 + * @since 3.0.0 */ public function hasAttribute($name): bool { @@ -58,7 +58,7 @@ public function hasAttribute($name): bool } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getAttribute($name) { @@ -66,7 +66,7 @@ public function getAttribute($name) } /** - * @since 0.2.0 + * @since 3.0.0 */ public function getAttributes(): array { @@ -74,7 +74,7 @@ public function getAttributes(): array } /** - * @since 0.4.0 + * @since 3.0.0 */ public function setAttribute(string $name, $value): BlockModel { @@ -88,7 +88,7 @@ public function setAttribute(string $name, $value): BlockModel /** * Returns the unqualified, or short name, of the block without the namespace. * - * @since 0.1.0 + * @since 3.0.0 */ public function getShortName(): string { @@ -96,7 +96,7 @@ public function getShortName(): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @param array $blockData * @return BlockModel @@ -118,7 +118,7 @@ public static function make( array $blockData ): BlockModel } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/Framework/FieldsAPI/Actions/CreateValidatorFromFormFields.php b/src/Framework/FieldsAPI/Actions/CreateValidatorFromFormFields.php index 090af7d016..084369fbcb 100644 --- a/src/Framework/FieldsAPI/Actions/CreateValidatorFromFormFields.php +++ b/src/Framework/FieldsAPI/Actions/CreateValidatorFromFormFields.php @@ -10,7 +10,7 @@ class CreateValidatorFromFormFields { /** - * @since 0.4.0 + * @since 3.0.0 * * @param Field[] $formFields * @param array $values diff --git a/src/Framework/FieldsAPI/Amount.php b/src/Framework/FieldsAPI/Amount.php index dedb3fe66b..7aeff6fa6a 100644 --- a/src/Framework/FieldsAPI/Amount.php +++ b/src/Framework/FieldsAPI/Amount.php @@ -38,7 +38,7 @@ class Amount extends Field /** * Set the preset donation levels. Provide levels in minor units. * - * @since 0.1.0 + * @since 3.0.0 */ public function levels(int ...$levels): self { @@ -48,7 +48,7 @@ public function levels(int ...$levels): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getLevels(): array { @@ -56,7 +56,7 @@ public function getLevels(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function allowCustomAmount($allow = true): self { @@ -66,7 +66,7 @@ public function allowCustomAmount($allow = true): self } /** - * @since 0.2.0 + * @since 3.0.0 */ public function allowLevels($allow = true): self { @@ -76,7 +76,7 @@ public function allowLevels($allow = true): self } /** - * @since 0.1.0 + * @since 3.0.0 */ public function customAmountAllowed(): bool { @@ -84,7 +84,7 @@ public function customAmountAllowed(): bool } /** - * @since 0.2.0 + * @since 3.0.0 */ public function customAmountText(string $customAmountText): Amount { @@ -94,7 +94,7 @@ public function customAmountText(string $customAmountText): Amount } /** - * @since 0.2.0 + * @since 3.0.0 * * @param float|int $amount */ @@ -106,7 +106,7 @@ public function fixedAmountValue($amount): Amount } /** - * @since 0.3.0 + * @since 3.0.0 */ public function getFixedAmountValue() { diff --git a/src/Framework/FieldsAPI/BillingAddress.php b/src/Framework/FieldsAPI/BillingAddress.php index f9516df865..48fc3f7105 100644 --- a/src/Framework/FieldsAPI/BillingAddress.php +++ b/src/Framework/FieldsAPI/BillingAddress.php @@ -5,24 +5,24 @@ namespace Give\Framework\FieldsAPI; /** - * @since 0.5.0 + * @since 3.0.0 */ class BillingAddress extends Group { const TYPE = 'billingAddress'; /** - * @since 0.5.0 + * @since 3.0.0 */ public $apiUrl; /** - * @since 0.5.0 + * @since 3.0.0 */ public $groupLabel; /** - * @since 0.5.0 + * @since 3.0.0 */ public function setApiUrl(string $url): BillingAddress { @@ -32,7 +32,7 @@ public function setApiUrl(string $url): BillingAddress } /** - * @since 0.5.0 + * @since 3.0.0 */ public function setGroupLabel(string $groupLabel): BillingAddress { @@ -42,7 +42,7 @@ public function setGroupLabel(string $groupLabel): BillingAddress } /** - * @since 0.5.0 + * @since 3.0.0 * * @throws Exceptions\EmptyNameException|Exceptions\NameCollisionException */ diff --git a/src/Framework/FieldsAPI/Consent.php b/src/Framework/FieldsAPI/Consent.php index 94e8ab2bdc..3ad6bc1045 100644 --- a/src/Framework/FieldsAPI/Consent.php +++ b/src/Framework/FieldsAPI/Consent.php @@ -20,7 +20,7 @@ class Consent extends field const TYPE = 'consent'; /** - * @since 0.5.0 + * @since 3.0.0 */ public function getUseGlobalSettings(): bool { @@ -28,7 +28,7 @@ public function getUseGlobalSettings(): bool } /** - * @since 0.5.0 + * @since 3.0.0 */ public function useGlobalSettings(bool $useGlobalSettings): Consent { @@ -38,7 +38,7 @@ public function useGlobalSettings(bool $useGlobalSettings): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getCheckboxLabel(): string { @@ -46,7 +46,7 @@ public function getCheckboxLabel(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function checkboxLabel(string $text): Consent { @@ -56,7 +56,7 @@ public function checkboxLabel(string $text): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getDisplayType(): string { @@ -64,7 +64,7 @@ public function getDisplayType(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function displayType(string $text): Consent { @@ -74,7 +74,7 @@ public function displayType(string $text): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getLinkText(): string { @@ -82,7 +82,7 @@ public function getLinkText(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function linkText(string $text): Consent { @@ -92,7 +92,7 @@ public function linkText(string $text): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getLinkUrl(): string { @@ -100,7 +100,7 @@ public function getLinkUrl(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function linkUrl(string $url): Consent { @@ -110,7 +110,7 @@ public function linkUrl(string $url): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getModalHeading(): string { @@ -118,7 +118,7 @@ public function getModalHeading(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function modalHeading(string $text): Consent { @@ -128,7 +128,7 @@ public function modalHeading(string $text): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getModalAcceptanceText(): string { @@ -136,7 +136,7 @@ public function getModalAcceptanceText(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function modalAcceptanceText(string $text): Consent { @@ -146,7 +146,7 @@ public function modalAcceptanceText(string $text): Consent } /** - * @since 0.5.0 + * @since 3.0.0 */ public function getAgreementText(): string { @@ -154,7 +154,7 @@ public function getAgreementText(): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function agreementText(string $text): Consent { diff --git a/src/Framework/FieldsAPI/DonationAmount.php b/src/Framework/FieldsAPI/DonationAmount.php index 2a894ee4d1..9403911a39 100644 --- a/src/Framework/FieldsAPI/DonationAmount.php +++ b/src/Framework/FieldsAPI/DonationAmount.php @@ -33,7 +33,7 @@ public static function make($name): DonationAmount } /** - * @since 0.3.0 + * @since 3.0.0 */ public function enableSubscriptions($enable = true): self { @@ -43,7 +43,7 @@ public function enableSubscriptions($enable = true): self } /** - * @since 0.3.0 + * @since 3.0.0 */ public function subscriptionDetailsAreFixed($fixed = true): self { @@ -53,7 +53,7 @@ public function subscriptionDetailsAreFixed($fixed = true): self } /** - * @since 0.3.0 + * @since 3.0.0 * @throws NameCollisionException */ public function donationType(Field $field): self @@ -64,7 +64,7 @@ public function donationType(Field $field): self } /** - * @since 0.3.0 + * @since 3.0.0 * @throws NameCollisionException */ public function subscriptionPeriod(Field $field): self @@ -77,7 +77,7 @@ public function subscriptionPeriod(Field $field): self } /** - * @since 0.3.0 + * @since 3.0.0 * @throws NameCollisionException */ public function subscriptionFrequency(Field $field): self @@ -90,7 +90,7 @@ public function subscriptionFrequency(Field $field): self } /** - * @since 0.3.0 + * @since 3.0.0 * @throws NameCollisionException */ public function subscriptionInstallments(Field $field): self diff --git a/src/Framework/FieldsAPI/DonationForm.php b/src/Framework/FieldsAPI/DonationForm.php index 637f863f5f..f28999a94a 100644 --- a/src/Framework/FieldsAPI/DonationForm.php +++ b/src/Framework/FieldsAPI/DonationForm.php @@ -5,32 +5,32 @@ use Give\Framework\FieldsAPI\Properties\DonationForm\CurrencySwitcherSetting; /** - * @since 0.6.0 + * @since 3.0.0 */ class DonationForm extends Form { /** - * @since 0.6.0 + * @since 3.0.0 * * @var string */ protected $defaultCurrency; /** - * @since 0.6.0 + * @since 3.0.0 * * @var CurrencySwitcherSetting[] */ protected $currencySwitcherSettings = []; /** - * @since 0.6.0 + * @since 3.0.0 * * @var string */ protected $currencySwitcherMessage; /** - * @since 0.6.0 + * @since 3.0.0 */ public function currencySwitcherSettings(CurrencySwitcherSetting ...$settings): DonationForm { @@ -40,7 +40,7 @@ public function currencySwitcherSettings(CurrencySwitcherSetting ...$settings): } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getCurrencySwitcherSettings(): array { @@ -48,7 +48,7 @@ public function getCurrencySwitcherSettings(): array } /** - * @since 0.6.0 + * @since 3.0.0 */ public function currencySwitcherMessage(string $message): DonationForm { @@ -58,7 +58,7 @@ public function currencySwitcherMessage(string $message): DonationForm } /** - * @since 0.6.0 + * @since 3.0.0 */ public function defaultCurrency(string $currency): DonationForm { @@ -68,7 +68,7 @@ public function defaultCurrency(string $currency): DonationForm } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getDefaultCurrency(): string { diff --git a/src/Framework/FieldsAPI/Password.php b/src/Framework/FieldsAPI/Password.php index 16c4513e8e..20ecd41040 100644 --- a/src/Framework/FieldsAPI/Password.php +++ b/src/Framework/FieldsAPI/Password.php @@ -5,7 +5,7 @@ namespace Give\Framework\FieldsAPI; /** - * @since 0.4.0 + * @since 3.0.0 */ class Password extends Field { diff --git a/src/Framework/FieldsAPI/PaymentGateways.php b/src/Framework/FieldsAPI/PaymentGateways.php index ac1e44174e..40f994f015 100644 --- a/src/Framework/FieldsAPI/PaymentGateways.php +++ b/src/Framework/FieldsAPI/PaymentGateways.php @@ -7,14 +7,14 @@ class PaymentGateways extends Field { /** - * @since 0.6.0 + * @since 3.0.0 * * @type bool */ public $isTestMode; /** - * @since 0.6.0 + * @since 3.0.0 */ public function testMode( bool $isTestMode = true ): PaymentGateways { $this->isTestMode = $isTestMode; diff --git a/src/Framework/FieldsAPI/Properties/DonationForm/CurrencySwitcherSetting.php b/src/Framework/FieldsAPI/Properties/DonationForm/CurrencySwitcherSetting.php index 6c238c3438..78fd86763a 100644 --- a/src/Framework/FieldsAPI/Properties/DonationForm/CurrencySwitcherSetting.php +++ b/src/Framework/FieldsAPI/Properties/DonationForm/CurrencySwitcherSetting.php @@ -5,7 +5,7 @@ use JsonSerializable; /** - * @since 0.6.0 + * @since 3.0.0 */ class CurrencySwitcherSetting implements JsonSerializable { @@ -27,7 +27,7 @@ class CurrencySwitcherSetting implements JsonSerializable protected $exchangeRateFractionDigits; /** - * @since 0.6.0 + * @since 3.0.0 */ public function __construct( string $id, @@ -42,7 +42,7 @@ public function __construct( } /** - * @since 0.6.0 + * @since 3.0.0 */ public function jsonSerialize() { @@ -50,7 +50,7 @@ public function jsonSerialize() } /** - * @since 0.6.0 + * @since 3.0.0 */ public function id(string $id): CurrencySwitcherSetting { @@ -60,7 +60,7 @@ public function id(string $id): CurrencySwitcherSetting } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getId(): string { @@ -68,7 +68,7 @@ public function getId(): string } /** - * @since 0.6.0 + * @since 3.0.0 */ public function exchangeRate(float $rate): CurrencySwitcherSetting { @@ -78,7 +78,7 @@ public function exchangeRate(float $rate): CurrencySwitcherSetting } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getExchangeRate(): float { @@ -86,7 +86,7 @@ public function getExchangeRate(): float } /** - * @since 0.6.0 + * @since 3.0.0 */ public function exchangeRateFractionDigits(int $exchangeRateFractionDigits): CurrencySwitcherSetting { @@ -96,7 +96,7 @@ public function exchangeRateFractionDigits(int $exchangeRateFractionDigits): Cur } /** - * @since 0.6.0 + * @since 3.0.0 */ public function getExchangeRateFractionDigits(): int { @@ -104,7 +104,7 @@ public function getExchangeRateFractionDigits(): int } /** - * @since 0.6.0 + * @since 3.0.0 */ public function gateways(array $gateways): CurrencySwitcherSetting { diff --git a/src/Framework/FormDesigns/Contracts/FormDesignInterface.php b/src/Framework/FormDesigns/Contracts/FormDesignInterface.php index 0bed754f11..9b3379692e 100644 --- a/src/Framework/FormDesigns/Contracts/FormDesignInterface.php +++ b/src/Framework/FormDesigns/Contracts/FormDesignInterface.php @@ -5,21 +5,21 @@ /** * The structure of a GiveWP FormDesign * - * @since 0.1.0 + * @since 3.0.0 */ interface FormDesignInterface { /** * Return a unique identifier for the design * - * @since 0.1.0 + * @since 3.0.0 */ public static function id(): string; /** * Returns a human-readable name for the design * - * @since 0.1.0 + * @since 3.0.0 */ public static function name(): string; } diff --git a/src/Framework/FormDesigns/Exceptions/OverflowException.php b/src/Framework/FormDesigns/Exceptions/OverflowException.php index 44d9b7a2c8..3629748caa 100644 --- a/src/Framework/FormDesigns/Exceptions/OverflowException.php +++ b/src/Framework/FormDesigns/Exceptions/OverflowException.php @@ -5,7 +5,7 @@ use Give\Framework\Exceptions\Primitives\Exception; /** - * @since 0.1.0 + * @since 3.0.0 */ class OverflowException extends Exception { diff --git a/src/Framework/FormDesigns/FormDesign.php b/src/Framework/FormDesigns/FormDesign.php index 72c062a53e..b6fd026194 100644 --- a/src/Framework/FormDesigns/FormDesign.php +++ b/src/Framework/FormDesigns/FormDesign.php @@ -7,7 +7,7 @@ /** * The FormDesign is meant to be extended to create custom GiveWP form designs. * - * @since 0.1.0 + * @since 3.0.0 */ abstract class FormDesign implements FormDesignInterface { @@ -16,21 +16,21 @@ abstract class FormDesign implements FormDesignInterface /** * The unique identifier of the design * - * @since 0.1.0 + * @since 3.0.0 */ abstract public static function id(): string; /** * THe human-readable name of the design * - * @since 0.1.0 + * @since 3.0.0 */ abstract public static function name(): string; /** * Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory. * - * @since 0.1.0 + * @since 3.0.0 * * @return string|false */ @@ -42,7 +42,7 @@ public function css() /** * Full URL of the script, or path of the script relative to the WordPress root directory. * - * @since 0.1.0 + * @since 3.0.0 * * @return string|false */ @@ -65,7 +65,7 @@ public function dependencies(): array } /** - * @since 0.4.0 + * @since 3.0.0 */ public function isMultiStep(): bool { diff --git a/src/Framework/FormDesigns/Registrars/FormDesignRegistrar.php b/src/Framework/FormDesigns/Registrars/FormDesignRegistrar.php index c7dde63b36..d853da4dad 100644 --- a/src/Framework/FormDesigns/Registrars/FormDesignRegistrar.php +++ b/src/Framework/FormDesigns/Registrars/FormDesignRegistrar.php @@ -8,7 +8,7 @@ use Give\Log\Log; /** - * @since 0.1.0 + * @since 3.0.0 */ class FormDesignRegistrar { @@ -18,7 +18,7 @@ class FormDesignRegistrar protected $designs = []; /** - * @since 0.1.0 + * @since 3.0.0 */ public function getDesigns(): array { @@ -26,7 +26,7 @@ public function getDesigns(): array } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws InvalidArgumentException */ @@ -43,7 +43,7 @@ public function getDesign(string $id): FormDesign } /** - * @since 0.1.0 + * @since 3.0.0 */ public function hasDesign(string $id): bool { @@ -51,7 +51,7 @@ public function hasDesign(string $id): bool } /** - * @since 0.1.0 + * @since 3.0.0 */ public function registerDesign(string $designClass) { @@ -67,7 +67,7 @@ public function registerDesign(string $designClass) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function unregisterDesign(string $designId) { @@ -77,7 +77,7 @@ public function unregisterDesign(string $designId) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void * diff --git a/src/Framework/FormDesigns/ServiceProvider.php b/src/Framework/FormDesigns/ServiceProvider.php index 646c560cc4..54892792b7 100644 --- a/src/Framework/FormDesigns/ServiceProvider.php +++ b/src/Framework/FormDesigns/ServiceProvider.php @@ -8,7 +8,7 @@ use Give\ServiceProviders\ServiceProvider as ServiceProviderInterface; /** - * @since 0.1.0 + * @since 3.0.0 */ class ServiceProvider implements ServiceProviderInterface { diff --git a/src/Framework/PaymentGateways/Traits/HasRequest.php b/src/Framework/PaymentGateways/Traits/HasRequest.php index 56facc09ff..3e6e1c6add 100644 --- a/src/Framework/PaymentGateways/Traits/HasRequest.php +++ b/src/Framework/PaymentGateways/Traits/HasRequest.php @@ -9,7 +9,7 @@ trait HasRequest { private $request; /** - * @since 0.1.0 + * @since 3.0.0 * @return mixed */ public function get(string $key) @@ -19,7 +19,7 @@ public function get(string $key) /** * - * @since 0.1.0 + * @since 3.0.0 * @return $this */ public function request(): self diff --git a/src/Framework/Receipts/Actions/GenerateConfirmationPageReceipt.php b/src/Framework/Receipts/Actions/GenerateConfirmationPageReceipt.php index f9fd192e58..9f9e3bfee9 100644 --- a/src/Framework/Receipts/Actions/GenerateConfirmationPageReceipt.php +++ b/src/Framework/Receipts/Actions/GenerateConfirmationPageReceipt.php @@ -16,7 +16,7 @@ class GenerateConfirmationPageReceipt { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(DonationReceipt $receipt): DonationReceipt { @@ -30,8 +30,8 @@ public function __invoke(DonationReceipt $receipt): DonationReceipt } /** - * @since 0.4.0 skip fields with non-existing meta - * @since 0.1.0 + * @since 3.0.0 skip fields with non-existing meta + * @since 3.0.0 */ protected function getCustomFields(Donation $donation): array { @@ -73,7 +73,7 @@ protected function getCustomFields(Donation $donation): array } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -118,7 +118,7 @@ private function fillDonationDetails(DonationReceipt $receipt) } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -147,8 +147,8 @@ private function fillDonorDetails(DonationReceipt $receipt) } /** - * @since 0.7.0 added comment field - * @since 0.1.0 + * @since 3.0.0 added comment field + * @since 3.0.0 * * @return void */ @@ -188,7 +188,7 @@ private function fillAdditionalDetails(DonationReceipt $receipt) /** * @since 0.3.3 update subscription amount label with frequency - * @since 0.1.0 + * @since 3.0.0 * * @return void */ @@ -234,7 +234,7 @@ private function fillSubscriptionDetails(DonationReceipt $receipt) } /** - * @since 0.1.0 + * @since 3.0.0 */ private function fillSettings(DonationReceipt $receipt) { @@ -255,7 +255,7 @@ private function fillSettings(DonationReceipt $receipt) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param int $formId * @return DonationForm|null @@ -270,8 +270,8 @@ protected function getDonationForm(int $formId) } /** - * @since 0.6.0 added backwards compatability for v2 forms tags - * @since 0.1.0 + * @since 3.0.0 added backwards compatability for v2 forms tags + * @since 3.0.0 */ protected function getHeading(DonationReceipt $receipt, DonationForm $donationForm = null): string { @@ -288,8 +288,8 @@ protected function getHeading(DonationReceipt $receipt, DonationForm $donationFo } /** - * @since 0.6.0 added backwards compatability for v2 forms tags - * @since 0.1.0 + * @since 3.0.0 added backwards compatability for v2 forms tags + * @since 3.0.0 */ protected function getDescription(DonationReceipt $receipt, DonationForm $donationForm = null): string { @@ -309,7 +309,7 @@ protected function getDescription(DonationReceipt $receipt, DonationForm $donati } /** - * @since 0.6.0 + * @since 3.0.0 */ protected function transformV2FormTags(string $content, Donation $donation): string { diff --git a/src/Framework/Receipts/DonationReceipt.php b/src/Framework/Receipts/DonationReceipt.php index 7f445641f4..d808aa13e9 100644 --- a/src/Framework/Receipts/DonationReceipt.php +++ b/src/Framework/Receipts/DonationReceipt.php @@ -36,7 +36,7 @@ class DonationReceipt implements Arrayable, Jsonable public $subscriptionDetails; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(Donation $donation) { @@ -50,7 +50,7 @@ public function __construct(Donation $donation) /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { @@ -64,7 +64,7 @@ public function toArray(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toJson($options = 0): string { diff --git a/src/Framework/Receipts/DonationReceiptBuilder.php b/src/Framework/Receipts/DonationReceiptBuilder.php index 2ce743985a..d8a9bef7ec 100644 --- a/src/Framework/Receipts/DonationReceiptBuilder.php +++ b/src/Framework/Receipts/DonationReceiptBuilder.php @@ -12,7 +12,7 @@ class DonationReceiptBuilder public $donationReceipt; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(DonationReceipt $donationReceipt) { @@ -20,7 +20,7 @@ public function __construct(DonationReceipt $donationReceipt) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toConfirmationPage(): DonationReceipt { diff --git a/src/Framework/Receipts/Properties/ReceiptDetail.php b/src/Framework/Receipts/Properties/ReceiptDetail.php index b2492917c3..b8f171104e 100644 --- a/src/Framework/Receipts/Properties/ReceiptDetail.php +++ b/src/Framework/Receipts/Properties/ReceiptDetail.php @@ -16,7 +16,7 @@ class ReceiptDetail implements Arrayable public $value; /** - * @since 0.1.0 + * @since 3.0.0 * * @param string $label * @param mixed $value @@ -27,7 +27,7 @@ public function __construct(string $label, $value) { } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/Framework/Receipts/Properties/ReceiptDetailCollection.php b/src/Framework/Receipts/Properties/ReceiptDetailCollection.php index 23cfb70728..8bff93d03f 100644 --- a/src/Framework/Receipts/Properties/ReceiptDetailCollection.php +++ b/src/Framework/Receipts/Properties/ReceiptDetailCollection.php @@ -15,7 +15,7 @@ class ReceiptDetailCollection implements Arrayable protected $receiptDetails; /** - * @since 0.1.0 + * @since 3.0.0 * * @param ReceiptDetail[] $receiptDetails */ @@ -25,7 +25,7 @@ public function __construct(array $receiptDetails = []) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param ReceiptDetail $receiptDetail * @return void @@ -36,7 +36,7 @@ public function addDetail(ReceiptDetail $receiptDetail) } /** - * @since 0.1.0 + * @since 3.0.0 * * @param ReceiptDetail[] $receiptDetails * @return void @@ -55,7 +55,7 @@ public function getDetails(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/Framework/Receipts/Properties/ReceiptSettings.php b/src/Framework/Receipts/Properties/ReceiptSettings.php index ee3ecb67b7..6ccf675b99 100644 --- a/src/Framework/Receipts/Properties/ReceiptSettings.php +++ b/src/Framework/Receipts/Properties/ReceiptSettings.php @@ -20,7 +20,7 @@ public function __construct(array $settings = []) { } /** - * @since 0.1.0 + * @since 3.0.0 * * @param string $key * @param $value @@ -34,7 +34,7 @@ public function addSetting(string $key, $value): ReceiptSettings } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getSettings(): array { @@ -42,7 +42,7 @@ public function getSettings(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toArray(): array { diff --git a/src/Framework/Routes/Route.php b/src/Framework/Routes/Route.php index e17b738d4a..919045c19a 100644 --- a/src/Framework/Routes/Route.php +++ b/src/Framework/Routes/Route.php @@ -5,7 +5,7 @@ use Give\Framework\Support\Facades\Facade; /** - * @since 0.1.0 + * @since 3.0.0 * * @method static string get(string $uri, string|callable $action, string $method = '_invoke') * @method static void post(string $uri, string|callable $action, string $method = '_invoke') diff --git a/src/Framework/Routes/RouteListener.php b/src/Framework/Routes/RouteListener.php index be2e73c05f..9bc057436d 100644 --- a/src/Framework/Routes/RouteListener.php +++ b/src/Framework/Routes/RouteListener.php @@ -20,7 +20,7 @@ public function __construct(string $event, string $listener) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function isValid(array $request, callable $validation = null): bool { @@ -33,7 +33,7 @@ public function isValid(array $request, callable $validation = null): bool } /** - * @since 0.1.0 + * @since 3.0.0 */ public function toUrl(string $originUrl, array $args = []): string { diff --git a/src/Framework/Routes/Router.php b/src/Framework/Routes/Router.php index db2ad6e8b6..53e7a7d9cf 100644 --- a/src/Framework/Routes/Router.php +++ b/src/Framework/Routes/Router.php @@ -10,7 +10,7 @@ class Router { /** - * @since 0.1.0 + * @since 3.0.0 * @param string $uri * @param string|callable $action * @param string $method @@ -23,7 +23,7 @@ public function get(string $uri, $action, $method = '__invoke') } /** - * @since 0.1.0 + * @since 3.0.0 * @param string $uri * @param string|callable $action * @param string $method @@ -36,7 +36,7 @@ public function post(string $uri, $action, $method = '__invoke') } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function isRouteValid(string $route): bool { @@ -44,7 +44,7 @@ protected function isRouteValid(string $route): bool } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function getRequestDataByType(string $type): array { @@ -56,8 +56,8 @@ protected function getRequestDataByType(string $type): array } /** - * @since 0.6.0 updated to check for "application/json" content-type first before accessing request super globals - * @since 0.1.0 + * @since 3.0.0 updated to check for "application/json" content-type first before accessing request super globals + * @since 3.0.0 */ protected function getDataFromPostRequest(): array { @@ -82,7 +82,7 @@ protected function getDataFromPostRequest(): array } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function getDataFromGetRequest(): array { @@ -90,7 +90,7 @@ protected function getDataFromGetRequest(): array } /** - * @since 0.1.0 + * @since 3.0.0 * * @param string $type * @param string $method @@ -122,7 +122,7 @@ protected function addRoute(string $type, string $method, string $uri, $action) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function url(string $uri, array $args = []): string { diff --git a/src/Framework/Support/Scripts/Concerns/HasScriptAssetFile.php b/src/Framework/Support/Scripts/Concerns/HasScriptAssetFile.php index 6ea3d5b3b5..885fda614a 100644 --- a/src/Framework/Support/Scripts/Concerns/HasScriptAssetFile.php +++ b/src/Framework/Support/Scripts/Concerns/HasScriptAssetFile.php @@ -4,7 +4,7 @@ trait HasScriptAssetFile { /** - * @since 0.5.0 + * @since 3.0.0 */ protected function getScriptAssetDependencies(string $path) { @@ -14,7 +14,7 @@ protected function getScriptAssetDependencies(string $path) } /** - * @since 0.5.0 + * @since 3.0.0 */ protected function getScriptAssetVersion(string $path) { @@ -26,7 +26,7 @@ protected function getScriptAssetVersion(string $path) /** * @see https://developer.wordpress.org/block-editor/reference-guides/packages/packages-dependency-extraction-webpack-plugin/#wordpress * - * @since 0.5.0 + * @since 3.0.0 */ protected function getScriptAsset(string $path): array { diff --git a/src/Framework/TemplateTags/Actions/TransformTemplateTags.php b/src/Framework/TemplateTags/Actions/TransformTemplateTags.php index 9ca625f806..71dfb78aee 100644 --- a/src/Framework/TemplateTags/Actions/TransformTemplateTags.php +++ b/src/Framework/TemplateTags/Actions/TransformTemplateTags.php @@ -5,7 +5,7 @@ class TransformTemplateTags { /** - * @since 0.1.0 + * @since 3.0.0 */ public function __invoke(string $content, array $tags): string { diff --git a/src/Framework/TemplateTags/DonationTemplateTags.php b/src/Framework/TemplateTags/DonationTemplateTags.php index 7a4e6a61e7..db84cae5b4 100644 --- a/src/Framework/TemplateTags/DonationTemplateTags.php +++ b/src/Framework/TemplateTags/DonationTemplateTags.php @@ -17,7 +17,7 @@ class DonationTemplateTags protected $content; /** - * @since 0.1.0 + * @since 3.0.0 */ public function __construct(Donation $donation, string $content) { @@ -26,7 +26,7 @@ public function __construct(Donation $donation, string $content) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function getContent(): string { @@ -34,7 +34,7 @@ public function getContent(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function getTags(): array { diff --git a/src/PaymentGateways/Gateways/PayPal/PayPalStandardGateway/PayPalStandardGateway.php b/src/PaymentGateways/Gateways/PayPal/PayPalStandardGateway/PayPalStandardGateway.php index 6ec4862ffc..3db5fdbdf9 100644 --- a/src/PaymentGateways/Gateways/PayPal/PayPalStandardGateway/PayPalStandardGateway.php +++ b/src/PaymentGateways/Gateways/PayPal/PayPalStandardGateway/PayPalStandardGateway.php @@ -25,7 +25,7 @@ public function getLegacyFormFieldMarkup(int $formId, array $args): string } /** - * @since 0.5.0 + * @since 3.0.0 */ public function enqueueScript(int $formId) { diff --git a/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceGateway.php b/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceGateway.php index c7c3becade..29cb4e4872 100644 --- a/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceGateway.php +++ b/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceGateway.php @@ -15,7 +15,7 @@ class PayPalCommerceGateway extends PayPalCommerce use HasScriptAssetFile; /** - * @since 0.5.0 + * @since 3.0.0 */ public function enqueueScript(int $formId) { diff --git a/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceSubscriptionModule.php b/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceSubscriptionModule.php index 9e842ef71c..51e285e5fd 100644 --- a/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceSubscriptionModule.php +++ b/src/PaymentGateways/Gateways/PayPalCommerce/PayPalCommerceSubscriptionModule.php @@ -14,7 +14,7 @@ class PayPalCommerceSubscriptionModule extends SubscriptionModule { /** - * @since 0.3.0 + * @since 3.0.0 */ public function createSubscription( Donation $donation, diff --git a/src/PaymentGateways/Gateways/ServiceProvider.php b/src/PaymentGateways/Gateways/ServiceProvider.php index cc26e3fd95..cd3c90da68 100644 --- a/src/PaymentGateways/Gateways/ServiceProvider.php +++ b/src/PaymentGateways/Gateways/ServiceProvider.php @@ -32,7 +32,7 @@ class ServiceProvider implements ServiceProviderInterface use HasScriptAssetFile; /** - * @since 0.4.0 + * @since 3.0.0 */ public function register() { @@ -40,7 +40,7 @@ public function register() } /** - * @since 0.4.0 + * @since 3.0.0 */ public function boot() { @@ -57,7 +57,7 @@ public function boot() } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws Exception * @throws OverflowException @@ -126,7 +126,7 @@ static function () { } /** - * @since 0.3.0 + * @since 3.0.0 */ private function addStripeWebhookListeners() { @@ -167,7 +167,7 @@ private function addStripeWebhookListeners() } /** - * @since 0.3.0 + * @since 3.0.0 */ private function addLegacyStripeAdapter() { @@ -179,7 +179,7 @@ private function addLegacyStripeAdapter() } /** - * @since 0.5.0 + * @since 3.0.0 */ protected function enqueueGatewayScripts() { diff --git a/src/PaymentGateways/Gateways/Stripe/LegacyStripeAdapter.php b/src/PaymentGateways/Gateways/Stripe/LegacyStripeAdapter.php index 0353331848..a91b99d612 100644 --- a/src/PaymentGateways/Gateways/Stripe/LegacyStripeAdapter.php +++ b/src/PaymentGateways/Gateways/Stripe/LegacyStripeAdapter.php @@ -15,7 +15,7 @@ class LegacyStripeAdapter * This also makes it possible to load the files without the use of the give_stripe_supported_payment_methods filter. * * @since 0.3.2 Fix reference to Next Gen gateway when loading Stripe (legacy) code. - * @since 0.3.0 + * @since 3.0.0 */ public function loadLegacyStripeWebhooksAndFilters() { @@ -41,7 +41,7 @@ public function loadLegacyStripeWebhooksAndFilters() * * If this is not included, then the webhooks will not be registered unless a legacy stripe gateway is enabled. * - * @since 0.3.0 + * @since 3.0.0 */ public function addToStripeSupportedPaymentMethodsList() { @@ -59,7 +59,7 @@ public function addToStripeSupportedPaymentMethodsList() /** * This adds the Stripe details to the donation details page. * - * @since 0.3.0 + * @since 3.0.0 */ public function addDonationDetails() { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripeGatewayData.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripeGatewayData.php index d15ec1fa86..ec3011ebfc 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripeGatewayData.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripeGatewayData.php @@ -22,7 +22,7 @@ class StripeGatewayData public $stripePaymentMethodIsCreditCard; /** - * @since 0.3.0 + * @since 3.0.0 * * @param array{stripeConnectedAccountKey: string, stripePaymentIntentId: string} $request * @return StripeGatewayData diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripePaymentIntentData.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripePaymentIntentData.php index 819ff5d618..654de1a69f 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripePaymentIntentData.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/DataTransferObjects/StripePaymentIntentData.php @@ -43,7 +43,7 @@ class StripePaymentIntentData public $receiptEmail; /** - * @since 0.3.0 + * @since 3.0.0 * * @param array{amount: string, currency: string, customer: string, description: string, metadata: array, automatic_payment_methods: array, application_fee_amount: string, statement_descriptor: string, receipt_email: string } $array */ @@ -64,7 +64,7 @@ public static function fromArray(array $array): self } /** - * @since 0.3.0 + * @since 3.0.0 */ public function toParams() { @@ -96,7 +96,7 @@ public function toParams() } /** - * @since 0.3.0 + * @since 3.0.0 */ public function toOptions(string $stripeConnectAccountId): array { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementGateway.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementGateway.php index c016f44228..4a4baea251 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementGateway.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementGateway.php @@ -11,7 +11,7 @@ use Stripe\Exception\ApiErrorException; /** - * @since 0.1.0 + * @since 3.0.0 */ class StripePaymentElementGateway extends PaymentGateway { @@ -51,7 +51,7 @@ public function getPaymentMethodLabel(): string } /** - * @since 0.1.0 + * @since 3.0.0 */ public function enqueueScript(int $formId) { @@ -67,7 +67,7 @@ public function enqueueScript(int $formId) } /** - * @since 0.1.0 + * @since 3.0.0 */ public function formSettings(int $formId): array { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementRepository.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementRepository.php index 25b5a115d9..87b7129fa9 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementRepository.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/StripePaymentElementRepository.php @@ -19,8 +19,8 @@ trait StripePaymentElementRepository { /** - * @since 0.3.0 update params to use StripePaymentIntentData - * @since 0.1.0 + * @since 3.0.0 update params to use StripePaymentIntentData + * @since 3.0.0 * @throws ApiErrorException */ protected function generateStripePaymentIntent( @@ -36,7 +36,7 @@ protected function generateStripePaymentIntent( /** * Get or create Stripe Customer from Donation * - * @since 0.1.0 + * @since 3.0.0 * @throws Exception * @throws ApiErrorException */ @@ -91,7 +91,7 @@ public function getOrCreateStripeCustomerFromDonation( } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws InvalidPropertyName */ @@ -128,8 +128,8 @@ protected function getPaymentIntentDataFromDonation( } /** - * @since 0.6.0 no longer store the intent secret - * @since 0.3.0 + * @since 3.0.0 no longer store the intent secret + * @since 3.0.0 * * @return void * @throws Exception @@ -154,7 +154,7 @@ protected function updateDonationMetaFromPaymentIntent( } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function getStripePublishableKey(int $formId): string { @@ -162,7 +162,7 @@ protected function getStripePublishableKey(int $formId): string } /** - * @since 0.1.0 + * @since 3.0.0 */ protected function getStripeConnectedAccountKey(int $formId): string { @@ -170,7 +170,7 @@ protected function getStripeConnectedAccountKey(int $formId): string } /** - * @since 0.1.0 + * @since 3.0.0 * * @return void; */ @@ -180,7 +180,7 @@ protected function setUpStripeAppInfo(int $formId) } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws ApiErrorException */ @@ -196,7 +196,7 @@ protected function createCustomer(Donation $donation, string $connectAccountId): } /** - * @since 0.1.0 + * @since 3.0.0 * * @throws ApiErrorException|InvalidRequestException */ diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Decorators/SubscriptionModelDecorator.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Decorators/SubscriptionModelDecorator.php index 19542a03bc..5811846ea0 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Decorators/SubscriptionModelDecorator.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Decorators/SubscriptionModelDecorator.php @@ -18,7 +18,7 @@ class SubscriptionModelDecorator { public $subscription; /** - * @since 0.3.0 + * @since 3.0.0 */ public function __construct(Subscription $subscription) { @@ -26,7 +26,7 @@ public function __construct(Subscription $subscription) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function shouldEndSubscription(): bool { @@ -36,7 +36,7 @@ public function shouldEndSubscription(): bool } /** - * @since 0.3.0 + * @since 3.0.0 */ public function shouldCreateRenewal(): bool { @@ -47,7 +47,7 @@ public function shouldCreateRenewal(): bool } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ @@ -92,7 +92,7 @@ public function handleRenewal(Invoice $invoice): SubscriptionModelDecorator } /** - * @since 0.3.0 + * @since 3.0.0 * @throws Exception */ public function cancelSubscription() @@ -101,7 +101,7 @@ public function cancelSubscription() } /** - * @since 0.3.0 + * @since 3.0.0 * @throws Exception */ public function handleSubscriptionCompleted() diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/ChargeRefunded.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/ChargeRefunded.php index c190f1ad35..5d363da6da 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/ChargeRefunded.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/ChargeRefunded.php @@ -9,7 +9,7 @@ use Stripe\Event; /** - * @since 0.3.0 + * @since 3.0.0 */ class ChargeRefunded { @@ -22,7 +22,7 @@ class ChargeRefunded * * @see https://stripe.com/docs/api/events/types#event_types-charge.refunded * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -39,7 +39,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionCreated.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionCreated.php index cc50d8afca..73a6e8e7a1 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionCreated.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionCreated.php @@ -7,7 +7,7 @@ use Stripe\Subscription as StripeSubscription; /** - * @since 0.3.0 + * @since 3.0.0 */ class CustomerSubscriptionCreated { @@ -20,7 +20,7 @@ class CustomerSubscriptionCreated * * @see https://stripe.com/docs/api/events/types#event_types-customer.subscription.created * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -37,7 +37,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function processEvent(Event $event) { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionDeleted.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionDeleted.php index 68dae7a2b1..8561b12b2e 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionDeleted.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/CustomerSubscriptionDeleted.php @@ -8,7 +8,7 @@ use Stripe\Subscription as StripeSubscription; /** - * @since 0.3.0 + * @since 3.0.0 */ class CustomerSubscriptionDeleted { @@ -21,7 +21,7 @@ class CustomerSubscriptionDeleted * * @see https://stripe.com/docs/api/events/types#event_types-customer.subscription.deleted * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -38,7 +38,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 * @throws Exception */ public function processEvent(Event $event) diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentFailed.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentFailed.php index f6da194983..0154b8796a 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentFailed.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentFailed.php @@ -8,7 +8,7 @@ use Stripe\Invoice; /** - * @since 0.3.0 + * @since 3.0.0 */ class InvoicePaymentFailed { @@ -21,7 +21,7 @@ class InvoicePaymentFailed * * @see https://stripe.com/docs/api/events/types#event_types-invoice.payment_failed * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -38,7 +38,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ @@ -67,7 +67,7 @@ public function processEvent(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function triggerLegacyFailedEmailNotificationEvent(Invoice $invoice) { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentSucceeded.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentSucceeded.php index cd8c1f08bf..be8e06988b 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentSucceeded.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/InvoicePaymentSucceeded.php @@ -12,7 +12,7 @@ use Stripe\Invoice; /** - * @since 0.3.0 + * @since 3.0.0 */ class InvoicePaymentSucceeded { @@ -25,7 +25,7 @@ class InvoicePaymentSucceeded * * @see https://stripe.com/docs/api/events/types#event_types-invoice.payment_succeeded * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws \Exception @@ -42,7 +42,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 * @throws \Exception */ public function processEvent(Event $event) @@ -74,7 +74,7 @@ public function processEvent(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function getSubscriptionModelDecorator(Subscription $subscription): SubscriptionModelDecorator { @@ -83,7 +83,7 @@ protected function getSubscriptionModelDecorator(Subscription $subscription): Su /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ @@ -103,7 +103,7 @@ protected function handleInitialDonation(Donation $initialDonation) } /** - * @since 0.3.0 + * @since 3.0.0 * @throws \Exception */ protected function cancelSubscription(SubscriptionModelDecorator $subscriptionModel) diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentPaymentFailed.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentPaymentFailed.php index ed1d383690..4cc6148b5d 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentPaymentFailed.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentPaymentFailed.php @@ -9,7 +9,7 @@ use Stripe\PaymentIntent; /** - * @since 0.3.0 + * @since 3.0.0 */ class PaymentIntentPaymentFailed { @@ -22,7 +22,7 @@ class PaymentIntentPaymentFailed * * @see https://stripe.com/docs/api/events/types#event_types-payment_intent.payment_failed * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -39,7 +39,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function processEvent(Event $event) { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentSucceeded.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentSucceeded.php index d0191b64c7..5460e56957 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentSucceeded.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/PaymentIntentSucceeded.php @@ -9,7 +9,7 @@ use Stripe\PaymentIntent; /** - * @since 0.3.0 + * @since 3.0.0 */ class PaymentIntentSucceeded { @@ -22,7 +22,7 @@ class PaymentIntentSucceeded * * @see https://stripe.com/docs/api/events/types#event_types-invoice.payment_succeeded * - * @since 0.3.0 + * @since 3.0.0 * * @return void * @throws Exception @@ -39,7 +39,7 @@ public function __invoke(Event $event) } /** - * @since 0.3.0 + * @since 3.0.0 */ public function processEvent(Event $event) { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/StripeWebhookListenerRepository.php b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/StripeWebhookListenerRepository.php index f3e915f9cc..a754437ba8 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/StripeWebhookListenerRepository.php +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/Webhooks/Listeners/StripeWebhookListenerRepository.php @@ -12,7 +12,7 @@ trait StripeWebhookListenerRepository { /** - * @since 0.3.0 + * @since 3.0.0 */ protected function shouldProcessSubscription(Subscription $subscription): bool { @@ -20,7 +20,7 @@ protected function shouldProcessSubscription(Subscription $subscription): bool } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function shouldProcessDonation(Donation $donation): bool { @@ -28,7 +28,7 @@ protected function shouldProcessDonation(Donation $donation): bool } /** - * @since 0.3.0 + * @since 3.0.0 */ protected function logWebhookError(Event $event, Exception $exception) { diff --git a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/stripePaymentElementGateway.tsx b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/stripePaymentElementGateway.tsx index dc595502ce..dc92c98569 100644 --- a/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/stripePaymentElementGateway.tsx +++ b/src/PaymentGateways/Gateways/Stripe/StripePaymentElementGateway/stripePaymentElementGateway.tsx @@ -35,8 +35,8 @@ const zeroDecimalCurrencies = [ /** * Takes in an amount value in dollar units and returns the calculated cents amount * - * @since 0.6.0 update conversion to round up to nearest integer - * @since 0.3.0 + * @since 3.0.0 update conversion to round up to nearest integer + * @since 3.0.0 */ const dollarsToCents = (amount: string, currency: string) => { if (zeroDecimalCurrencies.includes(currency)) { diff --git a/src/PaymentGateways/Gateways/TestGateway/TestGatewaySubscriptionModule.php b/src/PaymentGateways/Gateways/TestGateway/TestGatewaySubscriptionModule.php index f7f17c4804..844ed136c2 100644 --- a/src/PaymentGateways/Gateways/TestGateway/TestGatewaySubscriptionModule.php +++ b/src/PaymentGateways/Gateways/TestGateway/TestGatewaySubscriptionModule.php @@ -14,7 +14,7 @@ class TestGatewaySubscriptionModule extends SubscriptionModule implements SubscriptionAmountEditable { /** - * @since 0.3.0 + * @since 3.0.0 */ public function createSubscription( Donation $donation, @@ -29,7 +29,7 @@ public function createSubscription( /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ @@ -40,7 +40,7 @@ public function cancelSubscription(Subscription $subscription) } /** - * @since 0.3.0 + * @since 3.0.0 * * @throws Exception */ diff --git a/src/Promotions/ServiceProviderV3.php b/src/Promotions/ServiceProviderV3.php index 1092d0cc2e..b961051c69 100644 --- a/src/Promotions/ServiceProviderV3.php +++ b/src/Promotions/ServiceProviderV3.php @@ -6,7 +6,7 @@ use Give\ServiceProviders\ServiceProvider as ServiceProviderInterface; /** - * @since 0.1.0 + * @since 3.0.0 */ class ServiceProviderV3 implements ServiceProviderInterface {