Title: tells — Text Analysis Widget
Author: vøiddo
Published: <strong>2026 年 5 月 16 日</strong>
Last modified: 2026 年 5 月 20 日

---

搜尋外掛

![](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

 由 [vøiddo](https://profiles.wordpress.org/voiddo/) 開發

[下載](https://downloads.wordpress.org/plugin/tells-text-analysis-widget.1.0.1.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/tells-text-analysis-widget/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/tells-text-analysis-widget/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/tells-text-analysis-widget/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/tells-text-analysis-widget/#developers)

 [技術支援](https://wordpress.org/support/plugin/tells-text-analysis-widget/)

## 外掛說明

**tells** is a text-first analysis widget that reads between the lines of any message.
Coaches, mediators, communication trainers, recruiters, and intake teams add it 
to a WordPress page or post so that clients can analyze their own messages — or 
so that practitioners can surface signals before a session begins.

Two modes are included:

 * **Public demo widget** — free, no account required. Useful for articles, landing
   pages, and audience education.
 * **Licensed practitioner widget** — paid white-label embed. Client-data privacy
   controls, higher analysis volume, and your branding. Requires a tells embed license
   from tells.voiddo.com.

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.

## 螢幕擷圖

 * [[
 * tells settings page with public and licensed widget modes.
 * [[
 * tells widget block in the WordPress editor.
 * [[
 * public demo widget rendered inside a page.

## 適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

 *   tells widget

## 安裝方式

 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.

## 常見問題集

### 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.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈tells — Text Analysis Widget〉的開發相關工作。

參與者

 *   [ vøiddo ](https://profiles.wordpress.org/voiddo/)

[將〈tells — Text Analysis Widget〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/tells-text-analysis-widget)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/tells-text-analysis-widget/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/tells-text-analysis-widget/)，
或透過 [RSS](https://plugins.trac.wordpress.org/log/tells-text-analysis-widget/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/tells-text-analysis-widget/)。

## 變更記錄

#### 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.

## 中繼資料

 *  版本 **1.0.1**
 *  最後更新 **4 天前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.9.4**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/tells-text-analysis-widget/)
 * 標籤:
 * [intent](https://tw.wordpress.org/plugins/tags/intent/)[subtext](https://tw.wordpress.org/plugins/tags/subtext/)
   [Text-Analysis](https://tw.wordpress.org/plugins/tags/text-analysis/)
 *  [進階檢視](https://tw.wordpress.org/plugins/tells-text-analysis-widget/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/tells-text-analysis-widget/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/tells-text-analysis-widget/reviews/)

## 參與者

 *   [ vøiddo ](https://profiles.wordpress.org/voiddo/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/tells-text-analysis-widget/)