Effortless Taiwan Mandarin Helper

Effortless Taiwan Mandarin Helper translates any text into natural Taiwanese Mandarin (Traditional Chinese as used in Taiwan). Results include Hanyu Pinyin with tone marks and Bopomofo annotations rendered with the BpmfHuninn font.

Features:

• Admin quick-lookup tool (WP Admin → Tools → Mandarin Translator)

• Embeddable front-end shortcode: [eltmh_translator] or [eltmh_translator text="Hello"]

• Supports OpenAI (ChatGPT 4o, default), Anthropic (Claude), or WordPress’s own core AI Client (WP 7.0+, site-configured provider)

• Indefinite translation cache — identical inputs never hit the API twice

• Detects source language automatically

• Settings → Mandarin Helper → Display: site-wide show/hide toggles for each result row (Original, Chinese, Pinyin, Bopomofo, English), overridable per-shortcode

Shortcode Usage

Basic (visitor types their own text):

[eltmh_translator]

With preset text (pre-fills the textarea; renders immediately if already cached):

”]

External services

This plugin relies on a third-party AI API, chosen by the site administrator in Settings → Mandarin Helper, to perform the translation. The text a visitor submits through the shortcode form is sent to whichever provider is configured — no other data (name, email, IP address) is sent.

• OpenAI API — Used when OpenAI is selected as the provider (default). The submitted text is sent to OpenAI’s Chat Completions API (the model chosen in the settings: gpt-4o-mini by default, gpt-6-luna, gpt-5-nano, gpt-5.4-mini or gpt-5-mini). To list the models in the settings, the API key is also sent to OpenAI’s model list ( GET /v1/models ) from the settings page, at most every 12 hours; no content is sent with it to generate the translation, Pinyin and Bopomofo. Terms: https://openai.com/policies/row-terms-of-use/ — Privacy policy: https://openai.com/policies/row-privacy-policy/

• Anthropic API — Used when Anthropic is selected as the provider. The submitted text is sent to Anthropic’s Messages API (model: claude-sonnet-4-6) to generate the translation, Pinyin and Bopomofo. Terms: https://www.anthropic.com/legal/consumer-terms — Privacy policy: https://www.anthropic.com/legal/privacy

• WordPress AI Client — Used when “WordPress AI Client” is selected as the provider. The plugin makes no direct API call in this case; it delegates to whichever AI provider the site administrator has already configured for WordPress core (WP 7.0+). Refer to that provider’s own terms and privacy policy.