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


Installation
- In your dashboard, go to Plugins, Add New, and search for “Mandarin The Wild”.
- 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.
ContributorsTranslate “Mandarin The Wild Pinyin Hover” 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.0
- First release.
