=== WPGlobus ===
Contributors: tivnetinc, tivnet
Tags: WPGlobus, localization, multilanguage, multilingual, translate
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 3.0.7
License: GPL-3.0-or-later
License URI: https://spdx.org/licenses/GPL-3.0-or-later.html

Make your WordPress site multilingual - each language with its own URL, and an easy interface to enter your translations.

== Description ==

**WPGlobus** turns your WordPress site into a multilingual one. You choose the languages you want, and WPGlobus adds the fields where you enter your own translations - post and page titles, content, excerpts, categories, tags, and more.

= WPGlobus, WPGlobus Plus and TIV Globus =

* **WPGlobus** - this plugin. The essential multilingual tools, free from WordPress.org.
* **WPGlobus Plus** - the professional add-on for WPGlobus: translated URLs, publishing per language, multilingual ACF, Yoast SEO in every language, and more. Sold on [wpglobus.com](https://wpglobus.com/product/wpglobus-plus/).
* **TIV Globus** - a separate all-in-one multilingual plugin for WordPress and WooCommerce, the successor to WPGlobus for WooCommerce. It runs instead of WPGlobus. Sold on the WooCommerce.com marketplace.

= WPGlobus allows you to: =

* Enter translations for posts, pages, custom post types, categories, tags, menus, and widgets;
* Enter translations for the Site Title and Tagline;
* Enter multilingual SEO titles and meta descriptions - compatible with Yoast SEO (free version);
* Add one or several languages using custom combinations of country flags, locales, and language names;
* Give each language its own URL (`example.com/`, `example.com/es/`, `example.com/fr/`, and so on);
* Switch languages on the front-end with a drop-down menu extension and/or a customizable widget with various display options;
* Switch the admin interface language from the top bar.

https://www.youtube.com/watch?v=zoTWY9JrXLs

= WPGlobus Plus =

**WPGlobus Plus** is the professional add-on for WPGlobus. It works together with this plugin and adds:

* Translated addresses, including the "slug" (`/my-page/` becomes `/fr/ma-page/`, `/es/mi-pagina/`, and so on), and translated category, tag and post type bases;
* Publish a post in some languages while the others are still drafts;
* Multilingual ACF WYSIWYG fields and ACF PRO Options pages;
* Yoast SEO analysis and social previews in every language;
* A different menu per language, and more.

WPGlobus Plus is developed and sold on wpglobus.com. [Get WPGlobus Plus](https://wpglobus.com/product/wpglobus-plus/)

= TIV Globus =

**TIV Globus is not WPGlobus Plus.** It is a separate all-in-one plugin that runs instead of WPGlobus, and it does not work with WPGlobus Plus. TIV Globus is planned to become a full replacement for the whole WPGlobus family, including the Plus features - see what it covers today and what is planned on the [comparison page](https://wpglobus.com/compare/).

Today TIV Globus adds:

* WooCommerce in every language: products, categories, attributes, cart, checkout and emails;
* Page builders (Elementor and Avada) in every language;
* Translated addresses (slugs), also for WooCommerce products.

https://www.youtube.com/watch?v=s37KofMsKBw

[Get TIV Globus](https://wpglobus.com/tiv-globus/) - it reads the WPGlobus format, so your translations are kept.

[Compare WPGlobus, WPGlobus Plus and TIV Globus](https://wpglobus.com/compare/)

= For WPGlobus for WooCommerce customers =

Owned **WPGlobus for WooCommerce**? Its successor is TIV Globus. Test it before you buy - [ask for a free TIV Globus ZIP](https://wpglobus.com/free-tiv-globus/).

= Important Notes: please read first! =

These notes apply to WPGlobus, WPGlobus Plus and TIV Globus.

* NO AUTOMATIC TRANSLATION:
	* The plugin does NOT translate texts automatically! You **translate texts manually**.
* IF YOU UNINSTALL, YOU MUST REMOVE THE EXTRA LANGUAGES:
	* All translations are stored together in a special format: `{:en}English{:}{:fr}French{:}{:es}Spanish{:}`. If the plugin is not active, every language shows at once and your site becomes unreadable. Before you **deactivate and uninstall**, you **must run the cleanup tool** to remove all languages but one. See the details in the plugin's settings.
* PAGE BUILDERS / COMPOSERS:
	* Support for the Elementor and Avada page builders is available only in **TIV Globus**.
* COOKIES:
	* The plugin uses a browser cookie to remember your language preference. It stores only the language code (such as `en` or `es`) - no personal information.
* MULTISITE:
	* The **multisite** mode (multiple virtual sites sharing a single WordPress installation) is **not tested and not officially supported**. It may still work, but use it at your own discretion.

= Compatibility with themes and plugins =

WPGlobus works with any theme or plugin that passes its text through the standard WordPress filters before displaying it - which covers the large majority of them.

Some add-ons that render their own output (sliders, forms, page composers, and the like) are not always multilingual-ready. When you find an element that will not translate, please **let its author know** - the fix is usually small.

We test against many popular themes and plugins and follow their updates as closely as we can. Since third-party code changes frequently, an occasional tweak on our side may be needed after an update.

= Permalinks =

WPGlobus needs "pretty" permalinks. Go to `Settings -> Permalinks` and pick any structure other than "Plain" (with no `index.php` in it) - URLs like `example.com/?p=123` will not work.

== Installation ==

You can install this plugin directly from your WordPress dashboard:

1. Go to the *Plugins* menu and click *Add New*.
1. Search for *WPGlobus*.
1. Click *Install Now* next to the WPGlobus plugin.
1. Activate the plugin.

Alternatively, see the guide to [Manual Plugin Installation](https://wordpress.org/documentation/article/manage-plugins/#manual-plugin-installation-1).

== Frequently Asked Questions ==

= No automatic translation =

WPGlobus does NOT translate texts! You need to **translate texts manually**.

= After deactivating WPGlobus, all my pages look like garbage! =

What you see is a mix of the languages, which WPGlobus knows how to handle when it's active.
When you deactivate WPGlobus, your site is not multilingual anymore, and you have to remove all translations.

WPGlobus stores all translations using a special format: `{:en}English{:}{:fr}French{:}{:es}Spanish{:}`. If you decide to **deactivate WPGlobus**, you **must run the cleanup tool** to keep only one language. See the details on the "Uninstall" tab in the WPGlobus Settings.

= When I switch language, I am getting 404 on all pages =

Go to `Settings -> Permalinks`, make sure the permalink structure is not "Plain", and click `Save Changes`. It should help.

= What is the difference between WPGlobus, WPGlobus Plus and TIV Globus? =

**WPGlobus** (this plugin) is free, with the essential multilingual tools. **WPGlobus Plus** is a paid add-on that works together with WPGlobus and adds translated URLs, publishing per language and more. **TIV Globus** is a separate all-in-one plugin that replaces WPGlobus and adds WooCommerce and page-builder support. TIV Globus does not work with WPGlobus Plus; choose one. See the [comparison](https://wpglobus.com/compare/).

= I own WPGlobus Plus or WPGlobus for WooCommerce. Are they still supported? =

**WPGlobus Plus** is supported and developed - renew your license on [wpglobus.com](https://wpglobus.com/product/wpglobus-plus/) to get the latest version. **WPGlobus for WooCommerce** has been replaced by **TIV Globus**; as a past customer you can [test TIV Globus free](https://wpglobus.com/free-tiv-globus/) before you buy.

= Is TIV Globus the new version of WPGlobus Plus? =

No. TIV Globus is a different plugin and does not work with WPGlobus Plus. It is planned to cover the Plus features in the future; until then, keep WPGlobus + WPGlobus Plus if you need them. See the [comparison](https://wpglobus.com/compare/).

= Will my translations and settings carry over to TIV Globus? =

Yes. TIV Globus reads the same storage format as WPGlobus, so your existing translations and language settings are kept. Settings of WPGlobus Plus features that TIV Globus does not have yet are not used until they arrive. Your content stays compatible with WPGlobus, so you can switch back later if you ever need to.

= Does TIV Globus require WooCommerce? =

No. TIV Globus is sold on the WooCommerce.com marketplace, but it works on any site - with or without WooCommerce.

== Changelog ==

= 3.0.7 =
* Security: WPGlobus Plus administrative requests now require the right user permissions, also for sites that have not yet updated WPGlobus Plus.
* Improved: License and update messages for WPGlobus Plus (renewal reminders, clearer errors).
* Changed: Descriptions and recommendations now include WPGlobus Plus again, next to TIV Globus.
* Changed: TIV Globus is described as what it is today - a separate plugin that runs instead of WPGlobus and does not work with WPGlobus Plus.

= 3.0.6 =
* Fix: Block editor (Gutenberg) - saving a post or page that has classic meta boxes (for example, from ACF) no longer strips backslashes from the content. This corrects a regression introduced in 3.0.3 that could break block data such as line breaks and encoded characters. (Props @homepagehelden)
* Tested up to: 7.1.2

= 3.0.5 =
* Tested up to: 7.0.4


See `changelog.txt` for the older entries.
