Whitelist and Blacklist

To deliver a clean, organic, and fluid UX that captivates readers and drives engagement to maximize ad revenue, Marfeel filters the extraneous elements from a publisher's article on their desktop site, and optimizes it for their Marfeel Progressive WebApp (PWA). 

Boilerpipe is the clever algorithm that Marfeel engineered to parse a customer's articles. The whitelist and blacklist are what direct Boilerpipe to omit or extract the elements to be replicated in a publisher's Marfeelized mobile site to deliver an enhanced UX that boosts engagement. 

The elements in both are identified by Marfeel when developing a customer's Marfeel PWA to optimize UX, however they can always be configured and modified according to customer request.

Both the whitelist and blacklist are defined in a tenant's definition.json inside "configuration".

"whitelist":"elements_to_include"
"blacklist":"elements_to_remove"

The elements themselves can be classes, ids, or HTML tags. In the case of HTML tags, they have to all be in capital letters. 

They are listed without any class or id mark (. or #) and separated by a comma without a space. 

[attribute=anyData]

 

Whitelist

Whitelist identifies the elements or characteristics for Boilerpipe to extract and mirror in the Marfeel solution.

Examples might include author name, publishing date, etc.

"whitelist":"em fc-g,[href=/author/],slideshow-subtitle,article-full-picture,player,cover-img,[itemprop=datePublished],[href*=author],slideshow-thumbs,img-credits,H3",

Blacklist

Blacklist identifies the elements or characteristics to not replicate from a publisher's desktop site to their Marfeel PWA.

Defined items might include a publisher's sharing bar which would be excluded because the Marfeel solution provides a native auto-hiding social sharing bar that promotes readability and optimizes the space available while encouraging sharing on the user's social networks. 

"blacklist":"desktop-footer,==off-phones,article-bottom-blocks-comment-layout-cell-sidebar,OUTBRAIN,term-name-description,[itemprop=logo],mobile-incontent,element-hidden,horizontal-share-menu,H3", 

Image Gallery Blacklist

The following can be inserted in configuration of definition.json to prevent an image from being processed as an image, and treated as part of the article's textual content. This is especially useful for images under tags such as buttons:

"configuration":{
"galleryBlackList":".author img,[src*='gravatar']"
}

Collapsed Gallery Blacklist

The following can be inserted in configuration of definition.json to prevent an image from being part of a collapsed gallery. This is especially useful for small images as the author avatar:

"configuration":{
"collapsableGalleriesBlacklist": "#artist-heads img",
}

Next page whitelist and blacklist

The next page whitelist and blacklist define the elements to include or omit from subsequent pages of an article:

"nextPageWhitelist":"next_pages_elements_to_include"
"nextPageBlacklist":"next_pages_elements_to_remove",