# Meerkat Markdown for AI Visibility – Version 5.0

Grundlage: das bereitgestellte Archiv `meerkat-plugin-4.3.zip`. Alle PHP-, JavaScript- und Konfigurationsdateien wurden geprüft. Vorhandene benannte Funktionen, Methoden, Einstellungen, Filter und Builder-Konverter bleiben erhalten. Die bestehenden Include-Pfade und der Plugin-Ordner `meerkat-plugin` bleiben kompatibel.

## Korrekturen nach Plugin Check

| Gemeldete Stelle | Korrektur |
| --- | --- |
| `phpcs.xml.dist`: `application_detected` | Die Entwicklungs-Konfiguration liegt außerhalb des Plugin-Ordners und ist nicht mehr im Installations-ZIP enthalten. |
| `includes/dynamic-md.php`: `post__not_in` | ID-Ausschlüsse werden mit der gemeinsamen Freigabeprüfung nach dem Abruf gefiltert. Weitere Batches füllen die eingestellte Anzahl, ohne ausgeschlossene Beiträge auszugeben. |
| `includes/generator.php`: `post__not_in` | ID-Ausschlüsse werden nach dem Batch-Abruf geprüft. Auch explizit an die vorhandene Methode übergebene Ausschlüsse bleiben wirksam. |
| `readme.txt`: `outdated_tested_upto_header` | `Tested up to: 7.1` nach bestandenem Integrationstest mit WordPress 7.1.3. Das Feld verwendet die von Plugin Check verlangte Hauptversion ohne Wartungsnummer. |
| `includes/content.php`: `NonPrefixedVariableFound` | Die betreffende Zuweisung stellt ausschließlich die zuvor gesicherten, fest aufgelisteten WordPress-Core-Globals wieder her. Dafür ist eine einzelne PHPCS-Ausnahme mit Begründung dokumentiert; es werden keine neuen Plugin-Globals erzeugt. |

## Umgesetzte Verbesserungen

### Sicherheit

- **Öffentliche Exporte im Gast-Kontext:** Inhaltsfilter und Shortcodes erhalten einen anonymen WordPress-Benutzer und keine persönlichen Cookies. Der passende globale Beitrag wird gesetzt. Benutzer, Cookies und Beitragsvariablen werden auch bei Ausnahmen wiederhergestellt.
- **Einheitliche Freigabeprüfung:** Veröffentlichungsstatus, öffentliche Erreichbarkeit, Passwortschutz und Ausschlüsse nach ID, Kategorie und Schlagwort gelten für `llms.txt`, Startseiten-Markdown, direkte Markdown-Adressen und Markdown-Sitemaps. Die Auswahl „Beiträge/Seiten“ und die Mindestlänge von 15 Wörtern steuern weiterhin nur `llms.txt`.
- **Erweiterbare Zugriffskontrolle:** `mrmrkdofa_is_exportable_post` kann weitere Inhalte sperren, etwa für eine Membership-Integration. Der Filter wird ebenfalls im Gast-Kontext ausgewertet und kann die grundlegenden Schutzregeln nicht aufheben.
- **Keine gemeinsam genutzten personalisierten Antworten:** Anmeldungen, Cookies, Authorization-Header und zusätzliche Query-Parameter verhindern die Nutzung des gemeinsamen Markdown-Caches. Versions- und Sprachkennung verhindern die Wiederverwendung alter Cache-Inhalte nach dem Upgrade.
- **HTTP-Zugangsdaten geschützt:** Basic Auth wird nur bei identischem Protokoll, Host und effektivem Port mitgeschickt. Weiterleitungen werden einzeln geprüft; beim Origin-Wechsel werden Zugangsdaten dauerhaft für diese Weiterleitungskette entfernt. Sichere WordPress-HTTP-Anfragen bleiben erhalten. Übergroße Antworten erzeugen einen Fehler.
- **XML-Verarbeitung gehärtet:** DTDs, Entity-Deklarationen, ungültige Wurzelelemente und fremde Sitemap-Namespaces werden zurückgewiesen. Externe XML-Netzwerkzugriffe bleiben gesperrt. Fremde Stylesheet-Anweisungen werden entfernt. Der vorherige libxml-Fehlermodus wird wiederhergestellt.
- **Rekursive Sitemap-Anfragen verhindert:** Dynamische Teilsitemaps müssen im überprüften Originalindex aufgeführt sein. Eigene Markdown-Sitemaps werden nicht erneut als Quelle abgerufen. Statische Teilsitemaps müssen zur Website-Origin gehören.
- **AJAX abgesichert:** Speichern und Generieren erfordern POST, passende Nonces und `manage_options`. Arrays anstelle von Nonces werden ohne PHP-Warnung abgewiesen. Eingaben durchlaufen die registrierten Settings-API-Sanitizer; Ausgaben bleiben kontextbezogen escaped.
- **Konkurrenzschutz:** Eine Datenbanksperre verhindert parallele Generierungen. Freigabe und Übernahme abgelaufener Sperren vergleichen den Eigentümer-Token. Vor der Veröffentlichung wird die Sperre nochmals geprüft.
- **Dateischutz:** Die Eigentümerschaft von `llms.txt` wird unmittelbar vor dem Schreiben nochmals geprüft. Fremde Dateien werden nicht überschrieben. Ungültige oder nicht erreichbare Teilsitemaps brechen den Export vor der Veröffentlichung ab. Die vorhandene Staging- und Rollback-Logik bleibt erhalten.

### WordPress-Konventionen und Zuverlässigkeit

- Einstellungen sind mit Typ, Sanitizer und deaktivierter REST-Freigabe registriert.
- Der Generieren-Button wartet auf einen bestätigten JSON-Erfolg beim Speichern. Anmelde- oder Fehlerseiten werden nicht mehr als erfolgreiche Einstellungsänderung gewertet.
- Neue Optionen werden über `added_option` ebenso berücksichtigt wie spätere Änderungen. Dadurch funktionieren Zeitpläne und Markdown-Rewrite-Regeln bereits beim ersten Speichern.
- Rewrite-Regeln werden bei Versions- oder Routenkonfigurationsänderungen einmalig aktualisiert; Apache-Konfiguration und Brotli-Einstellungen werden nicht verändert.
- Cron wird bei Änderungen der WordPress-Zeitzone neu geplant. Die nächste Ausführung wird vor der Generierung eingeplant. Monatslängen und lokale Uhrzeiten bleiben berücksichtigt.
- Zeitpunkt und Ergebnis der letzten Generierung werden auf der Einstellungsseite angezeigt, einschließlich Fehlern aus automatischen Durchläufen.
- Unbekannte, gesperrte und fehlerhafte Markdown-Anfragen liefern HTTP 404. Pretty-, einfache und `.html`-Permalinks wurden geprüft.
- Markdown unterstützt HEAD und ETag-basierte bedingte GET-Anfragen. Canonical-, Noindex- und Nosniff-Header bleiben vorhanden. Browser müssen standardmäßig revalidieren.
- XML-URLs mit Query-Parametern werden korrekt escaped. Yoast-Dateinamen bleiben bei dynamischen Sitemap-Umleitungen erhalten.
- Inline-Code mit mehreren Backticks erhält ausreichend lange Begrenzungen. Geordnete und ungeordnete Listen sind geprüft.
- Deinstallation bereinigt die neuen Optionen und tatsächlich vorhandene Markdown-Transient-Einträge. Fremde `llms.txt`-Dateien bleiben erhalten.
- Plugin-Header, Laufzeitkonstante, Asset-Version, Readme und Übersetzungsvorlage führen Version 5.0. Die Readme nennt die tatsächlich geprüfte WordPress-Version.

### Performance

- Die Inhaltsabfrage lädt vollständige Beitragsobjekte pro Batch einschließlich Metadaten- und Taxonomie-Cache. Einzelne Nachladeabfragen pro Beitrag werden vermieden.
- Passwortschutz wird bereits in der Datenbankabfrage berücksichtigt. ID-Ausschlüsse werden nach dem Abruf geprüft; die Abfrage benötigt dadurch keine ID-Ausschlussliste. Die Startseite lädt bei Bedarf weitere begrenzte Batches und hält die eingestellte Ausgabemenge ein.
- Eine eindeutige ID-Sortierung stabilisiert die Seiteneinteilung bei identischen Änderungsdaten und Kommentarzahlen.
- Für die Mindestlänge wird nur eine begrenzte Wortliste erzeugt.
- Jede statische Teilsitemap wird einmal geparst und danach freigegeben. Doppelte Markdown-URLs und doppelte Bild-URLs werden entfernt.
- Dynamische Original-Sitemaps werden kurzzeitig gecacht. Die Quellenprüfung verhindert beliebige zusätzliche Abrufe über frei gewählte XML-Dateinamen.
- Globale Cache-Ungültigkeit erfordert kein Durchlaufen aller Beiträge. Inhalts-, Metadaten-, Taxonomie- und relevante Optionsänderungen aktualisieren die Cache-Kennung.
- Upload-Verzeichnisse werden erst beim Schreiben angelegt. Die Dateisysteminitialisierung wird innerhalb einer Generator-Instanz wiederverwendet.
- Kategorien und Schlagwörter werden direkt sortiert abgefragt; redundantes PHP-Nachsortieren entfällt.

## Prüfungen

- **Plugin Check 2.1.0: 0 Fehler und 0 Warnungen** in den vier betroffenen Prüfbereichen `File_Type_Check`, `Plugin_Readme_Check`, `Performant_WP_Query_Params_Check` und `Prefixing_Check` unter WordPress 7.1.3. Als Gegenprobe meldet dasselbe Prüfverfahren für das vorherige ZIP genau die ursprünglichen 2 Fehler und 3 Warnungen. Die Versionsprüfung verwendet die tatsächlich abgerufenen Daten der offiziellen WordPress-Versions-API.
- **116 bestandene Regressionstest-Prüfungen** der korrigierten Version in einer isolierten WordPress-7.1.3-Installation mit PHP 8.4.25, WebAssembly-Laufzeit und SQLite-Integration. Die vorherige Version wurde zusätzlich mit WordPress 6.8.3 geprüft.
- Zusätzliche Fälle der Korrektur: mehr als ein Batch ausgeschlossener Beiträge, vollständige und stabile Startseiten-Ausgabe, explizite Methoden-Ausschlüsse, ausschließlich ausgeschlossene Inhalte und Wiederherstellung aller gesicherten Core-Globals nach einer Ausnahme.
- Darunter: Aktivierung, Exportregeln, Gast-Kontext, Wiederherstellung des Anfragezustands, Nonces, Berechtigungen, tatsächliches Speichern, HTTP-Weiterleitungen, Größenlimits, XML-Abweisung, Fremddateischutz, Sperr-Tokens, Sitemap-Filterung, Cron, Deinstallation und echte WordPress-Markdown-Anfragen.
- **Zusätzliche Syntaxprüfung aller zehn PHP-Dateien** unter PHP 8.0.30 und PHP 8.4.25. Beide Laufzeiten prüfen zusätzlich geordnete und ungeordnete Markdown-Listen.
- **WordPress-Core und WordPress-Extra** mit PHP_CodeSniffer. Die nur in der Entwicklungsumgebung gespeicherte Konfiguration erlaubt die bestehenden Klassendateinamen und die vorgeschriebenen Eigenschaftsnamen der nativen PHP-DOM-API. Gezielte Inline-Ausnahmen dokumentieren notwendige WordPress-Globals, atomare Lock-SQL-Abfragen und bewusst unveränderte Signaturen.
- **ESLint-Prüfung** des Admin-JavaScripts auf unter anderem undefinierte Variablen, unbenutzte Variablen, unerreichbaren Code, doppelte Schlüssel und strikte Vergleiche.
- Abgleich der benannten Funktionen und Methoden mit dem ursprünglichen ZIP; keine entfernt.

## Betriebsgrenzen

- Es fand **kein Test auf deinem Apache-Server mit Brotli** statt. Die tatsächlichen Elementor-, Divi- und Avada-Plugins, Membership-Plugins, Multisite-Installationen und persistente externe Object-Caches standen nicht für einen vollständigen Integrationstest zur Verfügung.
- `llms.txt` und die statische XML-Sitemap sind öffentliche Momentaufnahmen. Nach Inhaltsänderungen werden sie aktualisiert, sobald der vorgemerkte WP-Cron-Job läuft oder manuell generiert wird. Bereits veröffentlichte statische Inhalte werden durch eine Statusänderung allein nicht sofort aus diesen Dateien entfernt. Für einen sofortigen Widerruf neu generieren und gegebenenfalls den vorgeschalteten Cache leeren.
- Zusätzliche Zugriffsregeln fremder Plugins müssen über den Freigabefilter oder die Ausschlusslisten berücksichtigt werden. Ein Gast-Kontext ersetzt keine Integration mit jedem denkbaren Membership- oder Personalisierungssystem.
- Eine einzelne statische Sitemap darf höchstens 50.000 URLs und 50 MiB enthalten. Bei Überschreitung wird ein Fehler gemeldet; eine automatische Aufteilung in mehrere Dateien ist nicht enthalten. Der Standard begrenzt außerdem die Verarbeitung auf 1.000 Teilsitemaps und jede HTTP-Antwort auf 10 MiB. Die bestehenden bzw. dokumentierten Filter können die Abruflimits innerhalb der vorgesehenen Grenzen anpassen.
- Für beliebig große Websites wurde kein Lasttest durchgeführt. Die vollständige `llms.txt` wird weiterhin im Arbeitsspeicher aufgebaut.

## Installation

1. Das ZIP über **Plugins → Neues Plugin hinzufügen → Plugin hochladen** installieren und die vorhandene Version ersetzen. Vorhandene Einstellungen bleiben erhalten.
2. Unter **Einstellungen → Markdown for AI** einmal **Generate Files Now** ausführen. Dadurch werden statische Exporte mit den neuen Schutzregeln neu aufgebaut.
3. `llms.txt`, eine öffentliche Markdown-Adresse und den angezeigten Generierungsstatus prüfen. Falls ein externer Seiten-/CDN-Cache eingesetzt wird, die alten Exporte dort leeren.

## Referenzen

- WordPress: Nonces und Berechtigungsprüfung: https://developer.wordpress.org/apis/security/nonces/
- WordPress: Sichere HTTP-Anfragen und Redirect-Prüfung: https://developer.wordpress.org/reference/functions/wp_safe_remote_get/
- WordPress: Beitragskontext und globale Post-Variable: https://developer.wordpress.org/reference/functions/setup_postdata/
- WordPress VIP: ID-Ausschlüsse nach dem Abruf filtern: https://docs.wpvip.com/databases/optimize-queries/using-post__not_in/
- WordPress: Readme-Header: https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/#readme-header-information
