- Adding Events
- Displaying the Calendar Widget
- Displaying a List of Events
- Category Options
- Other Configuration
Automatic Installation (recommended)
- From the WordPress dashboard go to Plugins > Add New
- In the search box, type Event Geek
- Look for Event Geek in the results (it should be the first), and click “Install Now”
- A message will appear asking if you are sure you want to install the plugin. Click Yes.
- After the plugin completes installation, click “Activate Plugin”
This method will require some means of access to uploading files to your web host. One of the easiest ways to do this is with an FTP program. I recommend Filezilla.
- Download the zip file and extract the files
- Upload all the files to the
- Activate the plugin through the ‘Plugins’ menu in WordPress
Once the plugin is activated, you should see an “Events” section added to your dashboard sidebar.
Adding an event is not much different than adding a regular post, with the exception that you will see some more options to set start/end dates, choose a thumbnail, etc.
Displaying the Calendar Widget
The easiest way to display the calendar widget is through the WordPress Widget Administration (Appearance > Widgets). From here you can add the calendar widget to any Widgetized area you like.
Displaying the Widget in a Template File
If you don’t have any widgetized areas (if this is the case, I recommend looking for a new theme), or for some other reason simply wish to display the calendar in one of your template files, you can use this function:
<?php gg_display_event_calendar (); ?>
This function also accepts a couple of parameters to allow you to specify a category, or link to an event page instead of using the pop up:
<?php //display the calendar without using the popup $args = array( 'popup'=> home_url('/') . '/events' // use the url to your own events page. ); gg_display_event_calendar ($args); //display the calendar showing a specific category $args = array( 'category'=> 'comic-con'// use the "slug" for the category you want. ); gg_display_event_calendar ($args); //display the calendar without using the popup, and showing a specific category $args = array( 'category'=> 'comic-con', 'popup'=> home_url('/') . '/events' ); gg_display_event_calendar ($args); ?>
Displaying a List of Events
Using the Shortcode
Use this shortcode to display a list of events on a page or in a post:
The shortcode also accepts some attributes:
- category – takes the category slug.
Example: [event_geek_list category="comic-con"] (would list everything in the Comic Con event category)
- all_dates – if set to true, will show events that have already passed.
Example: [event_geek_list all_dates="true"]
- limit – limit the number of events to list.
Example: [event_geek_list limit="5"] (would show 5 events)
- orderby – Sort the events using any of the options available to WP Query.
Example: [event_geek_list orderby="name"] (Order by Event name)
- order – Specify the sort order. Use ASC for lowest to highest values (1, 2, 3; a, b, c), DESC for highest to lowest values (3, 2, 1; c, b, a).
Example: [event_geek_list orderby="DESC"]
Using the Template Tag
In your theme file use this function:
<?php event_geek_list(); ?>
The template tag also accepts some arguments, similar to the shortcode:
<?php $args = array( 'post_per_page'=> 5, //same as "limit" in the shortcode 'order_by'=> 'name', //same as 'orderby' in the shortcode 'order' => 'ASC', 'category' => 'all', 'all_dates' => false ); event_geek_list($args); ?>
Event Geek Options
The options page allows you to select a theme to use for your calendar, as well as some color options for event days and the pop up window.
Basic Style Options
Pop Up Options
Info Box Options
Event Geek gets date formatting information from the general settings in the WordPress Dashboard (Settings > General).