Support

Documentation

5.Using in your editor

5.Using in your editor

When and where you will see the AI button

AITiny inserts an AI button to your site's TinyMCE or JCE editor, wherever this editor appears. This means that you will see it not just when editing content (articles), but anywhere you edit anything using the WYSIWYG editor. This includes, for example, banner descriptions, categories, contacts information, and any third party developer software editing content using the editor.

For information on when and where the button appears, please refer to the relevant documentation section.

The AI Generate feature

This option allows you to generate new text using the AI service. The current selection is used as the prompt to the AI service. If nothing is selected, then the current node (the rightmost tag shown in the breadcrumbs at the bottom of the editor) will be used instead.

If you are using the Streaming option (default) you will see a dialog with the AI service's response. At the end of the AI service generating a response you will be given the option to insert the text (replacing the selection), or copy it to the clipboard. Please note that copying to clipboard is only available on browsers released after February 2025, and only for sites being accessed over HTTPS – these restrictions are put in place by the browsers themselves, not us. To paste the text copied to the clipboard please make sure the deselect (remove the checkmark) in the Edit, Paste As Text menu item in your editor.

If you are not using the Streaming option, the generated text will replace the selection. If you don't like the results you can click on the Undo button, or click on the Edit, Undo menu item on the editor's menu.

The writing tools features

There are four feature we collectively call the writing tools. The following describes their default behaviour; please remember that you can change their behaviour by changing their System Prompt in the plugin's options.

Proofread will correct any grammar or spelling mistakes, trying to keep your text as close to the original as possible.

Friendly will rewrite your content in a more friendly, casual tone. The results may vary widely depending on the AI service and model you use. We have found that some models (e.g. Microsoft's Phi) tend to be a bit too enthusiastic and / or sound very artificial (think of the “hello, fellow kids” meme from Two And A Half Men).

Professional will rewrite your content in a more professional tone. We have observed that this tends to also make your text a bit more compact and occasionally miss the more nuanced points which might have to be reintroduced manually.

Concise will rewrite your content in a more compact manner. It's not summarisation, it's not turning it into an abstract, and it's not turning it into bullet points. It tries to keep the main points intact, throwing away everything else, and keeping a similar tone of voice.

The default settings for these tools work fairly well in a variety of source material. If the results are not very satisfactory for your use case, try changing the system prompt, giving the generative AI more context to work with. This is imperative if you are writing content for a business niche which uses its own vernacular.

The “Custom…” feature

Many times you'll find yourself having to tell the generative AI to perform an action on a piece of content that is not described by the aforementioned writing tools. This is where the Custom… feature comes in.

Select some content and click on AI, Custom… to open a modal dialog with a Prompt textbox. Enter your instructions in that textbox and click on the Send button. You can optionally change the tone of voice by selecting a different option from the Tone drop-down.

The system prompt, your prompt, and the selected text will be sent to the generative AI which will try to follow your instructions. The results will be shown in the AI Response area below.

If you would like to insert that into your editor, replacing your selection, use the Apply button. Otherwise, just click the dialog by clicking the circled X mark found at its top right corner.

When the AI comes back with a result you can do one of several actions:

  • Accept. Inserts the contents of the AI Response area into your text editor, overwriting the selected text.

  • Copy to Clipboard. Copies the contents of the AI Response area into your clipboard.

  • Try Again. Clears the conversation and starts over. This is just like closing the dialog box, selecting the same text, and clicking on Custom... again.

  • Continue Conversation. Clears the prompt, but remembers the conversation so far. This lets you enter a new prompt to further refine the AI response. This works exactly like an AI chat; the AI is given the previous parts of your conversation as context. You could, for example, use this feature to say something like "Make the introduction paragraph shorter. Expand the section on security and privacy controls. Use a more assertive tone".

    When you use this feature, you can see the previous prompts and responses under the new Conversation area which appears at the top of the dialog. Left aligned blue bubbles are your prompts, right aligned green bubbles are the AI responses.

Here are some examples of actions you can use with this powerful tool.

“Translate the following text to German.” This will have the generative AI translate the selection into German. We have found that the Aya Expanse model is very good at translating text, with only minor changes needed for some awkward words that don't translate very well.

“Give me the top five key points as bullet points.” Have the generative AI give you the main points in an easily digestible format. This can come in handy when you need to include a TL;DR / executive summary of a longer article in your site. This works best with a succinct tone of voice, e.g. Concise & Direct.

“Write an abstract of the following article. Keep it strictly under 30 words.” Create an abstract. Note that the generative AI tends to overshoot the target word count, so do tell it to aim lower than your intended target word count. Best use the None option as your tone of voice.

“Create a title for the following article.” Got stuck trying to make a decent title for your article? Generative AI to the rescue! Add “Make it click-bait.” if your paycheck is more important than your moral compass (no judgement; you gotta do what you gotta do to make a living).

"Suggest a comma-separated list of up to ten keywords for the following article". Copy the results and paste them into the Meta Keywords field in Joomla.

“Rewrite the following text for first grade reading level.” When you need to actually ELI5 (Explain Like I'm Five), or when you're authoring content meant for young kids. The result will probably exceed a first grader's reading level, but it makes for an excellent starting point to manually work your way through it.

"Does the following article contain any objectionable content or language? Give me a single word reply." Quick and dirty moderation, especially if you're not fluent in that language. You can customise the prompt to suit your editorial needs.

Your custom actions

If you have defined any custom actions they will appear below the built-in features. If you are wondering what you can use as a custom action, your best candidates would be the custom prompts you find yourself coming back to time and time again. You can even play with the temperature and top_p settings to find a balance between accurate and creative. Just keep in mind that the more creative you ask generative AI to be, the more likely it is that it will lie confidently to you. After all, it can't think; it cannot understand the difference between more creative wording and outright lying to your face. As far as the statistical model goes, both are the same: more random, less probable. It's your job, as a human, to understand the nuance between the two.