Code Monkey home page Code Monkey logo

cakephp-transifex's Introduction

CakePHP Transifex Plugin

Build Status License Total Downloads

A CakePHP 2.x Plugin that works with Transifex and pulls/pushes translations. It uses the Transifex API v2.

Please note: New functionality has been tested against latest CakePHP v2.x only. Please upgrade if possible.

Installation

Installing the Plugin is pretty much as with every other CakePHP Plugin.

  • Put the files in APP/Plugin/Transifex
  • Make sure you have CakePlugin::load('Transifex') or CakePlugin::loadAll() in your bootstrap

Create an account at transifex.com and create/join a project and resources.

Put the information regarding project, user and password in your config file or your bootstrap

$config['Transifex'] = array(
	'project' => 'cakephp',
	'user' => '...',
	'password' => '...');

That's it. It should be up and running.

Usage

To get a list of supported resources for the current project:

cake Transifex.Transifex resources

To get a list of supported languages:

cake Transifex.Transifex languages

Statistics for a resource can be garthered using

cake Transifex.Transifex statistics

To actually update your Locale folder, use

cake Transifex.Transifex pull

It will prompt for language and resource (use * to import all).

A shortcut to import a specific language for a specific resource, you can also use

cake Transifex.Transifex pull -l {language} -r {resource}

The PO files will be stored in APP/Locale/{locale}/LC_MESSAGES/{resource}.po. Using subversion or git is highly recommended to quickly overview and confirm the changes made.

Advanced usage

You can pull reviewed translations only using --reviewed-only or -R:

cake Transifex.Transifex pull -R

To pull locales for a plugin you need to set --plugin or -p:

cake Transifex.Transifex pull -p Tools

They will then be stored in the Plugin Locale folder.

If you happen to have one primary project and several other (plugin or CakePHP core) projects, you can overwrite the config project setting using --project or -P:

cake Transifex.Transifex pull -P cakephp

Tip: If you want to dry-run it first, use -d -v. This will not modify your locale files but simulate the import.

Debugging

Use --debug to have more verbose debugging output when pushing via cURL.

TODO

  • More tests
  • Upgrade to CakePHP 3.0

Disclaimer

Use at your own risk. Please provide any fixes or enhancements via issue or better pull request.

cakephp-transifex's People

Contributors

jrbasso avatar beinbm avatar

Watchers

James Cloos avatar Ilkka Pale avatar  avatar Ivan Toth avatar  avatar Felix avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.