# Ptero einrichten — Anleitung für deinen Coding-Agenten

> **So benutzt du diese Datei:** Leg sie in dein Projektverzeichnis und sag
> deinem Agenten: *„Halte dich an ptero-einrichten.md."* Das funktioniert mit Claude
> Code, Codex, Cursor, Cline und allem anderen, was Dateien lesen kann.
> Wenn dein Agent von selbst eine bestimmte Datei liest, kannst du sie auch
> in `AGENTS.md` umbenennen oder den Inhalt in deine `CLAUDE.md` kopieren.

**Projekt:** [github.com/aminkheddache-dotcom/Ptero](https://github.com/aminkheddache-dotcom/Ptero) · **Stand:** 2026-09-10 · Zusammengestellt von
[localdev.ai](https://localdev.ai/)

---

## Ziel

Ein WordPress-Plugin namens Ptero wird als lokal lauffähiges AI-Chat-Interface eingerichtet, das über einen Shortcode in WordPress eingebunden werden kann.

## Voraussetzungen

- WordPress-Installation
- PHP-fähiger Webserver
- FTP- oder Dateisystem-Zugang zum WordPress-Plugin-Verzeichnis `/wp-content/plugins/`
- Admin-Zugang zum WordPress-Backend für Plugin-Aktivierung

## Das fragst du mich, bevor du anfängst

- Hast du eine laufende WordPress-Installation und Admin-Zugang?
- Willst du das Plugin lokal entwickeln/testen oder auf einem Live-Server deployen?
- Hast du einen API-Schlüssel für einen der unterstützten AI-Provider (DeepSeek, Llama, Qwen, MiniMax, Mistral)? Die README erwähnt keine kostenlose API ohne Schlüssel für Self-Hosting.
- Soll der Agent das Plugin-Verzeichnis direkt bearbeiten oder ein Zip erstellen?
- Unter welchem Pfad liegt dein WordPress-Plugin-Verzeichnis? (z.B. `/var/www/html/wp-content/plugins/` oder lokal unter `~/Sites/wordpress/wp-content/plugins/`)

## Einrichtung

### 1. Plugin-Quelle klären

**Prüfen:** Nutzer hat Download-Link oder Repository-URL bestätigt

> ⚠️ README enthält inkonsistente Links: `https://github.com/aminkheddache-dotcom/Pterocos` im Text, aber `https://github.com/aminkheddache-dotcom/Ptero` im Kontakt-Link. Frage den Nutzer, welche URL korrekt ist.

### 2. Plugin herunterladen

**Prüfen:** ZIP-Datei oder geklontes Verzeichnis vorhanden

> ⚠️ Keine konkreten Download-Befehle im Material. Frage den Nutzer, ob er das ZIP selbst herunterlädt oder ob du einen `git clone` oder `curl`/`wget` ausführen sollst – nur nach Bestätigung der korrekten URL.

### 3. Plugin-Struktur prüfen

**Prüfen:** PHP-Dateien vorhanden, insbesondere eine Datei mit WordPress-Plugin-Header (Kommentarblock mit `Plugin Name:`)

> ⚠️ README gibt keine Dateistruktur an. Der Agent muss die Plugin-Hauptdatei selbst identifizieren, nachdem das Plugin verfügbar ist.

### 4. Plugin in WordPress installieren

**Prüfen:** Verzeichnis existiert unter `/wp-content/plugins/`

> ⚠️ Keine konkreten Kopierbefehle im Material. Pfade müssen vom Nutzer bestätigt werden. Kein `sudo` ohne Absprache.

### 5. Plugin in WordPress aktivieren

**Prüfen:** Plugin erscheint als aktiv in WordPress-Backend, keine Fehlermeldung

> ⚠️ Keine WP-CLI-Befehle im Material dokumentiert. Aktivierung über GUI oder WP-CLI nur nach Rückfrage beim Nutzer.

### 6. Shortcode testen

**Prüfen:** Seite lädt ohne Fatal Error, Chat-Interface wird gerendert (auch wenn API noch nicht konfiguriert)

> ⚠️ README erwähnt Shortcode `[mlp_ai_chat]` – der Name `mlp_` deutet auf mögliche Umbenennung oder alten Projektnamen hin. Prüfe nach Aktivierung, ob dieser Shortcode registriert ist oder ob ein anderer Name verwendet wird.


## Erster Test

Erstelle eine WordPress-Seite mit dem Shortcode und prüfe, ob das Chat-Interface geladen wird.

```python
[mlp_ai_chat]
```

## Wenn es klemmt

| Symptom | Ursache | Lösung |
|---|---|---|
| Plugin lässt sich nicht aktivieren oder zeigt Fatal Error | PHP-Version inkompatibel, fehlende Abhängigkeiten, oder Plugin-Hauptdatei nicht korrekt benannt | Prüfe PHP-Error-Log, identifiziere die Plugin-Hauptdatei (muss Name des Plugin-Ordners entsprechen oder explizit definiert sein), prüfe WordPress-Version |
| Shortcode `[mlp_ai_chat]` wird nicht erkannt, leere Ausgabe | Shortcode-Name abweichend oder Plugin nicht korrekt initialisiert | Suche in PHP-Dateien nach `add_shortcode`, prüfe registrierten Namen, vergleiche mit README-Angabe |
| Chat-Interface lädt, aber API-Antworten kommen nicht | Kein API-Schlüssel konfiguriert; README erwähnt 'free' und 'no signup required' für ptero.pro, aber nicht für Self-Hosting | Prüfe Plugin-Einstellungen auf API-Schlüssel-Feld; frage Nutzer nach Schlüssel oder ob Proxy/Weiterleitung auf ptero.pro genutzt werden soll |
| Inkonsistente Repository-Links | README verwendet `Pterocos` und `Ptero` durchmischt | Frage den Nutzer, welche URL korrekt ist; melde Inkonsistenz |

## Grenzen — das kann das Projekt nicht

- README beschreibt keine Self-Hosting-API-Konfiguration; 'kostenlos' bezieht sich auf ptero.pro, nicht notwendigerweise auf eigene API-Schlüssel
- Keine Dokumentation zur Datenbank-Installation oder zu Migrationen
- Keine Angaben zu PHP-Mindestversion oder getesteten WordPress-Versionen
- Keine CI/CD-Konfiguration oder automatisierte Tests dokumentiert
- Sprachanteil ist laut Metadaten 100% PHP, aber README nennt JavaScript/HTML/CSS-Frontend – möglicherweise verpacktes/minimiertes JS in PHP-Dateien oder Metadaten ungenau

## Regeln für dich als Agent

- Nur Befehle aus dem Material verwenden; keine WP-CLI-Annahmen ohne explizite Erwähnung
- Vor jedem Dateisystem-Zugriff oder Deployment den Zielpfad mit dem Nutzer bestätigen
- API-Schlüssel oder externe Dienst-Konfiguration nur nach expliziter Nutzerfreigabe eintragen
- Bei Inkonsistenzen (Repository-Name, Shortcode-Präfix) den Nutzer informieren und nicht selbst korrigieren
- Keine Annahmen über 'kostenlose' API-Nutzung treffen; ptero.pro ≠ Self-Hosting
- Plugin-Ordnerstruktur erst nach Download analysieren, nicht vorher spekulieren

---

### Wichtig

Diese Datei wurde aus der Liesmich-Datei des Projekts vom 2026-09-10
zusammengestellt und ist keine offizielle Dokumentation. Sie ersetzt nicht den
Blick in das Repository — wenn ein Befehl hier nicht funktioniert, gilt
[die Quelle](https://github.com/aminkheddache-dotcom/Ptero), nicht diese Datei.

*Erklärvideos und Merkblätter zu Werkzeugen wie diesem:
[localdev.ai](https://localdev.ai/m/) — ohne Anmeldung.*
