philo/laravel-translate

Translation manager for Laravel 5

Installs: 6 656

Dependents: 2

Stars: 56

Watches: 10

Forks: 7

Open Issues: 4

Language: PHP

v2.0.1 2015-02-02 21:00 UTC

README

68747470733a2f2f706f7365722e707567782e6f 68747470733a2f2f706f7365722e707567782e6f

Managing translations can be a pain, switching between different language files, adding new strings, keeping everything in sync and removing translations which are no longer being used.

But that's in the past if you install this package!

Features

Lets take a look at all the features included in this package.

Adding new translations

To add a new translation you need to open your terminal, and run the following command:

php artisan translate:add [--bench[="..."]] [--no-entities] <group> <line>

So for a example: php artisan translate:add profile first_name

1

As you can see, you will get the blade syntax returned so you can copy and paste it to your view. Adding variables to your string will result in a different syntax: php artisan translate:add profile texts.introduction

2

Translation files are dynamically generated in alphabetical order and equally spaced.

3

Removing translations

To remove translations you can use the remove command which has the same syntax as the add command:

php artisan translate:remove account upgrade

4

Clean up

The clean up command will search your files for language strings which are no longer used.

php artisan translate:cleanup

5

Foreach line that was not found, you will get a confirmation if you want to delete the line in question. In case you you don't want to confirm each line, you can add the --silent parameter.

php artisan translate:cleanup --silent

By default the clean up command will look through all your language files. In case you want to focus on one specific group, you can add the --group="account" parameter.

php artisan translate:cleanup --group="account"

Installation

The package can be installed via Composer by requiring the "philo/laravel-translate": "~2.0" package in your project's composer.json.

{
    "require": {
        "laravel/framework": "5.*",
        "philo/laravel-translate": "~2.0"
    },
    "minimum-stability": "dev"
}

Next you need to add the service provider to app/config/app.php

'providers' => array(
    /*
     * Application Service Providers...
     */
    'Philo\Translate\TranslateServiceProvider',
)

Config

You can publish the config file in case you want to make some adjustments to the clean up command: php artisan vendor:publish

<?php
return array(
    'search_ignore_folders' => array('commands', 'config', 'database', 'lang', 'start', 'storage', 'tests'),
    'search_exclude_files'  => array('pagination', 'reminders', 'validation'),
    'digg_folders'          => array('app/models', 'app/views', 'app/controllers'),
);
Notes

When you start using the translation manager you need to make sure that all your translation files are in sync.