Ricardo SIGNES > App-Addex-Plugin-Hiveminder-0.004 > App::Addex::Plugin::Hiveminder



Annotate this POD

View/Report Bugs
Module Version: 0.004   Source   Latest Release: App-Addex-Plugin-Hiveminder-0.006


App::Addex::Plugin::Hiveminder - automatically add "to Hiveminder.com" addrs


version 0.004


Hiveminder (http://hiveminder.com) offers Pro customers the ability to assign tasks to anybody with an email address, even if they don't already use Hiveminder. With a Hiveminder Pro account, you get a "secret." Then, to assign a task to bob@example.com, you would send mail to bob@example.com.secret.with.hm.

This plugin makes every entry in your address book appear to have an extra email address that will send to the with.hm assignment address.


First, you have to add the plugin to your Addex configuration file's top section:

  plugin = App::Addex::Plugin::Hiveminder

Then you'll need to setup at least a "secret" variable, which is your assign-by-email secret from your Hiveminder Pro account.

  secret = closetdiscodancer

With that done, every Entry in your AddressBook will now have an additional EmailAddress. It will receive but not send, will be based on the email address of the Entry's default address, and will have the label "todo."

To use a label other than "todo" specify a value for todo_label in the plugin configuration.

To specify that an entry's task assignment address should be built on an address other than its default address, specify the label of the address to use in that entry's todos_to field. Alternately, if the todos_to begins and ends with a slash, it will be treated as a regex and matched against the entry's addresses.

So, by way of example, if an address has these addresses:

  - home : alfa@example.com
  - other: bravo@example.com
  - work : charlie@example.com

The todo address will be alfa@example.com.secret.with.hm. If todos_to were other, the todo address would be bravo@example.com.secret.with.hm. If todos_to were /charlie/, it would be c<charlie@example.com.secret.with.hm>.

If the entry had an address with the label "todo," no address will be inserted into the returned list. If the entry had an address with the label "todo-via" it will be used to form the todo address, and will be suppressed from output. This is useful if your contact uses a specific address only for his Hiveminder account, as the recipient of a with.hm request cannot accept the request to a different address.

If the entry has a "skip_hiveminder" field, this plugin will leave it alone.


Ricardo SIGNES, <rjbs@cpan.org>


Please report any bugs or feature requests through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


Copyright 2008 Ricardo Signes, all rights reserved.

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: