Logging en foutopsporing

Deze pagina beschrijft op hoofdlijnen hoe de plugin omgaat met logging en foutopsporing. De interne logger-klasse, de locatie van logbestanden, rotatiedrempels en maskeerregels zijn implementatiedetails en worden hier niet gepubliceerd.

Gedrag op hoofdlijnen

• De plugin schrijft runtime-diagnostiek naar een eigen logbestemming die wordt beheerd door WordPress, gescheiden van het WordPress core-foutlogboek.
• Het logvolume is begrensd: oude vermeldingen worden automatisch geroteerd en opgeschoond.
• Gevoelige waarden (inloggegevens, tokens, autorisatieheaders, headers van ondertekende verzoeken) worden gemaskeerd voordat er een regel wordt weggeschreven.
• Wanneer er iets misgaat tijdens een import of achtergrondtaak, toont de plugin een melding in het beheerdersgedeelte en schrijft een diagnostische vermelding die met de supportafdeling kan worden gedeeld.

Voor beheerders

Als u diagnostische gegevens met de supportafdeling moet delen, gebruik dan de diagnostische exportfunctie die beschikbaar is in de beheerinterface van de plugin, in plaats van onbewerkte logbestanden te kopiëren. Het geëxporteerde pakket bevat de informatie die de supportafdeling nodig heeft, terwijl geheimen gemaskeerd blijven.

Voor ontwikkelaars

Vertrouw vanuit externe code niet op specifieke paden naar logbestanden, indelingen of rotatiegedrag; dit zijn implementatiedetails. Geef bij het ontwikkelen voor de plugin de voorkeur aan de standaard WP_DEBUG-workflow van WordPress in combinatie met de diagnostische export van de plugin.

Ondersteunde openbare integratie-interfaces

Geef bij het integreren met de plugin de voorkeur aan deze stabiele interfaces:

• De beheerinterface voor instellingen van de plugin.
• De gedocumenteerde shortcodes.
• Template-overschrijvingen op thema-niveau zoals beschreven in Template System And Overrides.
• Het algemene Developer Overview voor oriëntatie.

Interne klassennamen, optiesleutels, databasetabellen, REST- en AJAX-endpoints, cron-hooknamen, capability- en nonce-identificatoren, en de release- en update-infrastructuur worden behandeld als implementatiedetails. Deze kunnen tussen releases zonder voorafgaande kennisgeving wijzigen en maken geen deel uit van het openbare integratiecontract.

Stabiliteits- en wijzigingsbeleid

Alles wat hierboven niet als ondersteunde openbare interface wordt vermeld, wordt beschouwd als een intern implementatiedetail. Interne API's, opslaglay-out en beveiligingsimplementaties kunnen tussen releases wijzigen. Vertrouw hier niet op vanuit code van derden, thema's of externe systemen. Directe schrijfacties naar de database worden niet ondersteund.

Kennisgeving openbare documentatie. Deze pagina biedt uitsluitend een integratie-overzicht op hoofdlijnen. Interne implementatiedetails, privé-API's, interne opslagdetails en beveiligingsgevoelige release-infrastructuur worden afzonderlijk beheerd en maken geen deel uit van de openbare documentatie. Ondersteunde integratie-interfaces zijn de gedocumenteerde shortcodes, template-overschrijvingen, de instellingeninterface en eventuele uitbreidingspunten die expliciet in deze sectie zijn gepubliceerd.