AI Assistant plugin 1.1.0 / Getting started
Install and set up
This page is for admins: how to install AI Assistant, what you find right after installing, the first steps to take before members start using it, how to upgrade from AI Assistant 1.0.0, and how to switch it off or remove it.
Install and switch it on#
Last updated: 2026-11-19 · v1.1.0
You install AI Assistant like every other plugin: upload its zip in AdminCP → Plugins → Manage. The steps, the messages you may see, and how to switch a plugin off or remove it are in Install a plugin in the ShaunSocial guide.
After installing, members see nothing yet. Every switch of the plugin starts off and no AI service is picked, so no request can cost you money before you have set it up. Follow Set up AI Assistant to switch it on.
| Where | What you find | Right after installing |
|---|---|---|
| AdminCP → Site Settings → General Configuration → AI Assistant | seven settings: the main switch, a switch and an AI service for each assistant, the tones and the longest draft | all switches off, no AI service picked |
| AdminCP → Users → Manage User Roles → Permissions of a member role, box AI Assistant | two permissions and the daily limit | both permissions on, limit 20 drafts a day |
| On the site: the post composer, the comment box, under each comment | AI Assist, AI Comment, AI Reply | hidden until you switch them on |
AI Assistant adds no menu of its own under Plugins in the AdminCP, and no page or menu item on the site: it works inside screens your members already use.
Upgrading from AI Assistant 1.0.0#
Upgrade ShaunSocial to 1.5.6 first, then upload the 1.1.0 zip as described in Upgrade a plugin. Version 1.1.0 changes how the assistant looks, not how it works: your settings and permissions stay as they were.
- The two drafting windows use the site's own text boxes, buttons and error message, with Cancel and the main button placed like in every other window.
- The tones are shown as the same round buttons the site uses for filters.
- The AI icons sit in the composer and comment-box toolbars at the same size as the other icons there, and AI Reply looks like the Like and Reply links beside it.
- Everything follows dark mode and the colours set in the AdminCP, like the rest of the site.
Set up AI Assistant#
Last updated: 2026-11-19 · v1.1.0
After installing, everything is off. Do the steps in this order, so members never see a button that cannot work yet.
- Add a working API key for one of the AI services in AdminCP → Core Features → AI Features → Manage AI Providers (see Add or fill in a key in the ShaunSocial guide). You can use the same key as the chatbot, or a separate one so that you can follow each one's use.
- Open AdminCP → Site Settings → General Configuration → AI Assistant. In Select AI Platform do you want to use for AI Post Writing Assistant and in Select AI Platform do you want to use for AI Comment & Reply Assistant, pick the key for each assistant.
- Switch on AI Post Writing Assistant, AI Comment & Reply Assistant or both.
- Switch on AI Assistant, the main switch.
What you should see: after reloading the site, members see the AI Assist icon in the post composer and, for the comment assistant, the AI Comment icon in comment boxes and AI Reply under comments.
- Check the permissions and the daily limit of each member role (see Permissions and the daily limit), then try a draft yourself.
The AI service lists also offer the empty Default Key of each provider. If an assistant is switched on with no service picked, or with a key that does not work, members still see the buttons, but every draft ends with "… isn't configured. Please contact the site admin." or "Something went wrong …". A failing key is also marked Error after three failures in a row (see Health, errors and deleting a key).
For a post: the topic the member typed. For a comment or reply: the text of the post, up to the five most recent comments with up to two replies each, together with the names of the people who wrote them, the comment being answered, and the member's note if they wrote one. Long texts are shortened first. Mention this in your privacy policy, as for the other AI Features.
Switching it off or removing it#
Last updated: 2026-11-19 · v1.1.0
- To stop the assistant for a while, switch off AI Assistant in the settings (see The settings), or click Disable in the plugin manager. Posts, comments and replies written with its help are ordinary posts, comments and replies: they stay either way.
- Uninstall in the plugin manager removes the settings, the permissions and the record of how many drafts each member made. It cannot be undone (see Uninstall a plugin). The AI keys belong to ShaunSocial's AI Features and are not touched.
Change log#
Last updated: 2026-11-19 · v1.1.0
| Date (GMT+7) | Section | What changed |
|---|---|---|
| 2026-11-19 | install, set-up | New page. Its sections were moved here unchanged, with links to other pages updated: "Install and switch it on" (from the home page); "Set up AI Assistant" (from the former page "Set up and use AI Assistant"). |
| 2026-11-19 | install | First version for AI Assistant 1.1.0, written from the 1.1.0 code. The install and upgrade steps were read from the code, not run. |
| 2026-11-19 | set-up | First version for AI Assistant 1.1.0, written from the 1.1.0 code. No draft was made against a real AI service: the drafts, the daily limit and the messages were read from the code, not run. The member screenshots show the assistants switched on in the browser on a demo site without an AI key, before the first draft. |
| 2026-11-19 | all | Pages reorganised: AdminCP content now has its own pages. |
| 2026-11-19 | install, set-up, remove | Section order: setting up now comes before switching off. |