formId = (int)$requestData['formId']; $self->gatewayId = $requestData['gatewayId']; $self->originUrl = $requestData['originUrl']; $self->isEmbed = filter_var($requestData['isEmbed'], FILTER_VALIDATE_BOOLEAN); $self->embedId = $self->isEmbed ? $requestData['embedId'] : null; $self->requestData = $requestData; return $self; } /** * This method loops over the form schema to * compares the request against the individual fields, * their types and validation rules. * * @since 3.22.0 added givewp_donation_form_fields_validated action * @since 3.14.0 Added form status validation * @since 3.0.0 * * @throws DonationFormFieldErrorsException|NameCollisionException|DonationFormForbidden */ public function validated(): DonateControllerData { $request = $this->getRequestData(); $validData = new DonateControllerData(); /** @var DonationForm $form */ $form = DonationForm::find($this->formId); if (!$form || !$this->isValidForm($form)) { throw new DonationFormForbidden(); } $validator = (new CreateValidatorFromForm())($form->schema(), $request); if ($validator->fails()) { $this->throwDonationFormFieldErrorsException($validator->errors()); } $validatedValues = $validator->validated(); /** * @since 4.16.0 added $isFinalSubmission (true here: the final donation submission) * @since 3.22.0 * * @param array $data validated values in key value pairs * @param bool $isFinalSubmission whether this is the final donation submission */ do_action('givewp_donation_form_fields_validated', $validatedValues, true); foreach ($validatedValues as $fieldId => $value) { $validData->{$fieldId} = $value; } $validData->formTitle = $form->title; $validData->wpUserId = get_current_user_id(); $validData->originUrl = $this->originUrl; $validData->embedId = $this->embedId; $validData->isEmbed = $this->isEmbed; return $validData; } /** * @since 3.0.0 */ public function getRequestData(): array { return $this->requestData; } /** * This loops over an array of errors in the specific FieldAPI format, * and converts them into a WP_Error object that is attached to the * exception and delivered back to the client via JSON. * * @since 3.0.0 * * @param array $errors * * @throws DonationFormFieldErrorsException */ private function throwDonationFormFieldErrorsException(array $errors) { $wpError = new WP_Error(); foreach ($errors as $id => $error) { $wpError->add($id, $error); } throw new DonationFormFieldErrorsException($wpError); } /** * @since 3.0.0 */ public function toArray(): array { return get_object_vars($this); } /** * @since 4.14.0.0 update permission capability to use facade * @since 3.14.0 */ private function isValidForm(DonationForm $form): bool { if ($form->status->isTrash()) { return false; } if (!$form->status->isPublished() && !UserPermissions::donationForms()->canEdit()) { return false; } return true; } }