• View
• Edit
• History
• Print
• Login

Ubiquity

Ubiquity hacks for gtd-php and Firefox

Support for the Firefox addon Ubiquity has now been built into the AJAX addon within 0.9. It automatically works out where your installation is, and adds that information into the Ubiquity commands. Once the AJAX addon is active (from Configure > User Preferences > Addons), the ubiquity command-set will be available from the gtd-php front page (index.php)

gtdlist - list next actions, with the option of marking some complete

  gtdlist needle

will search for needle in the titles, description and outcomes of all your current next actions, and list them in the preview box. The title of each action and its parent will be clickable links to the item, as usual. And a checkbox will be provided so that you can mark the item complete right there from the preview box.

gtdna - create a next action

  gtdna action parent part of the parent name

for example

  gtdna join the gtd-php forum parent gtd

will list all of the projects that have "gtd" in the name. When you click on one of them, a next-action with the title "join the gtd-php forum" will be created for that project.

gtdin - create inbox item

The gtdin command creates an inbox item, for example:

  gtdin get hair cut

creates a new inbox item with title "get hair cut".

gtdref - create a reference

The gtdref command creates a reference with a weblink to the current page, and assigns it as the child of a specified project. For example, if you type

  gtdref gtd

then you will be shown a list of the top 5 projects that have the text "gtd" in the title. You then select one of those 5. That will create a new reference to the current page, as a child of that project. The title of the reference will be the title of the current page, and the description will contain an embedded link to the page. So, for example, if you issued the command on the gtd-php homepage, you'd create a reference:

title: GTD-PHP: Getting Things Done with PHP
description: webpage: <a href='http://www.gtd-php.com/'>GTD-PHP: Getting Things Done with PHP</a>

You can give the reference you create a different title, if you don't want to use the default:

  gtdref gtd title The GTDPHP wiki

would create a reference to www.gtd-php.com, and the reference would have title "The GTDPHP wiki".

Installation

1. install the Ubiquity addon into firefox
2. activate the AJAX addon in gtd-php Configure > User Preferences > Addons
3. Add the gtd-ubiquity commands to your list of subscribed commands - make sure you tick the Auto-update this feed box too
4. You should then be able to use the gtd-ubiquity commands anywhere. If your installation requires an authentication, then you'll need to do that before using the commands. You might need to do that each time you start the browser, depending on the type of authentication, your cookie settings, etc.

See the forum thread for background info.

You can view the source code for the ubiquity commands here on the SVN browser.

Remember, Ubiquity will treat some words as special words, and do clever stuff with them that you may or may not wish to happen:

  it, this, these