Shoppingmanager/english: Difference between revisions

From VivaLV-Software
Jump to navigation Jump to search
Line 1: Line 1:
=Shopping Manager=
=Shopping Manager 1.0.0=
[[Image:shoppingmanager_en.png]]
[[Image:shoppingmanager_en.png]]



Revision as of 19:58, 9 February 2010

Shopping Manager 1.0.0

File:Shoppingmanager en.png


Description

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.

Items can be imported from text files and exported to the clipboard or as email or SMS.

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

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

Basic Usage

  1. select the All mode
  2. tap the ball on the left of needed items or create new items with the + button
  3. select the Needed mode and go shopping
  4. tap on items that you put in your cart
  5. pay
  6. tap the ! button for checkout

Modes

All mode

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.

Needed mode

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.

Searching/Filtering

You can quickly find a specific item, by filtering the list by

  • Shop (upper left selector)
  • Category (upper right selector)
  • Item Name (just type some letters on the keyboard)

This works in both modes (All/Needed).

Main View

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

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.

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.

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.

If you tap on the checkbox of a checked 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.

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

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

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

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.

Menus

File:Shoppingmanager menu en.png

Edit

This is the standard webOS edit menu for handling the clipboard.

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:

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

Import will use the current Shop and/or Category for the added items.

To import items from HandyShopper (PalmOS), please follow these steps:

  • 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)

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.

Reset Visible Items

With this menu, you can change all items, that are currently visible to a different state.

  • Default: Switches all visible items to Default state
  • Need: Switches all visible and not needed items to Need state
  • Checked: Switches all visible and needed items to Checked state

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 by tapping the ! button on the bottom of the Main View.

Preferences

This opens the Preferences View (see below).

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.

Shops View

File:Shoppingmanager shops en.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.

Categories View

File:Shoppingmanager categories en.png

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

Edit View

File:Shoppingmanager edititem en.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. The following information is editable for an 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.
  • 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.
  • Aisle: The aisle, where you find the item in the Shop.
  • Note: Additional info text, that you want to enter (multi-line).
  • Category: Category, in which the item belongs, for example Fruit.
  • Shop: Shop, where you intend to buy the item.

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

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

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

The standard back swipe brings you back to the Main View.

Preferences

The Preferences View can be reached by choosing the corresponding menu entry.

Options

File:Shoppingmanager options en.png

  • 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.
  • Quantity decimals: Number of decimal places to be displayed for the quantity

Display for each entry

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

  • Category
  • Shop
  • Aisle
  • Price info (Price, Unit, Total price)
  • Note

Sorting in All mode/Needed mode

File:Shoppingmanager sorting en.png

Here you can define, what sorting criteria should be used first and following for the All and Needed mode. You cn choose between:

  • Name
  • Category
  • Shop
  • Aisle

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.

Colors

File:Shoppingmanager colors en.png

You can choose between various colors for displaying the different parts of the item list:

  • 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

File:Shoppingmanager fonts en.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

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:

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.

Support

shoppingmanager(at)vivalv.de

History

  • 2.6.5: Published in the Palm App Catalog (2011-10-11)
    • bugfix for TouchPad
  • 2.6.4: Published in the Palm App Catalog (2011-10-03)
    • bugfix for Google export, comma in numeric fields
  • 2.6.3: Published in the Palm App Catalog (2011-09-28)
    • bugfix for Google import
  • 2.6.2: Published in the Palm App Catalog (2011-09-07)
    • support for TouchPad, Pre 3
  • 2.5.2: Published in the Palm App Catalog (2011-06-14)
    • dark default
    • bug fix
  • 2.5.1: Published in the Palm App Catalog (2011-05-03)
    • bug fix
  • 2.5.0: Published in the Palm App Catalog (2011-04-29)
    • Just Type integration
    • keyboard shortcuts (D, M, T, N, B, P, H)
  • 2.4.2: Published in the Palm App Catalog (2011-03-11)
    • bug fix
  • 2.4.1: Published in the Palm App Catalog (2011-03-10)
    • option to remove info button
    • custom quantity at top of popup menu
    • dialog color with dark theme
  • 2.4.0: Published in the Palm App Catalog (2011-01-21)
    • optional vibration when tapping on an item
    • send/export checked items
    • info button
    • bug fixes
  • 2.3.5: Published in the Palm App Catalog (2010-12-02)
    • bug fixes and optimizations
  • 2.3.4: Published in the Palm App Catalog (2010-11-16)
    • bug fixes for Google import
  • 2.3.3: Published in the Palm App Catalog (2010-11-12)
    • bug fixes
  • 2.3.2: Published in the Palm App Catalog (2010-10-07)
    • option to clear coupon at checkout
    • bug fixes
  • 2.3.1: Published in the Palm App Catalog (2010-09-21)
    • minor changes
  • 2.3.0: Published in the Palm App Catalog (2010-09-14)
    • item image
    • last purchase date
    • planned purchase (with reminder)
    • delete item after checkout
    • create launcher icon for database
    • scaling of background image
    • bug fixes
  • 2.2.4: Published in the Palm App Catalog (2010-07-27)
    • styling of the background
    • base price or alternative price of 0 means not set
    • bug fixes
  • 2.2.3: Published in the Palm App Catalog (2010-07-09)
    • bug fixes regarding Google import, showing edited items and checkout
  • 2.2.2: Published in the Palm App Catalog (2010-07-01)
    • option to search in notes
    • bug fixes
  • 2.2.1: Published in the Palm App Catalog (2010-06-23)
    • high-price indicator
    • bug fixes
  • 2.2.0: Published in the Palm App Catalog (2010-06-17)
    • Google Docs integration
    • Best Buy
    • unit price
    • units list
    • automatic update check
    • bug fixes
  • 2.1.2: Published in the Palm App Catalog (2010-05-12)
    • enhanced database integrity
    • bug fixes
  • 2.1.0: Published in the Palm App Catalog (2010-05-04)
    • light and dark theme switchable
    • more colors for text
    • multi-assign of shops/categories in EditItem View
    • color-indicator for databases
    • database-switch in main menu
    • no resorting during switch between all/needed for same sort criteria
    • enhanced stability and error reporting
    • feedback button
    • bug fixes
  • 2.0.1: Published in the Palm App Catalog (2010-04-15)
    • bug fixes
  • 2.0.0: Published in the Palm App Catalog (2010-04-13)
    • multiple databases
    • alternative shops (multiple shops per item)
    • virtual categories (multiple categories per item, can be used as templates)
    • actions (assign, change, copy, move, delete with multiple items)
    • standard quantity
    • check-sensitivity configurable (complete row, left third, checkbox only)
    • correct sorting of all foreign language characters
    • comma works with NumLock
    • correct sorting by category after changing an item
    • auto-wrap of notes
    • import only allows text files
    • export more robust
    • possibility to repair a corrupt items table
    • remove CR from item names when reading from database
    • EditItem and Prefs screens rendering better with webOS 1.4
    • bug fixes
  • 1.1.2: Published in the Palm App Catalog (2010-04-01)
  • 1.1.2: Published in the Palm App Catalog (US) (2010-03-31)
    • small bug fix
  • 1.1.1: Published in the Palm App Catalog (US) (2010-02-23)
    • tax can be a decimal number
    • option for wrapping of long item names
    • option to not delete the filter on selection
    • allow negative prices
  • 1.1.0: Published in the Palm App Catalog (US) (2010-02-10)
    • new button look in Main View
    • undo button in Main View
    • complete import and export with all item details, configurable separator, Excel compatible
    • import from clipboard
    • sending of shopping list by email
    • new item attributes: Tax 1, Tax 2, Priority, Coupon
    • on-screen keyboard for entering custom quantity
    • on-screen keyboard for Edit View (quantity, price) on 2nd tap on field
    • send list uses sorting from prefs
    • option for multi-line name field
    • more sorting options
    • revert button in Edit View
    • gesture + tap on item edits the item
    • tap on title statistic in Needed mode switches between 2 types
    • show needed separate as option
    • keep display on in Needed mode as option
    • tap on checkbox or item in All mode does not check the item
    • always show checked items in All mode
    • immediate feedback when tapping ball, checkbox or item
    • always save everything when doing back or quit
    • sort shops and categories also in their Views
    • easier tapping of ball, checkbox, info
    • bug fixes
  • 1.0.0: Published in the Palm App Catalog (US) (2010-01-08)
  • 0.2.6: Published at http://www.precentral.net/ (2010-01-06)