weglot/translate-bundle

Seamless integration of Weglot into your Symfony project

Tuesday, July 10, 2018
by Shked0wn
Repository
4 Watchers
8 Stars
768 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
2 Open issues
29 Versions
194 % Grown

The README.md

, _(*1)

Symfony Translate Bundle

, _(*2)

Overview

Seamless integration of Weglot into your Symfony project., _(*3)

Requirements

PHP version 5.5 and later
Weglot API Key, starting at free level

Installation

You can install the library via Composer. Run the following command:, _(*4)

composer require weglot/translate-bundle

When you require the bundle with symfony/flex (available for symfony/symfony:^4.0) it should ask you if you wanna execute a recipe, tell yes. Like that it will make bundle registration in config/bundles.php & default config creation in config/packages/weglot_translate.yaml., _(*5)

To use the library, use Composer's autoload:, _(*6)

require_once __DIR__. '/vendor/autoload.php';

Getting Started

Bundle Register

Symfony 4

Add Weglot bundle in the config/bundles.php:, _(*7)

return [
    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
    // ... Other bundles ...
    Weglot\TranslateBundle\WeglotTranslateBundle::class => ['all' => true],
];

Symfony 3 & 2

Add Weglot bundle to app/AppKernel.php file:, _(*8)

$bundles = array(
    new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
    // ... Other bundles ...
    new Weglot\TranslateBundle\WeglotTranslateBundle(),
);

Quick configuration

For Symfony 4, create configuration file under config/packages/weglot_translate.yaml and add following content. For Symfony 3 & 2, add following content to your app/config/config.yaml., _(*9)

weglot_translate:
    api_key: '%env(WG_API_KEY)%'
    original_language : 'en'
    cache: true
    destination_languages:
        - 'fr'
        - 'de'

This is the default configuration file, if you want more default, check next part., _(*10)

Configuration

As already said, depending on Symfony version, we've different configuration file paths: - Symfony 4: config/packages/weglot_translate.yaml - Symfony 3 & 2: app/config/config.yaml, _(*11)

There is a full configuration file:, _(*12)

weglot_translate:
  api_key: '%env(WG_API_KEY)%'
  original_language : 'en'
  cache: false
  destination_languages:
    - 'fr'
    - 'de'
  exclude_blocks:
    - '.material-icons'

This is an example of configuration, enter your own API key, your original language and destination languages that you want. - api_key : is your personal API key. You can get an API Key by signing up on Weglot. - original_language : original language is the language of your website before translation. - destination_languages : are the languages that you want your website to be translated into. - cache : if you wanna use cache or not. It's not a required field and set as false by default. Look at Caching part for more details., _(*13)

There is also a non-required parameters: - exclude_blocks : You can list here all blocks you don't want to be translated. In this example, we won't translate all DOM tags with "material-icons" class., _(*14)

Twig extensions

Hreflang links

Hreflang links are a way to describe your website and to tell webcrawlers (such as search engines) if this page is available in other languages. More details on Google post about hreflang: https://support.google.com/webmasters/answer/189077, _(*15)

You can add them through the Twig function: weglot_hreflang_render, _(*16)

Just put the function at the end of your <head> tag:, _(*17)

<html>
    <head>
        ...

        {{ weglot_hreflang_render() }}
    </head>

Language button

You can add a language button if you're using Twig with function: weglot_translate_render, _(*18)

Two layouts exists:, _(*19)


{{ weglot_translate_render(1) }}


{{ weglot_translate_render(2) }}

Language code

Simple filter to convert ISO 639-1 code to full language name. It can takes one boolean parameter that allow you to choose having english name or original language name., _(*20)

Here is some examples:, _(*21)


{{ 'bg' | language }}


{{ 'bg' | language(false) }}

Caching

We implemented usage of cache pool service for both Symfony 4 and Symfony 3 (symfony/cache bundle was released with Symfony 3, so there is no compatibility for Symfony 2)., _(*22)

If you wanna use cache, just add cache: true to this bundle configuration. It will use a file-based cache through Symfony cache.system service., _(*23)

To clear the cache, you just have to use the usual pool clear command:, _(*24)

$ php bin/console cache:pool:clear weglot_translate.cache

Examples

You'll find a short README with details about example on each repository, _(*25)

Symfony 4: https://github.com/weglot/translate-bundle-example-sf4
Symfony 3: https://github.com/weglot/translate-bundle-example-sf3
Symfony 2: https://github.com/weglot/translate-bundle-example-sf2

About

translate-bundle is guided and supported by the Weglot Developer Team., _(*26)

translate-bundle is maintained and funded by Weglot SAS. The names and logos for translate-bundle are trademarks of Weglot SAS., _(*27)

License

The MIT License (MIT), _(*28)

The Versions

10/07 2018

dev-develop

dev-develop https://weglot.com/

Seamless integration of Weglot into your Symfony project

symfony-bundle translate-bundle

Seamless integration of Weglot into your Symfony project

weglot/translate-bundle

The README.md

Symfony Translate Bundle

Overview

Requirements

Installation

Getting Started

Bundle Register

Symfony 4

Symfony 3 & 2

Quick configuration

Configuration

Twig extensions

Hreflang links

Language button

Language code

Caching

Examples

About

License

The Versions

dev-develop

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

by Baptiste Leduc

dev-master

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.7.2

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

dev-feature/api-host-optional-param

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.7.1

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.7.0

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

dev-feature/using-symfony-cache-pool

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

dev-feature/twig-compiler-implementation

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.6.11

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.6.10

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.6.9

The Requires

by Floran Pagliai

by Remy Berda

by Baptiste Leduc

0.6.8