.. | ||
assets | ||
css | ||
flags | ||
js | ||
templates/partials | ||
blueprints.yaml | ||
CHANGELOG.md | ||
language-selector.php | ||
language-selector.yaml | ||
languages.yaml | ||
LICENSE | ||
README.md |
Grav Language Selector Plugin
Language Selector
is a Grav plugin that provides native language selector with flags to switch between Multiple Languages.
Installation
Installing the Language Selector plugin can be done in one of two ways. GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file or GIT.
GPM Installation (Preferred)
The simplest way to install this plugin is via the Grav Package Manager (GPM) through your system's Terminal (also called the command line). From the root of your Grav install type:
bin/gpm install language-selector
This will install the Language Selector plugin into your /user/plugins
directory within Grav. Its files can be found under /yoursite/user/plugins/language-selector
.
Manual Installation (Download)
To install this plugin, just download the zip version of this repository and unzip it under user/plugins
. Then, rename the folder to language-selector
. You can find these files either on GitHub.
You should now have all the plugin files under
/yoursite/user/plugins/language-selector
Manual Installation (Using GIT)
In user/plugins
folder, apply the following command:
git clone https://github.com/clemdesign/grav-plugin-language-selector language-selector
This will clone this repository into the language-selector folder.
Usage
1. Define the supported languages
In system.yaml
, add the supported languages in languages.supported
parameter.
Example:
languages:
supported:
- fr
- en
2. Integration
You do need to add the included Twig partials template into your own theme somewhere you want the available languages to be displayed.
{% include 'partials/language-selector.html.twig' %}
Something you might want to do is to override the look and feel of the langswitcher, and with Grav it is super easy.
Copy the template file language-selector.html.twig into the templates
folder of your custom theme:
/yoursite/user/themes/custom-theme/templates/partials/language-selector.html.twig
You can now edit the override and tweak it however you prefer.
language-selector
need jQuery (1.8 -> later) to display dropdown language menu.
3. Usage of the hreflang
partial
A second template is available for hreflang
annotations in the header of the page. In order to emit language annotations for the available languages of a page you need to add the corrsponding Twig partial template into the <head>
section of your page, which can typically be found in base.html.twig
:
{% include 'partials/language-selector.hreflang.html.twig' %}
This will generate something like:
<link rel="alternate" href="http://example.com/en" hreflang="en" />
<link rel="alternate" href="http://example.com/fr" hreflang="fr" />
<link rel="alternate" href="http://example.com/zh-cn" hreflang="zh-cn" />
Configuration
Plugin
Simply copy the user/plugins/language-selector/language-selector.yaml
into user/config/plugins/language-selector.yaml
and make your modifications.
enabled: true
built_in_css: true
button_display: default
select_display: default
Options enabled
and built_in_css
are pretty self explanatory.
For button_display
, this one define how button of selected language will be displayed. There are 3 possibilities:
default
: Flag and Language name are displayedflag
: Only flag is displayedname
: Only language name is displayed
For select_display
, this one define how language selector will be displayed. There are 3 possibilities:
default
: Flag and Language name are displayedflag
: Only flag is displayedname
: Only language name is displayed
Redirecting after switching language
To have Grav redirect to the default page route after switching language, you must add the following configuration to user/config/system.yaml
pages:
redirect_default_route: true
Contribute
Languages
For Administration panel, Language Selector
is available in English and French. You could contribute for another languages.
For flags and language names, it is available for both match between flag images (content in language-selector/flags
) and the list of language name in Grav/Common/Language/LanguageCodes.php
.
You could contribute by adding new flags to match with list of language name, or the opposite.
Flag images are sized 24 x 12 pixels in PNG.
Credits
Language Selector is based on Lang Switcher plugin.