README

Supercharge Customer Engagement and Boost Revenue with AI-Driven Visual Product Recommendations

In modern e-commerce, capturing a shopper's attention and guiding them to the right product is key to driving sales. The MHinspeya Hyvä Picalike module integrates an advanced visual similarity engine directly into your Magento 2 store, allowing you to showcase hyper-relevant product alternatives on the Product Detail Page (PDP).

Tailored specifically for the ultra-fast Hyvä Theme, this module provides a seamless, lightning-fast recommendation experience that matches your store's style while keeping performance at its peak.

Why Choose MHinspeya Hyvä Picalike?

📈 Increase Average Order Value (AOV)

By dynamically displaying products similar in shape, color, gender, and style, you entice customers to discover alternative choices they might prefer, increasing conversions and maximizing shopping cart value.

⚡ Engineered for Hyvä Themes

No slow page loads or heavy layouts. Built to work out-of-the-box with the Hyvä frontend ecosystem, it leverages lightweight Alpine.js and Tailwind CSS frameworks for micro-animations and smooth carousel sliders.

🤖 Automated Catalog Synchronization

Say goodbye to manual cross-sell linking. The module automatically generates categorized product export data, processes CSV files, and securely synchronizes them with Picalike’s image recognition servers via SFTP behind the scenes.

⚙️ Complete Control & Flexibility

An administrative interface lets you enable or disable the module with a single click, adjust pricing boundaries, set attribute preferences (for Brand, Size, and Color), and manage API parameters directly from your Magento Backend.

Key Features & Capabilities

• Visual Similarity Matching: Recommends alternative items based on image analysis and characteristics (color, shape, brand, gender) from the Picalike API.
• Hyvä-Ready Slider Integration: Renders similar products inside a responsive, swipe-friendly carousel slider using Splide.js.
• Smart Fallback Handling: If a product is out of stock or does not have recommendations, the slider hides itself seamlessly, maintaining a clean storefront look.
• Fully Configurable Settings:
  • One-click module activation (Enabled / Disabled).
  • Configurable attribute selectors (Size, Brand, Color mappings).
  • Price range filters (Price From, Price Till, Streichpreis checks).
  • Cron-managed catalog exports.
• Wishlist & Compare Actions: Allow customers to add recommended items to their wishlists directly from the carousel.
• Localized & Multi-language Support: Ready-to-use German translations (de_DE, de_AT, de_CH) ensure a localized experience for DACH region storefronts.

Installation

Manual Installation

1. Download the module from the official website or clone the repository.
2. Extract the downloaded files to the app/code/MHinspeya/Picalike directory of your Magento 2 installation.

3. Run the following commands from the root of your Magento installation:

   php bin/magento module:enable MHinspeya_Picalike
   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento setup:static-content:deploy
   php bin/magento cache:clean
   php bin/magento cache:flush
   

Composer Installation

1. Run the following command to install the module via Composer:

   composer require mhinspeya/inspeya-hyva-picalike
   

2. After the module is installed, run the following commands from the root of your Magento installation:

   php bin/magento module:enable MHinspeya_Picalike
   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento setup:static-content:deploy
   php bin/magento cache:clean
   php bin/magento cache:flush
   

Support

For any issues or questions, please visit our support page or contact us at support@inspeya.com.