Shoppingmanager/english: Difference between revisions

=Shopping Manager 1.1.2=

This program helps you to manage your shopping list. You enter items only once (automatically growing a complete list of your recurring shopping items) and then you can use them each time you plan your shopping tour with just a simple tap. While shopping, another simple tap checks the item you just put in your cart. When you are paying for your items, you can also do a checkout in the program. Items are sorted automatically to optimize planning and shopping.

You can define Shops and Categories to choose from for your items. Also, you can enter name, quantity, unit, price, aisle, notes, tax, priority and coupon.

Items can be imported from text files or clipboard and exported to the clipboard or as email. You can also send the list by email or SMS.

The item list can be configured to display more or less details, display text in different colors and font sizes, use complex sorting and more. You can filter the list by Shop, Category and search in the item names. The cost for your shopping tour is being calculated automatically.

If you know HandyShopper on PalmOS, you should have no problems using Shopping Manager for webOS.

In All mode, you see all kinds of items (default, needed, checked). This is the mode, where you plan your shopping. The items are sorted by name by default (you can change that). The header info displays the number of needed/visible items and the total price of needed items. You can always filter the view with the Shops and/or Category selector in the header or by typing some letters.

In Needed mode, you see only items that are needed or that you have checked. This is the mode, which you use while shopping. The items are sorted first by category, then by name by default (you can change that). The header info displays checked/visible items and the total price of the items that you have checked. By tapping on the header info, you can switch to the display of total price of needed and checked items. You can always filter the view with the Shops and/or Category selector in the header or by typing some letters.

* Shop (upper left selector)

* Category (upper right selector)

* Item Name (just type some letters on the keyboard)

By tapping on the selector in the upper left corner, you open the Shop menu. There you can enable filtering on a specific Shop or edit Shops. '''All Shops''' disables the filter. '''Edit...''' brings you to the Shops View (see below).

By tapping on the selector in the upper right corner, you open the Category menu. There you can enable filtering on a specific Category or edit Categories. '''All Cat.''' disables the filter. '''Edit...''' brings you to the Categories View (see below).

By default, items have a ball on the left. This means, they are not needed. Tapping on that ball switches the item to '''needed''' with a quantity of 1.  

Tapping on the item anywhere (but the '''i''' symbol) in '''Needed''' mode, checks the checkbox, meaning that you have the item in your cart. The item name changes color and all item texts are being stroked through. Items that you have are being displayed between the needed and default items by default (you can change that). Tapping again on the item unchecks it. Tapping on the item while you press on the gesture area edits the item.

On the right, there is a '''i''' symbol. Tapping on that opens the item menu. There you can go to the Edit View (see below), quickly set a quantity between 0 and 9 or a custom quantity (which opens a dialog for entering). Setting a quantity of 0  automatically switches the item to '''default'''. Setting a quantity of greater than 0, switches the item to '''needed'''.

In the first line, you can see the name of the item and the needed quantity (if the item is needed). In the second line, you can see the priority and the Category and Shop the item belongs to, the aisle (in [] and if you have a coupon). The third line displays the price for the item and the unit. If the item is needed, you can see the total price (price multiplied by quantity) on the right side. The last line (or lines) display notes for that item, if there are any. All lines (or part of lines) besides the first one can be switched off in the Preferences View (see below).

In the lower left corner, there is a '''+''' button. Tapping on the button opens the Edit View (see below) in new item mode.

Next, there is a button with a door. Tapping on the button does a checkout. You should choose Checkout, when you are done with a Shop (you have paid). This switches all checked items of the current Shop back to Default. If you are in the Needed mode, the items will disappear and you can (possibly) continue your shopping tour with the next Shop.

[[Image:shoppingmanager_menu_en_110.png]]

====Delete/Create====

Deletes and creates the entire database, so please be careful with that! After creating the database, you will be asked if you want to have some example items created.

You can import items from a text file or from the clipboard. The requirement is that you have each item on a separate line like this:

  Apples;Fruit;Shop2;Kilogram;1.99;2;Only the red ones;3;false;false;3;false

  Mineral water;Drinks;Shop1;Liter;0.49;6;;1;false;false;1;true

  Oranges;Fruit;Shop2;Kilogram;2.99;0;;3;false;false;4;false

  Red wine;Drinks;Shop1;Liter;5.99;0;;2;false;false;2;false

  Name;Categoryname;Shopname;Unit;Price;Quantity;Note;Aisle;Tax1;Tax2;Priority;Coupon

Import will use the current Shop and/or Category for the imported items. When you choose "ALL SHOPS" and/or "ALL CAT." then the Shop and/or Category for the imported items will be set automatically. That means, if the import data contains values for the Shop and/or Category then these values will be taken. If not, in case of an update the old value will remain unchanged or in case of an insert the default value will be used.

If you have text in the clipboard (for example you exported using a different version of Shopping Manager or you copied the text from an email or from the Memos application), then you choose Import and Clipboard and paste the content of the Clipboard into the text field and tap on '''Import'''.

=====Import from HandyShopper=====

To import items from HandyShopper (PalmOS), you have 2 possibilities: Items only or most fields.

* export your HandyShopper list (items only, no optional fields, "-" as separator) to MemoPad

HandyShopper's export format is not well structured and is missing some things, for example categories. So, to get most of your data exported, you would have to use an extra tool named [http://www.rmobile.ca/subpages/hs2edit.html HS2Edit]. This Excel extension reads the .pdb file from HandyShopper and lets you create a .csv file. You just have to make sure, that the file meets the specifications (field order) listed above.

You can export items to the Clipboard or an email. You can also choose, if you want to export all items or all needed items of the current Shop. The format is described in the Import chapter.

You can send a list of items by email or SMS. You can also choose, if you want to send all items or all needed items of the current Shop.

For email, the columns for the list can be selected in the following screen. For SMS, it's always name and quantity per item.

[[Image:shoppingmanager_shops_en_110.png]]

Here you can add, edit or delete Shops with standard webOS methods and gestures. Tapping on '''+''' adds a new Shop. Tapping on the Shop lets you edit the name and swiping the Shop to the left or right deletes the Shop.

[[Image:shoppingmanager_categories_en_110.png]]

Here you can add, edit or delete Categories with standard webOS methods and gestures. Tapping on '''+''' adds a new Category. Tapping on the Category lets you edit the name and swiping the Category to the left or right deletes the Category.

==Edit View==

[[Image:shoppingmanager_edititem_en_110.png]]

You get to the Edit View by tapping the '''+''' button on the Main View or the '''i''' symbol for an item and choosing '''Edit item'''.

* Tax 1 applies: Tax 1 (defined in Preferences) applies for this item

* Tax 2 applies: Tax 2 (defined in Preferences) applies for this item

* Aisle: The aisle, where you find the item in the Shop.

The Category and Shop selectors also offer to open the Category or Shop View by choosing '''Edit...'''.

The Edit View can be in New or Edit mode, depending how you got there:

* in New mode, tapping on '''Done''' creates the new item and clears the fields (not quantity, Category and Shop), so you can quickly add another item.  

The Number View can be reached by selecting '''Custom Quantity''' in the '''i''' menu of an item or by tapping twice on quantity or price in the Edit View. You can type in numbers by tapping on screen or by using the keyboard.

You can enter two global Taxes in percent. Then, for each item, you can select in the Item View if one or both applies.

[[Image:shoppingmanager_options1_en_111.png]][[Image:shoppingmanager_options2_en_111.png]]

* Checkout only visible items: If on, only the currently visible and checked items are being reset to default when doing a checkout. If off, all checked items from the current Shop are being reset.

* Category

* Shop

* Category

* Shop

* Details: Category, Shop, Aisle, Price, Unit

* Details: Category, Shop, Aisle, Price

{{ShoppingManagerHistory}}