User guide

For store owners and staff · Free plugin + optional Pro add-on · Plain English

1. What is Gift Rocket?

Gift Rocket (plugin name: Wallet Ready Gift Cards for WooCommerce) lets you sell digital gift cards in your WooCommerce shop.

• Customers buy a gift card product and fill in recipient details (name, email, message, and more).
• After payment, the store creates a gift card code with a balance.
• The recipient gets a PDF by email (you can schedule the send date).
• Anyone with the code can apply it at cart or checkout like store credit.

In the WordPress admin you will see the menu Gift Rocket → Gift Cards.

2. What you need

• WordPress 6.5 or newer
• PHP 8.1 or newer
• WooCommerce installed and active
• For Google / Apple Wallet passes: an ePasscard account and API key (optional)

3. Install the plugins

1. Upload and activate Wallet Ready Gift Cards for WooCommerce (free).
2. Make sure WooCommerce is active. If WooCommerce is missing, you will see an admin warning.
3. (Optional) Upload and activate Wallet Ready Gift Cards for WooCommerce Pro. Pro only works when the free plugin is active.
4. (Pro) Open Gift Rocket → Pro license, enter your license key, and activate. Pro features (checkout edit, AI, bulk import, etc.) stay disabled until the license is valid.
5. Open Gift Rocket → Gift Cards and open the Settings tab to review defaults.

4. Quick start (first gift card in 10 minutes)

1. Settings → General: Turn on Allow editing in cart if buyers should change details before checkout.
2. Settings → Email: Set email subject and body. Use placeholders like [giftcard_code] and [receiver_name].
3. Products → Add new: Set product type to Gift Card. Add a price (fixed or custom amount). Add a product image (recommended size 923×400 px for PDF).
4. Publish the product. Open it on the shop and test a purchase.
5. When the order is paid, check Gift Rocket → Gift Cards dashboard for the new code and use Download PDF or wait for the scheduled email.

5. Admin menu overview

6. Settings explained

Open Gift Rocket → Gift Cards → Settings. Save each tab after changes.

6.1 General settings

• PDF footer from short description — Uses the product short description at the bottom of the PDF.
• Show full description on product page — Shows long product text on the gift card page.
• Character counter — Shows how many characters are left in the message field.
• Allow editing in cart Free — Buyers can open an edit window from the cart (classic cart and Cart block).
• Allow editing at checkout Pro — Same edit popup during checkout (shortcode and Checkout block). Only appears when Pro is licensed and this option is on. If Pro is not licensed, the setting is ignored.
• Price label / manual price placeholder — Text near amount fields.
• Gallery label — Title above card design images.
• Apply link goes to — When someone scans a QR code, open cart or checkout.
• Coupon code pattern — How auto-generated codes look (letters and numbers).
• Min / max custom amount — Limits when buyers type their own price.
• Max quantity per add to cart — How many gift card lines can be added at once from the product page.
• Fraud & abuse safeguards — Rate limits and security log (recommended: leave enabled).

6.2 Gift card form

Change labels (recipient name, email, message, sender, schedule) and colors/fonts for the form on the product page and in the edit popup.

6.3 PDF & email card design

• Layout: two columns (card image + details), borders, backgrounds (solid, gradient, or image).
• Barcode or QR on PDF — Code can be the gift card number or a link to apply at checkout.

6.4 Email delivery

• Subject, heading, and HTML body with placeholders.
• Attach PDF yes/no.
• Emails are sent by a background task (every few minutes) when the scheduled time is reached.

6.5 Google / Apple Wallet (ePasscard)

This is optional. You need your own ePasscard API key.

1. Paste the API key and click Connect.
2. Choose a pass template and map fields (recipient name, code, balance, expiry, image, etc.).
3. On each gift card product you can override the template (optional).
4. Passes are created after the gift card is issued. Buyers may see a wallet link on the order and in My Account → Gift cards.

7. Create a gift card product

1. Go to Products → Add new.
2. In Product data, choose type Gift Card (not Simple product).
3. Set a title, image, and short description (used on PDF footer if enabled).
4. Pricing: Enable preset prices and/or “customer enters amount”. Set expiry (e.g. 1 year).
5. Email schedule: Allow buyers to pick send date/time if you want scheduled delivery.
6. Recipient on product page:
   • Show form — Buyer enters recipient on the product page (default).
   • Use billing or shipping at checkout — Hide recipient fields on the product page; name and email are taken from checkout instead (good for “gift to myself” or address-based gifts).
7. Publish and test on the live or staging shop.

8. How customers buy a gift card

1. Customer opens the gift card product page.
2. They choose amount and card design (if you offer a gallery).
3. They fill recipient details (unless your product uses billing/shipping at checkout).
4. They click add to cart. They can add more than one different gift card line on the same page.
5. They complete checkout and pay.
6. When the order reaches the right status, the plugin creates the gift card in the database and queues email.

9. Edit gift card in cart or checkout

Cart editing is a free feature when Allow editing in cart is on. Checkout editing is Pro-only and requires a valid Pro license plus Allow editing at checkout.

• Classic cart / checkout — Button opens a popup to change name, email, message, sender, schedule, image, or price (if allowed).
• WooCommerce Cart block / Checkout block — Edit button appears under the product name in the block cart and order summary (same popup).

10. Redeem a gift card (use balance)

Customers apply a code to reduce the order total.

1. On cart or checkout, open “Have a gift card code?” (or similar text you configured).
2. Enter the code and apply.
3. The discount appears as a fee/credit. Remaining balance stays on the card for later orders (until expiry).

Pro Choose redeem amount: If enabled, the customer can enter how much of the card balance to use on this order (within your min/max rules).

QR codes on PDFs can open the shop with the code pre-filled (?wallregi_apply_giftcard=CODE).

11. Manage gift cards in the dashboard

• Search by code, email, or order.
• Edit balance, expiry, recipient, message (careful: changing codes is restricted).
• Create gift card — Issue a code without an order (events, compensation, partners).
• Download PDF — Send or print manually.
• Create missing wallet pass — If ePasscard is connected but pass failed earlier.
• Status — Active, cancelled, etc. (affects redeem).

12. Purchaser My Account

Logged-in customers who bought gift cards see My Account → Gift cards.

• List of cards from their orders
• Download PDF
• Open wallet pass link when available
• View transaction history per card

13. Pro features (detailed)

13.1 Pro license

Go to Gift Rocket → Pro license. Enter the license key from your purchase and click activate. The site is checked against the license server (and re-checked daily). Deactivate before moving the site to another domain if your plan allows only one site.

Without a valid license, Pro menus may appear but checkout edit, AI, bulk import, and other Pro runtime features do not run.

13.2 Edit at checkout

With a valid license, turn on Allow editing at checkout under Settings → General. Works on shortcode checkout and the Checkout block.

13.3 Buyer custom image

Buyers upload a photo used on the card. Set max size, daily limit, and who may upload (all visitors or logged-in only). Optional ClamAV virus scan if your server supports it. Old unused uploads are cleaned automatically.

13.4 Greeting presets

In Form settings, add lines like Birthday | Happy birthday! (title, pipe, message). Buyers click a chip to fill the message. You can override presets per product.

13.5 Order rules

• Max number of different gift card codes per order
• Min and max total discount from all applied codes combined

13.6 Bulk CSV import

Gift Rocket → Bulk CSV import. Download the sample file. Required columns: amounts, expiry, recipient name, recipient email, sender name. Optional: code (empty = auto-generate), message, product ID, send date, image URL.

Flow: upload → validate → import runs in background → check job status.

13.7 Expiry reminder emails

Send reminders at 30, 14, 7 days before expiry (configurable). Each card gets one email per milestone. Recipients can unsubscribe from a link in the email.

13.8 Outstanding balance export

Download CSV reports for accounting: details (one row per card) or summary (grouped totals).

13.9 AI writing assistant

Gift Rocket → AI (Pro + valid license). You connect your own provider (OpenAI, OpenRouter, Google Gemini, or Anthropic) with an API key stored encrypted on your site.

• Enable AI master switch and choose provider/model.
• Daily credits — separate pools for storefront (shoppers) and admin tools, plus a site total cap.
• Storefront — optional “Get message” / “Improve text” / translate on the gift card form and cart edit modal (storefront AI is off by default).
• Admin — help write delivery email fields, expiry templates, greeting preset lines, product heading/footer, and manual gift card messages.
• Rate limits — cooldown between clicks, max uses per shopper visit, and matching hourly IP cap (see the built-in help on the AI screen).
• Customize messages — override shopper and staff-facing error/status text; leave a field empty to keep the default shown as placeholder.
• Alerts — email to admins when daily usage nears the limit (~95%). Shoppers never see raw API error text.

13.10 Gift card balance top-up & recharge

Pro Gift Rocket Pro lets customers or gift recipients recharge and add funds to an existing active gift card without needing to purchase a brand new code.

Visual preview of the modern Gift Card Balance Top-Up portal form [wallregi_topup] with preset amount chips and instant checkout integration.

How to set up Top-Up (Step-by-step):

1. Step 1 — Enable Global Top-Up in Settings:
   • Open Gift Rocket → Gift Cards → Settings → General tab.
   • Scroll down to the Balance top-up section.
   • Check the box: Enable gift card balance top-up.
   • Set the Minimum top-up amount and Maximum top-up amount (enter 0 for no maximum).
   • Choose when funds are credited: Credit card balance when order is → Order completed (recommended) or Payment complete.
   • Click Save changes at the bottom.
2. Step 2 — Create a Top-Up WooCommerce Product:
   • Go to Products → Add New.
   • Keep the Product Data type as Simple product and check Virtual. (Note: Do not select 'Gift Card' product type; use standard Simple Product).
   • Under the General tab, check the checkbox: Gift card balance top-up.
   • Choose the Top-up amount mode:
     • Fixed amount (product price): Uses the product's regular price or an optional fixed top-up amount override.
     • Customer chooses amount (variable): Check Allow custom amount and/or enter comma-separated Preset top-up amounts (e.g. 25, 50, 100).
   • Extend expiry on top-up (Optional): Choose Add years or Add months, set the extension value, and pick whether the new expiry is calculated From order date or From current card expiry.
   • Click Publish.
3. Step 3 — Deploy on Frontend (Two Options):
   • Option A — Dedicated Recharge Page (Shortcode): Create a new WordPress page (e.g. Pages → Add New → "Recharge Gift Card") and add the shortcode:
     [wallregi_topup]
     This provides a standalone, dedicated balance recharge portal.
   • Option B — Direct Product Page: Shoppers can also visit the Top-Up product page directly in your store catalog. Gift Rocket automatically replaces the default add-to-cart button with the interactive Gift Card validation and reload form.

13.11 Balance & transaction history checker

Pro Allow shoppers and recipients to check their current available gift card balance, status, expiry, and full transaction history from any public page.

Public balance checker and transaction history audit trail workflow with digital pass integration.

How to set up the Balance Checker:

1. Create a Balance Checker Page: Create a new page (e.g. Check Gift Card Balance) and paste the shortcode:
   [wallregi_transactions]
2. Customize Appearance & Text: Go to Gift Rocket → Settings → Transactions tab to customize form title, subtitle, search placeholder, button label, and result text.
3. Test on Frontend: Enter an issued gift card code and click View transactions. The responsive widget immediately renders:
   • Card Header & Status: Displays the Gift Card Number with a 1-click copy-to-clipboard button and a real-time status badge (● Active or ● Expired).
   • 3 Summary Stat Cards:
     • Current Balance: Prominently highlighted card with the remaining available balance in your store's currency.
     • Initial Balance: Original starting amount when the card was issued.
     • Expires On: Expiry date (e.g. December 24, 2026).
   • Transaction History Ledger Table: Clean chronological table listing:
     • Date: Exact date and timestamp of the transaction.
     • Type: Initial Balance, Order Redemption, or Balance Top-Up.
     • Amount: Credit (+) or debit (-) amount.
     • Order / Ref: Linked WooCommerce Order ID (e.g. #179) or manual issuance reference.
     • Status: Verification status badge (e.g. Recorded).

14. Multi-language & Translation Guide

Gift Rocket (Free) and Gift Rocket Pro are built from the ground up to be 100% translatable and multilingual-ready. Whether you want to translate your store into a single local language (like Spanish, German, or Arabic) or run a multi-currency, multi-language international store with WPML or Polylang, all user-facing forms, emails, cart edit popups, and checkout blocks adapt seamlessly.

Gift Rocket Free & Pro translation architecture across gettext, WPML, Loco Translate, dynamic settings, and products.

14.1 Text domains & string types

Gift Rocket uses standard WordPress gettext functions (__(), _e(), esc_html__(), _x()). Strings are split into two text domains:

• Free Plugin text domain: wallet-ready-gift-cards-for-woocommerce — Controls the gift card product form, classic cart & block cart editing, apply coupon modals, PDF card rendering, purchaser My Account table, and email notifications.
• Pro Plugin text domain: wallet-ready-gift-cards-for-woocommerce-pro — Controls checkout editing popup, bulk CSV import screen, expiry reminder logs, liability balance exports, AI assistant configuration, and REST API error responses.

14.2 Translating with Loco Translate (Step-by-step)

Loco Translate is the most popular free plugin for translating WordPress plugins directly inside your WordPress dashboard into your site's native language.

4-step process for translating Gift Rocket Free and Pro with Loco Translate.

1. Open Loco Translate: In the WordPress admin menu, go to Loco Translate → Plugins.
2. Select Gift Rocket: Click on Gift Rocket – Ultimate Gift Cards for WooCommerce (or Wallet Ready Gift Cards for WooCommerce Pro if translating Pro features).
3. Add or Edit Language:
   • If your language is already listed, click Edit.
   • If not listed, click New language, choose your target language (e.g. Spanish, German, French, Arabic).
4. Choose Safe Location (Important): Under Choose a location, select Custom (languages/loco/plugins/...) or System (languages/plugins/...).
   ⚠️ Warning: Do not choose "Author" location, or your translations will be overwritten when you update Gift Rocket!
5. Sync Strings: Click the Sync button at the top toolbar to ensure all latest strings from the .pot template are loaded.
6. Translate & Save: Use the search box to find strings (e.g. "Recipient Name", "Apply Gift Card"). Enter your translated text in the bottom translation box and click Save. Loco will immediately compile the .mo file.
7. Set Site Language: Make sure your WordPress language matches under Settings → General → Site Language.

14.3 Translating with WPML & WooCommerce Multilingual (WCML)

Gift Rocket is fully compatible with WPML (WordPress Multilingual), WPML String Translation, and WooCommerce Multilingual & Multicurrency (WCML).

WPML complete workflow: String Scanning, String Translation, Admin Texts, and WCML Product Translation.

A. Scan Gift Rocket for strings

1. Go to WPML → Theme and plugins localization.
2. Scroll down to the Strings in the plugins table.
3. Check the boxes for Wallet Ready Gift Cards for WooCommerce and Wallet Ready Gift Cards for WooCommerce Pro.
4. Click Scan selected plugins for strings. WPML will register all gettext strings in its database.

B. Translate static UI strings

1. Go to WPML → String Translation.
2. In the In domain dropdown, choose wallet-ready-gift-cards-for-woocommerce (or wallet-ready-gift-cards-for-woocommerce-pro).
3. Click on any string or click the + icon under your target language column to enter translations.
4. Check Translation is complete and save.

C. Translate dynamic settings & email templates (Admin Texts)

If you customized the field labels or email templates under Gift Rocket → Settings, register them in WPML:

1. Go to WPML → String Translation and scroll to the bottom.
2. Click the blue link: « Translate texts in admin screens ».
3. Look for the option keys:
   • wallregi_settings — Expand to select custom form labels, pricing labels, gallery title, etc.
   • wallregi_email_settings — Expand to select custom email subject lines, email headings, and message body text.
   • wallregi_pro_ai_settings — (Pro) Expand to translate custom shopper alert messages.
4. Check the boxes next to the keys you customized and click Add to String Translation at the bottom.
5. Return to WPML → String Translation and filter domain by admin_texts_wallregi_settings to translate them for each language.

D. Translate Gift Card products & multi-currency

• Product Translations: Go to WooCommerce → WooCommerce Multilingual → Products. Click the + icon next to your Gift Card product to translate title, short description (PDF footer), long description, and gallery presets.
• Multi-Currency: Gift Rocket seamlessly supports WCML multi-currency mode. Fixed price tiers and custom amounts are converted into the active customer currency during purchase and redemption.
• Cart Language Switching: If a buyer switches language while a gift card is in the cart, all custom data (recipient name, message, scheduled delivery date, custom image) remains intact.

14.4 Translating with Polylang & Polylang for WooCommerce

If you use Polylang or Polylang for WooCommerce:

• Gift Card Products: In Products → All Products, click the + icon under the target language flag to create a translated gift card product.
• Strings: Navigate to Languages → Translations (Strings translations) to translate registered plugin strings and domain labels.
• Cart & Checkout: Polylang preserves gift card session data and cart line prices when switching language switchers.

14.5 Front-End Visual Translation with TranslatePress

TranslatePress translates your site visually directly from the front-end:

1. Open any Gift Card product page on your shop and click Translate Page in the WordPress top admin bar.
2. Hover over any label (e.g. "Recipient Name", "Delivery Date", "Add to Cart") and click the pencil icon to provide the translation in the sidebar.
3. Open the cart and checkout pages to translate the Edit gift card popup and Have a gift card code? redemption input.
4. Click Save Translation. TranslatePress automatically delivers the translated strings dynamically.

14.6 Translation plugins comparison matrix

Feature matrix comparing Loco Translate, WPML, Polylang, and TranslatePress with Gift Rocket.

14.7 Right-to-Left (RTL) Language Support

Gift Rocket features built-in native RTL (Right-to-Left) styling for languages such as Arabic (العربية), Hebrew (עברית), Persian/Farsi (فارسی), and Urdu (اردو).

Visual preview of RTL form mirroring and Pro AI Assistant translation on the Gift Card product form.

14.8 Translation troubleshooting & FAQs

15. WooCommerce Blocks vs classic pages

16. Troubleshooting

17. Simple glossary

• Gift card code — The coupon-like code the customer types at checkout.
• Balance / current amount — Money left on the card.
• Initial amount — Starting value when the card was created.
• Preferred date/time — When the gift email should be sent.
• Redeem / apply — Using the card balance to pay for an order.
• Text domain — Unique identifier for translatable plugin strings (wallet-ready-gift-cards-for-woocommerce).
• PO / MO files — Standard gettext translation files (PO is human-readable, MO is compiled binary).
• Admin texts — Dynamic strings stored in the database options (like custom form labels).