Description
Tellpin is a hosted AI feedback service that lets visitors leave ratings and comments through an embeddable widget.
This plugin adds Tellpin’s existing hosted widget to your site’s front end. Paste your project key into Settings > Tellpin, select the enable checkbox and save. The widget is disabled by default, and saving a key alone does not enable it. A Tellpin account and project key are required to use the hosted service.
The plugin’s only job is to load the widget. Tellpin runs the widget and handles feedback in its hosted service. Any service plan limits are managed by Tellpin; this plugin has no quotas, locked features or upgrade prompts.
External services
When you save a project key and enable the widget, the plugin loads JavaScript from app.tellpin.com on front-end pages:
https://app.tellpin.com/widget/latest/widget.js?key=YOUR_PROJECT_KEY
This script provides the Tellpin feedback widget and uses the project key to associate it with your Tellpin project. The visitor’s browser contacts Tellpin to load the script, which exposes normal request information such as the visitor’s IP address and browser information to the service.
When a visitor uses the widget, their rating/comment and page context are sent directly from their browser to Tellpin’s service for feedback collection and processing. Feedback is handled by the hosted service and is not stored by this plugin in your WordPress database.
The plugin makes no PHP-side network requests, key validation requests or telemetry requests. It does not load the widget in wp-admin.
Service provider: Tellpin.
Terms of service: https://tellpin.com/terms.
Privacy policy: https://tellpin.com/privacy.
Privacy
The plugin stores only your project key and enable/disable preference in your site’s WordPress options. The project key is an embed identifier that appears in the public widget URL; do not enter a private API token or password.
Enabling the widget connects visitors’ browsers to Tellpin as described above. Include this external service and its feedback processing in your site’s privacy information as appropriate. Tellpin’s privacy policy describes its handling of information received by the service. Deleting the plugin removes its saved WordPress options, but does not delete information held in your Tellpin account.
Licence
This plugin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the Licence, or (at your option) any later version.
This plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
The licence applies to the plugin code. Use of the hosted Tellpin service is governed by its terms of service and privacy policy linked above.
Installation
- Upload the tellpin folder to /wp-content/plugins/.
- Activate Tellpin through the Plugins screen in WordPress.
- Open Settings > Tellpin.
- Copy the project key for your website from the Tellpin dashboard and paste it into the Project key field.
- Review the service disclosure, select Enable the Tellpin widget and save your changes.
- Visit a public page to see the widget. Clear any page cache after changing the key or enable setting.
FAQ
-
Where do I get a project key?
-
Sign in to the Tellpin dashboard and open the project for your website to find its project key.
-
Does it work with caching?
-
The plugin adds a standard WordPress script enqueue to the page footer and can be used with page caching. Clear your page/CDN cache whenever you change the key, disable the widget or deactivate the plugin. If an optimisation tool combines, delays or rewrites scripts and the widget does not appear, exclude the app.tellpin.com widget script from that optimisation. Your theme must call wp_footer().
-
How do I remove it?
-
Clear the enable checkbox in Settings > Tellpin and save, or deactivate the plugin. Then clear any page cache to remove the script from cached pages. Deactivation keeps your settings for later use. Deleting the plugin through the Plugins screen removes its saved options from WordPress, including each site’s options on multisite. Manage feedback already held by Tellpin in your Tellpin account.
-
Does the plugin validate my key or contact Tellpin from my server?
-
The plugin trims and sanitises the key and checks its length locally. It makes no PHP-side network calls. Once enabled, visitors’ browsers load the widget, and the hosted service handles the project key and feedback.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Tellpin” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Tellpin” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- The widget now loads from Tellpin’s auto-updating latest channel, so widget improvements reach your site without a plugin update.
- Removed the manual translation loading call; translations are loaded by WordPress.org.
1.0.0
- Initial release with a project key field, an explicit enable checkbox and front-end loading of the hosted Tellpin widget.
- Added external service and privacy disclosures, local validation and removal of saved options on uninstall.