HTBD is a multilingual translation plugin for WordPress. It uses the Baidu Translate API to translate posts, pages, and other website content into different languages, with a dedicated URL for each translated version.

Translations are stored on the server in {$wpdb->prefix}hyx_bd_translations. Unless a user explicitly refreshes a translation, the same content is translated only once for each target language. Existing {$wpdb->prefix}btranslate_translations data is migrated when the renamed plugin is activated. This avoids calling the translation API on every page visit, reducing API usage and improving page load performance.

Project Links

Plugin homepage: https://www.vblg.top/index.php/archives/147
GitHub repository: https://github.com/hanyixuanten/HTBD
WordPress plugin page: https://wordpress.org/plugins/hyx-translator-for-baidu-translate/

Review status: HTBD has not yet been approved for the WordPress.org Plugin Directory, so it cannot currently be installed directly from the WordPress admin plugin marketplace. For now, download it from GitHub and install it manually.

Key Features

Baidu Translate API Integration

HTBD uses the translation API provided by the Baidu Translate Open Platform. Users can configure their own App ID and secret key in WordPress Admin, and the plugin handles request signing, API calls, and error handling.

Post and Page Translation

The plugin supports translating the main content of WordPress posts and pages, including:

Titles
Body content
Excerpts
SEO fields
Image alternative text
Tags
Categories
Selected interface text

Multilingual URLs

HTBD can generate dedicated URLs for different languages, with support for:

Language subdirectories such as /en/ and /ja/
A separate domain for each language
Language-specific permalinks based on the configured routing mode

Persistent Translations

After a translation is generated, it is stored on the WordPress server. Future requests for the same translation use the stored result instead of calling the Baidu Translate API again.

When the source content changes, the corresponding translation is marked as requiring an update, preventing an outdated translation from being used for changed content.

WordPress Content Compatibility

When translating content, the plugin makes every effort to preserve:

Gutenberg block markup
HTML structure
Shortcodes
Placeholders
URLs
Content inside <pre> and <code> elements, which is left untranslated
Protected special content

Multilingual SEO

HTBD provides essential SEO support for multilingual pages, including:

Multilingual permalinks
Canonical URLs
hreflang alternate links
Sitemap compatibility
SEO field translation

Failure Fallback

If a Baidu Translate API request fails, the plugin does not cause the website page to fail:

If no translation is available, the website's source-language content is displayed.
If a previously saved successful translation exists, the previous translation continues to be used.

Quick Start

1. Get Access to the Baidu Translate API

Open the Baidu Translate Open Platform.
Register or sign in with a Baidu account.
Open the management console.
Activate the General Text Translation API service.
Create an application and enter the required application information.
Obtain the APP ID and secret key from the application management page.

Your APP ID and secret key are sensitive credentials. Do not commit them to a public GitHub repository or expose them in front-end code or public logs.

For activation instructions, pricing, and usage limits, see the official Baidu Translate API documentation.

2. Install the Plugin

Because the plugin has not yet been approved for the WordPress.org Plugin Directory, it must currently be installed manually from GitHub.

Method 1: Upload the ZIP Package

Visit the HTBD GitHub repository.
Select Releases.
Download the hyx-translator-for-baidu-translate-*.zip file from the latest release.
Sign in to WordPress Admin.
Open Plugins > Add New Plugin.
Select Upload Plugin.
Choose the downloaded ZIP file and start the installation.
Activate HTBD after installation is complete.

Method 2: Upload to the Server

Visit the HTBD GitHub repository.
Select Releases.
Download the hyx-translator-for-baidu-translate-*.zip file from the latest release.
Upload the hyx-translator-for-baidu-translate directory to the WordPress plugin directory: wp-content/plugins/hyx-translator-for-baidu-translate/.
Sign in to WordPress Admin.
Open Plugins > Installed Plugins.
Find HTBD and select Activate.

3. Configure the Plugin

Sign in to WordPress Admin.
Open the HTBD settings page.
Enter the APP ID and secret key provided by the Baidu Translate Open Platform.
Set the website's source language.
Add the target languages you want to enable.
Select a language URL mode, such as language subdirectories or domain binding.
Save the settings.

After changing language routing settings, open Settings > Permalinks in WordPress Admin and confirm that the permalink configuration is working correctly.

4. Start Translating

Open the post or page you want to translate in WordPress Admin.
Save or update the content.
Use the translation feature provided by HTBD to generate translations for the target languages.
Wait for the translation tasks to finish.
Check each translation at its language-specific URL.

For example, suppose the source-language page is available at:

https://example.com/about/

When English uses the /en/ subdirectory, its translated URL is:

https://example.com/en/about/

When Japanese uses the /ja/ subdirectory, its translated URL is:

https://example.com/ja/about/

The plugin prioritizes saved translations. It calls the translation API again only when the source content changes, a translation becomes invalid, or a user explicitly requests a refresh.

Recommendations

Test permalinks and multilingual routing in a staging environment before enabling the plugin in production.
Set appropriate usage quotas and security policies for the Baidu Translate API.
Do not store API credentials in source code, front-end JavaScript, or public logs.
Manually review brand names, technical terminology, and important pages before publishing translations.
After changing source content, check whether the corresponding translations need to be updated.
When configuring domain binding, also configure DNS, HTTPS certificates, and the server's domain settings.
After changing language routing, verify that canonical URLs, hreflang links, and sitemaps are correct.

System Requirements

WordPress 6.4 or later
PHP 8.1 or later
A server environment that can connect to the Baidu Translate API
A valid Baidu Translate Open Platform APP ID and secret key

Feedback and Contributions

To report a problem or suggest a feature, visit the GitHub repository:

https://github.com/hanyixuanten/HTBD

When opening an issue, consider including the following information:

WordPress version
PHP version
HTBD version
Languages and routing mode in use
Steps to reproduce the problem
Error logs with sensitive information removed

Contributions through issues and pull requests are welcome.