albertofem/translatableroutepath-bundle

JpnForPhp Symfony2 bundle integration

TranslatableRoutePathBundle

, _(*1)

Allows using translations in routes paths:, _(*2)

/**
 * @Route("/[my.translatable.key]/route/{param}", options={"translatable"=true})
 */
public function myAction()
{
}

If my.transatable.key is defined in English as: my_translatable_route, this will produce a route:, _(*3)

/my_translatable_route/route/whatever_param

Installation

Require it in composer:, _(*4)

composer require albertofem/translatableroutepath-bundle dev-master

Install it:, _(*5)

composer update albertofem/translatableroutepath-bundle

Add it to your bundles:, _(*6)

$bundles = array(
    ...,
    new \AFM\Bundle\TranslatableRoutePathBundle\AFMTranslatableRoutePathBundle()
);

Additionally, you can use this bundle with JMSI18nRoutingBundle in which case you will need to register it before this one:, _(*7)

$bundles = array(
    ...
    new \JMS\I18nRoutingBundle\JMSI18nRoutingBundle(),
    new \AFM\Bundle\TranslatableRoutePathBundle\AFMTranslatableRoutePathBundle()
);

If you need to run the tests:, _(*8)

./vendor/bin/phpunit

Usage

You need to add the option to your route to be translatable:, _(*9)

/**
 * @Route("/[my.translatable.key]/route/{param}", options={"translatable"=true})
 */
public function myAction()
{
}

Using YAML:, _(*10)

my_translatable_route:
    path: /[my.translatable.key]/route/{param}
    options: { translatable: true }

Use the syntax [...] to referer to translations in your routes paths. You can use this syntax in annotations/yaml/PHP indistintively., _(*11)

Integration with JMSI18nRoutingBundle

If your are using this great bundle, routes will be automatically translated to all the locales set in the configuration., _(*12)

Integration with Symfony core Router

When using Symfony core router, all routes are translated into the default locale. If you need a Route to be translated in another language, you must specify the _locale default parameter:, _(*13)

my_translatable_route:
    path: /[my.translatable.key]/route/{param}
    options: { translatable: true }
    defaults: { _locale: en } # this route will translated in English

TODO

• Support parameters for translations (domains, etc.)
• Support transChoice