| 1 |
=== Translate WordPress with wpLingua - Automatic, editable, SEO friendly === |
| 2 |
Contributors: wpr0ck, lyly13 |
| 3 |
Donate link: https://wplingua.com/ |
| 4 |
Tags: translate, translation, multilingual, localization, language |
| 5 |
Requires at least: 5.0 |
| 6 |
Tested up to: 6.4 |
| 7 |
Stable tag: 1.1.0 |
| 8 |
Requires PHP: 7.4 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Make your websites multilingual and translate them automatically: no word limits, free first language, SEO-friendly, no coding knowledge needed, and more! |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
**An all-in-one solution that makes your websites multilingual and translate them automatically, without word or page limits.** |
| 17 |
|
| 18 |
The highlights: |
| 19 |
|
| 20 |
✓ a free first language |
| 21 |
✓ an on-page visual editor for editing translations |
| 22 |
✓ a customizable language switcher |
| 23 |
✓ search engine optimization (SEO) |
| 24 |
✓ no coding knowledge needed |
| 25 |
✓ self-hosted data |
| 26 |
✓ open source, find [wpLingua on GitHub](https://github.com/julien-jacob/wplingua) |
| 27 |
✓ and more! |
| 28 |
|
| 29 |
### 🔥 One free target language ### |
| 30 |
With our complimentary offer, wpLingua empowers you to introduce your website to a broader audience in a new language. |
| 31 |
|
| 32 |
**While the free version supports translation into a single target language**, we set no boundaries on the number of words you can translate. |
| 33 |
|
| 34 |
Whether your site has a hundred pages or just a few, you can seamlessly make it accessible in the language you desire. |
| 35 |
|
| 36 |
###🪄 Streamlined Setup Process ### |
| 37 |
Dive into a hassle-free multilingual experience with wpLingua. Forget about complex configurations and the intimidating world of coding. |
| 38 |
|
| 39 |
All you need to get started is to request your complimentary API key. Once you do, we'll promptly send it straight to your inbox. It's as straightforward as that! |
| 40 |
|
| 41 |
Our commitment is **to make multilingual capabilities accessible and effortless for every WordPress user**. |
| 42 |
|
| 43 |
Let us take care of the technicalities while you focus on creating captivating content for your global audience. |
| 44 |
|
| 45 |
### 🚀 Optimized for international search engines (SEO) ### |
| 46 |
When you use wpLingua on your website, all elements of your content - even those that are invisible - are translated. |
| 47 |
|
| 48 |
wpLingua is "SEO-Friendly" because it takes care of translating: |
| 49 |
|
| 50 |
✓ Meta Title tags |
| 51 |
✓ Meta Description tags |
| 52 |
✓ Hreflang alternative links |
| 53 |
✓ Meta tags for social networks (Twitter X, OpenGraph Facebook...) |
| 54 |
✓ ALT attributes of images |
| 55 |
✓ And more. |
| 56 |
|
| 57 |
By optimizing indexing, we ensure that your translated pages are not only understood by your audience, but are also easily found by search engines. |
| 58 |
|
| 59 |
### ✍️ Tailor-made translations at your fingertips with our On-Page Editor ### |
| 60 |
Although wpLingua gives you the convenience of **machine translations**, we understand the nuances of each language. |
| 61 |
|
| 62 |
wpLingua offers a canvas in which you can **refine each translation** so that it resonates with your unique voice and your brand message adapted to the cultural and contextual expectations of your audience. |
| 63 |
|
| 64 |
Experience the fusion of automation and the personal touch with our **visual on-page editor**. |
| 65 |
|
| 66 |
### 🎨 Fully customizable language switcher ### |
| 67 |
The wpLingua language selector is fully customizable. You can display the language switcher in two ways: |
| 68 |
|
| 69 |
✓ Automatic insertion via predefined positions |
| 70 |
✓ Use of a shortcode to display it wherever you want |
| 71 |
|
| 72 |
You can also control the appearance of the language switcher using: |
| 73 |
|
| 74 |
✓ Switcher styles (dropdown, inline, block...) |
| 75 |
✓ Predefined themes (light, dark, chameleon, etc.) |
| 76 |
✓ Configurable language names (translated name, original name, language ID, etc.) |
| 77 |
✓ Flag shapes (round, rectagle, wavy) |
| 78 |
✓ Language-based flag choices or import your own flag images |
| 79 |
✓ Adding custom CSS in a dedicated insert |
| 80 |
|
| 81 |
With all these customization options, there's no way your site's language selector will look like any other! |
| 82 |
|
| 83 |
### 📖 Translation rules by dictionary ### |
| 84 |
The dictionary allows you to define translation rules that apply when generating machine translations. You can specify words or sets of words that should never be translated, or define how they should be translated for each language. |
| 85 |
|
| 86 |
### 🧭 Intuitive possibilities to exclude certain translations ### |
| 87 |
Navigate the complexities of website translation with wpLingua's intelligent exclusion feature. |
| 88 |
|
| 89 |
Want to preserve specific sections of a page in its original language? Our system seamlessly allows you to pinpoint and **exclude translations using CSS selectors**. |
| 90 |
|
| 91 |
If entire pages need to remain untouched, effortlessly exclude them by their URL. All of this can be managed with ease through our user-friendly exclusions manager. |
| 92 |
|
| 93 |
With wpLingua, you're always in command of what gets translated and what doesn't, ensuring your site's essence remains intact. |
| 94 |
|
| 95 |
### ⚡️ The wpLingua API ### |
| 96 |
The wpLingua plugin relies on our own wpLingua API, an integrated third-party service, to provide its machine translation functionality. The call to this Third Party Service (wpLingua API) is made when creating an API key from the plugin, during API key verification and when your site requests a new automatic translation (new texts discovered on a page web or request automatic translations from the translation edition). We invite you to consult our [Terms & Conditions page](https://wplingua.com/terms-and-conditions/) for more information. |
| 97 |
|
| 98 |
|
| 99 |
== Installation == |
| 100 |
|
| 101 |
1. Download the plugin zip file and install it via the WordPress interface, or upload it directly to your plugins directory. |
| 102 |
2. Activate wpLingua from your plugins page. |
| 103 |
3. Navigate to the wpLingua settings to get your free API key and to set up your language preferences. |
| 104 |
4. Start translating your content! |
| 105 |
|
| 106 |
== Frequently Asked Questions == |
| 107 |
|
| 108 |
= What languages are available for translation?= |
| 109 |
For the moment the available languages are: |
| 110 |
|
| 111 |
* English |
| 112 |
* French |
| 113 |
* German |
| 114 |
* Italian |
| 115 |
* Japanese |
| 116 |
* Portuguese |
| 117 |
* Simplified Chinese |
| 118 |
* Spanish |
| 119 |
|
| 120 |
If you need a language, let us know using the [contact form available on our website](https://wplingua.com/contact/), we add languages as we go. |
| 121 |
|
| 122 |
= What languages are available in the plugin administration? = |
| 123 |
At the moment, the plugin is available in English, French, German, Italian, Spanish and Portuguese. If you want to help us translate it into more languages, don't hesitate! |
| 124 |
|
| 125 |
= Is it compatible with page builders? = |
| 126 |
Yes, wpLingua is designed to work seamlessly with most popular page builders. |
| 127 |
|
| 128 |
= How it works? = |
| 129 |
wpLingua intercepts page content and analyzes HTML and JS code. It discovers all texts, translates them and makes the pages multilingual. This approach ensures compatibility with most themes, plugins and page builders such as Gutenberg, Elementor, Divi… |
| 130 |
|
| 131 |
= Is it possible to edit translations manually? = |
| 132 |
Of course ! Simply activate the **translation editor** on the page to make your changes. |
| 133 |
|
| 134 |
= What is the translated word limit? = |
| 135 |
wpLingua does **not limit the translation of the number of words**. |
| 136 |
|
| 137 |
= Is wpLingua compatible with WordPress Multisite? = |
| 138 |
No, wpLingua is not compatible with WordPress Multisite |
| 139 |
|
| 140 |
= Is wpLingua compatible with caching plugins? = |
| 141 |
Quite ! And it's even recommended to cache your pages and translations to improve site loading and performance. |
| 142 |
|
| 143 |
= Is there a Gutenberg block or Divi/Elementor widget to easily display the language switcher? = |
| 144 |
No, not at the moment but in the meantime, you can easily display the language switcher wherever you want using our shortcode provided for this purpose. Simply copy and paste this shortcode where you want: **[wplng_switcher]** |
| 145 |
|
| 146 |
== Screenshots == |
| 147 |
|
| 148 |
1. Once the plugin is downloaded, installed and activated, register your API key. |
| 149 |
2. As soon as your API key has been registered, your site is multilingual. This option screen allows you to configure your languages and their flags, as well as activate the functionalities. |
| 150 |
3. Customizing the language switcher, enable or disable auto-insertion + choose position or use the shortcode. |
| 151 |
4. You have the possibility to exclude pages or parts of pages. |
| 152 |
5. If you need, you can edit a translation directly from your pages using our visual editor. |
| 153 |
6. You can access the list of translations present on a page, including those which are not directly visible (Meta SEO, texts, alternative images, title attributes, etc.) |
| 154 |
7. You can edit all translations of your website. |
| 155 |
8. All translations are stored on your WordPress site. |
| 156 |
|
| 157 |
== Changelog == |
| 158 |
|
| 159 |
= 1.1.0 = |
| 160 |
|
| 161 |
* Translation rules by dictionary |
| 162 |
* Better UX: Register API key |
| 163 |
* Better UX: Options pages |
| 164 |
* Better UX: admin bar |
| 165 |
* Fix WooCommerce error on links getting |
| 166 |
|
| 167 |
= 1.0.5 = |
| 168 |
|
| 169 |
* Translate meta twitter:description |
| 170 |
* New shortcode: wplng_only |
| 171 |
* Add message when plugin is activated but not configured |
| 172 |
* Fix arrow on switcher (theme: blur, style: dropdown) |
| 173 |
|
| 174 |
= 1.0.4 = |
| 175 |
|
| 176 |
* Better JSON translation |
| 177 |
* Better JSON debug mode |
| 178 |
* New AJAX debug mode |
| 179 |
* Better register form |
| 180 |
* Better readme.txt and README.md files |
| 181 |
* Fix editor link class attributes |
| 182 |
* Fix error on URL translation (backslash on domain name) |
| 183 |
* Fix bad JS on translated page |
| 184 |
|
| 185 |
= 1.0.3 = |
| 186 |
|
| 187 |
* Prepare SVN folders |
| 188 |
|
| 189 |
= 1.0.2 = |
| 190 |
|
| 191 |
* Fix error on API key register |
| 192 |
|
| 193 |
= 1.0.1 = |
| 194 |
|
| 195 |
* Review code |
| 196 |
* Review shortcode |
| 197 |
* Review some texts and HTML |
| 198 |
* Update plugin translations |
| 199 |
* Add default excluded element for translation : code |
| 200 |
* Add default excluded element for editor links : option |
| 201 |
* CSS: Better switcher margin |
| 202 |
* CSS: Hover effect for link’s editor |
| 203 |
* Better flags in admin |
| 204 |
|
| 205 |
= 1.0.0 = |
| 206 |
|
| 207 |
* **Options pages** |
| 208 |
* Register |
| 209 |
* Set API key |
| 210 |
* Request API key |
| 211 |
* Settings |
| 212 |
* Original language |
| 213 |
* Target languages |
| 214 |
* Features |
| 215 |
* API key |
| 216 |
* Switcher |
| 217 |
* Theme (20) |
| 218 |
* Style (Dropdown / List / Block) |
| 219 |
* Language name (Untranslated name / ID / None) |
| 220 |
* Custom CSS |
| 221 |
* Auto insert |
| 222 |
* Exclusions |
| 223 |
* Exclude HTML elements by selector |
| 224 |
* Exclude URLs by regex |
| 225 |
|
| 226 |
* **Translation post type** |
| 227 |
* Edit translation |
| 228 |
* Status: Generated or Edited |
| 229 |
* Re-generate translation |
| 230 |
|
| 231 |
* **Translate webpage** |
| 232 |
* Text node (p, span, …) |
| 233 |
* Attribute (alt, title, …) |
| 234 |
* Dir attribute (ltr or rtl) |
| 235 |
* Body class (dir and language ID) |
| 236 |
* JS / JSON (Text / HTML / URL / Language ID) |
| 237 |
* AJAX (HTML / JSON) |
| 238 |
* Add links alternate hreflang |
| 239 |
|
| 240 |
* **On page : Visual editor** |
| 241 |
* **On page : Translations list** |
| 242 |
* **On page : Admin bar** |
| 243 |
* Access visual editor |
| 244 |
* Access all translation on current page |
| 245 |
* Access exclusion option if current page is excluded |
| 246 |
|
| 247 |
* **Feature : Search from translated page** |
| 248 |
* **Shortcode** |
| 249 |
* wplingua-switcher |
| 250 |
* wplingua-notranslate |
| 251 |
|
| 252 |
* **Plugin translation** |
| 253 |
* French |
| 254 |
* Portuguese |
| 255 |
* Spanish |
| 256 |
|
| 257 |
|
| 258 |
== Upgrade Notice == |
| 259 |
|
| 260 |
= 1.0.0 = |
| 261 |
First release. Be sure to set up your preferences after installation. |
