WordPress koppelen

Wat je nodig hebt

• De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
• Tweestapsverificatie (2FA) op je APIboard-account.
• Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
• Een WordPress-site met een openbaar https-adres, WordPress 5.6 of nieuwer en applicatiewachtwoorden ingeschakeld.
• Een WordPress-gebruiker om mee in te loggen. Met een beheerdersaccount ziet APIboard ook plugins, thema’s en instellingen; met een ander account koppel je ook, maar zie je minder.
• Een REST API die niet geblokkeerd wordt door je hosting of een beveiligingsplugin.

Verbinden

1. Ga in APIboard naar Koppelen > Koppelingen.
2. Zoek WordPress bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
3. Vul bij Adres van je website het adres in, bijvoorbeeld voorbeeld.nl. Dat is het adres waarop je WordPress-site te bereiken is.
4. Klik op Verbind met WordPress. APIboard opent daarna je eigen WordPress, waar je inlogt en met één klik toegang geeft.
5. Log in en keur de toegang goed. Dat moet binnen 10 minuten. WordPress maakt een applicatiewachtwoord met de naam APIboard.
6. APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met WordPress, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Je kunt het applicatiewachtwoord altijd intrekken in WordPress onder Gebruikers, Profiel, Applicatiewachtwoorden.

Welke gegevens je krijgt

Onderwerp	Tabellen
Inhoud	Berichten, Pagina’s, Media, Reacties
Indeling	Categorieën, Tags
Mensen	Auteurs
Site	Site, Plugins, Thema’s

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van WordPress.

Hoe vaak vernieuwd

De eerste ronde haalt alles volledig op. Daarna haalt APIboard berichten, pagina’s en media incrementeel op via het laatste wijzigingsmoment, reacties via hun datum, met een totaalcontrole en een veegpas voor verwijderde items. Plugins en thema’s komen elke ronde als complete lijst binnen. Reacties komen alleen vanaf de grens van je pakket binnen.

Wat wel wordt opgehaald: titel, adres, status, datums, auteur, categorieën en tags van berichten en pagina’s; de tekst en het e-mailadres van reageerders (alleen als je gebruiker reacties mag modereren); het e-mailadres en de registratiedatum van auteurs (alleen met beheerrechten); alt-tekst, bijschrift en bestandsadres van media. Wat niet wordt opgehaald: de inhoud (body) van berichten en pagina’s, het IP-adres van reageerders en velden van SEO-plugins.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

• Welke gegevens je krijgt, hangt af van de rechten van de gebruiker. Met het recht edit_others_posts ziet APIboard ook concepten, geplande en privéberichten van anderen. Met manage_options komen plugins, thema’s, het e-mailadres van auteurs en de registratiedatum binnen. Met moderate_comments komen e-mailadressen van reageerders en reacties in moderatie binnen. Zonder die rechten krijg je minder data, geen fout; APIboard probeert zo’n stap pas na 7 dagen opnieuw.
• Koppel je met een gebruiker zonder beheerrechten, dan meldt APIboard na het koppelen dat instellingen, gebruikers, reacties in moderatie, plugins en thema’s niet zichtbaar zijn. Koppel opnieuw met een beheerder voor alles.
• Sommige hostingpartijen of beveiligingsplugins blokkeren de REST API of de Authorization-header. Vraag je hostingpartij die open te zetten voor ingelogde gebruikers.
• WordPress zelf heeft geen limiet op het aantal aanroepen, maar je hosting of firewall kan er wel een hebben.
• Intrekken van het applicatiewachtwoord in WordPress zet de koppeling op Fout. Verbind dan opnieuw.
• Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Vul hetzelfde websiteadres in en keur de toegang opnieuw goed. Een ander adres is een nieuwe koppeling. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling.
• Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
• Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

• Vul het adres van je WordPress-website in, bijvoorbeeld voorbeeld.nl. Het veld Adres van je website is leeg.
• Dit adres kan APIboard niet bereiken. Gebruik het openbare https-adres van je website. Gebruik het openbare https-adres zonder andere poort dan 443. Adressen op een privé-netwerk werken niet.
• Op dit adres vonden we geen WordPress-site met een bereikbare REST API. Controleer het adres. Staat de site achter een beveiligingsplugin of firewall, laat de REST API dan open voor ingelogde gebruikers.
• Applicatiewachtwoorden staan uit op deze site (vereist WordPress 5.6 of nieuwer en https). Werk WordPress bij, gebruik https en zet applicatiewachtwoorden aan.
• De website blokkeert de REST API (beveiligingsplugin of firewall). Zet de REST API open voor ingelogde gebruikers. Pas de instelling van je beveiligingsplugin of hosting aan.
• De website blokkeert de gebruikers-API van WordPress (vaak een beveiligingsinstelling van de hosting, zoals Plesk). Zet de blokkade van gebruikersopsomming uit en probeer het opnieuw. Pas de instelling bij je hosting aan.
• WordPress accepteerde het applicatiewachtwoord niet. Mogelijk stript je hosting de Authorization-header; zie de uitleg bij het koppelen. Vraag je hostingpartij de Authorization-header door te laten.
• Je hebt de toegang geweigerd in WordPress. Start opnieuw en keur de toegang goed.
• WordPress gaf geen applicatiewachtwoord terug. Probeer het opnieuw. Start de koppeling opnieuw.
• De koppelsessie is verlopen. Keur de toegang binnen 10 minuten goed en probeer het opnieuw. Start opnieuw en rond de goedkeuring sneller af.
• De website reageerde niet. Probeer het later opnieuw. Controleer of je site bereikbaar is en probeer het later opnieuw.
• Deze WordPress-site is al gekoppeld. Deze site staat al in je organisatie.
• Er ging iets mis bij het koppelen. Probeer het opnieuw. Start de koppeling opnieuw.
• Kon geen popup-venster openen. Sta pop-ups toe voor deze site. Sta pop-ups toe voor APIboard in je browser en klik opnieuw op Verbind met WordPress.
• Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
• Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
• Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
• De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.