=== Apicius Products & Recipes ===
Contributors: stellarstudios.com
Tags: products, food, recipes, woocommerce
Description: Management of recipes related/linked with products, optionally with WooCommerce
Tested up to: 4.8.1
Stable tag: 0.12.0


== Description ==
A "recipes" and "products" post type manager.  If you are using WooCommerce for your products, this plugin works with that. If not, it makes its own products post type.

* Products have the option of having ingredients and nutritional information; even 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) as tiles and/or a dropdown
* Recipes have their own search box (optional)

* Archive is put onto any post/page you want with the use of the shortcode [apicius_recipes] or [apicius_products]
* 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)
* Archive display (optionally) is paginated, with the admin specifying the number of items per page, and whether or not to "collapse" some of the pages into an ellipsis if there's a lot of pages
* Single recipe view (optionally) includes a selection of random "related recipes" at the bottom - chosen by matching type; quantity determined in settings.
* Single recipe view's products can now be shown with the ingredients list, below the recipe, or both. The "below the recipe" option can be either limited or padded to a certain number of products; a request for more will pull random products to display to meet the number.
* Recipes and products output with a simple, well-classed structure, easily addressable by custom css.
* Single product view (optionally) includes a random selection of recipes that use that product; quantity determined in settings
* Single product and recipe views (optionally) include Previous and Next links at the top and/or bottom
* 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.
* Widget available for a dropdown of recipe types that links to the recipe archive, pre-filtered.

* Regular post type can have multiple suggested items below the content, pulling from recipes and products.  Displays like related items on single product or recipe posts.

* 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 and products, although you don't have to. <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_recipes]` shortcode
2. Recipe single view
3. Recipe edit
4. Apicius options


== Installation ==
1. Upload the `apicius-products-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_recipes]` or `[apicius_products]` onto whatever pages you want the archives on, in order to have other content around it
5. Go to the settings page (Settings > Apicius Products Recipes) and choose what elements to use, as well as customize colors and default images
6. *IMPORTANT* Go to the Extended Search plugin's settings page (Settings > Extended Search) and be sure to check the things you want searchable - recommended to check Categories, Tags, Recipe Type, and Product Category in the "Select Taxonomies" section; recipe_description, recipe_directions_group, recipe_ingredients_group, and recipe_products in the "Select Meta Key Names" section; Recipes and Products in the "Select Post Types" section.


== Frequently Asked Questions ==
**I just made my first product/recipe and tried to view it, but the page says the item can't be found!**
Go into the WP Settings, in the Permalinks section.  The "Post name" option works the best.  If that's already what you had, just click Save Changes anyway.  That generally fixes the problem.

**What order will the things show up? By "post" date?**
Recipes and products 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" and/or "products" checkboxes.

**Where's the recipes/products 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 /products/ page and use the `[apicius_recipes]` or `[apicius_products]` shortcode on them.  WordPress will most likely redirect to the correct page if someone tries to go to /recipe/ or /product/.

**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 Products, 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 ==
= 0.12.0 =
* Fixed missing prep time, servings, nutritional info, and description in the recipe edit view
* Added the option of products having ingredients and nutritional information (even on WooCommerce products)
* Removed the "Recipes" H2 in the #recipes_header in recipe archive shorttag

= 0.11.3 =
* Added content blocks in main Apicius admin for single product and recipe view, to display beneath the recommended recipes

= 0.11.2 =
* Added collapsing to pagination, if there's tooooo many pages (optional)

= 0.11.1 =
* Added prev/next arrows to pagination
* Added admin options to show pagination above, below, or both

= 0.11 =
* Added pagination (optional) to recipe archive
* Fixed bug introduced with the nice-select where coming in with a hash didn't select the pretty dropdowns

= 0.10.2 =
* Added a jquery thingie to make dropdowns look nicer

= 0.10.1 =
* Compensated for products with "<sup>®</sup>" in their title - was breaking code at images using that title as their alt tag

= 0.10 =
* Added widget for displaying a dropdown of recipe types

= 0.9.2 =
* Fixed bug that occurred if there is a product dropdown but not product category dropdown in recipe archive view

= 0.9.1 =
* Made post's related thingies tiles look like all the other related thing tiles on product and recipe single views

= 0.9 =
* Got recipe type dropdown working with hash handling

= 0.8.1 =
* Added a recipe type dropdown to the archive filter capabilities

= 0.8 =
* Gave recipes their own search box at the top of the recipes archive shortcode output
* Added WP Extended Search to required plugins
* Added DOM element IDs to recipe archive filter/search sections

= 0.7 =
* Added "suggested" content to go below single normal posts, with recipes and products available for the admin to choose from for each post.  Quantity is up to the admin.  Displays like related recipes/products on single recipe/product posts.

= 0.6 =
* Allowed related recipes on single product view to choose random (unrelated) recipes to fill out the max number specified in the admin
* Changed wording of related products/recipes at the bottom of single item view to "Suggested ____" since not all are actually used on the item you are viewing

= 0.5.1 =
* Changed single recipe view to just one column of stuff instead of two

= 0.5 =
* A recipe's products can now be shown with the ingredients list, below the recipe, or both.
* The "below the recipe" option can be either limited or padded to a certain number of products; a request for more will pull random products to display to meet the number.

= 0.4 =
* Allowed products archive to have no filtering options
* Fixed bug that happened if there were no filtering options on either product or recipe archive

= 0.2 =
* Added options for prev/next links on single recipes/products

= 0.1 =
* Beginning adaptation of original Apicius WC Recipes plugin
* Converted to work whether or not WooCommerce is present




== TODO ==
* Allow admin to choose to display single recipe stuff in one column or two
* Allow admin to drag to reorder stuff in single recipe view
* Handle products that are not in any product category
* Add ability to put a "featured recipe" with single products
* Add product archive pagination
* Prevent the "Ingredients" and "Nutritional Information" headers from showing up if a recipe doesn't have them
* Handle being able to have comments on recipes or not
