Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dereuromark/cakephp-translate
A CakePHP plugin to manage translations of your static content the easy way via web backend.
https://github.com/dereuromark/cakephp-translate
cakephp cakephp-plugin i18n po-files translation
Last synced: about 1 month ago
JSON representation
A CakePHP plugin to manage translations of your static content the easy way via web backend.
- Host: GitHub
- URL: https://github.com/dereuromark/cakephp-translate
- Owner: dereuromark
- License: mit
- Created: 2017-04-22T13:22:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-27T14:00:13.000Z (6 months ago)
- Last Synced: 2024-10-27T22:11:03.650Z (about 2 months ago)
- Topics: cakephp, cakephp-plugin, i18n, po-files, translation
- Language: PHP
- Homepage:
- Size: 439 KB
- Stars: 17
- Watchers: 3
- Forks: 3
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cakephp - Translate plugin - Manage translations of your static content the easy way via web backend, incl. import from POT files, auto-suggest and auto-translate via API. (I18n)
README
# CakePHP Translate Plugin
[](https://github.com/dereuromark/cakephp-translate/actions/workflows/ci.yml?query=branch%3Amaster)
[](https://codecov.io/github/dereuromark/cakephp-translate/branch/master)
[](https://packagist.org/packages/dereuromark/cakephp-translate)
[](https://php.net/)
[](https://packagist.org/packages/dereuromark/cakephp-translate)
[](https://packagist.org/packages/dereuromark/cakephp-translate)
[](https://github.com/php-fig-rectified/fig-rectified-standards)
A CakePHP plugin for managing translations DB driven.
This branch is for use with **CakePHP 5.0+**. For details see [version map](https://github.com/dereuromark/cakephp-translate/wiki#cakephp-version-map).
WARNING: Not fully upgraded yet, help needed!
## Key features
- Import from POT, PO files or any service/API.
- Web-based and without external dependencies.
- Translate strings in all languages simultaneously.
- Allow others to help translating without having to know technical details.
- Auto-Translate and Auto-Suggest with Translate APIs (e.g. Google Translate PHP/JS, Yandex, ...) for efficiency.
## Benefits over normal PO editing
- Prevent duplicates, missing translations, collisions.
- Auto-Features like `trim()`, `h()`, newlines to `
/
`, espacing of `%s`.
- Validate placeholders (`{0}`, `%s`, ...).
- Preview and code excerpts of references.
- Auto-Add Controller names (singular + plural).
- Manage in Groups (=Domains) and export/enable/disable them.
- Creates clean PO files with all translations in usage to easier diff changes.
## Included translation services via APIs
- Google (free, limited)
- Yandex (free, limited)
- Transltr (free)
Add your translation engine here [in a heartbeat](docs#add-your-own-implementation).
## Installation
Including the plugin is pretty much as with every other CakePHP plugin:
```bash
composer require dereuromark/cakephp-translate
```
Then, to load the plugin run the following command:
```sh
bin/cake plugin load Translate -b -r
# If you haven't loaded the Tools plugin already
bin/cake plugin load Tools -b -r
```
Routes are needed for the backed, the bootstrap sets up a few defaults.
Run this in console to create the necessary DB tables:
```
bin/cake migrations migrate -p Translate
```
### Recommendations
Use `dereuromark/cakephp-queue` for larger projects to avoid timeout issues when importing PO files.
## Usage
Web Backend
- Navigate to `/admin/translate/` in your browser.
CLI
- Run `bin/cake translate`.
## Tips
- Use [TinyAuth](https://github.com/dereuromark/cakephp-tinyauth) or alike to manage access to the translation backend for user groups.
- Implement your own Translation engine if you want to have even better auto-suggest.
## Configuration and documentation
- [Documentation](docs)