Title: Mandarin The Wild Pinyin Hover
Author: mandarinthewild
Published: <strong>November 16, 2026</strong>
Last modified: November 16, 2026

---

Search plugins

![](https://ps.w.org/mandarin-the-wild-pinyin-hover/assets/banner-772x250.png?rev
=3804736)

![](https://ps.w.org/mandarin-the-wild-pinyin-hover/assets/icon-256x256.png?rev=
3804736)

# Mandarin The Wild Pinyin Hover

 By [mandarinthewild](https://profiles.wordpress.org/mandarinthewild/)

[Download](https://downloads.wordpress.org/plugin/mandarin-the-wild-pinyin-hover.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/mandarin-the-wild-pinyin-hover/#description)
 * [Reviews](https://wordpress.org/plugins/mandarin-the-wild-pinyin-hover/#reviews)
 *  [Installation](https://wordpress.org/plugins/mandarin-the-wild-pinyin-hover/#installation)
 * [Development](https://wordpress.org/plugins/mandarin-the-wild-pinyin-hover/#developers)

 [Support](https://wordpress.org/support/plugin/mandarin-the-wild-pinyin-hover/)

## Description

Activate it and every Chinese word on your site explains itself. A reader points
at a word (or taps it on a phone) and sees:

 * its pinyin in tone colours, with the tone changes it really takes in that sentence(
   不是 is búshì),
 * its meaning in that sentence, and other meanings,
 * its HSK level,
 * a Listen button,
 * the characters inside a longer word,
 * a link to the word’s page with examples and stroke order.

It reads each word in its sentence, so 喝茶 is “to drink tea”, not 喝 and 茶 apart.
Simplified and traditional characters both work. Nothing runs until a reader points
at Chinese, and code blocks, text fields and anything marked `data-mtw-hover="off"`
are left alone.

For teachers’ class sites, Chinese learning blogs, recipe and tea sites, tai chi
and martial arts schools, and anyone who writes Chinese words for readers who are
still learning them.

### External services

This plugin loads one script from Mandarin The Wild, https://mandarinthewild.com/
hover.js, on your site’s pages. When a reader points at or taps a Chinese word, 
the script sends the sentence that word is in to https://mandarinthewild.com/api/
site-hover and shows the answer; when the reader presses Listen, it plays the word’s
recording from mandarinthewild.com. Only that sentence is sent, with your site’s
address as every browser sends it; no cookie is set, nothing is stored about the
reader, and we count only how many words each site’s readers looked up, by site 
name.

 * Service: https://mandarinthewild.com/pinyin-for-your-website
 * Privacy policy: https://mandarinthewild.com/privacy
 * Terms: https://mandarinthewild.com/terms

## Screenshots

[⌊A reader points at a word in a blog post and sees its pinyin, its meaning in that
sentence, its HSK level and a Listen button.⌉⌊A reader points at a word in a blog
post and sees its pinyin, its meaning in that sentence, its HSK level and a Listen
button.⌉[

A reader points at a word in a blog post and sees its pinyin, its meaning in that
sentence, its HSK level and a Listen button.

[⌊On a phone, a tap opens the same card: 龙井茶 is read as one word, Longjing tea,
with each part beneath it.⌉⌊On a phone, a tap opens the same card: 龙井茶 is read
as one word, Longjing tea, with each part beneath it.⌉[

On a phone, a tap opens the same card: 龙井茶 is read as one word, Longjing tea,
with each part beneath it.

## Installation

 1. In your dashboard, go to Plugins, Add New, and search for “Mandarin The Wild”.
 2. Press Install Now, then Activate.

That is all: every Chinese word on your site now explains itself. To leave a part
of a page alone, add `data-mtw-hover="off"` to its HTML (a block’s ⋮ menu, Edit 
as HTML).

## FAQ

### Is it free?

Yes, with no account and no limit for your readers.

### Will it slow my site down?

No. The script is about 9 KB compressed, loads after your page, and asks for nothing
until a reader points at a Chinese word.

### Does it work with my theme, page builder or cache plugin?

Yes. It reads the text readers see after the page has loaded, so it works with block
and classic themes, page builders and cached pages alike, and needs no setup.

### Can I turn it off on part of a page?

Yes. Add `data-mtw-hover="off"` to any element (in the block editor, the block’s
⋮ menu, Edit as HTML) and the words inside it are left alone. Text fields and code
blocks are always left alone.

### Does it add a link to my site?

Not to your pages. The card a reader opens links to that word’s page on mandarinthewild.
com (examples and stroke order) and names Mandarin The Wild, as the service’s own
card. A credit link at the end of your pages shows only if you turn on Settings,
Pinyin hover, Credit link; it is off until you do.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Mandarin The Wild Pinyin Hover” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ mandarinthewild ](https://profiles.wordpress.org/mandarinthewild/)

[Translate “Mandarin The Wild Pinyin Hover” into your language.](https://translate.wordpress.org/projects/wp-plugins/mandarin-the-wild-pinyin-hover)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/mandarin-the-wild-pinyin-hover/),
check out the [SVN repository](https://plugins.svn.wordpress.org/mandarin-the-wild-pinyin-hover/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/mandarin-the-wild-pinyin-hover/)
by [RSS](https://plugins.trac.wordpress.org/log/mandarin-the-wild-pinyin-hover/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * First release.

## Meta

 *  Version **1.0.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [chinese](https://wordpress.org/plugins/tags/chinese/)[dictionary](https://wordpress.org/plugins/tags/dictionary/)
   [mandarin](https://wordpress.org/plugins/tags/mandarin/)[pinyin](https://wordpress.org/plugins/tags/pinyin/)
   [tooltip](https://wordpress.org/plugins/tags/tooltip/)
 *  [Advanced View](https://wordpress.org/plugins/mandarin-the-wild-pinyin-hover/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/mandarin-the-wild-pinyin-hover/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/mandarin-the-wild-pinyin-hover/reviews/)

## Contributors

 *   [ mandarinthewild ](https://profiles.wordpress.org/mandarinthewild/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/mandarin-the-wild-pinyin-hover/)