README

AI Product Extension for TYPO3

Description

The AI Product Extension is a powerful TYPO3 extension that leverages OpenAI's GPT technology to automatically generate product descriptions and image alt texts.

Key Features

• AI-Powered Content Generation: Automatically generate product descriptions using OpenAI GPT
• Smart Alt Text Generation: Create SEO-friendly alt texts for product images
• Multi-Language Support: Translate descriptions and alt texts to multiple languages
• Backend Module: User-friendly interface for managing AI-generated content
• Content Management: Review, edit, and approve AI-generated content before publishing
• Flexible Integration: Works with any TYPO3 product extension

Requirements

• TYPO3 CMS 13.4
• PHP 8.2 or higher
• OpenAI API Key
• Any product extension

Installation

Via Composer (Recommended)

composer require raphael-gmbh/ra_aiproduct

Configuration

1. Extension Configuration

Configure the extension in the TYPO3 backend under Settings > Extension Configuration > ra_aiproduct:

Required Settings

OpenAI Configuration

Set your OpenAI API key in the extension configuration or via environment variable:

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['ra_aiproduct']['openAiApiKey'] = 'sk-...';

Recommendation: Use environment variables for security:

# .env file
OPENAI_API_KEY=sk-your-api-key-here

2. Database Setup

After configuration, update the database schema:

# Via command line
typo3 database:updateschema

# Or via Backend
Maintenance > Analyze Database Structure

Usage

Backend Module

Access the AI Product Module from the TYPO3 backend navigation:

Web > AI Product Descriptions

Product List View

1. Select a folder containing products from the page tree
2. View all products
3. Search for specific products by UID

Product Detail View

For each product, you can:

1. Generate AI Description

   • Click "Generate Description" to create AI-powered product description
   • Review the generated content
   • Click "Write to Product" to apply the description to the product record (Changes have to be made in the original product record in list module)

2. Generate Image Alt Texts

   • View all product images
   • Click "Generate Alt Text" for individual images
   • Review and edit generated alt texts
   • Save alt texts to file references

3. Translate Content

   • Automatically translate descriptions to all product language versions
   • Translate alt texts to all product language versions

Language Support

The extension automatically detects available languages from your TYPO3 configuration and generates content in the appropriate language based on:

• Product language version (sys_language_uid)
• Site language configuration
• Available translations for the product

Best Practices

For Optimal Results

1. Product Information: Ensure products have basic information filled in the productFurtherInformationField - this helps the AI generate more accurate descriptions

2. Review Content: Always review AI-generated content before publishing to ensure accuracy and brand consistency

Credits

Developer: Dominik Siwenski Company: Raphael GmbH Website: https://www.raphael-gmbh.de

Made with ❤️ by Raphael GmbH