forked from lloc/Multisite-Language-Switcher
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
137 lines (96 loc) · 6.58 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
=== Multisite Language Switcher ===
Contributors: realloc, lucatume
Donate link: https://www.greenpeace.org/international/
Tags: multilingual, multisite, language, switcher, localization
Requires at least: 3.6.1
Tested up to: 5.7
Requires PHP: 7.0
Stable tag: 2.4.11
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
A simple, powerful and easy to use plugin that will help you to manage multilingual content in a multisite WordPress installation.
== Description ==
A simple, powerful and easy to use plugin that will add multilingual support to a WordPress [multisite](http://codex.wordpress.org/Create_A_Network)
installation, i.e. multiple subdomains or folders (if you need to set up multiple sites across multiple domains, you'll also want to use the [WordPress MU
Domain Mapping](http://wordpress.org/extend/plugins/wordpress-mu-domain-mapping/) plugin as well - as long as the domains are all hosted on the same server.).
The Multisite Language Switcher enables you to manage translations of posts, pages, custom post types, categories, tags and custom taxonomies.
The plugin uses flag-icons from [FamFamFam](http://famfamfam.com). Thanks to Mark James for his great work. In addition I would like to thank [Jürgen Mayer](
https://creativpin.com) for creating the plugin's banner.
Please, don't forget to [rate this plugin](https://wordpress.org/support/plugin/multisite-language-switcher/reviews/)! :-)
== Installation ==
* Download the plugin and uncompress it with your preferred unzip programme
* Copy the entire directory in your plugin directory of your WordPress blog (/wp-content/plugins)
* Activate the plugin in your plugin administration page (by the network administrator on all the blogs or by the root blog administrator for each particular blog).
* You need to activate the plugin once in each blog, set the configuration in Settings -> Multisite Language Switcher
Now you can:
* connect your translated pages and posts in Posts -> Edit or Page -> Edit
* connect your translated categories and tags in Posts -> Categories or Post -> Tags
* connect your Custom Post Types and Custom Taxonomies across languages
* use the widget, the Gutenberg block, the shortcode [sc_msls] and/or a content_filter which displays a hint to the user if a translation is available
* find also a shortcode for the widget [sc_msls_widget]
* optionally you can place the code `<?php if ( function_exists( 'the_msls' ) ) the_msls(); ?>` directly in your theme files
Review the [Multisite Language Switcher Website](http://msls.co/) for more information.
== Frequently Asked Questions ==
= I have no language options in the General settings. =
You might read first [WordPress in your language](http://codex.wordpress.org/WordPress_in_Your_Language).
= But I'd like the interface to stay in English. =
You can choose the language of the dashboard in the settings of your user profile.
= Do I really need a multisite? =
It's up to you - of course. But yes, if you want to use the Multisite Language Switcher.
= How can I automatically redirect users based on the browser language? =
The Multisite Language Switcher does not redirect the users automatically. I'm not sure if the plugin should do that. You might check out this [jQuery plugin](
https://github.com/danieledesantis/jquery-language-detection) or [this approach with a theme](https://github.com/oncleben31/Multisite-Language-Switcher-Theme)
if you need such functionality.
= How can I add the Multisite Language Switcher to the nav-menu of my blog? =
Please check the add-on [MslsMenu](https://wordpress.org/plugins/mslsmenu/) out.
= I want to have the languages in an HTML select. How can I do that? =
Please check the add-on [MslsSelect](https://wordpress.org/plugins/mslsselect/) out.
= I don't want to upload the same media files for every site. What can I do? =
You could try the plugin [Network Shared Media](http://wordpress.org/plugins/network-shared-media/). It adds a new tab to the "Add Media" window, allowing you to access the media files in the other sites in your multisite.
= Is there a function I can call to get the language of the page the user is currently viewing? =
Yes, you should use the WordPress API function `get_locale()` but you could also use code like that
`use lloc\Msls\MslsBlogCollection;
$blog = MslsBlogCollection::instance()->get_current_blog();
$language = $blog->get_language();`
= How can I move from WPML to MSLS? =
There is a [plugin](http://wordpress.org/plugins/wpml2wpmsls/) which comes handy in here.
== Screenshots ==
1. Plugin configuration
2. Posts list
3. Edit post
4. Widget
== Changelog ==
There is a separate [Changelog](https://github.com/lloc/Multisite-Language-Switcher/blob/master/Changelog.md) for this project available.
== Translators ==
Thanks to all translators for their great work.
* German (de_DE) - [Dennis Ploetner](http://lloc.de/)
* Italian (it_IT) - [Antonella Cucinelli](http://www.freely.de/it/)
* Dutch (nl_NL) - [Alexandra Kleijn](http://www.buurtaal.de/)
* Brazillian Portuguese (pt_BR) - [Coolweb](http://www.coolweb.com.br/)
* Spanish (es_ES) - [Andreas Breitschopp](http://www.ab-weblog.com/en/)
* French (fr_FR) - [Andreas Breitschopp](http://www.ab-tools.com/en/)
* Russian (ru_RU) - [Andrey Vystavkin](http://j4vk.com/)
* Ukrainian (uk) - [Victor Melnichenko](http://worm.org.ua/)
* Croatian (hr_HR) - [Brankec69](https://github.com/Brankec69)
* Romanian (ro_RO) - [Armand K](http://caveatlector.eu/)
* Polish (pl_PL) - [Kamil Frejlich](http://www.mojito-networks.com/)
* Lithuanian (lt_LT) - Ovidijus Pukys
* Catalan (ca_ES) - Joan López
* Czech (cs_CZ) - Rastr
* Hungarian (hu_HU) - RobiG
* Georgian (ka_GE) - [Jas Saran](http://www.gwebpro.com/)
* Greek (el) - [Christoforos Aivazidis](http://www.aivazidis.org/)
* Serbian (sr_RS) - [Web Hosting Hub](http://www.webhostinghub.com/)
* Turkish (tr) - Alican Cakil
* Armenian (hy_AM) - Yeghishe Nersisyan
* Bengali (bn_BD) - Md. Nazmul Huda
* Japanese (ja) - [ThemeBoy](http://themeboy.com/)
* Swedish (sv_SE) - [Erik Bernskiold](http://www.bernskioldmedia.com/)
* Traditional & Simplified Chinese (zh_CN & zh_TW) - DrBenson
* Arabic (ar) - Mohamed Elwan
* Norwegian (nb_NO) - Ibrahim Qraiqe
* Bulgarian (bg_BG) - [Vencislav Raev](http://www.catblue.net/)
* Mexican Spanish (es_MX) - [Fernando Mata](https://fernandomata.mx/)
If you have created your own language pack, or have an update of an existing one, you can [send me](mailto:[email protected]) your gettext PO and MO so that I can
bundle it into the Multisite Language Switcher. You can download the latest POT file
[from here](http://plugins.svn.wordpress.org/multisite-language-switcher/trunk/languages/default.pot).