Document Actions

The to-dos list screen

by TooDo last modified 2009-01-26 10:10

We describe how the to-dos list screen works. Screen shots and illustrations are to come.

This documentation refers to TooDo v2.3.6.

This screen is the mostly used screen: it shows all your to-dos through a scrollable list.

Sorting

The displayed to-dos are sorted with the following strategy, which can be customized via the "Settings" screen, with the "Sort by due date?" check-box. If this box is checked, the sorting is done according this strategy:

  1. by importance: the to-dos with the greater importance are displayed first;
  2. chronologically by due date, the to-dos with no due date being positionned at the end. This is the second criterion, which enables to sort to-dos with the same importance;
  3. by remind date as a third criterion, which enables to sort to-dos with the same importance and due date.

If the box is left unchecked, the strategy is the same as in RTM, i.e. the 1 and 2 steps are swapped.

Anatomy of a to-do detail

If you need to view additional detail regarding a to-do, you need to click on it: in that case, a to-do screen is displayed. But you can already have some detail about a to-do from the to-dos list screen.

The icons and images

Some icons are shown for each to-do:

  • the left coloured rubber is the to-do importance, and you can rely on its color:
    • blue means low
    • green means normal
    • orange means important
    • red means paramount
  • the big icon next to the to-do title explains the status of the to-do:
    • the green check mark means that the to-do has been marked as completed
    • the red cross means that the to-do is overdue (its due date is past, thus it has a due date) and it has not been completed yet
    • the blue interrogation mark means that the to-do has not been marked completed yet (with a due date attached or not)
  • right to the previous status icons, you can see various icons:
    • the reminder icon, an alarm clock: will be displayed if the to-do has a time reminder
    • the decription icon, three yellow dots: will be displayed if the to-do has some description
    • the notes icon, a scracthpad: will be displayed if the to-dos has some notes
    • the conditions icon, a bell: will be displayed if the to-do has some contextual or geographical notification condition
    • the action icon, a "play" icon: will be displayed if the to-do has some URL action
    • the source of the to-do: the icons explains where the to-do was created from:
      • the TooDo logo means that the to-do was created from the ToodDo application
      • the RTM logo (the cow) means that the to-do has been imported from Remember The Milk
      • the Toodledo logo (the one with a checked box) means that the to-do has been imported from the Toodledo service

The three lines of text

  1. the first line in big bold white font is the title of the to-do
  2. the second line contains a blue box which the category name of the to-do, and a pink box which is the context the to-do is attached to
  3. the third line in big bold magenta font is the human friendly due date of the to-do: instead of displaying a concrete precise due date and time, it displays a message such as "In a week"

Actions

You do not necessarily to enter the to-do view screen in order to perform actions from the to-dos list screen: all the actions are also available when you select a to-do via the up/down navigation buttons and the trackball. Once selected (highlighted), if you press the trackball for a few seconds, or if you long-click on an item, the list of actions is displayed via contextual menu. Plus, there are shortcuts for each action (see the tip associated to each action in the contextual menu). The available actions are:

  • Edit: you enter the to-do edition screen
  • Delete: a confirmation dialog box is displayed, in order to make sure that this is what you want to
  • Notes: you are redirected to the to-do associated notes screen
  • Conditions: you are redirected to the to-do associated notification condtions
  • Complete: this marks the to-do as completed with a completion date set to the current time. You can also mark the to-do as completed, by just swiping it horizontally: a vibration is issued then
  • Launch action: if the to-do URL action is not empty and that it starts with either "tel:", "sms:", "http:", then you can execute that action

Filtering

Any time, you can filter the displayed to-dos on the list. The filtering detail is shown by pressing the "Filter" menu entry. The filtering control displays several criteria:

  • Status: three status icons are displayed. Those statuses are "completed", "not completed" and "overdue". In order to activate a filter, just click an icon: when greyed, the to-dos with the same status as the icon representation are removed from the display. This is handy, because it enables, for instance, to hide the already completed to-dos
  • Importance: you can restrict the displayed to-dos according to their importance. When set to "Low", this filter will not applied. Otherwise, all to-dos that have an importance less than the one chosen will not be displayed
  • Due date by: you can restrict the displayed to-dos according to their due date. "Any" means that the criterion is not taken into account
  • Created: you can indicate a maximum time span, and when set all to-dos that have a creation earlier than this timespan will not be displayed. When set to "Any", the criterion will not apply

In the bottom bar, on the right-most, a "i/N" text is displayed: the "i" stands for the number of to-dos currently displayed, the "N" stands for the total number of to-dos currently available in TooDo. If i is different from N, it means that some filtering is active.

In "lite" mode, note that the filtering criteria are automatically saved for you. In standard mode, just edit the smart folder that has been used for displaying the to-dos list screen.

Searching and creating

  • Search text: when the to-dos list has the current focus, if you start typing some text with the keyboad. This text will be used to restrict the currently displayed to-dos. TooDo will search through all text textual information associated with the to-do (in the title, description, notes, URL...) and will only display the matching to-do. In order to disable the search, delete the text that you have typed, or just press the Android "back" button. This feature is very handy when you think of a to-do and you want to quickly find it via a keyword search
  • Creation: the "Add" menu entry enables to create a new to-do. When you hit that entry, the to-do edition screen is displayed

The menu

When the device menu button is clicked, a menu is displayed, and proposes actions to switch to all the other available screens.