Atte Moisio

<p>The purpose of this plugin is to add an event type similar to the normal post type. By design this plugin doesn’t provide any ready-made layouts, and allows the events to be fully integrated and customized to the theme of your choosing.</p>
<h3>Current Features</h3>
<ul>
<li>Admin pages to view/create/modify events.</li>
<li>Available data fields for events: start date, end date, venue, category</li>
<li>Create weekly or biweekly recurring events</li>
<li>Fully customizable widget for displaying upcoming events.</li>
</ul>
<p>The custom post type created by the plugin is named ‘am_event’ and has two taxonomies: ‘am_event_categories’ and ‘am_venues’. Dates are stored as post metadata. Displaying the events is done in the theme files using WP_Query and the template tags provided by the plugin. This allows full control over the layout and what elements to show.</p>
<p>The widget for displaying upcoming events uses a simple template system for full control of the layout.</p>
<p>If you think something critical is missing, feel free to send me a request.</p>
<p>The plugin is available in the following languages (pot-file included for additional translations):</p>
<ul>
<li>English</li>
<li>French</li>
<li>Norwegian</li>
<li>Finnish</li>
</ul>
<h3>TUTORIAL</h3>
<p>For integrating AM Events to an existing theme, I suggest creating a <a href="https://codex.wordpress.org/Child_Themes" rel="nofollow ugc">child theme</a> with custom page templates. You can find an example of a working Twenty Twelve child theme from <a href="https://github.com/attemoi/am-events-child-theme" rel="nofollow ugc">https://github.com/attemoi/am-events-child-theme</a> containing three different page templates for event pages.</p>
<h4>Widget</h4>
<p>Here are the shortcodes available in the upcoming events widget template.</p>
<ul>
<li>[event-title]</li>
<li>[start-date]</li>
<li>[end-date]</li>
<li>[event-venue]</li>
<li>[event-category]</li>
<li>[content]</li>
<li>[thumbnail]</li>
<li>[excerpt]</li>
<li>[permalink]</li>
<li>[meta]</li>
</ul>
<p>Conditional shortcodes:</p>
<ul>
<li>[if cond=”startdate-is-enddate”]</li>
<li>[if cond=”startdate-not-enddate”]</li>
<li>[if cond=”startday-is-endday”]</li>
<li>[if cond=”startday-not-endday”]</li>
<li>[if cond=”has-venue”]</li>
<li>[if cond=”has-category”]</li>
</ul>
<p>The title can be linked to the event post with the ‘link’ attribute, e.g. [event-title link=true]</p>
<p>The category and venue can also be linked similarly to their respective archive pages using the ‘link’ attribute, e.g. [event-category link=true]</p>
<p>The number of words displayed in the title, content or excerpt can be limited by the ‘limit’ attribute, e.g. [content limit=25] or [event-title limit=10].</p>
<p>The dates can be formatted using the ‘format’ attribute, e.g. [start-date format=’d.m.Y H:i’] (see <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">PHP date</a> for formatting options). If no format is given, the default WordPress date format is used.</p>
<p>You can use any shortcode as many times as needed in a single template. To separate date and time of start date for example you could write:</p>
<pre><code>[start-date format='d.m.Y']
<span>divider</span>
[start-date format='H:i']
</code></pre>
<p>Example usage of conditional shortcode:</p>
<pre><code>[start-date format='D d.m.Y H:s']
[if cond='startdate-not-enddate']
 - [end-date format='D d.m.Y H:s']
[/if]
</code></pre>
<h4>Template tags</h4>
<p>Template tags were introduced in version 1.3.0 and are listed below. More documentation can be found in the source files.</p>
<pre><code>// Template tags for getting and displaying event dates
am_the_startdate($format = 'Y-m-d H:i:s', $before = '', $after = '', $echo = true)
am_get_the_startdate( $format = 'Y-m-d H:i:s', $post = 0 )
am_the_enddate($format = 'Y-m-d H:i:s', $before = '', $after = '', $echo = true)
am_get_the_enddate( $format = 'Y-m-d H:i:s', $post = 0 )

// Template tags for getting and displaying event venues
am_get_the_venue( $id = false )
am_in_venue( $venue, $post = null )
am_get_the_venue_list( $separator = '', $parents='', $post_id = false )
am_the_venue( $separator = '', $parents='', $post_id = false )

// Template tags for getting and displaying event categories
am_get_the_event_category( $id = false )
am_get_the_event_category_list( $separator = '', $parents='', $post_id = false )
am_in_event_category( $eventCategory, $post = null )
am_the_event_category( $separator = '', $parents='', $post_id = false )
</code></pre>
<p>Example of displaying the first category of the current event post:</p>
<pre><code>$categoryArray = am_get_the_event_category();
echo $categoryArray[0]->name;<h3>Creating a WP_Query</h3>
</code></pre>
<p>The custom post type is named ‘am_event’<br />
The taxonomies are named ‘am_venues’ and ‘am_event_categories’.</p>
<p>The event post has metadata named ‘am_startdate’ and ‘am_enddate’ that are formatted like ‘yyyy-mm-dd hh:mm’</p>
<p>So suppose I wanted to display all events with a category of ‘other’ and venue ‘mcdonalds’. I would then make a WP_Query like this:</p>
<pre><code>$args = array(
        'post_type' => 'am_event',
        'post_status' => 'publish',
        'tax_query' => array(
                'relation' => 'AND',
                array(
                    'taxonomy' => 'am_venues',
                    'field' => 'name',
                    'terms' => 'mcdonalds',
                ),
                array(
                    'taxonomy' => 'am_event_categories',
                    'field' => 'name',
                    'terms' => 'other'
                ),
        ),
    );

$the_query = new WP_Query($args);

if ($the_query->have_posts()) {
    while ($the_query->have_posts()) {
        $the_query->the_post();

        $postId = $post->ID;

        // Use template tags to get start and end date
        $startDate = am_get_the_startdate('Y-m-d H:i:s');
        $endDate = am_get_the_enddate('Y-m-d H:i:s');

        // Use template tags to get venues and categories in an array
        $venues = am_get_the_venue( $postId );
        $eventCategories = am_get_the_category( $postId );

        // All the other functions used for posts like
        // the_title() and the_content() work just like with normal posts.

        // ...  DISPLAY POST CONTENT HERE ... //

    }
}
</code></pre>
<p>If you want the events ordered by start date, add the following to $args:</p>
<pre><code>'orderby' => 'meta_value',
'meta_key' => 'am_startdate',
'order' => 'ASC',
</code></pre>
<p>If you need to display only upcoming events, add the following meta_query argument to $args:</p>
<pre><code>'meta_query' => array(
        array(
            'key' => 'am_enddate',
            'value' => date('Y-m-d H:i:s', time()),
            'compare' => ">",
        ),
),
</code></pre>
<p>The plugin folder also contains a file “examples.php”, which contains an example function for displaying upcoming events in a table.</p>


AM Events

This event plugin is a great foundation to build a custom calendar implementation on top of. It works well and provides many powerful options right out of the box.



Powerful, flexible, easy to mod

This plugin got loads of nice features unfortunately it hasn't been updated for quiet a while now.

I tried to use this plugin on a site the other day but unfortunately the date picker didn't returned the right format as well as the date field value send is not converted correctly to an unix timestamp it somehow always returns 0. Leaving you with only "1970-01-01 00:00:00" dates. Please look into this issue try different translations. I'm sure you have to use php's function strtotime() here.

Good luck,

Cheers Fleuv

Dead or still maintained

Manage and display your events. Allows fully customizable layouts and includes a widget for upcoming events.

Joe Dolson

<p><a href="https://joedolson.com/my-calendar/" rel="nofollow ugc">My Calendar</a> offers easy-to-use WordPress event management with rich options for custom displays. Display individual event calendars in WordPress Multisite, offer multiple views of calendars limited by event categories, locations or author, or show simple text-based lists of your upcoming events.</p>
<h4>Rich Event Calendar Features</h4>
<p>You’ll find enormous design flexibility fo your custom calendar. With recurring event support, design customization tools, custom templating, and category and venue support out of the box, My Calendar gives you a great feature set to get your calendar set up.</p>
<h4>Built with Accessibility in Mind</h4>
<p>My Calendar is an events calendar focused on holistic accessibility: providing a positive experience for site visitors and administrators who use assistive technology. It includes built-in settings where you can describe the ADA compliance features of your events and venues. Accessibility is a critical part of your website, so your audience can get equal access and experience to the events you list.</p>
<p>Learn about <a href="https://docs.joedolson.com/my-calendar/event-accessibility/" rel="nofollow ugc">accessible events</a> or <a href="https://demos.joedolson.com/my-calendar/" rel="nofollow ugc">visit the My Calendar demo</a></p>
<h4>Accessibility-first Software</h4>
<p>While My Calendar has a strong focus on backwards compatibility, it is officially built with an accessibility first mindset. That means that if a choice has to be made between improving accessibility and breaking backwards compatibility, the more accessible choice will always come first.</p>
<h4>Premium Event Management</h4>
<p>Looking for more? <a href="https://www.joedolson.com/my-calendar/pro/" rel="nofollow ugc">Buy My Calendar Pro</a>, the premium extension for My Calendar.</p>
<p>My Calendar Pro adds tons of great additional features:</p>
<ul>
<li>Support for user-submitted events,</li>
<li>Custom field creation and management,</li>
<li>integration between posting and event creation,</li>
<li>Import events from outside sources, and</li>
<li>support for sharing events between multiple sites.</li>
</ul>
<h4>Sell Event Tickets</h4>
<p>Do you sell tickets for your events? <a href="https://wordpress.org/plugins/my-tickets/" rel="ugc">Use My Tickets</a> and sell tickets for My Calendar events. Set prices, ticket availability, and sell multiple events at the same time using My Tickets.</p>
<h4>Features:</h4>
<ul>
<li>Calendar grid, card, and list views of events</li>
<li>Month, multi-month, week, or daily view.</li>
<li>Mini-calendar for compact displays (as widget or shortcode)</li>
<li>Widgets: today’s events, upcoming events, mini calendar, event search</li>
<li>Customize templates for event output</li>
<li>Limit views by categories, location, author, or host</li>
<li>Extensive support for recurring events.</li>
<li>Edit or add single dates in recurring events</li>
<li>Rich permissions handling to restrict access to parts of My Calendar</li>
<li>Email notifications when events are scheduled or drafted</li>
<li>Post to X when events are created (using <a href="https://wordpress.org/plugins/wp-to-twitter/" rel="ugc">XPoster</a>)</li>
<li>Event location management</li>
<li>Fetch events from a remote database. (Sharing events in a network of sites.)</li>
<li>Multisite-friendly</li>
<li>Integrated help page</li>
<li>Shortcode Generator to create customized views of My Calendar</li>
<li>SEO with JSON-LD structured data for events and venues.</li>
<li>Export or subscribe via iCal or Google Calendar.</li>
<li>Completely responsive events views</li>
<li>Extensive <a href="https://docs.joedolson.com/my-calendar/" rel="nofollow ugc">public documentation</a>.</li>
<li>Hundreds of <a href="https://joedolson.github.io/my-calendar/" rel="nofollow ugc">actions and filters for custom development</a></li>
</ul>
<h4>Accessibility</h4>
<p>My Calendar is designed with accessibility in mind. All interfaces – both front and back end – are tested with various assistive technology.</p>
<p>The plugin includes features for showing the accessibility services available for events and at physical venues, as well as providing access to your event information for users with disabilities.</p>
<h4>What’s in My Calendar Pro?</h4>
<ul>
<li>Let your site visitors submit events to your site (pay to post or free!).</li>
<li>Let logged-in users edit their events from the front-end.</li>
<li>Custom field creator</li>
<li>Create events when you publish a blog post</li>
<li>Publish a blog post when you create an event</li>
<li>Advanced search features</li>
<li>Import events from .ics or .csv formats via file or URL.</li>
<li>REST API support for sharing events between multiple sites.</li>
</ul>
<h4>Translations</h4>
<p>Visit <a href="https://translate.wordpress.org/projects/wp-plugins/my-calendar" rel="nofollow ugc">WordPress Translations</a> to check progress or contribute to your language.</p>
<p>Translating my plugins is always appreciated. Visit <a href="https://translate.wordpress.org/projects/wp-plugins/my-calendar" rel="nofollow ugc">WordPress translations</a> to help get your language to 100%!</p>


My Calendar – Accessible Event Manager

Great plugin - I tried many calendars for my class schedule and this was the only one that WORKED! I love all the detailed setup options for developers, with the ability to change text and colors. Haven't played with the templates yet but I'm excited to do so. 

Had an issue and developer was super-responsive, resolving it and fixing with care. Thank you!

Finally - A Robust Calendar that WORKS!


This is a great plugin! I have used this on many different kinds of sites and after several years there has yet to be a problem I have to solve with a calendar that this plugin cannot handle!


Great Plugin for Everything

Accessible WordPress event calendar plugin. Manage single or recurring events, event venues, and display your calendar anywhere on your site.

AM Events vs My Calendar – Accessible Event Manager