Dokumentation · Entwickler-Dokumentation

Lokale Entwicklungsumgebung einrichten

Diese Seite beschreibt die öffentlich sichere Struktur einer lokalen Entwicklungsumgebung für das Plugin. Die genauen Konstanten, Dateipfade, internen Hilfsskripte und Konfigurationen für verwaltete Dienste, die im eigenen Entwicklungs-Setup von AD Promotion verwendet werden, werden hier nicht veröffentlicht.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie dieses Dokument, wenn Sie:

  • Code, Vorlagen oder Dokumentationen über einen Fork zum Plugin beitragen.
  • Einen Fehler lokal reproduzieren müssen, bevor Sie ihn melden oder beheben.
  • Das Verhalten des Plugins in einer kontrollierten WordPress-Installation evaluieren möchten.

Endbenutzer, die das Plugin auf einer Live-Website installieren, sollten stattdessen der Installationsanleitung im Benutzerhandbuch folgen.

Grundlegende Anforderungen

  • Git zum Klonen Ihres Forks des Repositories.
  • PHP in der im Plugin-Header angegebenen Mindestversion.
  • Composer zur Installation von Entwicklungsabhängigkeiten (nur für das Test-Framework; das Plugin hat keine Composer-Abhängigkeiten zur Laufzeit).
  • Eine lokale WordPress-Installation mit der im Plugin-Header angegebenen Mindestversion von WordPress. Jedes standardmäßige Tool für die lokale Entwicklung funktioniert (Local, DDEV, Lando, wp-env, Docker, MAMP, natives LAMP/LEMP usw.).

Typischer Arbeitsablauf

  1. Klonen Sie Ihren Fork des Repositories.
  2. Platzieren Sie den Plugin-Ordner (oder erstellen Sie einen Symlink) in wp-content/plugins/ einer lokalen WordPress-Installation, die den dokumentierten Mindestversionen des Plugins entspricht.
  3. Aktivieren Sie das Plugin über wp-admin.
  4. Installieren Sie die Entwicklungsabhängigkeiten mit Composer, wenn Sie die Testsuite des Projekts ausführen möchten.
  5. Führen Sie die Testsuite vom Projektverzeichnis aus, indem Sie der Testanleitung folgen.
  6. Nehmen Sie Ihre Änderungen gemäß den Codierungsstandards und den Richtlinien für Beiträge vor.

Betriebshinweise

  • Geben Sie niemals Geheimnisse frei. Konfigurieren Sie alle API-Zugangsdaten, Automatisierungs-Token oder Webhook-Geheimnisse über die Admin-Benutzeroberfläche des Plugins auf Ihrer lokalen Website, nicht über versionierte Dateien. Fügen Sie keine Zugangsdaten in wp-config.php-Snippets ein, die von der Versionsverwaltung erfasst werden.
  • Verwaltete Dienste. Einige Plugin-Funktionen basieren auf von AD Promotion verwalteten Diensten, die für Kunden-Websites bereitgestellt werden. Verwenden Sie für die lokale Entwicklung dieser Funktionen Ihre eigenen persönlichen Test-Zugangsdaten, die über die Admin-Benutzeroberfläche konfiguriert werden; die verwaltete Konfiguration von AD Promotion wird nicht weitergegeben.
  • Ausführliche Diagnose. Wenn Sie lokal detailliertere Diagnoseinformationen benötigen, aktivieren Sie die ausführliche Protokollierung über die Admin-Benutzeroberfläche des Plugins, anstatt sich auf interne Protokollpfade zu verlassen.

Hinweis zur öffentlichen Dokumentation. Diese Seite bietet nur eine allgemeine Integrationsübersicht. Interne Implementierungsdetails, private APIs, Speicher-Interna und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Teil der öffentlichen Dokumentation.