Plugin documentation

Requirements

• WordPress 6.2 or newer, PHP 7.4 or newer.
• WooCommerce 7.0 or newer, active. Without WooCommerce, ThanklyClub shows a warning and does not start.
• HPOS (High-Performance Order Storage) is supported.
• Settings can be changed by a user with the manage_woocommerce capability: an administrator or shop manager.

Installation

• Download the thanklyclub.zip archive from your ThanklyClub dashboard.
• In WordPress, go to Plugins → Add New → Upload Plugin, choose the archive, and click Install Now. You can also install it manually: unzip the thanklyclub folder into /wp-content/plugins/.
• Click Activate.
• A ThanklyClub item appears in the admin menu with four tabs: Dashboard, Offer categories, Placement, Connection.

Demo mode

Right after installation the plugin runs in demo mode, and you'll see a Demo mode label on the tabs. In this mode the plugin does not contact the server: AI analysis is replaced by a simplified keyword analysis of your catalog, and gifts come from a built-in set of examples.

Demo mode lets you see the block on your own store before signing up. There are no earnings in it. The plugin stays in demo mode while the Demo mode checkbox is on or no site key is set.

Connecting your site key

The same tab has a Privacy setting: the checkbox Send product titles of the order for better matching. If you clear it, the server receives only product categories.

• Sign up in the ThanklyClub dashboard and add your site to get a site key.
• Open the Connection tab and paste the key into the Site key field.
• Leave the API URL field at its default: https://thanklyclub.com.
• Clear the Demo mode checkbox and click Save connection.
• Click Test connection. On success you'll see the message "Connected to the ThanklyClub server."

AI store analysis

On the Dashboard tab, click Run AI analysis. The plugin sends the server a snapshot of your catalog: the site's name and description, up to 40 of the largest categories, the 60 latest products with prices and categories, the currency, the store's country, and the price range. The snapshot contains no customer data. The analysis takes up to a minute.

After the analysis, the Dashboard shows an AI store analysis card: Store type, Price segment, Shown categories, Analysed (date), and Model. If your range changes, click Re-run AI analysis.

Until the first analysis, the plugin shows only apps and services. Product categories that could compete with the store are hidden.

Gift categories

The Offer categories tab lists all gift categories, grouped as Apps & subscriptions, Services, Retail (products that can compete with your range), and Sensitive (only if you turn them on yourself).

Each category shows an AI recommendation: AI: show, AI: hide, or AI: your call, along with a fit score from 0 to 100. In the Your choice column you can leave Follow AI or pick Always show or Never show. The Shown column displays the result.

Sensitive categories (Banking & payment apps, Insurance, Health & supplements, Wine & alcohol (18+), Dating) are never enabled by AI; only through Always show. Prohibited ones (Gambling & betting, Crypto & trading, Loans & credit, Tobacco & vaping, Adult content) are marked Not available and cannot be enabled.

The Reset all to AI recommendations button removes your manual choices.

Domain blocklist

At the bottom of the Offer categories tab is the Blocked brands and domains field. Enter domains you don't want to see in gifts, one per line, for example competitor.com. You can leave the https:// prefix and slashes in; the plugin cleans them up.

The plugin sends the list to the server with every request and also drops, on its own side, gifts from these domains and from disabled categories, even if the server returned them. After editing, click Save categories.

Placements

The Placement tab controls where the block appears and how it looks.

• Where to show: Thank-you page after checkout and Customer order emails. Both are on by default.
• Emails: Processing order, Order on hold, Completed order, Invoice / order details. The first three are selected by default.
• Gifts per order: from 1 to 3, 3 by default.
• Headline and Subheadline of the block. The defaults are "A gift with your order" and "Pick one bonus from our partners — it is free."
• Minimum order total: the block is not shown below this amount. 0 means it is shown on all orders.
• After you click Save placement, a Preview of the block appears at the bottom of the tab.

How the block works in an order

• Gifts are requested once per order and stored in the order, so the thank-you page and the email show the same gifts.
• The block is not shown on orders with the status failed, cancelled, or refunded.
• The gift request waits for the server for up to 4 seconds. If the server doesn't respond, the page loads without the block, and checkout is not affected.
• An impression is counted once per order for each placement: the page and the email.
• A gift link goes first to your own site (the thanklyclub_go parameter with the order key). The plugin checks the order, records the click, and redirects the customer to the partner. Links open in a new tab with rel="sponsored noopener".
• Below the block is a note that these are partner offers and that no personal data is passed to them.

Shortcode [thanklyclub_offers]

The block is inserted through the woocommerce_thankyou hook. Some themes and the block-based order confirmation template don't fire this hook, and the block doesn't appear. In that case, add the [thanklyclub_offers] shortcode to the "Order received" page template, for example with a Shortcode block in the Site Editor.

The shortcode outputs the block only on an order page with a valid order key in the URL. On other pages it shows nothing.

Emails

The block is added to emails through the woocommerce_email_after_order_table hook, right after the order table. HTML emails get a styled card, and plain-text emails get a list of gifts with links. The block does not appear in emails to the administrator.

Choose which emails show gifts on the Placement tab, in the Emails section.

Statistics in the plugin

The Dashboard shows impressions for the last 30 days (Impressions), Clicks, Click-through rate, and Earnings. The plugin fetches earnings from the server and refreshes them every 15 minutes; in demo mode the amount is replaced by Connect to see. Below are the Performance by category table and Preview: what customers see.

The plugin stores impressions and clicks in its own table in the WordPress database: the event, offer, category, placement, order number, and time. The table holds no personal data. Detailed statistics and earnings are in your ThanklyClub dashboard.

Uninstalling

Deactivate the plugin under Plugins, then click Delete. On deletion the plugin removes its settings (thanklyclub_settings), the AI analysis result (thanklyclub_analysis), your category choices (thanklyclub_category_rules), housekeeping records, and the wp_thanklyclub_events table.

Orders already placed keep the meta fields _thanklyclub_offers and _thanklyclub_seen, the list of gifts that were shown. If you only deactivate the plugin, all settings are kept.

FAQ