Shoppingmanager/english: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Line 1: Line 1:
=Shopping Manager 1.0.0=
=Shopping Manager 1.0.0=
[[Image:shoppingmanager_en.png]]
[[Image:shoppingmanager_en_110.png]]




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


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


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


The item list can be configured to display more or less details, display text in different colors and font sizes, use complex sorting and more. You can filter the list by Shop, Category and search in the item names. The cost for your shopping tour is being calculated automatically.
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.
Line 17: Line 17:


==Basic Usage==
==Basic Usage==
# select the '''All''' mode
# select the '''All''' mode by tapping on the memo pad
# tap the ball on the left 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''' mode 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
# tap the '''!''' button for checkout
# tap the door button for checkout


==Modes==
==Modes==


===All mode===
===All mode (memo pad icon)===
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. 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 checked. This is the mode, which you use while shopping. The items are sorted first by category, then by name. The header info displays checked/visible items and the total price of the items that you have checked. 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==
Line 47: Line 47:
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 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 a quantity of 1.  


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


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


In the first line, you can see the name of the item and the needed quantity (if the item is needed). In the second line, you can see the Category and Shop the item belongs to and also the aisle (in []). 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 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. 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).


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 67: Line 67:
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 View (see below) in new item mode.


In the middle, there is a '''!''' button. 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. You can also do a checkout via the menu.
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 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.
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.png]]
[[Image:shoppingmanager_menu_en_110.png]]
===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 84:


====Import====
====Import====
Lets you import items from a text file. The requirement is that you have each item on a separate line like this:
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:
  Beer
  Apples;Fruit;Shop2;Kilogram;1.99;2;Only the red ones;3;false;false;3;false
  Juice
  Mineral water;Drinks;Shop1;Liter;0.49;6;;1;false;false;1;true
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.
Oranges;Fruit;Shop2;Kilogram;2.99;0;;3;false;false;4;false
Red wine;Drinks;Shop1;Liter;5.99;0;;2;false;false;2;false


Import will use the current Shop and/or Category for the added items.
The format is:
Name;Categoryname;Shopname;Unit;Price;Quantity;Note;Aisle;Tax1;Tax2;Priority;Coupon


To import items from HandyShopper (PalmOS), please follow these steps:
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"
 
'''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 in Shopping Manager. 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'''.
 
=====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
* export your HandyShopper list (items only, no optional fields, "-" as separator) to MemoPad
* do a HotSync
* do a HotSync
Line 95: Line 121:
* copy that file to your webOS device over USB
* copy that file to your webOS device over USB
* import the list into Shopping Manager (choose ISO encoding, if you used Notepad)
* 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====
====Export====
Lets you 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.
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.


===Reset Visible Items===
===Reset Visible Items===
Line 105: Line 134:
* Checked: Switches all visible and needed items to Checked 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.
You can also do a Checkout by tapping the '''!''' button on the bottom of the Main View.
 
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]]


===Preferences===
===Preferences===
Line 114: Line 145:
===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.


==Shops View==
==Shops View==
[[Image:shoppingmanager_shops_en.png]]
[[Image:shoppingmanager_shops_en_110.png]]


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


==Categories View==
==Categories View==
[[Image:shoppingmanager_categories_en.png]]
[[Image:shoppingmanager_categories_en_110.png]]


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


==Edit View==
==Edit View==
[[Image:shoppingmanager_edititem_en.png]]
[[Image:shoppingmanager_edititem_en_110.png]]


You get to the Edit View by tapping the '''+''' button on the Main View or the '''i''' symbol for an item and choosing '''Edit item'''.
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'''.
Line 134: Line 168:
* 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. If you use that, you can enter '''Piece''' or '''lbs''' for example. The default is '''Piece'''.
* Price: Price for one unit of the item.
* Price: Price for one unit of the item.
* Tax 1 applies: Tax 1 (defined in Preferences) applies for this item
* Tax 2 applies: Tax 2 (defined in Preferences) applies for this item
* Coupon: You have a coupon for this item.
* 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.
* 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 145: Line 183:
* 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.  
* in New mode, tapping on '''Done''' creates the new item and clears the fields (not quantity, Category and Shop), so you can quickly add another item.  


The standard back swipe brings you back to the Main View.
Tapping on '''Revert''' resets your changes in this item.
 
The standard back swipe alters or creates the item and brings you back to Main View.
 
==Number View==
[[Image:shoppingmanager_number_en_110.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 View. You can type in numbers by tapping on screen or by using the keyboard.


==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.  
===Tax===
[[Image:shoppingmanager_tax_en_110.png]]
You can enter two global Taxes in percent. Then, for each item, you can select in the Item View if one or both applies.


===Options===
===Options===
[[Image:shoppingmanager_options_en.png]]
[[Image:shoppingmanager_options_en_110.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 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.
* 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.
* 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.
* 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===
===Display for each entry===
[[Image:shoppingmanager_display_en_110.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:
* Priority
* Category
* Category
* Shop
* Shop
* Aisle
* Aisle
* Coupon
* Price info (Price, Unit, Total price)
* Price info (Price, Unit, Total price)
* Note
* Note


===Sorting in All mode/Needed mode===
===Sorting in All mode/Needed mode===
[[Image:shoppingmanager_sorting_en.png]]
[[Image:shoppingmanager_sorting_en_110.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 cn choose between:
Line 173: Line 230:
* Shop
* Shop
* Aisle
* Aisle
* Priority
* Price
* Note
* Unit


Also, you can enable or disable to moving of checked items below needed items. Please remember, that needed items are always displayed at the top.
Also, you can enable or disable displaying the needed items separate and the moving of checked items below needed items.


===Colors===
===Colors===
[[Image:shoppingmanager_colors_en.png]]
[[Image:shoppingmanager_colors_en_110.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:
Line 188: Line 249:


===Font Sizes===
===Font Sizes===
[[Image:shoppingmanager_fonts_en.png]]
[[Image:shoppingmanager_fonts_en_110.png]]


You can configure the size of the fonts for different parts of the item list:
You can configure the size of the fonts for different parts of the item list:
Line 217: Line 278:
* Beta version: Available at [http://admin.precentral.net/homebrew-apps/shopping-manager-beta PreCentral]
* 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.
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.


==Support==
==Support==
1,504

edits

Navigation menu