Using AI Writer in the Gutenberg Editor (Editor Flow)

1. Opening the Block Editor with AI Writer #

Docs say:

1. Open any post or page in the block editor.
2. If:
   • You have permission to edit the post.
   • Your role is allowed in AI Writer settings.
3. The Davix AI Writer sidebar is available.

Step-by-step:

1. In the WordPress admin, go to Posts → Add New or Pages → Add New, or edit an existing item.
2. The Gutenberg editor loads.
3. Open the sidebar (if it’s a panel/tab, you might see a “Davix AI Writer” icon or label in the editor’s right-side panel selector).
4. Click Davix AI Writer to show its controls.

image IMAGE PLACEHOLDER: Screenshot of Gutenberg with the settings/inspector panel open, showing a tab or panel titled “Davix AI Writer” on the right side. IMAGE image

2. Drafting New Content #

From the docs:

• The sidebar lets you request new drafts for posts and pages.

Typical flow (as described):

1. In the Davix AI Writer sidebar, you’ll see fields/buttons to:
   • Describe what you want (e.g., a topic or short brief).
   • Trigger AI drafting.
2. When you click the Draft or similar action, AI Writer:
   • Uses the selected model, temperature, tone, and token limits from global + per-post settings.
   • Sends a request to its REST endpoint (davix-ai-writer/v1).
   • Returns draft content.
3. The sidebar then:
   • Inserts or offers to insert this draft into the editor (exact behavior is controlled by “insert_behavior” in per-post overrides).

3. Rewriting Existing Content #

Docs describe:

• You can rewrite existing content:
  • Make it shorter.
  • Make it more formal.
  • Make it SEO-friendly.
  • Change tone and length.

Step-by-step (editor perspective):

1. In the Gutenberg editor, select the text or block you want to improve.
2. Open the Davix AI Writer sidebar.
3. Choose a rewrite option:
   • For example, a dropdown or buttons like “Shorter”, “More formal”, “SEO-focused” (exact labels follow your UI, but this behavior is explicitly described).
4. Optionally adjust:
   • Tone.
   • Target length (per-post override).
5. Trigger the rewrite action.
6. AI Writer calls the /generate endpoint with:
   • The selected snippet.
   • Your chosen tone/length.
   • Model and token limits.
7. The returned text replaces or is offered to replace the original, depending on insert_behavior.

image IMAGE PLACEHOLDER: Screenshot of a paragraph selected in Gutenberg, with Davix AI Writer sidebar showing options like “Rewrite shorter”, “Rewrite more formal” and a visible result preview. IMAGE image

4. Changing Tone, Length, and Language #

Docs state:

• AI Writer can adjust tone, length, and language.

Based on your settings:

• Tone presets come from global settings (e.g., “formal”, “friendly”), with per-post overrides specifying the active tone.
• Target length is set per post using _davix_aiwriter_overrides.target_length.
• Default language can be specified per post in _davix_aiwriter_overrides.default_language to tell AI which language to use.

In practice:

1. In the sidebar, pick a tone (from presets).
2. Set a target length (short/medium/long or a numeric value based on your UI).
3. Make sure default language is set if you’re writing in something other than the site’s default.
4. Request draft/rewrite; AI Writer sends all these parameters in the request.

5. Using Image & Alt-Text Helpers #

Docs:

• AI Writer has optional media helpers:
  • Generate image ideas.
  • Suggest alt-text for images.

These helpers are controlled by:

• Global flags for image/alt-text tools in davix_aiwriter_settings.

Step-by-step:

1. Enable media helpers in Davix AI Engine → AI Writer settings (see next article).
2. In the editor, open the AI Writer sidebar.
3. For an image (or planned image):
   • Use the sidebar function to generate:
     • A description or prompt idea for your image.
     • Alt-text suggestions for accessibility and SEO.
4. Copy/paste the alt-text into the image block’s alt field.

image IMAGE PLACEHOLDER: Screenshot of AI Writer sidebar with a panel titled “Image & Alt-text helpers” showing suggested image prompts and an example alt-text. IMAGE image