VivaLV-Software

Shoppingmanager/english: Difference between revisions

Page Discussion

Shoppingmanager/english (view source)

Revision as of 17:16, 11 November 2011

34,562 bytes added ,  11 November 2011
m
→‎Sorting in All mode/Needed mode
 
(104 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Shopping Manager=
=Shopping Manager 2.6.5=
[[Image:shoppingmanager_en.png]]


[[Image:HotApps.png]]


[[Image:shoppingmanager_en_240.png]][[Image:shoppingmanager_dark_en_240.png]]
__NOTITLE__
__TOC__
__TOC__


==Description==
==Description==
This program helps you to manage your shopping list. You enter items only once 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. Items are sorted automatically to optimize planning and shopping.
Inspired by the HandyShopper concept, this App truly simplifies and enhances your shopping experience.  
 
Easy to use (even with one hand), yet very powerful and flexible:
 
One tap - marked as needed, another tap - marked as have - checkout when finished.
 
<b>Features:</b><br>
* one-time entry of items
* intelligent sorting & filtering
* multiple shops per item
* multiple categories (like templates) per item
* multiple databases * Excel-compatible (.csv) import and export
* send list by Email or SMS
* Google Docs
* Best Buy
* unit price
* configurable display (details, font sizes, colors, etc.)
* automatic cost calculation
* reminders
* and more


If you know HandyShopper on PalmOS, you should have no problems using Shopping Manager for webOS.
You can set name, quantity, standard quantity, unit, price, aisle, notes, tax, priority, coupon, planned date, auto-delete and image for each item.


==Basic Usage==
==Basic Usage==
# select the '''All''' view
# select the '''All''' mode by tapping on the memo pad
# tap the red ball of needed items or create new items with the '''+''' button
# tap the ball on the left of needed items or create new items with the '''+''' button
# select the '''Needed''' view and go shopping
# select the '''Needed''' mode by tapping on the shopping cart and go shopping
# tap on items that you put in your cart
# tap on items that you put in your cart
# pay
# pay
# select '''Checkout''' in the menu
# tap the door button for checkout
 
==Running on the TouchPad==
Shopping Manager runs fullscreen on the TouchPad. Differences to the phone version:
* some screens have an additional left arrow on the bottom to go back
* screens where you can search by just typing have a magnifier at the bottom to show the virtual keyboard
 
Other than that, Shopping Manager works on the TouchPad the same way as on the phones.


==Modes==
==Modes==


===All mode===
===All mode (memo pad icon)===
In All mode, you see all kinds of items (default, needed, have). This is the mode, where you plan your shopping. The items are sorted by name. 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 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.


===Needed mode===
===Needed mode (shopping cart icon)===
In Needed mode, you see only items that are needed or that you have. This is the mode, which you use while shopping. The items are sorted first by category, then by name. The header info displays have/visible items and the total price of the items that you have. 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.


==Searching/Filtering==
==Searching/Filtering==
You can quickly find a specific item, by filtering the list by
You can quickly find a specific item, by filtering the list by
* Shop (upper left selector)
* shop (upper left selector)
* Category (upper right selector)
* category (upper right selector)
* Item Name (just type some letters on the keyboard)
* item Name (just type some letters on the keyboard)


This works in both modes (All/Needed).
This works in both modes (All/Needed).
Line 37: Line 66:


===Header===
===Header===
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 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 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).


In the middle, you have some statistics about your items. The first line displays the number of needed or checked items and the number of visible items. The second line displays the price of needed items or checked items. The displayed numbers and price depend on the selected mode ('''All''' or '''Needed''').
In the middle, you have some statistics about your items. The first line displays the number of needed or checked items and the number of visible items. The second line displays the price of needed items or checked items. The displayed numbers and price depend on the selected mode ('''All''' or '''Needed'''). In '''Needed''' mode, tapping on the statistics switches between 2 variants.


===Item List===
===Item List===
By default, items have a red ball on the left. This means, they are not needed. Tapping on that ball switches the item to '''needed''' with a quantity of 1.  
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 the standard quantity of that item.  


When the item is needed, a checkbox appears instead of the red ball and the item name turns red. Now the item will also be displayed in the '''Needed''' mode. Needed items are being displayed at the top of the list.
When the item is needed, a checkbox appears instead of the ball and the item name changes color. Now the item will also be displayed in the '''Needed''' mode. Needed items are being displayed at the top of the list by default (you can change that).


Tapping on the item anywhere (but the '''i''' symbol), checks the checkbox, meaning that you have the item in your cart. The item name turns blue and all item texts are being striked through. Items that you have are being displayed between the needed and default items.
Tapping on the item anywhere (you can change that to left third or checkbox only) 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'''.
If you tap on the checkbox of an item in '''All''' mode, it will be reset back to '''default'''.


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 Category and Shop the item belongs to. 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 second and third line can be switched off in the Preferences View (see below).
On the right, there is a '''i''' symbol. Tapping on that opens the item menu. There you can:
* go to the Edit Item View (see below)
* set a custom quantity (which opens a dialog for entering)
* quickly set a quantity between 0 and 9
* copy the item
* move the item
* compare the item in the '''Best Buy''' tool
* show the image of the item, if you set one
 
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. It also displays the unit price, if you have entered a unit with a size different from one (for example "0.7 l" or "500 g"). If the item is needed, you can see the total price (price multiplied by quantity) on the right side. If you see a red arrow up to the left of the item price, then the item is cheaper in another shop. 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).


You can delete items by swiping them to the left or to the right.
You can delete items by swiping them to the left or to the right.


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


In the lower right corner, there is the mode switch. You can choose '''All''' or '''Needed''', which changes the display and behavior of the program. Please see above for more info.
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.
 
In the middle, there is a button with a curved arrow. This is the '''Undo''' button. Tapping on the button reverts the last simple changes (check/uncheck/change quantity) you did to the items in the Main View. When you leave the Main View or switch between All or Needed mode, you cannot take back the last changes.
 
In the lower right corner, there is the mode switch. You can choose '''All''' (memo pad) or '''Needed''' (shopping cartn), which changes the display and behavior of the program. Please see above for more info.


==Menus==
==Menus==
[[Image:shoppingmanager_menu_en_250.png]]
===Keyboard shortcuts===
Some of the menu entries are available as keyboard shortcuts (press and hold gesture area and then press key):
* D = switch database
* M = manage databases
* T = Data Transfer
* N = Action
* B = Best Buy
* P = Preferences
* H = Help


===Edit===
===Edit===
Line 67: Line 122:


===Database===
===Database===
'''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.


'''Import''' lets you import items from a text file. The requirement is that you have each item on a separate line like this:
====Manage====
Beer
This takes you to the Databases View (see below).
Juice
 
Simply copy a file with a name with ending '''.txt''' (for example '''items.txt''') over USB to your webOS device and choose Import in Shopping Manager. Then you select the encoding (ISO or UTF-8) and choose the file. Existing items will not be overwritten.
====Select====
Here you can see, what the current database is (has a checkmark) and quickly switch to another.
 
====Data Transfer====
This takes you to the Data Transfer View (see below).
 
===Execute Action===
[[Image:shoppingmanager_action1_en_220.png]][[Image:shoppingmanager_action2_en_220.png]]
 
Here you can execute an action on multiple items at once. First you should filter the item list as you wish and then you can tap on this menu and choose an action. After choosing the action, you see again the list of previously visible items and then you choose on which of those to invoke the action. Tap on '''Execute''' to execute. See also the chapter on the Pick Items View.
 
Most actions do have a second option named '''choice''', where you can further configure the action.
 
====Assign alternative shop====
This action assigns (or unassigns) a shop as alternative shop to multiple items. Choose the shop in the second selector. Items that have the chosen shop as main shop, cannot be assigned. You cannot input price and aisle for the alternative shop here (this can only be done in the Edit Item View). More on alternative shops in the chapter below.
 
====Assign virtual category====
This action assigns (or unassigns) a category as virtual category to multiple items. Choose the category in the second selector. Items that have the chosen category as main category, cannot be assigned. More on virtual categories in the chapter below.
 
====Change shop====
This action changes the main shop on multiple items. Choose the shop in the second selector. If the items already have the chosen shop as alternative shop, that will be removed.
 
====Change category====
This action changes the main category on multiple items. Choose the category in the second selector. If the items already have the chosen category as virtual category, that will be removed.
 
====Copy to DB====
This action copies multiple items to a different or the same database. Choose the database in the second selector. More on multiple databases in the chapter below.
 
====Move to DB====
This action moves multiple items to a different database. Choose the database in the second selector. More on multiple databases in the chapter below.


To import items from HandyShopper (PalmOS), please follow these steps:
====Delete items====
* export your HandyShopper list (items only, no optional fields, "-" as separator) to MemoPad
This action deletes multiple items. The second selector is irrelevant here. Be careful with this action, because deleted items are gone forever.
* do a HotSync
* copy the content of the memo from Palm Desktop to an editor (Notepad for example), replace "- " (this is the minus sign plus space) with "" (nothing) and save as somename.txt
* copy that file to your webOS device over USB
* import the list into Shopping Manager (choose ISO encoding, if you used Notepad)


===Reset Visible Items===
===Reset Visible Items===
Line 85: Line 164:
* Default: Switches all visible items to Default state
* Default: Switches all visible items to Default state
* Need: Switches all visible and not needed items to Need state
* Need: Switches all visible and not needed items to Need state
* Have: Switches all visible and needed items to Have state
* Checked: Switches all visible and needed items to Checked state


===Checkout===
===Send List===
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.
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_sendlist_en_110.png]]
 
===Best Buy===
[[Image:shoppingmanager_bestbuy_en_220.png]]
 
Here you can compare 2 prices of items with different units. For example, you can test, if that '''0.7 l''' bottle of water is cheaper than a '''2.0 l''' bottle of water. Just enter price and number of units for both items and the result will be displayed at the top.
 
You can get to this View by selecting '''Best Buy''' in the main menu or in the '''i''' menu of an item. In the 2nd case, the price and number of units for item B will be pre-populated with the data from the item. So, if you are shopping and the shop has a different unit size, you can easily find out, if the price is good.


===Preferences===
===Preferences===
Line 95: Line 185:
===Help===
===Help===
This opens the Help View, where you have some basic usage hints, the copyright notice and the possibility to visit the web site or write a mail to support.
This opens the Help View, where you have some basic usage hints, the copyright notice and the possibility to visit the web site or write a mail to support.
===About===
This shows you information about the program.
==Multiple databases==
You can have as many databases as you wish. Each database has its own items, shops, categories and preferences. Initially, there is only the '''Standard''' database. You can see the current database in the database menu ('''DB: Name'''). Tapping on that takes you to the Databases View (see below), where you can switch to another database and also create, delete and clear databases.
You can copy or move items from the current database to another database with the '''i''' menu of an item or with the corresponding Action to do multiple items at once. Alternative shops and virtual categories are also being copied to the destination database. Shops and categories are being created in the destination database, if necessary. If the item already exists in the destination database, the new item will be renamed to '''Itemname - 2''' and so on. The destination database can also be the current database.
==Alternative shops==
An item has always a base shop with price and aisle. You can add multiple alternative shops to each item. For each alternative shop, you can choose to use the base price or aisle or you can define its own price or aisle. When you filter by All Shops in the Main View, the shop with the best price will be displayed for each item.
You can assign alternative shops to an item in the Edit Item View and Alternative Shop View or with the corresponding Action. But the Action can not specify price or aisle for an alternative shop.
==Virtual categories==
An item has always a base category. You can add multiple virtual categories to each item. You can use virtual categories to group items, or you can see it as template. For example, you can have a category "Pizza" and assign it to tomatos, mushrooms, etc. Then, when you plan your shopping and want to buy stuff for Pizza, you filter by Pizza and mark all as needed. Virtual categories will not be displayed in the item details on the Main View. There you will always see the base category.
You can assign virtual categories to an item in the Edit Item View and Virtual Category View or with the corresponding Action.
==Unit price==
If you enter units with a leading number, that is different from '''1''' for an item, the unit price for that item will be displayed in the price info line in the main list. So, if you have a price of '''$0.49''' and a unit of '''0.7 Liter''', the price info will display '''$0.49/0.7 Liter ($0.70)'''. The unit price (for 1 Liter) is '''$0.70''' in this case.
Also, if you choose '''Best Buy''' from the '''i''' menu of an item, the information will be automatically entered for item B.
==High-price indicator==
If you are filtering by '''All''' shops, you will always see the name, price and aisle of the cheapest shop. If you are filtering by a specific shop, you will see a red arrow up (<span style="color:red">&uarr;</span>) to the left of the item price, if the item is cheaper in another shop.
==Planned purchase/Reminders==
If you enable '''Planned purchase''' in the Edit Item View, you can set a date and time, when you want to be reminded to purchase that item.
At the set point in time, you will get a Dashboard Notification with a small Shopping Manager icon at the bottom of the screen, the phone will vibrate and the LED below the screen will flash (if the screen is off at that moment). This works with Shopping Manager running or not.
[[Image:shoppingmanager_dashboard1_en_240.png]]
Tap on the notification to open the Dashboard. You will see the Shopping Manager icon on the left and information about the database and the item on the right. Tapping anywhere will open Shopping Manager and the corresponding database.
[[Image:shoppingmanager_dashboard2_en_240.png]]
If there are multiple notifications, you will see the number of notifications on the left and tapping on the Shopping Manager icon will cycle through the notifications. Tapping on the info text will open Shopping Manager and the corresponding database. The Dashboard Notification will display for each database only the newest reminder.
[[Image:shoppingmanager_dashboard3_en_240.png]]
Whenever you start Shopping Manager (with the Launcher icon or by tapping on the Dashboard) or switch to a database, it will always mark all planned items (date is before current date) as needed.
Planned purchase will be reset for all checked items during checkout.
==Just Type integration==
If you have a device with webOS 2.0 or greater, you can integrate Shopping Manager with '''Just Type'''. To do this, you have to go to the '''Just Type Preferences''' on your webOS device. Just type anything in the main menu (launcher) of your device, scroll down and tap on '''Preferences'''.
Then, under '''Launch & Search''', tap on '''Add More Searches'''. Tap on '''Shopping Manager''' under '''App Search Engines'''. That's it.
Now, when you type in some text in the webOS launcher, you will be offered to start '''Shopping Manager''' under '''Launch & Search'''. Shopping Manager will start and immediately search for the text you typed in.


==Shops View==
==Shops View==
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_shops_en_120.png]]
 
Here you can add, edit or delete shops. Tapping on '''+''' adds a new shop. Tapping on '''i''' lets you edit the name and swiping the shop to the left or right deletes the shop.


==Categories View==
==Categories View==
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.
[[Image:shoppingmanager_categories_en_120.png]]


==Edit View==
Here you can add, edit or delete categories. Tapping on '''+''' adds a new category. Tapping on '''i''' lets you edit the name and swiping the category to the left or right deletes the category.
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'''.
 
==Edit Item View==
[[Image:shoppingmanager_edititem_en_220.png]][[Image:shoppingmanager_edititem2_en_230.png]][[Image:shoppingmanager_edititem2a_en_230.png]][[Image:shoppingmanager_edititem3_en_210.png]]
 
You get to the Edit Item View by tapping the '''+''' button on the Main View or the '''i''' symbol for an item and choosing '''Edit item'''.
The following information is editable for an item:
The following information is editable for an item:
* Name: Unique name of the item.
* Name: Unique name of the item.
* Quantity: Current needed quantity of the item. This does not really describe the item, but it is here for convenience.
* Quantity: Current needed quantity of the item. This does not really describe the item, but it is here for convenience.
* Unit: Unit for the quantity. If you use that, you can enter '''Piece''' or '''lbs''' for example. The default is '''Piece'''.
* Unit: Unit for the quantity. Tap on unit to open the units menu. You can select an existing unit, change the unit (and optionally save the new unit in the units list) or edit the units list (see Units View below).
* Price: Price for one unit of the item.
* Price: Price for one unit of the item.
* Category: Category, in which the item belongs, for example '''Fruit'''. You must first define Categories in the Category View.
* Standard quantity: This is the initial quantity for the item when you tap on the ball in the Main View.
* Shop: Shop, where you intend to buy the item. You must first define Shops in the Shop View.
* Tax 1 applies: Tax 1 (defined in Preferences) applies for this item.
* Tax 2 applies: Tax 2 (defined in Preferences) applies for this item.
* Coupon: You have a coupon for this item.
* Delete after checkout: This is an item, that you only need once. It will be deleted after checking the item and doing checkout.
* Aisle: The aisle, where you find the item in the shop.
* Note: Additional info text, that you want to enter (multi-line).
* Priority: The priority (1-5) of the item. You can define sorting by priority in Preferences.
* Image: An image of the item. To choose an image on your phone (or take a new photo), tap the selector button on the left. You can also use an Internet URL of any image. You can see the image at the bottom of the Edit Item View or by tapping on the '''i''' of the item in the Main View and choosing '''Show image'''. The remove the image, clear the field.
* Last purchase date: This is the date of your last purchase of the item. It is being recorded for checked items on checkout.
* Planned purchase: Enable this to plan the purchase of the item. You can enter date and time, when you want to purchase it. Please see also the chapter about '''Planned purchase/Reminders'''.
* Category: Category, in which the item belongs, for example '''Fruit'''.
* Shop: Shop, where you intend to buy the item.
* Alternative shops: List of alternative shops for this item. Tap on a shop to see the Alternative Shop View. Tap on '''+''' to add an alternative shop.
* Virtual categories: List of virtual categories for this item. Tap on a category to see the Virtual Category View. Tap on '''+''' to add a virtual category.
 
The category and shop selectors also offer to open the category or shop View by choosing '''Edit...'''.
 
The Edit Item View can be in New or Edit mode, depending how you got there:
* in Edit mode, tapping on '''Done''' alters the item and brings you back to Main View.
* 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.
 
Tapping on '''Revert''' resets your changes in this item.


The Edit View can be in New or Edit mode, depending how you got there.
The standard back swipe alters or creates the item and brings you back to Main View.
In Edit mode, tapping on '''OK''' alters the item and brings you back to Main View.
 
In New mode, tapping on '''OK''' creates the new item and clears the fields, so you can quickly add another item. The standard back swipe brings you back to the Main View.
With the buttons '''Multi-Assign Alt. Shops''' and '''Multi-Assign Virt. Categories''' you can select/deselect multiple alternative shops/virtual categories for this item at once.
 
[[Image:shoppingmanager_multishops_en_210.png]][[Image:shoppingmanager_multicategories_en_210.png]]
 
The usage of these Views is similar to the Pick Items View.
 
==Number View==
[[Image:shoppingmanager_number_en_111.png]]
 
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 Item View. You can type in numbers by tapping on screen or by using the keyboard.
 
==Alternative Shop View==
[[Image:shoppingmanager_alternativeshop_en_120.png]]
 
You get to the Alternative Shop View by going to the Edit Item View and tapping either on '''+''' or on an existing alternative shop in the list of alternative shops.
 
You can choose the shop with the selector and you can decide for price and aisle, if you want to use the standard (from the Edit Item View) or if you want to have a different price or aisle for this shop.
 
Tap on '''Done''' or do a back-swipe when finished. Tap on '''Revert''' to revert your changes.
 
==Virtual Category View==
[[Image:shoppingmanager_virtualcategory_en_120.png]]
 
You get to the Virtual Category View by going to the Edit Item View and tapping either on + or on an existing virtual category in the list of virtual categories.
 
You can choose the category with the selector.
 
Tap on '''Done''' or do a back-swipe when finished. Tap on '''Revert''' to revert your changes.
 
==Pick Items View==
[[Image:shoppingmanager_pickitems_en_120.png]]
 
After choosing an Action from the main menu, you get to the Pick Item View to select the items on which to invoke the Action. You can select/deselect items by tapping on their checkbox or with the '''All''' and '''None''' buttons.
 
For some actions, selecting an item means invoking the action on them (for example the '''Delete items''' action deletes the selected items). For other actions, also deselecting an item does something (for example the '''Assign alternative shop''' action can assign and unassign a shop).
 
Tap on the '''Sort''' button to change the sorting. '''Normal''' means sorting like it's currently in the Main View. '''Checked on top''' means moving the selected items to the top, so you can more easily see the selected items.
 
'''Exec''' executes the action. A back-swipe cancels the action.
 
==Databases View==
[[Image:shoppingmanager_databases_en_210.png]]
 
You get to the Databases View by selecting the '''Database->Manage''' menu item in the Main View. Here you see a list of all your databases and the number of items they contain. The current active database has bold text.
 
Tap on '''+''' to add a new database. Tap on a database to switch to that database. Tap on the '''i''' to:
* rename the database
* change its color (for the title text in the Main View)
* clear it, which means deleting all items, shops and categories (so please be careful with that)
* add an icon (you can choose to use the standard icon or any photo) for the database to the Launcher, so that Shopping Manager opens this database after starting
* switch to the database, if it is not already the current one
 
Swipe a database to the left or right to delete the entire database. You cannot delete the '''Standard''' database.
 
In the menu, you can delete '''all of your databases''' at once by selecting '''Recreate complete database''', bringing Shopping Manager back to the state of a fresh install. Please be extra careful with that!
 
Also, if you think your items list has a problem, you can rewrite all items by choosing '''Fix Items''' in the menu. But we advice, that you contact us first, if you think there is a problem.
 
==Units View==
[[Image:shoppingmanager_units_en_220.png]]
 
You get to the Units View by tapping on the unit of an item in the Edit Item View and selecting '''Edit''' in the sub menu. Here you can add new units to the units list by tapping on '''+''' and you can delete units by swiping them to the left or right. Deleting a unit will '''not''' delete it from the items, where it's used. This is different from shops and categories, because units are not referenced in the item, but copied to it.
 
==Data Transfer View==
[[Image:shoppingmanager_datatransfer_en_220.png]][[Image:shoppingmanager_datatransfer2_en_220.png]]
 
You get to the Data Transfer View by selecting '''Database->Data Transfer''' in the main menu. Here you can export and import your data.
 
If you filtered by shop and/or category in the Main View, you will see information about this at the top. This will influence both export and import.
 
===Configuring===
Everything you configure here will be saved for using it again next time (for each database).
 
====Mode====
* select the direction: '''Import''', '''Export''' or '''Import + Export'''
* select the source/destination (choices depend on the chosen direction)
* select '''All items''' or '''Needed items''' (does not apply to Import)
 
====Google spreadsheet====
[[Image:shoppingmanager_googledocslist_en_220.png]]
 
If your source or destination for the transfer is '''Google Docs''', you can first pick a Google spreadsheet by tapping on the pick button (the button with the triangle). If you have configured a Google Account, you will see the list of spreadsheets for that Account. You can select an existing spreadsheet or tap '''+''' to enter a new name (this will not create a new spreadsheet now, you just choose a name). Only spreadsheets are working for data transfer.
 
====Options====
* Header included: This means that the first line contains a column header. For import, this line is just skipped It is not being used to configure which column contains which type of data.
* Backup existing Google Doc: If checked, an existing Google Doc will not be overwritten during export. Instead, it will be renamed.
* Update existing items on phone: If enabled, existing items on the phone will be updated during import. Otherwise, only new items will be imported.
 
===Starting a data transfer===
Tap the '''Execute''' button to start the data transfer with the options you have set. If you are communicating with Google and you did not choose a Google Doc earlier, you will see the Google Docs list now.
 
===Google Account===
[[Image:shoppingmanager_googleaccount_en_220.png]]
 
Tap on '''Change Login Settings''' to enter login and password for your Google Account. Tap on '''Sign In''' to accept the credentials. If you choose '''Save password''', the password will be saved. Otherwise, you will have to enter it after each restart of Shopping Manager when communicating with Google.
 
Tap on '''Remove Account''' to delete the Google credentials you entered.
 
You can only configure one global Google Account that will be used for all databases. The credentials are not being saved in the database, instead they are being saved in a Cookie.
 
===Transferring===
 
====Import====
Import always works on the current database. You can import items from a text file, from the clipboard or from a Google spreadsheet. 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;1
Mineral water;Drinks;Shop1;Liter;0.49;6;;1;false;false;1;true;1
Oranges;Fruit;Shop2;Kilogram;2.99;0;;3;false;false;4;false;1
Red wine;Drinks;Shop1;Liter;5.99;0;;2;false;false;2;false;1
 
The format is:
Name;CategoryName;ShopName;Unit;Price;Quantity;Note;Aisle;Tax1;Tax2;Priority;Coupon;StandardQuantity
 
You can import new items and update existing items with the Import functionality.
 
The separator can be configured in Preferences. Only the Name is mandatory. You can leave fields blank (no text between the two ;;). You can omit fields at the end, for example only importing Names. But the order of fields is fixed!
 
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.
 
Handling of special cases is compatible with Excel. If you want to have the separator char inside a field or a line feed or a quotation mark, then you have to write the complete field in quotation marks and quotation marks inside the field have to be doubled. For example, if you want to import a note field with this content:
this is;some "strange"
text
Then it has to be written like this:
"this is;some ""strange""
text"
 
If you are using Google, these rules do not apply.
 
If you are importing an item, that already is in the current database and the shop or category in the import data is different than in the database, it will be treated as alternative shop or virtual category. In this case all fields are being ignored that are irrelevant for an alternative shop (everything besides shop, price and aisle) or virtual category (everything besides category).
 
'''From File:'''
Simply copy a file with a name with ending '''.txt''' or '''.csv''' (for example '''items.txt''') over USB to your webOS device and choose Import and File. Then you select file and the encoding (ISO or UTF-8) and choose the file.
 
'''From Clipboard:'''
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'''.
 
'''From Google spreadsheet:'''
If you did not select a Google spreadsheet already, you have to select it now. Only spreadsheets work for import.
 
=====Import from Handyshopper=====
To import items from Handyshopper (PalmOS), you have 2 possibilities: Items only or most fields.
 
'''1. Items only'''<br>
* export your Handyshopper list (items only, no optional fields, "-" as separator) to MemoPad
* do a HotSync
* copy the content of the memo from Palm Desktop to an editor (Notepad for example), replace "- " (this is the minus sign plus space) with "" (nothing) and save as somename.txt
* copy that file to your webOS device over USB
* import the list into Shopping Manager (choose ISO encoding, if you used Notepad)
 
'''2. Most fields'''<br>
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.
 
====Export====
You can export items to the Clipboard, Email or a Google spreadsheet. 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.
 
If you are filtering by shop currently in the Main View, only items from that shop will be exported.
 
Alternative shops and virtual categories are being exported as lines with most fields empty. Only shop, price and aisle or category are bring written.
 
====Units====
The units list is being exported only if you choose '''All items'''. Then the units will be exported after all items, with only the unit name in the line, for example:
;;;0.7 Liter;;;;;;;;
During import, these kind of lines create entries in the units list.
 
===Tips for using Google Docs===
You can enable sharing of existing Google spreadsheets with others using the Google Docs web interface. After that, the other person sees this spreadsheet also in his/her list. Google Docs currently has a bug, if you export to a spreadsheet, that is being shared to you. You will get an error message after export, but the export will be OK anyway.
 
Following are several example scenarios for using Google Docs with Shopping Manager.
 
====Editing your items outside of Shopping Manager====
Export '''All items''' including header to a Google spreadsheet. Then you can change items in the Google Docs web interface. Be careful to not enter data in the wrong fields. After editing, import the spreadsheet into Shopping Manager. Be sure to enable updating of existing items. Deleted items on Google Docs will not be deleted in Shopping Manager, because import only updates or adds items. If you want to make big changes, you probably want to clear the current database in Shopping Manager or switch to a new database before import.
 
====Backup/Restore====
You can backup and restore your current database easily using export to Google Docs and import from Google Docs. Be careful not to filter by shop or category in the Main View and to choose '''All items'''. Also, the header option must be set equal for backup and restore. Be sure to enable updating of existing items for restore.
 
===="Syncing" a list of items between 2 persons====
If you are sharing a Google spreadsheet with someone else, you can share your Shopping Manager list of items with that person. To "sync" (it's no "real" sync in fact, because it does not know, who made changes to what and when), choose '''Import + Export''' and '''All items'''.
 
If you don't want to update existing items on your phone, switch off that option, so you will only get new items during the transfer. If both persons do this regularly, they will always get the others new items and will together grow the list of items. Changes to existing items however will not be transferred.
 
If you enable update existing, since it is no "real" sync, there are cases, where you will lose your changes to items. This happens for example, if you make changes, enable update existing and then do '''Import + Export'''. To work around this, first do an import only, then make your changes and then do an export only.
 
Be sure to always use the same header option.
 
====Planning shopping for someone else====
If you are sharing a Google spreadsheet, one person can export the '''Needed items''' and the other person can import from the same spreadsheet. In Google Docs on the web, you can even configure to get an Email, if a spreadsheet changes, so you know automatically, that the other person has finished and exported the needed items. Be sure to use the same header option. Be sure to enable updating of existing items. This even works, if the other person has no webOS device with Shopping Manager, because he/she can also edit the data in the Google Docs web interface.


==Preferences==
==Preferences==
The Preferences View can be reached by choosing the corresponding menu entry. You can configure the number of decimal places to be displayed for the quantity and what details to display for each item in the list:
The Preferences View can be reached by choosing the corresponding menu entry. You can expand the different sections by tapping on the section header.
 
===Tax===
[[Image:shoppingmanager_tax_en_220.png]]
 
You can enter two global Taxes in percent. Then, for each item, you can select in the Edit Item View if one or both applies.
 
===Options===
[[Image:shoppingmanager_options1_en_250.png]][[Image:shoppingmanager_options2_en_250.png]]
* Import/Export separator: This character will be used for import and export as field separator.
* Show needed in All mode: If on, the needed items are being display in All mode, otherwise only in Needed mode. If off, then if you mark an item as needed in the All mode, it will disappear.
* Show checked in Needed mode: If on, the checked items are being displayed in Needed mode, otherwise only in All mode. If off, then if you check an item in Needed mode, it will disappear.
* 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.
* Keep screen on in Needed mode: If on, the display will stay on always in Needed mode.
* Name entry multi-line: If on, you can enter item names with multiple lines.
* Name wraps: If on, long item names are being wrapped to use more than one line.
* Clear filter on selection: If on, the current name filter is being cleared when you select an item.
* Search in notes: If on, typing in the Main View searches not only in the item name, but also in the notes.
* Clear coupon after checkout: If on, coupon will be unchecked for items during checkout.
* Vibrate in All mode: Vibrate, when tapping on an item in All mode.
* Vibrate in Needed mode: Vibrate, when tapping on an item in Needed mode.
* Show info button: If on, shows the '''i''' button on the Main View.
* Check for update: If on, the program will search for a newer version once per week after starting. If it finds a newer version, you will be notified and be asked, if you want to update.
* Check item: Defines the area where you can check an item in Needed mode. Available is Complete line, Left third and Checkbox.
* Quantity decimals: Number of decimal places to be displayed for the quantity
 
===Item details (display for each item)===
[[Image:shoppingmanager_display_en_220.png]]
 
Here you can switch on or off, what information to display for each entry in the item list:
* Priority
* category
* shop
* Aisle
* Coupon
* Price info (Price, Unit, Total price)
* Note
 
===Sorting in All mode/Needed mode===
[[Image:shoppingmanager_sorting_en_220.png]]
 
Here you can define, what sorting criteria should be used first and following for the All and Needed mode. You can choose between:
* Name
* Category
* Category
* Shop
* Shop
* Price info (price, unit, total price)
* Aisle
* Priority
* Price
* Note
* Unit
 
Also, you can enable or disable displaying the needed items separate and the moving of checked items below needed items.
 
===Background===
[[Image:shoppingmanager_background_en_224.png]]
 
Here you can style your background for Shopping Manager:
* Choose Image: Choose an existing image or take a new photo for background
* Remove Image: Remove the current background image
* Color: Choose a background color or reset to default
* Transparency: Adjust the visibility of the background image or color
 
===Colors===
[[Image:shoppingmanager_colors_en_224.png]]
 
You can choose between various colors for displaying the different parts of the item list:
* Theme: This is the base color theme. It affects everything, that you cannot set explicitly below.
* Name (Default): The name of items in Default state
* Name (Needed): The name of items in Needed state
* Name (Checked): The name of items in Checked state
* Details: category, shop, Aisle, Price, Unit
* Note: The notes of the item
* Ball: The ball on the left of the item
 
===Font Sizes===
[[Image:shoppingmanager_fonts_en_110.png]]
 
You can configure the size of the fonts for different parts of the item list:
* Name
* Details: category, shop, Aisle, Price
* Note: The notes of the item


==Database==
==Database==
The data is being stored on the USB partition of your webOS device in directory '''/.app-storage/file_.var.usr.palm.applications.de.vivalv.software.shoppingmanager_0''', in case you want to back it up. If you uninstall the program, the data will be deleted by webOS.
The data is being stored on the USB partition of your webOS device in directory '''.app-storage/file_.media.cryptofs.apps.usr.palm.applications.de.vivalv.software.shoppingmanager_0''', in case you want to back it up.
 
If you don't see '''.app-storage''', you have to enable listing of hidden files for example in Windows Explorer.
 
In that directory, you'll find a file named for example '''0000000000000060.db'''. This name is created by random and will be different for everyone and for different versions of Shopping Manager.
 
If you want to transfer this to another version of Shopping Manager, just copy the file to the directory of the other version and rename it, like the existing file is named there. You can copy data between the versions, if the target version number is at least as high as the source version number!
 
Directory names:
* Full version: '''.app-storage/file_.media.cryptofs.apps.usr.palm.applications.de.vivalv.software.shoppingmanager_0'''
* Demo version: '''.app-storage/file_.media.cryptofs.apps.usr.palm.applications.de.vivalv.software.shoppingmanagerdemo_0'''
* Beta version: '''.app-storage/file_.media.cryptofs.apps.usr.palm.applications.de.vivalv.software.shoppingmanagerbeta_0'''
 
If you uninstall the program, the data will be deleted by webOS.
 
==Versions==
There are 3 versions of Shopping Manager:
* Full version: Available in the [http://developer.palm.com/appredirect/?packageid=de.vivalv.software.shoppingmanager App Catalog]
* Demo version: Available in the [http://developer.palm.com/appredirect/?packageid=de.vivalv.software.shoppingmanagerdemo Web Distribution Channel]
* Beta version: Available at [http://admin.precentral.net/homebrew-apps/shopping-manager-beta PreCentral]
 
Those different versions can be installed side-by-side and do not share data. But you can copy data between the versions with the method mentioned above, if the target version number is at least as high as the source version number. You can also use the import/export feature of Shopping Manager, but with the same restrictions.
 
==Tips==
 
===Sending a list to another webOS device by Email===
If you want to send a list of needed items by Email to another person, who also owns a webOS device and has Shopping Manager installed, please follow these steps:
 
Sender:
* Menu->Database->Export->Needed Items
* Email
* enter the destination mail address and send the mail
 
Receiver:
* open the mail
* mark the items with the shift key (on the keyboard) and tap, so that all items are selected (yellow)
* Menu->Edit->Copy
* start Shopping Manager
* Menu->Database->Import
* Clipboard
* Menu->Edit->Paste
* Import
 
For doing the same with Google Docs, please see the Google Docs Tips section under Data Transfer View.
 
===Assigning a new shop to all or many items===
If you added a new shop and want to quickly assign it as alternative shop to lots of items, you can use the corresponding action. First, please make sure that all items are visible by not filtering for anything specific. Then choose '''Execute Action''' from the main menu and then '''Assign alternative shop''' in the first selector and the new shop in the second selector and tap on '''OK'''. In the following View, check all items, that should have the new shop as alternative shop and tap '''Execute'''. You can only assign the shops this way, but if you want to enter different prices or aisles, you have to do it in the Edit Item View (tap on the alternative shop there).
The same applies to adding a new virtual category to many items.
 
===Assigning all or many shops as alternative shops to a new item===
If you added a new item and want to quickly assign all or many shops as alternative shop to it, you can use the button '''Multi-Assign Alt. Shops''' in the Edit Item View. In the following View, check all shops, that should be an alternative shop for that item and tap '''Execute'''. You can only assign the shops this way, but if you want to enter different prices or aisles, you have to tap on the alternative shop in the list of alternative shops in the Edit Item View.
 
The same applies to adding many virtual categories to an item.
 
===Using coupons===
If you have a coupon for something, then you can enter the coupon as item, naming it for example "Milk (coupon). Then enter the value of the coupon as negative price. Optionally enable the coupon option for that item, so the coupon item will display the scissors icon in the list. While shopping, you will have the correct total price including coupon and you will have the coupon item as reminder to show the coupon at the cashier.
 
===Performance===
The time for loading a database and switching between All and Needed mode depends on the number of items in the database. Rendering of changes to the displayed items depends on the details that you have enabled for the items list. Go to the Preferences View to configure this. For example, you can switch off coupon and priority, if you don't need them.
 
==Privacy==
If the user allows it, the Google password will be saved unencrypted in a Cookie. A saved password can be deleted by removing the account. Encryption would not make sense without a master password. If you lose your Palm, a webOS expert could find out the saved password.


==Support==
==Support==
shoppingmanager(at)vivalv.de
shoppingmanager(at)vivalv.de


==Versions==
==History==
* 0.2.2: Published at http://www.precentral.net/
{{shoppingManagerHistory}}
** immediate feedback when tapping on an item
 
** new default colors
==Copyright==
** checking/unchecking an item is faster
Copyright (C) 2011 VivaLV Software
** export of needed items of the current shop
** preset current category for new item
** tap on the checkbox of a checked item in All mode marks it as not needed (default)
** aisle sorting numeric and alphanumeric
** displaying the have items in Needed mode can be switched off
* 0.2.1: Published at http://www.precentral.net/
** bug fix regarding setting quantity to 0 in Needed mode
* 0.2.0: Published at http://www.precentral.net/
** new item from Needed mode presets quantity to 1
** new item has current shop preset and is not being deleted for next new item
** quantity is not being deleted for next new item
** checkout button at the bottom (label: !)
** clear text filter when choosing an item
** faster scrolling
** new created shop/category has focus
** aisles
** notes (multi-line)
** option to not display needed items in All mode
** export
** delayed touch feedback on the item list
** colors configurable
** font sizes configurable
** sorting configurable
** items displayed a little bit more compact
** import uses current shop/category, if not All
** bug fixes
* 0.1.1: Published at http://www.precentral.net/
** bug fixes regarding new items and quantity
* 0.1.0: Published at http://www.precentral.net/
Thomas
1,504

edits

Retrieved from "http://software.vivalv.de/Special:MobileDiff/1649...3157"