Verbinding met de Remote-Site mislukt

De plug-ins van de suite hebben het onderdeel ‘Externe sites’ (in het Duits: „Remote-Sites“): daar verbind je verdere WordPress-installaties via een applicatiewachtwoord en bedien je ze van hieruit. Verbinden, testen en verwijderen verlopen in alle plug-ins via dezelfde gedeelde code, de meldingen zijn daarom overal woordelijk gelijk. Dit artikel wijst ze toe.

De meldingen stuk voor stuk

• ‘Geef URL (http/https), gebruiker en applicatiewachtwoord op.’ — een veld is leeg of het adres begint niet met http:// of https://
• ‘Site niet bereikbaar.’ — er kwam helemaal geen antwoord terug; bij het aanmaken staat ‘Verbinding mislukt:’ ervoor, bij het latere controleren ‘Test mislukt:’
• ‘Toegangsgegevens geweigerd (applicatiewachtwoord controleren).’ — de doelwebsite heeft met 401 of 403 geantwoord
• ‘Geen geldig REST-antwoord (code …).’ — er kwam een antwoord, maar geen bruikbare JSON; de genoemde code staat erbij
• ‘Site niet gevonden.’ — het aangeklikte item staat niet meer in de lijst van deze installatie

Verbinding aanmaken en controleren

1. Open de pagina van de betreffende plugin in het WordPress-menu en ga links in de groep ‘Netwerk’ naar ‘Externe sites’ (in het Duits: „Remote-Sites“).
2. Vul in de kaart ‘Site verbinden’ de velden ‘Site-URL’, ‘Gebruikersnaam’ en ‘Applicatiewachtwoord’ in.
3. Klik op ‘Verbinden & testen’.
4. Controleer een bestaande verbinding later op elk moment via de knop ‘Testen’ in de tabel ‘Verbonden sites’.
5. Lees in de kolom ‘Status’ af of de site als ‘verbonden’, ‘fout’ of ‘ongecontroleerd’ wordt vermeld.

De test is een ingelogde aanroep van de WordPress-eigen gebruikersroute op de doelwebsite. Hij heeft 20 seconden de tijd en volgt geen redirects. Er worden twee adresvormen geprobeerd: eerst de vorm met rest_route, die bij elke permalink-instelling werkt, daarna de weg via /wp-json/. Als succes telt alleen een echt JSON-antwoord. Vervolgens leest de test de naam van de site na via de wortelroute; lukt dat niet, dan staat de hostnaam in de lijst.

Groene test, en toch mislukt de actie

• De acties naast elke site roepen eigen routes van de doelwebsite aan: ‘Externe status’ (in het Duits: „Fernstatus“) en ‘Externe back-up’ in de Backup-plugin, ‘Status’ en ‘Cache legen’ in Performance, ‘Config versturen’ in Consent, ‘Beveiligingsstatus’ in Security, ‘SEO-status’ in SEO, ‘Statistieken ophalen’ in Analytics, ‘Rollenstatus’ in Roles en ‘Herkomststand’ in Media
• Deze routes vereisen op de doelwebsite het recht manage_options — het applicatiewachtwoord moet dus bij een account met beheerdersrechten horen
• De betreffende plugin moet op de doelwebsite geïnstalleerd en actief zijn. Anders mislukt de actie: opvragingen zoals ‘Externe status’, ‘Statistieken ophalen’ of ‘Herkomststand’ (in het Duits: „Fernstatus“, „Statistik abrufen“, „Herkunfts-Stand“) melden dat niets op te vragen is („… nicht abrufbar“), met de antwoordcode; ‘Externe back-up’, ‘Cache legen’ en ‘Config versturen’ (in het Duits: „Fern-Backup“, „Cache leeren“, „Config senden“) melden een mislukking („… fehlgeschlagen:“) met het antwoord van de doelwebsite of de code daarvan
• Dat ‘Testen’ groen meldt, zegt alleen dat adres en toegangsgegevens kloppen — over de plugin aan de andere kant zegt het niets
• In de Analytics-plugin verschijnt het onderdeel ‘Externe sites’ (in het Duits: „Remote-Sites“) alleen voor beheerders