Description
Vragen.ai keeps your WordPress content in sync with a vragen.ai knowledge base. Whenever a post is published, updated, trashed or deleted, the plugin queues a background job (via Action Scheduler) that creates, updates or removes the matching document in vragen.ai.
Features:
- Automatic sync on publish/update/trash/delete for the post types you choose.
- Background processing through Action Scheduler, large sites stay responsive.
- Bulk synchronisation of all published content from the settings screen.
- WP-CLI command (
wp vragenai sync) for scripted/initial imports. - PDF attachments (directly attached media and ACF file fields) are passed to vragen.ai for server-side text extraction.
- Multilingual support for WPML and Polylang: all translations of a post are merged into a single document, tagged with every language it is available in.
- Filters (
vragenai_should_index_post,vragenai_document_attributes) to customise what is indexed.
The admin UI is available in English and Dutch, following your site language.
External services
This plugin connects to the vragen.ai knowledge base API. This connection is the sole purpose of the plugin: it is required to index your content so it can be searched and answered through vragen.ai. The service is operated by SWIS (https://swis.nl) on behalf of Vragen.ai (https://vragen.ai).
The API is reached at the endpoint configured for your account, https://{customer}.vragen.ai/api/v1 by default (the root domain can be changed with the VRAGENAI_API_DOMAIN constant).
When you publish, update, trash or delete content of an enabled post type and when you run a bulk synchronisation the plugin sends the following to that endpoint:
- the post title, public URL and rendered content;
- metadata: author display name, post type, post format, language(s), publish/modified dates, taxonomy terms and the featured-image URL;
- the URLs and MIME types of attached PDF files, so vragen.ai can fetch and extract their text server-side (the file contents themselves are not uploaded by the plugin);
- your configured customer name and API token (sent as a Bearer authorization header).
In addition, while the settings screen is open the plugin contacts the API at most once per hour to verify the connection.
No data is sent until you enter a customer name and API token. The plugin makes no other external requests.
- Service homepage: https://vragen.ai/
- Privacy Policy: https://vragen.ai/privacy-statement
Installation
- Install and activate the plugin.
- Go to Settings Vragen.ai.
- Enter your customer name (the
{customer}in{customer}.vragen.ai) and API token. A success notice confirms the connection. - Select the post types to synchronise and save.
- Optionally run Bulk synchronisation to index existing content.
For production, you can keep secrets out of the database by defining them in wp-config.php:
define( 'VRAGENAI_CUSTOMER', 'your-organisation' );
define( 'VRAGENAI_TOKEN', 'your-api-token' );
These constants take precedence over the values stored in the settings screen.
The API is reached at {customer}.vragen.ai by default. For staging or self-hosted environments you can change the root domain (the customer name stays the subdomain) by defining:
define( 'VRAGENAI_API_DOMAIN', 'example.com' );
With customer your-organisation this targets https://your-organisation.example.com/api/v1. There is no settings-screen field for this on purpose.
FAQ
-
Where do I get a customer name and API token?
-
From your vragen.ai account. See https://vragen.ai/docs.
-
Does it extract text from PDFs itself?
-
No. The plugin sends the file URL to vragen.ai, which crawls and extracts the text server-side.
-
Does it support multiple languages?
-
Yes. With WPML or Polylang active, all translations of a post are treated as one piece of content: they are merged into a single vragen.ai document keyed on the default-language (canonical) translation, with the document content taken from that translation and every available language listed in its metadata. Translations are assumed to be semantically equivalent, so only the canonical content is indexed.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Vragen.ai” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Vragen.ai” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.0
- Initial public release.