econda/magento2

econda Magento 2 extension including analytics, recommendations and personalization

v1.0.1 2023-06-13 07:08 UTC

Requires

• magento/magento-composer-installer: *

proprietary

• econda GmbH

README

This extensions allows you to use econda Analytics tracking and econda Cross Sell recommendations with just a few clicks.

Installation

Install extension using Composer (recommended)

Add "econda/magento2" to composer.json

"require":
    {
	 "econda/magento2":"dev-main"
    }

Run composer update

composer update

Install the extension via download (not recommended)

Download the extension from https://git.econda.de/system-integration/magento2 Create directory app/code/Econda/Base and paste the extension in it.

Enable the extension:

bin/magento module:enable Econda_Base

Register the extension:

bin/magento setup:upgrade

Recompile your project:

bin/magento setup:di:compile

Clean the cache:

bin/magento cache:clean

Upgrade plugin

Update via Composer

Run composer update

composer update

Register the extension:

bin/magento setup:upgrade

Recompile your project:

bin/magento setup:di:compile

Clean the cache:

bin/magento cache:clean

Configuration

Login to your Magento 2 Admin backend. To open configuration, go to Stores --> Configuration --> Econda

Analytics

General Configuration

Client Key

Insert your client key here. To do this, log into the Cockpit with your access data and click on Integration in the navigation. Request the integration code via the </> icon and copy the client key.

Container-ID

Insert your container ID here.To do this, log into the Cockpit with your access data and click on Integration in the navigation. Request the integration code via the </> icon and copy the container ID.

Site ID

Optionally add a site ID here. With the site ID you set the identifier for different websites. Default: Name of your integration.

Language ID

Optionally add a language ID here. You can use the language ID to specify the language of the page currently being displayed. Default: de for German

Country ID

Optionally add a Country ID here. With the Country ID you can distinguish your website for different countries. Default: DE for Germany

Export schedule

Please set the cronTab schedule for the export.

Analytics Attributes

If you want to give additional informations to econda you can define attributes here. For e.g. weight or color.

HTTP Basic Authentication (Export)

Is used for the product export for econda Cross Sell.

The URL is build like: {baseUrl}/econda/export/download?storeCode={storeCode} Please replace {baseUrl} and {storeCode} according to your shop settings.

Cross Sell

Cross Sell is the recommendation engine and is disabled by default.

To enable econda Cross Sell switch to Enabled Yes.

You can find your Cross Sell instance ID at https://crosssell.econda.de/#/settings

Cross Sell

To add Cross Sell recommendations widgets go to: Content --> Widgets

This extension offers three Cross Sell widgets by default:

• econda cart widget
• econda product widget
• econda category widget

Commands

To create your export file manually:

bin/magento econda:export

Example custom attribute to extend module

Adds a custom attribue to the product view page.

Files

app/code/{Vendor}/{Module}/registration.php

<?php
use Magento\Framework\Component\ComponentRegistrar;

ComponentRegistrar::register(ComponentRegistrar::MODULE, '{Vendor}_{Module}', __DIR__);

app/code/{Vendor}/{Module}/etc/di.xml

<?xml version="1.0"?>
<config>
    <type name="Econda\Base\Block\ProductView">
        <plugin name="{vendor}_{module}_plugin_block_product_view" type="{Vendor}\{Module}\Plugin\Econda\Block\ProductView" />
    </type>
</config>

app/code/{Vendor}/{Module}/etc/module.xml

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="{Vendor}_{Module}" setup_version="0.1.0">
        <sequence>
            <module name="Econda_Base"/>
        </sequence>
    </module>
</config>

app/code/{Vendor}/{Module}/Plugin/Econda/Block/ProductView.php

<?php

namespace {Vendor}\{Module}\Plugin\Econda\Block;

class ProductView
{

    /**
     * @param array $attributes
     * @return array
     */
    public function afterGetAttributes(\Econda\Base\Block\ProductView\Interceptor $interceptor, array $attributes): array
    {
        $attributes['myCoolAttribute'] = 'test';
        return $attributes;

    }
}

Enable module

bin/magento module:enable {Vendor}_{Module}
bin/magento setup:di:compile
bin/magento setup:upgrade