# LLMO Schema Markup Generator

WordPress-Plugin für WooCommerce um AI-optimierte Produktbeschreibungen als Schema.org Markup für Crawler auszugeben.

## Zweck

Dieses Plugin liest die von **LLMO Ready SaaS** generierten AI-optimierten Produktbeschreibungen und gibt sie als **Schema.org JSON-LD Markup** aus.

**Ergebnis:** Deine Produkte werden besser von generativen KI-Systemen gefunden:
- ChatGPT
- Google SGE (Search Generative Experience)  
- Perplexity
- Claude
- Andere LLMs

## Installation

### Methode 1: Upload via WP Admin

1. ZIP erstellen:
```bash
cd /Users/mag/Documents/GitHub/llmo/wordpress-plugin
zip -r llmo-schema-markup.zip llmo-schema-markup/
```

2. WordPress Admin → **Plugins** → **Installieren** → **Plugin hochladen**
3. `llmo-schema-markup.zip` auswählen und installieren
4. Plugin aktivieren

### Methode 2: FTP/SSH

```bash
# Per SSH
scp -r llmo-schema-markup/ user@server:/path/to/wordpress/wp-content/plugins/

# Dann in WP Admin aktivieren
```

## Wie es funktioniert

1. **LLMO Ready SaaS** publiziert Knowledge Packs zu WooCommerce
2. Custom Fields werden gespeichert:
   - `_llmo_description_ai` - AI-optimierte Beschreibung
   - `_llmo_title_ai` - AI-optimierter Titel
3. **Dieses Plugin** liest diese Fields auf Produktseiten
4. Generiert automatisch Schema.org JSON-LD im `<head>`
5. **Crawler sehen das Markup** - User sehen die normale Seite

## Was wird ausgegeben

Beispiel Schema.org Markup:

```html
<!-- LLMO Schema Markup for AI Crawlers -->
<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Enzyklopädie der Cannabiszucht",
  "description": "Die 'Enzyklopädie der Cannabiszucht' ist das ultimative Handbuch für...",
  "image": "https://example.com/image.jpg",
  "sku": "16204",
  "brand": {
    "@type": "Brand",
    "name": "Nachtschatten Verlag"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/product/...",
    "priceCurrency": "EUR",
    "price": "12.50",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "23"
  }
}
</script>
<meta name="llmo-optimized" content="true" />
<!-- /LLMO Schema Markup -->
```

## Features

- **Automatisch:** Kein manuelles Setup pro Produkt nötig
- **Nicht-invasiv:** Ändert nichts an der Website-Darstellung
- **Fallback:** Nutzt Original-Content wenn keine AI-Version vorhanden
- **Vollständig:** Inkl. Preis, Verfügbarkeit, Ratings, Bilder
- **Admin-Interface:** Statistiken unter WooCommerce → LLMO Schema
- **Validierbar:** Kompatibel mit Google Rich Results Test

## Testing

### 1. Seitenquelltext prüfen

Produktseite öffnen → Rechtsklick → "Seitenquelltext anzeigen" → Suche nach "LLMO Schema Markup"

### 2. Google Rich Results Test

https://search.google.com/test/rich-results

Deine Produkt-URL eingeben → Schema wird validiert

### 3. Schema.org Validator

https://validator.schema.org/

Deine Produkt-URL eingeben → Vollständige Validierung

## 📊 Admin Interface

Nach Aktivierung: **WooCommerce → LLMO Schema**

Zeigt:
- Anzahl optimierter Produkte
- Test-Link zu Beispielprodukt
- Validierungs-Tools
- How-it-works Erklärung

## 🔄 Workflow

```
LLMO Ready SaaS
    ↓
Knowledge Pack generieren
    ↓
Zu WooCommerce publizieren
    ↓
Custom Fields gespeichert (_llmo_*)
    ↓
Dieses Plugin liest Fields
    ↓
Schema.org Markup im <head>
    ↓
AI-Crawler finden deine Produkte!
```

## Technische Details

- **WordPress:** 6.0+
- **PHP:** 8.0+
- **WooCommerce:** Required
- **Custom Fields:** `_llmo_description_ai`, `_llmo_title_ai`
- **Output:** Schema.org JSON-LD
- **Hook:** `wp_head` (Priority 10)

## Debugging

Falls Markup nicht erscheint:

1. **WooCommerce installiert?**
```bash
wp plugin list | grep woocommerce
```

2. **Custom Fields vorhanden?**
```sql
SELECT post_id, meta_key, meta_value 
FROM wp_postmeta 
WHERE meta_key LIKE '_llmo%' 
LIMIT 10;
```

3. **Plugin aktiv?**
```bash
wp plugin list | grep llmo-schema
```

4. **Caching disabled?**
Clear all caches (WP Rocket, W3 Total Cache, etc.)

## Changelog

### Version 1.0.0 (2025-10-05)
- Initial release
- Automatic Schema.org JSON-LD generation
- Admin interface with statistics
- Fallback to original content
- Full WooCommerce integration

## Support

- **Website:** https://llmoready.com
- **Email:** support@llmoready.com
- **Documentation:** https://llmoready.com/documentation.html

## License

GPL v2 or later
