{"id":401664,"date":"2026-11-16T10:00:21","date_gmt":"2026-11-16T10:00:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/mandarin-the-wild-pinyin-hover\/"},"modified":"2026-11-16T09:59:57","modified_gmt":"2026-11-16T09:59:57","slug":"mandarin-the-wild-pinyin-hover","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/mandarin-the-wild-pinyin-hover\/","author":23602323,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Mandarin The Wild Pinyin Hover","header_author":"Mandarin The Wild","header_description":"Pinyin, the meaning in context and audio on every Chinese word of your site, when a reader points at it or taps it.","last_updated":"2026-11-16 09:59:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/mandarinthewild.com\/pinyin-for-your-website","header_author_uri":"https:\/\/mandarinthewild.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":52,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"mandarinthewild","date":"2026-11-16 09:59:57","revision":3804736}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3804736,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3804736,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3804736,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3804736,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3804736,"resolution":"1","location":"assets","locale":"","width":2400,"height":1240},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3804736,"resolution":"2","location":"assets","locale":"","width":1170,"height":2532}},"screenshots":{"1":"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.","2":"On a phone, a tap opens the same card: \u9f99\u4e95\u8336 is read as one word, Longjing tea, with each part beneath it."}},"plugin_section":[],"plugin_tags":[4316,8880,49268,4320,788],"plugin_category":[47],"plugin_contributors":[293081],"plugin_business_model":[],"class_list":["post-401664","plugin","type-plugin","status-publish","hentry","plugin_tags-chinese","plugin_tags-dictionary","plugin_tags-mandarin","plugin_tags-pinyin","plugin_tags-tooltip","plugin_category-education-and-support","plugin_contributors-mandarinthewild","plugin_committers-mandarinthewild"],"banners":{"banner":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/banner-772x250.png?rev=3804736","banner_2x":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/banner-1544x500.png?rev=3804736","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/icon-128x128.png?rev=3804736","icon_2x":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/icon-256x256.png?rev=3804736","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/screenshot-1.png?rev=3804736","caption":"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."},{"src":"https:\/\/ps.w.org\/mandarin-the-wild-pinyin-hover\/assets\/screenshot-2.png?rev=3804736","caption":"On a phone, a tap opens the same card: \u9f99\u4e95\u8336 is read as one word, Longjing tea, with each part beneath it."}],"raw_content":"<!--section=description-->\n<p>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:<\/p>\n\n<ul>\n<li>its pinyin in tone colours, with the tone changes it really takes in that sentence (\u4e0d\u662f is b\u00fash\u00ec),<\/li>\n<li>its meaning in that sentence, and other meanings,<\/li>\n<li>its HSK level,<\/li>\n<li>a Listen button,<\/li>\n<li>the characters inside a longer word,<\/li>\n<li>a link to the word's page with examples and stroke order.<\/li>\n<\/ul>\n\n<p>It reads each word in its sentence, so \u559d\u8336 is \"to drink tea\", not \u559d and \u8336 apart. Simplified and traditional characters both work. Nothing runs until a reader points at Chinese, and code blocks, text fields and anything marked <code>data-mtw-hover=\"off\"<\/code> are left alone.<\/p>\n\n<p>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.<\/p>\n\n<h3>External services<\/h3>\n\n<p>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.<\/p>\n\n<ul>\n<li>Service: https:\/\/mandarinthewild.com\/pinyin-for-your-website<\/li>\n<li>Privacy policy: https:\/\/mandarinthewild.com\/privacy<\/li>\n<li>Terms: https:\/\/mandarinthewild.com\/terms<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>In your dashboard, go to Plugins, Add New, and search for \"Mandarin The Wild\".<\/li>\n<li>Press Install Now, then Activate.<\/li>\n<\/ol>\n\n<p>That is all: every Chinese word on your site now explains itself. To leave a part of a page alone, add <code>data-mtw-hover=\"off\"<\/code> to its HTML (a block's \u22ee menu, Edit as HTML).<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20it%20free%3F\"><h3>Is it free?<\/h3><\/dt>\n<dd><p>Yes, with no account and no limit for your readers.<\/p><\/dd>\n<dt id=\"will%20it%20slow%20my%20site%20down%3F\"><h3>Will it slow my site down?<\/h3><\/dt>\n<dd><p>No. The script is about 9 KB compressed, loads after your page, and asks for nothing until a reader points at a Chinese word.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20my%20theme%2C%20page%20builder%20or%20cache%20plugin%3F\"><h3>Does it work with my theme, page builder or cache plugin?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"can%20i%20turn%20it%20off%20on%20part%20of%20a%20page%3F\"><h3>Can I turn it off on part of a page?<\/h3><\/dt>\n<dd><p>Yes. Add <code>data-mtw-hover=\"off\"<\/code> to any element (in the block editor, the block's \u22ee menu, Edit as HTML) and the words inside it are left alone. Text fields and code blocks are always left alone.<\/p><\/dd>\n<dt id=\"does%20it%20add%20a%20link%20to%20my%20site%3F\"><h3>Does it add a link to my site?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Pinyin, the meaning in context and audio on every Chinese word of your site, when a reader points at it or taps it.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/401664","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=401664"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mandarinthewild"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=401664"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=401664"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=401664"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=401664"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=401664"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=401664"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}