AI Descriptions - Descriptions for Products and Categories

Released 2026-05-04

Added

• Anthropic Claude Support: generate descriptions and SEO content with Claude alongside OpenAI. New provider selector in plugin configuration (OpenAI / Anthropic). The shared API key field applies to the active provider.
• Dynamic Model List: the model dropdown is now populated by calling the active provider's /v1/models endpoint, with a refresh button to reload after switching providers or keys. No more hardcoded model options that go stale between releases.
• Structured Output Enforcement: generated content is now constrained by a response schema. OpenAI uses native Structured Outputs (response_format: json_schema, strict mode), Anthropic uses a forced tool call with input_schema. Eliminates stray code-fence wrapping and "Here is your description:" preambles.

Changed

• Plugin Label: renamed from "AI Descriptions - OpenAI Integration" to "AI Descriptions - OpenAI & Anthropic Integration" so the admin plugin list and store listing reflect both supported providers.
• Provider-Agnostic Naming: internal classes renamed for the multi-provider architecture. OpenAIController → AiController, OpenAiService → AiService, OpenAiConfigStruct → AiConfigStruct, admin JS service openAiService → aiProviderService. Only relevant if you have overrides referencing these classes.
• Retry Strategy: retryable HTTP failures now honour the provider's Retry-After response header (capped at 30 seconds) instead of a fixed linear delay.
• Database Lookups: product, category, and language fetches use Shopware's indexed primary-key path (new Criteria([$id])) instead of an EqualsFilter on id.

Fixed

• Translation lookup in description generation now returns the requested field instead of always returning the translated name.
• The "Test API" button no longer sends the saved organizationId header when verifying an unsaved key, preventing false-negative results when switching organizations.
• Connect/transport failures from the AI provider now produce clean status-coded errors in the admin notifications instead of generic 500s.

Removed

• Hardcoded model options in config.xml (replaced by the dynamic model select).
• output-format.html.twig and output-management.html.twig prompt templates (their output rules are now enforced by the response schema).

Added

  - SEO Generation: AI-powered generation of meta titles, meta

  descriptions, and keywords for products and categories

    - Preview modal with character count validation for optimal SEO lengths

    - Review and edit generated content before applying

    - Visual feedback for character limits (green/yellow/red indicators)

  - Writing Style Variants: Five different writing styles for content

  generation

    - Standard, Technical, Emotional, SEO-focused, and Luxury variants

    - Configurable default variant in plugin settings

    - Style selector in product and category forms

  - Modular Prompt System: Component-based prompt architecture

    - Reusable prompt components (shop-context, entity-data, constraints,

  output-format, examples)

    - Language-specific context templates (DE/EN)

    - Better structured prompts with clear sections

  - Custom Prompts: Additional instruction field for fine-tuning AI

  generation

  - API Retry Mechanism: Automatic retries with exponential backoff for

  transient API failures

  - New OpenAI Models: Support for GPT-4.1 variants, o3-mini and o4-mini

  reasoning models

  Changed

  - Shopware 6.7 Compatibility: Full compatibility update for Shopware 6.7

    - Updated dependencies and service configurations

    - Migrated build system from webpack to Vite

  - Default Model: Changed from gpt-3.5-turbo to gpt-4o-mini for improved

  performance

  - UI Improvements: Streamlined generation workflow

    - Moved "Generate All SEO" button to bottom of form

    - Modal opens immediately with loading overlay

    - Added sparkle icons to generation buttons

  - Administration Notifications: Updated to use Shopware's built-in

  notification mixin

  - Configuration Page: Improved spacing and layout

  Fixed

  - Category form variant selector initialization issues

  - Template variable references in category detail menu

  - Prompt variant passing to API endpoints

  - Various UI state management bugs in admin components

  Security

  - Prompt Injection Protection: New security layer with PromptSanitizer

  service

    - Detection and blocking of prompt injection attempts

    - Secure boundaries in templates for user-provided content

    - Comprehensive input validation with configurable limits

  - Security Settings: New configuration card for customizable validation

  limits

Compatibility with Shopware 6.6 established

Release of the plugin