PHPackages                             codematic/shopware6-inci - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. codematic/shopware6-inci

ActiveShopware-platform-plugin

codematic/shopware6-inci
========================

Cosmetic ingredients database plugin for Shopware 6

1.0.3(8mo ago)00MITPHP

Since Sep 7Pushed 8mo agoCompare

[ Source](https://github.com/flytomek/shopware-inci)[ Packagist](https://packagist.org/packages/codematic/shopware6-inci)[ RSS](/packages/codematic-shopware6-inci/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

CodematicInci Plugin
====================

[](#codematicinci-plugin)

A comprehensive Shopware 6 plugin for managing cosmetic INCI (International Nomenclature of Cosmetic Ingredients) with AI-powered content generation using OpenAI's ChatGPT.

Features
--------

[](#features)

### 📋 INCI Ingredient Management

[](#-inci-ingredient-management)

- Complete ingredient database with detailed information
- Support for both English and Polish names
- Alternative names, CAS numbers, and technical data
- Safety ratings and origin classification (Natural/Synthetic)
- Main functions categorization

### 🤖 AI-Powered Content Generation

[](#-ai-powered-content-generation)

- Automatic description generation using OpenAI ChatGPT
- Safety information with scientific backing
- Rating system (Good/Average/Bad) with explanations
- Technical field population (CAS numbers, alternative names, etc.)
- Configurable prompts through admin panel

### 🌐 Frontend Display

[](#-frontend-display)

- **Listing Page** (`/inci`) - Alphabetical ingredient list with table of contents
- **Detail Pages** (`/inci/{slug}`) - Complete ingredient information
- Responsive design with clean, professional layout
- SEO-optimized with proper meta tags and structured data
- Multi-language support (English, Polish, German)

### 🛠️ CLI Management

[](#️-cli-management)

Complete command-line interface for ingredient management:

- `codematic:inci:add "Name"` - Add new ingredient
- `codematic:inci:generate "Name"` - Generate AI content
- `codematic:inci:show "Name"` - Display all ingredient details
- `codematic:inci:remove "Name"` - Remove ingredient
- `codematic:inci:clear [--force]` - Remove all ingredients

Installation
------------

[](#installation)

1. **Download** the plugin to `custom/plugins/CodematicInci/`
2. **Install** the plugin:

```
bin/console plugin:refresh
bin/console plugin:install --activate CodematicInci
```

3. **Run migrations**:

```
bin/console database:migrate --all CodematicInci
```

4. **Configure OpenAI** in `.env.local`:

```
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4.1
```

5. **Clear cache**:

```
bin/console cache:clear
```

Configuration
-------------

[](#configuration)

### Admin Panel Settings

[](#admin-panel-settings)

Configure all settings in **Settings &gt; Extensions &gt; CodematicInci**:

#### Meta Information

[](#meta-information)

- Meta title template with placeholders `{name}`, `{polishName}`
- Default meta description for ingredients without descriptions
- Listing page meta tags

#### Page Content

[](#page-content)

- Listing page title and description
- Empty list messages
- Content customization

#### AI Prompts (Fully Configurable)

[](#ai-prompts-fully-configurable)

- **Description Prompt** - Generate ingredient descriptions in Polish with HTML formatting
- **Safety Information Prompt** - Generate safety information based on scientific facts
- **Main Functions Prompt** - Categorize ingredient functions
- **Rating Prompt** - Assign safety ratings (1-3 scale)
- **General Fields Prompt** - Generate technical data (CAS, alternative names, etc.)

All prompts support placeholders like `{INGREDIENT_NAME}`, `{RATING}` and can be customized per sales channel.

Usage Examples
--------------

[](#usage-examples)

### Adding and Generating Content

[](#adding-and-generating-content)

```
# Add a new ingredient
bin/console codematic:inci:add "Pentylene Glycol"

# Generate all AI content for the ingredient
bin/console codematic:inci:generate "Pentylene Glycol"

# View complete ingredient details
bin/console codematic:inci:show "Pentylene Glycol"
```

### Viewing in Frontend

[](#viewing-in-frontend)

- **All ingredients**: `https://yoursite.com/inci`
- **Specific ingredient**: `https://yoursite.com/inci/pentylene-glycol`

Database Schema
---------------

[](#database-schema)

The plugin creates a `codematic_inci` table with the following fields:

FieldTypeDescription`id`UUIDPrimary key`name`VARCHARIngredient name (required)`slug`VARCHARURL-friendly slug (required)`polish_name`VARCHARPolish translation`alternative_names`TEXTComma-separated alternative names`cas_number`VARCHARChemical Abstracts Service number`description`TEXTHTML-formatted description`main_functions`TEXTComma-separated functions`safety_information`TEXTHTML-formatted safety info`rating`INTSafety rating (1=Good, 2=Average, 3=Bad)`resources`TEXTComma-separated URLs`natural`BOOLEANNatural vs synthetic origin`active`BOOLEANVisibility flag`created_at`DATETIMECreation timestamp`updated_at`DATETIMELast modificationFrontend Features
-----------------

[](#frontend-features)

### Listing Page

[](#listing-page)

- **Alphabetical navigation** - Quick jump to any letter
- **Simple list layout** - Clean, scannable format
- **Ingredient preview** - Name, Polish name, main functions, safety rating
- **Responsive design** - Works on all devices

### Detail Page

[](#detail-page)

- **Complete information display** with proper HTML formatting
- **Safety rating** prominently displayed with color coding
- **Information table** - Name, Polish name, CAS number, origin, functions
- **Additional resources** as clickable links
- **SEO optimization** - Proper meta tags, Open Graph, JSON-LD structured data

### CSS Classes for Customization

[](#css-classes-for-customization)

- `.inci` - General INCI container
- `.inci-listing` - Listing page specific
- `.inci-detail` - Detail page specific
- `.rating-indicator` - Safety rating badges
- `.rating-indicator-small` - Smaller rating badges for listings

Technical Details
-----------------

[](#technical-details)

### Architecture

[](#architecture)

- **Shopware 6 Plugin Structure** - Follows Shopware best practices
- **Entity System** - Uses Shopware's Data Abstraction Layer (DAL)
- **Service Pattern** - OpenAI integration through dedicated service
- **Command Pattern** - CLI commands for management
- **Page Loader Pattern** - Proper meta information handling

### OpenAI Integration

[](#openai-integration)

- **Configurable models** - Support for GPT-4.1, o1, o3, etc.
- **Error handling** - Retry logic with exponential backoff
- **Parameter optimization** - Different parameters for different models
- **Logging** - Comprehensive error and debug logging

### Multi-language Support

[](#multi-language-support)

- **Snippet system** - All UI text translatable
- **Currently supported**: English, Polish, German
- **Easy to extend** for additional languages

Development
-----------

[](#development)

### File Structure

[](#file-structure)

```
src/
├── Command/                 # CLI commands
├── Core/Content/Inci/      # Entity definitions
├── Migration/              # Database migrations
├── Resources/
│   ├── config/            # Services and configuration
│   ├── snippet/           # Translations
│   └── views/             # Twig templates
├── Service/               # Business logic services
└── Storefront/            # Frontend controllers and page loaders

```

### Extending the Plugin

[](#extending-the-plugin)

1. **Add new fields** - Extend `InciDefinition` and create migration
2. **Customize prompts** - Modify prompts in admin configuration
3. **Add languages** - Create new snippet files
4. **Styling** - Use `.inci`, `.inci-detail`, `.inci-listing` CSS classes

Requirements
------------

[](#requirements)

- **Shopware 6.4+**
- **PHP 8.1+**
- **OpenAI API access**
- **MySQL/MariaDB**

Support
-------

[](#support)

For issues, feature requests, or contributions, please refer to the project documentation or contact the development team.

License
-------

[](#license)

This plugin is proprietary software developed for specific use cases. Please refer to the license terms provided with your copy.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance61

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

245d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/41d79a22afff807f59bfff13453545b918b3540b1e8504a58dda64e2474c5cea?d=identicon)[flytomek](/maintainers/flytomek)

---

Top Contributors

[![flytomek](https://avatars.githubusercontent.com/u/37069663?v=4)](https://github.com/flytomek "flytomek (4 commits)")

### Embed Badge

![Health badge](/badges/codematic-shopware6-inci/health.svg)

```
[![Health](https://phpackages.com/badges/codematic-shopware6-inci/health.svg)](https://phpackages.com/packages/codematic-shopware6-inci)
```

###  Alternatives

[shopware/storefront

Storefront for Shopware

684.2M148](/packages/shopware-storefront)[shopware/administration

Administration frontend for the Shopware Core

413.9M75](/packages/shopware-administration)[shopware/production

178190.0k](/packages/shopware-production)[frosh/tools

Provides some basic things for managing the Shopware Installation

79709.7k2](/packages/frosh-tools)[shopware/elasticsearch

Elasticsearch for Shopware

153.6M8](/packages/shopware-elasticsearch)[kiener/mollie-payments-plugin

Mollie Payments

6257.6k](/packages/kiener-mollie-payments-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
