Loyalil Rewards for WooCommerce

This plugin connects your store to your customer loyalty club at Loyalil. Once connected, every paid order earns the customer credit against their phone number, and a refund automatically reverses that credit. All of the club's own rules — stamps, cashback, tiers, promotions — are kept and decided at Loyalil, so the plugin never needs updating when you change how the club works. Shoppers reach the club in whichever ways you switch on, all from one settings screen (WooCommerce → Loyalil):

• A floating button in the corner of the screen, on every page or only on the kinds of page you tick (home, shop, product pages, cart, checkout, My Account, the club page, everything else). It opens a panel with the card, joining and redemption, without leaving the page.
• The menu: a club icon beside your main menu, in block themes and classic themes alike, or any menu link you point at #loyalil-club. Both open the same panel, by mouse, touch or keyboard.
• A club page: a full page on your site with the headline, tiers, how it works and FAQ, and the card inside it. The settings screen can create it for you.
• The card inside any page: the "Loyalil Club" block in the block editor, the "Loyalil Club Card" widget in Elementor, or the [loyaly_club] shortcode in any theme. On the "My Account" page the card appears automatically.

Connecting WooCommerce → Loyalil (or "Settings" under the plugin's name on the Plugins screen) → "Connect to Loyalil". There are no keys to create and nothing to copy. If your host blocks the automatic connection, you can paste a key by hand under "Advanced" on the same screen. Recovering an abandoned cart WooCommerce does not track a checkout that was started and never finished, so this plugin reports each checkout it sees to Loyalil, and Loyalil decides — on a setting you control at Loyalil, next to the club's other messaging settings — whether and after how long to remind that customer, on the channels and with the marketing consent your club already has for them. See "External services" below for exactly what is sent.

1.0.6

• New: choose the club icon. WooCommerce → Loyalil → Look → "Icon" offers a gift, a person, a star or a heart, for the menu icon and the floating button together. Shops that never choose keep the gift they have today.

1.0.5

• The club now opens as a floating window beside the button or icon that was pressed, instead of a popup in the middle of the screen. WooCommerce → Loyalil → Look → "How the club opens" offers the floating window, a full-height drawer from the side, or the popup. The club inside is the same in all three, and a shop can switch at any time without losing anything; the menu icon, the floating button and the card in My Account all follow it. Shops that never chose get the floating window on update.
• Fixed: the club panel jumped while it opened. It was sized by its content, so it appeared as an empty box, grew when the club answered and grew again when the member screen arrived. Every shape now keeps one size from the first frame and shows a placeholder until the club answers.
• Fixed: the club card in My Account pushed the page down twice as it loaded (nothing, then a small card, then a larger screen squeezed into the column). It is now one card that keeps its size from the first paint, with a button that opens the full club.
• The page behind the panel no longer shifts sideways when its scrollbar is hidden, and keeps its scroll position.
• Readability: text on the floating button and in the card's header is white or near-black, whichever reads on the club's colour, and brand-coloured text is darkened until it meets WCAG AA contrast. A light brand colour such as gold was unreadable before.
• The club screen inside the panel (served by Loyalil, so these reach every plugin version): the first tab is now "My card"; on a phone the member sees an "Add to Apple Wallet" or "Add to Google Wallet" button instead of a QR code the same phone cannot scan, while a computer keeps the QR; the Orders tab finds the member's orders by email and by phone and shows only orders that belong to them; and a stamps card no longer says a gift is waiting when it is not.

1.0.4

• The floating club button appears on every page in the club's own colour, the menu icon opens the club panel, all settings live on one screen under WooCommerce → Loyalil, and the club panel is a single clean sheet with its own close button.
• Fixed: the floating club button appeared only on the club page and My Account. Its script was queued too late for WordPress to print it on any other page. It now appears on every page, or only on the pages you choose.
• New: a club icon in the menu. It sits beside the main menu in block themes (Twenty Twenty-Four, Twenty Twenty-Five and the like) and inside the chosen menu in classic themes. It is a real link, reachable with the keyboard, and it opens the club panel; if the panel cannot open, it leads to your club page. Any menu link pointed at #loyalil-club does the same.
• The club panel was redesigned as one surface: the card no longer sits inside a second frame, and the close button has its own row, clear of the content. On phones it is a bottom sheet you can drag down to close. It is a proper dialog: focus moves into it and stays there, Escape closes it, focus returns to whatever opened it, and reduced-motion settings are respected.
• One settings screen, in four numbered sections: Connection, Where the club appears, Look, Advanced. It shows the connection's live state with a "Check the connection now" button, lets you pick or create the club page, and has a single Save button. A "Settings" link was added on the Plugins screen.
• The floating button can show an icon with text or an icon only, and uses the club's colour from Loyalil or one you pick. Up to 1.0.3 it was always navy.
• The club page's "Join the club" button opens the join form again instead of only scrolling to the card.
• Updating keeps your settings. The first time 1.0.4 runs, it copies what 1.0.3 saved into its own settings and leaves the old values in place, so a shop that had the floating button off does not get one after the update.

1.0.3

• The club page's stylesheet now reaches the page through WordPress's own style queue, added with wp_add_inline_style(), instead of a style tag printed inside the page content. The page looks the same.
• The list of addresses this site reports to Loyalil is now only the site's own home and site URLs. It no longer includes the Host header of incoming requests, which the sender of a request can set to anything, and the list earlier versions stored is deleted.

1.0.2

• Renamed from "Loyaly for WooCommerce" to "Loyalil Rewards for WooCommerce" — the previous name was too close to an existing project's in the same field. The slug, text domain and every on-screen mention of the old name changed with it; nothing about how the plugin connects, earns, reverses or displays the club changed.

1.0.1

• The club page's HTML, which is fetched from Loyalil and printed inside your theme, now passes through an allowlist of tags and attributes before it reaches the page. Nothing on that list can run a script or load a frame, so the page renders as designed even if the response is ever tampered with. The page's own stylesheet is kept, checked separately, so the design is unchanged.
• Two small changes to the club page follow from that. Its headings now use your theme's own sans-serif rather than fetching Heebo and Inter from Google, so the page no longer contacts anyone but Loyalil; and the tier pills under the hero no longer fill in when pressed, though they still jump to the tier they name.
• The API address is now checked against Loyalil's own host before it is stored, from both the connect handshake and the settings form. A site can still be pointed elsewhere for development, but only by defining LOYALY_API_HOST in wp-config.php, which needs file access to the server rather than a login.
• Declares WooCommerce as a required plugin, so WordPress checks for it before activating.

1.0.0

• Abandoned-cart recovery: the plugin now reports a started checkout to Loyalil, so Loyalil can send a reminder — with the customer's real balance, not just "you left something in your cart" — if the order is never completed. Off unless switched on at Loyalil.
• A customer who joins the club on your storefront now also reaches your own WooCommerce Customers list, the way one who places an order already did.
• Registered with WordPress's own Export Personal Data and Erase Personal Data tools.
• Documentation catch-up: this readme had fallen behind the plugin by several versions. It now names every external service the plugin uses (see "External services" above), and the version number here matches the plugin's own for the first time in a while. Nothing in this release changes how the connection, the widget, or redemption already worked — see the FAQ and "External services" sections for what they do now that this file has caught up.
• Text domain corrected to match the plugin's own slug.

0.7.1

• Identifying a customer without a store account: phone or email and a one-time code.
• Guest mode always offers two choices: join the club, or sign in as an existing member.
• New widget design — the club's own logo and colours, full Hebrew support.
• "Not me, sign out" on any shared device.

0.7.0

• Thank-you page: an offer to join right after payment, with the exact value of that order in cashback or stamps.
• "No thanks" is recorded for that order only and does not ask again.
• Someone already a club member sees no offer at all.

0.6.0

• Redeeming balance from inside the store: a discount code is created in WooCommerce, and cancelling it returns the balance.

0.5.0

• Redesigned admin screen: cards, a tagged connection state, one-click shortcode copy, and a collapsible diagnostics section.
• The screen follows the logged-in user's own language (Hebrew or English), correctly aligned in both.
• A block for the block editor and a widget for Elementor. The shortcode remains as a fallback.

0.1.0

• First version: one-click connect, earning on a paid order, reversal on refund, the club card shown in the store.