Attend JEvents

A addon available to JEvents Club Gold members that allows you take event registrations and accept Paypal payments. This is a brief overview of the functionality of this addon.

1. Installation You will need to install both the component and the jevsessions plugin (remember to enable the plugin). In addition you may want to install and enable the ajefixdomready plugin (this plugin deals with javascript problems encountered in MSIE with some templates) – it you get errors in javascript in internet explorer then you should install and enable this plugin too. These are all available in the JEvents club download area.

2. Configuration After installing you should configure the component. To do this click the “Configuration” icon within the Attend JEvents component in the backend of your site. For most of these config options there are explanatory tooltips available if you place your mouse over each option title. Taking the tabs in turn:

2.1 Registration Control

Display name and email fields for registered users. When a site visitor comes to register for an event if they are already logged in then we don't need their username and email address to identify them. This option allows you to hide these fields or at least disable changes in them. There is a risk in saying “yes” in this field that users may update an existing registration with a new name/email address thus overwriting an existing registration. You are therefore

advised to choose “no” or “show but changes not allowed” for this field. Capacity Management. Should event registration sessions track capacity (you specify the actual capacity for each event). This option controls if this choice should be available or not. Require unique email addresses. If you choose yes here then someone registering for an event will only be able to use an email address for one specific registration. Block Multiple Registrations Per Transaction. If you choose no here then a person registering for an event will be able to add guests to their booking (e.g. other family members). If you choose yes then only one person can book in each registration. Allow Registration Cancellation. Should visitors be able to cancel their registrations?

2.2 Automated Emails

These options control the notification emails sent to the visitor and administrator. Send Confirmation Email: Should the person registering receive a notification email confirming their registration Bcc of confirmation email to session host: Should the session host (typically the creator of the event) receive a BCC of this notification email. Send Cancellation Email: Should the person registering receive a notification email confirming their cancellation. Send Notification Email – After Registration: This is a separate notification email to the event session host/organiser. Send Notification Email – After Payment: This is a separate notification email to the event session host/organiser.

Send Notification Email – After Cancellation: This is a separate notification email to the event session host/organiser.

2.3 Frontend Control

These option control the frontend display options. General – Display Footer in Front-End : Display the Attend JEvents footer message? General – Display Registration Numbers : Should visitors see how many people have registered and the remaining number of spaces? List of Sessions – Default Sorting Column : If you create a menu item for registration sessions this controls the order in which they are displayed. List of Sessions – Default Sorting Order : The order of the list List of Sessions – Start Listing Sessions : This determines when you should start showing that a registrations can be taken. Note that this controls display within the event detail as well as the list of sessions. List of Sessions – Stop Listing Sessions : See above. List of Sessions – List Sessions that are full : Should sessions that are full be hidden? Note that this controls display within the event detail as well as the list of sessions List of Sessions – Display Unauthorised Links : If registration sesssions are only available to registered or special users should they still appear in the list of sessions? Detail of Sessions - Display list of already registered users : Should visitors be able to see a list of those who have already registered for an event.

2.3 Payment Gateways

Attend Jevents supports Paypal and manual payments. Here is where you enter your Paypal account details. Note that you can test with a Paypal Sandbox account available from http://devloper.paypal.com Also you can specify a paypal log file where error and success messages from paypal are posted. If you can place this file outside your webserver path then this is a good idea. You can reset this file or view it at any time using the links provided here.

2.3 Currency/Formatting

Choose the combination of currencies etc. appropriate for your currency. If a currency you require is missing then please report this in the club forum.

2.3 Date and Time Formatting

Again – choose the formatting you require for date and time display within the application.

3. Creating an Event Registration Session Create a non-repeating event in JEvents. After it has been saved you will see a button to create a registration session. Since you may want to create other registration session that share many characteristics it is possible to mark specific sessions as templates. If you have done this then you will be given the option to 'clone' one of these templates (this will be explained in more detail later).

When you click one of these buttons a squeeze box popup window will appear where you can fill in the session details. This edit screen split into 3 blocks each with a number of tabs. Taking these blocks in turn.

3.1 Core Session Details 3.1.1Session Details

By default the description of the registration session picks up the description of the event. If you change this then you can add instructions to your visitors specific to the registration here. You can also set if the session if published (i.e. visible on the site) what type of users can see it (access level), choose the host (defaulting to the user editing the session), even provide an alias for this host (i.e. a name meaningful to the visitors). You can also set if registrations to this event can be cancelled. 3.1.2 Registration Period

The session start and end times and dates relate to the underlying event. You can specify then registration period starts and finishes. Note that all times follow the 24 hour clock

3.1.3 Session Capacity

If you choose a limited capacity then you can specify the maximum number of attendees to the event.

3.2 Special Fields Attend JEvents uses a sophisticated DHTML system to creating and customising the special fields and attributes of your registration session. 3.2.1 Additional Registration Information

You can choose from 9 different registration information field types: •

Text

•

TextArea

•

Checkbox (single)

•

Checkbox (multiple)

•

Radio List

•

Select List (single)

•

Select List (multiple)

•

Instructions

•

Divider

To edit a field simply click on it on the left part of the screen. To add a new field click the “New Field” button. When you do a new section appears on the right side of the screen where you can customise your field. You can reorder your fields simply by dragging and dropping the preview sections on the left. Taking the field types in turn:

3.2.1.1 Text Field

For text fields you specify •

a label,

•

a default value,

•

a tooltip (text that appears over an information icon in the event session display) and

•

a blank value (this is the value that is used to ensure that a required field value has been entered).

You can also state: •

if the field is required (the visitor must enter a valid value to complete their regstration)

•

the access level (which users can see this field)

•

whether the field applies to the group or to the individual. If the field relates to the individual it will appear on any additional tabs created for secondary registrations

•

the maximum length of the input field.

Finally you can style the label and the input element using CSS in the appearance fields. Note that as you change values the area on the left is updated to reflect your changes.

3.2.1.2 Text Area Field

These options are almost identical to the text field 3.2.1.3 Checkbox Single

This is a simple checkbox field that you where you can set the default state (checked or unchecked). Otherwise similar to the text field.

3.2.1.4 Checkbox Multiple

This is a group of check boxes. You add new checkboxes to the group by clicking the “New Option” button – each option must have a unique label. 3.2.1.5 Radio List

Similar to the checkbox multiple but the visitor can only choose one of these values 3.2.1.6 Select List - Single

This creates a drop down list where the visitor can choose one of the available options. Create the options as in the checkbox multiple field type. 3.2.1.7 Select List - Multiple

This creates a select list where the visitor can choose one or more of the available options. Create the options as in the checkbox multiple field type. 3.2.1.8 Instructions

Here you can add instructions or notes to your visitor part way thorough your form

3.2.1.9 Divider

A horizontal line to break up the presentation of your registration form. 3.2.2 Session Fees

This is where you specify any charges relating to your event registration. Note that you can use negative fee amounts and make some fees only applicable to certain visitor types. You can use this combination to create discounts for registered users (choose -£10 as a fee amount and choose all the access levels apart from “public Frontend”). Taking the field types in turn 3.2.2.1 Mandatory Fee

This is fixed fee relating to a registration – it can apply to an individual or to the group. 3.2.2.2 Checkbox Fee (single)

This is a fee that depends on the state of the checkbox 3.2.2.3 Checkbox Fee (multiple)

A series of fees that depends on the state of the checkboxes.

3.2.2.4 Radio Fee

A series of fees but the visitor can only choose one of them. 3.2.2.5 Select Fee (Single)

A list of fees but the visitor can only choose one of them. 3.2.2.6 Select Fee (Multiple)

A list of fees but the visitor can only choose more than one of them. 3.2.2.7 Instructions

As in the registration fields 3.2.2.8 Divider

As in the registration fields 3.2.3 Payment Options

There are 2 types of payment option – manual and paypal but these can be grouped together as a select list or radio list.

3.2.3.1 Manual Payment

Provide the instructions to your visitors in the instruction box. Note that you can have more than one manual payment method (e.g. telephone or mail/post).

3.2.3.2 Paypal

Specify the paypal account details and modify the instructions if required.