HTBD is a free and open-source Wordpress multilingual plugin based on Baidu Translation API

HTBD is a WordPress multilingual translation plugin that uses the Baidu Translation Open Platform API to translate articles, pages, and other content on a website into different languages and generate independent language access addresses for the translations.

The plugin will save the translation results on the server. Unless the user actively refreshes the translation, the same content only needs to be translated once in the same target language, without the need to repeatedly call the translation API every time the page is accessed, which helps reduce API requests and improve page loading speed.

Project address

Main functions

Baidu Translation API Integration

HTBD uses the translation API provided by Baidu Translation Open Platform. Users can configure their own App ID and key in the WordPress backend, and have the plugin handle request signing, translation calls, and error handling.

Article and page translation

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

  • Title
  • Body text
  • Abstract
  • SEO Fields
  • Image replaces text
  • Tag
  • Category Directory
  • Partial interface text

Multilingual access address

HTBD can generate independent access addresses for different languages, supporting:

  • Language subdirectories, such as /en/The/jp/
  • Bind different domain names in different languages
  • Generate fixed links for the corresponding language based on the configuration

Translation result persistence

After the translation is completed, the results will be saved in the WordPress server. When accessing the same translation in the future, the plugin will prioritize reading the saved results instead of requesting the Baidu Translation API again.

When the original text changes, the corresponding translation will be marked as needing to be updated to avoid continuing to use old translations that are inconsistent with the original text.

WordPress content compatibility

When translating content, plugins will try to preserve:

  • Gutenberg block tagging
  • HTML Structure
  • Shortcode Short code
  • placeholder
  • URL
  • Protected special content

Multilingual SEO

HTBD provides necessary SEO support for multilingual pages, including:

  • Multi language fixed links
  • Canonical URL
  • hreflang Multilingual Link
  • Site map compatibility
  • SEO field translation

Failed rollback

If the Baidu Translation API request fails, the plugin will not cause the website page to report an error:

  • If there is no available translation, display the source language content of the website.
  • If there are previously successfully saved translations, continue to use the old translation.

Quick Start

1、 Get Baidu Translation API

  1. openBaidu Translation Open Platform.
  2. Register or log in to a Baidu account.
  3. Enter the management console.
  4. Open the universal text translation API service.
  5. Create an application and fill in the application information.
  6. Get it on the application management page APP ID and Key.

The APP ID and key are sensitive information, please do not submit them to public GitHub repositories, and do not expose them through web front-end code or public logs.

Please refer to the specific activation method, billing rules, and call restrictions of Baidu Translation APIOfficial documentation of Baidu Translation API.

2、 Install plugins

As the plugin has not yet been approved by WordPress.org, it needs to be manually installed from GitHub.

2026.08.01 Update: Approved and can be downloaded directly from the official WordPress plugin search.

Method 1: Upload ZIP compressed file

  1. visit HTBD GitHub repository.
  2. Click Releases.
  3. Download zip file from the latest version
  4. Log in to the WordPress management backend.
  5. Open "Plugin" → "Install Plugin".
  6. Click on 'Upload Plugin'.
  7. Select the downloaded ZIP file and start the installation.
  8. Enable HTBD after installation is complete.

Method 2: Upload to the server

  1. visit HTBD GitHub repository.
  2. Click Releases.
  3. Download zip file from the latest version
  4. Translate into English HTBD Upload directory to WordPress plugin directory: wp-content/plugins/hyx-translator-for-baidu-translate/
  5. Log in to the WordPress management backend.
  6. Open "Plugin" → "Installed Plugin".
  7. Find HTBD and click 'Enable'.

3、 Configure plugins

  1. Log in to the WordPress management backend.
  2. Open the HTBD settings page.
  3. Fill in the form provided by Baidu Translation Open Platform APP ID and Key.
  4. Set the source language for the website.
  5. Add the target language that needs to be enabled.
  6. Choose the language URL mode, such as language subdirectories or domain name binding.
  7. Save settings.

After modifying the language routing settings, it is recommended to open "Settings" ->"Fixed Links" in the WordPress backend and confirm that the fixed link configuration has taken effect correctly.

4、 Start using

  1. Open the article or page that needs to be translated in the WordPress backend.
  2. Save or update content.
  3. Generate target language translations using the translation function provided by HTBD.
  4. Waiting for the translation task to be completed.
  5. Check the translation by accessing the corresponding language address.

For example, suppose the source language page address is:

https://example.com/about/

English usage /en/ When it comes to subdirectories, the translation address is:

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

Japanese usage /jp/ When it comes to subdirectories, the translation address is:

https://example.com/jp/about/

The plugin will prioritize using saved translations. Only when the original text changes, the translation becomes invalid, or the user requests a refresh, is it necessary to call the translation API again.

Usage recommendations

  • Before officially launching, please check the fixed links and multilingual routing in the testing environment.
  • Set reasonable call limits and security policies for Baidu Translate API.
  • Do not save API keys in source code, frontend JavaScript, or public logs.
  • Before publishing the translation, it is recommended to manually check the brand name, professional terminology, and important pages.
  • After modifying the original text, it is necessary to check whether the corresponding language translation needs to be updated.
  • When configuring domain name binding, it is necessary to complete DNS, HTTPS certificate, and server domain name settings simultaneously.
  • After modifying the language routing, please check the Canonical URLhreflang Is the site map correct.

system requirements

  • WordPress 6.4 or higher version
  • PHP 8.1 or higher version
  • A server network environment that can access Baidu Translate API normally
  • Effective Baidu Translation Open Platform APP ID and Key

Problem feedback and contribution

If you encounter any problems during use or wish to submit feature suggestions, you can go to the GitHub repository to provide feedback:

https://github.com/hanyixuanten/HTBD

When submitting a question, it is recommended to provide the following information:

  • WordPress version
  • PHP version
  • HTBD version
  • Language and routing mode used
  • Problem reproduction steps
  • Hidden error logs of sensitive information

Welcome to participate in the improvement of HTBD through Issue or Pull Request.

相关文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注