=== Agenda ===
Contributors: dgmike
Donate link: http://www.dgmike.com.br
Tags: events,post,manipulate,date
Requires at least: 2.5
Tested up to: 2.5
Stable tag: 1.5

Creates events posts for your wordpress.

== Description ==

Now you can create events for your wordpress. Whit this plugin you can create and manipulate events like
you do on Google Calendar.

== Installation ==

1. Unzip `events` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. You can configure the category in your Settings.
1. Automaticaly you will see new options in Write and Manage sessions of your wordpress admin.

You can also use function `agenda_compromissos()`, `agenda_list()` and `agenda_events()` on your templates. These functions
generate html codes to be used on your tamplate.
 
== Usage ==

= Agenda list =

`agenta_list()` can be used in your sidebar generating a hightlighted next events list.

Params: `agenda_list ($next, $only_destak, $show_date, $before, $after, $print)`

1. `$next` defines de quantity of next events that are going to be showed. Default: 5
1. `$only_destak` if matched  as `true` shows only hightlighted events, if it is not matched it shows all events (hightlighted events are marked as strong). Default: `true`.
1. `$show_date` if matched  as `true` shows each date events. Default: `true`
1. `$before` and `$after` elements that are going to be written before and after each event. Default: `<li>` e `</li>`
1. `$print` if matched as `true` prints the result, if it is not matched only returns the string for future manipulations. Default: `true`

So for use the `agenda_list ()` prints a list contain the next 5 events.

Using `agenda_list(7, true)` prints only the next 7 hightlighted events, while `agenda_list(7, false)` prints
all the 7 next events (highlighted or not)

`agenda_list(15, true, true)`

prints each event whith they're respectives dates.

`agenda_list(15, true, false)`

prints all event whith not date.

= Agenda compromissos =

agenda_compromissos()` can be used on your tamplate's page.
It generates a events list separated by date.
 
Params: `agenda_compromissos ($next, $title_tag, $print)`:

1. `$next` Number of events that must be showed.default: 25
1. `$title_tag` show date tag's name . defaut: `h3`
1. `$print` if matched as `true` prints the result, if it is not matched only returns the string for future manipulations.

= Agenda Events =

`agenda_events()` can be used in your page, listing the events in a year or month.

Examples:

Default usage:

`$defaults = array(
  'month' => date('m'),
  'year' => date('Y'),
  'title_tag' => 'h3',
  'print' => '1'
);` 

Parameters:

month - if passed, selects a month to show
year - selects a yea to show
title_tag - the tag to be used on your title/date tag
print - prints the result.

=== Show only events on may 2009 ===

`<?php agenda_events('month=5&year=2009') ?>`

The following example shows only events that matches may of 2009.

=== Show only events on 2008 ===

`<?php agenda_events('month=false&year=2008') ?>`

The following example shows only events that matches in all 2008.

=== Changing the tag of date events ===

`<?php agenda_events('title_tag=h5') ?>`

The following example show events that matches the curent month, changing the tag of title/date by h5.
The output will be:

`
<div class="event_even">
  <h5>09-12-2008</h5>
  <ul>
    <li><a href="http://ldg/?p=12" title="Evento simples">Evento simples</a></li>
    <li><a href="http://ldg/?p=18" title="Event single">Event single</a></li>
    <li><a href="http://ldg/?p=23" title="Multiple Event">Multiple Event</a></li>
  </ul>
</div>
<div class="event_odd">
  <h5>11-12-2008</h5>
  <ul>
    <li><a href="http://ldg/?p=22" title="Algo así es muy simples">Algo así es muy simples</a></li>
    <li><a href="http://ldg/?p=18" title="Event single">Event single</a></li>
    <li><a href="http://ldg/?p=28" title="DGmike gones home">DGmike gones home</a></li>
  </ul>
</div>
`

Note that the function generates a even odd class of each day of events

== Screenshots ==

1. Create new Event screen
2. An event filled
3. List of events on manipulate events
4. Requesting a delete event