RecipePress reloaded

Use taxonomies to organize your recipes

This documentation is a work in progress. Hopefully the finished bits are helpful already.

Predefined taxonomies

You’are probably used to organize your posts in categories and give them tags. RecipePress reloaded offers a lot more taxonomies than just categories to organize your recipes. By default you can use the following taxonomies:

  • Course (like mains, starters, dessert, …)
  • Cuisine (like French, German, American, Indian, …)
  • Season (like spring, summer, autumn, winter, Christmas, …)
  • Difficulty (like easy, advanced, difficult) disabled by default

You’ll further have to decide wether you want to use the wordpress categories and tags for your recipes and your posts (enabled by default) or use special categories and tags for your recipes (disabled by default). Since version 0.7.7 of RecipePress reloaded you can also use all of them alongside. You could for example use the recipe tags for stuff like ‘for guests’, ‘basic’, .. and use wordpress tags for stuff you can tag posts and recipes with.
You can enable and disable the predefined taxonomies in the Recipe Metadata section of the RecipePress reloaded settings.

Disable predefined taxonomies option

It’s also possible to rename or delete predefined taxonomies and of course you can also create your own taxonomies.

Use taxonomy listings

For sure one of the most interesting things around taxonomies is to get a list of all recipes related to a taxonomy term, eg all recipes related to ‘summer’. Fortunately this is a function already built in. Just click on a taxonomy term and you’ll get the archive page for this term.
However if you want to get a page listing all the terms of a taxonomy, manual interaction is required. Create a page, name it accordingly and place the [rpr-tax-list tax="{TAXONOMY}"] shortcode on that page. Just replace {TAXONOMY} with the id of the taxonomy you want to display.

Taxonomy ID Shortcode
Course rpr_course [rpr-tax-list tax="rpr_course"] Demo
Cuisine rpr_cuisine [rpr-tax-list tax="rpr_cuisine"] Demo
Season rpr_season [rpr-tax-list tax="rpr_season"] Demo
Difficulty rpr_difficulty [rpr-tax-list tax="rpr_difficulty"] Demo
Ingredient rpr_ingredient [rpr-tax-list tax="rpr_ingredient"] Demo

There even is a button in the editor that opens a dialog to do this. So you don’t have to worry about ids and stuff.
Embed taxonomy button in editor

Please note that ingredients are also stored as a taxonomy so you can easily find recipes using a certain ingredient. However ingredients are a bit special: First, you cannot deactivate or even delete this taxonomy for some reason ;). Second, you will get terms like salt and pepper, but probably don’t want these terms to appear in your ingredients listing. You can easily exclude terms from the listing using the ‘Exclude ingredients from listings’ setting. Just type the names of the terms you want to exclude and save.
ingredients_exclude
This setting also applies to the tag cloud widget.
Also different from the other taxonomies you can have ingredients linked to custom URLs. Using the ‘Ingredient Links’ setting you can decide:

  • not to link at all,
  • always link to archive page,
  • link to custom URL if provided and to archive else (default setting, recommended) or
  • link to custom URL if provided and nowhere else.

ingredients_link

Manage taxonomies

RecipePress reloaded offers a powerful tool to manage your recipes’ taxonomies. In the meta data section of the settings page you can find the button Manage recipe taxonomies.Manage recipe taxonomies buttonClicking it will lead you to the ‘Manage taxonomies’ pages.

Manage taxonomies page
This page gives you an overview of all taxonomies associated with recipes and their settings. You can add your own taxonomies using the Add taxonomy button. You can delete existing taxonomies using the Delete button in the respective row. Deleting a taxonomy will also delete all terms saved in this taxonomy. Please note that cannot delete the taxonomies created by wordpress like ‘category’ and ‘post-tag’ as well as ‘rpr_ingredients’. Deleting these would severely damage your wordpress installation.

You can also change some settings of the taxonomies by clicking the Edit button.

Edit taxonomy dialog You can change the name (singular and plural) of the taxonomy. The name will appear on top of the meta boxes on the recipe edit page as well as a headline for the taxonomy in the frontend.

You can also change the ‘slug’ of the taxonomy. This is the part of the URL leading to the taxonomy archive page. If you have a taxonomy called ‘course’, you will find all courses on the archive page http://yourwebsite.tld/course and all recipes tagged as ‘main course’ eg under http://yourwebsite.tld/course/mains. Changing the slug will change the part of the URL marked bold.
Since release 0.7.8 you can also change the type of a taxonomy from hierarchical category like to non-hierarchical tag like.

Feature missing?

If you think an important feature is missing here, consider posting a feature request in the support forum.