# Kemoku: full documentation

> A WordPress plugin for gambling affiliate websites to manage and promote sportsbook and casino reviews.

============================================================
Kemoku
============================================================

---

URL: https://docs.affkraft.com/kemoku
Markdown: https://docs.affkraft.com/kemoku.md

# Kemoku Plugin

Kemoku is a WordPress plugin developed for gambling affiliate websites. It gives
opportunities to manage and promote sportsbook and casino reviews easily.

***

## Getting Started

It's easy to get started with Kemoku. Follow the documentation to install the
plugin and create compelling review pages.

### Requirements

Before getting started make sure you have all the requirements met.

To use the plugin, you must be running `WordPress 6.0` or higher and `PHP 8.4`
or higher. \
Recommended `WordPress 7.1`.

Also make sure your host has the minimum requirements to run WordPress and PHP
`max_upload_size` is more than `8MB`.

### Changelog

Find the full changelog [here](https://affkraft.com/changelog?product=kemoku).

---

URL: https://docs.affkraft.com/kemoku/installation
Markdown: https://docs.affkraft.com/kemoku/installation.md

# Plugin Installation

You can install the plugin either through WordPress dashboard (recommended) or via FTP.

***

## Before Installation

Please make sure your server meets the minimum [system requirements](https://docs.affkraft.com/kemoku#requirements) and download the plugin file from your [AffKraft account](https://affkraft.com/login).

### Install through WordPress Dashboard

1. Visit WordPress dashboard → Plugins and click `Add New` and `Upload Plugin` after that
2. Click `Choose File`, select the plugin file `kemoku.zip` and click `Install Now`
3. Activate the plugin

### Install via FTP

1. Log in to your server with your FTP credentials, using an FTP client, cPanel or similar
2. Navigate to `plugins` directory from your WordPress website root
3. Upload the plugin file `kemoku.zip` to `plugins` directory
4. Unzip the archive, you'll have a directory `kemoku` in plugins
5. Remove the `kemoku.zip` file
6. Visit WordPress dashboard → Plugins and activate the plugin

---

URL: https://docs.affkraft.com/kemoku/registration
Markdown: https://docs.affkraft.com/kemoku/registration.md

# Plugin Registration

You need to register your plugin to be able to receive new security and feature updates.

***

## Setup Page

After activating the plugin you'll be prompted with a notice to add your product key and configure your review pages.

Click on **the setup page** link to access the plugin setup interface.

***

## Plugin Registration

The setup page includes three main sections. The first section is for plugin registration.

### Add Product Key

1. **Get Your Product Key**: You can find your product key in your [AffKraft account dashboard](https://affkraft.com/login)
2. **Enter Product Key**: On the setup page, enter the product key you got from your AffKraft account
3. **Save**: Click "Save" to register the plugin
4. **Confirmation**: A message confirming the plugin product key registration will appear

### Troubleshooting Registration

If you get an error that the license key is not correct and the registration fails:

* Make sure there are no white spaces at the beginning or end of the key
* If you have a firewall installed on your server, make sure requests to `api.affkraft.com` are not being blocked

***

## Review Page Slug

The second section allows you to configure your review pages URL structure.

### Set Reviews Page Slug

1. **Enter Slug**: Enter the slug you want for your review pages (default: "reviews")
2. **Preview URLs**: The setup page shows example URLs based on your slug choice
3. **Save**: Click "Save" to set the slug

**Example URLs with default slug:**

* `https://your-domain.com/reviews/bet365`
* `https://your-domain.com/reviews/bovada`

***

## Clear Cache

The third section provides cache management functionality.

### Clear Plugin Cache

* **Clear Cache**: Click "Clear Cache" to remove all cached plugin data
* **Use When**: Clear cache if you experience display issues

---

URL: https://docs.affkraft.com/kemoku/review-pages
Markdown: https://docs.affkraft.com/kemoku/review-pages.md

# Creating Review Pages

In your WordPress dashboard you will find a new menu called **Kemoku Reviews** right below the **Pages** menu link. Click `Add New` to add a new review.

***

## Review Fields

Besides adding your review title and content as usual, you'll find **Review Fields** section below page content. Here you can define properties for each review. The fields are in separate sections and have descriptions to make it easy for you to fill them in.

### General Fields

Define main review information such as the name, logo, affiliate URL, rating. All fields in this section are required.

### Bonus & Terms Fields

Define bonus, bonus code (if any) and terms that can be the full terms and conditions text and/or a URL.

### Payments & Currencies

Define *Payment Methods* and *Currencies* for the reviewed item and display them in your content through `Review Payments` and `Currencies` block.
Payment method and currency information is also used for filtering review listings.

### Details

Define some details such as *Services, Sports, Licenses, Features* for the reviewed item. Services and sports can be displayed using `Review Services` and `Review Sports` blocks. They can be also used in listing filters along with features.

### Hero Section

Define whether the *Hero* section at the top of the review page is enabled or not.
Hero section settings can be adjusted on [plugin settings page](https://docs.affkraft.com/kemoku/settings#hero)

### CTA Section

Define whether the *CTA* section at the bottom of the review page is enabled or not, as well as fill in the CTA details.
CTA section settings can be adjusted on [plugin settings page](https://docs.affkraft.com/kemoku/settings#cta)

### Pros & Cons

Define *Pros & Cons* of the reviewed item and display it in your content through `Review Pros & Cons` block.

### Ratings

Define *Ratings* of the reviewed item and display it in your content through `Review Ratings` block.

### Info

Define *Review Info* fields for the reviewed item and display it in your content through `Review Info` block.

### Geo Targeting

Here you can define supported or restricted countries for the reviewed item. Fill just one of the fields, whichever information is available to you. Do NOT fill in both fields, in that case "Restricted Countries" will be used.

You can also define supported US States in this section.

If the operators provide you with different affiliate links for different regions, you can use "Affiliate Links" field to add as many country-specific links as you want. Simply choose a country and add a link.

### Schema.org markup

For all your review pages the plugin generates **Review Snippet Structured Data** (schema.org) markup. The rating value used is the "Rating" field from "Bonus & Rating" section. It is generated automatically so you don't need to do anything. You can test your pages [here](https://search.google.com/structured-data/testing-tool).

By default the review snippet author is set as "Organization" and the name is your website title.

`💁 since version 1.5.2` you can change the author to "Person" and that would be the review page author. You can do that in Kemoku Settings → [General](https://docs.affkraft.com/kemoku/settings#general-settings).

### Taxonomies

`💁 since version 1.5` you can assign **Categories** and **Tags** to review pages,
and you can filter reviews on tables and grids by category and tag as well.

---

URL: https://docs.affkraft.com/kemoku/review-page-blocks
Markdown: https://docs.affkraft.com/kemoku/review-page-blocks.md

# Review Page Blocks

There are multiple blocks and shortcodes available for you to present your website information. It is recommended to use native blocks instead of shortcodes, however if for some reason you're still using a version of WordPress lower than 5.0, you can use shortcodes as well.

There are 2 groups of blocks:

1. Blocks you can use on all pages
2. Blocks you can use on review pages

This page describes the blocks that you can use on review pages.

***

## Available Review Page Blocks

Here are the blocks available in Kemoku plugin that you can use on any review page:

* Review Hero
* Review Info
* Review Ratings
* Review Pros & Cons
* Review Payment Methods
* Review Services
* Review Countries
* Review US States
* Review Currencies
* Review Sports
* Review Country Support

In most cases, there's nothing to configure in these blocks, simply add the blocks where you want to display them, and they are ready.

You can also use **[Review CTA](https://docs.affkraft.com/kemoku/blocks#review-cta)** and **[Review Bonus](https://docs.affkraft.com/kemoku/blocks#review-bonus)** blocks in review pages.

### Review Hero Block

The Review Hero block displays the main hero section of your review page. This block doesn't require any configuration - it automatically displays the review information from your review fields.

### Review Info Block

The Review Info block displays the basic information about the reviewed item. This block doesn't require any configuration - it automatically displays the information from your review fields.

### Review Ratings Block

The Review Ratings block has 2 configuration options:

* **Display Option**: Choose between "Stars" or "Progress Bar" display format
* **Display a CTA Section**: Toggle to show/hide the call-to-action section

### Review Pros & Cons Block

The Review Pros & Cons block doesn't require any configuration, just make sure you have filled in the `Pros & Cons` fields on review page.

### Review Payment Methods Block

The Review Payment Methods block has 1 configuration option:

* **Display a CTA Section**: Toggle to show/hide the call-to-action section

### Review Services Block

The Review Services block has 3 optional fields:

* **Block Heading**: Leave empty for default heading, or set "none" for no heading.
* **Bonus**: Leave empty for default review bonus or add a new one.
* **Button Text**: Leave empty for default button text or set a custom one.

### Review Countries Block

The Review Countries block has 2 configuration options:

* **List Supported or Restricted Countries**: Choose whether to display supported countries or restricted countries
* **Display a CTA Section**: Toggle to show/hide the call-to-action section

### Review US States Block

The Review US States block has 2 configuration options:

* **Style**: Choose between "Map" or "List" display format
* **Display a CTA Section**: Toggle to show/hide the call-to-action section

This is the states displayed as a map.

This is the states displayed as a list. If you switch off the "Display CTA section" option, the part with the review item's logo will not be displayed.

### Review Currencies Block

The Review Currencies block has 1 configuration option:

* **Display a CTA Section**: Toggle to show/hide the call-to-action section

This is what the currencies block looks like. If you switch off the "Display CTA section" option, the part with the logo and link will not be displayed.

If you for some reason add a custom currency and no symbol, there will be a dash instead of it.

### Review Sports Block

The Review Sports block has 1 configuration option:

* **Display a CTA Section**: Toggle to show/hide the call-to-action section

This is what the sports block looks like. If you switch off the "Display CTA section" option, the button will not be displayed.

### Review Country Support Block

`💁 since version 2.0` The Review Country Support block displays geo-targeting information for the current review. This block doesn't require any configuration - it automatically shows country availability status based on the visitor's location and the review's supported countries.

---

URL: https://docs.affkraft.com/kemoku/blocks
Markdown: https://docs.affkraft.com/kemoku/blocks.md

# Kemoku Plugin Blocks

There are multiple blocks and shortcodes available for you to present your website information. It is recommended to use native blocks instead of shortcodes, however if for some reason you're still using a version of WordPress lower than 5.0, you can use shortcodes as well.

There are 2 groups of blocks:

1. Blocks you can use on all pages
2. Blocks you can use on review pages

This page describes the blocks you can use on all pages.

***

## Using Blocks

Below are the blocks available in Kemoku plugin you can use on all pages:

* Reviews Listings (Tables and Grids)
* Review CTA
* Review Bonus

### Reviews Listings

Simply add the block, select reviews you want to display, adjust the settings and they are ready.

`💁 since version 1.5` you can choose reviews manually, filter them by category or by tag(s).

You can select a review category and all reviews in that category will be displayed. You can also set a limit, for example display 10 reviews in "Sports" category.

Besides categories, you can filter reviews by review tags as well. In difference to categories, you can select multiple tags. For example, display 12 reviews tagged "USA" and "Canada". You can combine those 2 together, for example display 10 reviews in "Sports" category tagged "USA" and "Canada".

`💁 since version 1.5.7` you can overwrite bonus and affiliate link values on each listing block.

`💁 since version 1.5.8` you can enable filters, sorting and load more button on listing blocks.

`💁 since version 1.6.3` you can display terms in a popup.

`💁 since version 2.0.0` you can display filter reviews by the visitor's country and display a country support badges on listing items.

`💁 since version 2.2.0` you can overwrite bonus codes for individual items in your tables and grids.

`💁 since version 2.2.0` you can filter review tables and grids by specific custom fields like payment methods, currencies, sports, services, countries and US states.

#### Table

#### Table: Payments

`💁 since version 1.6.5`

New table design for showcasing review payment options such as different payment methods, payout speeds. You can use the filtering, sorting and limiting options with this table as well. The styles of this table can be easily customized, learn how to do that [here](https://docs.affkraft.com/kemoku/how-to#how-to-customize-"table:-payments"-block-design).

#### Grid

#### Grid: Bonus

`💁 since version 1.6.8`

New grid design for showcasing review bonuses. You can use the filtering, sorting and limiting options with this grid as well. The styles of this grid can be easily customized, learn how to do that [here](https://docs.affkraft.com/kemoku/how-to#how-to-customize-"grid:-bonus"-block-design).

#### Filters and Sorting

Both for tables and grids, this is what the filters and sorting popup looks like. And you can customize every part of it as described [here](https://docs.affkraft.com/kemoku/listing-tools).

### Review CTA

Simply add the block, fill in the heading (optional), content and button/link fields and it's ready.

### Review Links

`💁 since version 2.4.0`

New list block for displaying links to review pages.

To customize the block styles, override the below CSS custom properties in your Additional CSS section.

```css
.sb-review-links {
  /* min width of each grid item */
  --item-width: 280px;
  /* grid item padding */
  --item-padding: 1em;
  /* gap between elements in grid items */
  --item-gap: 1em;
  /* the height of the log image */
  --logo-height: 3rem;
  /* the color of the border and right chevron */
  --accent-color: #cad5e2;
  /* the hover color of the border and right chevron */
  --hover-color: #62748e;
  /* grid item background color */
  --item-bg-color: transparent;
  /* logo image background color */
  --logo-bg-color: #fcfcfc;
  --text-color: #333;
  --name-font-size: 1em;
  --shadow: none;
  --radius: var(--section_border_radius);
}
```

### Review Bonus

`💁 since version 2.3.0`

New card block for showcasing a single review's bonus offer. Displays the review logo, a bonus heading label, the bonus text, an optional copy-able bonus code, an affiliate link button, and optional terms.

The block can target a specific review via the **Review** field, or leave it empty to automatically use the current review page. You can override the bonus text, bonus code, affiliate link, and terms directly in the block fields.

### Blocks vs Shortcodes

You can use all blocks as shortcodes as well. Check out [Shortcodes](https://docs.affkraft.com/kemoku/shortcodes) for more information.

> It is highly recommended to use blocks instead of shortcodes. Future blocks may not have shortcodes.

---

URL: https://docs.affkraft.com/kemoku/shortcodes
Markdown: https://docs.affkraft.com/kemoku/shortcodes.md

# Kemoku Plugin Shortcodes

All the plugin blocks are also available as shortcodes. This is useful if you're using WordPress versions below 5.0 or prefer to use shortcodes instead of blocks.

***

## General Shortcodes

Here are the general shortcodes available in Kemoku plugin you can use on all pages:

**Reviews Table**

```html
[sb_table source="manual" ids="6, 9" style="no-terms|link-terms|popup-terms spacing altrows"]
```

```html
[sb_table source="tax" cat="42,43" tag="73,74" style="..."]
```

**Reviews Grid**

```html
[sb_grid source="manual" ids="6, 9" style="no-terms|link-terms|popup-terms"]
```

```html
[sb_grid source="tax" cat="42,43" tag="73,74" style="..."]
```

**Reviews Table: Payments**

```html
[sb_payments_table source="manual" ids="6, 9" style="short-terms|link-terms|popup-terms"]
```

```html
[sb_payments_table source="tax" cat="42,43" tag="73,74" style="..."]
```

**Reviews Grid: Bonus**

```html
[sb_bonus_grid source="manual" ids="6, 9" style="no-terms|link-terms|popup-terms"]
```

```html
[sb_bonus_grid source="tax" cat="42,43" tag="73,74" style="..."]
```

**Review CTA**

```html
[sb_cta content="Content" button_url="#" button_text="Button Text" heading="Heading"]
```

**Review Links**

```html
[sb_review_links ids="6, 9"]
```

**Review Bonus**

```html
[sb_bonus review_id="" bonus_heading="Welcome Bonus" terms="none" bonus="" bonus_code="" button_url=""]
```

To see the general shortcodes and the parameters they accept check the [Shortcode Generator](https://docs.affkraft.com/kemoku/shortcodes#shortcode-generator) in your WordPress dashboard.

***

## Review Page Shortcodes

Here are the shortcodes available in Kemoku plugin you can use on review pages:

* `[sb_hero]`
* `[sb_info]`
* `[sb_ratings]`
* `[sb_pros_cons]`
* `[sb_countries]`
* `[sb_us_states]`
* `[sb_currencies]`
* `[sb_payment_methods]`
* `[sb_services]`
* `[sb_sports]`
* `[sb_country_support]`

To see the review page shortcodes and the parameters they accept check the [Shortcode Generator](https://docs.affkraft.com/kemoku/shortcodes#shortcode-generator) in your WordPress dashboard.

***

## Shortcode Generator

You can easily generate shortcodes by using the **Shortcode Generator** if you choose to use shortcodes instead of blocks. In WordPress dashboard visit **Kemoku Reviews** → **Shortcode Generator** and you'll find generators and information about all available shortcodes.

The shortcode generator includes all the listing blocks, CTA and review page blocks.

Generate the shortcode with a couple of mouse clicks, copy and paste the result where you need.

---

URL: https://docs.affkraft.com/kemoku/widgets
Markdown: https://docs.affkraft.com/kemoku/widgets.md

# Kemoku Plugin Widgets

There are 2 type of widgets available in the plugin.

***

### Blocks as Widgets

Since WordPress 5.8 update, blocks can be used as widgets, and that's the recommended way. Kemoku has been updated so that you can use blocks in widget areas. All widgets, including the ones that are intended for review pages only, can be used in widget areas. Check out plugin [blocks](https://docs.affkraft.com/kemoku/blocks) for more information.

However, if for some reason you want to use legacy widgets, you still do so as described below.

### Review Widgets

Here are the widgets available in Kemoku plugin that you can use:

* Kemoku Review Widget
* Kemoku Reviews Widget

`💁 since version 1.0.8` you can choose to:

* display terms and conditions in full,
* just a short notice
* or skip them at all.

#### Kemoku Review Widget

#### Kemoku Reviews Widget

---

URL: https://docs.affkraft.com/kemoku/ai
Markdown: https://docs.affkraft.com/kemoku/ai.md

# Kemoku & AI

With Kemoku 2.6.0 you can manage your reviews from an AI chat. Ask Claude or
ChatGPT something like "which reviews have no bonus terms?" or "add these pros
and cons to *review name*", and it does the work on your website for you.

This page explains how to set that up. If you are a developer using a coding
tool such as Claude Code, skip to
[Coding agents and developer tools](https://docs.affkraft.com/kemoku/ai#coding-agents-and-developer-tools).

***

## Manage your website from a chat with an AI agent

### How it works

An AI assistant doesn't log in to your dashboard and click around like you do.
Instead, your website gives it a list of specific tasks it is allowed to do,
such as "list reviews", "update a review" or "set the bonus". WordPress calls
these tasks **abilities**.

To make this work you need three things:

1. **Kemoku** provides the abilities for your reviews, review categories and
   tags, Kemoku blocks and shortcodes, settings and license. You choose which
   ones to offer on the **Kemoku Reviews → AI & Abilities** page.
2. **"[MCP Adapter](https://wordpress.org/plugins/mcp-adapter/)"**, a free
   plugin, lets AI apps connect to your website and use those abilities.
3. **"[Enable Abilities for MCP](https://wordpress.org/plugins/enable-abilities-for-mcp/)"**,
   a free plugin, adds the sign-in. When you connect a chat app, you log in to
   your WordPress website and approve the connection, much like "Sign in with
   Google" on other websites.

The assistant then works as the WordPress user you signed in with. If that user
isn't allowed to do something, the assistant can't do it either.

> **Warning**
>
> AI abilities need WordPress 6.9 or newer. On older versions the
> **AI & Abilities** page shows a notice, upgrade to latest versions to be able
> to use Kemoku's AI abilities.
>
> Your website must also be online and use HTTPS, because the chat app connects
> to it over the internet. A local website, or a staging website behind a
> password, won't work.

### Set it up

1. **Install the plugins.** Go to **Kemoku Reviews → AI & Abilities**.
   The **Status** box at the top has buttons to install and activate both
   plugins.
2. **Choose what the assistant can do.** On the same page, tick **Enable
   abilities**, then tick the groups you want and click **Save Changes**. The
   default groups let the assistant read and edit reviews, manage categories
   and tags, and work with Kemoku blocks and shortcodes, but not move reviews
   to the trash or change your settings or license.
3. **Turn on sign-in.** Go to **Settings → WP Abilities**, open the
   **Connection** tab and turn on the OAuth connector.
4. **Connect your chat app.** In your chat app, add a *custom connector* and
   paste your website address. You'll be sent to your WordPress login page:
   sign in and approve.
5. **Try it.** Start a new chat, make sure the connector is switched on for it,
   and ask "list my five most recent reviews".

Where to add a custom connector depends on the app. Menu names change often, so
treat these as a guide:

| App | Where |
| --- | --- |
| Claude | **Settings → Connectors → Add custom connector** |
| ChatGPT | Turn on Developer Mode in **Settings → Apps & Connectors → Advanced settings**, then create a connector with your website address and OAuth sign-in. Paid plans only, at the time of writing. |
| Gemini | **Settings → Connected Apps → Add a custom app**. Available to personal accounts in the US only, at the time of writing. |

> **Tip**
>
> "Enable Abilities for MCP" also comes with its own abilities for posts, pages,
> media and more. Kemoku doesn't need them, so turn on only the ones you want on
> its **Abilities** tab.

### The AI & Abilities page

**Status** tells you whether everything is ready. A green tick means that part
is fine; a warning icon tells you what's missing, usually with a button to fix
it.

* **MCP Adapter** and **Chat app sign-in (OAuth)** show whether the two plugins
  are active. When MCP Adapter is active, its endpoint address is shown too.
* **Kemoku abilities** shows how many tasks the assistant can currently use,
  and from how many groups.
* **Hidden elsewhere** only appears if "Enable Abilities for MCP" has switched
  off some of Kemoku's abilities on its own screen. Turn them back on there if
  you want to use them.

**Ability Groups** starts with the main switch, **Enable abilities**. It is off
by default, and while it's off, assistants can't do anything with your Kemoku
data. Below it, related tasks are grouped together, for example everything
needed to create and update reviews.

**Individual abilities (advanced)** lets you switch off a single task inside a
group you turned on. For example, you can let the assistant update reviews but
not change their geo affiliate links.

### Ability groups

"Who can use it" means which WordPress users the assistant can sign in as to
use that group.

| Group | What it can do | Abilities | Who can use it | Default |
| --- | --- | --- | --- | --- |
| Reviews: read | List, view and audit reviews, list valid field choices and check country support | `kemoku/list-reviews`, `kemoku/get-review`, `kemoku/audit-reviews`, `kemoku/list-field-choices`, `kemoku/check-geo-support` | Users who can edit pages (Editor and up) | On |
| Reviews: edit | Create review drafts and update review fields, status, categories and tags, including the bonus, pros & cons, ratings, payments, info table, countries and geo links | `kemoku/create-review`, `kemoku/update-review`, `kemoku/set-bonus`, `kemoku/set-pros-cons`, `kemoku/set-ratings`, `kemoku/set-payments`, `kemoku/set-info-table`, `kemoku/set-geo`, `kemoku/set-geo-links` | Users who can edit pages, only on reviews they may edit. Publishing needs publish rights | On |
| Reviews: trash | Move reviews to the trash and restore them | `kemoku/trash-review`, `kemoku/restore-review` | Users who can delete that review | Off |
| Categories & tags | List, create, rename and delete review categories and tags | `kemoku/list-terms`, `kemoku/create-term`, `kemoku/update-term`, `kemoku/delete-term` | Users who can manage categories (Editor and up) | On |
| Blocks & shortcodes | Find Kemoku blocks and shortcodes in posts and pages, change their settings and insert new ones | `kemoku/list-element-types`, `kemoku/find-elements`, `kemoku/get-elements`, `kemoku/update-block`, `kemoku/update-shortcode`, `kemoku/insert-block`, `kemoku/insert-shortcode` | Users who can edit that post or page | On |
| Kemoku settings | Read and update Kemoku settings, apply a color theme, change the review URL slug and clear the cache | `kemoku/get-settings`, `kemoku/update-settings`, `kemoku/apply-color-theme`, `kemoku/set-review-slug`, `kemoku/clear-cache` | Administrators | On |
| License & updates | Check the license, activate or deactivate it, and check for and install Kemoku updates | `kemoku/get-license-status`, `kemoku/activate-license`, `kemoku/deactivate-license`, `kemoku/check-update`, `kemoku/install-update` | Administrators; installing updates also needs permission to update plugins | Off |

### Keeping it safe

* **Use a separate WordPress user** for the assistant, with the Editor role,
  instead of your own Administrator account.
* **Start with the default groups** and turn on more only when you need them.
* **Nothing goes live by accident.** New reviews are always saved as drafts. A
  review can only be published once it has the required fields: image, name,
  affiliate URL, rating and bonus.
* **Reviews are never deleted for good.** "Move to trash" only moves reviews to
  the Trash, where you can restore them. Deleting a review category or tag,
  however, can't be undone (the reviews themselves are kept).
* **Your keys stay private.** The assistant can't read your Kemoku license key
  or your MaxMind license key, only whether one is set.
* **Some settings have wide effects.** Changing the review URL slug changes the
  address of every review, so old links stop working unless you add redirects.
  Applying a color theme overwrites your style settings and resets every text
  setting to its default.
* **Ask to see changes first**, especially for bulk edits: "show me the changes
  before saving".

### Things you can ask

* "Which reviews have no bonus terms?"
* "Audit my reviews for missing data and list what's missing."
* "Add these pros and cons to *review name*: ..."
* "Set the geo link for Canada on *review name* to *affiliate URL*."
* "Is *review name* available to visitors from Germany?"
* "Add a Reviews Table with the top 5 reviews to the homepage."
* "Create a draft review for *brand name* with a 100% welcome bonus up to $200.
  Show me the change before saving."

The audit checks each review for problems such as a missing image, name,
affiliate URL, rating or bonus, a bonus without terms, missing pros or cons,
conflicting country settings and reviews that haven't been updated for six
months.

***

## Coding agents and developer tools

Tools such as Claude Code, Codex or Cursor don't need the chat-app sign-in, so
"Enable Abilities for MCP" isn't required. You still turn on the abilities in
**Kemoku Reviews → AI & Abilities**.

### MCP over HTTP

Needs the "MCP Adapter" plugin and a WordPress
[Application Password](https://developer.wordpress.org/advanced-administration/security/application-passwords/)
(**Users → Profile**). The `@automattic/mcp-wordpress-remote` proxy connects
to the endpoint. For Claude Code:

```bash
claude mcp add wordpress \
  --env WP_API_URL=https://example.com/wp-json/mcp/mcp-adapter-default-server \
  --env WP_API_USERNAME=your-user \
  --env WP_API_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \
  -- npx -y @automattic/mcp-wordpress-remote@latest
```

### MCP over WP-CLI

On a local site, or over SSH, you can skip HTTP and run the MCP server through
WP-CLI (STDIO):

```bash
wp mcp-adapter list
wp mcp-adapter serve --server=mcp-adapter-default-server --user=admin
```

### WordPress REST API

Abilities with REST enabled are also listed by WordPress itself at
`/wp-json/wp-abilities/v1/abilities`. Kemoku's abilities are in the `kemoku`
category.

***

## AI writing helpers in the editor

The official WordPress AI plugin adds writing helpers inside the Block Editor,
such as titles, excerpts and alt text. It works alongside Kemoku and is a
different thing from managing your website from a chat assistant.

---

URL: https://docs.affkraft.com/kemoku/settings
Markdown: https://docs.affkraft.com/kemoku/settings.md

# Plugin Settings

To customize the plugin options visit **Kemoku Reviews** → **Settings** in your WordPress Dashboard where you can define all plugin options.

To let AI assistants such as Claude or ChatGPT work with your reviews and settings, see [AI](https://docs.affkraft.com/kemoku/ai).

***

## Adjusting Settings

All default plugin settings are defined in this page. Take your time to go over each field and set the value you need.
If you find a field name unclear, check the detailed information right below it.

### General Settings

These settings apply to all the plugin sections.

**Key Settings:**

* **Affiliate Link Target**: Choose whether affiliate links open in new tab or same tab
* **Affiliate Link Rel Attribute**: Set rel attributes for affiliate links (nofollow, noopener, etc.)
* **Button Styling**: Customize button colors, font weight, and shadow effects
* **Rating Stars**: Configure star colors and total number of stars
* **Table Styling**: Set background and font colors for table rows and grid items
* **Collapsed Lists**: Enable collapsed lists in review blocks and set initial item count

### Hero Section

These settings apply to Hero section only.

**Key Settings:**

* **Affiliate Link/Button Text**: Customize the hero button text
* **Ratings Headline**: Text above the rating stars
* **Bonus Text**: Bonus information display
* **Include Geo Section**: Enable/disable country support messages in hero
* **Hero Layout**: Choose between 1 or 2 column layout

### Pros & Cons

These settings apply to Pros & Cons section only.

**Key Settings:**

* **Pros Icon Color**: Background color for pros icons
* **Cons Icon Color**: Background color for cons icons
* **Heading Font Size**: Font size for pros/cons headings
* **Text Styling**: Font size and colors for pros/cons text

### CTA Section

These settings apply to CTA section only.

**Key Settings:**

* **Block Headline**: Headline for the CTA section
* **Button Text**: CTA section button text
* **Heading Font Size**: Font size for CTA headings
* **Button Styling**: Colors and styling for CTA buttons
* **Sticky CTA Section**: Display the CTA section as a sticky block at the bottom of the page on mobile devices

### Blocks (Table & Grid)

These settings apply to Table and Grid blocks/shortcodes only.

**Key Settings:**

* **Row/Item Background Color**: Background color for table rows and grid items
* **Row/Item Font Color**: Font color for table rows and grid items
* **Button Text**: Text for buttons in table/grid items
* **Listing Tools**: Configure popup text, button labels, and sorting options

### Geo Targeting

Plugin's Geo Targeting settings.

**Key Settings:**

* **Supported Text**: Message when review supports visitor's country
* **Unsupported Text**: Message when review doesn't support visitor's country
* **Bonus Text**: Bonus information for supported countries
* **Affiliate Link/Button Text**: Button text for country support blocks
* **Not Supported Additional Text**: Alternative message for unsupported countries
* **Page Link URL**: Fallback page for unsupported countries
* **Page Link Text**: Link text for fallback pages
* **MaxMind License Key**: License key for geo-location when Cloudflare isn't available

### Color Theme

Changing a color theme will overwrite all your custom styling options.

**Available Themes:**

* **Default**: Original plugin colors
* **Blue**: Blue color scheme
* **Green**: Green color scheme
* **Red**: Red color scheme
* **Yellow**: Yellow color scheme
* **Purple**: Purple color scheme
* **Black**: Black color scheme

---

URL: https://docs.affkraft.com/kemoku/geo-targeting
Markdown: https://docs.affkraft.com/kemoku/geo-targeting.md

# Geo-Targeting

`💁 since version 2.0`

Kemoku includes powerful geo-targeting features that automatically adapt your review content based on your visitors' location. This ensures visitors see relevant operators and get the right affiliate links for their country.

***

## How Geo-Targeting Works

When a visitor lands on your review page, Kemoku automatically detects their country and shows personalized content:

* **Country Support Messages**: Clear indicators showing if the operator accepts players from the visitor's country
* **Smart Affiliate Links**: Automatic routing to the correct affiliate link for the visitor's location
* **Filtered Listings**: Option to hide reviews for operators that don't accept the visitor's country
* **Fallback Pages**: Redirect visitors from unsupported countries to relevant alternatives

***

## Country Detection

Kemoku uses multiple methods to detect visitor locations, with automatic fallbacks for maximum accuracy:

### Cloudflare Integration

If you're using Cloudflare, Kemoku automatically detects visitor countries through Cloudflare's geo headers. This is the fastest and most accurate method.

**No setup required** - it works automatically when Cloudflare is active.

### MaxMind GeoLite2

For sites not using Cloudflare, you can add your free MaxMind license key for professional-grade geo-location.

1. Get a free license key from [MaxMind](https://www.maxmind.com/en/geolite2/signup)
2. Go to **Kemoku Reviews** → **Settings** → **Geo Targeting**
3. Enter your MaxMind license key
4. The plugin will automatically download and update the geo database

### Intelligent Fallbacks

If neither Cloudflare nor MaxMind is available, Kemoku uses a default country (US) that you can customize through the `kemoku_geo_default_country_code` filter:

```php
<?php

add_filter( 'kemoku_geo_default_country_code', function( $default ) {
    return 'gb'; // Return country code
} );
```

***

## Geo-Targeting Settings

Configure geo-targeting options in **Kemoku Reviews** → **Settings** → **Geo Targeting**.

### Country Support Messages

Customize the messages visitors see based on their country support status:

* **Supported Text**: Message when the operator accepts players from the visitor's country (default: `%review% supports players from %country%`)
* **Unsupported Text**: Message when the operator doesn't accept players from the visitor's country (default: `%review% does not support players from %country%`)
* **Bonus Text**: Bonus information shown for supported countries (default: `%bonus%`)
* **Affiliate Link/Button Text**: Text for the affiliate button (default: `Claim Now`)
* **Not Supported Additional Text**: Alternative message for unsupported countries (default: `Check out our other reviews for %country% %link%`)

### Fallback Configuration

Set up fallback pages for visitors from unsupported countries:

* **Page link URL**: Where to redirect visitors when an operator doesn't accept their country
* **Page link text**: Customize the link text (default: your site name)

### MaxMind License Key

Enter your MaxMind license key for geo-location when Cloudflare headers are not available.

***

## Review Page Geo Features

### Country Support in Hero Section

Enable country support messages in your review hero sections:

1. Go to **Kemoku Reviews** → **Settings** → **Hero Section**
2. Set "Include Geo Section" to "Yes"
3. The hero will automatically show country availability with flags and messaging

### Country Support in Info Table

Add country support information to your review info tables:

1. Edit a review page
2. Go to **Review Fields** → **Info Block**
3. In the "Add country support to Info Table" section, enable the field
4. Customize the field name (default: "Support for your country")
5. The info table will include a country support row with availability status

### Country Support Block

Use the dedicated **Review Country Support** block anywhere on your site:

1. Add the "Review Country Support" block to any page
2. The block automatically shows country availability for the current review
3. Perfect for sidebars, comparison pages, or anywhere you want to highlight geo-availability

***

## Listing Geo Features

### Country Filtering

Enable country filtering in your review listings to show only relevant operators:

1. Add a **Reviews Table** or **Reviews Grid** block
2. In the block settings, enable "Filter by visitor's country"
3. Visitors will only see reviews for operators that accept their country

### Country Support Badges

Show country availability status directly in listing items:

1. Add a **Reviews Table** or **Reviews Grid** block
2. In the block settings, enable "Show country support badges"
3. Each listing item will display a country support indicator

***

## Geo-Specific Affiliate Links

Configure different affiliate links for different countries:

### Setting Up Geo Links

1. Edit a review page
2. Go to **Review Fields** → **Geo Targeting**
3. In the **Affiliate Links** section, add country-specific URLs
4. Set a default affiliate link for countries not specifically configured

### How It Works

* Visitors from configured countries get the specific affiliate link
* Visitors from other countries get the default affiliate link
* If no default is set, visitors from unconfigured countries see the fallback page

***

## Customization

### Custom Geo Messages

The geo-targeting messages are configured through the plugin settings and cannot be overridden with filters. You can customize these messages in **Kemoku Reviews** → **Settings** → **Geo Targeting**.

### Custom Country Names

For translating or customizing country names, see the [How To Change/Translate Country Names](https://docs.affkraft.com/kemoku/how-to#how-to-changetranslate-country-names) section.

---

URL: https://docs.affkraft.com/kemoku/deep-linking
Markdown: https://docs.affkraft.com/kemoku/deep-linking.md

# Smart Deep Linking

`💁 since version 2.0`

Kemoku includes smart deep linking functionality that automatically creates links from review page content blocks to associated pages. This feature helps improve your site's internal linking structure and SEO performance.

***

## How Deep Linking Works

When enabled, deep linking automatically converts content items in review page blocks into clickable links that point to relevant pages on your site. For example, if you have a "Bitcoin bookmakers" page, currencies like "Bitcoin" in your review blocks will automatically link to that page.

### Supported Content Blocks

Deep linking works with the following review page blocks:

* **Review Currencies**: Links currency names to currency-specific pages
* **Review Payment Methods**: Links payment method names to payment method-specific pages
* **Review Services**: Links service names to service-specific pages
* **Review Sports**: Links sport names to sport-specific pages
* **Review Countries**: Links country names to country-specific pages
* **Review US States**: Links state names to state-specific pages

***

## Enabling Deep Linking

Deep linking is controlled through WordPress filters. By default, deep linking is disabled for all content blocks. You need to enable it for each content type you want to use.

Here's how to enable deep linking for currencies. Use this code in child theme's `functions.php` file:

```php
<?php

// Enable deep linking for currencies
add_filter( 'kemoku_deep_linking_enabled__currencies', '__return_true' );
```

Just enabling it is not enough, your currency pages have to have a specific URL structure. By default, the plugin expects the currency page URLs should have this structure:

```
https://your-domain.com/currencies/{SLUG}
```

\- where {SLUG} is the currency abbreviation, for example `/currencies/eur` or `/currencies/btc`.

If you use a different structure, you need to let the plugin know about it. Let's say your currency pages use `currency` instead of `currencies`. Here's how to update it:

```php
<?php

add_filter( 'kemoku_deep_linking_slug__currencies', function() {
    return 'currency';
} );
```

You can also remove the "parent" page slug if your currency pages don't have any and your currency page URLs look like `your-domian.com/{SLUG}`:

```php
<?php

add_filter( 'kemoku_deep_linking_slug__currencies', fn() => '');
```

### All deep linking filters

```php
<?php

// Enable deep linking and customize the slug for currencies
add_filter( 'kemoku_deep_linking_enabled__currencies', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__currencies', function() {
    return 'currencies'; // update according to your URL structure
} );

// Enable deep linking for and customize the slug for payment-methods
add_filter( 'kemoku_deep_linking_enabled__payment-methods', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__payment-methods', function() {
    return 'payment-methods'; // update according to your URL structure
} );

// Enable deep linking and customize the slug for services
add_filter( 'kemoku_deep_linking_enabled__services', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__services', function() {
    return 'services'; // update according to your URL structure
} );

// Enable deep linking and customize the slug for sports
add_filter( 'kemoku_deep_linking_enabled__sports', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__sports', function() {
    return 'sports'; // update according to your URL structure
} );

// Enable deep linking and customize the slug for countries
add_filter( 'kemoku_deep_linking_enabled__countries', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__countries', function() {
    return 'countries'; // update according to your URL structure
} );

// Enable deep linking and customize the slug for US States
add_filter( 'kemoku_deep_linking_enabled__us-states', '__return_true' );
add_filter( 'kemoku_deep_linking_slug__us-states', function() {
    return 'us-states'; // update according to your URL structure
} );
```

***

## How It Works

After the optional configuration is done and deep linking is enabled, it all works automatically.

1. **Content Detection**: The plugin detects content items in review page blocks
2. **Slug Generation**: It creates slugs from the content item names, if not given
3. **Page Lookup**: It searches for pages matching the pattern `page-slug/content-slug`
4. **Link Creation**: If a matching page is found, the content item becomes a clickable link
5. **Fallback**: If no matching page is found, the content item remains as plain text

---

URL: https://docs.affkraft.com/kemoku/listing-tools
Markdown: https://docs.affkraft.com/kemoku/listing-tools.md

# Customizing Listing Tools

Kemoku listings have optional filtering and sorting features. You can enable them for each listing block individually. In this document I'll demonstrate how to customize them.

All text strings used in listing tools can be updated in Kemoku Settings → Blocks section.

[Style changes](https://docs.affkraft.com/kemoku/listing-tools#styling) can be added to a child theme's stylesheet or theme's Customizer's Additional CSS section.

Other changes described below can be added to a child theme.

## Sorting

The listings can be sorted by name, rating or date in ascending and descending order. You can change these options with simple functions.

### Changing Sorting Options

You can use a function like this one to modify sorting key labels, this example changes "Recently Added" to "Date".

```php
<?php

function update_listing_sorting_keys( array $defaults ): array {

  $defaults['date'] = __( 'Date', 'kemoku' );

  return $defaults;
}
add_filter( 'kemoku_table_sorting__keys', 'update_listing_sorting_keys' );
```

### Disabling Sorting Options

This function removes the "Recently Added" option:

```php
<?php

function update_listing_sorting_keys( array $defaults ): array {

  unset( $defaults['date'] );

  return $defaults;
}
add_filter( 'kemoku_table_sorting__keys', 'update_listing_sorting_keys' );
```

## Filters

By default there are 6 filter groups: Rating, Features, Services, Licenses, Countries, Payment Methods, Sports. You can disable each one of them or change the group heading. These are the default values:

```php
<?php

array(
    'rating'          => __( 'Rating', 'kemoku' ),
    'features'        => __( 'Features', 'kemoku' ),
    'services'        => __( 'Services', 'kemoku' ),
    'licenses'        => __( 'Licenses', 'kemoku' ),
    'countries'       => __( 'Countries', 'kemoku' ),
    'us_states'       => __( 'US States', 'kemoku' ),
    'payment_methods' => __( 'Payment Methods', 'kemoku' ),
    'sports'          => __( 'Sports', 'kemoku' ),
);
```

### Disabling Filter Groups

To remove any group from filters, use a function like the one below. Change 'us_states' to any other key to remove those.

```php
<?php

function remove_us_states_from_listing_filters( array $defaults ): array {

  unset( $defaults['us_states'] );

  return $defaults;
}
add_filter( 'kemoku_listing_filters__keys', 'remove_us_states_from_listing_filters' );
```

### Changing Filter Headings

To change the group heading, use a function like the one below. This example is for Payment Methods, and you can adjust the values to change any other heading.

```php
<?php

function update_listing_filters_pm_heading( array $defaults ): array {

  $defaults['payment_methods'] = 'Deposit Methods';

  return $defaults;
}
add_filter( 'kemoku_listing_filters__keys', 'update_listing_filters_pm_heading' );
```

### Changing Rating Filters

By default there are 5 rating options: 6+, 7+, 8+, 9+ and 10. You can use a function like the example below to modify the rating options. This one removes "6+" option.

```php
<?php

function update_listing_filters_ratings( array $defaults ): array {

  unset( $defaults[6] );

  return $defaults;
}
add_filter( 'kemoku_listing_filters__values__rating', 'update_listing_filters_ratings' );
```

### Changing Feature Filters

By default there are 5 feature options: 'New', 'Popular', 'Fast Payouts', 'Mobile Friendly' and 'Good Reputation'. You can use a function like the example below to modify the feature options. This one removes the "Good Reputation" option and renames "Mobile Friendly" to "Mobile Apps".

```php
<?php

function update_listing_filters_features( array $defaults ): array {

  unset( $defaults['feature_5'] );

  return $defaults;
}
add_filter( 'kemoku_listing_filters__values__features', 'update_listing_filters_features' );
```

This function changes "Mobile Friendly" to "Mobile Apps":

```php
<?php

function update_listing_filters_features( array $defaults ): array {

  $defaults['feature_4'] = __( 'Mobile Apps', 'kemoku' );

  return $defaults;
}
add_filter( 'kemoku_listing_filters__values__features', 'update_listing_filters_features' );
```

If you need multiple changes, you can add them all into a single function. For example, remove "Fast Payouts" and translate into Spanish.

```php
<?php

function update_listing_filters_features( array $defaults ): array {

  return array(
			'feature_1' => __( 'Nuevo', 'kemoku' ),
			'feature_2' => __( 'Popular', 'kemoku' ),
			'feature_4' => __( 'Apto para móviles', 'kemoku' ),
			'feature_5' => __( 'Buena reputación', 'kemoku' ),
  );
}
add_filter( 'kemoku_listing_filters__values__features', 'update_listing_filters_features' );
```

### Changing Service Filters

By default there are 8 services and here are their default values:

```php
<?php

array(
    'sportsbook'     => __( 'Sportsbook', 'kemoku' ),
    'casino'         => __( 'Casino', 'kemoku' ),
    'live_casino'    => __( 'Live Casino', 'kemoku' ),
    'poker'          => __( 'Poker', 'kemoku' ),
    'bingo'          => __( 'Bingo', 'kemoku' ),
    'lottery'        => __( 'Lottery', 'kemoku' ),
    'horse_racing'   => __( 'Horse Racing', 'kemoku' ),
    'fantasy_sports' => __( 'Fantasy Sports', 'kemoku' ),
);
```

You can use a function like the example below to modify the service options. This one removes "Bingo" and "Lottery" options and renames "Fantasy Sports" to "Daily Fantasy Sports".

```php
<?php

function update_listing_filters_services( array $defaults ): array {

    unset( $defaults['bingo'] );
    unset( $defaults['lottery'] );

    $defaults['fantasy_sports'] = __( 'Daily Fantasy Sports', 'kemoku' );

    return $defaults;
}
add_filter( 'kemoku_listing_filters__values__services', 'update_listing_filters_services' );
```

### Geo Filtering

`💁 since version 2.0`

Kemoku includes geo-filtering capabilities that automatically filter listings based on visitor location. This feature works with the plugin's geo-targeting system to show only relevant reviews for each visitor's country.

For detailed information about geo-targeting features, see the [Geo-Targeting](https://docs.affkraft.com/kemoku/geo-targeting) documentation.

### Changing Country, State, License, Payment Method and Currency Filters

Country, State, Payment Method, Currency and License values on filters are generated from the fields you fill in when editing review pages. There will be only values that you already selected. However, if for some reason you need to modify them, you can use the below filters:

```php
<?php

kemoku_listing_filters__values__licenses
kemoku_listing_filters__values__countries
kemoku_listing_filters__values__us_states
kemoku_listing_filters__values__payment_methods
kemoku_listing_filters__values__currencies
```

### Styling

Copy the values you want to change to a custom stylesheet or Additional CSS section and adjust them.

```css
.sb-listing-popup {
  /* This is the semi-transparent background color outside the popup window. */
  --listing_tools_popup_outer_color: rgba(2, 15, 44, 0.76);
  /* This is the popup background color. */
  --listing_tools_popup_bg_color: #fff;
  /* This is the popup font color. */
  --listing_tools_popup_font_color: #8d99a2;
  /* This is the popup maximum width. */
  --listing_tools_popup_max_width: 440px;
  /* This is the popup maximum height. */
  --listing_tools_popup_max_height: 90vh;
  /* This is the popup border radius. */
  --listing_tools_popup_border_radius: 4px;
  /* This is the popup headings background color. */
  --listing_tools_headings_bg_color: var(--section_bg_color);
  /* This is the popup headings border radius. */
  --listing_tools_headings_border_radius: var(--listing_tools_popup_border_radius);
  /* This is the popup button font color. */
  --listing_tools_button_font_color: #565f66;
  /* This is the popup button background color. */
  --listing_tools_button_bg_color: var(--section_bg_color);
  /* This is the popup button border color. */
  --listing_tools_button_border_color: #d5dde3;
  /* This is the popup button border radius. */
  --listing_tools_button_border_radius: 4px;
  /* This is the popup selected options highlight color. */
  --listing_tools_filter_sort_selected_color: var(--button_bg_color, green);
  /* This is the popup footer buttons' background color. */
  --listing_tools_footer_button_bg_color: #d5dde3;
  /* This is the popup footer buttons' font color. */
  --listing_tools_footer_button_font_color: inherit;
}
```

---

URL: https://docs.affkraft.com/kemoku/integrations
Markdown: https://docs.affkraft.com/kemoku/integrations.md

# Integrations

Kemoku can be extended with third-party services to automate your workflow and manage data more efficiently.

Want to manage your reviews from Claude or ChatGPT? See [AI](https://docs.affkraft.com/kemoku/ai).

## tablrr - Automated Data Management

Connect your Kemoku-powered sites to [tablrr.app](https://tablrr.app?utm_source=affkraft\&utm_medium=docs\&utm_term=kemoku) to manage your operator data, bonus details, and affiliate links from a single dashboard.

* **Automatic Sync**: Update data in one place and see changes across all your sites.
* **Centralized Control**: Manage multiple Kemoku installations without logging into each WordPress admin.

Tutorial: [Learn how to set up the Kemoku-tablrr integration](https://affkraft.com/blog/how-to-sync-kemoku-review-fields-across-multiple-websites-using-tablrr).

---

URL: https://docs.affkraft.com/kemoku/how-to
Markdown: https://docs.affkraft.com/kemoku/how-to.md

# How To ...

### How To Change Listing Filters and Sorting

Check out [this guide](https://docs.affkraft.com/kemoku/listing-tools) for complete list of options about how to change the filters and sorting on listings.

***

### How To Change/Translate Country Names

Use the below code snippet in your child theme's `functions.php` file and adjust the array of country names. You can add as many countries as you want.

> Please make sure to use [ISO 3166 country codes](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) in array keys (us, gb, fr, etc.).

```php
<?php

add_filter( 'kemoku_country_custom_names', fn( array $names ) => array(
    'us' => 'Estados Unidos',
    'gb' => 'Reino Unido',
    'fr' => 'Francia',
) );
```

***

### How To Change/Translate Currency Names And Symbols

Use the below code snippet in your child theme's `functions.php` file and adjust the array of currency names and symbols. You can add as many currencies as you want.

> Please make sure to use [ISO 4217 country codes](https://en.wikipedia.org/wiki/ISO_4217) in array keys (usd, eur, etc.).

```php
<?php

add_filter( 'kemoku_currency_custom_data', fn( array $data ) => array(
    'usd' => array(
        'name' => 'USD',
        'symbol' => '$',
    ),
    'eur' => array(
        'name' => 'EUR',
        'symbol' => '€',
    ),
) );
```

> Please make sure arrays for each currency have both `name` and `symbol` keys and values, even though you don't change one of them. In the example above, I don't change the symbols `$, €`, but I need to pass them anyway.

***

### How To Change/Translate Services

To change or translate the service names you can use the following filter - `kemoku_sportsbook_services` in your child theme's `functions.php` file. The below example renames "Sportsbook" to "Bookmaker".

```php
<?php

add_filter( 'kemoku_sportsbook_services', function( array $defaults ) {

    $defaults['sportsbook'] = 'Bookmaker';

    return $defaults;
} );
```

Find below the default names of services.

```php
<?php

[
    'sportsbook'         => __('Sportsbook', 'kemoku'),
    'casino'             => __('Casino', 'kemoku'),
    'live_casino'        => __('Live Casino', 'kemoku'),
    'poker'              => __('Poker', 'kemoku'),
    'bingo'              => __('Bingo', 'kemoku'),
    'lottery'            => __('Lottery', 'kemoku'),
    'horse_racing'       => __('Horse Racing', 'kemoku'),
    'fantasy_sports'     => __('Fantasy Sports', 'kemoku'),
    'sweepstakes'        => __('Sweepstakes', 'kemoku'),
    'exchange_betting'   => __('Exchange Betting', 'kemoku'),
    'prediction_markets' => __('Prediction Markets', 'kemoku'),
]
```

***

### How To Change/Translate Sports

To change or translate the sport names you can use the following filter - `kemoku_sportsbook_sports` in your child theme's `functions.php` file. The below example renames "American Football" to "Football" and "Football" to "Soccer".

```php
<?php

add_filter( 'kemoku_sportsbook_sports', function( array $defaults ) {

    $defaults['football'] = 'Football';
    $defaults['soccer'] = 'Soccer';

    return $defaults;
} );
```

Find below the default sport names used in the plugin:

```php
<?php

[
    'baseball'     => __('Baseball', 'kemoku'),
    'basketball'   => __('Basketball', 'kemoku'),
    'boxing'       => __('Boxing', 'kemoku'),
    'cricket'      => __('Cricket', 'kemoku'),
    'cycling'      => __('Cycling', 'kemoku'),
    'esports'      => __('Esports', 'kemoku'),
    'football'     => __('Football', 'kemoku'),
    'golf'         => __('Golf', 'kemoku'),
    'hockey'       => __('Hockey', 'kemoku'),
    'horse-racing' => __('Horse Racing', 'kemoku'),
    'martial-arts' => __('Martial Arts', 'kemoku'),
    'racing'       => __('Racing', 'kemoku'),
    'soccer'       => __('Soccer', 'kemoku'),
    'tennis'       => __('Tennis', 'kemoku'),
    'volleyball'   => __('Volleyball', 'kemoku'),
]

```

***

***

### How To Change/Translate Features

Use the below code snippet in your child theme's `functions.php` file and adjust the review features values. These values are set when editing a review page on Review Fields -> Details section, and they're used in filtering the listings.

```php
<?php

add_filter( 'kemoku_sportsbook_features', function( array $defaults ) {

    $defaults['feature_1'] = 'Nuevo';
    $defaults['feature_5'] = 'Buena reputación';

    return $defaults;
} );
```

### How To Change SVG Icons

Kemoku uses SVG icons for various content types like payment methods, sports, and countries. You can customize these icons by providing your own SVG files.

**General Approach:**
Use the appropriate filter to specify a custom directory containing your SVG icons. The plugin will look for SVG files matching the content keys/slugs (e.g., `visa.svg`, `football.svg`, `us.svg`).

#### Payment Method Icons

Use the `kemoku_payment_icons_dir` filter to specify a custom directory for payment method icons.

```php
<?php

add_filter( 'kemoku_payment_icons_dir', function() {
    return get_stylesheet_directory() . '/icons/payment-methods/';
} );
```

**Icon File Names:**
Your SVG files should match the payment method keys: `visa.svg`, `mastercard.svg`, `paypal.svg`, etc.

#### Sports Icons

Use the `kemoku_sport_icons_dir` filter to specify a custom directory for sports icons.

```php
<?php

add_filter( 'kemoku_sport_icons_dir', function() {
    return get_stylesheet_directory() . '/icons/sports/';
} );
```

**Icon File Names:**
Your SVG files should match the sport keys: `football.svg`, `soccer.svg`, `basketball.svg`, etc.

#### Country Icons

Use the `kemoku_country_icons_dir` filter to specify a custom directory for country icons.

```php
<?php

add_filter( 'kemoku_country_icons_dir', function() {
    return get_stylesheet_directory() . '/icons/countries/';
} );
```

**Icon File Names:**
Your SVG files should match the country codes: `us.svg`, `gb.svg`, `de.svg`, `fr.svg`, `es.svg`, etc. Use [ISO 3166 country codes](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).

**Directory Structure with Example Icon Names:**

```
your-child-theme/
├── icons/
│   ├── payment-methods/
│   │   ├── visa.svg
│   │   ├── mastercard.svg
│   │   └── paypal.svg
│   ├── sports/
│   │   ├── football.svg
│   │   ├── soccer.svg
│   │   └── basketball.svg
│   └── countries/
│       ├── us.svg
│       ├── gb.svg
│       └── de.svg
```

***

### How To Customize "Table: Payments" Block Design

You have total control over the block's design, all you need to do is adjust some CSS properties and values. Here's a screenshot for easy reference:

#### Colors

Let's start with colors. To adjust them, simply use the below snippet in your Additional CSS section and change the color values to your liking. The snippet below contains the default values.

```css
.sb-table-payments .sb-item {
  /* the light gray backgrounds such as bonus code section, */
  /* payout speed and payment methods sections */
  --color-light-gray: #f1f5f9;
  /* the gray border color of the sections */
  --color-dark-gray: #cbd5e1;
  /* the bonus code icon color when there's no code */
  --color-darker-gray: #64748b;
  /* the logo background color */
  --color-logo-bg: #082f49;
  /* bonus text color */
  --color-highlight-1: var(--button_bg_color);
  /* the item name and section headings text color */
  /* also the bonus code icon color when it's available */
  --color-highlight-2: #075985;
}
```

You don't have to copy all the values, just the ones you want to change.
For example, if you want to change the logo background color to red, use this snippet:

```css
.sb-table-payments .sb-item {
  --color-logo-bg: red;
}
```

Other than the above mentioned colors, there are some colors that inherit their values from other elements or they simply don't have any value.
The main button color can be controlled from Kemoku plugin settings page, and the review page link color is inherited from your theme's link color.

To change the row text and background color use:

```css
.sb-table-payments .sb-item {
  color: #f1faf9;
  background-color: #075985;
}
```

#### Column widths

This table is mostly intended to be used on wider pages as it has many columns. As different themes have different content area widths, the plugin columns may need to be adjusted. And it's as easy as it gets, simply set some values and you're done. The names are self-explanatory.

```css
.sb-table-payments .sb-item {
  --column-width-logo: 160px;
  --column-width-rating--base-5: 170px;
  --column-width-rating--base-10: 220px;
  --column-width-payments: 260px;
  --column-width-buttons: 180px;
}
```

As you can see there are 2 properties for the rating column. That's because you may be using 5 or 10 star based rating (Kemoku Settings -> General -> Rating Stars Number). Update the value for whatever option you're using.

Also you may have noticed that there's no property for the bonus section, that's because it takes all the remaining space, no need to set a fixed width for it.

#### Other styles

You can customize the rounded border size by adjusting the `--radius` property value.
`--shadow` property is for the box shadow of the table row, and `--shadow-hover` takes effect when you hover over a row.

```css
--radius: 6px;
--shadow: 0 0 5px rgba(7, 89, 133, 0.35);
--shadow-hover: 0 1px 12px rgba(7, 89, 133, 0.3);
```

To change the gift-box icon background of the bonus section use:

```css
.sb-table-payments .sb-item .sb-item--bonus {
  /* this will remove the background */
  background-image: none;
  /* this will set your own background image */
  background-image: url('IMAGE URL OR BASE 64 ENCODED SVG');
  /* this will set a background color, adjust the value to your liking */
  background-color: #075985;
}
```

To remove or change the dollar-sign icon of the payout speed section use:

```css
.sb-table-payments .sb-item .sb-item--payouts {
  /* this will remove the background */
  background-image: none;
  /* this will set your own background image */
  background-image: url('IMAGE URL OR BASE 64 ENCODED SVG');
}
```

### How To Customize "Grid: Bonus" Block Design

You have total control over the block's design, all you need to do is adjust some CSS properties and values. Here's a screenshot for easy reference:

To adjust any value, simply use the below snippet in your Additional CSS section and change the values to your liking. The snippet below contains the default values.
You can copy just the properties that you want to change, no need to copy them all.

```css
.sb-grid-bonus {
  /* this will change the grid item background color */
  --item-bg-color: #fff;

  /* this will change the grid item text color */
  --item-fg-color: #333;

  /* this will change the grid item border color */
  --item-border-color: #d8dfe8;

  /* this will change the bonus section background color */
  --bonus-bg-color: #124588;

  /* this will change the bonus section text color */
  --bonus-fg-color: #f1f1f1;

  /* this will change the bonus section font size */
  --bonus-font-size: 1.6em;

  /* this will change the bonus section font weight */
  --bonus-font-weight: 400;
}
```

Other styling options such as rounded borders, button background color, etc. are defined in [plugin settings](https://docs.affkraft.com/kemoku/settings).

***

### How To Customize Hero Section

The Hero block has several filters that allow you to customize different sections of the block. Each filter receives the default HTML content of the corresponding section and allows you to modify or replace it entirely.

#### Available Hero Filters

**Image Section:**

```php
<?php

add_filter( 'kemoku_review_hero_image', function( $content ) {
    // Modify or replace the hero image HTML
    return $content;
} );
```

**Rating Section:**

```php
<?php

add_filter( 'kemoku_review_hero_rating', function( $content ) {
    // Modify or replace the rating stars HTML
    return $content;
} );
```

**Geo Section:**

```php
<?php

add_filter( 'kemoku_review_hero_geo', function( $content ) {
    // Modify or replace the geo-targeting message HTML
    return $content;
} );
```

**Bonus Section:**

```php
<?php

add_filter( 'kemoku_review_hero_bonus', function( $content ) {
    // Modify or replace the bonus text HTML
    return $content;
} );
```

**Button Section:**

```php
<?php

add_filter( 'kemoku_review_hero_button', function( $content ) {
    // Modify or replace the affiliate button HTML
    return $content;
} );
```

**Terms Section:**

```php
<?php

add_filter( 'kemoku_review_hero_terms', function( $content ) {
    // Modify or replace the terms and conditions HTML
    return $content;
} );
```

**Example: Customize Hero Button**

```php
<?php

add_filter( 'kemoku_review_hero_button', function( $content ) {
    // Replace the default button with a custom one
    return '<a href="#" class="custom-hero-button">Get Started Today</a>';
} );
```

---

URL: https://docs.affkraft.com/kemoku/plugin-updates
Markdown: https://docs.affkraft.com/kemoku/plugin-updates.md

# Kemoku Plugin Updates

Kemoku updates are baked into the plugin, meaning you will receive them in your WordPress dashboard as soon as they are available and you don't have to do anything more than just clicking the update button, no need to download the plugin and upload through FTP again.

However, if for some reason you want to do that, you still can just download the plugin files from your account, remove the old plugin directory and upload the new one to your server.