Documentation
Reference

Builders

From plugin v1.37.13

Builders

Builders generate shortcode blocks without making users remember shortcode syntax. They are available from MisePress → Builders.

Builder groups

Builders are grouped into tabs:

  • Content: recipe slider and category grid.
  • Discovery: smart collections, trending recipes, and “because you viewed”.
  • Engagement: favourites, smart search, and featured recipe blocks.
  • Reference: dynamic recipe fields.
  • Utilities: “Use what I have”, combined shopping list, and meal planner.

Shortcode output

Each builder outputs a shortcode field with a copy button. You can paste the shortcode into:

  • WordPress pages.
  • Posts.
  • Widgets.
  • Bricks templates.
  • Gutenberg shortcode blocks.
  • Theme templates with do_shortcode().

Live preview

Each builder includes a Show preview button below the generated shortcode. The preview is hidden until opened.

When opened, MisePress sends the generated shortcode to WordPress AJAX and renders the real shortcode output. If matching site content exists, the preview uses real recipes, terms, ratings and images. If no matching content exists, the preview falls back to demo content so the user can still understand the block.

Recipe slider builder

Use the slider builder for carousel-style recipe sections.

Common controls:

  • Template.
  • Count.
  • Sort order.
  • Cuisine or course filter.
  • Specific recipe IDs.
  • Autoplay.
  • Show or hide meta.
  • Show or hide excerpt.

Example:

[misepress_recipe_slider template="hero" count="6" sort="latest"]

Category grid builder

Use this to display cuisine, course, diet or other taxonomy terms.

Common controls:

  • Taxonomy.
  • Template.
  • Columns.
  • Limit.
  • Ordering.
  • Show image.
  • Show count.
  • Show description.
  • Hide empty terms.

Example:

[misepress_category_grid taxonomy="mp_cuisine" template="cards" columns="4"]

Smart collection builder

Smart collections output curated recipe groups such as quick dinners, under-15-minute recipes, high-protein recipes or balanced collections.

Example:

[misepress_collection preset="under-15" title="Under 15 minutes" limit="6"]

Trending and because-you-viewed builders

These create discovery blocks:

[misepress_trending title="Trending now" limit="8"]
[misepress_because_you_viewed title="Because you viewed" limit="6"]

Favourites builder

Displays saved/favourited recipes.

[misepress_favorites title="My favourites" columns="4" limit="60"]

Smart search builder

Builds a standalone recipe search box.

Options include:

  • Search mode.
  • Custom placeholder.
  • Smart rotating placeholder is an advanced discovery option.

When the smart rotating placeholder is enabled, the custom placeholder field is hidden because the placeholder is generated dynamically from recipe/ingredient examples.

[misepress_smart_search mode="balanced" smart_placeholder="1"]

Featured recipe builder

Allows choosing a recipe by searching by name instead of manually typing the ID.

[misepress_featured_recipe id="123" layout="card" show_rating="yes"]

Dynamic recipe field builder

Outputs a single value from one selected recipe. The recipe picker searches by title.

Fields include calories, rating, prep time, servings, title, ingredients, allergens and other supported values.

Display styles:

  • Plain.
  • Badge.
  • Label + value.
[misepress_recipe_field id="123" field="calories" style="badge"]

Use what I have builder

Creates an ingredient-input experience where visitors enter the ingredients they have and MisePress suggests matching recipes.

Controls include:

  • Heading.
  • Placeholder.
  • Button label.
  • Show or hide heading.
  • Result limit.
[misepress_use_what_i_have title="Cook with what you have" placeholder="chicken, rice, lemon" button="Find recipes" limit="6"]

Combined shopping list builder

Outputs a shopping list built from saved/listed recipes.

[misepress_combined_shopping_list group="1" checkboxes="1"]

Meal planner builder

Outputs a simple weekly meal planner.

[misepress_meal_planner days="7" meals="Breakfast,Lunch,Dinner"]
Product context

Need the high-level overview? Start with MisePress Recipes, the WordPress recipe plugin.