README

Delgraf_PasskeyAuthTranslations adds Italian, German, French and Spanish translations to mage-os/module-passkey-auth, which ships only with English and Romanian.

It covers every string of the base module: the sign-in button and messages on the storefront, the My Passkeys page in the customer account, the passkey enrollment banner, the "passkey added/removed" notification emails and the admin configuration and customer grid. It also translates Delgraf_PasskeyAuthPopup, which reuses the base module's strings.

Languages

Locale	Language	Term used for "passkey"	Form of address
`it_IT`	Italian	passkey (feminine)	informal (tu)
`de_DE`	German	Passkey (masculine)	formal (Sie)
`fr_FR`	French	clé d'accès	formal (vous)
`es_ES`	Spanish	llave de acceso	formal (usted)

The terms follow the ones Apple, Google and Microsoft use in each language, so customers see the same word as in their browser and operating system prompts.

Requirements

Magento Open Source / Adobe Commerce 2.4.x or Mage-OS, PHP 8.2+
mage-os/module-passkey-auth 1.x
A store view whose Locale (Stores > Configuration > General > General > Locale Options) is one of the locales above

Installation

Run all commands from the Magento root directory, as the user that owns the Magento files. Back up your code and database first, and try the module on a staging site before production.

Option 1: Composer (recommended)

Put the store in maintenance mode (production stores only):
```
bin/magento maintenance:enable
```

Download the module:

composer require delgraf/module-passkey-auth-translations

Enable the module and update Magento:

bin/magento module:enable Delgraf_PasskeyAuthTranslations
bin/magento setup:upgrade

In production mode, compile and deploy static content. List every locale your store views use, for example en_US it_IT. JavaScript strings are only translated for the locales you deploy:
```
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US it_IT
```

Clear the cache and leave maintenance mode:

bin/magento cache:flush
bin/magento maintenance:disable

Option 2: Manual (app/code)

Download the latest version as a ZIP from the Tags page and extract it.
Copy its contents to app/code/Delgraf/PasskeyAuthTranslations/, so that registration.php is at app/code/Delgraf/PasskeyAuthTranslations/registration.php.
Run steps 1 and 3 to 5 of the Composer installation.

Check the installation

Check that the module is enabled:

bin/magento module:status Delgraf_PasskeyAuthTranslations

Open a store view with one of the supported locales and go to the customer login page: the passkey button should read, for example, Accedi con passkey in Italian.
If the button is still in English, clear your browser cache or test in a private window: the browser may keep an old js-translation.json.

Customizing a translation

Translations are applied in this order, and each step overrides the previous one:

Module CSV files (the base module, then this module)
Theme CSV files (app/design/frontend/<Vendor>/<theme>/i18n/<locale>.csv)
Language packs
Inline translations stored in the database

To change a single phrase for your store, copy its line from i18n/<locale>.csv into your theme's CSV for that locale and edit the second column. Don't edit the files of this module: your changes would be lost on the next update.

Update

Read the CHANGELOG before updating. The module follows Semantic Versioning.

Installed with Composer

bin/magento maintenance:enable
composer update delgraf/module-passkey-auth-translations
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US it_IT
bin/magento cache:flush
bin/magento maintenance:disable

Installed manually (app/code)

Delete app/code/Delgraf/PasskeyAuthTranslations, copy in the new version as in the manual installation, then run the commands above except composer update.

When mage-os/module-passkey-auth adds or changes strings, they stay in English until this module is updated. Please open an issue if you notice untranslated text.

Uninstall

The module stores no data. After removing it, the passkey texts go back to English.

bin/magento maintenance:enable
bin/magento module:disable Delgraf_PasskeyAuthTranslations
composer remove delgraf/module-passkey-auth-translations
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US it_IT
bin/magento cache:flush
bin/magento maintenance:disable

For a manual installation, replace composer remove with rm -rf app/code/Delgraf/PasskeyAuthTranslations.

Contributing

Corrections and new languages are welcome as pull requests. Each file in i18n/ must contain exactly the same source strings as the base module's i18n/en_US.csv, keep every placeholder (%1, %name, %store_name, …) and HTML tag unchanged, and use UTF-8 with LF line endings.

License

Open Software License 3.0, the same license as mage-os/module-passkey-auth.

delgraf / module-passkey-auth-translations

Package info

Security

Statistics