Dokumentation · Entwickler-Dokumentation

Lokale Entwicklungsumgebung einrichten

Diese Seite beschreibt die öffentlich zugängliche Struktur einer lokalen Entwicklungsumgebung für das Plugin. Die genauen Konstanten, Dateipfade, internen Hilfsskripte und Konfigurationen für verwaltete Dienste, die in der eigenen Entwicklungsumgebung von AD Promotion verwendet werden, sind hier nicht veröffentlicht.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie dieses Dokument, wenn Sie:

  • Code, Vorlagen oder Dokumentationen von einem 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 Repository-Forks.
  • PHP in der im Plugin-Header deklarierten 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 in der im Plugin-Header deklarierten Mindestversion von WordPress. Jedes standardmässige 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 Repositorys.
  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 gemäss der Testanleitung aus.
  6. Nehmen Sie Ihre Änderungen gemäss den Codierungsrichtlinien und den Richtlinien für Beiträge vor.

Betriebshinweise

  • Geben Sie niemals Zugangsdaten frei. Konfigurieren Sie API-Zugangsdaten, Automatisierungs-Token oder Webhook-Geheimnisse über die Admin-Benutzeroberfläche des Plugins auf Ihrer lokalen Website, nicht über hochgeladene 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, Speicherinterna und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Teil der öffentlichen Dokumentation.