Connect magnews to Magento

Configure the parameters for connecting magnews to Magento. The parameters are organized into three main subsections:

• General Configuration
• Store Configuration
• Automated Flow

General configuration

Connection to Magento

The parameters in this section detail the connection between the platform and Magento itself.
You will need to enter the following values:

• Web Services URL:
  indicates the address of the REST service, for example:
  http://wwww.mystore.com/index.php/rest
• User Name and Api Key/Password
  enter the User Name and Password of the user created on Magento.
• HTTP connection timeout
  if the Magento server is too slow to respond, increase the timeout value; otherwise, leave the default value.
• Disable certificate validity check
  this option disables the security certificate validity check.
• The web server requires authentication
  if authentication is required by the web server, enable this option and enter a username and password.
• The web server requires authentication for Magento frontend images
  if authentication is required by the web server to show frontend images, enable this option and enter a username and password.

The Status: field indicates whether magnews is effectively connected to Magento.
The Platform Plugin: field provides information about the version of the connector installed.
The plugin to install on Magento for the proper functioning of the integration is available (even after installation) by clicking on the link Installation of the Magento plugin.

After completing the configuration of the base parameters, test the connection by clicking the Test connection button.
The test will verify that magnews and Magento are indeed connected. If the result is positive, click Save in the upper right corner and confirm or customize the additional settings that will be displayed on the page.

Technical parameters

The technical parameters allow you to optimize the performance of some aspects of the synchronization between the connector and the platform.

• Page size: indicates the number of contacts per page that will be processed by the contacts synchronization. The higher the number, the faster the operation, but it requires a Magento server with more resources.
• Timezone: changing the timezone (default is UTC) may cause issues with dates. It is advisable to change this value if you are sure to operate in a region with a different timezone.

• Image cache time-to-live (minutes): indicate how many minutes you want the platform to keep the images downloaded from Magento in memory (selecting 0 will disable caching).

After verifying the correctness of the technical parameters, connect the connector to the Magento platform by clicking the Update definitions button.

Definition of custom fields for newsletter subscribers via Magento

In this section, you can configure a mapping between the fields of the platform and the custom fields created in Magento to store the information of Subscribers who registered directly on the eCommerce.

To add the mapping of a field, click the Add field definition button.
The Custom field definition form will open where you will need to indicate:

• Internal name: this is a label you can assign to the Magento field to recognize it when, for example, mapping it to a platform field. It helps to more easily identify the Magento fields that may not have a recognizable name.
• Magento field: enter the exact name of the column in the Magento table that you want to map to the platform.
• Field type: enter the data type you want to map (available types are varchar, text, boolean, int, decimal, datetime, picklist).
• Notes: in this field, you can enter free notes or comments visible only to platform users.

After completing the field mapping configuration, click the Save button, so the mapping will be added to the list of those already present on the platform.