Installation

Install the plugin and migrations from your application directory:

composer require dereuromark/cakephp-translate cakephp/migrations

Composer declares the supported PHP and CakePHP versions. For older applications, see the version map.

Load Translate with its bootstrap and routes:

bin/cake plugin load Translate

Load Migrations if your application has not already loaded it, then create the plugin tables:

bin/cake plugin load Migrations
bin/cake migrations migrate -p Translate

Translate does not require the Tools plugin. If your application loads Tools, the admin backend uses its pagination element; otherwise it uses the pagination element included with Translate.

Use quoteIdentifiers => true in the application datasource configuration: the schema contains names such as default and primary. Keep translation strings and contexts case-sensitive so messages that differ only in case remain distinct.

Continue with Getting started. Loading the routes also exposes the public /translate interface. That interface permits public projects and requires the admin gate for private projects. The admin interface denies access until you configure its gate. To supply only custom routes, load the plugin with routes => false in application bootstrap and define the routes you need.