Installation & Integration

Overview

This document provides step-by-step instructions to install the Hyva_Cart2QuoteQuotation module, which enables compatibility between the Cart2Quote_Quotation module and Hyvä themes. The Hyva_Cart2QuoteQuotation module facilitates limited functionality of the Cart2Quote_Quotation module, such as:

• Add to Quote button visibility on product and category pages.
• Miniquote functionality integration.
• Quotation request form on the quotation view page.

Important Notes

1. Compatibility Limitations: The Hyva_Cart2QuoteQuotation module does not support all Cart2Quote_Quotation features. Some functionalities of the Cart2Quote module are not fully available when integrated with Hyvä.
2. Required Modules: This module requires Hyva_CompatModuleFallback for proper integration with Hyvä themes.

Requirements

• Magento 2: Ensure your Magento 2 installation meets the standard server requirements for Cart2Quote.
• Hyvä Theme: Ensure the Hyvä theme is correctly installed.
• Hyva_CompatModuleFallback Module: This is a dependency for enabling the Hyvä compatibility functionality.

Custom Header Installation

To ensure seamless functionality and compatibility with the Hyva_Cart2QuoteQuotation module, it is recommended to install a custom header. This header component:

1. Prevents Theme Overrides: By utilising a custom header, the module’s core functionality remains intact without risking conflicts from theme overrides.
2. Maintains Module Functionality: The custom header has been designed to fully support and display all module-specific elements, such as the “Add to Quote” button.
3. Supports Webshop Customisation: This setup enables webshops to apply their unique headers while still maintaining compatibility with the Cart2Quote features, allowing for a fully customised and cohesive look.

By implementing this custom header, webshop developers can enhance module stability across various themes and maintain Cart2Quote integration reliability without compromising their design elements.

Step-by-Step Installation

Step 1: Install the Cart2Quote_Quotation Module

Follow the instructions in the Cart2Quote Installation Manual to install the base Cart2Quote_Quotation module.

Step 2: Install Hyva_Cart2QuoteQuotation and Hyva_CompatModuleFallback

1. Download and Install Hyva_Cart2QuoteQuotation:
• Obtain the module files from Cart2Quote.
• Upload the module to your Magento installation directory at app/code/Hyva/Cart2QuoteQuotation.
• Run the following Magento CLI commands:

bin/magento module:enable Hyva_Cart2QuoteQuotation bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:clean

2. Download and Install Hyva_CompatModuleFallback:
• Upload this module to your Magento installation directory at app/code/Hyva/CompatModuleFallback.
• Run the following Magento CLI commands:

bin/magento module:enable Hyva_CompatModuleFallback bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:clean

3. Verify and Configure Module Integration:
• Once both modules are enabled, verify that Hyva_Cart2QuoteQuotation and Hyva_CompatModuleFallback are correctly integrated.
• Test the “Add to Quote” button visibility on product, category, and quotation pages.
• Ensure the miniquote and quotation request form on the quotation view page function as expected.

Known Limitations

The Hyva_Cart2QuoteQuotation module currently supports only the above-listed functionalities. Future updates may expand compatibility, but users are advised to regularly check module documentation for updates.