{"id":290323,"date":"2026-03-26T09:56:31","date_gmt":"2026-03-26T09:56:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/beltoft-gift-cards-for-woocommerce\/"},"modified":"2026-03-26T09:56:06","modified_gmt":"2026-03-26T09:56:06","slug":"beltoft-gift-cards","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/beltoft-gift-cards\/","author":23461136,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.2","stable_tag":"1.4.2","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Beltoft Gift Cards for WooCommerce","header_author":"beltoft.net","header_description":"Sell digital gift cards, deliver them by email, and let customers redeem them at checkout.","assets_banners_color":"","last_updated":"2026-03-26 09:56:06","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/beltoft-gift-cards\/","header_author_uri":"https:\/\/beltoft.net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":50,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.2":{"tag":"1.4.2","author":"christian198521","date":"2026-03-26 09:56:06"}},"upgrade_notice":{"1.3.0":"

Performance and concurrency improvements.<\/p>","1.0.0":"

Initial release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.2"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Gift card product page with amount selector and recipient fields.","2":"Gift card delivery email sent to the recipient.","3":"Gift card applied at checkout via the coupon field.","4":"Dedicated \"Apply Gift Card\" field on the cart page.","5":"My Account \u2014 Gift Cards tab showing balances and transactions.","6":"Admin dashboard with stats.","7":"Admin gift card list with search, filters, and bulk actions.","8":"Settings page."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[19968,6600,5495,35576,286],"plugin_category":[45],"plugin_contributors":[256640,257057],"plugin_business_model":[],"class_list":["post-290323","plugin","type-plugin","status-publish","hentry","plugin_tags-gift-cards","plugin_tags-gift-certificate","plugin_tags-store-credit","plugin_tags-voucher","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-beltoftnet","plugin_contributors-christian198521","plugin_committers-beltoftnet","plugin_committers-christian198521"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/beltoft-gift-cards.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Beltoft Gift Cards for WooCommerce adds a gift card product type to your store. Customers purchase a gift card, choose an amount, and enter the recipient's email. When the order is processed, the recipient gets a branded email with their unique gift card code. Codes are redeemed at checkout through the standard WooCommerce coupon field \u2014 no extra steps for the customer.<\/p>\n\n

Key Features<\/h3>\n\n
    \n
  1. Gift card product type \u2014 predefined amounts (e.g., $25, $50, $100) or custom amounts within configurable min\/max.<\/li>\n
  2. Email delivery using WooCommerce email templates \u2014 same look as your order emails.<\/li>\n
  3. Coupon field redemption \u2014 gift card codes work in the standard WooCommerce coupon field, no setup required.<\/li>\n
  4. Optional dedicated \"Apply Gift Card\" field on cart\/checkout via settings or [bgcw_apply_field]<\/code> shortcode.<\/li>\n
  5. Auto-apply from email \u2014 the \"Shop Now\" button in the delivery email automatically applies the gift card to the recipient's cart.<\/li>\n
  6. Balance tracking with partial redemption \u2014 remaining balance carries over to the next purchase.<\/li>\n
  7. My Account tab \u2014 customers view their gift cards, balances, and full transaction history.<\/li>\n
  8. Personal message displayed in cart and order details.<\/li>\n
  9. Price range display \u2014 gift card products show \"From $25\" or \"$25 \u2013 $100\" in your shop catalog.<\/li>\n
  10. Admin dashboard with stats: total issued, outstanding balance, redeemed, and expired counts.<\/li>\n
  11. Gift card management list with search, status filters, pagination, and bulk actions (disable\/delete).<\/li>\n
  12. Manual gift card creation from the admin panel \u2014 no order required.<\/li>\n
  13. Order meta box showing gift cards created by and used on each order.<\/li>\n
  14. Automatic balance restore on order cancel\/refund, including proportional partial refund support.<\/li>\n
  15. Loyalty Rewards integration \u2014 optionally block or allow customers from using loyalty points to purchase gift cards (requires Loyalty Rewards for WooCommerce).<\/li>\n
  16. Shortcode [bgcw_product_form]<\/code> for page builders (Bricks, Elementor, etc.).<\/li>\n
  17. HPOS compatible \u2014 works with WooCommerce High-Performance Order Storage.<\/li>\n
  18. Email settings (subject, heading, on\/off) under WooCommerce > Settings > Emails.<\/li>\n<\/ol>\n\n

    How It Works<\/h3>\n\n
      \n
    1. Create a \"Gift Card\" product in WooCommerce and set the predefined amounts.<\/li>\n
    2. Customer purchases the gift card, picks an amount, and enters recipient details and an optional message.<\/li>\n
    3. When the order is processed, a unique code is generated and emailed to the recipient.<\/li>\n
    4. Recipient enters the code at checkout in the coupon field \u2014 the gift card balance is applied as a discount.<\/li>\n
    5. Partial use is tracked. The remaining balance stays on the gift card for future orders.<\/li>\n<\/ol>\n\n

      Configuration<\/h3>\n\n

      Gift Card Product<\/h3>\n\n
        \n
      • Create a product, select \"Gift card\" as the product type.<\/li>\n
      • Set predefined amounts in the Gift Card data panel (e.g., 25,50,75,100).<\/li>\n
      • Custom amounts and their min\/max are controlled from the global settings page.<\/li>\n<\/ul>\n\n

        Redemption<\/h3>\n\n
          \n
        • Gift card codes always work in the standard WooCommerce coupon field \u2014 this is automatic.<\/li>\n
        • To also show a dedicated \"Apply Gift Card\" field, enable it in settings with automatic placement or shortcode-only.<\/li>\n
        • Shortcode: [bgcw_apply_field]<\/code> \u2014 place it on cart or checkout pages.<\/li>\n
        • Recipients can click \"Shop Now\" in the delivery email to auto-apply the gift card to their cart.<\/li>\n<\/ul>\n\n

          Email Template<\/h3>\n\n
            \n
          • Uses WooCommerce's email system \u2014 same header, footer, and colours as your other store emails.<\/li>\n
          • Customise subject and heading under WooCommerce > Settings > Emails > Gift Card Delivery.<\/li>\n
          • Override the template by copying templates\/emails\/gift-card-delivery.php<\/code> to your theme's woocommerce\/emails\/<\/code> folder.<\/li>\n<\/ul>\n\n

            Page Builders<\/h3>\n\n
              \n
            • For Bricks, Elementor, or other page builders that replace WooCommerce templates, use the WooCommerce Add to Cart element or the [bgcw_product_form]<\/code> shortcode.<\/li>\n<\/ul>\n\n

              Hooks & Filters<\/h3>\n\n

              Developers can extend the plugin:<\/p>\n\n

                \n
              • bgcw_gift_card_created<\/code> \u2014 fires after a gift card is created (used by the email system).<\/li>\n<\/ul>\n\n\n
                  \n
                1. Upload the beltoft-gift-cards<\/code> folder to \/wp-content\/plugins\/<\/code> or install via the Plugins screen.<\/li>\n
                2. Activate the plugin.<\/li>\n
                3. Go to WooCommerce > Gift Cards > Settings<\/strong> to configure.<\/li>\n
                4. Create a new product and select \"Gift card\"<\/strong> as the product type.<\/li>\n
                5. Optionally adjust the delivery email under WooCommerce > Settings > Emails > Gift Card Delivery<\/strong>.<\/li>\n<\/ol>\n\n\n
                  \n

                  Do gift cards work with the standard coupon field?<\/h3><\/dt>\n

                  Yes. Gift card codes are always accepted in the WooCommerce coupon field. This works automatically \u2014 customers just enter the code where they would enter a coupon.<\/p><\/dd>\n

                  Can I also show a separate gift card field?<\/h3><\/dt>\n

                  Yes. Go to WooCommerce > Gift Cards > Settings and enable the \"Dedicated Gift Card Field.\" You can choose automatic placement (cart & checkout) or shortcode-only ([bgcw_apply_field]<\/code>).<\/p><\/dd>\n

                  Do gift cards support partial redemption?<\/h3><\/dt>\n

                  Yes. If a gift card balance exceeds the order total, only the needed amount is deducted. The remaining balance stays on the gift card for future use.<\/p><\/dd>\n

                  What happens when an order is refunded?<\/h3><\/dt>\n

                  Gift card balances are automatically restored when an order is cancelled or fully refunded. Partial refunds proportionally restore the gift card balance.<\/p><\/dd>\n

                  Can I create gift cards manually?<\/h3><\/dt>\n

                  Yes. Go to WooCommerce > Gift Cards > Gift Cards tab and click \"Add Gift Card.\" You can specify the amount, recipient, and message.<\/p><\/dd>\n

                  Are gift cards taxable?<\/h3><\/dt>\n

                  No. Gift card products are set as non-taxable, and gift card discounts are applied as non-taxable negative fees.<\/p><\/dd>\n

                  Does it work with page builders like Bricks or Elementor?<\/h3><\/dt>\n

                  Yes. Use the [bgcw_product_form]<\/code> shortcode inside your page builder's product template to display the gift card amount selector and recipient fields.<\/p><\/dd>\n

                  Do emails match my store's design?<\/h3><\/dt>\n

                  Yes. They use WooCommerce's email template \u2014 same header, footer, and styling as order emails.<\/p><\/dd>\n

                  Can customers see their gift card balances?<\/h3><\/dt>\n

                  Yes. A \"Gift Cards\" tab is added to My Account where customers can view all their gift cards (purchased and received), balances, and transaction history.<\/p><\/dd>\n

                  Can customers use loyalty points to buy gift cards?<\/h3><\/dt>\n

                  By default, no. If you have the Loyalty Rewards for WooCommerce plugin active, an \"Integrations\" section appears in the gift card settings where you can allow or block loyalty point redemption on gift card purchases.<\/p><\/dd>\n\n<\/dl>\n\n\n

                  1.4.2<\/h4>\n\n
                    \n
                  • Added GitHub Actions workflow for automated WordPress.org deployment.<\/li>\n<\/ul>\n\n

                    1.4.1<\/h4>\n\n
                      \n
                    • Added width: 100%<\/code> to gift card product fields container for better theme compatibility.<\/li>\n
                    • Added placeholder text to Predefined Amounts field on the product edit page.<\/li>\n<\/ul>\n\n

                      1.4.0<\/h4>\n\n
                        \n
                      • Renamed plugin slug and folder to beltoft-gift-cards<\/code>.<\/li>\n
                      • Renamed text domain to beltoft-gift-cards<\/code>.<\/li>\n
                      • Replaced inline scripts with wp_add_inline_script()<\/code>.<\/li>\n
                      • Fixed double-escaping on gift card price display.<\/li>\n
                      • Improved input sanitization on all add-to-cart POST data.<\/li>\n
                      • Moved all inline styles to external CSS files.<\/li>\n
                      • Added wp_cache_delete()<\/code> calls after custom table writes.<\/li>\n
                      • Updated author to beltoft.net.<\/li>\n<\/ul>\n\n

                        1.3.0<\/h4>\n\n
                          \n
                        • Improved: MySQL advisory lock for concurrent balance deductions.<\/li>\n
                        • Improved: SQL-level pagination for My Account gift cards.<\/li>\n
                        • Improved: Bulk gift card code lookups in cart and Store API.<\/li>\n
                        • Improved: Expiry sync moved to WP-Cron (hourly) with composite DB index.<\/li>\n
                        • Fixed: Tax-inclusive discount amount in balance deductions.<\/li>\n
                        • Fixed: Refund safety guard requires prior deduction before restoring balance.<\/li>\n
                        • Added: Block checkout support \u2014 gift card codes identified via Store API extension.<\/li>\n<\/ul>\n\n

                          1.0.0<\/h4>\n\n
                            \n
                          • Initial release.<\/li>\n
                          • Gift card product type with predefined and custom amounts.<\/li>\n
                          • Email delivery to recipients using WooCommerce email templates.<\/li>\n
                          • Auto-apply gift card from email \"Shop Now\" link.<\/li>\n
                          • Virtual coupon integration \u2014 gift card discounts display natively between subtotal and total with WooCommerce [Remove] link.<\/li>\n
                          • Optional dedicated \"Apply Gift Card\" field with automatic or shortcode-only placement.<\/li>\n
                          • Personal message displayed in cart and order details.<\/li>\n
                          • Price range display in shop catalog (e.g., \"$25 \u2013 $100\").<\/li>\n
                          • Balance tracking with partial redemption.<\/li>\n
                          • My Account tab for viewing gift cards and transactions.<\/li>\n
                          • Admin dashboard, gift card list with bulk actions, and manual creation.<\/li>\n
                          • Order meta box showing created and used gift cards.<\/li>\n
                          • Automatic balance restore on cancel\/refund with partial refund support.<\/li>\n
                          • Loyalty Rewards for WooCommerce integration \u2014 block or allow loyalty points for gift card purchases.<\/li>\n
                          • Atomic balance deduction to prevent race conditions.<\/li>\n
                          • Rate limiting on gift card code lookups.<\/li>\n
                          • HPOS compatibility.<\/li>\n
                          • Block checkout incompatibility declared (classic checkout required).<\/li>\n
                          • Portuguese (pt_PT) translation included.<\/li>\n<\/ul>","raw_excerpt":"Sell digital gift cards, deliver them by email, and let customers redeem them at checkout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/290323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=290323"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/beltoftnet"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=290323"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=290323"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=290323"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=290323"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=290323"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=290323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}