micropackage/internationalization

Internationalization (i18n) wrapper for WordPress plugins, themes or libraries

1.0.2 2023-06-23 08:54 UTC

Requires

• php: >=5.6

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^0.5.0
• phpcompatibility/php-compatibility: ^9.1
• wp-coding-standards/wpcs: ^2.0

GPL-3.0-or-later

• Jakub Mikita

README

🧬 About Internationalization

The Internationalization micropackage is an unified wrapper for both load_plugin_textdomain and load_theme_textdomain functions.

It can handle both theme and plugin language packs but also any other 3rd party library, like a translated Composer package.

The language file must follow the scheme: {textdomain}-{locale_LOCALE}.mo.

This package is compatible with DocHooks library.

💾 Installation

composer require micropackage/internationalization

🕹 Usage

Call the action manually:

use Micropackage\Internationalization\Internationalization;

add_action( 'init', [ new Internationalization( $textdomain, $full_language_dir_path ), 'load_translation' ] );

Using DocHooks library:

Micropackage\DocHooks\Helper::hook( new Internationalization( $textdomain, $full_language_dir_path ) );

Retrieving full path to the directory:

$theme_language_dir  = get_template_directory() . '/languages';
$plugin_language_dir = plugin_dir_path( __FILE__ );

📦 About the Micropackage project

Micropackages - as the name suggests - are micro packages with a tiny bit of reusable code, helpful particularly in WordPress development.

The aim is to have multiple packages which can be put together to create something bigger by defining only the structure.

Micropackages are maintained by BracketSpace.

📖 Changelog

See the changelog file.

📃 License

This software is released under MIT license. See the LICENSE file for more information.