Download the PHP package weglot/weglot-laravel without Composer
On this page you can find all versions of the php package weglot/weglot-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download weglot/weglot-laravel
More information about weglot/weglot-laravel
Files in weglot/weglot-laravel
Package weglot-laravel
Short Description Seamless integration of Weglot into your Laravel project
License MIT
Homepage https://weglot.com/
Informations about the package weglot-laravel
⚠️ This package is deprecated ⚠️
Create a new project and use the subdomain integration (Technology: Other) to translate your Laravel website.
Laravel Package
Overview
Seamless integration of Weglot into your Laravel project.
Requirements
- PHP version 5.5 and later
- Laravel 5.*
- Weglot API Key, starting at free level
Installation
You can install the library via Composer. Run the following command:
To use the library, use Composer's autoload:
Getting Started
Package Register
This package use auto-discovery, when you require it from composer, you should have nothing to do and Provider gonna be added automatically to your config/app.php
providers list.
If this doesn't work, you can add our provider to the config/app.php
, as following:
Quick configuration
As usual for Laravel packages, you can publish configuration files by doing:
You'll find the configuration file in config/weglot-translate.php
with default values.
If you want to go deeper in corresponding part of this README.
Configuration
Here is a full configuration file:
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.prefix_path
: if your laravel installation is not on webroot (ie. something like that:https://my.website.com/foo/
is your actual root) set it to specify the path to your laravel installationcache
: 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.
There is also a non-required parameters:
exclude_blocks
: where you can list all blocks you don't want to be translated. On this example, you can see that all blocks with thesite-name
class won't be translated.exclude_urls
: you can prevent urls path from being translated (such as an admin path in this example)
And some Laravel-related parameters:
laravel.controller_namespace
: Used internaly when rewriting routes, change it if your Laravel namespace isn'tApp
or your controllers are moved.laravel.routes_web
: Used internaly when rewriting routes, refer to the file where you have all your web routes.
Routing
Since we are adding routes for each destination languages we need a strong way to manipulate urls.
We choose to make that through named routes and route()
helper.
When you create a route, you have to give a name as following:
Then you can use it in your blade templates as following:
Like that, we will detect current language and adjust url if needed.
Forcing language
You can force any language as following:
Like that, it will force es
language for this link !
Caching
We implemented usage of Cache
Facade for our package.
If you wanna use cache, just put the cache
parameter to true in this package configuration. It will plug onto the Laravel cache behavior.
If you wanna clear your translation cache, just use the weglot:cache:clear
command as following:
Helper reference
weglotCurrentUrlInstance
One of the core helper of this plugin it returns an instance of Weglot\Util\Url
which is what manages:
- Detect current language
- What are translated urls based on current url
- Is a given url translable or not (based on
excludedUrls
option) - Generate hreflinks
Here is some usage examples:
weglotButtonRender
You can add a language button with the helper function: weglotButtonRender
Two layouts exists:
If you want to overwrite theses templates you can publish them with the following artisan command:
weglotHrefLangRender
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
You can add them through the helper function: weglotHrefLangRender
Just put the function at the end of your <head>
tag:
weglotLanguage
Simple helper 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.
Here is a quick example:
Examples
You'll find a short README with details about example on each repository:
About
translate-laravel
is guided and supported by the Weglot Developer Team.
translate-laravel
is maintained and funded by Weglot SAS.
The names and logos for translate-laravel
are trademarks of Weglot SAS.
License
The MIT License (MIT)
All versions of weglot-laravel with dependencies
cache/illuminate-adapter Version ^0.2.0
illuminate/filesystem Version ^5.4