AM Events

Version: 1.13.1

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

Overall Rating

WordPress Rating

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. Current Features Admin pages to view/create/modify events. Available data fields for events: start date, end date, venue, category Create weekly or biweekly recurring events Fully customizable widget for displaying upcoming events. 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. The widget for displaying upcoming events uses a simple template system for full control of the layout. If you think something critical is missing, feel free to send me a request. The plugin is available in the following languages (pot-file included for additional translations): English French Norwegian Finnish TUTORIAL For integrating AM Events to an existing theme, I suggest creating a child theme with custom page templates. You can find an example of a working Twenty Twelve child theme from https://github.com/attemoi/am-events-child-theme containing three different page templates for event pages. Widget Here are...

Want to write review?

Are you an author of this plugin? Want to write a more detailed review?

The plugin have some issues.

Sorry, pal! The plugin couldn’t pass all our tests. No hard feelings, right?

Tests done by WP Hive test script Results

Minimal impact on memory usage The memory usage of this plugin is less than the average memory usage of other plugins on WordPress.org + 200KB. Check FAQ for more.
Minimal impact on pagespeed The impact of this plugin on PageSpeed is less than the average impact of other plugins on WordPress.org + 1000 milliseconds
No PHP errors, warning, notices WP Hive automated test found no PHP error while activating this plugin on our server
No Javascript issues WP Hive automated test found no JavaScrip error while activating this plugin on our server
Latest PHP 7.2.16 compatible The latest version of the plugin is compatible with the latest PHP version
Latest WordPress 5.2.4 compatible The latest version of the plugin is compatible with the latest PHP version
Optimized database footprint The plugin creates less than 50 database tables
No activation errors WP Hive automated test found no activation error while activating this plugin on our server
No resource errors WP Hive automated test found no resource error/s while trying this plugin on our server
Frequently updated The plugin was not updated at least once in the last 90 days

All the plugins are tested on the same server with exactly same configuration via test script that automatically activates and logs the data WP Hive shows.

All the scripts run on a VPS with 8 CPU cores and 8 GB of RAM.
The test sites are hosted on Google Cloud VM instances, one site/plugin per instance. The machine type is n1-standard-1. The server is a 8 core CPU with 8GB of RAM.
The test sites are hosted on Apache/2 server and they are tested on PHP 7.2.16 & WordPress 5.2.4.
The database server is MySQL 8.0.15 and the default PHP memory limit is 256MB.

12K

Total Downloads

200

Active Installation

9 years

On WordPress

0.0%

Growth Rate

1

Support Thread

7

Ratings on WordPress

00

Downloads This Week

00

Ago Last Updated

Download Plugin Plugin Website

About AM Events

Description

Current Features

Admin pages to view/create/modify events.
Available data fields for events: start date, end date, venue, category
Create weekly or biweekly recurring events
Fully customizable widget for displaying upcoming events.

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.

The widget for displaying upcoming events uses a simple template system for full control of the layout.

If you think something critical is missing, feel free to send me a request.

The plugin is available in the following languages (pot-file included for additional translations):

English
French
Norwegian
Finnish

TUTORIAL

For integrating AM Events to an existing theme, I suggest creating a child theme with custom page templates. You can find an example of a working Twenty Twelve child theme from https://github.com/attemoi/am-events-child-theme containing three different page templates for event pages.

Widget

Here are the shortcodes available in the upcoming events widget template.

[event-title]
[start-date]
[end-date]
[event-venue]
[event-category]
[content]
[thumbnail]
[excerpt]
[permalink]
[meta]

Conditional shortcodes:

[if cond=”startdate-is-enddate”]
[if cond=”startdate-not-enddate”]
[if cond=”startday-is-endday”]
[if cond=”startday-not-endday”]
[if cond=”has-venue”]
[if cond=”has-category”]

The title can be linked to the event post with the ‘link’ attribute, e.g. [event-title link=true]

The category and venue can also be linked similarly to their respective archive pages using the ‘link’ attribute, e.g. [event-category link=true]

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].

The dates can be formatted using the ‘format’ attribute, e.g. [start-date format=’d.m.Y H:i’] (see PHP date for formatting options). If no format is given, the default WordPress date format is used.

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:

[start-date format='d.m.Y']
divider
[start-date format='H:i']

Example usage of conditional shortcode:

[start-date format='D d.m.Y H:s']
[if cond='startdate-not-enddate']
 - [end-date format='D d.m.Y H:s']
[/if]

Template tags

Template tags were introduced in version 1.3.0 and are listed below. More documentation can be found in the source files.

// 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 )

Example of displaying the first category of the current event post:

$categoryArray = am_get_the_event_category();
echo $categoryArray[0]->name;Creating a WP_Query

The custom post type is named ‘am_event’
The taxonomies are named ‘am_venues’ and ‘am_event_categories’.

The event post has metadata named ‘am_startdate’ and ‘am_enddate’ that are formatted like ‘yyyy-mm-dd hh:mm’

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:

$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 ... //

    }
}

If you want the events ordered by start date, add the following to $args:

'orderby' => 'meta_value',
'meta_key' => 'am_startdate',
'order' => 'ASC',

If you need to display only upcoming events, add the following meta_query argument to $args:

'meta_query' => array(
        array(
            'key' => 'am_enddate',
            'value' => date('Y-m-d H:i:s', time()),
            'compare' => ">",
        ),
),

The plugin folder also contains a file “examples.php”, which contains an example function for displaying upcoming events in a table.

Performance

Memory Usage

Average memory usage is 83.03 KB
This is less than 99% plugins

Page Speed

Average page loading time is increased by 0.01 s
This is faster than 99% plugins

Speed Test Benchmark Learn more how we collect the data

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

+ 0.01s

/(front page)

- 0.04s

/wp-admin/edit-comments.php

+ 0.06s

/wp-admin/edit-tags.php?taxonomy=category

- 0.05s

/wp-admin/edit.php

+ 0.08s

/wp-admin/index.php

- 0.04s

/wp-admin/media-new.php

+ 0.08s

/wp-admin/options-discussion.php

+ 0.14s

/wp-admin/options-writing.php

- 0.15s

/wp-admin/post-new.php

+ 0.03s

/wp-admin/post-new.php?post_type=page

+ 0.16s

/wp-admin/upload.php

- 0.17s

MoreLess

Memory Usage Benchmark Learn more how we collect the data

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

+ 83.03KB

/ (front page)

+ 0.78KB

/wp-admin/edit-comments.php

+ 9.58KB

/wp-admin/edit-tags.php?taxonomy=category

+ 17.72KB

/wp-admin/edit.php

+ 11.88KB

/wp-admin/index.php

+ 9.86KB

/wp-admin/media-new.php

+ 9.61KB

/wp-admin/options-discussion.php

+ 9.65KB

/wp-admin/options-writing.php

- 2.09KB

/wp-admin/post-new.php

+ 19.22KB

/wp-admin/post-new.php?post_type=page

+ 18.37KB

/wp-admin/upload.php

+ 9.59KB

MoreLess

User Rating of AM Events from WP Hive Users

Overall Quality

Measures the overall quality

Ease of Use

How easy it is to use?

Quality of Support

Satisfied or not?

Value for Money

Is it good bang for the buck?

Features

Is it feature riched?

Rate Now

Stats

Download Statistics

Plugin Version Usage

Database Tables

The plugin has added 0 additional options to your WordPress.

WP-Options

The plugin has added 1 additional options to your WordPress website.

widget_am_upcoming_events

Errors

Frequently Updated

The plugin has not been updated in the last 90 days.

Read more how WP Hive determines this data.

Show Off Your Plugin

PHP 7.2.16

WP 5.2.4

Love using this plugin?

Why don’t you compare the plugin side by side
with another plugin

Start Comparing

Ratings & Reviews

Overall Quality

Ease of Use

Quality of Support

Value for Money

Features

Like what you see?

Subscribe to get more quality reviews and articles.

AM Events

Version : 1.13.1

Want to write review?

The plugin have some issues.

12K

200

9 years

0.0%

1

7

00

00

About AM Events

Description

Current Features

TUTORIAL

Widget

Template tags

Creating a WP_Query

Performance

Memory Usage

Page Speed

<img decoding="async" width="67" height="67" loading="lazy" src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossy,ret_img,w_67,h_67/https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/speed-test-bm.png" alt=""> Speed Test Benchmark Learn more how we collect the data

Pages

Benchmark

Change

Pages

Benchmark

Change

User Rating of AM Events from WP Hive Users

Overall Quality

Ease of Use

Quality of Support

Value for Money

Features

<img decoding="async" width="81" height="81" loading="lazy" src="https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/stats-image.svg" alt="Stats"> Stats

Download Statistics

Plugin Version Usage

<img decoding="async" width="53" height="53" loading="lazy" src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossy,ret_img,w_53,h_53/https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/more-icon.png" alt="Stats"> More

Database Tables

WP-Options

Errors

Frequently Updated

Show Off Your Plugin

PHP 7.2.16

WP 5.2.4

Love using this plugin?

Ratings & Reviews

Like what you see?

Social Reviews and Recommendations Widgets Review Write a Review

Are you an author of this plugin?

Stina Gunnarsdottir

Overall

Easy of Use

Features

Quality of Support

Value for Money

Changelog

Speed Test Benchmark Learn more how we collect the data

Stats

More

Are you an author
of this plugin?