Cacbot

Cacbot is a WordPress plugin that lets you interact with AI agents directly on your WordPress site, using the native comment system to record the chats. Written entirely in PHP, this plugin works on any WordPress site.

Features and Capabilities:

• Transform and generate text
• Create images
• Execute functions and perform actions
• Capture all conversation data in the WordPress comment system

You can give system instructions that remain hidden from users, create multi-step conversations, and keep all data within your WordPress environment. All data is stored in the default WordPress comment system.

Who is it for?
Developers and site admins looking to build AI-powered WordPress applications.

---

Getting Started

1. Download the ZIP File
   Download cacbot.zip.

2. Upload and Activate
   In your WordPress admin, navigate to Plugins > Add New, then upload the zip file and activate it.

3. Create a Cacbot Conversation

   • Go to the Posts tab in your WordPress admin area.
   • Click Add New Post.
   • Add a title to your conversation (for example, "Test").
   • enable Custom Fields in the Screen Options tab
   • Create a post metadata item with the key "_cacbot_conversation", and set the value to "1".
   • Set the post’s visibility to Private and click Publish.

4. Use Cacbot

   • View the conversation on the frontend.
   • Type your message in the comment box.
   • Once you submit, the Cacbot Assistant will reply, and its response is saved as a WordPress comment.

---

Cacbot User Role

Cacbot introduces a new WordPress user role: Cacbot.

• By default, users with the Cacbot role also have editor capabilities.
• Cacbots can perform all actions an editor can, though you can adjust these capabilities manually.
• With an Administrator’s permission, a Cacbot can even modify its own capabilities.

---

Conversation Structure

• _cacbot_interlocutor_user_id: The user ID of the first speaker (Interlocutor).
• _cacbot_respondent_user_id: The user ID of the second speaker (Respondent).

If a non-Cacbot user leaves a comment, the Cacbot Assistant is automatically designated as the Respondent. This information is stored as post meta data.

---

Special Post Meta Fields

Below are several custom fields that can be used to adjust Cacbot Conversations:

_cacbot_action_enabled_archive

• Type: bool
• Default: false
• When set to true, a trash-can icon appears if there is at least one comment. Clicking it archives the conversation.

This can be useful when you only need a single result from the AI (for example, a one-time generated text or image), and you want to archive or "retry" that conversation.

---

_cacbot_action_enabled_fetch_image

• Type: bool
• Default: false
• When set to true, an image icon appears if there are no comments yet. Clicking it sends the user’s comment text to the DALL·E 3 model, which generates an image.

How to Use:

1. Install the free plugin LH Add Media from URL from the wordpress.org repo.
2. Create a new Cacbot Conversation.
3. Add a custom field _cacbot_action_enabled_fetch_image and set it to true.
4. Describe your desired image.
5. Click the “Fetch Image” icon to generate and save it to the WordPress Media Library.

---

_cacbot_max_replies

• Type: integer
• Description: The maximum number of comments allowed before the conversation is closed.

---

_cacbot_max_archives

• Type: integer
• Description: The total number of times a user can click the “archive” button.

---

_cacbot_system_instructions

• Type: string or integer
• Default: "You are a helpful assistant."
• If you provide a string, it becomes the system instruction passed to the LLM.
• If you provide an integer, the post with that ID is used (including expanded shortcodes in that post).

Usage Ideas:

• Insert pages or shortcodes to pass dynamic information to the LLM.
• Combine multiple instructions in one place.
• Use WordPress shortcodes in the content of the post to use PHP functions to send custom messages to the AI!

---

_cacbot_anchor_post

• Type: bool
• Default: false

How it works:

• When a user comments on an anchor post, a new Cacbot Conversation is automatically created in the background.
• The comment thread is displayed on the anchor post’s frontend.
• This setup allows multiple users to chat with a specific Cacbot on a specific page, post or URL.

---

_cacbot_comment_form_placeholder_text

• Type: string
• Description: The placeholder text shown in the comment form.

---