Frequently Asked Questions - Registration Manager King

Installing the Software

Event Registration Manager King uses the same installer system that jomsocial uses. It will install the complete package, consisting of all the main extension and additional plugins and modules as well as the library packages. There is no need to download the extensions one at a time now as we install them all for you. During the installation process, you also have the option to install sample data.

The install package is 10Mb so, you will need to set your PHP settings to allow the upload of this size.

To install Joomla extensions, you need to folow the satandrd installations steps, which are as follows:

1. Login to your Joomla! admin area and go to the control panel if it is not already open.
2. From the top menu, go to Extensions and then Extension Manager
3. Select the Install Option. Then you can drag and drop the installation package into the joomla web page to have it start installing.
4. When the page loads, you will see a green button to Start the Installation process.
5. When you click on the big green button you will see that the installation page will automatically go through each of the installation process steps. When it has finished, you can opt to install sample data.

---

UPDATING

NOTE: WHEN YOU ARE UPGRADING, YOU DO NOT NEED TO UNINSTALL THE OLD VERSION. THE PROCESS WON'T TOUCH YOUR DATA. The process won't delete your database. It will only replace the files, so the database tables won't be deleted.

In order to upgrade to a new version of Event Registration Manager King you just need to go to the joomla Extension manager and select Updates,, then the new versionshould be listed if it is available. Just select it and click the Update button to get the latest version.

The My Account area of king-products.net will always have the most recent version available if your support license is still valid.  After you have downloaded the latest version from your account, you can just perform the same steps as before. The update will automatically overwrite the files for the main component, modules, and plugins as well as update the database. NOTE: If you have made any modifications to the core files of the extensions, then they will be overwritten. Alternatively, the core component can be upgraded using the Joomla installer built into the CMS

---

Uninstalling the Software

If you need to completely uninstall Event Registration Manager King, you can simply uninstall the component, and then the plugins, modules, etc. using the Joomla! extension manager

The database tables for the extensions won't be deleted when they are uninstalled.

To remove the tables, you will need to do it via phpmyadmin or another database tool.

registration manager King has an extensive list of configuration options.  Here we will explain the purpose of each option in each tab so that you can configure it to display data how you need.

GENERAL SETTINGS TAB

Currency & Tax Settings

We have added a complete list of all the world currencies. When you select your currency, the Currency icon will appear. This is the icon that will be shown to the user in the front end.

If you want to charge your users tax on their purchases, this is where you set the tax for the cart total.

INTRO TEXT SETTINGS TAB

Intro text can be displayed in category, calendar, accordioned categories, and event list front end views, Here we have listed each of them so that you can enter the intro text seperately for each.  This intro text is visible in the front end.

These fields are not required. So leaving them blank will result in them not being visible.

 EVENT HANDLING TAB

Here is where you set the events that the system can trigger.

• Handle expired events By: Expired events will be archived in the archive manager section. Here is where you specify How to determine when to archive them, IE, by referring to their start date or their end date. It is unlikely however that you would archive an event based on it's start date, as it many not have completed yet.
• Handle expired events: Here yous specify what you will do with the expired events. You  can archive them to archive manager, you can delete them, or you can do nothing with them, just leave them be.
• Number of days: Here is where yous et the period after the set start er end date for triggering the expired event event. So, if you have set this to 10, and the By option to end date, and the what do do option to delete, then 10 days after the event expires, it will be permanently deleted from the system. NOTE: If you have used the recurring feature and there are child events, The events will only be unpublished when the last child event has been triggered, this way, the entire event and its copies can be archived.
• Disable event reminder notifications: If you dont want the system t send you emails notifying you that an event has been archived or deleted, then set this option to NO.
• Enable Event moderation: With this option set to yes, all events created by the event content creators int he front end, will be set to unpublished automatically, until the admin of the site has authorized and published it manually. The moderator will be send an email accordingly.
• Moderator email address: This is where you set the email address of the moderators, you can comma separate them.
• Enable PDF receipt with email: Here you can set the system to send a PDF receipt to the user at the time that they register for an event. It will be send as a file attachment to the email.

 REGISTRATION HANDLING

• Notify on Register:
  This email address will be notified when a new user registers for an event.
• Require Registrations:
  This option will require all users to be logged in when they register for events. Meaning, No Guest Checkout.
• Allow duplicate emails:
  Witht his option set to "yes", users can register using the same email address multiple times.
• Accept users by default for free events:
  With this option set to "yes", users will be automatically accepted to events when the event is free. If it is set to "no" then the event registration will be set to pending.
• Autimatically accept payments as completed when using offline payment method:
  If your event uses the offline payment method, setting this optjon to "yes" will mark the payment as completed automoatically, otherwise it will be set to pending.

DISPLAY SETTINGS
General Display Settings Section

• Default number of events per page in the list view: Enter a number of how many events will be displayed on the lists per page. EG: 20 events per page.
• Background Color for Featured Event: Select the color you want to use as the background color of your featured events. This color will be used in the event lists as the background color of the event if it is marked as featured.
• Featured Event Text Color: Here you select the color that you want for the text to be for the featured events. If you have a dark background color selected, then you should select a lighter color for the text text color so that the listing can be read.
• Show event start/end dates: This will show or hide the event dates from the list view.
• Show event start/end times: This will show or hide the event times from the list view.
• Display location: This will show or hide the event location from the list view.
• Show short description: This will show or hide the short description from the list view.
• Show event category: This will show or hide the event category from the list view.
• Show max capacity of the event: This will show or hide the maximum capacity number from the list view.
• Show remaining available capacity for the event: This will show or hide the remaining available capacity number from the list view.
• Show amount of registrants for the event: This will show or hide the number of registrants from the list view.

Event List View Section

• Default number of events per page in the list view:Enter the number of items to show per page. EG: 10 events per page.
• Featured Event Background Color: To show an event as Featured, it should stand out from the rest. To do this, you select a background color for it.
• Featured Event Text Color: If you set the background color of a featured event, you may need to change the text color too so that the text can be seen on the background.
• Show event start/end dates: If you dont want to show the events dates, then you can hide them here.
• Show event start/end times: If you dont want to show the events times, then you can hide them here..
• Display location: To hide the event locaiton field, set this to "No".
• Show short description: In List view, if you want to show the short description for an event, you can set this here.
• Show event category: In List view, if you want to show the category for an event, you can set this here.
• Show max capacity of the event: This will show or hide the maximum number of seats for an event.
• Show remaining available capacity for the event: This will show or hide the remainingnumber of seats.
• Show amount of registrants for the event: This will show or hide the number seats already booked for the events.

Event Calendar View Section

• Show calendar category filter:On the calendar page, show the category filter.
• Show event thumbnail image in calendar under the event title: If you set this to yes, you will show a small tumbnail from the event under the events title. This should be avoided if you have alot of events.
• Span events from start to end dates in calendar view : This will blockout the enter time that an event is running, on the calendar. You should only use this if your events don't overlap as it could get messy.
• First day of the week for the calendar view: Use this to est the first column of your calendar day to Eg: monday or Sunday.

Event Details Page View Section

• Show max event capacity available on event detail page: Show the maximum number of seats for the event.
• Show available seats for event on detail page: Show the remaining number of seats.
• Show amount of booked registrants on event detail page: Show the number of seats already booked.
• Show registration dates on event details page: Show or hide the event registration dates.
• Display event description on event detail page: Show or hide the event description.
• Display event title on event detail page: Show or hide the event title. Hiding it is not advised as google then can't find it.
• Show location on event details page: Show or hide the event location.
• Show location URL on event details page: Show URL of the location on the event detail page.
• Show Link to Google Maps for the location: Show or hide the link to the location in google maps.
• Show category: Show or hide the category.

Event Categories Grid Settings

1. Default number of categories on front end: Set the number of categories in each list in the categories list pages.
   
2. Category Per Row: Set the number of columns in each row.
   
3. Show Category Image: Show or hide the category image.
   
4. Show Category Name: Show or hide the category name.
   
5. Show Number of Events: Show or hide the total number of events int he category.
   
6. Show Short Description: Show or hide the categories short description.
   
7. Show View Events Button: Show ir hide a button linking to the categories events list.
   

Shopping Cart View Section

• Maximum quantity limit: Setting this option sets the length of the selector field because if an event has 500 seats, you dont want the user to see a selector with 1-500 items in it when going through the checkout.
• Allow registrants to add multiple events to the cart: This option allows user to go back from the checkout and add another event to the cart.
• Enable discount code field on cart:Show or hide the discount field.
• Show mandatory fields alert above register button: Dynamic form validation so that the user sees any equired fields that they have missed prior to dubmitting.

IMAGE SETTINGS TAB

These settings will resize your images upon upload to the dimentions set in these parameters. If you change these settings later, it will not automatically resize your existing images that have been previously uploaded.

You can set the image height and width if you want to. You can also set the height to be auto and the image will be properly sized only based on the width setting.

INTEGRATION OPTIONS TAB

Note: This is an optional setting and not needed for most websites.

Are Joomla Extended Profiles, JomSocial, or Community Builder being used?        

This option allows the user profile links to point to the specified component on your site. So if you have JomSocial installed, then you can link to the users JomSocial profile.

 

FRNOTEND EVENT MANAGEMENT TAB

1. Front End selectable categories: When creating an event in the front end, this is a list of the cattegories that will be available to the content creator to choose from.
2. Front End selectable Locations: When creating an event, this will give the list of already created and allowed locations for the content creator to choose from.
3. Front End selectable Forms: This will show the front end content creator a list of already predifined event registration forms to select from.

OTHER TAB

Google Maps API - Here is where you can find the options that couldn't be groups with others, so we put them together here.

Google maps API, you will need to options this from your google Console. Log into your google account and go to the console. At the time of writing this document, the URL was this. https://console.cloud.google.com/google/maps-apis/overview?project=geo-radius-search

However, that could change at any time with google. You will need to option the Javascript Maps API key from here.

1. Terms and Conditions - Terms and conditions are the restrictions and rules that you provide to yoru clients when they are making a purchase from your site. The users must agree to these in order to complete the checkout process. This option is the GLOBAL option that will be used if an event does not have its own. The terms are shown to the user when the click the link during the checkout process.
2. Logo For PDF Invoice - When sending the user their purchase emails, the system also sends an invoice in PDF form. Here is where you specify the logo for that invoice.

 

 

Many people if not, MOST, like to just jump in and start using things without reading the documentation. I know, I'm oe of them too. So, to forwarn you, here are some things you'll need to do in the component first before you can create any events.

These are the required first steps you need to take.

BEFORE YOU CREATE AN EVENT! The system will prompt you do perform these tasks.

1.     Create the event category 

2.     Create a venue location 

3.     Create your registration form

4.     Publish your payment plugin 

Once you have done these items, you can create an event. Any event will require the above items be done before you can create your first event.

For the rest of you that really like to follow more detailed instructions please continue on with reading this documentation.

Managing Event Registration Manager King Categories

Event Registration Manager King allows you to create unlimited categories. Each event must be assigned to a category.

Each category can be publish or unpublish as needed. If a category isn't assigned to any events it will not show up in the category list views in the front end of the site. If a category is not assigned, it will not be hidden in the Category Grid View.

---

When you add a category, it will be using our own internal category system instead of the standard Joomla category system because we like to add a few more options to make things prettier in the front end. From here, you can set the parent category to make a multi level category system, a category description, text color and background color.

Adding Colors to Categories

This is where you can set the background color and the text colors for this category by using the color pickers that are in each field. You should make sure that you dont select the same colors for both fields or you won't be able to read the text.

Whichever color you choose, the background of the category in the front end will have that color as its background label colors in the calendar and accordion category views.

Managing Locations (Where the event will take place)

• You can't create an event without first creating a Location. All events must have a location.
• It is not a requrement that the location have a physical address  that the location have an address.
• The description for the locaiton will be shown in the front end of the event details page. You can also add images for your description too.
• As many events as you want, can use the same location.
• The location URL will link to the location's website in a new window.
• If you want to show the Google Map in the details page, then enter the address in the address field.

Adding a new location

Finding the Latitude and Longitude for a locaiton can be quite daunting. However, here is how you can do it quickly.

Open Google maps. (https://maps.google.com) and type in the location you need the co-ordinates for.

Eg:Queanbeyan Showground, Glebe Avenue, Queanbeyan NSW, Australia

Google will open the map, with the location. Somtimes there will be a marker already present on the map and other times not.

Right-Click on the locaiton you need and you will see a custom context menu. Select the "Whats Here?" item.

You will now see a little window show near the bottom of the screen. In it will be the Lat and Long that you need to enter in the Locaiton form.

 

On the Events Manager page, you can add and delete events, in addition to adding new users to the event directly.

Furthermore, if you need to mark your events with the users that arrived to the event, you can click on the "users" column links, and go to the RegistEred Users page. Here, you are able to click Check-In and this will automatically mark the user as arrived.

 

Add New User To Event

From the add new user pages, you are able to add a new user to the event system without the user performing any actions.

This is most useful when you perform over the phone registrations for your events.

This way, all you need to do is to select offline payment as the payment method once you have completed the users registration details and then, once that is done, you will also need to set their payment as Confirmed in the Registratered Users Page. To access the Registred Users page, go to the event manager, and select the link in the Users column.

 

To add a new event just click on the "New" button on the toolbar in the event manager screen.

When you click on the "New" button, you will be taken to the event creation screen where you can enter the details for the event.

Event Details

Here you see the required fields in red.

1. Firstly you should set the title for the event. And then the start and end dates and time for the event.
2. Each event can have up to 5 images. You can select the banner image too. The banner image can be shown above the event details on the detials page. The (upto) 5 images be shown on the event details page.
3. The max attendance field sets the max number of tickets that can be sold fir the event.
4. Enter the short description for the event. it shows in both the list and details views.
5. If you enter the full description then it will be visible on the event details page. The more details the better here.
6. If you do not enter terms and conditions here, then the terms from the configuration settings will be used.

Event Registration Manager King Payment Plugins

From the Event Registration Manager King dashboard, click on the tile "Payment Plugins"

This will open the list of installed payment plguins for the Event Registration Manager King Software.

We install the offline  payment plugin with the component when you install it. If you want to install more payment plugins, then you could download them from our site, or have them developed yourself. They install via the Joomla plugins installer.

After upgrading the component, you should not need to update the payment plguins however, you can update them via the joomla plugin manager, if needed.

Installation of payment plugins

Install new payment plugins;

1.   All Payment plugins are installed as Joomla plugins via the extension manager in Joomla.

2.   Open the Extension Manager and select Install, Select the Upload Package File tab, then select the payment gateway plugin you wish to install.

3.   Click Install, or alternatively if you used the new drag and drop feature, it will auto install.

4.   The plugin will not be automatically published. You will need to publish your payment plugin before you decide to use.

Configuring payment plugins

1. To configure each of the payment plugins, you need go to the payment plugins area from the Event Registration Manager King dashboard or to the joomla plugin manager and click on the title of the plugin to open it. Now you can enter all the config details that are needed for your plugin to communicate with the payment service provider. The last thing you need to do now, is to publish it.
2. You can change the name of the plugin title that is displayed on the front end when the customer select their preferred payment method.

More Payment Gateways

Event Registration Manager King can give the user a choice of multiple payment options to your customers when purchasing.

By default, with an install of Event Registration Manager King, the main component is installed along with an offline Payment Plugin. Ths payment plugin will show a message to the user after the purchase so that they can either mail in their payment or deposit directly into your bank account. We have more payment plugins available for sale in the downloads area of King-products.net that you can install separately as needed.

We can develop specific payment plugins for you if needed at an additional development fee. You can email us and we can developthe one you need.

This feature will link users profiles to their customer dashboard, to the users profile of the linked component from the list below.

• Joomla Profiles
• Community Builder
• JomSocial
• Easy Social
• Profile LMS

The Frontend Fields manager is located in the admin side of the system.

Using this part of the component you can create fields that will be available to content creators that only have access to the creator dashboard in the front end.

First you need to open the Fields list, in the admin area.

From the fields manager, Click NEW on the toolbar, and you will get to the new field page.

Once you have created the field, it will be made available to the content creators in the front end.

They can use this field as a template for their own field. When they select it, it will be copied to their own fields list so that they can customize it however they want.

 

 

The customer dashboard is accessible to any logged in user.

The customer dashboard gives users access to:

From here, the user can select their Instructor or Organizer profile

From here, if you are an organizer, you can edit your profile.

and your Event Registration history

 

In the front end of the component, if you have permissions, you have access to the content creator dashboard.

From the creator dashboard, you can do just about everything that is in the admin area.

You can create events, locations, forms, categories, creators, and, instructors.

You can also generate reports and check statistics.

In the MyEvents List page, you can see all of the events you have created and only you. Nobody else can see your events in this format.

From here, you can edit your events and create new ones.

Inthe forms list page, you can see the Forms that YOU have created and nobody else can see them in this format.

And you can edit them and create more.

 

 Here you can see the list of categories that you have created.

And you can edit and create more.

 Here you can see all of the Locations that you have created.

And you can create and edit more too.

 On the My Reports page you can generate a report of the payments and attendance for your events.

 On the My Statisticss page you can generate a report of the payments and attendance for your events.

From the Event Manager page, you can access the Registered User Manager pages by clicking the links in the Users column.

From the Registered Users Manager page, you CANNOT delete user accounts. However, you can remove users from events, Check-In users, Put users On or Off a waiting list. And Mark users as accepted, to let them show in the front end on the Attendees list for the event details page. Additionally, you can also see the status of the order that was created when the user registered for the event.

 

To check in a guest or simply register that they have attended the event, you will need to log into the admin are of the component and open the events manager page.

 

If you have users registered for your event, you will see a link to the users table in the users column.

Click the link for any of the user types, Accepted, Pending, or Total.

From here you will be take to the users list for the selected event.

To check-in a user, simply click the red circle in the Check-In column for the user that you are planning to check in.

NOTE: you cannot undo this action.

In order to show the list of attendees for an event, you will need to configure this in the event settings firstly, and then for each user, you can set their registrtion to accepted, then they will show on the attendees list.

So firstly,find the correct event.

Now click on the event title to edit the event.

Now, with the option turned on. you will see the Attendees List link in the front end of the site when you view the event details page.

Currently the list will be empty, until you accept the user in the admin area.

So, lets go back to the event manager page and click the Users link in the Users column.

Now, on the Registered users page, you can click the red circle in the Accepted colum, which will make the user show on the attendees list.

Now the user should be seen in the attendees list when you click it in the front of the site.

 you can access the Nametage generator from either the admin dashboard of the left menu, once you open the admin area of the component.

On this page, you will need to select the event that you want to generate the NameTags for, select the users, or ALL users, Select the sort order

 field, and then you can select up to 4 fields to show on the NameTags.

All that remains is to selec tthe style of nametag. Each has it's own size.

When you're done, click the Generate Badges button.

You will now get a pdf file to print.

 

 

Automatically archiving events is easy.

Go to the Component settings page. Then to the Event Handling tab.

 

From this tab, you can set the option for auto archive.

The first three fields are the ones specifically for archiving.

The first field, "How to handle" specifies that we will use either the event start or end date to use for the trigger.

The second field, "What do do with old events" lets you specify, Do Nothing, Delete, or Archive the event. This helps to reduce crowding in the events manager.

The last field, "How many days" is what we use to calculate and trigger the event.

Is this example, we will archive the old events, 45 days after the events start date.

From here, you have the option of selecting the checkbox and clicking Unarchive event, if ou want to return it to the events list.

However, unless you want it to be rearchived again, you will need to change the dates for the event.

The Coupons manager lists all of the discount coupons that you've made in the system.

It shows the validity dates, the actual code, the status of the coupon and its state, published or not.

 

 

The fields on thie page are pretty self explanitary, however to avoid questions and confusion, The most important ones will be explained.

The discount type field can be a fixed amount or a percentage. How much of a discount is entered into the "Discount" field as a numeric value.

You can then set the discount to be applied on at a specific cart total and higher, and you set it on a specific event too.

 

 

 

On the Submissions page, you are able to see everyone that has registered for your event. You can filter by user and by event, to help reduce the number of items shown.

Furthermore, the most handy feature here is that if you select an event filter, you can then check all the users for your event and click the toolbar button Email Selected Users. This lets you send a mass mail to all the users notifying them of some news about the event or some changes, or even a cancellation.

From here, you can see who purchased the event, in teh Submitted by column, for which event and when it was submitted.

There are two main buttons here. View Ticket which lets you see the e-Ticket for the user that was registered at the time of purchase, from which you can event save or print:

 

And the other button, Vew Details shows you the Info entered into the registration form at the time of purchase:

 

When you go to the Ticket Template Editor, you will see several sections.

The main one of which is the WYSIWYG editor.

This contains the template for the ticket.

When generating PDF tickets for download and printing, we use the TCPDF public library.

The library however is somewhat limited in what you can do with regards to styling.

So, here are some examples of tables that you can create: https://tcpdf.org/examples/example_048/

In our example, we use the NON-BREAKING TABLE example, and modify the column widths.

 When styling the eticket, you are limited to using the following list of css attributes, (all others will be removed):

In the top righ tof the page, you can see an input box for some custom css styling too.

Finally, you can see the list of TAGs that you can use as placeholders.

[NAME]	Name of event attendee
[BOOKING_DATE]	Date of Booking For Ticket
[BUYER_NAME]	Name of ticket buyer
[EVENT_IMAGE]	This is Event Image
[EVENT_NAME]	This is Name of Event
[EVENT_URL]	Link for Event
[ST_DATE]	This is Start Date of Event
[EN_DATE]	This is End Date of Event
[EVENT_LOCATION]	This is location of Event
[TICKET_ID]	This is Ticket ID of Event
[TICKET_TYPE]	Ticket Type set by Event Owner while creating events
[TICKET_PRICE]	This is price per ticket
[TOTAL_PRICE]	This is total price
[EVENT_DESCRIPTION]	This is event Description
[QR_CODE]	This is QR code which is verified at time of event

When you enter one of these tags, the system will replace it with the specified value in the list above.

 

In the statistics area, you can generate results for the current year to date or for the current month.

You can also select a cart from the list, Area, Line or Stepped Area.

The page will also list the last 10 transactions a list of the next ten events to finish.

Events that are currently in proces will be listed in this area too.

In this page, you can see how much revenue you are generating from your events.

 

 

 When you select a checkbox and click the delete order button, the system will not only delete the order, but it will delete all user registrations associated with the order as though it never existed.

It will NOT however, delete user accounts associated with a registration.