Net::Google::Calendar::Entry - entry class for Net::Google::Calendar


Net-Google-Calendar documentation  | view source Contained in the Net-Google-Calendar distribution.

Index


NAME

Top

Net::Google::Calendar::Entry - entry class for Net::Google::Calendar

SYNOPSIS

Top

    my $event = Net::Google::Calendar::Entry->new();
    $event->title('Party!');
    $event->content('P-A-R-T-Why? Because we GOTTA!');
    $event->location("My Flat, London, England");
    $event->status('confirmed'); 
    $event->transparency('opaque');
    $event->visibility('private'); 

    my $author = Net::Google::Calendar::Person->new;
    $author->name('Foo Bar');
    $author->email('foo@bar.com');
    $entry->author($author);







DESCRIPTION

Top

METHODS

Top

new

Create a new Event object

id [id]

Get or set the id.

title [title]

Get or set the title.

content [content]

Get or set the content.

author [author]

Get or set the author

transparency [transparency]

Get or set the transparency. Transparency should be one of

    opaque
    transparent

visibility [visibility]

Get or set the visibility. Visibility should be one of

    confidential
    default
    private
    public 

status [status]

Get or set the status. Status should be one of

    canceled
    confirmed
    tentative

is_allday

Get the allday flag.

Returns 1 of event is an All Day event, 0 if not, undef if it can't be determined.

extended_property [property]

Get or set an extended property

location [location]

Get or set the location

quick_add [bool]

Get or set whether this is a a quick add entry or not.

when [<start> <end> [allday]]

Get or set the start and end time as supplied as DateTime objects. End must be more than start.

You may optionally pass a paramter in designating if this is an all day event or not.

Returns two DateTime objects depicting the start and end and a flag noting whether it's an all day event.

reminder <method> <type> <when>

Sets a reminder on this entry.

method must be one of:

    alert email sms

type must be one of

    days hours minutes absoluteTime

If the type is absoluteTime then when should be either a iso formatted date string or a DateTime object.

who [Net::Google::Calendar::Person[s]]

Get or set the list of event invitees.

If no parameters are passed then it returns a list containing zero or more Net::Google::Calendar::Person objects.

If you pass in one or more Net::Google::Calendar::Person objects then they get set as the invitees.

comments [comment[s]]

Get or set Comments object.

edit_url

Return the edit url of this event.

self_url

Return the self url of this event.

html_url

Return the 'alternate' browser-friendly url of this event.

recurrence [ Data::ICal::Entry::Event ]

Get or set a recurrence for an entry - this is in the form of a Data::ICal::Entry::Event object.

Returns undef if there's no recurrence event

This will not work if Data::ICal is not installed and will return undef.

For example ...

    $event->title('Pay Day');
    $event->start(DateTime->now);

    my $recurrence = Data::ICal::Entry::Event->new();




    my $last_day_of_the_month = DateTime::Event::Recurrence->monthly( days => -1 );
    $recurrence->add_properties(
               dtstart   => DateTime::Format::ICal->format_datetime(DateTime->now),
               rrule     => DateTime::Format::ICal->format_recurrence($last_day_of_the_month),
    );

    $entry->recurrence($recurrence);

To get the recurrence back:

    print $entry->recurrence->a_string;

See

    http://code.google.com/apis/gdata/common-elements.html#gdRecurrence

For more details

TODO

Top

more complex content
more complex locations
recurrency
comments

See http://code.google.com/apis/gdata/common-elements.html for details

AUTHOR

Top

Simon Wistow <simon@thegestalt.org>

COPYRIGHT

Top

SEE ALSO

Top

http://code.google.com/apis/gdata/common-elements.html

Net::Google::Calendar

XML::Atom::Event


Net-Google-Calendar documentation  | view source Contained in the Net-Google-Calendar distribution.