=== Apicius WC Recipes ===
Contributors: stellarstudios.com
Tags: products, food, recipes, woocommerce
Description: Management of recipes related/linked with WooCommerce products 
Tested up to: 4.5.3
Stable tag: 1.1


== Description ==
A "recipes" post type manager.  You can link recipes with WooCommerce products.

* Recipes have name, ingredients, directions, featured image, tags (like "entrees, appetizers"), products used, prep and cook times, nutritional information, serving size, and number of servings.  Many of these parts are optional, and don't have to be used.
* Recipes are filterable on archive display by product category, product, recipe type (tag)

* Archive is put onto any post/page you want with the use of the shortcode [apicius]
* Filtered recipe list is (optionally) linkable, by putting a hash in the URL
* Archive display (optionally) shows a count of how many recipes are being displayed (according to the filters)
* Single recipe view (optionally) includes a selection of 3 "related recipes" at the bottom - chosen by matching type
* Recipes output with a simple, well-classed structure, easily addressable by custom css.
* Settings page for whether or not to use some of the elements, which product categories to exclude, colors you can customize, and social sharing options.
* Default images for products and recipes without featured images, which can also be customized by your own upload in the settings.

* Uses Bootstrap for responsive sizing, but includes the (localized to Apicius) css necessary in case your site doesn't have it
* Requires the RW Meta Box plugin, which will automatically be prompted to install if it isn't already
* Requires the Meta Groups and Meta Box Settings Page plugins, which are included, and you will be automatically prompted to install them.
* Intuitive Custom Post Order is required for manually ordering recipes, although you don't have to. Note, though, that it doesn't work well for WC post types. <https://wordpress.org/plugins/intuitive-custom-post-order/>
* The name "Apicius" (ahPISH-iss) had long been associated with excessively refined love of food, from the habits of an early bearer of the name, Marcus Gavius Apicius, a Roman gourmet and lover of refined luxury who lived sometime in the 1st century AD, during the reign of Tiberius. <https://en.wikipedia.org/wiki/Apicius>
* Social media icons appreciatively used from <http://tomswebspace.com/72-minimalist-social-media-icons-square/>


== Screenshots ==
1. Recipe archive view output by `[apicius]` shortcode
2. Recipe single view
3. Recipe edit
4. Apicius options


== Installation ==
1. Upload the `apicius-wc-recipes` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Install and activate any additional required plugins (you will be prompted)
4. Put the shortcode `[apicius]` onto whatever page you want the archive on, in order to have other content around it
5. Go to the settings page (Settings > Apicius WC Recipes) and choose what elements to use, as well as customize colors and default images


== Frequently Asked Questions ==
**What order will the things show up? By "post" date?**
Recipes will be displayed with most recent first, unless you manually reorder them by using the ICPO plugin.

**Okay, so how do I manually reorder them?**
You need to go into the ICPO Settings page, which is "Intuitive CPO" under the main WP Settings menu, and tick the "recipes" checkbox.  Note that you should not tick the Products checkbox; WooCommerce handles drag-n-drop ordering by itself, and this will mess it up.

**Where's the recipes archive?**
There currently isn't a real way to reliably override the template for just the content portion of an archive view.  I turned off the post type's archive, so I suggest you make a /recipes/ page and use the `[apicius]` shortcode on it.  WordPress will most likely redirect to that page if someone tries to go to /recipe/ .

**Where is Recipes or Apicius Info menu items in the admin?**
WordPress 4.4+ allows menu items to have the same position number, so if either Recipes or Apicius Info are missing from the admin side menu, please update your WordPress.  Older versions would just overwrite menu items if their position number was the same.


== Changelog ==
= 1.1 =
* Fixed issue with options not saving or being respected on the front end
* Added optional nutritional information to recipes

= 1.0 =
* Full launch!
* Updated screenshots
* Put in updater so it can update like any other plugin
* WordPress 4.4+ allows menu items to have the same position number, so if either Recipes or Apicius Info are missing from the admin side menu, please update your WordPress.
* Put in an admin page to display this document

= 0.8 =
* Gave up on having a "real" archive
* Fixed missing default image for recipe in Related Recipes
* Prevented viewed recipe from showing up in Related Recipes
* Styled Products Used blocks so they are distinct from each other
* Added link to Settings in the plugin's listing
* Made Products Used blocks the same height, with name and Buy Now at the bottom of each
* Polished code

= 0.7 =
* Made "Products Used" dropdown only show products that are actually used in one or more recipes

= 0.6 =
* Added settings page. Categories to exclude, and element styles (colors) working.
* Settings page social section fully functioning.
* Default and adminable placeholder images for products and recipes without a featured picture.
* Settings section for displaying results count, and product category dropdown, fully functioning.
* Filter results can now (optionally) be linkable, by using a hash url

= 0.5 =
* Single recipe view includes a selection of 3 "related recipes" at the bottom - chosen by matching type
* Added a "View All" button under the Product dropdown
* Styled dropdowns and View All button

= 0.4 =
* Layout for single recipe view done, layout for archive shortcode done.

= 0.3 =
* Added pre-packaged Meta Box Group plugin, added grouping for ingredients and directions

= 0.2 =
* Shortcode-produced archive laid out styled
* CSS reference for custom style targeting

= 0.1 =
* Basic functionality: 
* Recipes post type
* Shortcode to output archive


== TODO ==

* Add ability to put a "featured recipe" with single products
* Add ability to have a random assortment of recipes (like Related Recipes) on single product view
* Add ability to show nutritional information on single product view (on categories not excluded in the Apicius settings)
* Handle being able to have comments on recipes or not
