====== Magento 2 Allow UTF8MB4 Extension ======

===== Extension context =====
This extension enables safe use of utf8mb4 emoji/unicode content in Magento areas where text filtering or validation can otherwise strip or reject 4-byte characters.

  * **Module name**: `Toweringmedia_AllowUtf8mb4`
  * **Composer package**: `toweringmedia/module-allow-utf8mb4`

===== Quick links =====
  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]

===== Installation =====
<code bash>
cd /path/to/magento
composer require toweringmedia/module-allow-utf8mb4
php bin/magento setup:upgrade
php bin/magento cache:flush
</code>

===== Before you enable =====
  * Confirm Magento DB/tables already use utf8mb4-compatible collation where required.
  * Take a DB backup before enabling in production.

===== Configuration =====
No admin configuration screen is required for standard usage. The module behavior is active once enabled.

===== Validation checklist =====
  * Module enabled: `php bin/magento module:status Toweringmedia_AllowUtf8mb4`.
  * Save test content containing 4-byte emoji in an affected field.
  * Re-open and confirm characters persist without corruption.

===== Troubleshooting =====
  * If characters still fail to save, verify MySQL charset/collation is utf8mb4 on affected tables/columns.
  * Clear Magento caches after enabling.

===== SEO and conversion links =====
  * [[https://toweringmedia.com/magento-2-extensions|Magento 2 Extensions Catalog]]
  * [[https://toweringmedia.com/magento-2-development-services|Magento 2 Development Services]]

===== Related Magento 2 docs =====
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]]