HyperMew AI Translator

HyperMew AI Translator is a high-performance, developer-friendly translation plugin that integrates modern language model routing directly inside your WordPress post edit screens. Powered by the OpenRouter API, it translates your content fields to a variety of target languages within seconds.

Key features include:
* Gutenberg & Classic Editors: Complete sidebar integration in Gutenberg and a custom metabox inside the Classic Editor.
* Granular Field Selection: Translate the Title, Content, Excerpt, or any arbitrary custom fields simultaneously.
* Custom Field Mapping: Define translatable fields dynamically using custom CSS selectors to target specific page elements.
* Performance Caching: Local caching via the WordPress Transients API preserves translations for 24 hours to speed up repeated edits and minimize API usage.
* System Prompt Customization: Customize the core instructions sent to translation models, with full support for HTML tag preservation and specific typography rules.
* Dynamic Model Selection: Connect to any model on OpenRouter, with visual badges highlighting free tiers, fast options, and auto-routing models.
* Tabbed Settings Dashboard: A fully responsive settings page with slide-in tab transitions and persisted navigation states.

External Service Integration

This plugin relies on the external service OpenRouter (https://openrouter.ai) to perform translation requests.
* Service URL: https://openrouter.ai
* Terms of Service: https://openrouter.ai/terms
* Privacy Policy: https://openrouter.ai/privacy
* Data Transmission: When you perform a translation, the selected text, chosen target language, system prompt guidelines, and your configured API key are securely transmitted via HTTPS requests to OpenRouter’s API endpoint (https://openrouter.ai/api/v1/chat/completions). No other personal or site details are shared.

Help & Guide

Step-by-Step Translation Guide

1. Open any supported Post or Page.
2. Write or paste your content in the Title, Content, Excerpt, or Custom text area.
3. Observe that the translation panel automatically detects which fields contain text and lights them up.
4. Select the field(s) you wish to translate.
5. Select your target language from the buttons group.
6. Click Translate Now.
7. The fields will temporarily disable during execution and then update automatically.

System Prompt Best Practices

Use the system prompt to guide your translation model. Always keep the {target-lang} placeholder, which is replaced dynamically. To prevent models from breaking layouts, instruct them to preserve:
* WordPress blocks and shortcodes (e.g., [gallery])
* HTML tags and attribute values (e.g., class names, URLs)
* Typography preferences (e.g., prohibiting em dashes)