Documentation

Complete guide for installing, configuring, and using Gift Cards for Amelia (v1.0.0).

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Amelia Booking Plugin v9+ — any license (Starter, Standard, Pro, or Premium). Requires the Finance module (coupons).
• A Stripe or Square account — for payment processing
• SSL certificate — required for payments (HTTPS)

Installation

1. Download the amelia-gift-cards.zip file from your LemonSqueezy account
2. Go to WordPress Admin → Plugins → Add New
3. Click Upload Plugin and select the ZIP file
4. Click Install Now, then Activate

After activation, you should see a "Gift Cards" menu in your WordPress admin sidebar.

Quick Start

Get your gift card system running in under 10 minutes:

1. Activate the plugin — an admin notice appears with a link to the License page and information about the Divi module
2. Configure payments — Stripe/Square auto-detected from Amelia (Pro/Premium) or enter keys manually
3. Create a gift card type — go to Gift Cards → Types and create your first type
4. Add the form to a page — insert [agc_gift_card_form] on any page
5. Test a purchase — use test mode to verify everything works

Payment Setup

Stripe Setup

Automatic (Pro / Premium)

If you have Amelia Pro or Premium, the plugin automatically uses your existing Stripe configuration from Amelia. No additional setup required.

Manual (Starter / Standard)

If you have Amelia Starter or Standard:

1. Go to Gift Cards → Settings → Payments
2. Enter your Stripe Publishable Key and Secret Key
3. Enable Test Mode for initial testing
4. Click Save & Verify to test the connection

Square Setup

Square is also supported as a payment provider:

1. Go to Gift Cards → Settings → Payments
2. Select Square as your payment provider
3. Enter your Square Application ID and Access Token
4. Click Save & Verify to test the connection

General Settings

Navigate to Gift Cards → Settings → General to configure:

• Default Currency — auto-detected from your site, changeable
• Expiration Period — default 365 days
• Code Format — prefix and pattern for gift card codes (e.g., GC-XXXXXXX)
• Suggested Amounts — pre-defined amounts shown in the purchase form
• Custom Amounts — allow customers to enter any amount within a min/max range

Email Settings

Configure email delivery at Gift Cards → Settings → Email:

• From Name — sender name for emails
• From Email — sender email address
• Reply-To Email — where replies go
• Enable/disable specific email types (purchase confirmation, recipient notification, etc.)

Advanced Settings

• Debug Mode — enable detailed logging for troubleshooting

Creating Gift Card Types

Gift card types define the look, amounts, and restrictions for your gift cards.

1. Go to Gift Cards → Types
2. Click Add New Type
3. Fill in the name, description, and select an email template
4. Configure amounts and restrictions
5. Save

Amounts & Pricing

For each type, you can configure:

• Suggested Amounts — pre-set buttons (e.g., $25, $50, $100, $200)
• Custom Amount — allow free-form entry with min/max limits
• Currency — override the default currency per type

Restrictions

Restrict gift cards to specific Amelia services:

• Services — limit to specific services
• Packages — limit to specific packages
• Events — limit to specific events

Email Templates

The plugin includes 6 professionally designed email templates:

• Spa & Wellness — calming greens, Georgia font
• Restaurant & Gastronomy — warm browns, Georgia font
• Beauty Salon — elegant pinks, Arial font
• Fitness & Sport — energetic oranges, Helvetica font
• Health & Medical — professional blues, Arial font
• Generic — versatile grays, Arial font

Each template can be fully customized with the built-in WYSIWYG editor — change colors, text, images, and layout.

WordPress Shortcode

Add the gift card purchase form to any page or post:

[agc_gift_card_form]

With Parameters

[agc_gift_card_form
    title="Buy a Gift Card"
    description="Give the perfect gift"
    amounts="25,50,100,200"
    allow_custom="yes"
    min_amount="10"
    max_amount="500"
    currency="EUR"
    css_class="my-custom-class"
]

Divi Builder Module

If you use the Divi theme, a native Gift Card module is available:

1. Edit a page with Divi Builder
2. Click Add Module and search for "Gift Card"
3. Configure the design options (colors, fonts, spacing)
4. Save and publish

Frontend Form

The purchase form guides customers through 3 steps:

1. Choose Amount — select a preset or enter a custom amount
2. Recipient Details — name, email, personal message
3. Payment — secure Stripe or Square checkout with 3D Secure support

After payment, the recipient receives a beautifully designed email with their gift card code.

Dashboard

The dashboard (Gift Cards → Dashboard) provides:

• Sales Overview — total revenue, number of cards sold, average value
• Transaction History — filterable list of all transactions
• Email Stats — delivery rates, open rates
• Quick Actions — create manual cards, export data

Manual Gift Card Creation

Create gift cards directly from the admin:

1. Go to Gift Cards → Add New
2. Fill in the amount, recipient details, and optional message
3. Choose whether to send the notification email
4. Click Create

Export

Export gift card data from the Dashboard (CSV report) or from Gift Cards → Logs (CSV log export). Filter by date range or status before exporting.

Logs

View all system activity at Gift Cards → Logs:

• Filter by action type, date range, user, or gift card
• View detailed log entries with timestamps
• Export logs in CSV format
• Log stats: total entries, entries by type, error rate

Shortcode Reference

[agc_gift_card_form]

Main purchase form with Stripe integration.

Common Issues

Gift Cards menu not visible

Ensure the Amelia Booking plugin is installed and activated. The Gift Cards plugin requires Amelia to function.

Payment errors

• Verify your Stripe or Square API keys are correct
• Ensure your site has an SSL certificate (HTTPS)
• Check that webhooks are configured
• Try enabling Test Mode first

Emails not being received

• Check your spam/junk folder
• Verify the "From Email" address in settings
• Test with the built-in email test tool: Gift Cards → Settings → Email → Send Test
• Consider using an SMTP plugin like WP Mail SMTP

Form not displaying

• Check for JavaScript errors in the browser console
• Ensure the shortcode is typed correctly: [agc_gift_card_form]
• Clear any caching plugins

Diagnostics

The built-in diagnostics system (Gift Cards → Diagnostics) checks:

• System Requirements — PHP version, WordPress version, required extensions
• Plugin Dependencies — Amelia status, payment connection
• Database — table integrity, orphaned records
• Email — delivery capability, template integrity
• Performance — response times, cache status

Each section gets a health score. Click on any failing check for remediation steps.

Debug Mode

Enable debug mode at Gift Cards → Settings → Advanced → Debug Mode.

When enabled, the plugin logs detailed information about:

• Payment requests and responses
• Stripe and Square payment processing
• Email sending
• Coupon creation in Amelia

FAQ

Can I use this without Amelia?

No. Gift Cards for Amelia is designed specifically to work with the Amelia Booking plugin. It creates Amelia coupons that are used during the booking process.

Is there a free version?

No. Gift Cards for Amelia is a premium plugin available for $39/year. This includes all features, 1 year of updates, and email support.

Can I use it on multiple sites?

Each license is for a single WordPress installation. Contact us for multi-site pricing.

What happens when a gift card is purchased?

1. Customer pays via Stripe or Square
2. Gift card record is created in the database
3. A corresponding Amelia coupon is auto-created
4. Recipient receives an email with the gift card code
5. Buyer receives a confirmation email

How do recipients use their gift card?

Recipients enter their gift card code in the coupon/promo code field during the Amelia booking process. The discount is applied automatically based on the card's balance.