A simple application for storing and retrieving recipes
In addition, fine-grained security is implemented so that the recipes can be searched and viewed by anyone, but all functions that make changes (adding/editing/deleting) require additional privileges to be granted by the administrator. Privileges for adding things can be granted separate from privileges for deleting things. The administrator can also decide whether or not units or categories are modifiable, on a per-user basis.
Recipes are categorized, and new categories are easy to create. Ingredients are added to the database on-the-fly, as they are used in recipes. Unit types (such as "cup" or "teaspoon") are stored in the database as well, and can be easily added to or modified. Unit "plurals" are also handled correctly when viewing recipes (using "cups" instead of "cup" in the right places).
A robust search feature is included that allows users to search the recipes based on a wide range of criteria, including words found (or not found) in the instructions, the recipe name, category, and ingredients list.
Using the phpMyRecipes software is supposed to be fairly intuitive. When you first access the site, you are not logged in. You can browse and search recipes, as well as view the lists of categories, ingredients, and units. But you can't change anything.
Once you login, your access level is determined by the privileges you have been granted. By default, accounts have no privileges, and act exactly as if you hadn't logged in at all. The only difference is that you have a "Profile" option, which allows you to edit your profile information and change your password.
During the installation process, a single account was created with user management privileges. This account can see and use the "Users" button to edit any account. By editing an account, you can add privileges. All of the privilege selections are easy to understand. At this point, it might be a good idea to create an account that has all privileges (except "Manage Users", which should be isolated to a single account that doesn't do anything else).
When logged in to an account that has privileges, you can now see the "Add Recipe" button, as well as see Edit and Delete links for things. If you go to the "Add Recipe" page, you will get a form to enter in a recipe. There are a few things you should know about here:
All recipes must have a name, and the name must be discrete. This means that you can't have two recipes named the same thing.
Recipes are categorized. If you don't see a category you like in the selection box, go to the "Categories" page and create what you want.
Serving sizes are not very important in this release, but they will be later. Try and enter them correctly.
Ingredients are entered by entering in a quantity (like "1", or "1/2"), selecting a unit (like "cup"), and either selecting an ingredient from the selection list or entering it into the text box. If you enter an ingredient in the text box, it will appear in the selection box in the future.
Try to use the ingredients from the selection box where you can. This will make it easier if we add features later like being able to generate a shopping list.
All instructions for the recipe are entered into a free-form text entry area. If you wanted to put a line of keywords in here, to help with searching, you could do that too.
Just about everything else in phpMyRecipes should be intuitive. If it's not, and you're having a problem, send me a note at the contact info below. I'll help as much as I can, and make the documentation better for the next time around.