Hoe u kunt helpen bij het debuggen van WordPress-plugins

De ontwikkelaars van JoomUnited werken altijd zodat uw plugins op de meest optimale manier werken, natuurlijk kunnen in sommige gevallen bepaalde storingen optreden, bijvoorbeeld een incompatibiliteit die wordt veroorzaakt door een derde plugin en wat willen we wanneer dit soort storingen gebeuren? Natuurlijk worden ze snel opgelost ...    

In dit bericht leren we je hoe je de juiste informatie aan de ontwikkelaar kunt geven, zodat hij de fout snel kan begrijpen en oplossen. Dit bericht is opgedeeld in 3 stappen die we gaan volgen om de juiste informatie aan een ontwikkelaar te geven wanneer er een probleem optreedt:

• Debug-logboek inschakelen
• Installeer de Troubleshooting-plugin
• Controleren op javascript-fouten

Schakel het WordPress Debug- en Logsysteem in

Allereerst moeten we weten wat WP_DEBUG is; Zoals we kunnen zien op Wikipedia, “ WP_DEBUG is een PHP constante (een permanente globale variabele) die kan worden gebruikt om de "debug" modus in heel WordPress te activeren. Het wordt verondersteld standaard onwaar te zijn en wordt meestal ingesteld op true in het wp-config.php bestand op ontwikkelingskopieën van WordPress.”

Zoals we kunnen zien is WP_DEBUG een constante die standaard uit staat, maar we kunnen deze aan zetten voor tijdelijke debugging-doeleinden. 

Daarnaast is er nog een PHP-constante genaamd WP_DEBUG_LOG die ons helpt om automatisch een tekstbestand aan te maken met alle fouten van je plugins, en dat is wat we naar de ontwikkelaars gaan sturen.  

We gaan je leren hoe we het precies kunnen inschakelen en hoe het eruit zal zien als er een fout is met je plugin, WP Meta SEO zal voor dit voorbeeld worden gebruikt, maar je kunt dezelfde stappen volgen voor al onze plugins. In dit geval hebben we een probleem met WP Meta SEO, het kan elk probleem zijn, dus wat we gaan doen is het bestand wp-config.php openen. Dit kan met je favoriete tekstverwerkingssoftware, met bijvoorbeeld Notepad, Visual Studio Code, Brackets. Ga gewoon en open wp-config.php.

Het bestand bevindt zich in de hoofdmap van je server, waar je WordPress-website is geïnstalleerd.

Open het met de teksteditor en druk vervolgens op CTRL + F of klik op Bewerken > Zoeken… je zult een vak zien waarin je het woord kunt typen dat je wilt vinden, in dit geval typen we “WP_DEBUG” en klik op Enter totdat je vindt:
“define( 'WP_DEBUG', false )”

Nu we op die regel staan, verwijdert u de “false” en typt u true, klikt u op Enter en kopieert u in de volgende regel define( 'WP_DEBUG_LOG', true ); en slaat u het bestand op, het zou eruit moeten zien als de volgende afbeelding.

Als deze twee regels worden gewijzigd, verschijnt er een bestand met de naam “debug.php” in /wp-content/

En klaar… we hebben de eerste stap voltooid, dat is een van de bestanden die onze ontwikkelaars nodig zullen hebben om het proces van het oplossen van uw probleem te versnellen. Alle fouten worden gemonitord en in dit tekstbestand geschreven.

Installeer de WordPress Troubleshooting Plugin

Health Check & Troubleshooting plugin is een plugin waarmee je een conflictcontrole kunt uitvoeren zonder normale bezoekers van je site te beïnvloeden. Het is heel eenvoudig te gebruiken en te installeren. We gaan nog steeds WP Meta SEO gebruiken voor dit voorbeeld. Volg deze stappen om een conflictcontrole te installeren en uit te voeren met Health Check & Troubleshooting:  

• Log in op je WordPress-site, je bevindt je op het dashboard van je site
• Klik op “Plugins”, in het linkergedeelte van uw pagina
• Klik op “Nieuwe toevoegen”
• Typ “Health Check & Troubleshooting” in de zoekbalk, zoals hieronder weergegeven

• Klik op “Nu installeren”, De lijst met plugins wordt automatisch geladen, zoek de juiste en klik op “Nu installeren” en vervolgens op “Activeren”

• Klik op “Site Health”, in het linkermenu staat een sectie genaamd “Tools” Klik erop, en vervolgens op “Site Health”

• Klik op het tabblad “Probleemoplossing” , lees de waarschuwingsinformatie en klik op “Probleemoplossingsmodus openen” 

De probleemoplossingsmodus schakelt automatisch alle plugins uit en schakelt over naar een standaardthema. De probleemoplossingsmodus heeft geen invloed op normale bezoekers van uw site.  

• Reproduceer het probleem dat u ervoer

In de standaardomgeving zonder actieve plugins en met een standaardthema, als het probleem zich voordoet, betekent dit dat onze plugin niet het onverwachte gedrag veroorzaakt.

• Klik op “Plugins” > “Geïnstalleerde plugins”

  Het “Plugins” menu zal uitklappen en u extra opties bieden. Klik op “Geïnstalleerde plugins”

• Klik op “Inschakelen tijdens probleemoplossing” naast WP Meta SEO

• Reproduceer het probleem dat u ondervond met alleen WP Meta SEO actief en een standaardthema; als het probleem zich voordoet, wordt het veroorzaakt door onze plugin.

Dit is op een bepaalde manier goed nieuws, want je hebt al een deel van het probleem geïdentificeerd. Nu is het nodig dat de ontwikkelaar inlogt op je website en het probleem oplost voordat we een nieuwe versie uitbrengen! Zo niet, herhaal dan de stappen om de volgende uitgeschakelde plugin te activeren waarmee je de fout kunt reproduceren.

Javascript-fouten controleren en debuggen in WordPress-plugins

We gaan zoeken naar Javascript-fouten met de console van Chrome of Firefox. Afhankelijk van je browser is de naamgeving iets anders, maar volgens Chrome en Firefox noemen we het de “Console”. Volg deze stappen om de console te openen:  

• Klik met de rechtermuisknop op 'Inspecteren' op de frontend van de website, waar dan ook.

• Selecteer console, Hiermee worden de ontwikkelaarstools aan de rechterkant van de pagina geopend, klik op “Console”

Controleer op fouten

Als je een JavaScript-fout hebt gevonden, maak dan een screenshot van de uitgeklapte versie van de fout om deze toe te voegen aan je ticket/bericht.

Verzend / Deel je probleemrapport

Nu je al deze informatie hebt, help je de ontwikkelaar om het proces te versnellen. Voeg alle informatie die je hebt verzameld toe aan je ticket/bericht. Laten we niet vergeten, de items zijn:  

• debug.log
• Let op de plugins die conflicten veroorzaken
• Een schermafbeelding van de javascript-console met de fout

Als je deze stappen volgt en ons de juiste informatie stuurt, kan de ontwikkelaar sneller debuggen en we danken je bij voorbaat :)    

Maak en deel een nieuw WordPress-gebruikersaccount voor ondersteuningsdoeleinden

Het aanmaken van een nieuwe admin-gebruiker is soms een snelle manier om het supportteam te laten zien wat uw probleem is. Voordat u met dat proces begint, een korte herinnering:

• We bewaren geen oude inloggegevens nadat het probleem is opgelost (om veiligheidsredenen)
• We raden aan om die admin-gebruikersaccounts die voor supportdoeleinden zijn aangemaakt te verwijderen
• Alle informatie die met ons team wordt gedeeld, is beveiligd en blijft vertrouwelijk

Om een nieuwe gebruiker aan te maken, logt u eerst in op uw beheerderssite. Na succesvol inloggen bevindt u zich in het WordPress-dashboard.

Ga vervolgens naar het linker Menu > Gebruikers.

Navigeer daarna naar het bovenste scherm, klik op de knop Nieuwe toevoegen of ga naar de knop Nieuwe toevoegen in het linkermenu.

Vervolgens verschijnt het formulier Nieuwe gebruiker toevoegen op uw scherm. Er zijn 2 velden die verplicht moeten worden ingevuld: Gebruikersnaam, E-mail.

Bij het veld Wachtwoord kunt u een willekeurige wachtwoordgenerator gebruiken of er zelf een instellen. En u kunt Gebruiker op de hoogte stellen aanvinken als u de nieuwe gebruiker een e-mail over hun account wilt sturen.

Daarna kies je een Rol voor de gebruiker in het dropdown-menu. Dit is een belangrijke stap om de rechten voor gebruikers op je site in te stellen. "Beheerder" is het hoogste niveau en geeft de gebruiker toegang tot alle functies van je website. Je kunt andere rollen instellen als je de toegang van je gebruiker wilt beperken.

Klik ten slotte op Nieuwe gebruiker toevoegen knop onderaan. Het is al klaar, veel succes!