Title: bLoyal: Loyalty & Promotions by bLoyal Author: bLoyal Published: 23 Haziran 2023 Last modified: 21 Ağustos 2026 --- Eklentilerde ara ![](https://ps.w.org/bloyal/assets/banner-772x250.png?rev=2929807) ![](https://ps.w.org/bloyal/assets/icon-256x256.png?rev=2929807) # bLoyal: Loyalty & Promotions by bLoyal [bLoyal](https://profiles.wordpress.org/connectordev/) tarafından [İndir](https://downloads.wordpress.org/plugin/bloyal.zip) * [Detaylar](https://tr.wordpress.org/plugins/bloyal/#description) * [Değerlendirmeler](https://tr.wordpress.org/plugins/bloyal/#reviews) * [Kurulum](https://tr.wordpress.org/plugins/bloyal/#installation) * [Geliştirme](https://tr.wordpress.org/plugins/bloyal/#developers) [Destek](https://wordpress.org/support/plugin/bloyal/) ## Açıklama ### Introduction bLoyal enables WooCommerce users to grow their loyal customer base and engage with their customers across all devices and sales channels. The bLoyal App enables you to have a single customer master record across your WooCommerce store and physical store(s) and run a consistent loyalty program, promotions, and engagement across all your sales channels. bLoyal also enables you to sell and accept gift/egift cards and customer loyalty tender in WooCommerce and in your physical store. For more information, please go to [bLoyal.com](https://bloyal.com) ### Major features in bLoyal include: * Powerful promotions and loyalty programs * Single Master Customer Record. * Automated Subscriptions. * Referral Programs * Real-Time Lifecycle Engagement. * Click-and-Collect- Sell online and pick up in store. [REQUEST A DEMO](https://bloyal.com/request-demo/) For complete list of features and details, please visit [More Information](https://bloyal.com/woocommerce-integration/) To learn how to install the plugin, navigate to the Installation tab. For detailed guidance on the installation and setup of the plugin, refer to the [plugin documentation](https://mysupport.bloyal.com/hc/en-us/articles/360022898114-bLoyal-Plugin-for-WooCommerce-Update-Setup-Guide/). [Terms and Conditions](https://mysupport.bloyal.com/hc/en-us/article_attachments/360047099174/bLoyal-SubscriptionAgreement.pdf) PS: Once integrated, you’ll have access to an unrivaled set of loyalty program management tools that will help achieve your business goals; ### Support [Get quick answers to your questions with support resources, documentation, and step-by-step video walk-throughs for common bLoyal’s frequently asked questions](https://mysupport.bloyal.com/hc/en-us) ### License ### Changes 1. Fixed duplicate coupon error messages by checking flag status before showing “already applied” error 2. Only show error if coupon is fully applied (flag=true), suppress notice for pending validation (flag=false) 3. Added proper escaping with esc_html() for security #### 3.1.611.59 _Release Date – 22 Dec 2025_ Fix: Coupon double application issue (Kanna Collective) ### Changes 1. Fixed coupon timing issue by setting flag=true immediately after successful API call 2. Added cart calculation trigger to ensure discount applies immediately 3. Enhanced error suppression for bLoyal coupons to prevent WooCommerce validation errors 4. Fixed duplicate check logic to only show error when coupon is fully applied 5. Removed HTML output from filter hook (WordPress best practice) This fixes the issue where customers had to apply coupons twice and addresses the UI/backend mismatch where backend succeeded but frontend showed errors. #### 3.1.611.60 _Release Date – 8 Jan 2026_ Fix: eGift card package/shipping errors when guest creates account at checkout. Proactive cart_uid preservation to order metadata during checkout, fallback retrieval mechanism for cart_uid when session is lost, enhanced postmeta table management for backoffice connector compatibility, improved SQL security with prepared statements. #### 3.1.611.61 _Release Date – 12 Jan 2026_ Fix cart UID persistence for WooCommerce orders. Ensures cart_uid is saved to the database even when CommitCart API call fails, preventing loss of loyalty data, shipping services, and e-gift card information. #### 3.1.611.62 _Release Date – 16 Jan 2026_ Enhanced cart UID persistence with multi-point fallback system. Implements early cart_uid capture before CommitCart in multiple checkout hooks. Adds fallback retrieval from bloyal_cart_data session when plugin is deactivated mid-checkout, ensuring cart_uid is always persisted even when CommitCart fails or plugin is disconnected. ## Ekran Görüntüleri [⌊Powerful Promotions⌉⌊Powerful Promotions⌉[ Powerful Promotions [⌊Create your own Loyalty Program in three easy steps⌉⌊Create your own Loyalty Program in three easy steps⌉[ Create your own Loyalty Program in three easy steps [⌊Automated Life Cycle Engagement⌉⌊Automated Life Cycle Engagement⌉[ Automated Life Cycle Engagement [⌊Single Master Customer Record⌉⌊Single Master Customer Record⌉[ Single Master Customer Record [⌊Subscriptions & Club Management⌉⌊Subscriptions & Club Management⌉[ Subscriptions & Club Management ## Yükleme #### Minimum Requirements * PHP 5.6 or higher is recommended * WordPress 5.6 or higher is recommended #### Prerequisites [REQUEST A DEMO](https://bloyal.com/request-demo/) #### Steps to install the plugin Step 1: Log in to your WordPress dashboard. Step 2: Upload the plugin folder to the /wp-content/plugins/ directory, or install the plugin directly from the WordPress Plugin Directory. Step 3: Activate the plugin through the ‘Plugins’ menu in WordPress. Step 4: Go to the ‘bLoyal’ menu and configure the plugin as per your requirements. ## SSS ### What does the Plugin do? The bLoyal WooCommerce plugin syncs your ecommerce and other POS systems data with bLoyal, so you can engage your customers with targeted email marketing, automation, and promotions. With the combined power of WooCommerce and bLoyal, this plugin gives you all the tools you need to grow your online store and delight your contacts and customers. ### Who should use the bLoyal WooCommerce plugin? This extension is perfect for Magento store owners who want to be able to track their customers and to engage with them by segmented and automated email and text campaigns, targeted promotions and loyalty programs to increase their customer lifetime value. ### What types of loyalty programs does the plugin support? The plugin is very configurable so that you can points, frequent buyer, cashback, and many other loyalty programs. ### Are coding skills needed to use the bLoyal WooCommerce plugin? Not at all! The bLoyal WooCommerce plugin is easy to download and starts working with your WordPress site right away. ### My question is not listed Visit bloyal.com or send us an email to info@bloyal.com and someone from our team will contact you shortly to answer all your questions. ## İncelemeler Bu eklenti için herhangi bir değerlendirme bulunmuyor. ## Katkıda Bulunanlar ve Geliştiriciler “bLoyal: Loyalty & Promotions by bLoyal” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır. Katkıda bulunanlar * [ bLoyal ](https://profiles.wordpress.org/connectordev/) [“bLoyal: Loyalty & Promotions by bLoyal” eklentisini dilinize çevirin.](https://translate.wordpress.org/projects/wp-plugins/bloyal) ### Geliştirmeyle ilgilenir misiniz? [Kodu görüntüleyin](https://plugins.trac.wordpress.org/browser/bloyal/), [SVN deposuna](https://plugins.svn.wordpress.org/bloyal/) göz atın ya da [RSS](https://plugins.trac.wordpress.org/log/bloyal/?limit=100&mode=stop_on_copy&format=rss) ile [geliştirme günlüğüne](https://plugins.trac.wordpress.org/log/bloyal/) abone olun. ## Değişiklik Kaydı #### 3.1.611.90 _Release Date – 21 Aug 2026_ Security: the cart-handoff route no longer signs anyone in. Opening a bLoyal cart link transfers the cart to WooCommerce as before, but the plugin no longer uses the customer identifier returned by the API to log a visitor in, and no longer creates a WordPress account from it. A visitor arriving from a cart link continues as a guest, or signs in through WooCommerce’s own login. This is a deliberate change in behavior: stores that relied on shoppers arriving already signed in will notice it. The same route now declares an explicit permission callback and validates the cart identifier it receives. It answers with a 503 status instead of a fatal error when WooCommerce has not set up a cart for the request, which is what happened on /wp- json/ style requests. Tested up to WordPress 7.1. #### 3.1.611.88 _Release Date – 20 Aug 2026_ Fix CON-182: Stop a repeated Place Order submission from producing a duplicate order with no shipping charge. When a shopper submitted the checkout twice on the same visit, the second submission started a brand new bLoyal cart, because the plugin cleared the bLoyal CartUID from the session as soon as the order object was created– before payment. That new cart never went through shipping calculation, so the order that reached bLoyal Director carried $0.00 shipping even though the shopper had selected a service, and the card was authorised twice. The CartUID is no longer cleared at order creation; it is still cleared after a successful commit, and now also when the cart itself is emptied, so a genuinely new order never inherits an old CartUID. A second submission of the same cart therefore reuses the first cart and keeps the selected shipping charge. Known limitation: a repeated submission of the same cart still creates a second WooCommerce order, because WooCommerce cannot reuse an order whose payment has already been authorized. Both orders carry the correct shipping charge, and bLoyal records a single transaction for them. #### 3.1.611.87 _Release Date – 20 Aug 2026_ Fix privilege escalation (custom Loyalty Engine API URL + cart auto-login) and add AJAX authorization gates (CON-184): admin configuration actions require manage_options and a nonce; storefront actions require a nonce that is fetched per visitor so page caching cannot share it; cart REST remains public. Denied requests are logged. A storefront action rejected because its nonce went stale on a cached page is retried once with a fresh one, and a rejected admin action now says so on screen instead of failing quietly. Behaviour changes to be aware of: WordPress users who can manage options, edit users, manage WooCommerce or edit posts (Contributor and above) are no longer auto-logged- in from bLoyal cart customer data, so staff accounts that also shop must sign in normally; new customers created from bLoyal cart data now get a random password instead of one derived from their bLoyal identifier; and the minimum supported PHP version is now 7.4, matching WooCommerce. #### 3.1.611.83 _Release Date – 4 Aug 2026_ Fix CON-171: Only report a coupon as applied when bLoyal actually redeemed it. The confirmation added in 3.1.611.82 fired whenever bLoyal acknowledged the code, including for a reward coupon the customer had never been awarded – which comes back Valid =false / Redeemed=false and produces no discount, so the shopper was told “applied successfully” while the total did not change. The applied-coupon confirmation is now gated on the Redeemed flag of the CalculateCart response that the coupon request itself triggers (the same flag the commit path uses to decide which coupons are written onto the order), and when a coupon is not redeemed bLoyal’s own explanation is shown instead – for example “Customer has not been awarded this coupon.” The check fails safe: an empty cart, a missing response or a response for a different cart all keep the previous success message rather than wrongly telling the shopper their coupon is invalid. #### 3.1.611.82 _Release Date – 4 Aug 2026_ Fix CON-171: Confirm to the shopper that a bLoyal coupon was applied. A valid bLoyal coupon reduced the totals but produced no confirmation at all, because the discount is folded into the line-item prices instead of appearing as a separate totals row– so merchants and shoppers reported coupons as “not working” when they had in fact been applied. A success notice is now shown on the apply request. Also harden the woocommerce_coupons_enabled filter callback so it returns the original value when an exception is caught; previously it returned nothing, which resolves to null and would disable coupons store-wide, hiding the coupon form on both cart and checkout. #### 3.1.611.81 _Release Date – 17 Jul 2026_ Fix CON-159: Repair the “Submit Order to bLoyal” manual resubmit. The Grid SalesOrders/ Changes payload was rejected with HTTP 400 (invalid Status value “completed”; ExternalIds and ClubMemberships sent as objects instead of arrays; null tax Rate), and the rejection was swallowed into an empty order note. Send Status “Approved”, wrap ExternalIds/ ClubMemberships as arrays, send 0 for tax Rate, and surface the bLoyal error on the order note instead of a blank one. #### 3.1.611.80 _Release Date – 3 Jul 2026_ Fix CON-111: Preserve the device connection (access key, service URLs, device id) and the payment tender mappings on plugin uninstall. Previously, deleting the plugin( a common way to update the manually-distributed ZIP) wiped these via the uninstall hook, forcing merchants to reconnect the device and re-map every tender after reinstall. Caches and non-essential settings are still cleaned up on uninstall. #### 3.1.611.79 _Release Date – 2 Jul 2026_ Fix CON-106: Prevent fatal PHP error (“Class WC_Payment_Gateway not found”) that could take down the entire site, including wp-login.php. Guard all four bLoyal payment gateway registrations (gift card, loyalty dollar, snippets, stored payment) with a class_exists( ‘WC_Payment_Gateway’ ) check before defining the gateway class, and also guard the direct instantiation of the stored-payment gateway in the payment- alert AJAX handler, so requests where WooCommerce is active but its gateway class is not yet loaded no longer crash. #### 3.1.611.78 _Release Date – 26 Jun 2026_ Fix CON-85: Prevent shipping discount from being skipped on retry checkout. Remove ExternallyAppliedCharge override from the CON-78 ApproveCart stamp so bLoyal-managed rates can apply their discount rules. Add order-status guard in CommitCart to skip non-processing orders. Clear bloyal_early_cart_uid at the start of each CalculateCart run to prevent stale CartUIDs from prior attempts. #### 3.1.611.77 _Release Date – 18 Jun 2026_ Fix CON-79: Prevent fatal PHP error on session-less frontend requests. Guard WC()- >session null check in bloyal_include_scripts before calling ->get(), so bot/crawler traffic that hits routes with no WooCommerce session no longer causes a 503. #### 3.1.611.76 _Release Date – 17 Jun 2026_ Fix CON-78: Prevent zero shipping on retry checkout. When a prior order clears the WC cart, bLoyal CalculateCart receives Charge:0 and zeroes out the shipping rate; the fix guards the shipping rate filter and stamps the correct amount into ApproveCart before sending. #### 3.1.611.75 _Release Date – 05 Jun 2026_ Fix CON-73: Block stored-payment checkout when no card was selected. The bLoyal payment snippet only stores the payment method when the customer clicks “SELECT CREDIT CARD”; if skipped, the order failed silently and auto-cancelled. The order is now stopped up front with a clear message instead. #### 3.1.611.74 _Release Date – 15 May 2026_ Fix CON-65: Revert shipping services postmeta (Director resolves shipping from CartUID directly); persist stored payment PaymentMethodUid to user meta so authorization survives session loss. [Plugin Release Notes](https://mysupport.bloyal.com/hc/en-us/articles/360041454494) #### 3.1.611.73 _Release Date – 14 May 2026_ Fix CON-65: Add null guards for bloyal_cart_data in stored payment method; persist bloyal_shipping_services to order postmeta at checkout so CommitCart can recover it if the WooCommerce session expires before payment is confirmed. [Plugin Release Notes](https://mysupport.bloyal.com/hc/en-us/articles/360041454494) #### 3.0.590.17 _Release Date – 26 July 2022_ #### 3.1.611.3 _Release Date – 03 January 2023_ #### 3.1.611.10 _Release Date – 01 May 2023_ #### 3.1.611.11 _Release Date – 03 May 2023_ #### 3.1.611.12 _Release Date – 18 May 2023_ #### 3.1.611.13 _Release Date – 02 June 2023_ Fixed bLoyal calculate and approve alerts for EGift products. #### 3.1.611.14 _Release Date – 12 June 2023_ #### 3.1.611.15 _Release Date – 08 August 2023_ #### 3.1.611.16 _Release Date – 28 August 2023_ Fixed 100% discount issue on cart page summary. #### 3.1.611.30 _Release Date – 22 Jan 2024_ Fixed saleprice discount issue. Fixed Birth Date value not being populated on the customer record in admin order page. Fixed bLoyal customer data is not showing for“ new sigunp customer” on the checkout address form. Fixed Pickup stores not showing on the cart page. Fixed bLoyal Shipping method issue on the cart/checkout page. Fixed bLoyal Applied tax issue mismatched on checkout page. #### 3.1.611.33 _Release Date – 27 Feb 2024_ Fixed First Name and Last Name value for guest customer bLoyal Connector. Fixed Stored payment method websnippets API call multiple times. Fixed invalid payment method issue on checkout page. Removed checking message from Loyalty Tender Payment. #### 3.1.611.51 _Release Date – 14 Nov 2024_ Fixed the issue in which when the user login with the club signup web snippet page then it displays the wrong user details while it should display the current user details. Fixed the issue in which when the user tried to log-in with the club signup page then it was redirecting to the customer dashboard page while it should be on the club signup page. Fixed the issue which was related to ” Shipping not working”. Implemented the egiftcard web snippet functionality in which we can add egiftcard product from the egiftcard web snippet page. Fixed the issue in which the bL_sk key was not generating whenever the web snippet launched. Implemented the functionality to add new line item to the woocommerce cart. #### 3.1.611.56 _Release Date – 11 Jun 2025_ Fixed an issue with stored credit cards. #### 3.1.611.60 _Release Date – 8 Jan 2026_ Fixed eGift card package/shipping errors when guest creates account at checkout. Implemented proactive cart_uid preservation to order metadata and fallback retrieval mechanism to ensure cart information is available even when session is lost during account creation. #### 3.1.611.61 _Release Date – 12 Jan 2026_ Fix cart UID persistence for WooCommerce orders. Ensures cart_uid is saved to the database even when CommitCart API call fails, preventing loss of loyalty data, shipping services, and e-gift card information. #### 3.1.611.62 _Release Date – 16 Jan 2026_ Enhanced cart UID persistence with multi-point fallback system. Implements early cart_uid capture before CommitCart in multiple checkout hooks (before_calculate_totals, checkout_create_order, new_order, checkout_order_processed). Adds fallback retrieval from bloyal_cart_data session when plugin is deactivated mid-checkout, ensuring cart_uid is always persisted even when CommitCart fails or plugin is disconnected. Includes comprehensive logging with masked sensitive data for security. #### 3.1.611.63 (reverted by 3.1.611.71) _Release Date – 21 Jan 2026_ Fixed USA ePay ‘Hold for Review’ orders failing to sync to bLoyal. Orders with on- hold status are now skipped during checkout and committed when status changes to processing/completed. #### 3.1.611.64 _Release Date – 22 Jan 2026_ Fixed club signup snippet freezing on Delivery/Shipping step. Added null checks to WebSnippetCompleteFn to prevent JavaScript errors when responseData is null or undefined. #### 3.1.611.65 _Release Date – 5 Feb 2026_ Centralized JavaScript versioning for cache busting by replacing all hardcoded version numbers with a single BLOYAL_VERSION constant. #### 3.1.611.66 _Release Date – 5 Feb 2026_ Fixed critical error when placing orders using Gift Card + Credit Card payment combination. Added validation to ensure tender payment mapping is always an array, preventing“ Cannot access offset of type string on string” fatal error on the thank you page. #### 3.1.611.67 _Release Date – 6 Feb 2026_ Fixed gift card and loyalty dollar “Apply Balance” not updating checkout totals without a manual page refresh. Restored direct checkout update trigger after applying balance, replacing a passive event listener that only fired on payment method change. #### 3.1.611.68 _Release Date – 17 Feb 2026_ Fixed gift card balance display showing inconsistent decimal places (e.g. $10.0 instead of $10.00). All balance and amount values in the Check Balance and Apply Balance messages are now consistently formatted to two decimal places. #### 3.1.611.69 _Release Date – 2 Mar 2026_ Fix CON-23: Prevent duplicate CartUID across back-to-back orders in the same session. Clear bloyal_uid and bloyal_early_cart_uid session keys after CommitCart so each new order generates a fresh unique CartUID. #### 3.1.611.72 _Release Date – 17 Apr 2026_ Fix CON-49: Set shipment Type to Pickup for virtual product orders. Virtual products have no WooCommerce shipping method, causing the payload to default to Type: Shipment. bLoyal/ShipCompliant then ran compliance checks on eProduct+PickupOnly products, causing Approved (Problem – General) errors in Director. #### 3.1.611.71 (reverts 3.1.611.63) _Release Date – 16 Mar 2026_ Fix CON-28: Revert incorrect on-hold skip logic introduced in 3.1.611.63. CommitCart is now always called when an order is placed, regardless of WooCommerce order status. The previous fix incorrectly skipped CommitCart for all on-hold orders; clients use bLoyal Director for order processing, not WooCommerce, so the status transition fallback never fired. #### 3.1.611.70 _Release Date – 13 Mar 2026_ Fix CON-27: Prevent duplicate CartUID when the customer navigates away before the order-received page loads. CartUID session keys are now cleared at order creation time (after the CartUID is safely saved to order metadata), instead of only on the order-received page. This ensures session cleanup is guaranteed regardless of browser behavior or payment gateway timing. ## Meta * Sürüm **3.1.611.90** * Son güncelleme **6 gün önce** * Etkin kurulumlar **10+** * WordPress sürümü ** 5.6 veya üstü ** * Test edilen sürüm **7.1** * PHP sürümü ** 7.4 veya üstü ** * Dil * [English (US)](https://wordpress.org/plugins/bloyal/) * Etiket * [loyalty points](https://tr.wordpress.org/plugins/tags/loyalty-points/) * [Gelişmiş görünüm](https://tr.wordpress.org/plugins/bloyal/advanced/) ## Puanlar Henüz inceleme gönderilmedi. [Değerlendirmeniz](https://wordpress.org/support/plugin/bloyal/reviews/#new-post) [Tüm değerlendirmeleri gör](https://wordpress.org/support/plugin/bloyal/reviews/) ## Katkıda bulunanlar * [ bLoyal ](https://profiles.wordpress.org/connectordev/) ## Destek Söyleyeceğiniz bir şey mi var? Yardım mı lazım? [Destek forumunu görüntüle](https://wordpress.org/support/plugin/bloyal/)