Sandalfoot Shopper V1.0

© 2017 by Gary Chanson

All Rights Reserved

Overview

Features

Usage

Create a shopping list

Create a list of stores

Create a list of categories

Create a map

Start adding items

Start shopping

Databases

Shopping Lists

Categories

Stores

Item Details

Main Menu

Context Menu

Checkout

 Settings

Advanced Topics

 

Overview

Sandalfoot Shopper is a shopping list program modeled after the popular Handy Shopper program.

Features

Supports multiple individually customizable shopping lists.

Each shopping list supports unlimited lists of stores and categories.

Shopping lists can be viewed in Inventory Mode or Shopping Cart Mode.

Separate sort settings for each view mode.

Inventory Mode shows all items in the shopping list, typically sorted by description.

Shopping Cart Mode shows only items marked as Needed, typically sorted by store aisle.

Selecting a store filters the items shown to only those marked for that store.

Selecting a category filters the items shown to only those in that category.

Items can be flagged as taxable, coupon, and auto delete and can be dated.

Each view mode can be customize to show only selected columns.

User configurable font and row sizes.

Unlimited Undo and Redo.

Back To Top

Usage

Create a shopping list.  There is no limit on the number of shopping lists.  Each shopping list has its own settings and its own lists of stores and categories.

Create a list of stores in this shopping list.  There is no limit on the number of stores.  The list of stores is specific to each shopping list.

Create a list of categories in this shopping list.  There is no limit on the number of categories .  The list of categories is specific to each shopping list.

Create a map for each store.  Enter an aisle name for each category.  This will set the default aisle for all items in each category.  Assigning an aisle to individual items over-rides the default for those items.  Categories can also be added from within the store map dialog.

Note that categories, stores, and store maps are optional and can be left empty in simple shopping lists which don't need to use them.

Start adding items to the shopping list (see Shopping Lists).  New items are automatically marked as "needed" with the quantity set to "1" and priority set to "3".  All other fields start out blank.

Start shopping.  Select Shopping Cart Mode and select the store you are shopping in.  In this mode, items are displayed in aisle order (if possible).  As you pick up items, press the checkbox for the item to check it off.  When you finish shopping, open the main menu and select "Checkout".  This will set all checked off items as "Not Needed" and display the total cost of the items (if prices have been entered for the items).

Databases

To see a list of databases, press Lists.  This page is automatically displayed when no shopping list is open.

Databases

Press New to create a new shopping list.

Select a shopping list and press Opento open it.  You can also press Rename to change the name of the shopping list or Delete to delete it.

Press Close to return to the previously open shopping list.

Long-press on a shopping list to display a menu which also supports import and export of database files.

Back To Top

Shopping Lists

The shopping list has a heading which shows the name current shopping list, the currently selected store and the currently selected category.

Press the store title to select a store or to manage the list of stores.

Press the category title to select a category or to manage categories.

The shopping list is displayed in two different modes, Inventory Mode, and Shopping Cart Mode.

Press Inventory Mode to select Inventory Mode.  In Inventory Mode, all items in the shopping list are shown, sorted by description by default.  Items which are selected as "needed" are shown with a square checkbox in the first column.  All other items are shown with a circle in the first column.  Press this icon to change the item's state between "needed" and "not needed".

Shopping List

Press Shopping Cart to select Shopping Cart Mode.  In Shopping Cart Mode, only items marked as "needed" are shown, sorted by aisle by default.  Items are shown with an empty checkbox.  Pressing this checkbox marks the item as "bought".

Shopping List

At the bottom of each list, an information toolbar is shown which shows additional information about the list.  By default, Inventory Mode shows the item toolbar which shows the most important fields of the currently selected item, and Shopping Cart Mode shows the shopping cart toolbar which shows total counts and prices for items.  Either toolbar (or none) can be shown in either mode.

Press the heading of any column to sort the list by this column.  Pressing it a second time reverses the sort order.  See Settings for more sorting options.

Press Details to change a shopping list item (see "Item Details").

Press New to create a new shopping list item.  The New Item Dialog is the same as Item Details).

Press Undo to undo changes and Redo to redo them.  Undo and redo support multiple operations.

Long-press on a shopping list item for a menu with more choices, including import and export of items.

Back To Top

Categories

The current category is shown in the list heading.  It typically starts out as "All Categories".  Pressing this field shows a list of all of the categories defined in the current shopping list, along with "All Categories' and "[Manage Categories]".  Selecting a category filters the visible items to the ones assigned to that category.

 

Categories

To add or change the list of categories, press the categories field and select "[Manage Categories]".

Categories

Press New to add a new category.

Select an existing category and press RenameDelete, or Delete to rename, copy or delete it.  Press the up or down arrows to move it to a different position in the list.

Back To Top

Stores

The current store is shown in the list heading.  It typically starts out as "All Stores".  Pressing this field shows a list of all of the stores defined in the current shopping list, along with "All Stores' and "[Manage Stores]".  Selecting a store filters the visible items to the ones marked for that store.

 

Dtores

To add or change the list of stores, press the stores field and select "[Manage Stores]".

Dtores

Press New to add a new store .

Select an existing store and press RenameDelete, or Delete to rename, copy or delete it.  Press the up or down arrows to move it to a different position in the list.

Select an existing store and press New to edit the map for this store.  The store map lists all of the categories and the default aisle for each.  This aisle will be shown for all items assigned to that category when this store is selected.  You can also assign a different aisle for any item (see "Item Details").  Aisles can be any name or number of combination of the two.  Press New to add a new category.

Store Map

Back To Top

Item Details

Select an item and press Details to change the properties of a shopping list item.

The "Item" tab shows the item description, priority level, quantity, date, and check boxes for taxable, coupon, and auto delete.  If auto delete is checked, the item will be removed from the list during checkout when the item is bought.

Details

The "Note" tab shows text about this item.

Details - Note

The "Stores" tab shows a list of all stores, with a check box, an aisle, and a price, for each store.  If the check box for a store is checked, this item will be shown when this store is selected.  If an aisle is entered for a store, this aisle will be shown for this item instead of the aisle from the store map.  If a price is entered, this price will be used when calculating costs.

Details - Stores

Press the up or down arrows (at the bottom of the screen) to go to the next or previous item in the shopping list.

Back To Top

Main Menu

Press Details in the heading to open the main menu.

Main Menu

Main Menu

Main Menu

Back To Top

Context Menu

Long-press on an item in the shopping list to open the context menu for the item.

Main Menu

Back To Top

Checkout

Select "Checkout" from the main menu to complete shopping.  Checkout will show the total amount spent (only if items have prices assigned) and will clear all items marked as "bought" to "not needed".

Back To Top

Settings

Select "Settings" from the main menu to customize the settings for this shopping list.

The "View" tab shows settings for the name of the shopping list and what and how to display items in Inventory and Shopping Cart modes.

Settings - View

The "Columns" tab shows settings for what columns to show (in the current mode) and settings for column sizes.

Settings - Columns

The "Sort" tab shows settings for sorting in each mode.  Three levels of sorting are supported (items which sort equally in one level are sorted by the next level).  Pressing a column heading in the shopping list will add another temporary level above these.  When "Learn your shopping order" is enabled, an arbitrary aisle number will be assigned to any items no aisle based on the order it is checked off.

Settings - Sort

The "Theme" tab shows settings for font sizes and line spacing.

Settings - Theme

The "Locale" tab shows settings for currency and tax rate.

Settings - Locale

Back To Top

Advanced Topics

Sandalfoot Shopper stores its shopping list databases in the internal emulated sdcard (/storage/emulated/0/Sandalfoot Shopper) so that they are easily accessible to the user and to other programs.  This makes it easy to back them up or synchronize them with another device.

Shopping list database files are named "<database>.sfd".  When Sandalfoot Shopper deletes a database, it does not remove the file.  It changes its name to "<database>.sfd.removed".  Rename it back to its original name to restore it.

Back To Top