Home

You're currently viewing XMPL V3

Attention: XMPL V5 beta is now available!

XMPL technology is part of the XMPie OpenXM technology stack that includes the XMPL HTML, XMPL JavaScript and XMPL Rest API.

If you are already familiar with XMPL you may want to quickly consult our Cheat Sheet. Otherwise, read on.

XMPL is a Javascript library that adds personalization to your HTML page. Use the library's custom tags and attributes to add features such as variable text and images. Show or hide various areas of the page based on the offer that you wish to make for the target recipient. You can also change the font, color or any other style aspects with style variables.

Important: XMPL websites are hosted on the XMPL web server, a publicly accessible server via the internet. Therefore, any static files (HTML, PDF, images, etc.) which you upload as part of your website are also publicly accessible. It is highly recommended that you do not store confidential or sensitive files on the XMPL server.

Additional features that the library supports include:

• Update recipient data through update forms
• Add new recipients to your database via registration and referral forms
• Update the data based on recipient behavior
• Use XMPie's tracking infrastructure through tracking tags
• Post on Facebook or share via Twitter

The library uses AngularJS as an infrastructure for providing the custom tags and attributes. In addition, it defines a services layer that is implemented as an AngularJS Service. This can be used independently in your AngularJS webpage, as well as from your non-AngularJS plain javascript code, providing you various XMPie services as variable data handling and tracking.

The library communicates with the XMPie campaign via an XMPL server. The server defines a collection of REST services for the library that you can use independently, if you wish to perform custom or client side activity without involving the XMPie client library. This SDK also includes information about these REST services.

Use the following links to get started:

• Getting Started. How to set up a website for using XMPL
• Your First Personalized Page. How to create a simple personalized webpage

To learn how to use the various library features, use these links:

• Webpage Personalization. Personalize a webpage using ADORs.
• Updating Recipient Data. Update recipient data.
• Adding New Recipients through Registration. Create registration forms.
• Refer a Friend. Create pages that enable recipients to refer others to your site.
• Social Media Tags. Add social media sharing to your webpage.
• Web Analytics. Gather information about user interaction with the site.
• JavaScript Access. Access the XMPL services and controller data from your JavaScript code.
• PDF on Demand. Add automatically-generated personalized PDFs to your webpage.
• Triggered Emails. Set up automatic email sending triggered by click events, form submits or page load events.
• Form validation examples. Samples of validating the values users enter into form fields.
• User Authentication (SecURL). Protect unauthorized users from accessing private recipient information.
• Error Handling. Control the error display on the page.
• Clear Browser Cookies. Work with multiple recipients in the same browser session.

Technical overviews of the library:

• XMPL Library Infrastructure. Discussion of the contents of the library
• How Does it Work. Explanation of how an XMPL webpage works

Reference:

• Markup Reference. Reference to all attributes, elements and expressions that can be used in XMPL
• xmpResource Reference. Reference to the XMPL services layer