Necessary Shortcodes and Pages When Using New Form and Dashboard

  • Resolved jfbprivate

    (@jfbprivate)


    3 years, 8 months ago

    Hello,

    I only have a a couple questions regarding shortcodes and default pages:

    1) Are the following shortcodes (and pages) even relevant anymore when using the Multi-Step Donation Form and Dashboard, or are those only necessary when using the Legacy Form?

    The shortcodes in question: GiveWP Receipt Shortcode, GiveWP Donation History Shortcode, and GiveWP Profile Editor Shortcode

    It seems the donation history is accessible via the dashboard, so there would be no need for an extra page. It also seems that the receipt is automatically being shown after the donation process, so there would be no need for the receipt shortcode either. The same seems to be true for the profile editor shortcode.

    2) Are the Donation Confirmation and Donation Failure pages still necessary when using the Multi-Step Donation Form and Dashboard? Because it looks like they’re not even being touched after the donation process. Instead the result is being shown within the actual donation form page, e.g., “donate” or “give,” or are they crucial for handling the process anyway?

    Thanks much for clarification!

Viewing 4 replies - 1 through 4 (of 4 total)
  • Plugin Support Rick Alday

    (@mrdaro)

    Hi @jfbprivate,

    Happy to clarify.

    The GiveWP Receipt Shortcode which is used in the Donation Confirmation page is still required even if you use the multi-step form template.

    During the donation process, GiveWP checks for the existence of the donation confirmation page and the shortcode to display the donation receipt for all form templates.

    The other pages that use the GiveWP Donation History Shortcode, and GiveWP Profile Editor Shortcode are not required if you now use the new Donor Dashboard page.

    Let me know if you have any other questions.

    Thread Starter jfbprivate

    (@jfbprivate)

    Hi @mrdaro,

    Thanks for the clarification.

    So basically you’re saying that all shortcodes that would also be available from the Dashboard are optional. You also state that the Confirmation page is necessary and must include the receipt shortcode. However, I am not using the shortcode and the receipt is showing just fine. On your website it also says the following:

    “If you use our Legacy form template, your donors want to confidently see confirmation that the donation they submitted was successful. Reiterating and displaying what they donated is a confirmation that you collected the proper information. Without this shortcode, your donors will not see a confirmation of their donation or important information about their donation history.”

    Since I am using the multi-step form it seems I can ignore it. Am I missing something?

    And one last thing: Is the Failure page required or not?

    Thanks much again!

    Plugin Support Rick Alday

    (@mrdaro)

    The Failure Page is not required but the Donation Confirmation page with the [give_receipt] shortcode is a must even if you use the multi-step form template.

    The sequence of events is as follows:
    – Upon a successful payment, the multi-step form shows the receipt:
    https://github.com/impress-org/givewp/blob/master/src/Controller/Form.php#L113

    That line calls the showReceiptInIframeOnSuccessPage function:
    https://github.com/impress-org/givewp/blob/master/src/Controller/Form.php#L164

    The showReceiptInIframeOnSuccessPage function then calls the getReceiptShortcodeFromConfirmationPage function:
    https://github.com/impress-org/givewp/blob/master/src/Controller/Form.php#L165

    The getReceiptShortcodeFromConfirmationPage function checks for the existance of the [give_receipt] shortcode on the Donation Confirmation page:
    https://github.com/impress-org/givewp/blob/master/src/Helpers/Frontend/Shortcode.php#L12

    Hope that clears things up.

    Thread Starter jfbprivate

    (@jfbprivate)

    Hi @mrdaro,

    I appreciate the detailed response here.

    No need to figure it out really, but it actually makes me wonder why and how the success page is still working without using the shortcode.

    Thanks again!

Viewing 4 replies - 1 through 4 (of 4 total)
  • The topic ‘Necessary Shortcodes and Pages When Using New Form and Dashboard’ is closed to new replies.