WordPress-chatbotplug-in
Gebruik de officiële ChattyBox WordPress-plug-in als je een installatie zonder code wilt die de gehoste widget laadt zonder themabestanden te bewerken. Deze handleiding behandelt de operationele configuratie. De WordPress AI-chatbotpagina legt de strategie voor content en crawlen uit, terwijl de landingspagina van de WordPress-plug-in het product in vogelvlucht beschrijft.
Voordat je installeert
Doorloop eerst Aan de slag: koppel je openbare WordPress-URL, bekijk geïndexeerde pagina's en controleer representatieve antwoorden in Test Chat. Maak daarna een browserveilige openbare sleutel in Public Keys en kopieer deze uit het tabblad Embed van het project.
De plug-in installeren
De plug-in heeft geen afhankelijkheid van Composer, npm of een buildstap. De plug-in wordt momenteel verspreid vanuit de openbare ChattyBox GitHub-repository, niet via de WordPress.org Plugin Directory. Gebruik daarom de WordPress-flow Upload Plugin in plaats van te zoeken in de directory. Automatische updates vanuit de directory zijn nog niet beschikbaar.
Het vastgezette pakket 0.2.0 declareert WordPress 5.8+ en PHP 7.4+ en testmetadata tot WordPress 6.8. Test je werkelijke WordPress-/PHP-versie en thema; deze metadata zijn geen garantie voor iedere nieuwere release.
- Download de vastgezette ZIP van versie 0.2.0 van de ChattyBox WordPress-plug-in of bekijk de openbare bronrepository.
- Open in WordPress Plugins > Add New > Upload Plugin, upload de ZIP en activeer ChattyBox AI Chatbot. Kopieer bij een handmatige serverinstallatie eerst de map van de plug-in naar
wp-content/plugins/. - Open Settings > ChattyBox.
- Plak de openbare widget-API-sleutel uit het tabblad Embed van het project.
- Schakel de chatbot in en sla de instellingen op.
De plug-in slaat de openbare widget-sleutel en weergave-instellingen op in de WordPress-opties. Plak nooit een ChattyBox-beheerdersreferentie in de plug-in.
Laden configureren
De standaardinstellingen voor productie zijn:
- Widgetscript:
https://chattybox.ai/widget.js - API-eindpunt: automatisch geconfigureerd door de plug-in
- Locale-override: leeg; de widget volgt het projectbeleid (standaard Auto)
In Auto-modus gaat <html lang> vóór browsertaal; Fixed gebruikt de standaardlocale van het project. De optionele plug-inoverride wordt data-locale en wint alleen wanneer script-overschrijving is toegestaan. Header- en welkomsttekst worden niet automatisch vertaald.
De plug-in laadt de widget bij openbare frontendverzoeken en slaat wp-admin, feeds, REST en AJAX bewust over. Dit is geen privacycontrole voor elke frontendpagina: sluit checkout-, account-, wachtwoord- en ledenpagina’s expliciet uit. De plug-in crawlt of synchroniseert geen berichten; indexering gebeurt in ChattyBox.
Extra routes uitsluiten
Gebruik het filter chattybox_load_widget vanuit een site-specifieke plug-in of een child theme als een openbare route de widget niet mag tonen:
add_filter(
'chattybox_load_widget',
static function ( $should_load ) {
return $should_load && ! is_page( array( 'checkout', 'account' ) );
}
);
Laat eerst het standaardgedrag van de plug-in ingeschakeld en voeg daarna alleen de route-uitsluitingen toe die je site nodig heeft. Test na het wijzigen van het filter zowel een uitgesloten route als een normale openbare pagina.
Handmatige scriptfallback
Gebruik de plug-in als standaardoptie. Als je WordPress-team scripts al beheert via een thema, child theme, scriptplug-in of Google Tag Manager, kun je de gehoste widget in plaats daarvan handmatig laden:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Schakel de plug-in niet in en voeg niet tegelijkertijd hetzelfde widgetfragment toe. Kies één loader, zodat bezoekers geen dubbele launchers ontvangen.
De installatie controleren
Nadat je de plug-in hebt geconfigureerd:
- Open een openbare WordPress-pagina in een incognitovenster.
- Controleer of de launcher één keer verschijnt.
- Stel een echte bezoekersvraag.
- Controleer dat een ondersteund antwoord geïndexeerde WordPress-pagina’s citeert en dat een niet-ondersteunde vraag de fallback toont, die geen bronnen kan hebben.
- Controleer de browserconsole op ontbrekende
data-api-key,data-api-urlof sleutelfouten. - Test een checkout-, account- of privéroute bij een uitsluiting. Wis na wijzigingen relevante WordPress-/CDN-caches; CSS-verbergen of het script verwijderen is geen volledige UI-teardown of intrekking van toestemming.
Ga verder met de lanceringschecklist. Gebruik Logs in elk plan en [Analytics]/Content Gaps alleen in Pro/Business.