FlatPlan handles the display and distribution of your content. All we need from you is the content, delivered via an RSS/Atom feed. The ‘full’ feed that comes as standard with your CMS will be a sufficient basis on which to build the feed. See below for a breakdown of our feed requirements. Please ensure your feed meets these standards.
We need your feed to be valid, well-structured and contain everything we need. By this, we mean:
We fetch your feed regularly so we require a minimum of 50 items per page.
FlatPlan only supports UTF-8
FlatPlan requires the following namespaces
|DCMI Metadata Terms||http://purl.org/dc/elements/1.1/||dc|
|RDF Site Summary 1.0 Modules: Content||http://purl.org/rss/1.0/modules/content/||content|
|FlatPlan format extension||https://www.wearemathematics.co.uk/flatplan-feedspec/||flatplan|
Specifies XML document version and character code
<?xml version="1.0" encoding="utf-8" ?>
Specifies RSS version and namespaces.
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:flatplan="https://www.wearemathematics.co.uk/flatplan-feedspec/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" > ... </rss>
A description of your website
|✔||Title of the publication (HTML not supported)||The Daily News|
|✔||URL of the publication||https://dailynews.com/|
|✔||Published date and time (must comply with RFC822)||Sun, 14 Oct 2019 05:00:00 GMT|
|✔||The last date and time the content of the feed was updated||Mon, 15 Oct 2019 07:23:00 GMT|
|✔||A category to which the feed belongs||News|
|✔||Articles (explained below)||See below|
Describes each article
|✔||Unique numerical identifier of the article||098765|
|✔||Title of the article (HTML not supported)||FlatPlan launches another publication on Apple News|
|✔||Canonical URL of article||https://dailynews.com/flatplan-applenews|
|✔||Date and time the article was published (must comply with RFC822)||Mon, 15 Oct 2019 07:23:00 GMT|
|✔||The URL of an image to represent the article. Will be used in the article feeds and as the lead image of the article (send largest available version)||https://dailynews.com/flatplan-applenews.jpg|
|✔||Author of the aricle||A.N. Other|
|✔||All elements of the article including text, images, media and embeds||See below|
|✔||The introduction to the article||The latest publication makes full use of Apple News format with minimal effort|
|✔||The category the article pertains to||News|
|Name of template specific to FlatPlan||Feature|
|Name of article sponsor||Apple|
It is possible to pass gallery data. Use the custom HTML tag found in the example below.
View a sample RSS document on Github
Ensure the following:
<content:encoded>and is used to describe the article is not also included in
<content:encoded>(e.g. repetition of thumbnail image)
Please refer to https://validator.w3.org/feed/
If characters which are not allowed by XML specification are included in a document, we can not parse them correctly. For more information about XML specification, please see http://www.w3.org/XML/Core/#Publications.
Date Format of <pubDate>
The value of <pubDate> must be specified in accordance with RFC822 (https://www.ietf.org/rfc/rfc0822.txt).
Please specify a timezone using one of the following notations:
For example, the following are correct notation to express “May 1, 2019 15:00:00 (PST)“:
For language settings follow these guidelines for support codes
Supported image types are JPEG (
.jpg) GIF, or PNG.
The minimum size of the image must be 300 px wide x 300 px high.
The aspect ratio (width ÷ height) must be between 0.5 and 3.0.
Find out more about FlatPlanMore information