FlatPlan handles the display and distribution of your content. All we need from you is the content, delivered via an RSS/Atom feed. For most publishers, the ‘full’ feed that comes as standard with their CMS will be sufficient, but below we have listed 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 only require the most recent stories – 20 or 30 items will be enough
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|
|Human-readable copyright of the feed's content||Copyright 2019 The Daily 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|
Ensure the content is suitable for presentation as HTML with appropriate tags and be encoded as character data.
View a sample RSS document on Github.
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