Documentation

Installation

Automatic Installation (recommended)

  1. From the WordPress dashboard go to Plugins > Add New
  2. In the search box, type Event Geek
  3. Look for Event Geek in the results (it should be the first), and click “Install Now”install
  4. A message will appear asking if you are sure you want to install the plugin. Click Yes.
  5. After the plugin completes installation, click “Activate Plugin”

Manual Instalation

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.

  1. Download the zip file and extract the files
  2. Upload all the files to the /wp-content/plugins/ directory
  3. 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 Events

add-new
To add an event, simply go to Events > Add New Event

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.

selecting-dates

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.

adding-the-widget

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:

[event_geek_list]

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

menu-options
You can access the Event Geek options under Events > 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

Event Geek Widget Style Optiosn
These options allow you to select the basic styles for the calendar widget

Pop Up Options

Event Geek Pop Up Style Options
Specify the background color, border color (and thickness), text and link color for the pop up box.

Lightbox Options

Event Geek Lightbox Style Options
Set the color and opacity level of the lightbox background

Info Box Options

Event Geek Info Box styling options
Specify the color and size options for the info box that accompanies each event.

Other Options

other-options

Category Options

Use different widget date highlight colors for specific categories
Use different widget date highlight colors for specific categories

Other Configuration

Date Format

Event Geek gets date formatting information from the general settings in the WordPress Dashboard (Settings > General).

WordrPress date and time settings
To Make the calendar start on Monday, simply change the “Week Starts On” setting.
To change the date format just select one of the options from the Date Format section.