1 of 1

Newsletter Widget API

In this document you will learn how to consume the MG2 Newsletter Widget API.

MG2 Newsletter Widget API is a Javascript library which allows you to consume, easily and quickly, every feature in the MG2 Newsletter Widget.

Installation

In order to consume the API, the page needs to include a reference to MG2Widget newsletterwidget.min.jsand a container element as the following example shows:

<head>
    <script id="scriptMg2Widget" src="{Link will be provided by MG2 team}">
    </script>
    … (the others JS references) …
</head>
<body>
     … (the others HTML elements) …
    <div id="mg2Widget-newsletter-container"></div>
</body>

Parameters

Parameter

Description

email

Subscriber’s email. If this param is not specified, it will be looked for in the cookie. If it doesn’t exist, it will be asked to user.

categoryIdsList

List of Category IDs. It needs to be specified as an array list. If this param is not specified, widget will show all the categories. (Omitted in unsubscribe flow)

newsletterIdsList

List of Newsletter IDs. It needs to be specified as an array list.

Open widget flow: If this param is not specified, widget will show all the newsletters.
Unsubscribe newsletters flow: If this param is not specified, widget will unsubscribe from all the newsletters.

viewMode

This param specifies the view mode in which newsletters are shown. There are two options: Tabs mode (1) or List mode (2). Default mode is Tabs. (Omitted in unsubscribe flow)

defaultCategoryId

This param specifies the category that will be opened by default.

siteCode

If this param is specified, only preferences for that NewspaperId will be displayed.

isModal

If this param is specified and has value 'true' then widget will be displayed in Modal mode

subscriberOnly

If this param is specified and has value 'true' then widget will display only Subscriber available newsletters. Otherwise only non-subscriber newsletters will be displayed.

showAll

If this param is specified and has value 'true' and 'subscriberOnly' has value 'true' then widget will display all newsletters. Otherwise result depends on 'subscriberOnly' flag.

Code Examples

mg2WidgetAPI.openNewsletter();

Filtering Preferences

var params =  {
    email: 'subscriber@email.com', // subscriber email
    newsletterIdsList: [ 5,6 ] // list of Ids of the EmailPreference
};
mg2WidgetAPI.openNewsletter(params);

Filtering Categories

var params =  {
    email: 'subscriber@email.com', // subscriber email
    categoryIdsList: [ 2, 3 ] // list of Ids of the EmailPreferenceCategory
};
mg2WidgetAPI.openNewsletter(params);

Unsubscribe All

mg2WidgetAPI.unsubscribeNewsletter();

Unsubscribe Preference

var params =   {
    email: 'subscriber@email.com', // subscriber email  
    newsletterIdsList: [ 7, 8 ] // list of Ids of the EmailPreference
};
mg2WidgetAPI.unsubscribeNewsletter(params);

mg2WidgetAPI.closeNewsletter();

Open default category.

var params =  {
    email: 'subscriber@email.com', // subscriber email
    defaultCategoryId: 3
};
mg2WidgetAPI.openNewsletter(params);

View Mode

Force a View Mode for Preferences.

var params =  {
    email: 'subscriber@email.com', // subscriber email
    viewMode: 1 // 1: tabs view mode, 2: list view mode
};
mg2WidgetAPI.openNewsletter(params);

Display widget as modal.

var params =  {
    isModal: true
};
mg2WidgetAPI.openNewsletter(params);

Subscriber/Non-Subscriber Newsletters

Displays newsletters filtered by SubscriberOnly criteria.

var params =  {
    subscriberOnly: false
};
mg2WidgetAPI.openNewsletter(params);

Show All Newsletters

Displays all newsletters.

var params =  {
    showAll: true,
    subscriberOnly: true
};
mg2WidgetAPI.openNewsletter(params);

Email Campaign Links

LINKS: Please apply URLEncode to each QueryString parameter.

Change Profile: http://{YOUR_WIDGET_DOMAIN}/changeprofile?email=subscriber%40email.com
Change Preferences: http://{YOUR_WIDGET_DOMAIN}/updatepreference?email=subscriber%40email.com
Unsubscribe: http://{YOUR_WIDGET_DOMAIN}/unsubscribe?email=subscriber%40email.com&preferenceid=2

Newsletter Widget API

In this document you will learn how to consume the MG2 Newsletter Widget API.

MG2 Newsletter Widget API is a Javascript library which allows you to consume, easily and quickly, every feature in the MG2 Newsletter Widget.

Installation

In order to consume the API, the page needs to include a reference to MG2Widget newsletterwidget.min.jsand a container element as the following example shows:

<head>
    <script id="scriptMg2Widget" src="{Link will be provided by MG2 team}">
    </script>
    … (the others JS references) …
</head>
<body>
     … (the others HTML elements) …
    <div id="mg2Widget-newsletter-container"></div>
</body>

Parameters

Parameter

Description

email

Subscriber’s email. If this param is not specified, it will be looked for in the cookie. If it doesn’t exist, it will be asked to user.

categoryIdsList

List of Category IDs. It needs to be specified as an array list. If this param is not specified, widget will show all the categories. (Omitted in unsubscribe flow)

newsletterIdsList

List of Newsletter IDs. It needs to be specified as an array list.

Open widget flow: If this param is not specified, widget will show all the newsletters.
Unsubscribe newsletters flow: If this param is not specified, widget will unsubscribe from all the newsletters.

viewMode

This param specifies the view mode in which newsletters are shown. There are two options: Tabs mode (1) or List mode (2). Default mode is Tabs. (Omitted in unsubscribe flow)

defaultCategoryId

This param specifies the category that will be opened by default.

siteCode

If this param is specified, only preferences for that NewspaperId will be displayed.

isModal

If this param is specified and has value 'true' then widget will be displayed in Modal mode

subscriberOnly

If this param is specified and has value 'true' then widget will display only Subscriber available newsletters. Otherwise only non-subscriber newsletters will be displayed.

showAll

If this param is specified and has value 'true' and 'subscriberOnly' has value 'true' then widget will display all newsletters. Otherwise result depends on 'subscriberOnly' flag.

Code Examples

mg2WidgetAPI.openNewsletter();

Filtering Preferences

var params =  {
    email: 'subscriber@email.com', // subscriber email
    newsletterIdsList: [ 5,6 ] // list of Ids of the EmailPreference
};
mg2WidgetAPI.openNewsletter(params);

Filtering Categories

var params =  {
    email: 'subscriber@email.com', // subscriber email
    categoryIdsList: [ 2, 3 ] // list of Ids of the EmailPreferenceCategory
};
mg2WidgetAPI.openNewsletter(params);

Unsubscribe All

mg2WidgetAPI.unsubscribeNewsletter();

Unsubscribe Preference

var params =   {
    email: 'subscriber@email.com', // subscriber email  
    newsletterIdsList: [ 7, 8 ] // list of Ids of the EmailPreference
};
mg2WidgetAPI.unsubscribeNewsletter(params);

mg2WidgetAPI.closeNewsletter();

Open default category.

var params =  {
    email: 'subscriber@email.com', // subscriber email
    defaultCategoryId: 3
};
mg2WidgetAPI.openNewsletter(params);

View Mode

Force a View Mode for Preferences.

var params =  {
    email: 'subscriber@email.com', // subscriber email
    viewMode: 1 // 1: tabs view mode, 2: list view mode
};
mg2WidgetAPI.openNewsletter(params);

Display widget as modal.

var params =  {
    isModal: true
};
mg2WidgetAPI.openNewsletter(params);

Subscriber/Non-Subscriber Newsletters

Displays newsletters filtered by SubscriberOnly criteria.

var params =  {
    subscriberOnly: false
};
mg2WidgetAPI.openNewsletter(params);

Show All Newsletters

Displays all newsletters.

var params =  {
    showAll: true,
    subscriberOnly: true
};
mg2WidgetAPI.openNewsletter(params);

Email Campaign Links

LINKS: Please apply URLEncode to each QueryString parameter.

Change Profile: http://{YOUR_WIDGET_DOMAIN}/changeprofile?email=subscriber%40email.com
Change Preferences: http://{YOUR_WIDGET_DOMAIN}/updatepreference?email=subscriber%40email.com
Unsubscribe: http://{YOUR_WIDGET_DOMAIN}/unsubscribe?email=subscriber%40email.com&preferenceid=2

Newsletter Widget API

Installation

Parameters

Code Examples

Filtering Preferences

Filtering Categories

Unsubscribe All

Unsubscribe Preference

Close Widget

View Mode

Widget Display Mode

Subscriber/Non-Subscriber Newsletters

Show All Newsletters

Email Campaign Links

Newsletter Widget API

Installation

Parameters

Code Examples

Filtering Preferences

Filtering Categories

Unsubscribe All

Unsubscribe Preference

Close Widget

View Mode

Widget Display Mode

Subscriber/Non-Subscriber Newsletters

Show All Newsletters

Email Campaign Links

Newsletter Widget API

Installation

Parameters

Code Examples

Subscribe Flow

Filtering Preferences

Filtering Categories

Unsubscribe All

Unsubscribe Preference

Close Widget

Subscribe Flow Default Category

View Mode

Widget Display Mode

Subscriber/Non-Subscriber Newsletters

Show All Newsletters

Email Campaign Links

Newsletter Widget API

Installation

Parameters

Code Examples

Subscribe Flow

Filtering Preferences

Filtering Categories

Unsubscribe All

Unsubscribe Preference

Close Widget

Subscribe Flow Default Category

View Mode

Widget Display Mode

Subscriber/Non-Subscriber Newsletters

Show All Newsletters

Email Campaign Links