Snilles Automatic Shopping List System help - Version: 1.5 (13-05-06) Author: Snille
Description:

This is a small utility that creates a "online" shopping list for your family. You add and edit items on a normal webpage, anybody can add, change and delete items to / from your list.
Then when you are in the actual shop, you use your phone (or whatever handheld device you own) to browse the shopping list "list" site via WAP. And all items you have "selected" is presented in the list. No more forgotten notes, endless SMSing lists or even phone calls from the store. Just keep the list updated and you always have it with you! :)

What you need:

1. Some space on a web server somewhere with PHP 4.x support. (0,3mb)
2. A cell phone with WAP support (it's not really needed but some type of hand held device that can use WAP).

Insallation:

Unpack the archive and upload it all to your webserver.
Make sure you have set CHMOD to 777 on the data dir. And if you want to be able to make changes and create language files online also set the folders "conf" and "lang" to 777.
Now surf to http://yoursite/shoppinglist/conf to create a config.php file. Just click the "save" button and you are done.
I also recommend you to go to http://yoursite/shoppinglist/lang to change the title and under title to fit your needs. The text presented on this page is all text that can be displayed in the program.

Start using your list at http://yoursite/shoppinglist/edit <= Here you add, change and remove items.

See the list on this address: http://yoursite/shoppinglist <= This you enter in your hand held device. :)

 

Usage:

Browse to http://yoursite/shoppinglist/edit page and start adding your items.
When you add an item it will automatically get "selected" as well (If you don't uncheck the tag behind the price field). Just type the items name, quantity and price / pice. Press "Save / Add item to list".

The select tags shows what items that actually selected to be shown in the "real" list. Tag the "Clear all selected items:" box if you want to clear all selected items.
The real list is located at http://www.yoursite.com/shoppinglist <= This is the address you should WAP to in your hand held device. All selected items will be shown in a simple list page (you can of course just use a normal web browser as well :).

If you want to completely remove an item from the list (only in edit mode), just select the item in the "edit" field and the item shows up in the "add" field below. Delete the item title and press "Save / Add item to list". Or if you just want to "rename" the item, just type the new name instead of the old one. After editing an item, don't forget to push the "Save / Add item to list" button, only one item at the time can be edited. However, you can tag multiple items at the same time.

The price in the price column is price / piece. That means if you have typed 5 in the quantity field the price will be taken times 5 automatically when calculating the total cost. Both the fields are very "understanding". You can add letters in them if you want. But they will be "discarded" when calculating the price.

The category field is meant for a easy way to navigate in the actual shop. You just give the items a category that equal the category of that item in the shop. Then when the list is displayed in your handheld device it is automatically sorted on categories, that way you don't have to run back and forth in the store. There is also a small "tag" box in that list, which is used for just tagging the items you have picked up while you are shopping. When you are done shopping you push the button and the list will be updated (all the tagged items will be untagged in the list).

All items have to have unique names. If you type an already existing items name, that item will be updated (if you change anything in the rest of the fields). That is basically the same as using the "edit" tag.

Hints:

You can create your own "language" files, in the lang folder. Just browse to http://yoursite/shoppinglist/lang fill ing a new language name at the top, translate all entries and click "Create / Update". Your new file will be saved. Then go in to the conf page and select your new language file. Save and all done. Now you only have to create your own templates in your language. The templates are located in it's own folders in the "tpl" folder.
To create a new "template set" just copy one of mine, and change all the things you want. Go in to the conf page again and select your new profile folder.

Tags used:
In Edit Head:
{LIST_DATE} Date of last list update.
{LIST_SELECTITEMS} Number of selected items in list.
{LIST_TITLE} Main title of list.
{LIST_TOTALITEMS} Number of total items in list.
{LIST_UNDERTITLE} Under title of list.
In the Edit Body:
{ITEM_CATEGORY} Category for the item.
{ITEM_NAME} Name of the item.
{ITEM_NUMBER} Number of the item in the list.
{ITEM_PRICE} Price of item / pice.
{ITEM_QUANT} Quantity of item.
{ITEM_SELECTED} If item is selected or not.
In the Edit Foot:
{LIST_BUTTONNAME} The button name.
{LIST_DATE} Date of last list update.
{LIST_LASTACTION} Info of last action when button is pressed.
{LIST_SELECTITEMS} Number of selected items in list.
{LIST_TOTALITEMS} Number of total items in list.
{LIST_TOTALPRICE} Total price of all items in list.
{LIST_TOTALPRICESELITEMS} Total price of all selected items in list.
{LIST_TOTALPRICEUNSELITEMS} Total price of all unselected items in list.
In List Head:
{LIST_DATE} Date of last list update.
{LIST_TITLE} Main title of list.
In List Body:
{ITEM_CATEGORY} Category for the item.
{ITEM_LISTNUMBER} The number in the list.
{ITEM_NAME} Name of the item.
{ITEM_NUMBER} The ID Number of the item.
{ITEM_PRICE} Price of item / pice.
{ITEM_QUANT} Quantity of item.
In List Foot:
{LIST_BUTTONNAME} The name of the button.
{LIST_DATE} Date of last list update.
{LIST_LASTACTION} Shown after the button is pressed.
{ITEM_TOTAL} Total items on list.
{LIST_TOTALPRICE} Total price of all items in list.
{LIST_TOTALPRICESELITEMS} Total price of all selected items in list.
{LIST_TOTALPRICEUNSELITEMS} Total price of all unselected items in list.

Copy the current templates and take a look at the HTML code to understand how it works. You will need to have some skills in HTML coding to create new templates. :)

Mail me at: master_snille@hotmail.com
WWW: www.snille.net
The forum: Support forum
License: GNU General Public License