WPSSO User Locale Selector

Provides a convenient locale / language / region selector in the WordPress admin toolbar.

Perfect for anyone that needs to switch languages quickly and easily:

Allows logged-in users to easily change their preferred locale / language / region setting right from the toolbar menu, instead of having to modify their user profile settings.

The default behavior of WordPress is to apply the user locale preference to the admin back-end only - the WPSSO User Locale Selector add-on can optionally extend the locale preference to the front-end webpage as well.

Do you use the Polylang plugin?

If the Polylang plugin is detected, the locale selector will automatically use the correct Polylang language URLs.

Users Love the WPSSO UL Add-on

★★★★★ - "Practical and Fast - Works as advertised. Very easy to use." - grouper

WPSSO Core Required

WPSSO User Locale Selector (WPSSO UL) is an add-on for the WPSSO Core plugin, which provides complete structured data for WordPress to present your content at its best on social sites and in search results – no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.

Install and Uninstall

• Install the WPSSO User Locale Selector add-on.
• Uninstall the WPSSO User Locale Selector add-on.

Frequently Asked Questions

• None.

Notes and Documentation

• Developer Resources
  • Filters
    • All Filters
    • Filter Examples
      • Disable User Locale on Front-End
      • Modify the Menu Title
      • Modify the Redirect URL

1. 

   WPSSO User Locale selector in the WordPress toolbar menu.

Version Numbering

Version components: {major}.{minor}.{bugfix}[-{stage}.{level}]

• {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes).
• {minor} = New functionality was added or improved in a backwards-compatible manner.
• {bugfix} = Backwards-compatible bug fixes or small improvements.
• {stage}.{level} = Pre-production release: dev < a (alpha) < b (beta) < rc (release candidate).

Standard Edition Repositories

• GitHub
• WordPress.org

Development Version Updates

WPSSO Core Premium edition customers have access to development, alpha, beta, and release candidate version updates:

Under the SSO > Update Manager settings page, select the "Development and Up" (for example) version filter for the WPSSO Core plugin and/or its add-ons. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can reselect the "Stable / Production" version filter at any time to reinstall the latest stable version.

WPSSO Core Standard edition users (ie. the plugin hosted on WordPress.org) have access to the latest development version under the Advanced Options section.

Changelog / Release Notes

Version 3.8.1 (2023/01/26)

• New Features
  • None.
• Improvements
  • Updated the minimum WordPress version from v5.2 to v5.4.
• Bugfixes
  • None.
• Developer Notes
  • Updated the WpssoAbstractAddOn library class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.
  • WPSSO Core v14.7.0.

Version 3.8.0 (2023/01/20)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated the SucomAbstractAddOn common library class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v14.5.0.

Version 3.7.0 (2022/12/28)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoUlFiltersOptions class.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v14.0.0.

Version 3.6.1 (2022/03/07)

Maintenance release.

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v11.5.0.

Version 3.6.0 (2022/01/19)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Renamed the lib/abstracts/ folder to lib/abstract/.
  • Renamed the SucomAddOn class to SucomAbstractAddOn.
  • Renamed the WpssoAddOn class to WpssoAbstractAddOn.
  • Renamed the WpssoWpMeta class to WpssoAbstractWpMeta.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v9.14.0.

Version 3.5.1 (2021/11/16)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Refactored the WpssoUlLocale->add_locale_toolbar() method.
  • Refactored the SucomAddOn->get_missing_requirements() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.
  • WPSSO Core v9.8.0.

Version 3.5.0 (2021/11/10)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Replaced SucomUtilWP::get_available_languages() by SucomUtil::get_available_locales() for consistency.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.7.0.

Version 3.4.1 (2021/10/06)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Standardized get_table_rows() calls and filters in 'submenu' and 'sitesubmenu' classes.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.1.0.

Version 3.4.0 (2021/09/24)

Maintenance release for WPSSO Core v9.0.0.

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.
  • WPSSO Core v9.0.0.

Version 3.3.2 (2021/06/11)

• New Features
  • None.
• Improvements
  • Minor label change and translation update.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.7.
  • WPSSO Core v8.34.0.

Version 3.3.1 (2021/04/30)

• New Features
  • None.
• Improvements
  • Minor CSS and text formatting updates.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.7.
  • WPSSO Core v8.28.0.

Version 3.3.0 (2021/04/17)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added support for SucomUtilWP::get_available_languages().
• Requires At Least
  • PHP v7.0.
  • WordPress v4.7.
  • WPSSO Core v8.26.3.

Version 3.2.1 (2021/02/25)

• New Features
  • None.
• Improvements
  • Updated the banners and icons of WPSSO Core and its add-ons.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.7.
  • WPSSO Core v8.25.2.

Version 3.2.0 (2020/11/20)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Included the $addon argument for library class constructors.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.7.
  • WPSSO Core v8.16.0.

Version 3.1.0 (2020/11/20)

• New Features
  • None.
• Improvements
  • Renamed the 'default' menu item to 'Default'.
• Bugfixes
  • None.
• Developer Notes
  • Renamed the 'wpsso_user_locale_front_end' filter to 'wpsso_user_locale_show_on_front'.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.7.
  • WPSSO Core v8.13.0.

Version 3.0.1 (2020/10/17)

• New Features
  • None.
• Improvements
  • Added a call to switch_to_locale() on the front-end.
  • Refactored the add-on class to extend a new WpssoAddOn abstract class.
• Bugfixes
  • Fixed backwards compatibility with older 'init_objects' and 'init_plugin' action arguments.
• Developer Notes
  • Added a new WpssoAddOn class in lib/abstracts/add-on.php.
  • Added a new SucomAddOn class in lib/abstracts/com/add-on.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.7.
  • WPSSO Core v8.12.1.