wearerequired/traduttore

WordPress.org-style translation API for your WordPress projects.

3.2.0 2022-01-18 17:05 UTC

Requires

• php: >=7.1
• ext-json: *
• ext-zip: *
• wearerequired/traduttore-registry: ^2.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^0.7.0
• php-stubs/wp-cli-stubs: ^2.4
• phpunit/phpunit: ^7.5.20
• szepeviktor/phpstan-wordpress: ^1.0.2
• wearerequired/coding-standards: ^1.5
• wp-cli/extension-command: ^2.0
• wp-cli/rewrite-command: ^2.0
• wp-cli/wp-cli-tests: ^3.0.11
• wpackagist-plugin/glotpress: ^2.3.1

Suggests

• wpackagist-plugin/slack: Send Slack notifications for various events

GPL-2.0-or-later

• required
• Dominik Schilling
• Ulrich Pogson
• Pascal Birchler

• wordpress
• translations
• glotpress

README

Traduttore is a WordPress plugin that allows you to host your own WordPress.org-style translation API for your WordPress projects.

How it Works

Working on a multilingual WordPress project with custom plugins and themes can be quite cumbersome. Every time you add new strings to the project, you have to regenerate POT files and update the PO/MO files for every locale. All these changes clutter the history of your Git repository and are prone to errors as well. Plus, you can't easily send these translation files to your clients.

These problems don't exist for plugins and themes hosted on WordPress.org, as they benefit from the translate.wordpress.org translation platform. Whenever you publish a new version of your project, WordPress.org makes sure that new strings can be translated. With Traduttore, you can now get the same experience for your custom projects hosted on GitHub!

Every time you commit something to your plugin or theme, Traduttore will extract translatable strings using WP-CLI and add import these to GlotPress.

Then, you (or even your clients!) can translate these strings right from within GlotPress. Whenever translations are edited, Traduttore will create a ZIP file containing PO and MO files that can be consumed by WordPress. A list of available ZIP files is exposed over a simple API endpoint that is understood by WordPress.

Using our little helper library called Traduttore Registry, you can then tell WordPress that translations for your project should be loaded from that API endpoint.

After that, you never have to worry about the translation workflow ever again!

Features

• Automatic string extraction
• ZIP file generation and caching
• Works with any WordPress plugin or theme hosted on GitHub
• Custom WP-CLI commands to manage translations
• Supports Restricted Site Access
• Supports sending Slack notifications