🤖 A.I. Style User Guide
A.I. Style is a conversation-focused WordPress theme inspired by modern AI chat interfaces. Each post is a conversation, and its comments are the messages.
This guide is for site owners. It explains how to install the theme, set it up, and use each of its features from the WordPress dashboard. You don’t need to edit any code.
🧭 Contents
- What you need
- Install and activate the theme
- Quick start: your first conversation
- Where to find the theme’s controls
- Conversations
- Choose what appears above a post
- The blog roll and archive pages
- Add a header Page
- Set the footer text
- Write in the block editor
- The sidebar
- Optional plugins
- Updating the theme
- Troubleshooting and known limitations
- Privacy
- License
✅ What you need
- WordPress 7.0 or later.
- PHP 8.1 or later. If you’re not sure, your hosting provider can tell you.
- Comments switched on for every post you want to use as a conversation.
The theme works on its own as a conversation space for the people on your site. A.I. Style does not contact any AI service by itself.
📦 Install and activate the theme
- In the dashboard, go to Appearance → Themes and select Add New Theme.
- Select Upload Theme, choose the theme’s
.zipfile, and select Install Now. - When the upload finishes, select Activate.
The theme is now active. Your posts appear as tiles on the blog roll, and each post opens as a conversation.
⚠️ If the upload fails, contact your hosting provider.
🚀 Quick start: your first conversation
- Go to Settings → Discussion and choose your moderation settings. To make visitors sign in before they post, tick Users must be registered and logged in to comment; signed-out visitors then see WordPress’s “You must be logged in” message instead of the message box. Select Save Changes.
- Go to Posts → Add New Post.
- Give the post a title, such as “Welcome chat”. If you like, write an opening message or some ground rules in the post body.
- Make sure comments are allowed. In the block editor, open the Post sidebar and check that Discussion is set to Open. In the Classic Editor, tick Allow comments in the Discussion box.
- Select Publish and open the post.
The message box sits at the bottom of the screen. Sign in if necessary, then type a message and send it. Your message appears on the right. When someone else replies, their message appears on the left.
🧰 Where to find the theme’s controls
A.I. Style is a classic theme. It doesn’t use the Site Editor (Appearance → Editor). Its controls are:
| What you want to change | Where to change it |
|---|---|
| 🖼️ Blog roll, header Page, avatars and names, footer text | Appearance → Customize → AI Style (users who can edit theme options) |
| 📝 What appears above a single post | The Singular Meta Controls panel or box when you edit the post |
| 🧩 Sidebar contents | Appearance → Widgets, Sidebar area |
| 📚 Sidebar menus | Appearance → Menus |
| 💬 Who can post messages, moderation, avatars | Settings → Discussion (standard WordPress settings) |
💬 Conversations
Who can take part
Messages are ordinary WordPress comments, so the usual rules under Settings → Discussion apply:
- The message box appears only when comments are open on the post, as in any WordPress theme.
- With Users must be registered and logged in to comment ticked, signed-out visitors see WordPress’s “You must be logged in” message, with a sign-in link, in place of the box.
- With it switched off, signed-out visitors see the box with WordPress’s name, email and website fields, and can post as guests.
- Use Comment moderation, Disallowed Comment Keys and the Comments screen to review or remove messages.
🔓 Remember: anyone who can see a post can see its approved messages. Comments are not private messages.
How messages are laid out
- Your own messages are on the right, and everyone else’s are on the left. Each person sees their own messages on the right.
- Signed-out visitors see every ordinary message on the left.
- Messages appear oldest first. Messages that are still waiting for approval are not shown.
- The whole conversation shows on one screen. The theme ignores Break comments into pages under Settings → Discussion, so a long conversation is never split across pages.
- Password-protected posts show only the password box until the visitor enters the password; then the conversation and the message box appear.
- Full-width answers. Messages from an account that has the full-width permission, such as the Cacbot assistant, span the whole width of the conversation with no bubble. This suits long answers with headings, lists or code. The permission is given by the plugin that creates that account, not by a setting in the theme.
Show avatars and names
- Go to Appearance → Customize → AI Style → Conversations.
- Tick Show avatars and names in conversations. The preview shows the change straight away.
- Select Publish.
Each message then shows the writer’s display name and their Gravatar picture. Your own messages show your name but no picture.
- Pictures also need Show Avatars to be ticked under Settings → Discussion. Without it, only names are shown.
- Names in group conversations. When three or more people have written in a conversation, names are always shown, even with this setting off, so readers can tell everyone apart.
🎛️ Choose what appears above a post
A single post can show, above its body: the featured image, the title, the author’s avatar, the publication date, and the excerpt. You choose this for each post. Every item is shown until you turn it off.
Block editor: edit the post, open the Post tab of the sidebar, and use the switches in the Singular Meta Controls panel.
Classic Editor: edit the post and use the checkboxes in the Singular Meta Controls box at the side.
Then update the post. The items always appear in this order: featured image, title, author avatar, publication date, excerpt. On screens 782 pixels wide or more, the avatar sits to the left of the title with the date beneath it.
- Turn everything off to remove the whole area above the post.
- The excerpt only appears if you wrote one in the post’s Excerpt field. The theme never makes one up from the post body.
- The featured image only appears if the post has one.
These controls are available for posts, Pages and other public content types that support custom fields.
🗂️ The blog roll and archive pages
Your blog roll and archive pages show posts as tiles, with page links at the bottom when there are more posts than fit on one page.
Choose which content types appear
- Go to Appearance → Customize → AI Style → Blog Roll.
- Tick each content type to show on the blog home page and its main feed. Content types added by plugins, such as products, appear in this list.
- Select Publish.
This changes the blog home page and its feed only. Category, tag and other archive pages are unchanged. If you untick everything, or a content type you chose no longer exists, the theme falls back to ordinary posts.
Add content rows between the tiles
A content row is a full-width band, such as an announcement, placed between rows of tiles. You can have up to two.
- Create a Page with the content for the row and publish it. The Content row: callout pattern is a good starting point; see Write in the block editor. Only published Pages appear in public content rows.
- Go to Appearance → Customize → AI Style → Blog Roll.
- In Content Row 1: Page, choose your Page.
- In Content Row 1: Position (after row #), enter how many rows of tiles come before it. Use
to put it above the first row. Content Row 1 starts at1and Content Row 2 at3. - Select Publish.
The position counts rows as they appear on screen, not posts. A wide screen fits more tiles in a row than a phone, so the content row appears after more posts on a wide screen.
To remove a content row, choose — Select —. The theme remembers its position, so if you choose a Page again later it appears in the same place.
🪧 Add a header Page
The header Page is a strip of your own content, such as a welcome message, shown at the top of the blog roll, archive pages and single posts.
- Create a Page for the header and publish it. The Header row: site intro pattern is a good starting point. Keep it to one top-level block, because the header lays its contents out side by side. Only a published Page appears in the public header.
- Go to Appearance → Customize → AI Style → Header and choose the Page in Header Page.
- Select Publish.
Visitors who are not signed in also see a Login button in the header. It takes them to the sign-in screen and brings them back to the page they were on.
- The header is not shown on single posts to signed-in users, so they get the full conversation. It still shows on the blog roll and archive pages.
- To remove the header and its Login button, set Header Page to — Select —.
- If a selected Page is later made private, drafted, or trashed, its header content is no longer rendered.
📝 Set the footer text
On desktop screens a thin bar runs along the bottom of the page. It is empty until you add text.
- Go to Appearance → Customize → AI Style → Footer and type your text in Footer Text. You can use links (
<a href="…">), bold (<strong>), italic (<em>) and line breaks (<br>); any other HTML is removed when you publish. - Select Publish.
To empty the bar, clear the box and publish. The footer is hidden on phones.
✍️ Write in the block editor
You can write posts and Pages with the block editor or with the Classic Editor plugin.
- What you see is what you get. The editor uses the conversation’s dark background, colors, fonts and width, so a post looks much as it will when published.
- Theme colors and sizes. Color and font-size options offer the theme’s own palette and sizes.
- Wide and full-width blocks. You can set blocks to wide or full width. Everything else is centered at the width of the conversation.
- Patterns. In the block inserter, open Patterns and choose the A.I. Style category:
- Header row: site intro is for the header Page.
- Content row: callout is for a content-row Page.
- Conversation starter is an opening message with suggested prompts for a new conversation post. WordPress may also offer it when you start a new post.
📚 The sidebar
For signed-in users, the sidebar sits to the left of the conversation. Signed-out visitors do not see it.
Add widgets and menus
- Go to Appearance → Widgets and open the Sidebar area.
- Add the widgets you want.
For a menu with expandable sections:
- Go to Appearance → Menus, create a menu, and drag items under a parent to make sub-items. Select Save Menu.
- In Appearance → Widgets, add the Navigation Menu widget to the Sidebar and choose your menu. Use the widget named Navigation Menu, not the Navigation block. The expanding sections only work with the widget.
Each item with sub-items gets an arrow button (▸). Select it to open the section, or select it again (▾) to close it. With the keyboard, use Enter or Space, or the right and left arrow keys. Each browser remembers which sections were left open. When a visitor opens a page that sits under a parent in the menu, that parent’s section opens automatically so the current page is visible.
Show and hide the sidebar
Signed-in users show or hide the sidebar with the sidebar button on the toolbar at the top of the screen. On wide screens their choice is remembered in that browser. On a touch screen, you can also close an open sidebar by swiping left inside it. Swiping never opens it.
🧩 Optional plugins
A.I. Style works without any plugins. These plugins add features when they are installed and active.
Anchor Posts: one public post, a private conversation for each member
An anchor post is a public post that everyone opens at the same address. Each signed-in member gets their own private conversation behind it.
- Install and activate the Anchor Posts plugin.
- Edit a post, tick Designate this post as an anchor post in the Anchor Post box, make sure comments are open, and publish it.
When a signed-in member sends a message on that post, it starts their own private conversation. Visitors who are not signed in see the post’s ordinary public comments.
To let members start a fresh conversation, add Anchor Posts’ New Chat widget to the Sidebar under Appearance → Widgets. On an anchor post it shows a New Chat button that clears the current conversation from the screen; the member’s next message starts a new one, and the old one stays in Archived Conversations. When the conversation is already new, the button is greyed out. The widget comes with Anchor Posts, so it isn’t available without the plugin.
To list each member’s earlier conversations, add the Archived Conversations widget to the Sidebar under Appearance → Widgets. Selecting one opens that conversation on the anchor post. When there are none, the widget says “No archived conversations.”
Without Anchor Posts, every post simply shows its own comments.
Cacbot: conversations with an AI agent
Cacbot connects conversations to an AI agent and adds the agent’s replies to the conversation. Cacbot needs its own setup, including the AI provider account and the agent. Follow the instructions that come with Cacbot.
Live message updates do not require Cacbot. While a signed-in user keeps an unprotected conversation open, A.I. Style checks for newly approved, edited or removed messages about every five seconds and updates the conversation without reloading the whole page. This check pauses while the page is hidden. Signed-out visitors must refresh the page to see new messages.
Markup Markdown: formatted messages
With the Markup Markdown plugin active, messages written in Markdown are shown formatted, for example **bold**, lists and code. Without it, messages are shown exactly as typed.
Classic Editor
With the Classic Editor plugin, the Singular Meta Controls appear as a box beside the editor instead of a panel in the block editor sidebar.
🔄 Updating the theme
A.I. Style does not have an automatic update channel, so WordPress does not fetch its updates under Dashboard → Updates. Obtain the new theme .zip file from the same trusted source as your original copy. Back up your site, then go to Appearance → Themes → Add New Theme → Upload Theme, choose the new .zip, select Install Now, and confirm that WordPress should replace the installed version.
Your settings, menus, widgets and per-post choices are kept when you update. Changes made by editing the theme’s files are replaced. Keep any customizations in a child theme or a plugin instead.
AI Style Customizer settings are stored as theme modifications for the active theme. Per-post display choices are stored as post metadata and remain in the database when you switch themes. The theme creates no custom database tables.
🛠️ Troubleshooting and known limitations
The message box is missing
- Check that comments are open on the post (see Quick start, step 4).
- WordPress may close comments on older posts automatically. Check Automatically close comments on posts older than under Settings → Discussion.
- For signed-out visitors, WordPress replaces the box with its “You must be logged in” message when Users must be registered and logged in to comment is ticked under Settings → Discussion.
- Another plugin may be replacing the comment form. Deactivate plugins one at a time to find it.
A message doesn’t appear
- Look under Comments in the dashboard. The message may be waiting for approval or marked as spam.
- Signed-in users normally receive message changes automatically about every five seconds while the page is visible. Signed-out visitors must refresh the page.
Names appear but pictures don’t
Tick Show Avatars under Settings → Discussion. Pictures come from Gravatar, so someone without a Gravatar account gets the default image.
The header doesn’t appear on a post
That’s expected for signed-in users on single posts. Check the post while signed out, or look at the blog roll.
A content row appears in a different place on my phone
That’s expected. Positions count rows on screen, and a phone shows fewer tiles per row; see Add content rows between the tiles.
The AI agent doesn’t answer
Check that Cacbot is installed, active and set up, and follow Cacbot’s own troubleshooting steps. The theme only displays the conversation.
🔒 Privacy
Messages are WordPress comments and are stored in your site’s database. Theme appearance settings are stored as theme modifications, and the display choices described under Choose what appears above a post are stored as post metadata. Optional integrations may store additional data, including comment metadata. A.I. Style creates no custom database tables and does not contact an AI service itself. If you use Cacbot, message text is sent to the AI provider configured in that plugin.
When Show Avatars is enabled under Settings → Discussion, visitors’ browsers may load pictures from Gravatar, a service run by Automattic, in blog and archive tiles, above a singular post, and beside conversation messages. Conversation pictures also require Show avatars and names in conversations; that theme setting does not control archive-tile or singular-post author avatars.
Before opening your site to the public:
- Publish a privacy policy that covers comments and, if you use it, your AI provider.
- Ask people not to share sensitive personal information in conversations.
- Set up moderation and spam protection.
⚖️ License
A.I. Style is licensed under the GNU General Public License, version 2 or later. See readme.txt for the licenses of the components it includes.