Documentatie · Ontwikkelaarsdocumentatie

Lokale ontwikkelomgeving instellen

Deze pagina beschrijft de publiek toegankelijke opzet van een lokale ontwikkelomgeving voor de plugin. De exacte constanten, bestandspaden, interne hulpscripts en beheerde serviceconfiguraties die worden gebruikt door de eigen ontwikkelomgeving van AD Promotion worden hier niet gepubliceerd.

Wanneer u dit document gebruikt

Gebruik dit document wanneer u:

  • Code, templates of documentatie bijdraagt aan de plugin vanuit een fork.
  • Een bug lokaal wilt reproduceren voordat u deze rapporteert of oplost.
  • Het gedrag van de plugin wilt evalueren binnen een gecontroleerde WordPress-installatie.

Eindgebruikers die de plugin op een productiesite installeren, moeten in plaats hiervan de installatiehandleiding in de gebruikershandleiding volgen.

Algemene vereisten

  • Git voor het clonen van uw fork van de repository.
  • PHP met minimaal de versie die in de plugin-header is gedeclareerd.
  • Composer voor het installeren van ontwikkelingsafhankelijkheden (alleen voor het testframework; de plugin heeft geen runtime Composer-afhankelijkheden).
  • Een lokale WordPress-installatie met minimaal de WordPress-versie die in de plugin-header is gedeclareerd. Elke standaardtool voor lokale ontwikkeling werkt (Local, DDEV, Lando, wp-env, Docker, MAMP, native LAMP/LEMP, etc.).

Typische werkstroom

  1. Clone uw fork van de repository.
  2. Plaats (of symlink) de pluginmap in wp-content/plugins/ van een lokale WordPress-installatie die voldoet aan de gedocumenteerde minimale versies van de plugin.
  3. Activeer de plugin vanuit wp-admin.
  4. Installeer ontwikkelingsafhankelijkheden met Composer als u de testsuite van het project wilt uitvoeren.
  5. Voer de testsuite uit vanaf de projectmap volgens de Testgids.
  6. Breng uw wijzigingen aan volgens de Codeerstandaarden en de Richtlijnen voor bijdragen.

Operationele opmerkingen

  • Leg nooit geheimen vast in Git. Configureer API-inloggegevens, automatiseringstokens of webhook-geheimen via de beheerinterface van de plugin op uw lokale site, niet via vastgelegde bestanden. Plaats geen inloggegevens in wp-config.php-fragmenten die door versiebeheer worden gevolgd.
  • Beheerde services. Sommige plugin-functies zijn afhankelijk van door AD Promotion beheerde services die voor klantensites zijn ingericht. Gebruik voor de lokale ontwikkeling van die functies uw eigen persoonlijke test-inloggegevens die via de beheerinterface zijn geconfigureerd; de beheerde configuratie van AD Promotion wordt niet gedistribueerd.
  • Uitgebreide diagnostiek. Wanneer u lokaal meer diagnostische details nodig hebt, schakelt u uitgebreide logboekregistratie in via de beheerinterface van de plugin in plaats van te vertrouwen op interne logpaden.

Kennisgeving publieke documentatie. Deze pagina biedt uitsluitend een algemeen integratie-overzicht. Interne implementatiedetails, privé-API's, opslaginterne zaken en beveiligingsgevoelige release-infrastructuur worden afzonderlijk beheerd en maken geen deel uit van de publieke documentatie.