Plugin All-in-One Calendar Flexible Event List

General

The plugin bases on All-in-One Event Calendar by Timely Plugin. You can select events more flexible than with All-in-One Event Calendar by Timely Plugin itself. Because of technical reasons the designs of All-in-One Event Calendar by Timely cannot be used.

The plugin needs a modification of the All-in-One Event Calendar by Timely Plugin, because it adds a new view for the shortcode of the All-in-One Event Calendar by Timely Plugin.

The usage and the interface is rather technical, you have to know about using your own CSS-Styles and some other things. In return you can display events very flexible.

Shortcode

The shortcode to embed a list of events is[ai1ec view="list"]. The list of events is enclosed with <div class="ai1ec_fel">...</div>. Every event is enclosed with <div class="ai1ec_fel_row">...</div>.
You can specify the following attributes:

class

Specifies another CSS-class for the event list. This is useful to specify different CSS-style for different event lists, for example
[ai1ec view="list" class="this_specific_event_list"]
results in
<div class="ai1ec_fel this_specific_event_list">…</div>

start

You can specify a valid PHP date and time format.
Default is: -100 year

end

You can specify a valid PHP date and time format.
Default is because of the year 2038 problem: 31.12.2037 23:59:59

sort

Defines the sort order of the start of the events. Default is  asc for ascending, descending order is specified by desc.

cat_id

You can specify the ids of the categories in the same way as in the  [ai1ec] shortcode.

tag_id

You can specify the ids of the tags in the same way as in the  [ai1ec] shortcode.

post_id

You can specify the ids of the posts in the same way as in the  [ai1ec] shortcode.

props

Here you specify the properties of the events to be displayed. You can use the following properties:

  • date and time properties of the event:
    • end: end date and time
    • start: start date and time
  • other properties of the event:
    • post_id: id of the corresponding post
    • allday: if the event is an all-day event
    • instant_event: if the event has no end time
    • recurrence_rules
    • exception_rules
    • recurrence_dates
    • exception_dates
    • venue: the location of the event
    • country: the country of the location of the event
    • address: the address of location of the event
    • address_d: the address of location of the event, a trailing ‘ , Deutschland‘ removed
    • city: the city of the location of the event
    • province: the province of the location of the event
    • postal_code: the postal_code of location of the event
    • show_map: if the flag to show google map is set
    • show_coordinates
    • longitude
    • latitude
    • facebook_eid
    • facebook_user
    • facebook_status
    • contact_name
    • contact_phone
    • contact_email
    • contact_url
    • cost: the cost information of the event
    • ticket_url
    • ical_feed_url
    • ical_source_url
    • ical_organizer
    • ical_contact
    • ical_uid
    • tags: the  tags of the event
    • categories: the categories of the event
    • feed
  • properties of the posts (every event is also a post):
    • author (post->post_…)
    • content (post->post_…)
    • content_filtered (post->post_…)
    • date (post->post_…)
    • date_gmt (post->post_…)
    • excerpt (post->post_…)
    • modified (post->post_…)
    • modified_gmt (post->post_…)
    • name (post->post_…)
    • status (post->post_…)
    • title (post->post_…)
    • comment_count (post->…)
    • comment_status (post->…)
    • guid (post->…)
    • pinged (post->…)
    • ping_status (post->…)
    • to_ping (post->…)

The separator for properties is  ;; ,  for example [ai1ec view="list" props="title;;venue"].

For date and time properties the format has to be specified separated with :: like in the PHP function strftime, for example
[ai1ec view="list" props="start::%d.%m.%Y %H:%M;;title"].

If the property is followed ## it is enclosed in a div-Tag with CSS-classe  ai1ec_fel_ and the name of the property, for example
<div class="ai1ec_fel_title">event title</div>

An optional text follown## is glued to the name of the CSS-class, for example
[ai1ec view="list" props="start::%d.%m.%Y##date;;start::%H:%M##time"]
results in
<div class="ai1ec_fel_start_date">15.08.2013</div><div class="ai1ec_fel_start_time">21:07</div>

This is useful to specifiy different styles for different parts of a date and time property. The styles for the specified class names have to specified by the theme settings.

Alternatively you can specifiy a CSS-class with a text separated by || , for example
[ai1ec view="list" props="start::%Y##year||ai1ec-year"]
results in
<div class="ai1ec_fel_year ai1ec-year">2013</div>

This is useful to let the property be formatted by existing styles.

As a special form you can use || respectively  ++ followed by a text without a property, the result is an opening div respectiveley span tag with the text as class name without a closing one, for example
[ai1ec view="list" props="||ai1ec-header"]
results in
<div class=“ai1ec-header”>
and
[ai1ec view="list" props="++ai1ec-header"]
results in
<span class=“ai1ec-header”>

Without a following text,  || respectively  ++ results in an closing div respectiveley span tag, thus
[ai1ec view="list" props="||"]
results in
</div>
and
[ai1ec view="list" props="++"]
results in
</span>

Instead of the listed properties you can specify HTML-code starting with !! , for example
[ai1ec view="list" props=start:%d.%m.%Y##date;;!!<p>;;start:%H:%M##time]
results in
<div>15.08.2013</div><p><div class="ai1ec_fel_start_time">21:07</div>

Additionally starting  $$ the following precalculatet values can be used:

  • event_url: the URL of the event
  • a_href_title: the title of the event as link to the URL of the event

Starting with () can use the return values of the following PHP functions:

  • site_url ()