zaius/zaius-magento-2 1.0.0-beta.4

The Zaius Engage Connector for Magento 2. This module is currently in a BETA state, and therefore not recommended in production environments.

Type

magento2-module

License

MIT

Requires
Requires (dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

Zaius Magento 2 Connector

Integrate Zaius directly into your Magento instance using the Zaius Magento 2 Connector.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

  1. Magento 2 "^2.2.5"
  2. PHP 5 >= 5.5.0, PHP 7
  3. Composer

Installing

Composer

By far the quickest and easiest way to install and maintain the Zaius connector is to use Composer.

  1. Require the Zaius Magento 2 package.
  2. Install the Zaius Magento 2 package.
  3. Finally, make sure the package is up-to-date.
composer require zaius/zaius-magento-2
composer install
composer update zaius/*

Note: during beta testing, you will need to specify your willingness to use the beta releases of both the module and the underlying PHP SDK:

  1. Edit your <MAGENTO_ROOT>/composer.json file:
"minimum-stability" "beta",
"prefer-stable": true
  1. Add the required packages:
composer require zaius/zaius-magento-2:^1.0
composer install
composer update zaius/*

ZIP

  1. Download the Zaius Magento 2 module archive from Git: https://github.com/ZaiusInc/zaius-magento-2/archive/master.zip
  2. Extract the contents of the ZIP file to /app/code/Zaius/Engage/.

Verify & Enable the Zaius Magento 2 Connector

To verify that the extension installed properly, run the following command:

php bin/magento module:status

By default, the extension is probably disabled:

List of disabled modules:
Zaius_Engage

Enable the extension and clear static view files:

php bin/magento module:enable Zaius_Engage --clear-static-content

You should see the following output:

The following modules have been enabled:
- Zaius_Engage

To make sure that the enabled modules are properly registered, run 'setup:upgrade'.
Cache cleared successfully.
Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes.
Generated static view files cleared successfully.

Register the extension:

php bin/magento setup:upgrade

Recompile your Magento project:

php bin/magento setup:di:compile

Verify that the extension is enabled:

php bin/magento module:status

You should see output verifying that the extension is no longer disabled:

List of enabled modules:
Zaius_Engage

List of disabled modules:
None

Clean the cache:

php bin/magento cache:clean

Configuration

After installing the module, all configuration is done via Stores >> Configuration >> Zaius >> Engage.

Zaius Engage Status

Enabled: Enable or disable the Zaius Engage Connector functionality.

Version: The currently installed version of the Zaius Engage Connector.

Composer Installed?: Checks if Composer is installed. Will ALWAYS be installed for Magento 2 projects.

SDK Installed?: Checks if the Zaius PHP SDK is installed. The SDK is REQUIRED by the Zaius Engage Connector, and installed automatically with Composer.

Configuration

Zaius Tracker ID: Configuration field for the Zaius client Tracker ID. Found at API Management in the Zaius client Account.

Zaius Private API Key: Configuration field for the Zaius Private API Key. Found at API Management in the Zaius client Account. This is REQUIRED for [Batch Updates](Batch Updates) to work.

Enable Amazon S3: Enable or disable the Amazon S3 Upload functionality.

Amazon S3 Key: Configuration field for the Zaius Client Amazon S3 Key. Found At Integrations in the Zaius Client Account. This is REQUIRED if Amazon S3 functionality is enabled.

Amazon S3 Secret: Configuration field for the Zaius Client Amazon S3 Secret. Found At Integrations in the Zaius Client Account. This is REQUIRED if Amazon S3 functionality is enabled.

Settings

Collect All Product Attributes: Enable or disable the functionality to collect all product attributes, or only the minimum.

Track Orders on Frontend: Enable or disable the functionality to track orders on the frontend of the website.

Timeout: Specify a number of seconds to wait before timing out the connection to Zaius.

Schema Update

FUNCTIONALITY DEPRECATED

Batch Updates

Enabled?: Enable or disable the Batch Update functionality. With batch updates enabled, updates are sent to Zaius on a schedule, instead of "on-the-fly". This can lower resource use. Clients must enter their [Zaius Private API Key](Zaius Private API Key) for this functionality to communicate with Zaius.

Zaius Localizations

Enabled?: Enable or disable the Zaius Localizations functionality. With Zaius Localizations functionality enabled, localized store_view data will be sent to Zaius.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.