Shoppingmanager/english: Difference between revisions

Jump to navigation Jump to search
m
No edit summary
 
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Shopping Manager 2.0.1=
=Shopping Manager 2.6.5=
[[Image:shoppingmanager_en_110.png]]
 
[[Image:HotApps.png]]
 
[[Image:shoppingmanager_en_240.png]][[Image:shoppingmanager_dark_en_240.png]]


__NOTITLE__
__NOTITLE__
Line 6: Line 9:


==Description==
==Description==
This program helps you to manage your shopping list. It is easy to use (even with one hand) but very powerful. You enter items only once (automatically growing a complete list of your recurring shopping items). They can be reused each time you plan your shopping tour with just a simple tap. While shopping, another simple tap checks the item that 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.
Inspired by the HandyShopper concept, this App truly simplifies and enhances your shopping experience.  


You can define shops and categories to choose from for your items. You can also assign alternative (multiple) shops and virtual categories (like templates) to the items. Each item has the properties name, quantity, standard quantity, unit, price, aisle, notes, tax, priority and coupon.
Easy to use (even with one hand), yet very powerful and flexible:


Items can be imported from text files (.csv) or clipboard and exported to the clipboard or as Email. You can also send a nice list by Email or SMS.
One tap - marked as needed, another tap - marked as have - checkout when finished.  


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.
<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


You can define as many databases as you wish and easily switch between them and copy/move items to other databases.
You can set name, quantity, standard quantity, unit, price, aisle, notes, tax, priority, coupon, planned date, auto-delete and image for each item.
 
If you know Handyshopper on PalmOS, you should have no problems using Shopping Manager for webOS.


==Basic Usage==
==Basic Usage==
Line 25: Line 39:
# pay
# pay
# tap the door button for checkout
# 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==
Line 60: Line 81:
If you tap on the checkbox of an item in '''All''' mode, it will be reset back to '''default'''.
If you tap on the checkbox of an item in '''All''' mode, it will be reset back to '''default'''.


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), quickly set a quantity between 0 and 9 or a custom quantity (which opens a dialog for entering) and copy or move an item. Setting a quantity of 0  automatically switches the item to '''default'''. Setting a quantity of greater than 0, switches the item to '''needed'''.
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. 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 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.
Line 76: Line 106:


==Menus==
==Menus==
[[Image:shoppingmanager_menu_en_120.png]]
[[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===
This is the standard webOS edit menu for handling the clipboard.
This is the standard webOS edit menu for handling the clipboard.
Line 82: Line 123:
===Database===
===Database===


====DB: Name====
====Manage====
This shows you the current database and tapping on it takes you to the Databases View (see below).
This takes you to the Databases View (see below).
 
====Import====
Import always works on the current database. 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;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 or 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 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:'''
====Select====
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 in Shopping Manager. Then you select file and the encoding (ISO or UTF-8) and choose the file.
Here you can see, what the current database is (has a checkmark) and quickly switch to another.
 
'''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'''.


=====Import from Handyshopper=====
====Data Transfer====
To import items from Handyshopper (PalmOS), you have 2 possibilities: Items only or most fields.
This takes you to the Data Transfer View (see below).
 
'''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 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.
 
Alternative shops and virtual categories are being exported as lines with most fields empty. Only shop, price and aisle or category are bring written.


===Execute Action===
===Execute Action===
[[Image:shoppingmanager_action1_en_120.png]][[Image:shoppingmanager_action2_en_120.png]]
[[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 '''Exec''' to execute. See also the chapter on the Pick Items View.
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.
Most actions do have a second option named '''choice''', where you can further configure the action.
Line 172: Line 170:


For Email, the columns for the list can be selected in the following screen. For SMS, it's always name and quantity per item.
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]]
[[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 197: Line 203:


You can assign virtual categories to an item in the Edit Item View and Virtual Category View or with the corresponding Action.
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==
Line 209: Line 249:


==Edit Item View==
==Edit Item View==
[[Image:shoppingmanager_edititem_en_120.png]][[Image:shoppingmanager_edititem2_en_120.png]]
[[Image:shoppingmanager_edititem_en_220.png]][[Image:shoppingmanager_edititem2_en_230.png]][[Image:shoppingmanager_edititem2a_en_230.png]][[Image:shoppingmanager_edititem3_en_210.png]]
[[Image:shoppingmanager_edititem3_en_120.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'''.
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'''.
Line 216: Line 255:
* 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.
* Standard quantity: This is the initial quantity for the item when you tap on the ball in the Main View.
* Standard quantity: This is the initial quantity for the item when you tap on the ball in the Main View.
Line 222: Line 261:
* Tax 2 applies: Tax 2 (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.
* 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.
* Aisle: The aisle, where you find the item in the shop.
* Note: Additional info text, that you want to enter (multi-line).
* 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.
* 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'''.
* Category: Category, in which the item belongs, for example '''Fruit'''.
* Shop: Shop, where you intend to buy the item.
* Shop: Shop, where you intend to buy the item.
Line 239: Line 282:


The standard back swipe alters or creates the item and brings you back to Main View.
The standard back swipe alters or creates the item and brings you back to 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==
==Number View==
Line 275: Line 324:


==Databases View==
==Databases View==
[[Image:shoppingmanager_databases_en_120.png]]
[[Image:shoppingmanager_databases_en_210.png]]


You get to the Databases View by selecting the '''DB: Name''' 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 is green.
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 a database or clear it, which means deleting all items, shops and categories (so please be careful with that).
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.
Swipe a database to the left or right to delete the entire database. You cannot delete the '''Standard''' database.
Line 286: Line 340:


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.
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.  
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===
===Tax===
[[Image:shoppingmanager_tax_en_110.png]]
[[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.
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===
===Options===
[[Image:shoppingmanager_options1_en_111.png]][[Image:shoppingmanager_options2_en_120.png]]
[[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.
* 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 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.
Line 305: Line 487:
* Name wraps: If on, long item names are being wrapped to use more than one line.
* 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.
* 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.
* 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
* Quantity decimals: Number of decimal places to be displayed for the quantity


===Display for each entry===
===Item details (display for each item)===
[[Image:shoppingmanager_display_en_110.png]]
[[Image:shoppingmanager_display_en_220.png]]


Here you can switch on or off, what information to display for each entry in the item list:
Here you can switch on or off, what information to display for each entry in the item list:
Line 321: Line 509:


===Sorting in All mode/Needed mode===
===Sorting in All mode/Needed mode===
[[Image:shoppingmanager_sorting_en_110.png]]
[[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 cn choose between:
Here you can define, what sorting criteria should be used first and following for the All and Needed mode. You can choose between:
* Name
* Name
* category
* Category
* shop
* Shop
* Aisle
* Aisle
* Priority
* Priority
Line 334: Line 522:


Also, you can enable or disable displaying the needed items separate and the moving of checked items below needed items.
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===
===Colors===
[[Image:shoppingmanager_colors_en_110.png]]
[[Image:shoppingmanager_colors_en_224.png]]


You can choose between various colors for displaying the different parts of the item list:
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 (Default): The name of items in Default state
* Name (Needed): The name of items in Needed state
* Name (Needed): The name of items in Needed state
Line 380: Line 578:
==Tips==
==Tips==


===Sending a list to another webOS device===
===Sending a list to another webOS device by Email===
If you want to send a list of needed items to another person, who also owns a webOS device and has Shopping Manager installed, please follow these steps:
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:
Sender:
Line 397: Line 595:
* Menu->Edit->Paste
* Menu->Edit->Paste
* Import
* 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===
===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.
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==
Line 406: Line 622:
==History==
==History==
{{shoppingManagerHistory}}
{{shoppingManagerHistory}}
==Copyright==
Copyright (C) 2011 VivaLV Software
1,504

edits

Navigation menu