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.

Click Add New to open the builder.

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

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