Marfeel Docs

# Marfeel Activation

Marfeelized websites become visible to the world once they are activated. Activating happens differently depending on the Marfeel features that are active on the site. There are three principal modes of activating a Marfeel site:

  • MarfeelCDN
  • MarfeelPress Plugin
  • Garda

Prefer any of the first two because they take advantage of server-side detection, delivering mobile content faster to the readers.

The third one, Garda, relies on the Garda script placed on top of the site's HTML. This script is responsible for detecting mobile users and transforms the page as it loads.

Only one activation method should be used at a time to avoid unintended consequences. For this reason, activating MarfeelCDN does not equal activating Marfeel, and the MarfeelPress plugin offers different activation options.

Continue reading to learn more about Marfeel activation with Garda.

# Garda Script

The Garda Script is an HTML script tag to insert at the very top of the site to marfeelize.

This script tag calls a Marfeel script that analyses the reader's device and decides if the Marfeel version should show.

Marfeel is active as soon as you insert the Garda, and inactive as soon as you remove it.

# Script placement

The Garda script tag must be as high as possible on the page in the head tag, to guarantee optimal user experience. If the Garda detects a mobile device, it prevents all subsequent Desktop resources to load. However, it is impossible to block resources that started loading before the Garda, leading to unnecessary data downloaded by mobile users, and to unexpected behavior in the worst case.

The tag must be present on all pages to marfeelize.

# Garda Script tag

<script data-mrf-script="garda" data-mrf-dt="1" data-mrf-host="live.mrf.io" src="https://live.mrf.io/statics/marfeel/gardac-sync.js" data-cfasync="false"></script>

WARNING

If you are unable to insert HTML directly, do not copy the content of the script in a new file, but contact success@marfeel.com to consider other activation options.

All the attributes are necessary to guarantee a smooth activation!

← Common issues →