Skip to content

Quick Multilingual allows you to create multilingual brochure sites on WordPress with automatic language attributes and hreflang tags.

License

Notifications You must be signed in to change notification settings

senlin/quick-multilingual

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Quick Multilingual

plugin version WP compatibility PHP compatibility

Last updated on September 26, 2024
Development version 1.5.5
requires at least WordPress 4.9
tested up to WordPress 6.6
Author: Pieter Bos

Quick Multilingual allows you to create multilingual brochure sites on WordPress with automatic language attributes and hreflang tags.

Description

Quick Multilingual is a WordPress plugin designed to offer a streamlined, user-friendly solution for creating bilingual websites with the flexibility to expand into multilingual sites in the future. This Lite version is tailored for smaller websites with up to two languages and a maximum of four pages, making it perfect for businesses and individuals who need a straightforward setup. The plugin automatically adjusts the HTML lang attribute and adding hreflang tags for better SEO and user experience.

Features

  • Adjust HTML Lang Attribute: Dynamically set the lang attribute in the HTML tag based on the current language.
  • Custom Hreflang Tags: Define custom hreflang tags for primary and secondary languages.
  • Language Folder Redirection: Redirect the parent language folder to the secondary language homepage.
  • Mapping: map up to 4 pages of the primary language to their translation in the secondary language.
  • Easy Configuration: User-friendly settings page for managing language settings and redirections.
  • Settings Link: Convenient link to the plugin settings from the main Plugins page.

Installation

  1. Upload the quick-multilingual folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the 'Plugins' menu in WordPress.
  3. Read "Configuration" in readme file.
  4. Go to Settings > Quick Multilingual to configure the plugin.

Configuration

  1. Add Pages: Create your website pages in the primary language as usual. For the secondary language, create a language “folder” page and add child pages underneath for each translated page.
  2. General Settings: Navigate to the Settings page and configure the HTML language attributes (there is a link included to look those up) for your primary and secondary languages. Define the language “folder” page and specify the number of pages your website will have (up to four in the Lite version).
  3. Map Translations: Use the Translation Mapping tab to link each secondary language page to its corresponding primary language page. Important: make sure to set the homepage as first mapped page.
  4. Finalise with Navigation: Add the main navigation menu with the primary language pages and the secondary language “folder” under which you can add the translated (child) pages. The plugin handles all the necessary technical details, ensuring your multilingual site functions smoothly with the correct language tags and redirections.

Frequently Asked Questions

How do I determine the correct HTML lang attribute and hreflang code for my languages?

You can find the appropriate HTML lang attributes and hreflang codes for most languages here.

What if my secondary language homepage is not listed?

Ensure the page is published and not in draft mode. Refresh the settings page to update the list of pages.

Can I use this plugin with any WordPress theme?

Yes, this plugin is designed to work with most themes, but menu handling is not included. You may need to customise your theme if it has specific requirements for multilingual navigation.

With a settings page comes additional entries in the database; what happens on uninstall?

Great question! Indeed the Quick Multilingual plugin writes its settings to the database. The included uninstall.php file removes all the plugin-related entries from the database once you remove the plugin via the WordPress Plugins page (not on deactivation).

I have an issue with this plugin, where can I get support?

Please open an issue on Github

Contributions

I welcome your contributions very much! PR's will be considered and of course bug reports and feature requests can also be seen as contributions! If you're interested in becoming involved, please let me know or simply send a PR with your proposed improvement.

License

Donations

Connect with me through

BHI Localization for Websites

SO WP Plugins

Github

LinkedIn

WordPress

Screenshots

Plugin Settings page (two tabs) and frontend output.

General Settings tab (set HTML attribute and hreflang tag primary/secondary languages)

Page Translations tab (to map translations)

Frontend sourcecode primary language

Frontend sourcecode secondary language

Changelog

1.5.5

  • September 26, 2024
  • Make HTML lang attribute output more robust

1.5.4

  • September 26, 2024
  • Plugin approved by WP Plugins Review Team
  • Update readme files with screenshots

1.5.3

  • Change the namespace from hlh_ to so_qmp_
  • Improve sanitisation and escaping throughout the plugin
  • Properly enqueue scripts and styles
  • Internationalise all user-facing strings, including those in JavaScript
  • Update the uninstall.php file for better security and precision
  • Ensure proper handling of external links

1.5.2

  • Resolve three errors (checking existence, unslashing, and sanitizing) that came up after running code through Plugin Check (PCP) plugin, which is requirement for release on WP Plugins Directory

1.5.1

  • Fix typos

1.5.0

  • Add uninstall.php file to remove all registered settings from wp_options table upon plugin deletion.

1.4.0

  • Adjusted custom hreflang code options for both primary and secondary languages.
  • Add option to set the secondary language "folder", the page that functions as the placeholder for the translations.
  • Add option to have user select the number of pages that need mapping (up to 4).
  • Adjust Page Translations UI to exclude the the secondary language folder from both primary and secondary language drop downs.

1.3.0

  • Added custom hreflang code options for both primary and secondary languages.
  • Fixed HTML lang attribute output based on the selected language.
  • Included a settings link on the main Plugins page.
  • Removed navigation menu handling as it is managed through custom theme code.

1.2.0

  • Improved hreflang tag generation to reflect proper language codes.
  • Added redirection from parent language page to secondary language homepage.

1.1.0

  • Initial release with basic functionality for setting HTML lang attribute and hreflang tags.

About

Quick Multilingual allows you to create multilingual brochure sites on WordPress with automatic language attributes and hreflang tags.

Resources

License

Stars

Watchers

Forks

Packages

No packages published