README

The MHinspeya_CheckSizeAPI module integrates your Magento 2 store with the Modehaus.de API to provide real-time stock availability and size checks for customers. It includes a frontend interface for checking availability across different physical stores and a dynamic link to external product pages when sizes are missing in the local store.

Features

• Real-time Inventory Check: Displays a list of available sizes across different physical store locations (Inventory Sources).
• Modehaus.de API Integration: Allows customers to check for missing sizes on Modehaus.de via a GraphQL API integration.
• Dynamic Icons: Fully configurable icons for "Store Availability" and "Check Size" features via the Magento Admin.
• AJAX Driven: Smooth, non-blocking user experience for checking sizes without page reloads.
• Hyvä Compatible: Built specifically for Hyvä themes using Alpine.js and Tailwind CSS.
• Full Localization: Support for English and German locales (de_DE, de_CH, de_AT).

Installation

1. Manual Installation

1. Upload the module files to app/code/MHinspeya/CheckSizeAPI.
2. Ensure you have the MHinspeya_BackendMod dependency installed.

2. Enable the Module

Run the following commands in your Magento root directory:

bin/magento module:enable MHinspeya_CheckSizeAPI
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

Navigate to Stores > Settings > Configuration > Inspeya > CheckSizeAPI Configuration to manage the module settings:

General Settings

1. Enable CheckOnSize in Frontend: Toggle the main feature on or off.
2. Product EAN/SKU for Check: Choose whether to send the EAN or SKU to the Modehaus.de API.
3. Modehaus API Authorization Key: Your unique API key for authentication.
4. Modehaus API Graphql API Key: The endpoint URL for the GraphQL search.
5. Modehaus API Shop URL: The base URL of the target shop.
6. Check Size Icon: Upload a custom SVG/PNG icon for the size check section.

Text Style Section

1. Modehaus.de Text Title: Customize the instructional text shown to users.
2. Availability Icon: Upload a custom SVG/PNG icon for the store availability section.

Technical Details

• Vendor: MHinspeya
• Module Name: CheckSizeAPI
• API Client: Uses Magento\Framework\HTTP\Client\Curl for all external communication.
• ViewModel: Business logic is decoupled from templates via the ConfigData ViewModel.

Localization

Base strings are in English. Translation files are available in:

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

© MHinspeya. All rights reserved.