{"id":311997,"date":"2026-05-16T09:17:20","date_gmt":"2026-05-16T09:17:20","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/tells-text-analysis-widget\/"},"modified":"2026-05-16T09:17:11","modified_gmt":"2026-05-16T09:17:11","slug":"tells-text-analysis-widget","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/tells-text-analysis-widget\/","author":23483678,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"tells \u2014 Text Analysis Widget","header_author":"v\u00f8iddo","header_description":"Add a tells message-analysis widget to a WordPress site. Use the free public demo or connect a paid tells embed license for practitioner\/client intake.","assets_banners_color":"06070f","last_updated":"2026-05-16 09:17:11","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/tells.voiddo.com\/en\/install","header_author_uri":"https:\/\/voiddo.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":33,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"voiddo","date":"2026-05-16 09:17:11"}},"upgrade_notice":{"1.0.0":"<p>First release. No upgrade path needed.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3533667,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3533667,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3533667,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3533667,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"tells\/text-analysis-widget":{"name":"tells\/text-analysis-widget","title":"tells widget"}},"tagged_versions":["1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3533667,"resolution":"1","location":"assets","locale":"","width":1280,"height":800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3533667,"resolution":"2","location":"assets","locale":"","width":1280,"height":800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3533667,"resolution":"3","location":"assets","locale":"","width":1280,"height":800}},"screenshots":{"1":"tells settings page with public and licensed widget modes.","2":"tells widget block in the WordPress editor.","3":"public demo widget rendered inside a page."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1220,9110,3964,4676,29894],"plugin_category":[],"plugin_contributors":[261505],"plugin_business_model":[],"class_list":["post-311997","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-coaching","plugin_tags-communication","plugin_tags-relationships","plugin_tags-text-analysis","plugin_contributors-voiddo","plugin_committers-voiddo"],"banners":{"banner":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/banner-772x250.png?rev=3533667","banner_2x":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/banner-1544x500.png?rev=3533667","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/icon-128x128.png?rev=3533667","icon_2x":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/icon-256x256.png?rev=3533667","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/screenshot-1.png?rev=3533667","caption":"tells settings page with public and licensed widget modes."},{"src":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/screenshot-2.png?rev=3533667","caption":"tells widget block in the WordPress editor."},{"src":"https:\/\/ps.w.org\/tells-text-analysis-widget\/assets\/screenshot-3.png?rev=3533667","caption":"public demo widget rendered inside a page."}],"raw_content":"<!--section=description-->\n<p><strong>tells<\/strong> 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.<\/p>\n\n<p>Two modes are included:<\/p>\n\n<ul>\n<li><strong>Public demo widget<\/strong> \u2014 a free message-analysis demo powered by tells. Useful for articles, landing pages, and audience education.<\/li>\n<li><strong>Licensed practitioner widget<\/strong> \u2014 a paid white-label embed for coaches, mediators, communication trainers, and practices that want clients to analyze a message before booking or intake.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<h4>Shortcode<\/h4>\n\n<p>Use the site-wide settings:<\/p>\n\n<pre><code>[tells_widget]\n<\/code><\/pre>\n\n<p>Force public demo mode:<\/p>\n\n<pre><code>[tells_widget mode=\"public\" height=\"700\"]\n<\/code><\/pre>\n\n<p>Use a licensed embed for one page:<\/p>\n\n<pre><code>[tells_widget mode=\"licensed\" license=\"paste-license-here\" height=\"760\"]\n<\/code><\/pre>\n\n<h4>Block<\/h4>\n\n<p>The plugin registers a dynamic block named <strong>tells widget<\/strong>. The block lets you choose plugin settings, public demo mode, or licensed mode per page.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin connects to the <strong>tells<\/strong> service at <code>https:\/\/tells.voiddo.com<\/code>.<\/p>\n\n<p><strong>What data is sent and when:<\/strong><\/p>\n\n<p>In public mode the widget loads a sandboxed iframe from <code>https:\/\/tells.voiddo.com\/embed\/message-analyzer.html<\/code>. Text entered by a visitor inside that iframe is submitted by the iframe directly to tells for analysis. No WordPress data is involved.<\/p>\n\n<p>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 <code>https:\/\/tells.voiddo.com\/api\/v1\/embed\/init<\/code> to obtain a short-lived session token. The analysis widget then runs inside a sandboxed iframe at <code>https:\/\/tells.voiddo.com\/embed\/iframe<\/code>.<\/p>\n\n<p><strong>What is NOT sent:<\/strong> WordPress post content, page content, comments, users, admin credentials, or any database rows are never sent to tells by this plugin.<\/p>\n\n<p><strong>Service terms and privacy:<\/strong><\/p>\n\n<ul>\n<li>Product page: https:\/\/tells.voiddo.com\/<\/li>\n<li>Privacy policy: https:\/\/tells.voiddo.com\/en\/privacy<\/li>\n<li>Terms of service: https:\/\/tells.voiddo.com\/en\/terms<\/li>\n<\/ul>\n\n<h3>About<\/h3>\n\n<p>Built by v\u00f8iddo \u2014 a small studio shipping tools, browser extensions, games, and WordPress plugins.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>tells-text-analysis-widget<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install via Plugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu.<\/li>\n<li>Go to <strong>Settings \u2192 tells<\/strong>.<\/li>\n<li>Choose public demo mode or paste your tells embed license.<\/li>\n<li>Add the <strong>tells widget<\/strong> block, or use <code>[tells_widget]<\/code> in any post or page.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20tells%20account%3F\"><h3>Do I need a tells account?<\/h3><\/dt>\n<dd><p>Not for the public demo widget. A paid tells embed license is required for the white-label practitioner widget.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20send%20my%20wordpress%20content%20to%20tells%3F\"><h3>Does this plugin send my WordPress content to tells?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"why%20is%20the%20widget%20sandboxed%3F\"><h3>Why is the widget sandboxed?<\/h3><\/dt>\n<dd><p>The iframe uses a strict sandbox so the widget can run its own form and JavaScript without accessing the parent WordPress page.<\/p><\/dd>\n<dt id=\"can%20i%20use%20it%20with%20gutenberg%3F\"><h3>Can I use it with Gutenberg?<\/h3><\/dt>\n<dd><p>Yes. Use the dynamic <strong>tells widget<\/strong> block, or place the shortcode inside any Shortcode block.<\/p><\/dd>\n<dt id=\"can%20i%20use%20it%20with%20classic%20editor%20or%20page%20builders%3F\"><h3>Can I use it with Classic Editor or page builders?<\/h3><\/dt>\n<dd><p>Yes. Use the <code>[tells_widget]<\/code> shortcode wherever your editor allows shortcodes.<\/p><\/dd>\n<dt id=\"how%20do%20i%20get%20a%20license%3F\"><h3>How do I get a license?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.1 \u2014 2026-05-15<\/h4>\n\n<ul>\n<li>Added standalone <code>== External Services ==<\/code> section to readme.txt per plugin guidelines.<\/li>\n<li>Removed WordPress.org directory assets (banners, icons, screenshots) from the plugin ZIP \u2014 these belong in the SVN <code>assets\/<\/code> directory, not the installable package.<\/li>\n<\/ul>\n\n<h4>1.0.0 \u2014 2026-05-11<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Shortcode <code>[tells_widget]<\/code>.<\/li>\n<li>Dynamic Gutenberg block.<\/li>\n<li>Settings page for public demo or licensed embed mode.<\/li>\n<li>Local WordPress JavaScript wrapper with sandboxed tells iframe.<\/li>\n<\/ul>","raw_excerpt":"Add a tells message-analysis widget to WordPress. Use the free public demo or connect a paid tells embed license for practitioner\/client intake.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/311997","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=311997"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/voiddo"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=311997"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=311997"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=311997"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=311997"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=311997"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=311997"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}