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"]