# Simple Event Listing #
**Contributors:** NatalieMac
**Tags:** events, calendar
**Requires at least:** 3.7
**Tested up to:** 3.7
**Stable tag:** trunk
**License:** GPLv2 or later
**License URI:** http://www.gnu.org/licenses/gpl-2.0.html

Create a simple listing of events and display with a shortcode or widget.

## Description ##

Easily and quickly enter a list of events with just a few descriptive fields - event name, start date, locale, short description, and a link for more info or to buy tickets.

Then display your list of events on your site with a plugin or shortcode. Show upcoming events, past events, or events between any two dates.

By default, inherits the styles of your theme, but can easily be customized with CSS. You can also override the template by including your own template in your theme or child theme. Full flexibility for displaying your events!

## Installation ##

### Using The WordPress Dashboard ###

1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'simple event listing'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard

### Uploading in WordPress Dashboard ###

1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `simple-event-listing.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard

## Frequently Asked Questions ##

### How do I add a new event? ###

In the WordPress admin, navigate to Events, then click the Add New button.

### How do I edit an event? ###

Find the event you wish to edit, then click the pencil icon. Make any changes you need to make then click Save.

### How do I save a draft of an event without displaying it on the site? ###

If you want to save your work, but you're not yet ready to show your event to the world, just click the eye icon on your event. You'll see the eye icon change and the event will fade a bit to indicate that it's a draft.

### How do I delete an event? ###

Find the event you wish to delete, then click the x icon. You'll be prompted with a confirmation box to ensure you don't accidentally delete any events.

### How do I display the list of events? ###

You can use the `[simple_event_listing]` shortcode, or you may use the Simple Event Listing widget.

### How do I customize the events template? ###

Inside the plugin directory, find the templates folder and copy event-listing.php to your theme/child theme. Customize the template in your theme. Do not edit the event-listing.php file in the plugin folder as it will be overwritten when you update the plugin and your customizations will be lost.

## Screenshots ##

1. The listing of upcoming events in the admin
2. The form for adding a new event
3. Displaying the events with a shortcode
4. The Simple Event Listing widget options
5. Displaying the events with a widget

## Changelog ##

= 1.0 =

* Shiny new plugin
