C2Q Headline

Installation & Integration

Installation Manual| User Manual
November 05, 2024•2 min read

Document Version: 1.0
Date: November 5, 2024
Target Audience: Magento 2 Developers and System Administrators
Modules: Cart2Quote_Quotation, Hyva_Cart2QuoteQuotation (Hyvä Compatibility), Hyva_CompatModuleFallback
Pre-requisite: Cart2Quote Quotation Module Installation Manual - Installation Manual

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.

Back to Blog