Contents
On this page

Shortcodes - Plugixa Recipe

Plugixa Recipe registers shortcodes for recipe listings, for a single recipe inside a post, for your visitors’ own pages, for the submission form, and eight widget shortcodes for smaller recipe-related components.

Shortcode What it shows Details
[plugixa_recipe] A recipe listing: grid, slider, masonry or list Below
[plugixa_single_recipe id="12"] One whole recipe inside a post or page Recipe in a post
[plugixa_recipe_roundup ids="3,8,12"] A numbered round-up of recipes Recipe in a post
[plugixa_jump_to_recipe] “Jump to recipe” and “Print recipe” buttons, placed by hand Recipe in a post
[plugixa_surprise_recipe] A link to a recipe picked at random Below
[plugixa_recipe_account] Saved recipes, shopping list and submissions as tabs Visitor account
[plugixa_saved_recipes] The visitor’s saved recipes Visitor account
[plugixa_shopping_list] PRO The visitor’s shopping list Visitor account
[plugixa_my_submissions] PRO The recipes the visitor submitted Visitor account
[plugixa_recipe_form] PRO The frontend submission form Below
Widget shortcodes Categories, cuisines, latest, popular, related, search, recipe of the day, count Widget Shortcodes

[plugixa_recipe]: the main shortcode

Renders recipes in grid / slider / masonry / list layouts.

Basic usage

[plugixa_recipe]

Uses the default view and shows the most recent 12 recipes.

With attributes

[plugixa_recipe categories="breakfast" limit="9" view="featured-grid"]
[plugixa_recipe cuisines="italian" min_rating="4" pagination="true" per_page="12"]
[plugixa_recipe featured="true" columns="4"]
[plugixa_recipe difficulty="easy" orderby="rating_average" order="DESC"]

All attributes

Attribute Values Notes
id shortcode ID Loads a saved shortcode config from the DB. This is a saved listing’s ID, not a recipe’s
view view ID or slug
categories comma-separated slugs or IDs
cuisines comma-separated slugs or IDs
courses comma-separated slugs or IDs
limit integer Max recipes to fetch (default 12)
orderby created_at, title, rating_average, view_count, display_order
order ASC / DESC
featured true Only featured recipes
min_rating 1 to 5 Cached rating_average ≥
difficulty easy / medium / hard / expert
columns integer Override desktop columns
dark_mode true / false Apply the view’s dark-mode palette
pagination true / false Enable pagination
pagination_style numbers, loadmore, infinite
per_page integer Items per page

For a random pick, use [plugixa_surprise_recipe] below: a listing has no random order.

The visual builder (saved shortcodes)

Rather than memorising attributes, use the Shortcodes menu to build reusable configurations.

The Shortcodes admin list showing eight saved shortcodes, among them All Recipes Grid, Desserts & Beverages Slider, Easy Vegan Masonry and Top Rated Grid, each with a description and a pair of copy buttons labelled By ID and By Parameters

Click Add New to open the builder.

The shortcode builder with content source, display and behavior settings for a saved recipe listing

The builder has sections for:

  • Content source - categories, cuisines, courses, difficulty, diet flags, featured flag, search text.
  • Display - view selection, columns override, dark-mode toggle.
  • Behavior - orderby / order, pagination (on/off, style, per-page), limit.
  • Filters - which filter controls (category bar, search box, sort dropdown) to show on the frontend.

Save. The builder gives you a shortcode like:

[plugixa_recipe id="7"]

Paste that into any page - the saved config drives everything. A saved shortcode limited to a category, cuisine or course lists only those recipes, in the sort order chosen in the builder.

[plugixa_surprise_recipe]

[plugixa_surprise_recipe label="Surprise me"]

Prints a link that opens a recipe picked at random. The link is the same for every visitor, so the page can be cached; the recipe is picked when the link is followed.

The [plugixa_recipe_form] shortcode

Renders a frontend submission form so visitors can suggest recipes. It is part of Plugixa Recipe Pro since version 1.4.0. On a site that runs the free plugin, the page shows nothing to visitors, and whoever may switch apps on sees a note with a link to Apps. The same goes for [plugixa_shopping_list] and [plugixa_my_submissions].

[plugixa_recipe_form]
[plugixa_recipe_form style="modal"]

style is the only attribute: inline (default) or modal. Login, the status of new recipes and notifications are set under Settings > Submission form. Submitted recipes land in the recipe list as pending for moderation. The form has the same list tools as the admin editor: reorder, group and paste ingredients and steps. See Frontend Submission.

Search with filters

[plugixa_recipe_search] is a search box. With style="expanded", it also filters by category, cuisine, course, total time, difficulty and diet:

[plugixa_recipe_search style="expanded"]

The expanded recipe search form with a search box, dropdowns for categories, cuisines, courses, time, difficulty and diet, and a Search button

Placed beside a [plugixa_recipe] listing, the search form filters that listing, and “load more” and pagination keep the search. See Widget Shortcodes.

Widget shortcodes

The free plugin bundles eight widget shortcodes for lightweight embeds - perfect for sidebars, footers, and landing pages.

Shortcode Template Purpose
[plugixa_categories] widgets/categories.php Gallery of category cards
[plugixa_cuisines] widgets/categories.php Gallery of cuisine cards (reuses the categories template with type switch)
[plugixa_latest_recipes] widgets/latest-recipes.php Most-recent recipes
[plugixa_popular_recipes] widgets/popular-recipes.php By view_count or rating_average
[plugixa_related_recipes] widgets/related-recipes.php Related to the current recipe
[plugixa_recipe_search] widgets/recipe-search.php Search box, with filters in style="expanded"
[plugixa_recipe_of_day] widgets/recipe-of-day.php Daily rotating recipe
[plugixa_recipe_count] widgets/recipe-count.php Integer count

See Widget Shortcodes for the full attribute reference for each.

AJAX & pagination

When pagination="true" and pagination_style="loadmore" or infinite, the “Load more” button / scroll trigger hits the AJAX handler:

POST /wp-admin/admin-ajax.php?action=pxr_load_recipes

The handler renders the next page server-side and returns HTML - keeping behavior identical between initial render and subsequent pages. It keeps working on a page served from a page cache, however old the cached copy is, and the button says so when a request fails.

Performance notes

  • The plugin enqueues the frontend CSS / JS only when [plugixa_recipe] (or a widget) is rendered. No bloat on pages that don’t use it.
  • Fonts picked in a view are served from your site and enqueued only on pages where that view is used.
  • Schema JSON-LD is printed in the footer, after recipe data is known.

Quick Links

Share