LokiCheckout_AdvancedCountryField

Professional
Standard
PHP 8.2 - 8.5
Magento 2.4.6 - 2.4.9
CSP Yes
Unit Tests 18
Integration Tests 7
PHPStan 5
Magento PHPCS 6
License OSL-3.0
Latest Release 1.0.1

This Magento 2 module is an add-on package to the LokiCheckout.

Installation

Install this package via composer:

composer require loki-checkout/magento2-advanced-country-field

Next, enable this module:

bin/magento module:enable LokiCheckout_AdvancedCountryField

Current status

pipeline success

Support

For getting support, create an Issue under the following project URL:

https://gitlab.yireo.com/loki-checkout/LokiCheckout_AdvancedCountryField.git

Configuration Options

The following options of this module can be configured via the Store Configuration:

Advanced Country Field > Add Emoji Flags
loki_checkout/advanced_country_field/add_emoji
Advanced Country Field > Emoji Flag Position
loki_checkout/advanced_country_field/emoji_position
Module Dependencies

The following dependencies are declared in the module its `etc/module.xml` file:

LokiCheckout_Core Loki_Base Loki_Components Loki_CssUtils Loki_FieldComponents Magento_AdminNotification Magento_Backend Magento_Catalog Magento_CatalogInventory Magento_Checkout Magento_CheckoutAgreements Magento_Cms Magento_Config Magento_Csp Magento_Customer Magento_Directory Magento_Eav Magento_Indexer Magento_MediaGalleryUiApi Magento_Newsletter Magento_Payment Magento_Quote Magento_Rule Magento_Sales Magento_SalesRule Magento_SalesSequence Magento_Shipping Magento_Store Magento_Tax Magento_Theme Magento_Ui Magento_User Magento_Variable Magento_Vault Magento_Widget Yireo_CspUtilities
Composer details
Magento module name
LokiCheckout_AdvancedCountryField
Composer name
loki-checkout/magento2-advanced-country-field
Composer version
1.0.1
Default branch
main
Requirements
ext-json: *
ext-mbstring: *
ext-pcre: *
loki-checkout/magento2-core: ^2.3
loki/magento2-components: ^2.2
loki/magento2-field-components: ^2.0
magento/framework: ^103.0
magento/module-backend: ^102.0
magento/module-config: ^101.2
magento/module-store: ^101.1
php: >=8.2 <8.6
Releases
1.0.1 11 November 2026
1.0.0 11 November 2026
Changelog

[1.0.1] - 03 November 2026

Fixed

  • Add ext-json and ext-pcre requirements and ignore false Loki_FieldComponents warning
  • Make the flag cache compatible with PHP 8.6 and skip it for unknown objects
  • Save the admin setting Add Emoji Flags to the path read by the module
  • Declare dependencies on Loki_FieldComponents and ext-mbstring
  • Keep unknown options, array keys and invalid country codes intact when adding flags

Added

  • Add configurable emoji flag position, defaulting to after the country name

[1.0.0] - 07 May 2026

  • Initial release with flags and optgroups

Last modified: June 1, 2026