mhinspeya / virtuelle-anprobe

1.0.1 2026-09-16 12:37 UTC

Requires

• mhinspeya/backend-mod: ^1.0

Suggests

• mhinspeya/backend-mod: Support Configuration

OSL-3.0

• MHinspeya

• magento
• magento 2
• MHinspeya
• Virtual Try-On

Published on Packagist.org on 2026-09-16 12:37 UTC

README

Magento 2 / Hyvä module that adds a Virtual Try-On accordion on the product page: EAN-13 barcode, App Store / Google Play badges, and an optional “more information” link for your customer app.

Features

• EAN barcode — Renders an EAN-13 barcode for simple products or the first enabled variant with an ean attribute (configurable products).
• Accordion UI — Collapsible block with configurable title, description, and icon (Alpine.js + Tailwind, Hyvä-friendly).
• App store links — iOS App Store and Google Play URLs from admin-configured app IDs; badge images ship with the module (no external CDN).
• More information link — Configurable label and URL in the accordion footer; leave the URL empty to hide the link.
• License validation — Inspeya license service on config save; invalid or missing key disables the module.
• Localization — English base strings with de_DE, de_CH, and de_AT CSV files.

Requirements

• PHP 8.1–8.4
• Magento 2.4.x
• Hyvä theme (Alpine.js, Tailwind CSS)
• mhinspeya/backend-mod (MHinspeya_BackendMod) — admin tab and shared Inspeya configuration

Installation

1. Install the module under app/code/MHinspeya/VirtuelleAnprobe (or via Composer if published).
2. Ensure MHinspeya_BackendMod is installed.

bin/magento module:enable MHinspeya_VirtuelleAnprobe
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f de_DE de_CH de_AT en_US
bin/magento cache:flush

Configuration

Admin: Stores → Configuration → MHinspeya.de → Virtual Try-On
Menu shortcut: Inspeya → Virtuelle Anprobe (requires ACL MHinspeya_VirtuelleAnprobe::config)

License

1. Enter your License Key and Save Config.
2. A green or red icon next to the field shows the current validation status.
3. If validation fails, Enable Virtual Try-On is set to No automatically.
4. A valid license does not force the module on — turn Enable Virtual Try-On to Yes when you are ready.

General settings

Setting	Config path	Notes
Enable Virtual Try-On	virtuelle_anprobe/general/enabled	Master switch for the storefront block
Title	virtuelle_anprobe/general/title	Default: Virtuelle Anprobe
Description	virtuelle_anprobe/general/description	Accordion subtitle
Icon	virtuelle_anprobe/general/icon	Upload to media/virtual/; default SVG in module
iOS App ID	virtuelle_anprobe/general/ios_app_id	App Store slug, e.g. id123456789
Android App ID	virtuelle_anprobe/general/android_app_id	Play package name, e.g. de.example.app
More Information URL	virtuelle_anprobe/general/more_info_url	Default: https://bernheim.ch/kundenapp; empty = no link
More Information Link Text	virtuelle_anprobe/general/more_info_text	Default: Mehr Informationen
License Key	virtuelle_anprobe/license/license_key	Required for production use

Scope: most general fields support website and store view; license key is default config only.

Storefront behavior

• Layout: view/frontend/layout/catalog_product_view.xml injects barcode_accordion.phtml.
• The block is shown only when the module is enabled, a license allows operation (module not auto-disabled), and the product has a usable EAN.
• Barcodes are generated via the public EAN-13 API (bwipjs-api.metafloor.com).
• Bundled assets: view/frontend/web/images/virtuelle_anprobe.svg, appstore.png, playstore.png.

Product data

Products must expose an ean product attribute. For configurable products, at least one enabled child variant needs a non-empty EAN.

Localization

Translation files:

• i18n/de_DE.csv
• i18n/de_CH.csv
• i18n/de_AT.csv

Includes storefront copy, license messages, and admin field comments where translated.

License

License verification uses the Inspeya shop API (shop.inspeya.com), consistent with other MHinspeya extensions. Internal development keys may be supported for MHinspeya environments only.

© MHinspeya. All rights reserved.