Troubleshooting & Best Practices for AI Writer

1. Sidebar Not Showing #

If the Davix AI Writer sidebar doesn’t appear:

1. Pro License
   • Confirm you have a Pro license active. Without Pro, aiWriter.php returns early and the module is disabled.
2. Role Access
   • Go to Davix AI Engine → AI Writer and confirm your role is allowed in davix_aiwriter_settings.
3. Capability
   • Ensure you can edit the post.
4. Caches
   • Docs explicitly say:
     • “Clear editor and browser caches after enabling AI Writer to ensure assets load.”

2. Requests Failing or Returning Errors #

Docs recommend:

• Turn on Debug Logs for AI Writer:

Step-by-step:

1. Go to Davix AI Engine → Debug Logs.
2. Enable debug_aiwriter_enabled.
3. Save.
4. Reproduce the issue:
   • Open editor, trigger a draft/rewrite.
5. Return to Debug Logs and click View log.
6. Inspect the AI Writer log for:
   • REST errors.
   • OpenAI API errors.
   • Permission issues.

3. Insert Behavior Not Doing What You Expect #

If AI-generated text is appearing in unexpected places:

1. Check the post’s per-post overrides:
   • _davix_aiwriter_overrides.insert_behavior.
2. Adjust the insert behavior in the AI Writer sidebar’s post settings panel, if exposed.
3. Save the post and try again.

4. Tokens, Length, and Cost Control #

Docs define both global token limits and per-post max_tokens + target_length.

Good practice:

• Use a reasonable global max tokens.
• For large posts where you need more detail:
  • Increase only that post’s max_tokens.
• For short snippets:
  • Lower max_tokens and target_length per post to avoid over-generation.

5. Security & Role Restrictions #

Docs advise:

• “Restrict AI Writer to necessary roles only (e.g., editors & admins).”

This prevents:

• Overuse by many contributors.
• Inconsistent AI content produced by users who may not understand brand/tone.

6. Media Helper Issues #

If image/alt-text helpers are not visible:

1. In Davix AI Engine → AI Writer:
   • Ensure media helper flags are enabled.
2. Confirm that:
   • class-davix-image-controller.php is loaded (Pro active).
3. Use Debug Logs if requests to image endpoints fail.

image IMAGE PLACEHOLDER: Screenshot of Debug Logs with the AI Writer channel enabled, showing example entries for AI Writer requests. IMAGE image