# 🚀 AMATUM H1 Optimizer

KI-gestützte H1-Überschriften für besseres SEO – direkt in WordPress
Version 1.0 | Kostenlos | Für WordPress 6.7+

## 📌 Kurzbeschreibung

Der AMATUM H1 Optimizer ist ein leichtgewichtiges WordPress-Plugin, das SEO-optimierte H1-Überschriften aus deinem Seiten- oder Beitragstext generiert. Mit Hilfe von KI (DeepSeek / OpenRouter) erhältst du drei maßgeschneiderte Vorschläge – per Klick übernommen. Optional: Automatische Permalink-Anpassung inklusive 301-Weiterleitung.

Perfekt für: Content-Creator, SEOs, Redakteure und Agenturen, die Zeit sparen und bessere Rankings erzielen wollen.

## ✨ Hauptfunktionen auf einen Blick

#### 🤖 KI-gestützte H1-Generierung

Analysiert deinen Seiteninhalt und liefert 3 SEO-optimierte H1-Vorschläge.

#### ⚡ 1-Klick-Übernahme

Wähle eine Überschrift aus – sie wird sofort in den Titel übernommen.

#### 🔗 Automatische Permalink-Optimierung

Optional: Passt die URL automatisch an die neue H1 an.

#### 🔄 301-Weiterleitungen

Erstellt automatisch eine Weiterleitung von der alten zur neuen URL (SEO-sicher!).

#### 📦 Backup-Funktion

Speichert die originale H1 für spätere Wiederherstellung.

#### 🔌 Kompatibel

Mit Rank Math, Yoast, Elementor, WooCommerce, WPML.

## 🎯 Für wen ist das Plugin?

Zielgruppe | Vorteil
--- | ---
Blogger & Redakteure | Spart Zeit bei der Titel-Findung, verbessert die Klickrate
SEO-Agenturen | Automatisiert H1-Optimierung für viele Seiten
Online-Shop-Betreiber (WooCommerce) | Optimiert Produkt- und Kategorieseiten
Entwickler & Designer | Lässt sich per Hooks & Filters erweitern
Agenturen & Freelancer | Professionelles Tool für Kundenprojekte

## 🔧 Technische Details

Anforderung | Wert
--- | ---
WordPress-Version | 6.7 oder höher
PHP-Version | 8.0 oder höher
KI-API | OpenRouter (kostenloser Key inkludiert)
Mehrsprachigkeit | Deutsch, Englisch
Deinstallation | Löscht alle eigenen Daten (optional)

## 📥 Installation (in 3 Schritten)

1. Plugin herunterladen – über WordPress.org oder als ZIP von amatum.com
2. Hochladen & aktivieren – unter `Plugins → Installieren → Hochladen`
3. API-Key prüfen – unter `Einstellungen → H1 Optimizer` (Standard-Key ist hinterlegt)

✨ Fertig! Der Button erscheint automatisch im Beitrags- und Seiten-Editor.

## 🧪 Beispiel aus der Praxis

Ausgangslage: Eine Seite über "Workforce AI" mit 800 Wörtern Inhalt.

Vorschläge des Plugins:

- Workforce AI Plattform – Der komplette Leitfaden 2026
- TALEMAI im Einsatz: Skill-Gaps analysieren & schließen
- Workforce Intelligence für HR-Teams: So gelingt die Transformation

Ergebnis: Der Nutzer wählt Vorschlag 2, der Permalink wird von `/workforce-ai` zu `/talemai-skill-gaps-analyze` geändert – eine 301-Weiterleitung sorgt dafür, dass alte Links nicht brechen.

## ⚙️ Einstellungen (Admin)

Option | Standard | Beschreibung
--- | --- | ---
API-Key | Standard-Key | Kann durch eigenen OpenRouter-Key ersetzt werden
Permalink anpassen | ✅ An | Im Popup vorausgewählt
301-Weiterleitung | ✅ An | Wird bei jeder Permalink-Änderung erstellt
Manuelle Titeländerung | ❌ Aus | Vorsicht: Ändert Permalink bei jeder manuellen Titel-Änderung

## 🧩 Hooks & Filter für Entwickler

    <?php
    // Prompt für KI anpassen
    add_filter( 'amatum_h1_prompt', function( $prompt, $content ) {
        return "Erstelle 3 H1 für: " . $content;
    }, 10, 2 );

    // Eigene KI-API nutzen
    add_filter( 'amatum_h1_api_url', function() {
        return 'https://meine-api.de/chat';
    } );

    // Nach H1-Update
    do_action( 'amatum_h1_after_update', $post_id, $new_h1 );
    ?>

## ❓ FAQ

Brauche ich einen eigenen API-Key?
Nein, ein kostenloser Standard-Key ist bereits hinterlegt. Du kannst aber jederzeit deinen eigenen OpenRouter-Key eintragen.

Werden auch bestehende Seiten optimiert?
Ja, das Plugin funktioniert auf allen Seiten und Beiträgen – auch nachträglich.

Was passiert mit alten Permalinks?
Bei Aktivierung der Option erstellt das Plugin automatisch eine 301-Weiterleitung – SEO-sicher!

Ist das Plugin mit Elementor kompatibel?
Ja, Elementor speichert Titel und Inhalt in den WordPress-Standardfeldern, daher funktioniert es einwandfrei.

## 📦 Download & Support

- Download: https://wordpress.org/plugins/amatum-h1-optimizer (bald verfügbar)
- Hersteller-Website: https://amatum.com/h1-optimizer-for-wordpress
- Support: https://amatum.com/support (kostenlos)