Reading time: 3 minutes | Difficulty: Beginner
Overview
The [wppal_checkout] shortcode is an alternative way to display payment forms. This guide covers its usage and options.
Prerequisites
- At least one payment form created
- Understanding of shortcode basics
Basic Usage
[wppal_checkout form_id="123"]
This is functionally equivalent to [wppal_form id="123"].
Shortcode Comparison
| Shortcode | Attribute | Notes |
|---|---|---|
[wppal_form] |
id="123" |
Primary shortcode |
[wppal_checkout] |
form_id="123" |
Alternative shortcode |
Both display the same form in the same way.
When to Use Each
Use [wppal_form]
- Simpler syntax
- Primary/recommended
idattribute
Use [wppal_checkout]
- Personal preference
- More descriptive name
form_idattribute
Examples
Standard Form
[wppal_checkout form_id="42"]
In Page Content
<h2>Complete Your Purchase</h2>
[wppal_checkout form_id="42"]
Multiple Forms
[wppal_checkout form_id="10"]
[wppal_checkout form_id="20"]
Attributes
form_id (Required)
The ID of the payment form to display:
[wppal_checkout form_id="123"]
Display Output
The shortcode outputs the same as [wppal_form]:
- Embedded forms display inline
- Overlay forms show button
- Respects form type setting
Finding the Form ID
- Go to Payment Forms
- Find your form
- Check the ID column
- Use in shortcode
Where to Place
Page/Post Editor
- Add Shortcode block
- Enter shortcode
- Publish/update
Widgets
- Add Text widget
- Paste shortcode
- Save
PHP Templates
<?php echo do_shortcode('[wppal_checkout form_id="123"]'); ?>
Practical Examples
Product Purchase
<div class="product-checkout">
<h3>Buy Now - $49</h3>
[wppal_checkout form_id="55"]
</div>
Donation Widget
<div class="sidebar-donate">
<p>Support our cause</p>
[wppal_checkout form_id="33"]
</div>
Membership Signup
<section class="membership">
<h2>Join Today</h2>
<p>Get access to all premium content.</p>
[wppal_checkout form_id="88"]
</section>
Mixing Shortcodes
You can use both shortcode types on the same site:
Page 1: [wppal_form id="10"]
Page 2: [wppal_checkout form_id="20"]
Both work fine simultaneously.
Shortcode Generator
In the form editor or forms list:
- Find the Shortcode column
- Copy the provided shortcode
- This gives you the correct format
Common Issues
Form Not Showing
- Check form_id is correct
- Verify form is published
- Check form restrictions
Shortcode Displays as Text
- Verify attribute syntax
- Check for curly quotes
- Ensure plugin is active
Wrong Form Displays
- Double-check the form_id
- Each form has a unique ID
Troubleshooting Steps
- Verify shortcode syntax
- Confirm form ID exists
- Check form is published
- Test without caching
- Check browser console
Best Practices
- Use consistent shortcode – Pick one style
- Copy from admin – Avoid typos
- Test after placing – Verify it works
- Document IDs – Know which ID is which
Which Shortcode to Choose?
For most users, either works fine. Choose based on:
- What you remember easier
- What documentation/tutorials used
- Team preference
Both are fully supported.
What’s Next?
- Using the Payment Form Shortcode – Primary shortcode
- Using the Gutenberg Block – Block editor
- Embedding Forms on Your Website – All methods