Title: tells — Text Analysis Widget Author: vøiddo Published: May 16, 2026 Last modified: May 16, 2026 --- Search plugins ![](https://ps.w.org/tells-text-analysis-widget/assets/banner-772x250.png?rev=3533667) ![](https://ps.w.org/tells-text-analysis-widget/assets/icon-256x256.png?rev=3533667) # tells — Text Analysis Widget By [vøiddo](https://profiles.wordpress.org/voiddo/) [Download](https://downloads.wordpress.org/plugin/tells-text-analysis-widget.1.0.1.zip) * [Details](https://wordpress.org/plugins/tells-text-analysis-widget/#description) * [Reviews](https://wordpress.org/plugins/tells-text-analysis-widget/#reviews) * [Installation](https://wordpress.org/plugins/tells-text-analysis-widget/#installation) * [Development](https://wordpress.org/plugins/tells-text-analysis-widget/#developers) [Support](https://wordpress.org/support/plugin/tells-text-analysis-widget/) ## Description **tells** is a text-first analysis product for reading messages, profiles, and the parts of a conversation that sit between the lines. This plugin lets a WordPress site owner place a tells analyzer inside any page, post, or block layout. Two modes are included: * **Public demo widget** — a free message-analysis demo powered by tells. Useful for articles, landing pages, and audience education. * **Licensed practitioner widget** — a paid white-label embed for coaches, mediators, communication trainers, and practices that want clients to analyze a message before booking or intake. The plugin includes a shortcode, a dynamic Gutenberg block, and a settings page. It does not analyze content inside WordPress and does not send post content to tells. It only renders the widget where you place it. #### Shortcode Use the site-wide settings: ``` [tells_widget] ``` Force public demo mode: ``` [tells_widget mode="public" height="700"] ``` Use a licensed embed for one page: ``` [tells_widget mode="licensed" license="paste-license-here" height="760"] ``` #### Block The plugin registers a dynamic block named **tells widget**. The block lets you choose plugin settings, public demo mode, or licensed mode per page. ### External Services This plugin connects to the **tells** service at `https://tells.voiddo.com`. **What data is sent and when:** In public mode the widget loads a sandboxed iframe from `https://tells.voiddo.com/ embed/message-analyzer.html`. Text entered by a visitor inside that iframe is submitted by the iframe directly to tells for analysis. No WordPress data is involved. In licensed mode the plugin’s frontend JavaScript sends the configured embed license key, the current site hostname, and the browser user-agent string to `https://tells. voiddo.com/api/v1/embed/init` to obtain a short-lived session token. The analysis widget then runs inside a sandboxed iframe at `https://tells.voiddo.com/embed/iframe`. **What is NOT sent:** WordPress post content, page content, comments, users, admin credentials, or any database rows are never sent to tells by this plugin. **Service terms and privacy:** * Product page: https://tells.voiddo.com/ * Privacy policy: https://tells.voiddo.com/en/privacy * Terms of service: https://tells.voiddo.com/en/terms ### About Built by vøiddo — a small studio shipping tools, browser extensions, games, and WordPress plugins. ## Screenshots * [[ * tells settings page with public and licensed widget modes. * [[ * tells widget block in the WordPress editor. * [[ * public demo widget rendered inside a page. ## Blocks This plugin provides 1 block. * tells widget ## Installation 1. Upload the `tells-text-analysis-widget` folder to `/wp-content/plugins/`, or install via Plugins Add New Upload Plugin. 2. Activate the plugin through the **Plugins** menu. 3. Go to **Settings tells**. 4. Choose public demo mode or paste your tells embed license. 5. Add the **tells widget** block, or use `[tells_widget]` in any post or page. ## FAQ ### Do I need a tells account? Not for the public demo widget. A paid tells embed license is required for the white- label practitioner widget. ### Does this plugin send my WordPress content to tells? No. The plugin does not send post content, pages, comments, users, or admin data. It only renders a tells iframe. Text entered by a visitor inside the tells widget is handled by tells. ### Why is the widget sandboxed? The iframe uses a strict sandbox so the widget can run its own form and JavaScript without accessing the parent WordPress page. ### Can I use it with Gutenberg? Yes. Use the dynamic **tells widget** block, or place the shortcode inside any Shortcode block. ### Can I use it with Classic Editor or page builders? Yes. Use the `[tells_widget]` shortcode wherever your editor allows shortcodes. ### How do I get a license? Open https://tells.voiddo.com/en/pricing and choose a practitioner or practice plan. The install guide at https://tells.voiddo.com/en/install explains how to create and rotate your embed license. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “tells — Text Analysis Widget” is open source software. The following people have contributed to this plugin. Contributors * [ vøiddo ](https://profiles.wordpress.org/voiddo/) [Translate “tells — Text Analysis Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/tells-text-analysis-widget) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/tells-text-analysis-widget/), check out the [SVN repository](https://plugins.svn.wordpress.org/tells-text-analysis-widget/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tells-text-analysis-widget/) by [RSS](https://plugins.trac.wordpress.org/log/tells-text-analysis-widget/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.1 — 2026-05-15 * Added standalone `== External Services ==` section to readme.txt per plugin guidelines. * Removed WordPress.org directory assets (banners, icons, screenshots) from the plugin ZIP — these belong in the SVN `assets/` directory, not the installable package. #### 1.0.0 — 2026-05-11 * Initial release. * Shortcode `[tells_widget]`. * Dynamic Gutenberg block. * Settings page for public demo or licensed embed mode. * Local WordPress JavaScript wrapper with sandboxed tells iframe. ## Meta * Version **1.0.1** * Last updated **19 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Tags * [block](https://wordpress.org/plugins/tags/block/)[coaching](https://wordpress.org/plugins/tags/coaching/) [communication](https://wordpress.org/plugins/tags/communication/)[relationships](https://wordpress.org/plugins/tags/relationships/) [Text-Analysis](https://wordpress.org/plugins/tags/text-analysis/) * [Advanced View](https://wordpress.org/plugins/tells-text-analysis-widget/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/tells-text-analysis-widget/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/tells-text-analysis-widget/reviews/) ## Contributors * [ vøiddo ](https://profiles.wordpress.org/voiddo/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/tells-text-analysis-widget/)