jlaso/translations-apibundle

Client API for https://www.tradukoj.com

, _(*1)

Overview

This bundle permits API comunication with https://www.tradukoj.com, _(*2)

In order to install this bundle you need to pay attention with requiremens:, _(*3)

php > 5.3.7
php-lzf extension must be installed (try sudo pecl install lzf)

Installation

Checkout a copy of the code:, _(*4)

// in composer.json
"require": {
    // ...
    "jlaso/translations-apibundle": "*"
    // ...
},

Then register the bundle with your kernel:, _(*5)

// in AppKernel::registerBundles()
$bundles = array(
    // ...
    new JLaso\TranslationsApiBundle\TranslationsApiBundle(),
    // Excel Bundle
    new Liuggio\ExcelBundle\LiuggioExcelBundle(),
    // ...
);

Configuration

// in app/config/parameters.yml
###############################
##   TRANSLATIONS API REST   ##
###############################
jlaso_translations_api_access:
    project_id: 1 # the number that correspond to the project created
    key:  1234  # the key that systems assigns
    secret: 1234  # the password that you choose when init project in server
    url: http://www.tradukoj.com/app.php/api/


// in app/config/config.yml
translations_api:
    default_locale: %locale%
    managed_locales: ['es', 'en', 'fr', 'ca']  # the languages you want

and remember to enable translator in framework key
framework:
    translator:      { fallback: %locale% }

Usage

first schema:update to init database with SCM table:, _(*6)

app/console doctrine:schema:update --force --env=dev

now, fill the local database with the content of your translations/catalog.locale.yml files, _(*7)

app/console jlaso:translations:dump

and next upload your messages form local database to remote server, _(*8)

app/console jlaso:translations:sync --upload-first=yes
when you use the bundle first time is necessary the use the upload-first option in order to generate the remote db

Examples

For synchronize local translations with server (remote) translations:, _(*9)

app/console jlaso:translations:sync [--cache-clear] [--backup-files]

In the view, _(*10)

Currently only be used yaml files in src/Company/bbbBundle/Resource/translations/messages.xx.yml
with xx as locale, and bbb as bundle name,
same for translations resources of app located at app/Resources/messages.xx.yml