Feedspress

Feedspress Shortcode Language

By November 2, 2019May 14th, 2020No Comments

Getting started with Feedspress shortcode parameters

Feedspress uses self-closing shortcodes, that start with “[feedspress”, and ends with regular square brackets “]”. Below is the simplest shortcode example for a feed, that loads from https://www.unitedvoice.com:

[feedspress url="https://www.unitedvoice.com/category/news/feed/"]

The only parameter being used (see all accepted the parameters here) is the feed source URL parameter: url=”https://www.unitedvoice.com/category/news/feed/”.

To give it a better look, use one of the default templates by adding the template parameter, for example template=”7″ (see all the templates here);

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7"]

To limit the number of items that will show up, use max_items=”5″ parameter, this way Feedspress will show only 5 items:

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5"]

If you want to skip several items use skip_items=””:

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5" skip_items="3"]

When you want your feed to show as a local link (by default it will link to your feed source URL), you need to follow the following set-up:

1. Change the permalink to a local link: change_to_local_link=”true”;
2. Add the article detail page manually to your website, for example “united-voice” (with the shortcode on it) this way the feed will show up as a category on your website with the following shortcode (click here to see);
3. Add the article detail page URL parameter to your shortcode detail_page=”united-voice”
3. Change the {permalink} into a {local_link} in your template by adding change_to_local_link=”true” parameter;
4. Add the article detail page template parameter (this is how the feed item article will look like on your page): article_detail_template=”3″;

After adding the 3 parameters from above, the shortcode will look like this:

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5" skip_items="3" article_detail_template="3" change_to_local_link="true" detail_page="united-voice"]

To truncate the description, use truncate_description=”1″ parameter (“1” for yes, and “0” for no). Also the “Read More” text at the end of each truncated item, can be changed using truncate_description_suffix=”…Your wording” parameter. The description can be transformed into a link using truncate_description_to_link=”1″.

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5" skip_items="3" article_detail_template="3" change_to_local_link="true" detail_page="united-voice" truncate_description="1" truncate_description_suffix="...Read More" truncate_description_to_link="1"]

You can also hide the feed title and the feed description, and show only the feed items using feed_fields=”content” parameters:

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5" skip_items="3" article_detail_template="3" change_to_local_link="true" detail_page="united-voice" truncate_description="1" truncate_description_suffix="...Read More" truncate_description_to_link="1" feed_fields="content"]

To add a query string at the end of each feed item URL, use querystring=””

[feedspress url="https://www.unitedvoice.com/category/news/feed/" template="7" max_items="5" skip_items="3" article_detail_template="3" change_to_local_link="true" detail_page="united-voice" truncate_description="1" truncate_description_suffix="...Read More" truncate_description_to_link="1" feed_fields="content" querystring="utm_placement=dp-ap"]

Feed item category / detail page

For the article / category page that was mentioned above (that has to be added manually) please use the below feed shortcode, in which you will see many familiar parameters covered here.

[feedspress url="https://www.unitedvoice.com/category/news/feed/" title_override="" max_items="50" skip_items="" item_fields="title,content" feed_fields="content" allowed_tags="" link_item_title="0" template="2" article_detail_template="3" change_to_local_link="true"]