readme.txt

=== wpLingua - Automatic translation - Translate and make website multilingual ===
Contributors: wpr0ck, lyly13, wplingua
Donate link: https://wplingua.com/
Tags: translate, translation, multilingual, localization, language
Requires at least: 6.0
Tested up to: 6.7
Stable tag: 2.1.5
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Make your websites multilingual and translate them automatically: no word limits, editable translations, SEO-friendly, no coding knowledge needed

== Description ==

**An all-in-one solution that makes your websites multilingual and translate them automatically, without word or page limits.**

The highlights:

✓ One free first language for non-commercial websites
✓ Automatic translation API
✓ Unlimited number of translated words
✓ SEO-friendly: indexing of translated pages in search engines
✓ On-page visual editor for editing translations
✓ Customizable language switcher
✓ Translate website URLs
✓ No coding knowledge needed
✓ Self-hosted data
✓ Open source, find [wpLingua on GitHub](https://github.com/julien-jacob/wplingua)
✓ And more!

### 🎬 6 minutes to translate your website

[youtube https://www.youtube.com/watch?v=T1fTHnZhH-0]

Video tutorial available in [Chinese](https://youtu.be/ET2ijgN3cUw?si=6L2_KlZJ6Dw3kOJq), [Danish](https://youtu.be/cxoMK5UamXA?si=sbaK-Fx8GAfsl8Bu), [English](https://youtu.be/T1fTHnZhH-0?si=rELV5g5I4i9KwVG0), [Finnish](https://youtu.be/niuBK79uK4Y?si=fKs6mvNqLCTliOIV), [French](https://youtu.be/No6PdIJrbrk?si=2w2yJERXIhdSfqFb), [German](https://youtu.be/TvyHn8n9zr4?si=FSWSHd8YkW17V07u), [Greek](https://youtu.be/MMrkmhzVrNM?si=A0BM0Mq-gBgIQ-rT), [Hindi](https://youtu.be/TCoaBMCusbE?si=eXACXPXZtAeC4J2P), [Italian](https://youtu.be/yYNkJqbFGeo?si=VBkJrNck4_kPma-0), [Japanese](https://youtu.be/H9jL6B9ZoRk?si=ZOoNKdxE67LMt4Sv), [Korean](https://youtu.be/FGi68qYvzWg?si=zNZKYPUvf12FNxCz), [Polish](https://youtu.be/QkQ8fn7XZkY?si=Z4aEfcVHs05_AOLS), [Portuguese](https://youtu.be/W8lGMYeE-wQ?si=SorUAE_AVW8-ezKE) and [Spanish](https://youtu.be/ePsri0sP99Y?si=l3JCik3Z-B0hg4CR). 

### 🔥 One free target language ###
The first language translation is completely free for non-commercial websites. If your website is of a commercial nature (e-commerce, advertising, etc.), a commercial licence is available.

### 🧮 No word limits! ###

Don't count the words on your website to decide which plan to choose, wpLingua doesn't limit them! Simply choose the number of target languages and translate without counting!

### 🚀 Optimized for international search engines (SEO) ###
When you use wpLingua on your website, all elements of your content - even those that are invisible - are translated.

wpLingua is "SEO-Friendly" because it takes care of translating:

✓ Meta Title tags
✓ Meta Description tags
✓ Hreflang alternative links
✓ Meta tags for social networks (Twitter X, OpenGraph Facebook...)
✓ ALT attributes of images
✓ And more.

By optimizing indexing, we ensure that your translated pages are not only understood by your audience, but are also easily found by search engines.

### 🪄 Streamlined Setup Process ###
Forget about complex plugins to set up, wpLingua enhances the user experience of the multilingual world. 

All you need to do to get started is request your machine translation API key, then play with the language switcher appearance options!

Let wpLingua take care of the technical aspects while you concentrate on creating compelling content for your international audience. Our commitment is **to make multilingual capabilities accessible and easy to use for all WordPress users**. 

### ✍️ Tailor-made translations at your fingertips with our On-Page Editor ###
Although wpLingua gives you the convenience of **machine translations**, we understand the nuances of each language. 

wpLingua allows you **to fine-tune each translation manually** if you need to.

Experience the fusion of automation and the personal touch with our **visual on-page editor**.

### 🔗 Editable URL translation ###
The plugin **automatically discovers URLs on your website and lets you translate them**. URLs are split into slugs (parts of the URL), making them easy to edit. This feature boosts SEO performance!

### 🎨 Fully customizable language switcher ###
The wpLingua language switcher is fully customisable. You can display the language switcher in three ways:

✓ Automatic insertion via predefined positions
✓ Using a shortcode to display it wherever you like
✓ Insertion in the navigation menu using the design defined by the theme

You can also control the appearance of the language switcher using:

✓ Switcher styles (dropdown, inline, block...)
✓ Predefined themes (light, dark, chameleon, etc.)
✓ Configurable language names (translated name, original name, language ID, etc.)
✓ Flag shapes (round, rectangle, wavy)
✓ Language-based flag choices or import your own flag images
✓ Adding custom CSS in a dedicated insert

With all these customization options, there's no way your website's language switcher will look like any other!

### 📖 Translation rules by dictionary ###
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.

### 🧭 Intuitive possibilities to exclude certain translations ###
Navigate the complexities of website translation with wpLingua's intelligent exclusion feature. 

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**. 

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. 

With wpLingua, you're always in command of what gets translated and what doesn't, ensuring your website's essence remains intact.

### 💫 Supported languages ###

#### The plugin supports the following languages ####

Arabic ∘ Chinese ∘ Danish ∘ Dutch ∘ Slovak ∘ English ∘ Finnish ∘ French ∘ German ∘ Greek ∘ Hebrew ∘ Hindi ∘ Hungarian ∘ Indonesian ∘ Italian ∘ Japanese ∘ Korean ∘ Polish ∘ Portuguese ∘ Russian ∘ Spanish ∘ Swedish ∘ Turkish ∘ Ukrainian ∘ Vietnamese 

#### The plugin is translated into the following languages ####

English ∘ French ∘ German ∘ Italian ∘ Portuguese ∘ Spanish

### 🔌 Theme and plugin compatibility ###
The method used by wpLingua to translate website texts ensures compatibility with most themes and plugins.

Compatible plugins tested: WooCommerce, Yoast SEO, SEOPress, All in One SEO, SEOKey, Elementor, Gutenberg, Divi Builder, Contact Form 7, Fluent Forms, WP Forms, Gravity Form, MailPoet, WP Rocket, Cache Enabler, All-in-One WP Migration, UpdraftPlus, Redirection, Complianz, WF Cookies, Complianz, LuckyWP Table of content, WP Grid Builder, and more...

Compatible themes tested: Divi, Twenty Twenty One, Astra, OceanWP, Blocksy, Hello, Generate Press, Neve, Envince, Twenty Twenty Four, Twenty Twenty Five, Poe, Neve FSE, Frost, Tove, and more...

### ⚡️ The wpLingua API ###
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 website 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.


== Installation ==

1. Download the plugin zip file and install it via the WordPress interface, or upload it directly to your plugins directory.
2. Activate wpLingua from your plugins page.
3. Navigate to the wpLingua settings to get your free API key and to set up your language preferences.
4. Start translating your content!

== Frequently Asked Questions ==

= What languages are available in the plugin administration? =
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!

= Is it compatible with page builders? =
Yes, wpLingua is designed to work seamlessly with most popular page builders.

= How it works? =
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…

= Is it possible to edit translations manually? =
Of course ! Simply activate the **translation editor** on the page to make your changes.

= What is the translated word limit? =
wpLingua does **not limit the translation of the number of words**.

= Is wpLingua compatible with WordPress Multisite? =
No, wpLingua is not compatible with WordPress Multisite

= Is wpLingua compatible with caching plugins? =
Quite ! And it's even recommended to cache your pages and translations to improve website loading and performance.

= Is there a Gutenberg block or Divi/Elementor widget to easily display the language switcher? =
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]**

== Screenshots ==

1. When you visit your translated page, you can activate the editor to modify your translations if necessary.
2. Installing wpLingua and creating an API key.
3. You can choose which flag to display by language or import a custom flag.
4. Customize language selector, activate or deactivate automatic insertion + choose position, use shortcode or add directly to menu.
5. Many options available for the language switcher, even adding custom CSS.
6. SEO tags are translated automatically, but you can modify them manually.
7. Dictionary : define translation rules that apply when generating machine translations.
8. You have the possibility to exclude pages or parts of pages.
9. wpLingua adds a list of your website's slugs. You can decide whether or not to translate them.
10. All translations are stored on your WordPress website.
11. Translations are automatically generated by wpLingua. When you visit the page for the first time (from the admin), you'll see the translation progress.
12. SEO-Friendly: wpLingua add the HTML code needed for your translated pages to be indexed by search engines.

== Changelog ==

= 2.1.5 =

* New option for switcher in menu: Use only flag
* Optimizing cache for translations and slugs

= 2.1.4 =

* Better management of translated slugs
* Better management of excluded elements
* Some optimizations
* Fix incorrectly replaced flags on flag format changing in selector options

= 2.1.3 =

* Better untranslatable URL detection
* Automatic bad slug deletion

= 2.1.2 =

* Better plugin translations loading
* Better slug status management 
* Optimize cache for wpLingua functions
* Plugin compatibility: Debug Bar
* Clear wpLingua query args in hreflang URLs

= 2.1.1 =

* Added compatibility with WordPress 6.7
* Update README and screenshots

= 2.1.0 =

* New feature: translate website URLs
* Better handling of strings containing special characters
* Increase the priority of hreflang header
* Better UX: 
 * Keep the wpLingua submenu open in the slug and translation editor
 * Better textarea auto height on translation editor 
 * Use light-simple-smooth as default switcher design

= 2.0.2 =

* Better JSON detection in JavaScript
* Added plugin compatibility: WF Cookie Consent
* Add videos on WordPress description

= 2.0.1 =

* Better SEO: Translate meta[name="description"]
* Better UX: Admin & translations editor
* Polish flag added

= 2.0.0 = 

* Add new flags:
 * Arabic
 * US/GB
 * Chinese
* Display an information message when adding target languages
* API protocol V2.0
* Display API informations in admin:
 * Status (FREE, PREMIUM, VIP)
 * Expiration for PREMIUM
* Plugin translation update
 * French
 * German
 * Italian
 * Portuguese
 * Spanish
* Removed Herobrine

= 1.4.5 =

* New feature - Status on website translations list:
 * Full reviewed
 * Partially reviewed
 * Unreviewed
* Better UX for translations list on page
* Texts review
* Plugin translation update
 * French
 * German
 * Italian
 * Portuguese
 * Spanish

= 1.4.4 =

* On page translation list:
 * Filter by search (On source and translated texts)
 * Filter by translation status (All, Reviewed, Unreviewed)
 * Ordering (Occurrence order, Alphabetical sources or translations)
 * Add go to top button
* Disable admin bar menu if user can not edit posts
* Texts review
* README review for GitHub

= 1.4.3 =

* Tested up to WordPress 6.6
* Better plugin's compatibility:
 * Contact Form 7
 * Query Monitor
 * SecuPress
* Better meta translation:
 * Open Graph
 * Dublin Core
 * Twitter
* Optimize flag images
* Manages pages of up to 5 million characters
* Better definition of debugging constants
* Better edit modal UX compatibility
* Some GIT reviews
* Add default exclusions:
 * address
 * link[rel="EditURI"]
 * link[title="oEmbed (JSON)"]
 * link[title="oEmbed (XML)"]
 * link[title="JSON"]
* Add a method to exclude some texts from translation for developers
 * Special tag: _wplingua_no_translate_
 * Function: wplng_text_is_translatable() 
 * File: /inc/util.php

= 1.4.2 =

* Coloring reviewed texts
* Better translation for JSON in attributes 
* Edit page button on edition modale
* Exclude comment content and author names
* Better Divi Builder exclusion
* Better notice for for incompatible plugins

= 1.4.1 =

* Exclude /feed/ from translations
* Better front editor compatibility with themes and plugins
* Better compatibility with permanent cache (Redis, Memcache)
* Better first registration pre-translation
* Better management of bad HTML ending tag 
* Better management of HTML in text
* Better help box in API feature options
* Fix error with Query Monitor plugin
* Add context on translation API call

= 1.4.0 =

* New feature: Translation editor modal
* Better nav menu switcher

= 1.3.1 =

* Speed optimization:
 * Use WP Cache
 * Text escaping
 * WP_Query
* On excluded URLs:
 * Fix redirection
 * Hide Nav Menu language switcher
* Dictionary update
* Manage non-breaking space before and after texts
* Better management of the Fluent Forms plugin


= 1.3.0 =

* New feature: Switcher in menu
* Better admin UX
 * Review texts
 * Add help box
 * Message if user leave translation edit page without saving
* Optimize:
 * In progress mode
 * Text escaping and replace
* Better Divi management
* Better compatibility with PHP under V8

= 1.2.4 =

* Add x-default alternate link
* Translate JSON in attriutes
* SEO: Better @graph translation
* Divi: Better translation
* Emoji: Better translation
* Fix translations with empty title
* Fix URL when domain name start with a number
* Optimize CSS
* Translation list: Better UX

= 1.2.3 =

* Fix translation in progress

= 1.2.2 =

* CSS and JS files
 * Better minification and compatility
 * Add Map files
* Fix flags files

= 1.2.1 =

* New languages:
 * Arabic
 * Danish
 * Dutch
 * Slovak
 * Finnish
 * Greek
 * Hebrew
 * Hindi
 * Hungarian
 * Indonesian
 * Korean
 * Polish
 * Swedish
 * Turkish
 * Ukrainian
 * Vietnamese
* Add flags for languages:
 * Spanish
 * Russian
 * Portuguese
 * German
 * French
 * English
 * Chinese

= 1.2.0 =

* New feature: Translation in progress message for admin and editor
* New feature: Filter website translations by status (reviewed, unreviewed) 
* New feature: Edit translation status by language (reviewed, unreviewed) 
* Better parsing and content updating: Relay method
* Better string detection for dictionary rules
* Better file detection: Detect IJFIF files
* Check compatibility with another activated plugins
* Fix URL with anchor translation

= 1.1.1 =

* Better UX: Options pages
* Optimization: faster translations query and finding
* Experimental feature: Translation in progress message (disabled by default, enable with wplng_enale_in_progress_feature filter set to true) 

= 1.1.0 =

* Translation rules by dictionary
* Better UX: Register API key
* Better UX: Options pages
* Better UX: admin bar
* Fix WooCommerce error on links getting

= 1.0.5 =

* Translate meta twitter:description
* New shortcode: wplng_only
* Add message when plugin is activated but not configured
* Fix arrow on switcher (theme: blur, style: dropdown)

= 1.0.4 =

* Better JSON translation
* Better JSON debug mode
* New AJAX debug mode
* Better register form
* Better readme.txt and README.md files
* Fix editor link class attributes
* Fix error on URL translation (backslash on domain name)
* Fix bad JS on translated page

= 1.0.3 = 

* Prepare SVN folders

= 1.0.2 = 

* Fix error on API key register

= 1.0.1 =

* Review code
* Review shortcode
* Review some texts and HTML
* Update plugin translations
* Add default excluded element for translation : code
* Add default excluded element for editor links : option
* CSS: Better switcher margin
* CSS: Hover effect for link’s editor
* Better flags in admin

= 1.0.0 =

* **Options pages** 
 * Register
     * Set API key
     * Request API key
 * Settings
     * Original language
     * Target languages
     * Features
     * API key
 * Switcher
     * Theme (20)
     * Style (Dropdown / List / Block)
     * Language name (Untranslated name / ID / None)
     * Custom CSS
     * Auto insert
 * Exclusions
     * Exclude HTML elements by selector
     * Exclude URLs by regex
    
* **Translation post type**
 * Edit translation
 * Status: Generated or Edited
 * Re-generate translation
    
* **Translate webpage**
 * Text node (p, span, …)
 * Attribute (alt, title, …)
 * Dir attribute (ltr or rtl)
 * Body class (dir and language ID)
 * JS / JSON (Text / HTML / URL / Language ID)
 * AJAX (HTML / JSON)
 * Add links alternate hreflang
    
* **On page : Visual editor**
* **On page : Translations list**
* **On page : Admin bar**
 * Access visual editor
 * Access all translation on current page
 * Access exclusion option if current page is excluded

* **Feature : Search from translated page**
* **Shortcode**
 * wplingua-switcher
 * wplingua-notranslate

* **Plugin translation**
 * French
 * Portuguese
 * Spanish


== Upgrade Notice ==

= 1.0.0 =
First release. Be sure to set up your preferences after installation.