FSRI Shortcode

This is a feature of the Feast Plugin

The FSRI (Feast Simple Recipe Index) shortcode is the replacement for the "Featured Posts" widget included in the theme, and is used to build the Modern Homepage.

We've taken all the unnecessary options in the widget and replaced them with the current best practices, and made it usable on any page - not just the homepage.

Jump to:

• Defaults
• Change the category
• Change number of posts
• Change the image size
• Apply rounded-image styling
• Change the desktop columns
• Remove the title
• Include previously displayed
• Show recently modified
• Order by comments
• Displaying content/excerpt
• Preventing duplicate internal links
• Display recently modified posts
• Trending Posts
• Use it anywhere
• Custom homepage
• Posts
• 💬 Comments

Defaults

By default, it will output:

• 4 posts horizontally on desktop, 2x2 on mobile
• the featured image, using the WPRM or Create square thumbnail
• the recipe title

Here's an example of the fsri shortcode in action:

It can be modified using parameters (note: you'll need to wrap them with opening and closing square brackets.

Change the category

fsri category="mycategoryname"

• specifies the category slug to output posts from that category
• default: none (eg. all recently published)

Change number of posts

fsri posts_per_page="8"

• changes the number of posts being displayed
• default: 4

Change the image size

fsri image_size="feast-vertical-3x4-360x480"

• changes the desired thumbnail size
• default: the recipe card's square thumbnail

Apply rounded-image styling

fsri image_class="feast-image-round"

• applies a class to the image for styling
• default: none

Change the desktop columns

fsri list_class="feast-desktop-grid-third"

• changes the desktop and mobile display
• default: feast-grid-half feast-grid-desktop-fourth (2-wide mobile, 4-wide desktop)
• note: if using feast-desktop-grid-third, make sure to also use posts_per_page="6" posts so that mobile is a 2-wide-by-3-high grid

Remove the title

fsri include_title="false"

• removes the title (not recommended)
• generally, both the featured image and title are required to adequately convey information about the recipe
• note: this can be ignored if displaying pages with the title embedded in the image

Include previously displayed

fsri exclude_previous="false"

• includes previously displayed posts
• we exclude previous posts by default to increase the variety of internal linking, but on large pages this can exclude entire categories if they're small enough

Show recently modified

fsri orderby="modified"

• show posts by recently modified (updated) instead of recently published
• this is a good way to get content recrawled and a short-term boost from being on the homepage

Order by comments

fsri orderby="comment_count"

• show posts by comment count (total) instead of recently published
• this is a cheap proxy for all-time "popular" content, and isn't as effective as manually building a category using Google Search Console data

Displaying content/excerpt

At this time, we've decided not to support displaying content/excerpts. This is because it adds too much clutter to the page, making it difficult for readers on mobile (80% of pageviews) to find what they're looking for.

The featured image + title should convey all the information necessary for the reader to decide whether they want to click through to the recipe.

The content/excerpt is actually duplicate content and does not count towards unique content on those pages.

One thing we learned over time was that the content/excerpt that was displayed on the homepage and category pages led bloggers into a false sense of content on those pages.

The modern homepage puts the need for unique content on your homepage very in-your-face. You should provide a 1-2 sentence explanation about why you've chosen to feature that category for your readers - sell them on why they should click through to your recipes.

Preventing duplicate internal links

By default, the shortcode will not output any posts that have been included by other instances of the shortcode (eg. previously in the post, the sidebar, the footer). This can be disabled with

fsri exclude_previous="false"

Display recently modified posts

You may want to display a few recently modified posts on the homepage, so that search engines find them quicker and re-crawl them. To do this, use:

fsri orderby="modified"

Trending Posts

See this tutorial for building a trending posts category and displaying it.

Use it anywhere

Unlike widgets, the shortcode can be used anywhere:

• homepage
• category pages
• sidebar
• recipe pages
• footer

Custom homepage

As outlined in the Modern Homepage, you can create a fully custom homepage using the FSRI shortcode, using the regular block editor.

Posts

Looking for an easy way to embed related recipes? Use the FSRI shortcode with your current category to display other recipes from that category, directly in your post!