# Akurai: full documentation > A versatile WordPress theme for creating and managing awesome sports betting affiliate websites. ============================================================ Akurai ============================================================ --- URL: https://docs.affkraft.com/akurai Markdown: https://docs.affkraft.com/akurai.md # Akurai Theme Akurai is a versatile WordPress theme for creating and managing awesome sports betting affiliate websites. It's unique and modern, making your website stand out among others. *** ## Getting Started It's easy to get started with Akurai. Follow the documentations to install the theme and create compelling websites. ### Requirements Before getting started make sure you have all the requirements met. To use the theme, 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 2MB. ### Changelog Find the full changelog [here](https://affkraft.com/changelog?product=akurai). --- URL: https://docs.affkraft.com/akurai/installation Markdown: https://docs.affkraft.com/akurai/installation.md # Theme Installation You can install the theme either through WordPress dashboard (recommended) or via FTP. *** ## Before Installation Please make sure your server meets the minimum system requirements and download the theme file from your [AffKraft account](https://affkraft.com/login). ### Install through WordPress Dashboard 1. Visit WordPress dashboard → Themes and click `Add New` and `Upload Theme` after that 2. Click `Choose File`, select the theme file `akurai.zip` and click `Install Now` 3. Activate the theme ### Install via FTP 1. Log in to your server with your FTP credentials, using an FTP client, cPanel or similar 2. Navigate to `themes` directory from your WordPress website root 3. Upload the theme file `akurai.zip` to `themes` directory 4. Unzip the archive, you'll have a directory `akurai` in themes 5. Remove the `akurai.zip` file 6. Visit WordPress dashboard → Themes and activate the theme --- URL: https://docs.affkraft.com/akurai/registration Markdown: https://docs.affkraft.com/akurai/registration.md # Theme Registration You need to register your theme to be able to receive new security and feature updates. *** ## Product Key You can get your product key from your [AffKraft account](https://affkraft.com/login) ### Add Product Key 1. In WordPress dashboard visit **Akurai** → **Setup** 2. Enter the product code you got from your account 3. Click `Submit` 4. A message confirming the theme registration will appear If you get an error that the license key is not correct and the registration fails: * make sure there are no white spaces in the beginning or at the end of the key * if you have firewall installed on your server, make sure requests to `api.affkraft.com` are not being blocked --- URL: https://docs.affkraft.com/akurai/setting-review-page-slug Markdown: https://docs.affkraft.com/akurai/setting-review-page-slug.md # Review Page Slug You can set the review page slug to whatever string you need if you're not happy with its default value of `review`. *** ### Set Review Page Slug 1. In WordPress dashboard visit **Akurai** → **Setup** 2. Enter the slug you want 3. Click `Save` 4. A message confirming the change will appear --- URL: https://docs.affkraft.com/akurai/creating-review-pages Markdown: https://docs.affkraft.com/akurai/creating-review-pages.md # Creating Review Pages In your WordPress dashboard you will find a new menu item called **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. These properties are used all over the website, please make sure to fill them in. ### Main Fields In this section you'll define the main fields for any review such as: * Name * Images/Logos * Affiliate Link URL * Review Page Hero Colors The name, image and affiliate URL are used in all shortcodes, blocks, widgets and review page and hero colors are there to help you customize each review page. ### Bonus Fields Bonus fields are for defining sportsbook bonuses. You can define an optional **Shortcode Bonus** if you want to display a different or differently formatted bonus in shortcodes. ### Ratings Fields First you define the main sportsbook rating which is used all over the website n shortcodes, widgets, etc. The second part for **Ratings** is where you define different ratings to display in review pages **Ratings** block/shortcode. ### Terms Fields You can define 2 fields for sportsbook terms and conditions, first the longer and 2nd the shorter version. later in blocks/shortcodes you can choose to display one of them. ### Info Fields Define basic information about the sportsbook and display them in `Info` block (or `[info]` shortcode) in review pages. ### Pros & Cons Fields Define pros and cons of the sportsbook and display them in `Pros & Cons` block (or `[pros_cons]` shortcode) in review pages. ### Banking Fields Define deposit and withdrawal methods provided by the sportsbook and display them in `Banking` block (or `[banking]` shortcode) in review pages. ### Offer Fields Define the main offers of the sportsbook such as sportsbook, casino, poker, etc. and their bonuses and display them in `Offer` block (or `[offer]` shortcode) in review pages. ### Related Reviews You can choose to display related reviews section at the end of each review page. For that you need to select at least 1 (max 3) other review pages. ### Supported Countries Define the supported countries of the sportsbook and display them in `Countries` block (or `[countries]` shortcode) in review pages. ### Additional Info Define some additional info fields here that are used on table/grid filters mostly. ### Linked Bonuses Enable **Show Linked Bonuses** to display a "Similar Bonuses"-style section of bonus pages on this review page. Manually pin specific bonus pages, or leave the field empty to automatically show up to 6 published [bonus pages](https://docs.affkraft.com/akurai/bonuses) linked to this review. You can also set a custom section heading, otherwise it defaults to `REVIEW_NAME Bonuses`. ### Geo Affiliate Links `💁 since version 4.6.0` In its own tab inside the **Review Fields** box, you can set up country-specific affiliate links which replace your default affiliate link all over the website, when a link for the visitor's country is available. Leave any of them empty to use the default affiliate link instead. One field is available per target country — configure your target countries first in [Geo Targeting settings](https://docs.affkraft.com/akurai/geo-targeting#settings). ### Review Snippet For all your review pages Akurai generates **Review Snippet Structured data** (schema.org) markup. The rating value used is the "Overall Rating" field from [Rating Fields](https://docs.affkraft.com/akurai/creating-review-pages#ratings-fields) section. It is generated automatically so you don't need to do anything, however you can turn it off if you decide so. You can test your pages [here](https://search.google.com/structured-data/testing-tool). --- URL: https://docs.affkraft.com/akurai/bonuses Markdown: https://docs.affkraft.com/akurai/bonuses.md # Creating Bonus Pages In your WordPress dashboard you will find a new menu item called **Bonuses** right below the **Reviews** menu link. Click `Add New` to add a new bonus. *** ## Bonus Fields Besides adding your bonus title and content as usual, you'll find a **Bonus Fields** section below the page content. Here you can define properties for each bonus. These properties are used on the bonus page and in related bonus cards. ### Linked Review Select the review this bonus belongs to. The linked review's affiliate link and logo will be used on the bonus page if no bonus-specific affiliate link is set. ### Affiliate Link An optional direct affiliate URL for this bonus. Leave empty to fall back to the linked review's affiliate link. ### Bonus Type Select one of the available bonus types: * **Welcome Bonus** — a first-deposit offer for new players * **No Deposit Bonus** — a bonus that requires no deposit to claim * **Free Spins** — free spins on selected slots (or a free bet equivalent for sportsbooks) * **Reload Bonus** — a recurring deposit bonus for existing players * **Cashback** — a percentage of losses returned to the player * **Enhanced Odds** — a price boost on selected markets * **Other** — any other promotion type ### Bonus Value A short string describing the offer value, for example `100% up to €500` or `Bet €10 Get €30`. This is displayed as the main headline in the bonus page hero. ### Bonus Code The promo code required to claim the bonus, if any. Leave empty if no code is needed — the hero will show a "No Code" label instead (configurable in the Customizer). ### Full Terms & Conditions The complete terms and conditions for this bonus, displayed below the hero section. ### Short Terms A brief one-line summary of the most important terms, shown below the CTA button in the in related bonus cards. ### Minimum Deposit The minimum deposit required to trigger the bonus, for example `€10` or `None`. ### Wagering Requirement The playthrough requirement before winnings can be withdrawn, for example `35x` or `1x turnover at min. odds 1.50`. ### Max Bet The maximum allowed bet per round or spin while the bonus is active, for example `€5`. ### Hero Background Color & Hero Text Color Choose custom colors for the bonus page hero section. These let you match each bonus card to its associated brand. Defaults to `#222222` background and `#ffffff` text if left empty. ### Related Bonuses You can link up to 3 other bonus pages to display in the **Similar Bonuses** section at the bottom of the bonus page. Select them using the **Related Bonus #1**, **#2**, and **#3** fields. *** ## Bonus Page Each bonus has its own public page at `/bonus/bonus-slug`. The page consists of: * **Hero section** — displays the bonus value, promo code with a copy button, CTA button, short terms, and the linked review's logo. * **Content area** — the post content you write in the editor. * **Similar Bonuses section** — a grid of the related bonuses you linked, if any are set. *** ## Customizer Options Bonus page text strings are configurable under **Appearance** → **Customize** → **Bonus Options**: * **Bonus button text** — the CTA button label. Default: `Claim bonus`. Use `%s` to insert the linked review's name. * **Bonus page link text** — the "read review" link label shown in related bonus cards. Default: `Read review`. * **Text before review logo** — the label shown before the operator logo in the hero and related cards. Default: `From`. * **Text instead of bonus code** — shown when no promo code is set. Default: `No Code`. * **Bonus page related bonuses section heading** — the heading above the Similar Bonuses grid. Default: `Similar Bonuses`. --- URL: https://docs.affkraft.com/akurai/review-page-templates Markdown: https://docs.affkraft.com/akurai/review-page-templates.md # Review Page Templates You can define different templates for review pages in Akurai. *** ## Using Review Page Templates There are 3 page templates available for displaying **Review Pages** in your website. 1. Default Template 2. Review with Sidebar 3. Banner Template ### Default Template The default template layout has 100% wide content area, no sidebars, no widgets. You can display a [hero section](https://docs.affkraft.com/akurai/review-page-templates#review-page-hero) on top reviews with default template. ### Review with Sidebar This is just like the default template, however it has a sidebar on the right, where you can add review page and general widgets. You can display a [hero section](https://docs.affkraft.com/akurai/review-page-templates#review-page-hero) on top reviews with default template. ### Banner Template Review pages with the banner template have a nice section on top of the page to display important review information such as the logo, bonus, country support, payment methods, etc. You can change its background color for each review to make them unique. ### Review Page Hero Default review pages have a hero section at the top to display information about the sportsbook such as the logo, ratings, bonus, etc. You can customize the hero to display in 1 or 2 columns. Also you can choose to display the page heading (`h1` tag) below or above the hero. You can make this changes in [Customizer → Review Options](https://docs.affkraft.com/akurai/customizations#review-options). --- URL: https://docs.affkraft.com/akurai/review-page-blocks Markdown: https://docs.affkraft.com/akurai/review-page-blocks.md # Review Page Blocks Akurai theme comes with built-in review page blocks (and shortcodes) that you can use to easily present sportsbook information. *** ## Using Blocks & Shortcodes General and some specific blocks are available on Akurai review pages. Check them out below. ### Blocks There are 7 review blocks available for you to use in review pages: * Info Table * Pros & Cons * Ratings * Banking * Offers * Bonus List * Countries 5 blocks, except Bonus List and Countries, require no configuration, all you need is to just add them to the content by clicking on the block name. The information is populated from [Review Fields](https://docs.affkraft.com/akurai/creating-review-pages) that you need to have filled in beforehand. ### Shortcodes The same blocks are also available via shortcodes, and you can also use them in [Review Page Sidebars](https://docs.affkraft.com/akurai/widget-areas). Here are the formats: * `[info]` * `[pros_cons]` * `[ratings]` * `[banking]` * `[offers]` * `[bonus_list]` - At least 2 bonuses must be specified. ``` [bonus_list bonus_1="1st BONUS" bonus_2="2nd BONUS" bonus_3="" bonus_4="" bonus_5=""] ``` * `[countries]` - You can skip the options and display the default block. ``` [countries show_search="1" main_text="..." not_supported_text="..."] ``` ### Screenshots --- URL: https://docs.affkraft.com/akurai/geo-targeting Markdown: https://docs.affkraft.com/akurai/geo-targeting.md # Geo Targeting Akurai comes with built-in geo targeting, so you can tailor content, listings and messages to visitors based on their country — no separate plugin required. `💁 since version 4.6.0` Geo Targeting used to be a separate AkuraiGeo add-on plugin. It's now built directly into the theme. If you had the AkuraiGeo plugin active, it's automatically deactivated for you and all your existing Geo settings and content carry over unchanged. *** ## Settings To adjust Geo Targeting settings visit **Akurai → Setup** in your WordPress Dashboard, and scroll to the **Geo Targeting** section. ### Target Countries Select your target countries in advance, and all your Geo blocks and other geo options will be based on those countries. Use the search box to quickly find a country in the list. Do not select all countries, just the ones for which you have specific offers — a "Default" option in Geo blocks covers visitors from countries not selected here. ### Default Support Messages Set the default "Country supported" and "Country not supported" texts used by the Review Geo Message block. You can use `%country` and `%review` placeholders, which are replaced with the actual country and review names. Each Review Geo Message block can override these defaults individually. *** ## Using Geo Targeting Once your target countries are set, you can use them in: * **Geo blocks** — the Geo Listing, Geo Content and Review Geo Message blocks, documented in [Blocks & Shortcodes](https://docs.affkraft.com/akurai/blocks-shortcodes#geo-listing-block). * **Geo Affiliate Links** — a per-country affiliate link field on review pages, documented in [Creating Review Pages](https://docs.affkraft.com/akurai/creating-review-pages#geo-affiliate-links). *** ## Country Detection By default, Geo Targeting requires your website traffic to be routed through **Cloudflare**, since it reads the visitor's country from a request header Cloudflare provides. ### Cloudflare Setup To make sure the necessary information is provided, visit your Cloudflare dashboard, select your website, select **Network** on the left sidebar, scroll down to **IP Geolocation** and toggle it on. Cloudflare provides a lot of products and solutions to build cloud infrastructure, applications and websites — DNS management, a global CDN, SSL certificates and more. Check out for details. > Geo Targeting uses the country code of your website's visitor's IP address directly. It doesn't use the IP address itself, doesn't fetch it from anywhere, and therefore can't store it anywhere. ### Custom Detection (Without Cloudflare) If your website isn't behind Cloudflare, you can provide a custom solution instead. You can either provide a **custom HTTP header** or a completely **custom geo-location detection algorithm**. In both cases the returned value should be an [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) two-letter country code. #### Custom Header If your server provides the country code through a differently named HTTP header, use the `akurai_geo_header_name` filter in your [child theme](https://docs.affkraft.com/akurai/child-theme). For example, if your custom header is called `HTTP-Country-Code`: ```php 'HTTP-Country-Code'); ``` #### Custom Detection Script If a custom header isn't available and you want to use your own country detection script, use the `akurai_geo_country_code` filter instead: ```php getCountryCode(); // and in the end, // you return an ISO 3166-1 alpha-2 two-letter country code return $countryCode; }); ``` > In both cases, the returned value must be an `ISO 3166-1 alpha-2` two-letter country code. --- URL: https://docs.affkraft.com/akurai/page-templates Markdown: https://docs.affkraft.com/akurai/page-templates.md # Page Templates You can define different templates for your pages in Akurai. *** ## Using Page Templates There are 6 page templates available for displaying **Pages** in your website. 1. Default Template 2. Left Sidebar Template 3. Right Sidebar Template 4. Hero Template 5. Hero Full Screen Template 6. Banner Template ### Default Template **Default** template layout has only content area covering its 100% width. There's no sidebar used. ### Left Sidebar Template **Left Sidebar** template layout has the content area on the right and the sidebar on the left. The sidebar used in Left Sidebar templates is called **Left Sidebar**. ### Right Sidebar Template **Right Sidebar Template** template layout has the content area on the left and the sidebar on the right. The sidebar used in default templates is called **Main Sidebar**. ### Page with Top Listing For general templates (Default, Left and Right Sidebar) you can add a top listing at the top of the pages. The listing has the main table design of the theme and occupies a full content width regardless whether there's a sidebar or not. ### Hero Template **Hero** template uses the same layout as the default template, however it adds nice hero section on top of the page. In each hero template there are 3 areas: top and main. The top area can have a heading, some text content, as well as a link/button. Top area is optional. The main area can be either "3 Reviews Block" or "2 Columns Block". If you choose the "3 Reviews Block", you need to select reviews and they will be displayed in a grid layout. If you choose the "2 Columns Block", you'll have 2 blocks (left and right) to fill in with information. Each one of them can have either a review, a text content, a collection of links/buttons or an image. Each section can also have an optional heading. With all these options you can have very many different page layouts, and obviously you can adjust the hero styles, e.g. background image, colors, sizes, spacing, etc. ### Hero Full Screen Template **Hero Full Screen** template uses the same layout as the default template, however it adds nice hero section on top of the page that covers the whole screen. Each full screen hero template consists of 2 sections: top and bottom. Top section can have a heading and some text content, as well as a link/button. Only text content is required. The bottom section can be either "4 Columns of Review Boxes" or "4 Columns of Custom Content". For review boxes you just select 4 reviews and they will be displayed nicely in a grid layout. For custom content, for each box you can add an image, a heading, text content and a URL, heading and URL fields are optional. You can adjust the hero styles, e.g. background image, colors, sizes, spacing, etc. ### Banner Template **Banner Template** again uses the default page layout and adds a nice banner-like section on top. The section is divided into 3 areas: left, right and bottom. The left area has an image background with a heading, text content and a link/button, the right area is a collection of reviews and the bottom area is some text content. You can adjust the styles for the whole section choosing all its colors and sizes. --- URL: https://docs.affkraft.com/akurai/blocks-shortcodes Markdown: https://docs.affkraft.com/akurai/blocks-shortcodes.md # Akurai Theme Blocks & Shortcodes 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. *** ## Using Blocks and Shortcodes Here are the blocks available in Akurai theme: 1. Reviews Table 2. Reviews Table Extended 3. Reviews Table Flex 4. Reviews Grid 5. Reviews List 6. Review Offer (Featured Review) 7. Review Finder 8. Comparison Table 9. Recent Posts 10. Links Group 11. FAQ 12. Lazy Image 13. Geo Listing 14. Geo Content 15. Review Geo Message ### Reviews Table Block To add a new table simply click on the **+** (Add block) sign and select **Reviews Table** in **Akurai Blocks** section. In the content editor a new table edit section will appear. There are 2 options to add reviews to the table: 1. Manual selection where you select all the reviews from a dropdown list. 2. Filtering by taxonomy where you choose a category and/or tag(s) and reviews display automatically (`💁 since version 2.4.0`). For example, you can select a review category and all reviews in that category will be displayed. You can also set a limit, for example, display just 8 reviews in "Sports" category. Below reviews select how to display the **terms and conditions**. `💁 since version 2.3.0` You can add **filters** to tables, learn how to modify filters [here](https://docs.affkraft.com/akurai/how-to#how-to-modify-reviews-filters). `💁 since version 3.0.0` You can enable **lazy loading** for logo images on tables. `💁 since version 3.1.5` You can add **load more button** on tables. ### Reviews Table Shortcode ```html [table source="manual" reviews="comma separated list of review page ids" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ```html [table source="tax" cat="ID" tag="ID" ppp="-1" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ### Extended Table Block To add a new extended table simply click on the **+** (Add block) sign and select **Extended Reviews Table** in **Akurai Blocks** section. In the content editor a new table edit section will appear. There are 2 options to add reviews to the grid, manually or automatic, it's the same as for [general tables](https://docs.affkraft.com/akurai/blocks-shortcodes#reviews-table-block). Below reviews select how to display the **terms and conditions**. `💁 since version 2.3.0` You can add **filters** to tables, learn how to modify filters [here](https://docs.affkraft.com/akurai/how-to#how-to-modify-reviews-filters). `💁 since version 3.0.0` You can enable **lazy loading** for logo images on tables. `💁 since version 3.1.5` You can add **load more button** on tables. ### Extended Table Shortcode ```html [table_extended source="manual" reviews="comma separated list of review page ids" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ```html [table_extended source="tax" cat="ID" tag="ID" ppp="-1" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ### Flex Table Block `💁 since version 3.0.0` To add a new flex table simply click on the **+** (Add block) sign and select **Flex Reviews Table** in **Akurai Blocks** section. In the content editor a new table edit section will appear. There are 2 options to add reviews to the grid, manually or automatic, it's the same as for [general tables](https://docs.affkraft.com/akurai/blocks-shortcodes#reviews-table-block). Below reviews select how to display the **terms and conditions**, add **filters** to tables, learn how to modify filters [here](https://docs.affkraft.com/akurai/how-to#how-to-modify-reviews-filters). You can also enable **lazy loading** for logo images on tables. `💁 since version 3.1.5` You can add **load more button** on tables. ### Flex Table Shortcode ```html [table_flex source="manual" reviews="comma separated list of review page ids" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ```html [table_flex source="tax" cat="ID" tag="ID" ppp="-1" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ### Reviews Grid Block To add a new grid simply click on the **+** (Add block) sign and select **Reviews Grid** in **Akurai Blocks** section. In the content editor a new grid edit section will appear. There are 2 options to add reviews to the grid, manually or automatic, it's the same as for \[tables].(#reviews-table-block) Below reviews select how to display the **terms and conditions**. `💁 since version 2.3.0` You can add **filters** to grids, learn how to modify filters [here](https://docs.affkraft.com/akurai/how-to#how-to-modify-reviews-filters). `💁 since version 3.0.0` You can enable **lazy loading** for logo images on grids. `💁 since version 3.1.5` You can add **load more button** on tables. ### Reviews Grid Shortcode ```html [grid source="manual" reviews="comma separated list of review page ids" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ```html [grid source="tax" cat="ID" tag="ID" ppp="-1" terms="none|short|long|ajax|ajax-hover" filters="true" lazy_logo="true" load_more_enabled="true" count_initial="3" count_click="3"] ``` ### Reviews List Block To add a new list simply click on the **+** (Add block) sign and select **Reviews List** in **Akurai Blocks** section. In the content editor a new list edit section will appear. Click **Add Review** to add the 4 reviews. ### Reviews List Shortcode ```html [list reviews="comma separated list of review page ids" terms="none|ajax-hover"] ``` ### Review Offer Block To add a new offer simply click on the **+** (Add block) sign and select **Review Offer** in **Akurai Blocks** section. In the content editor a new offer edit section will appear. Select a review and fill in the fields. ### Review Offer Shortcode ```html [review_block review="review page id" terms="none|short|long" heading="..." subheading="..." button_url="..." button_text="..."] ... content here ... [/review_block] ``` ### Review Finder Block `💁 since version 3.0.0` To add a new review finder simply click on the **+** (Add block) sign and select **Review Finder** in **Akurai Blocks** section. In the content editor a new review finder edit section will appear. You can leave the default values or adjust the strings used on the block front-end. ### Review Finder Shortcode ```html [review_finder] ``` You can use the default shortcode as above, or set your own options: ```html [review_finder heading="..." placeholder="..." aff_link_text="..." review_link_text="..." bonus_code_label="..." not_found_label="..."] ``` ### Comparison Table Block `💁 since version 4.4.0` To add a new comparison table simply click on the **+** (Add block) sign and select **Comparison Table** in **Akurai Blocks** section. In the content editor a new comparison table edit section will appear. Add 2 or 3 reviews to compare side-by-side. For each comparison row, select the field type and optionally provide a custom label to override the default. Available row types: Rating, Welcome Bonus, Min Deposit, Max Deposit, Established, License, Payment Methods, Features, Sportsbook, Casino, Live Casino, Poker, Bingo, Lottery. Below reviews you can configure additional display options: how to display **terms and conditions**, whether to show the **visit button** and **review link**, **content alignment** (centered or left), and whether to apply each review's **brand colors** to the header row. ### Comparison Table Shortcode ```html [comparison_table reviews="comma separated list of review page ids" rows="rating,bonus,min_deposit" terms="none|short|long|ajax|ajax-hover" centered="true" use_review_colors="false" show_visit="true" show_review="true"] ``` ### Recent Posts Block To add a new posts block simply click on the **+** (Add block) sign and select **Recent Posts** in **Akurai Blocks** section. In the content editor a new recent posts edit section will appear. Select the number of posts to display and the post excerpt length. Or you can leave them blank for default values: 6 posts and 40 words. You can also select a category to filter the posts or leave it blank to display posts from all categories. `💁 since version 2.0` You can also choose a block style - default or no excerpt. ### Recent Posts Shortcode ```html [posts count="6" words="40"] [posts count="6" words="40" cat_id="1"] 💁 since version 2.0 [posts count="3" style="no_excerpt"] ``` ### Links Group Block `💁 since version 2.0.1` To add a new links group simply click on the **+** (Add block) sign and select **Links Group** in **Akurai Blocks** section. Select the links that can be posts, pages or reviews. If you want you can overwrite the titles and featured images. At the bottom, adjust the column count (2, 3, 4), whether the blog is contained in a section or not, rounded or straight image borders to fit with your website styles and finally you can disable the captions/titles. You can use this for posts, pages, reviews or as a mix of all, as you find it useful. On the right-side panel you can click on "Switch to Preview" to preview the slider block in your editor. ### FAQs Block To add a new FAQs block simply click on the **+** (Add block) sign and select **FAQs** in **Akurai Blocks** section. In the content editor a new FAQs edit section will appear. For each one add the question and the answer and clack `Add New` to add a new FAQ item. `💁 since version 2.0` By default schema.org markup for FAQ rich snippets will be included in all your FAQ blocks, however you can disable them if you need to. > Note that you can include only one markup on a page. If you have multiple FAQ blocks on a single, please enable this for one of them only. ### Lazy Image Block `💁 since version 2.0` To add a new lazy image simply click on the **+** (Add block) sign and select **Lazy Image** in **Akurai Blocks** section. Select or upload an image, set the alt text and you're ready. You can specify any CSS class names you want to add to the `img` tag Also select the shape of the image, whether it's wide, tall or square. This helps reserve space similar to the image and not cause document "rearrangement". ### Geo Blocks `💁 since version 4.6.0` The Geo Listing, Geo Content and Review Geo Message blocks let you tailor content to visitors based on their country. Before using them, set up your target countries on [Akurai → Setup → Geo Targeting](https://docs.affkraft.com/akurai/geo-targeting#settings). #### Geo Listing Block To add a new listing simply click on the **+** (Add block) sign and select **Geo Listing** in **Akurai Blocks** section. On the 1st tab you select the listing options such as listing type (grid, table, etc.), terms and whether to display filters or not. The 2nd tab, called **Default**, is where you select all reviews that you want to display to users from countries that are not in your list of targeted ones. After that there's a new tab for each country you target, simply add reviews or leave them empty to display the Default selection. You can choose reviews manually or filter them by category and/or by tag — select a review tag and all reviews with that tag will be displayed, and optionally set a limit, for example, display just 6 reviews tagged as "usa". #### Geo Content Block To add a new content block simply click on the **+** (Add block) sign and select **Geo Content** in **Akurai Blocks** section. Add your content to the rich-text editor and simply select the countries by toggling them on or off. #### Review Geo Message Block To add a new message block simply click on the **+** (Add block) sign and select **Review Geo Message** in **Akurai Blocks** section. You can overwrite the default supported/not-supported texts (set in [Geo Targeting settings](https://docs.affkraft.com/akurai/geo-targeting#default-support-messages)) or keep the defaults. Next you can select a style from the **Block Style** dropdown: 2 options with just message and country flag (flag being either on left or right side) and 2 options with the message, the flag as well as a bonus text and affiliate link (only for cases where country is supported). There is one more style called "No Styles" which just prints out the markup, so you can design your own message block by applying your own CSS rules to it. --- URL: https://docs.affkraft.com/akurai/widget-areas Markdown: https://docs.affkraft.com/akurai/widget-areas.md # Widget Areas Akurai has multiple widget areas to give you more options for laying out your content. *** ## Widget Area Layouts There are 7 widget areas available: 1. Main Sidebar 2. Left Sidebar 3. Review Page Sidebar 4. Footer Widgets #1 5. Footer Widgets #2 6. Footer Widgets #3 7. Footer Widgets #4 ### Main Sidebar **Main Sidebar** is displayed on pages with the **Right Sidebar** page template. ### Left Sidebar **Left Sidebar** is displayed on pages with the **Left Sidebar** page template. ### Review Page Sidebar **Review Page Sidebar** is displayed on review pages with **Review with Sidebar** template where you can add review page blocks (also via shortcodes). ### Footer Widgets The theme footer is divided into 4 equal parts, each one of them displaying a single widget area. This way you can have a long footer without having to worry about their responsive structure. --- URL: https://docs.affkraft.com/akurai/widgets Markdown: https://docs.affkraft.com/akurai/widgets.md # Akurai Widgets Akurai theme comes with built-in review widgets that you can use in page sidebars. *** ### Blocks as Widget Since WordPress 5.8 update, blocks can be used as widgets. The theme is updated so that you can use blocks in widget areas. There's a new blocks category called **Akurai Widgets** that lets you add the same 2 block widgets: Single Review and Reviews List. You can also use all review page blocks in review page sidebar. > It is recommended to use blocks instead of legacy widgets, as they may not get updated in the future. *** ## Using Widgets To add a widget to a sidebar or footer, in your WordPress dashboard visit **Appearance** → **Widgets**. Or you can use the Customizer as well, visit **Appearance** → **Customize** and select **Widgets**. Besides the default WordPress widgets, 2 sportsbook widgets are available for you to use in sidebars and footer. * Reviews List * Single Review ### Reviews List Widget Add the `Reviews List` widget to the widget area of your choice. Add a widget title, select whether to display the review terms of conditions or not, whether the logo image links the review page or the affiliate website, choose the reviews you want to display from the dropdown lists and click `Save`. You can display up to 10 reviews. ### Single Review Widget Add the `Single Review` widget to the widget area of your choice. Add a widget title, adjust settings: how to display terms and conditions and whether to include the review page link, choose the review you want to display from the dropdown list and click `Save`. --- URL: https://docs.affkraft.com/akurai/breadcrumbs Markdown: https://docs.affkraft.com/akurai/breadcrumbs.md # Akurai Breadcrumbs Akurai theme comes with built-in breadcrumbs since version 1.0.9. *** ### Enable Breadcrumbs To add breadcrumbs to your website you need to enable them. In your WordPress dashboard visit **Appearance** → **Customizer** → **Breadcrumbs Options** to enable breadcrumbs as well as adjust settings. ### Breadcrumbs Options **Reviews page Parent page** Akurai doesn't enforce users to have a parent page for review pages, however you can set one in breadcrumbs if you want. **Blog posts** By default breadcrumbs for posts pages includes categories, however you can add blog page as well. Just make sure to check the box *Include blog page in posts breadcrumbs*. ### Schema.org markup Akurai also includes structured data (schema.org) markup for [breadcrumbs](https://developers.google.com/search/docs/data-types/breadcrumb) out of the box, so you don't need to do anything. > **Do not enable breadcrumbs option in Yoast, as you'll end up having duplicate markup.** --- URL: https://docs.affkraft.com/akurai/customizations Markdown: https://docs.affkraft.com/akurai/customizations.md # Theme Customizations Theme customizations are made through native WordPress Customizer. In admin dashboard visit **Appearance** → **Customize** select the options group you want to customize and make the required changes. ## Customizer Options Below is the main WordPress Customizer view showing all the options you can customize. ### Site Identity This is the standard Site Identity section where you can upload your logo and favicon, set site title and tagline. ### Colors Define main theme colors here. ### Header Options Header options such as colors, navigation menu styles, header layout and positioning. `💁 since version 3.0.0` you can add a search form to the header. ### Footer Options Footer colors, footer navigation, gambling logos and copyright text. If you're using year in your copyright text, you can replace it with `_current_year_` and it will display the current year. ### Font Options Website font family. You can choose a system default font or one from [Google Fonts](https://fonts.google.com) or [Bunny Fonts](https://fonts.bunny.net). ### Section Options Here you define what Akurai sections look like and it'll affect almost everything including blocks and shortcodes. ### Link Options Define link colors and `rel` and `target` attributes. ### Button Options Theme button options such as colors, font styles, as well as hover effects and other styles. ### Review Options A plenty of options related to reviews and review pages. You can specify text contents used on these pages, choose Hero layouts for default and banner templates, whether to display a featured image on review pages, as well as specify review logo sizes for better performance and rendering, etc. You can also enable/disable review/rating snippets (schema.org) markup for review pages, and adjust review author options. ### Posts Options Several options related to posts, blog and archive pages. First of all, you can disable featured images on single post pages. You can disable post meta data above the content (author, date) and below it (categories, tags, comments count) - this will affect not only single posts, but also blog page and archive pages such as category and tag pages. You can also customize the layout of the blog page, by choosing to display it in a 2 column grid. `💁 since version 2.2.2` you can change the posts navigation type on archive pages: previous/next links or page numbers. `💁 since version 3.0.0` you can change the posts header style by choosing whether or not to display a hero on top og the page. ### Shortcode Options Specify various block/shortcode options such as anchor texts and the number of review stars, etc. ### Breadcrumbs Options Read more about breadcrumbs [here](https://docs.affkraft.com/akurai/breadcrumbs) --- URL: https://docs.affkraft.com/akurai/amp Markdown: https://docs.affkraft.com/akurai/amp.md # AMP Support Akurai comes with built-in AMP support. `💁 since version 2.0` *** Akurai supports AMP functionality out of the box. All you have to do is just install the **official AMP plugin for WordPress**, activate it and follow the wizard to set it up. It's quite straightforward. You can get the plugin from WordPress Plugins Directory: [AMP By AMP Project Contributors](https://wordpress.org/plugins/amp/) or add it through your WordPress dashboard Plugins page. To check the AMP functionality of the theme, simply append `?amp` at the page URLs. --- URL: https://docs.affkraft.com/akurai/demo-import Markdown: https://docs.affkraft.com/akurai/demo-import.md # Demo Import One Click Demo Import for Akurai theme. ## How to import demo content Instead of starting from scratch, with Akurai you have options to import demo content and make your adjustments. ### One Click Demo Import With **One Click Demo Import** option you can import demo content, as well as customizations and widgets exactly the way they are on demo websites. You need to install [One Click Demo Import](https://wordpress.org/plugins/one-click-demo-import/) plugin from WP plugin directory. Once it's installed and activated, there will be a new submenu item in your WP dashboard → Appearance called "**Akurai Demo Import**". Visit that page, select the demo website and import it. You can also install optional plugins the during import process. Once the import is completed your website will like the demo you selected. If for some reason you get an error when trying to import the demo, try switching to manual method and upload the below files: * Akurai demo - [content](https://raw.githubusercontent.com/affkraft/downloads/main/akurai/demo-import/akurai.xml), [customizer](https://raw.githubusercontent.com/affkraft/downloads/main/akurai/demo-import/akurai.dat), [widgets](https://raw.githubusercontent.com/affkraft/downloads/main/akurai/demo-import/akurai.wie) ### Manual Content Import If you prefer to customize the theme on your own, you can download a `.xml` file from your AffKraft account that contains the demo content. After that you can import it to your new website using WP Importer following [simple steps](https://wordpress.org/support/article/importing-content/#wordpress). It will not import the customizations or widgets to your website. --- URL: https://docs.affkraft.com/akurai/updates Markdown: https://docs.affkraft.com/akurai/updates.md # Akurai Theme Updates Akurai updates are baked into the theme, 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 theme and upload through FTP again. However, if for some reason you want to do that, you still can just download the theme files from your account, remove the old theme directory and upload the new one to your server. --- URL: https://docs.affkraft.com/akurai/child-theme Markdown: https://docs.affkraft.com/akurai/child-theme.md # Akurai Child Theme If you need for any reason to do any modifications to the theme files, the recommended approach would be using child themes. Learn how to [create WordPress child themes](https://affkraft.com/blog/how-to-create-wordpress-child-themes) and download the child theme for Akurai. --- URL: https://docs.affkraft.com/akurai/how-to Markdown: https://docs.affkraft.com/akurai/how-to.md # How To ... ### How To Modify Reviews Filters `💁 since version 2.3.0` You can add **filters** to tables and grids. Currently filters are divided into 6 groups: * Popular Filters * Ratings * Offers * Licenses * Countries * Payment Methods Below filters allow to modify which filter groups to include (keys), what to call those groups (headings) and values to filter reviews. You can use them in your child theme. For more details check out inc/modules/listing-filters.php file. #### How To Modify Keys ```php $key !== 'ai_licenses' ); } add_filter( 'akurai_review_filters__keys', 'set_akurai_review_filters_keys' ); } ``` #### How To Modify Headings These are all available filters to modify review filters headings: ```toml 'akurai_review_filters__heading__popular' 'akurai_review_filters__heading__ratings' 'akurai_review_filters__heading__offers' 'akurai_review_filters__heading__licenses' 'akurai_review_filters__heading__countries' 'akurai_review_filters__heading__payment_methods' ``` The below example changes offers block heading from Offers to Services. ```php __( 'Services', 'akurai' ) ); ``` *** #### How To Modify Values These are all available filters to modify review filters values: ```toml 'akurai_review_filters__values__popular' 'akurai_review_filters__values__ratings' 'akurai_review_filters__values__offers' 'akurai_review_filters__values__licenses' 'akurai_review_filters__values__countries' 'akurai_review_filters__values__payment_methods' ``` The below example modifies ratings block. Instead of 6+, 7+, 8+, 9+, 10 it will change it to just 8 and more, 9 and more, 10. ```php array( '8' => '8 and more', '9' => '9 and more', '10' => '10' ) ); ``` This next example modifies offers block. Instead of Sportsbook, Casino, Live Casino, Poker, Bingo, Lottery it will change it to just Sportsbook, Casino. ```php array( 'sportsbook' => 'Sportsbook', 'casino' => 'Casino' ) ); ``` *** ### How To Change Footer Gambling Logos To do that, first we need to create the following directory structure in the child theme and upload all the logo images to that directory: ```yaml /assets/images/gambling-logos/ ``` It helps if you resize the images beforehand so that they all have the same height. Next we need to use a filter to update the logo files. Add this to your child theme's `functions.php` file and replace the values with actual image names, dimensions, alt texts and URLs (optional). Those should be the images you uploaded at the previous step. The example uses just 2 images, but you can add as many images as you want. ```php 'logo-1.png', 'alt' => 'Logo #1 alt text', 'url' => 'https://some-url-here.org/', 'width' => 64, 'height' => 36, ), array( 'image' => 'logo-1.png', 'alt' => 'Logo #2 alt text', 'width' => 124, 'height' => 36, ), // copy/paste and modify the previous array as many times as you need ); } add_filter( 'akurai_gambling_logos', 'change_akurai_gambling_logos' ); ``` *** ### How to Choose which Logo to Use on each Listing Block For each review you can upload 2 logos (main/large and small), and there are 5 listing blocks and 2 widget blocks available in Akurai. By default blocks use the following logos: * Review Table - Large Logos * Review Table Flex - Large Logos * Review Table Extended - Large Logos * Review Grid - Large Logos * Review List - Small Logos * Single Review Widget - Large Logos * Multiple Reviews Widget - Small Logos Depending on what kind of logos you upload, you may want to use different images on different blocks. You can change which logo to use on the blocks by using the below filters, copy only the ones that you want to change and add them to your child theme. ```php 'large' ); add_filter( 'akurai_table_flex_logo_size', fn() => 'small' ); add_filter( 'akurai_table_extended_logo_size', fn() => 'small' ); add_filter( 'akurai_grid_logo_size', fn() => 'small' ); add_filter( 'akurai_list_logo_size', fn() => 'large' ); add_filter( 'akurai_multiple_reviews_widget_logo_size', fn() => 'large' ); add_filter( 'akurai_single_review_widget_logo_size', fn() => 'small' ); ``` --- URL: https://docs.affkraft.com/akurai/ai Markdown: https://docs.affkraft.com/akurai/ai.md # Akurai & AI With Akurai 4.7.0 you can manage your reviews and bonuses 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/akurai/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 bonus" or "set the payments". WordPress calls these tasks **abilities**. To make this work you need three things: 1. **Akurai** provides the abilities for your reviews, standalone bonuses, categories, tags, Akurai blocks and shortcodes, settings and license. You choose which ones to offer on the **Akurai → 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 recent versions of WordPress > to be able to use Akurai'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 **Akurai → 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 and bonuses, manage categories and tags, and work with Akurai blocks and shortcodes, but not move posts 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. Akurai 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. * **Akurai 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 Akurai'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 Akurai 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 | `akurai/list-reviews`, `akurai/get-review`, `akurai/audit-reviews`, `akurai/list-field-choices`, `akurai/check-geo-support` | Users who can edit reviews (`edit_posts` on review CPT) | On | | Reviews: edit | Create review drafts and update review fields, status, categories, tags, bonus, pros & cons, ratings, payments, info table, offers, countries and geo affiliate links | `akurai/create-review`, `akurai/update-review`, `akurai/set-bonus`, `akurai/set-pros-cons`, `akurai/set-ratings`, `akurai/set-payments`, `akurai/set-info-table`, `akurai/set-offers`, `akurai/set-geo`, `akurai/set-geo-links` | Users who can edit that review; publishing requires `publish_posts` on review CPT | On | | Bonuses: read | List and inspect standalone bonus posts | `akurai/list-bonuses`, `akurai/get-bonus` | Users who can edit bonuses (`edit_posts` on bonus CPT) | On | | Bonuses: edit | Create bonus drafts and update bonus fields, status, categories and review links | `akurai/create-bonus`, `akurai/update-bonus` | Users who can edit that bonus; publishing requires `publish_posts` on bonus CPT | On | | Categories & tags | List, create, rename and delete terms in review categories, review tags and bonus categories | `akurai/list-terms`, `akurai/create-term`, `akurai/update-term`, `akurai/delete-term` | Users with taxonomy edit/delete capabilities | On | | Blocks & shortcodes | Find Akurai blocks and shortcodes in posts, pages, reviews and bonuses, change their settings and insert new ones | `akurai/list-element-types`, `akurai/find-elements`, `akurai/get-elements`, `akurai/update-block`, `akurai/update-shortcode`, `akurai/insert-block`, `akurai/insert-shortcode` | Users who can edit that post or page | On | | Settings | Read and update allowlisted Customizer theme settings, configure geo targeting and change CPT rewrite base slugs | `akurai/get-settings`, `akurai/update-settings`, `akurai/set-geo-settings`, `akurai/set-review-slug` | Administrators (`manage_options`; `get-settings` and `update-settings` also need `edit_theme_options`) | Off | | Trash & restore | Move reviews or bonuses to the trash and restore them as drafts | `akurai/trash-review`, `akurai/restore-review`, `akurai/trash-bonus`, `akurai/restore-bonus` | Users who can delete that post | Off | | License | Check theme registration state, version and cached expiration | `akurai/get-license-status` | Administrators (`manage_options`) | Off | ### The 39 abilities Read abilities only look at your data; write abilities change it. Every ability runs as the WordPress user you signed in with. | Ability | Group | Type | What it does | Who can use it | | --- | --- | --- | --- | --- | | `akurai/list-reviews` | Reviews: read | Read | Lists reviews with search, status, category and tag filters, sorting and paging, and shows each review's issue codes. | Users who can edit reviews | | `akurai/get-review` | Reviews: read | Read | Returns one full review: fields, bonus, ratings, pros and cons, payments, info table, offers, geo settings, terms and issue codes. | Users who can edit that review | | `akurai/audit-reviews` | Reviews: read | Read | Scans up to 1000 reviews and returns only those with problems, plus a count per issue code. | Users who can edit reviews | | `akurai/list-field-choices` | Reviews: read | Read | Lists valid values for countries, bonus types, offer types and geo target countries. | Users who can edit reviews | | `akurai/check-geo-support` | Reviews: read | Read | Checks whether a review (or, without a review, which reviews you can edit) supports a country, with the geo message and affiliate link. | Users who can edit reviews | | `akurai/create-review` | Reviews: edit | Write | Creates a review as a draft. Refuses duplicate titles unless you allow them. | Users who can edit reviews | | `akurai/update-review` | Reviews: edit | Write | Updates title, slug, status, content, featured image, categories, tags and main fields. Publishing needs name, logo, small logo and affiliate link. | Users who can edit that review; publishing needs publish rights | | `akurai/set-bonus` | Reviews: edit | Write | Sets a review's bonus text, bonus codes and terms. | Users who can edit that review | | `akurai/set-pros-cons` | Reviews: edit | Write | Replaces the pros and cons headings and lists (up to 20 items each). | Users who can edit that review | | `akurai/set-ratings` | Reviews: edit | Write | Sets the overall rating and the rating rows (0 to 10 in steps of 0.5, up to 10 rows). | Users who can edit that review | | `akurai/set-payments` | Reviews: edit | Write | Sets deposit and withdrawal headings and method lists (up to 30 each). | Users who can edit that review | | `akurai/set-info-table` | Reviews: edit | Write | Sets the info table values (website, established, country, minimum and maximum deposit) and custom row labels. | Users who can edit that review | | `akurai/set-offers` | Reviews: edit | Write | Sets the sportsbook, casino, live casino, poker, bingo and lottery offers and their display options. | Users who can edit that review | | `akurai/set-geo` | Reviews: edit | Write | Replaces a review's supported countries and custom geo texts. | Users who can edit that review | | `akurai/set-geo-links` | Reviews: edit | Write | Sets or removes per-country affiliate links on a review. | Users who can edit that review | | `akurai/list-bonuses` | Bonuses: read | Read | Lists bonus posts with search, status, category, bonus type and linked review filters. | Users who can edit bonuses | | `akurai/get-bonus` | Bonuses: read | Read | Returns the full record of one bonus. | Users who can edit that bonus | | `akurai/create-bonus` | Bonuses: edit | Write | Creates a bonus as a draft. | Users who can edit bonuses | | `akurai/update-bonus` | Bonuses: edit | Write | Updates a bonus's post fields, categories and fields. | Users who can edit that bonus; publishing needs publish rights | | `akurai/list-terms` | Categories & tags | Read | Lists terms in review categories, review tags or bonus categories. | Users who can edit reviews | | `akurai/create-term` | Categories & tags | Write | Creates a term in one of those taxonomies. | Users who can manage those terms | | `akurai/update-term` | Categories & tags | Write | Changes a term's name, slug, description or parent. | Users who can manage those terms | | `akurai/delete-term` | Categories & tags | Write | Permanently deletes a term. The reviews and bonuses stay and are only detached from it. | Users who can delete those terms | | `akurai/list-element-types` | Blocks & shortcodes | Read | Lists Akurai block types and shortcode types with their settings. | Users who can edit reviews | | `akurai/find-elements` | Blocks & shortcodes | Read | Finds posts, pages, reviews and bonuses you can edit that contain Akurai blocks or shortcodes. Looks at the first 500 matches and tells you if there were more. | Users who can edit reviews | | `akurai/get-elements` | Blocks & shortcodes | Read | Returns every Akurai block and shortcode in one post with its settings. | Users who can edit that post | | `akurai/update-block` | Blocks & shortcodes | Write | Changes settings of one Akurai block; the rest of the post is left exactly as it was. | Users who can edit that post | | `akurai/update-shortcode` | Blocks & shortcodes | Write | Changes attributes of one Akurai shortcode. Refuses shortcodes that wrap content or use unnamed attributes, and values containing a double quote or `]`. | Users who can edit that post | | `akurai/insert-block` | Blocks & shortcodes | Write | Inserts a new Akurai block at the start, the end or after an existing block. | Users who can edit that post | | `akurai/insert-shortcode` | Blocks & shortcodes | Write | Inserts a new Akurai shortcode at the start, the end or after an existing shortcode. | Users who can edit that post | | `akurai/trash-review` | Trash & restore | Write | Moves a review to the Trash. Refuses if Trash is turned off on the website. | Users who can delete that review | | `akurai/restore-review` | Trash & restore | Write | Restores a trashed review as a draft. A review that isn't in the Trash is left as it is. | Users who can delete that review | | `akurai/trash-bonus` | Trash & restore | Write | Moves a bonus to the Trash. Refuses if Trash is turned off on the website. | Users who can delete that bonus | | `akurai/restore-bonus` | Trash & restore | Write | Restores a trashed bonus as a draft. | Users who can delete that bonus | | `akurai/get-settings` | Settings | Read | Reads the allowed theme settings, the review and bonus URL slugs and the geo options. | Administrators | | `akurai/update-settings` | Settings | Write | Changes allowed theme settings, or resets them to default. All values are checked before anything is saved. | Administrators | | `akurai/set-geo-settings` | Settings | Write | Sets the geo target countries and the default supported and not-supported texts. | Administrators | | `akurai/set-review-slug` | Settings | Write | Changes the URL slug of reviews or bonuses. | Administrators | | `akurai/get-license-status` | License | Read | Shows whether the theme is registered, its version and the cached expiry, never the license key. | Administrators | Two limits to know about. Linking a review to a bonus isn't kept in sync: the review's linked bonuses and the bonus's linked review are separate fields, so set each side yourself. And the assistant can't change custom fonts, the footer copyright text or header and footer scripts. ### Keeping it safe * **Use a separate WordPress user** for the assistant, with the Editor role (Authors and Contributors can't use any Akurai ability), 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 and bonuses are always saved as drafts. A review can only be published once it has the required fields: name, logo, small logo and affiliate link. A post with a future date can't be published by the assistant (that would schedule it); change the date first. * **Posts are never deleted for good.** Trash abilities only move posts to the Trash, where you can restore them. If Trash is turned off on your website (`EMPTY_TRASH_DAYS` set to 0), they refuse and change nothing. Deleting a category or tag, however, cannot be undone (the reviews and bonuses themselves are kept). * **Your keys stay private.** The assistant can never read your Akurai license key, only whether one is registered. Header and footer script options (`aic_scripts_*`) cannot be read or modified through the abilities API. * **Some things can't be changed by the assistant.** Custom fonts, the footer copyright text and the header and footer scripts are not available to it. Make those changes in the Customizer yourself. * **Slug changes have wide effects.** Changing the review or bonus URL slug changes the address of every item, so old links stop working unless you add redirects. * **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." * "Create a standalone welcome bonus linked to *review name* with code *BONUS100*." The audit checks each review for these problems (issue codes in brackets): no name (`no_name`), no logo (`no_logo`), no small logo (`no_small_logo`), no affiliate link (`no_affiliate_link`), no bonus (`no_bonus`), no overall rating (`no_rating`), fewer than two rating rows (`few_ratings`), no pros (`no_pros`), no cons (`no_cons`), no bonus terms (`no_terms`), no supported countries (`no_countries`), no category (`no_categories`) and published reviews not modified for six months, or the number of months you ask for (`stale`). *** ## 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 **Akurai → 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`. Akurai's abilities are in the `akurai` 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 Akurai and is a different thing from managing your website from a chat assistant.