Do you have events planned and need to sell tickets? Do you want a page where people can RSVP? Then this plugin is for you!
Please Note: In order to utilise the full Map integration you need to install our Google Maps plugin - http://premium.wpmudev.org/project/wordpress-google-maps-plugin/
Getting Started
Download the latest version of the Events + Plugin here and unpack it.
Once unpacked you need to upload this content to your website. Providing you have not changed your plugin directory path, it will look like this:
/wp-content/plugins/
You will upload your plugin (unpacked folder with content) there, so log in through FTP or if you are on a local host you can move the folder over. The path will then be:
/wp-content/plugins/events-and-bookings/ (And all of the folder content of course)
If you’re new to all this and want to learn more about FTP, this link will get you started:
http://premium.wpmudev.org/wpmu-manual/introduction-to-ftp-and-using-ftp-clients/
Now pop over to your WordPress Dashboard
Admin » Plugins
And activate the Events + Plugin.
If you’re running in Multisite mode you can network activate the Plugin. There are no network settings and the Plugin will function on all sub sites independently. You will also have network wide widgets.
GETTING STARTED, STEP 1: Configure Your Settings
Now that you have the Plugin installed and activated you can configure your Plugin. Go to:
Admin » Events
You will see the initial ‘Getting Started’ screen that will guide you through the 4-step setup process.
Click on ‘Configure Your Settings’ Button. You will be sent to the Settings Page.
You can also get to the Settings Page from the Events menu:
Plugin Settings
The slug is the url for your event listings. Let’s assume this is a events page is for WordCamp, so we enter into the slug field ‘wordcamp-events’, your url will now be:
yourdomain.com/wordcamp-events/
Next you need to decide if these events will be paid ones, checking that option will allow you to sell tickets through PayPal.
A great way to network your events is to utilize social networks, so checking the ‘Allow Facebook and Twitter Login?’ will allow you to connect with both Facebook and Twitter.
And the final option here is for RSVP. Do you want people to see who else is attending your event? If so then get that option checked – friends of those attending might sign up to make the event all that more special!
Please take note of the blue ‘information’ circles with the white ‘i‘ inside. If you hover over these or click on it a dialogue block will appear with some helpful tips on how to complete each field, as seen below:
You will also notice the Step by Step blue ‘pop up’ box that will guide you through your initial setup, as seen below:
Appearance Settings
Without overriding the ‘default’ appearance you will see this:
- Archive template
- Single Event template
When you select ‘Plugin: Calendar’ it will look like this:
- Archive template
- Single Event template
When you select ‘Plugin: Default’ it will look like this:
- Archive template
- Single Event template
When you select ‘Plugin: Default’ it will look like this:
- Archive template
- Single Event template
Payment Settings
If you checked the earlier option ‘Will you be accepting payment for any of your events’, you will have the Payment Settings box after the ‘Appearance Settings’.
Currency
Here you can enter the currency you would like to accept / receive via PayPal.
You can find a list of the accepted PayPal codes here:
https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_currency_codes
And here are some codes for the most popular currencies:
GBP – Great British Pound
AUD – Australian Dollar
EUR – Euro
USD – United States Dollar
PayPal Email Address
Enter the email address that is linked to your PayPal account.
Sandbox
This is a term used for a testing environment. By selecting PayPal Sandbox mode you can test your payment process, without processing live payments. Once you finished testing your site, you can simply deselect this option and you will be ready to earn some cash!
API Settings
If you checked ‘Allow Facebook and Twitter Login?’ you will be able to see the API Settings box.
For more information on how to create your Facebook and Twitter Apps, please see the below information:
Facebook App ID
You can get your Facebook App ID from here:
https://developers.facebook.com/apps
If you don’t have a Facebook App ID you can create one by following the instructions provided on the Facebook Developers page (see link above).
Take note: If you’re using another plugin that also loads Facebook scripts you might encounter some plugin conflicts, one or both plugins might even stop working. Our Developers built in a feature where you can turn off the Facebook scripts that would normally run from the Events + Plugin. Simply check the box ‘My pages already load scripts from Facebook’ to prevent our Plugin from loading the scripts again.
Twitter Credentials
You can get a Twitter App here:
https://dev.twitter.com/apps/new. Make sure you set the Callback URL in the “Settings Tab” of the App for the App to work. Set the Callback URL as the link to your site.
You will need to enter your Customer Key and Twitter Consumer Secret to finish this section of settings.
Note: If you get a ‘Whoa there! There is no request token for this page’ message, do the following:
- Clear cache/cookies
- Create your app as instructed
- Go to ‘Oauth tool’ tab in the Twitter App and copy URI in the ‘Request URI’ field and paste it into the ‘Callback URL’ field in the ‘Settings’ tab
- Select ‘Access’ level (read-only or read and write) as necessary
- Save and proceed as mentioned above
Events + Plugin Extras
BuddyPress: My Events
BuddyPress: Group Events
Please take note of the below reminders when activating these BuddyPress Add-ons.
Email E-Newsletter integration
Please take note of the below reminder when activating the Email E-Newsletter integration Add-on.
Capabilities
Once the Capabilities Add-on is activated you will notice the Event Capabilities Box appearing where you can specify the privileges for each of your users:
Capabilities can be set for the:
- Administrator
- Editor
- Author
- Contributor
- Subscriber
- Directory Member Paid
- Directory Member Not Paid
Front-page editing
Once the Front-page editing Add-on is activated you will notice the Front-page editing Box appearing where you can specify which Front editor page you would like to use:
Available pages that can be used with the Front-page Editor:
- Default
- Listings
- Sample Page
- Sign in
- Sign up
Limited capacity Events
Guest lists options
Once the Guest lists option Add-on is activated you will notice the Guest List Options Box appearing where you can specify how you would like guest avatars and guest names to appear:
Once finished with all these settings, remember to ‘Save Changes’ and then click ‘Go back to Getting started guide’.
GETTING STARTED, STEP 2: Add an Event
Click on the ‘Add an Event’ button if you’re on the default Events page. Or use the Events side menu and click on ‘Add Event’.
Admin » Events » Add Event
The standard WordPress article creation page will appear, with a few modifications to it.
First of all, you will notice the Step by Step blue ‘pop up’ box that will guide you through the rest of your setup.
Start by adding the Event title.
Next add the Event location.
If you have the WPMU DEV Google Maps Plugin installed you will notice a small globe appearing next to the title ‘Event Location’ as seen below:
You can click on this globe which will bring up a box to add a map to your Event.
Enter your location, give your map a name, place the marker and click on ‘Insert this map’.
The result you will see on your Event page will be:
Enter time and dates.
You can also add more dates to your Event by clicking on the ‘Click here to add another date to event’ button.
Update the Event status.
Options are:
- Open
- Closed
- Expired
- Archived
Update the Event type.
Is this a paid event? Yes or no.
Note that if you activated the Payments via MarketPress Products addon, you will see an additional dropdown menu where you can select the product your event should be associated with. You must create the product in MarketPress before you can select it from the dropdown in the event editor.
If you activated the Event Capacity Add-on earlier, you will notice another option on your Event Details page.
Enter the maximum attendees for this event or check for unlimited (self explanatory).
Add your Event details.
See who has RSVP’s in the below section.
And click on ‘Publish’!
FAQ:
When I click ‘Preview’ to see my Event I don’t see ANYTHING on the page? Is it broken? What’s up with that?
From the Dev: This is by design – previews do not work, as the meta fields may not get saved entirely in default AJAX requests. Good catch though!
