User Manual for the AI Writer Module

💬 Floating bubble on all pages

Once the module is installed and configured (see the Installation and Configuration section at the end of this guide), a clickable bubble will appear in the bottom right corner of all Dolibarr pages.

This bubble is the gateway to the AI assistant's functions.

✏️ Text selection mode

When you click the bubble, the page will enter selection mode, applying a faint color to the background.
As you move the cursor, editable elements containing text will be highlighted, including:

• Single-line text boxes (forms).
• Multi-line text areas (textarea in forms).
• Content within rich editors like CKEditor (e.g., in notes or emails).
• Visible texts on screen: titles, paragraphs, list items, etc.

👉 Clicking on one of these elements will open the transformation dialog box for the selected text.

⚙️ Text transformation options

• The dialog box offers multiple text enhancement and formatting options.
• You can select a predefined transformation or write a custom instruction.

Predefined transformation types

• ✨ Improve writing — corrects grammar and style.
• 🌍 Translate to another language — select desired language and tone.
• ✂️ Summarize — creates brief and clear versions.
• 📈 Extend or expand — develops ideas or adds more context.
• 🤓 Simplify technical language — useful for complex texts or non-specialized audiences.
• 👔 Make more formal — ideal for reports or executive emails.
• 💬 Make more casual — for informal messages or social media.
• ⚙️ Custom instruction — freely combine any adjustments (see next section).

Available predefined languages

• The module includes direct translation to: English, French, Spanish, German, Italian, Portuguese, Catalan, Dutch, Russian, Chinese, and Japanese.
• 📌 If you need another language, select the Custom instruction option and indicate it manually.

Additional options

• Emojis: automatically inserts them at the beginning or end of each paragraph. 
  Perfect for social media, messaging, or modern emails.
• Hashtags: generates tags (#) at the beginning, end, or interspersed in the text.
  Very useful for posts on LinkedIn, X, or Instagram.

Custom transformation

• The "Custom instruction" transformation unleashes the full potential of AI.
• It allows you to write any natural prompt, combining actions or rules according to your needs.

Usage examples:

• "Summarize in a single paragraph, and in Hungarian."
• "Correct grammatically, simplify technical terms, and add an apology for the delay."
• "Exclude non-technical items from the list, keep only financial ones, and draft in basic English."

This option is ideal for advanced writers or specialized tasks where every word matters.

Installation process

First, as usual when installing any Dolibarr module:

1. Go to the Configuration section
2. Go to Modules
3. Go to the Install external module tab, and there you upload the module ZIP or its update
4. Return to the Available modules tab
5. Filter by Origin: "External - IMASDEWEB"
6. Activate the module

Configuration and integration with AI providers

1. Enter the "API key" for at least one of the providers
2. After saving changes, you must select the LLM model from that provider you want to use by default.

Note:

• You must obtain the API key from the provider's platform; it is usually pay-per-use, typically you add credit to your account with them (starting with $5 USD is enough)
• Sometimes when adding the provider's key in the module configuration, its models are not activated. In this case, simply refresh the page
• In the future, it is planned to add the possibility to choose different models and/or LLM providers for different tasks, because some types of transformation are quite simple to process and any model/provider can perform them at a very minimal cost, but some transformation processes require using a more expensive model to achieve healthier results. That is, sometimes we need a "mediocre" translation for ourselves, but other times we need it to be excellent (to publish or send to a client). Therefore, being able to choose the model/provider to use in each case, savings can easily be 4-10x !!

💎 Benefits of the AI Writer module