# Administrator's Guide
# Dashboard
### Overview
Administration dashboard gives you an overview of all the activities you can do using the JomEvents extension. It provides you a view of all the menu items, system configuration checks, license information, and links to the documentation.

**Screen 1: Dashboard screen**
### Menu Items
The following table provides an explanation about different menu items available:
Dashboard
| Home or dashboard for the JomEvents extension
|
Address | Shows the Address administration screen |
Custom Fields
| Shows the Custom Fields administration screen
|
Categories
| Shows the Categories administration screen
|
Venues Categories | Shows the Venues Categories administration screen |
Venues | Shows the Venues administration screen |
Events | Shows the Events administration screen |
Membership Plans
| Shows the Membership Plans administration screen
|
Messages
| Shows the messages received
|
Documentation
| Access the JomEvents documentation.
|
### System Configuration Checks
Any configuration problems or current configuration status is displayed in this area as shown in the following screen:

**Screen 3: System configuration checks area**
# Address
{{@105}}
# Categories
{{@106}}
# Custom Fields
{{@107}}
# Events Listings
### Overview
Properties are nothing but the product listings that you want to create in the JomEvents. Each listing is attached to a category. They are created in the same manner as Joomla articles, but are not related to Joomla articles in definition.
### Creating A New Listing
The following image shows the Listings screen.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/6Gaobraz.png)
**Screen 1: Properties screen**
The following table explains the different options seen on the screen.
**New**
| Creates a new Address entry. You must create separate entries for each level of depth that you need.
|
**Edit**
| Provides the edit mode to make changes to the existing level or titles created.
|
**Publish**
| Publishes the created address entry.
|
**Unpublish**
| Removes the entry from the list of published address entries
|
**Archive**
| Archives address entries that are not used anymore.
|
**Trash**
| Deletes the address entry that is not required anymore.
|
### Edit Listing
If you want to edit existing entries, you can either click the entry from the Listings screen or select the checkbox next to the entry, and then click Edit.
This tab provides options to add title, description, select category, and other options for the Listing as seen in the following image:
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/zrBobraz.png)
**Screen 2: Edit Listing screen**
The following table shows the options available:
Title
| Title for the Listing.
|
Alias
| URL alias for “SEF/SEO” URL.
|
Text Area
| Provide a description for the listing.
You can create a short description as well a long description.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/9EEobraz.png)

In the above image, the red dotted line appears when you click **Read More**. Any content above the red line is the **short description**, while the entire content is the **long description**. Also, note that if there is no content after the **Read More** tag, the event description will be blank when users view the listing. Ensure that you have content after the **Read More** tag. |
Article *Button*
| Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.
|
Image | Click to add an image for the listing. |
Read More | Click to separate the short description from the long description. |
Toggle editor *Button*
| Toggle between plain text and rich text editor
|
Category | Select the category for the listing. |
Venue | Select the venue for the listing. |
Event Start Date | Provide the start date for the listing. |
Event Finish Date | Provide the finish date for the listing. |
EventBrite Event ID
| Provide the EventBrite event id for integration with the event listing.
|
Featured
| Enable to make the listing appear as featured listing.
|
Approved
| Enable to approve the listing. Listing will not be published.
|
Language
| Select the language for which the listing needs to appear for. For [multiple languages](https://wiki.comdev.eu/display/JV/Multilingual+Site), you must create separate entries for each language.
|
Status
| Select the required status.
- Published
- Unpublished
- Trashed
- Archived
|
Published By | Select the user who published the listing. |
Access
| Provide the access level for the listing.
- Guest
- Public
- Registered
- Special
|
Date created
| Select the date when the listing was created. You can select a future date for publishing the listing as well.
|
Publish Up
| Select a date when you want to publish the listing. Here too, you can schedule to post the listing at a future date.
|
Publish down
| Select a date when the listing should stop being published.
|
Modified Date
| Select a date when the listing was modified.
|
ID
| This is an auto-generated field.
|
#### Custom Fields tab
This tab includes all the custom fields created for a particular category. If the custom field is not applied to a specific category, it can be seen for all categories when creating a listing. The following image shows the Custom Fields tab screen.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/dMzobraz.png)
**Screen 5: Custom Fields tab**
For more information about creating custom fields, see [Custom Fields](https://wiki.comdev.eu/display/JV/Custom+Fields).
#### Images tab
This tab includes information about images and videos attached to the listing. Before you can add images to the listing, you must save your listing at least once. This ensure that all the other data you have filled for the listing does not disappear after the images are added
To set the the Order of the images, which one displayed first, drag and drop images to switch positions.
The first image in the gallery is used as the image thumbnail for the listing.
Provide the options as shown in the following table.
##### Images
| **Add file area**
| Upload Into
| Select which category the image falls under:
- Slideshow - detailed view main gallery
- Gallery - in gallery tab
- Logo - displayed in sidebar under custom fields and over the image with transparency in listings page.
|
| Add available images & attachments
| Click to add images and attachments to this listing.
|
**Images area**
| Editing an Image

| Click the  Edit icon to edit the image details. The options are as seen in the following image:

Click the  Delete icon to delete the image.
|
**Attachments area**
| | Click the  Edit icon to edit an attachment that is linked to the listing. The screen is as shown here:

Click the  Delete icon to delete the attachment.
Attachments are detected automatically based on file extension that’s are allowed in Configuration .
|
##### Video
| YouTube | Provide the YouTube video URL in this field as shown in the following image.

|
Vimeo | Provide the Vimeo video URL in this field. |
---
#### Metadata tab
This tab includes the Meta title and Meta description for the listing as shown in the following image:

**Screen 8: Metadata tab**
# Venues Categories
### Overview
Venues categories are different types of venues that each venue will be associated with. These include arenas, symphony halls, conference halls, and so on.
### Creating A New Venue category
The following image shows the Venue Category screen. To add a category, click **Components** > **JomEvents** > **Venues Categories**. Click **New** to create a new category.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/AKmobraz.png)
**Screen 1: New venue category screen**
Let us understand each of the buttons seen on the screen using the following table.
New
| Creates a new catgory entry. You must create separate entries for each level of depth that you need.
|
Edit
| Provides the edit mode to make changes to the existing level or titles created.
|
Publish
| Publishes the created category entry.
|
Unpublish
| Removes the entry from the list of published category entries
|
Archive
| Archives category entries that are not used anymore.
|
Trash
| Deletes the category entry that is not required anymore.
|
Rebuild
| Refreshes to incorporate the changes made to the entries.
|
### Editing venue category entries
If you want to edit existing entries, you can either click the entry from the category screen or select the check box next to the entry, and then click **Edit**.
#### New Category tab
The New Category tab is seen as shown in the following image:
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/tsnobraz.png)
**Screen 2: New Category tab screen**
After you click the required entry that you need to edit, you can change the configurations based on the options as seen in the following table.
Title
| Venue category title
|
Alias
| URL alias for “SEF/SEO” URL
|
Parent
| Select the parent category entry
|
Text box
| Provide a description about the entry. You can format the text using the formatting options in the text box. You can also insert images or links to URLs for more information.
|
Toggle editor
| Toggle between a rich text box with formatting options and plain text box.
|
Image | Click to add an image related to the category. |
Category Image
| Upload an category image
|
#### Publishing tab
After you have provided the above information, you can provide the publishing information in the Publishing tab as seen in the following image.
You can change the values for the given options using the following table.
Status
| Based on the status seen here, the visibility changes as follows:
- Published - Entries are visible on the front-end.
- Unpublished – Entries are invisible in the front-end, but can be published later.
- Archived – Older entries that are not ready for deletion yet.
- Trashed – Older entries that should be removed.
|
Access
| Access level for site users is as follows:
- Public access grant access to everybody.
- Registered access grants access only to registered and logged in users.
- Special access only grants access to users specified as “Special”.
|
Language
| Select the language for the category entry.
|
ID
| Category ID, which can be used in modules, plugins and menus.
|
Created by
| User name who created the entry.
|
Created Date
| Date when the entry was created.
|
#### Metadata tab
The metadata tab is used to provide metadata information for a particular category entry. The options for this tab can be seen as shown in the following image.
You can change the values for the given options using the following table.
# Venue
### Overview
Venues are locations where the event is to be held. You can add arenas, concert halls, or more based on your requirements. Before you create Venues, ensure that you have created Venue Categories.
Creating A New Venue
To create a new Venue, click New. The following image shows the venues listing in the venues administration screen.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/Nlvobraz.png)

**Screen 1: Venues listing**
### Edit Venue tab
To edit a venue, either click the venue or select the check box next to the venue and click Edit.
Provide the options as shown in the following table.
**Name**
| Name for the membership plan.
|
---|
**Alias** | URL alias for “SEF/SEO” URL. |
---|
**Category**
| Category where the listing will be published.
|
---|
**Address**
| Choose the address of the venue.
|
---|
**Street, Number**
| Enter the street address of the venue.
|
---|
**User**
| Select the JomEvents user for the venue.
|
---|
**Status**
| “Published” Items will be visible in the front-end.
“Unpublished” Items will be invisible in the front-end but intended to be published.
“Archived” Items are old items which are not ready for deletion yet.
“Trashed” Items are old items that should be removed.
|
---|
**Approved**
| Choose if the Venue is approved or not (Y/N) |
---|
**Language**
| Choose the language for the venue.
|
---|
**ID** | This field is auto-populated. |
---|
**Description** | Type your description here, the functionality is the same as main Joomla articles. |
---|
**Article**
| Click to select Joomla articles that are related to the venue.
|
---|
**Image** | Click to select the images related to the venue. |
---|
**Toggle editor** | Click to toggle between rich text and plain text editors. |
---|
**Latitude** | It utilizes the GEO-location based on Google Maps.
Provide the latitude information for the location mapping.
|
---|
**Longitude** | The information provided in this field is used to map the exact location. It utilizes the GEO-location based on Google Maps.
Provide the longitude information for the location mapping.
|
---|
**Map Search** | Search for a specific location. Type in the location and press Enter to go to the exact location. |
---|
#### Understanding the Location area in Edit listing tab
Let us understand how to provide the address and Street/House No for providing the exact locations on the map. When you provide the address, street and House No. in the backend when creating venues, the location position automatically. If the House No. is not provided, additional location fields needs to be used.
##### Mapping using longitudes and latitudes
If you provide the latitudes and longitudes, and the Maps Search setting is left blank, the location mapping is done based on these parameters as shown in the following image.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/WrEobraz.png)
**Screen 3: Map using longitudes and latitudes values**
##### Mapping with Map Search values
If the Map Search field has a value provided to it, it takes precedence as shown in the following image. If the Map Search field value is given as “New York”, the location will map to this location.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/OPbobraz.png)**Screen 4: Map using Map Search Field values**
#### Images tab
This tab includes information about images and videos attached to the listing. Before you can add images to the listing, you must save your listing at least once. This ensure that all the other data you have filled for the listing does not disappear after the images are added.
The Images tab can be seen as shown in the following image:
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/YItobraz.png)

**Screen 7: Images tab**
To set the the Order of the images, which one displayed first, drag and drop images to switch positions.
The first image in the gallery is used as the image thumbnail for the listing.
Provide the options as shown in the following table.
**Images**
| **Add file area**
| Add Files
| Click to select the image that needs to be uploaded.
|
| Drag & Drop Files Here
| Drag a bunch of images to this area to upload multiple images.
|
| Add available images & attachments
| Click to add already uploaded images and attachments to this listing.
|
**Images area**
| Editing an Image

| Click the  Edit icon to edit the image details. The options are as seen in the following image:

Click the  Delete icon to delete the image.
|
**Attachments area**
| | Click the  Edit icon to edit an attachment that is linked to the listing. The screen is as shown here:

Click the  Delete icon to delete the attachment.
Attachments are detected automatically based on file extension that’s are allowed in Configuration .
|
---
#### Publishing tab
After you have provided the above information, you can provide the publishing information in the Publishing tab
You can change the values for the given options using the following table.
**Created Date**
| Date when the entry was created.
|
**Start Publishing**
| Date when publishing needs to start in case of limited viewing of the field.
|
**Finish Publishing**
| Date when publishing needs to stop in case of limited viewing of the field.
|
**Modified Date**
| Date when the entry was modified.
|
#### Metadata tab
This tab includes the Meta title and Meta description for the listing.
# Membership
{{@109}}
### Creating a new Group for Membership Plans
In order to add users to groups for membership plans, you must create a super group named JomEvents. Then, under it you must create groups for each of your membership plan. These groups are used to provide Group ID when creating a membership plan. Users created using User Manager can be linked to each of these membership plan groups.
To create the JomEvents group and other groups, do the following:
1. Click **Users** > **Groups** > **Add New Group**.
2. Provide a name for the group. We need to create JomEvents group before creating other groups. So, provide the name as **JomEvents**.

3. Repeat steps 1 and 2, but select the parent as JomEvents.

4. Click **Save**.
### User Permissions based on groups
For the users to access Front Admin certain user permissions need to be granted. These settings need to be done in the JomEvents and Comdev Options.
To provide user permissions for JomEvents, do the following:
1. Click **Components** > **JomEvents**
2. Click **Options** from the right-hand side of the screen.
3. Click **Permissions**.
4. Provide the permissions as shown in the following image.

5. Click **Save**.
User permissions also need to be set for Comdev extension as explained here.
1. Click **Components** > **Comdev**.
2. Click **Options** from the right-hand side of the screen.
3. Click **Comdev**.
4. Provide the permissions as shown in the following image.

5. Click **Save**.
Users, which belongs to Joomla group JomEvents, will now have access to Front Admin.
If Permissions for the Comdev component are not set, users would not be able to upload images. A 500 error would show that permissions are denied.
# Messages
{{@111}}
# Configuration
### Overview
The JomEvents extension can be configured using the options provided with it. You can control multiple factors such as SEO, Printing, Security, Image widths, and more using the options provided.
### General tab
This tab controls the elements for Layout, SEO, Security, Contact, and Print options. The following image shows the options available on the General tab.

**Screen 1: General tab**
The following table explains the different options seen on the screen.
**Layout**
| Default Listings Sort
| Select the Listings from the following options:
- Latest
- Updated
- Alphabetically
- Rated DESC
- Rated ASC
- Most Viewed
|
| Listings Per Page
| Select 15, 30, or 60 listings per page.
|
| Featured Listings on Top
| Enable to see featured listings on top.
|
##### Layout Elements
| Enable Print
| Enable the “Print” button on listing pages.
|
| Enable Tell a Friend
| Enable the “Tell a Friend” button on listing pages.
|
| Enable Save Listings
| Enable the “Save” button on listing pages.
|
| Enable Social Networking
| Enable social networking buttons on listing pages.
|
| Enable Youtube
| Enable YouTube video embedded on listing pages.
|
| Item Map
| Enable google map in the detailed view - location tab
|
| Listings Map
| Enable Google map on the listings (items menu link)
|
##### Contact
| Email Send To
| Enable Send Email button on listing pages.
|
| Contact Enable
| Enable the contact function on listing pages.
|
| Enable Terms & Privacy
| Activate a check-button for TOS and Privacy statements on contact requests.
|
| Terms & Condition
| Provide Terms & Condition statement by category.
|
| Privacy Policy
| Choose Privacy Policy by category.
|
##### Security
| Enable Captcha
| Enable Captcha for non-registered/logged-in users.
Captcha needs to be **configured** in Plugins -> ReCaptcha and **enabled** under Joomla Global Configuration |
| Enable Captcha for Registered Users
| Enable Captcha for registered users as well.
|
##### SEO
| Maximum Characters for Meta Title
| The maximum amount of characters used in the meta title.
|
| Maximum Characters for Meta Description
| The maximum amount of characters used in the meta-description.
|
##### Print
| Print Location
| Print the map on print requests.
|
Print Reviews | Print the reviews for a listing. |
##### Other
| Enable Powered By Link
| Enable the “powered by” link on listing pages.
|
### Media tab
This tab provides options to control display of media such as images or videos on the listing pages.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/pdVobraz.png)

**Screen 2: Media tab**
The following table explains the options seen on the screen.
**Default Image Library**
| Select the default image library for the listings component between “GD” and “iMagick”.
For more information see:
[http://en.wikipedia.org/wiki/GD\_Graphics\_Library](http://en.wikipedia.org/wiki/GD_Graphics_Library)
[http://en.wikipedia.org/wiki/Imagick](http://en.wikipedia.org/wiki/Imagick)
|
**Max Image Size** | Provide the maximum image size. |
**Max Attachment Size**
| The component wide settings for maximum Attachment size in kilo-byte. (1024 KB = 1 MB)
|
**Video Width**
| Embedded Video width in pixels.
(size of the grey-box video player)
Default Youtube.com size is either 480×385 for a 4:3 video, or 640×385 for a 16:9 video.
|
**Video Height**
| Embedded Video height in pixels.
(size of the grey-box video player)
Default Youtube.com size is either 480×385 for a 4:3 video, or 640×385 for a 16:9 video.
|
**Allowed Files Extensions**
| Comma separated list of allowed attachment file-extensions.
|
**Slideshow Width** | Image width in pixels for the slideshow display area width. |
**Slideshow Format** | The format for the main listing image.
1:1 = Image will be unchanged.
4:3 = image will be resized to 4:3 format.
10:9 = Image will be resized to 10:9 format. |
**Items Logo Width**
| Image width in pixels for Items Logo on the listing page.
|
**Item Logo Image Width**
| Image width in pixels for Item Logo on the listing page.
|
**Main Gallery Image Width**
| Image width in pixels for main gallery image. Ensure that the width value given here is as wide as or more than the slideshow width (generally 800-1200 pixels). If this is not done, the slideshow images will be blurred.
|
**Main Gallery Image Height**
| Image height in pixels for main gallery image.
|
**Main Gallery Image Format**
| The format for the main gallery image.
1:1 = Image will be unchanged.
4:3 = image will be resized to 4:3 format.
10:9 = Image will be resized to 10:9 format.
|
After the images width or format are changed in the Media tab, ensure that you **clear the cache** for JomEvents extension. Click System > Clear Cache -> check com_jomcomdev to clear the Joomla cache for our extension.
If possible, image format should be constant for both component and modules. Otherwise, cache issues may appear.
### Currency & Price tab
This tab provides options to control display of currency formats for listings.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/X26obraz.png)

**Screen 3: Currency & Price tab**
The following table explains options seen on the screen.
**Currency**
| Select the currency to use.
Additional currencies can be added by editing a config file administrator/components/com_jomevents/config.xml |
**Vat**
| The current vat rate for events in the operating country.
|
**Decimal Digits**
| Select the number of decimal digits required.
|
**Number Format**
| Select the number format most suitable for your currency.
|
**Display Digits**
| Select the format for the digits.
|
**Currency Position**
| Select if your currency sign will appear before or after the price.
|
### Integrations tab
This tab provides options to control map integration for listings.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/k1iobraz.png)
**Screen 4: Integrations tab**
The following table explains the options seen on the screen.
**Map Type**
| Select the map type from Google maps.
- Satellite
- Hybrid
- Terrain
|
**Default Zoom**
| Select the default zoom factor for the listing map.
Listings (Items) map zoom is calculated automatically based on all listings and can't be adjusted, same apply for the ajax map search module. |
**Map Starting Location**
| Default location or starting point for map search.
|
**EventBrite API Key** | Provide the event brite key for the event. |
### Front Admin
This tab controls how the menu links are seen on the front admin for JomEvents. It also provides other options related to front admin.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/pelobraz.png)
**Screen 5: Front Admin tab**
The following table explains the options seen on the screen.
**Default New User Group** | Set default group (membership) for users which are not assigned into any component group. Usually, it is the first free group. |
**Welcome Article-ID**
| Set the component's welcome article from Joomla articles.
|
**Help Article-ID**
| Set the component's help article from Joomla articles.
|
**Profile Menu Link**
| [Set the page for the Profile Menu Link.](http://confluence.comdev.eu/display/JV/Menu+Items)
|
**Login Menu Link**
| [Set the page for the Login Menu Link.](http://confluence.comdev.eu/display/JV/Menu+Items)
|
**View Profile Menu Link**
| [Set the page for the View Profile Menu Link.](http://confluence.comdev.eu/display/JV/Menu+Items)
|
**Send email copy to admin** | Send a copy of any email received for the site to the admin along with the owner of the listing. |
**Approve User's Listings**
| When listings are added from the Front Admin, they will not be published unless the site admin approves it.
|
**Enable Paypal**
| [Enable the Paypal facility for user subscriptions.](http://confluence.comdev.eu/display/JV/PayPal+Configuration)
|
**Paypal Email Address**
| Provide the Paypal email that will receive the payments.
|
**PDT token**
| [Provide your Paypal PDT token for secure payments.](http://confluence.comdev.eu/display/JV/PayPal+Configuration)
|
**Use Paypal Sandbox**
| Enable for testing your configuration with the Paypal sandbox facility.
|
**Paypal Sandbox Merchant Email**
| Enable to set your merchant sandbox email address for receiving payments.
|
**Paymens success article ID**
| Provide the article from Joomla articles that points to the page that the user will go to after payment is made.
|
**Membership expiration reminder**
| Provide the number of days after which a notice will be sent about membership expiry. For this configuration, you need to set the Cron job. See [Cron Job Settings](http://confluence.comdev.eu/display/JV/Membership#Membership-Cronsetting) for more information.
|
**Monthly plan**
| Enable to set monthly payment in membership plans.
|
### Permissions
This tab provides options to control permissions for different group.
For more information about how to configure permissions, see the Joomla documentation.