# User Guide



# Front Admin Overview

### Overview

The dashboard gives a quick snapshot of all the tasks that you can perform using the Front Admin. It also provided multiple menu items that you can use to create listings, view listings, view membership plans, and so on. The other options that you can control are approving reviews, viewing statistics, upgrading membership for a particular user, and so on.

For the Menu to be able to access the JomEvents Front Admin, certain settings need to be made. You must create the Profile Edit Menu link, Admin Menu link, and Profile View Menu link in the JomEvents Front Admin configurations to be able to access Front Admin. For more information, see the Front Admin Options section in the [Menu Items](https://wiki.comdev.eu/books/jomevents/page/menu-items "Menu Items") documentation.

### Accessing the dashboard

When you access the home URL for JomEvents extension, do the following:

1. Click **Front Admin**.
2. Provide the login details for the required user and click **Submit**.

You can access Front Admin either as an agent or a company. Based on the login used, the pages displayed change too.

The dashboard as seen by a company with various options can be seen as shown in the following image.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/dkEobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/dkEobraz.png)**Screen 2: Dashboard screen**

You can click the options as seen in the following table.

<table id="bkmrk-report-most-viewed-g" style="width: 100%;"><tbody><tr><td style="width: 16.8052%;">##### Report

</td><td style="width: 16.0749%;">Most Viewed graph

</td><td style="width: 67.1199%;">View the statistics for the site based on the listings viewership.

</td></tr><tr><td style="width: 16.8052%;">##### Membership

</td><td style="width: 16.0749%;">Upgrade Your Membership NOW!

</td><td style="width: 67.1199%;">Upgrade to another membership plan. Click Upgrade on the plan tab for the plan you want to upgrade to as shown here.

![](https://wiki.comdev.eu/download/attachments/5735404/userguide_dash_jv1.jpg)

</td></tr><tr><td style="width: 16.8052%;">##### Profile

</td><td style="width: 16.0749%;">Profile

</td><td style="width: 67.1199%;">View the profile details for your profile.

</td></tr></tbody></table>

# Manage Listings

## Overview

You can view all the listings created for your site or create a new listing. The listings created let you add descriptions, images, provide ratings, and much more.

## Creating a New Listing

The following image shows the Listings screen.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/HUeobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/HUeobraz.png)**Screen 1: Listing screen**

The following table explains the different options seen on the screen.

<div id="bkmrk-button-usage-insert-"><table><thead><tr><td data-highlight-colour="blue">**Button**

</td><td data-highlight-colour="blue">**Usage**

</td></tr></thead><tbody><tr><td>**Insert New**

</td><td>Creates a new listing entry. You must create separate entries for each level of depth that you need.

</td></tr><tr><td>**Publish**

</td><td>Publishes the created listing entry.

</td></tr><tr><td>**Unpublish**

</td><td>Removes the entry from the list of published entries.

</td></tr><tr><td>**Delete**

</td><td>Deletes the listing entry that is not required anymore.

</td></tr></tbody></table>

</div>## Adding a new listing

To create a new listing, click **Add New** from the Dashboard Menu list. The new listing page is displayed.

#### New Listing tab

This tab provides options to add title, description, select category, and other options for the Listing as seen in the following image:

The following table shows the options available:

<div id="bkmrk-area-options-usage-e"><table style="width: 100%;"><thead><tr><td data-highlight-colour="blue" style="width: 16.1821%;">**Area**

</td><td data-highlight-colour="blue" style="width: 69.4792%;">**Options**

</td><td data-highlight-colour="blue" style="width: 14.2151%;">**Usage**

</td></tr></thead><tbody><tr><td style="width: 16.1821%;">**Edit Listing area**

</td><td style="width: 69.4792%;">Title

</td><td style="width: 14.2151%;">Title for the Listing.

</td></tr><tr><td style="width: 16.1821%;">**Text Area**

</td><td style="width: 69.4792%;">Provide a description for the listing.

</td></tr><tr><td style="width: 16.1821%;">**Short Description**

</td><td style="width: 69.4792%;">Provide a short description for the listing.

</td></tr><tr><td style="width: 16.1821%;">**Article *Button***

</td><td style="width: 69.4792%;">Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.

<div data-hasbody="true" data-macro-name="note"><div>***Buttons*** for the editor are available when enabled under Site Backadmin -&gt; Plugins and WYSIWYG editor turned On in Joomla Configuration.</div></div></td></tr><tr><td style="width: 16.1821%;">**Page Break *Button***

</td><td style="width: 69.4792%;">Insert a page break in the displayed text.

</td></tr><tr><td style="width: 16.1821%;">**Toggle editor *Button***

</td><td style="width: 69.4792%;">Toggle between plain text and rich text editor

</td></tr><tr><td style="width: 16.1821%;">**Read More Button**

</td><td style="width: 69.4792%;">Insert a separation for creating short description. Any content above the dotted line is displayed as the short description.

<div data-hasbody="true" data-macro-name="info"><div>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.</div></div></td></tr><tr><td style="width: 16.1821%;">**Status**

</td><td style="width: 69.4792%;">Select the required status.

- Published
- Unpublished
- Trashed
- Archived

</td></tr><tr><td style="width: 16.1821%;">**Featured**

</td><td style="width: 69.4792%;">Enable to make the listing appear as featured listing.

<div data-hasbody="true" data-macro-name="note"><div>Feature Count is being checked when saving listing for the selected Membership Plan.</div></div></td></tr><tr><td style="width: 16.1821%;">**Language**

</td><td style="width: 69.4792%;">Select the language for which the listing needs to appear for. For [multiple languages](https://wiki.comdev.eu/books/installation-requirements-language/page/multilingual-site "Multilingual Site"), you must create separate entries for each language.

</td></tr><tr><td style="width: 16.1821%;">**Category**

</td><td style="width: 69.4792%;">Category where the listing will be published.

</td></tr><tr><td colspan="1" style="width: 16.1821%;">**Category Type**</td><td colspan="1" style="width: 69.4792%;">Category Type such as house, apartment and so on based on the category types for your site.</td></tr><tr><td colspan="1" style="width: 16.1821%;">**Energy Class**</td><td colspan="1" style="width: 69.4792%;">Select the energy class for the listing.</td></tr><tr><td style="width: 16.1821%;">**Address area**

</td><td style="width: 69.4792%;">Address

</td><td style="width: 14.2151%;">Address of the listing

</td></tr><tr><td style="width: 16.1821%;">**Full address**

</td><td style="width: 69.4792%;">Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.

</td></tr><tr><td style="width: 16.1821%;">**Location area**

</td><td style="width: 69.4792%;">Maps latitude

</td><td style="width: 14.2151%;">It utilizes the GEO-location based on Google Maps.

Provide the latitude information for the location mapping.

</td></tr><tr><td style="width: 16.1821%;">**Maps longitude**

</td><td style="width: 69.4792%;">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.

</td></tr><tr><td style="width: 16.1821%;">**Maps Search**

</td><td style="width: 69.4792%;">Search for a specific location. Type in the location and press Enter to go to the exact location.

</td></tr></tbody></table>

</div><div data-hasbody="true" data-macro-name="tip" id="bkmrk-for-more-information"><div>For more information about how the location mapping is done in the listing, see [Listings](http://confluence.comdev.eu/display/JE/Listings) in the Administrative Guide.</div></div>#### Custom Fields area

This area 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.

For more information about creating custom fields, see [Custom Fields](https://wiki.comdev.eu/books/jomevents/page/custom-fields "Custom Fields").

#### Images tab

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-02/scaled-1680-/mexobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-02/mexobraz.png)

**Screen 5: Images tab**

To add an image, do the following:

Click **Add Image**.

Provide options as seen in the following image.![](https://wiki.comdev.eu/download/attachments/5735004/Listings_Images1.jpg)

You can provide values using the following table.

<div id="bkmrk-title-or-alias-provi"><table><tbody><tr><td>**Title or alias**

</td><td>Provide a title for the Image.

</td></tr><tr><td>**Categories**

</td><td>Select from the following options:

- Slideshow - detailed view main gallery
- Gallery - in gallery tab
- Features- displayed under features.

</td></tr><tr><td>**Status**

</td><td>Select the required status.

- Published
- Unpublished

</td></tr><tr><td>**Order**

</td><td>Order in which you want the image to appear.

</td></tr><tr><td>**File**

</td><td>Click Choose File and provide the image.

</td></tr><tr><td>**Description**

</td><td>Provide a description about the image.

</td></tr></tbody></table>

Click **Save**.</div>For more information about editing images or deleting images, see [Images](http://confluence.comdev.eu/display/JE/Listings) in the Administrative Guide.

You can also provide YouTube video links for the listing. Provide the link as shown in the above image.

#### Attachments tab

Click the ![](https://wiki.comdev.eu/download/attachments/5735004/Listings_edit_icon.jpg)Edit icon to edit an attachment that is linked to the listing. Click the ![](https://wiki.comdev.eu/download/attachments/5735004/Listings_close_icon.jpg) Delete icon to delete the attachment.

Attachments are detected automatically based on file extension that’s are allowed in Configuration.

Some features or tabs are enabled based on the user membership. If the user is attached to a membership plan that does not allow adding attachments, he will not be able to see any options under the Attachments tab. These membership limitations are checked for when you save the listing.

# Manage Venues

### Overview

You can add venues related to the listings using this tab. The following screen shows the list of venues available for creating a listing.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/6Juobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/6Juobraz.png)**Screen 1: Venues listing**

You can select what to do next based on the following table.

<div id="bkmrk-insert-new-click-to-"><table><tbody><tr><td>**Insert New**</td><td>Click to add a new agent information.</td></tr><tr><td colspan="1">**Publish**</td><td colspan="1">Click to publish the agent information.</td></tr><tr><td colspan="1">**Unpublish**</td><td colspan="1">Click to unpublish agent information.</td></tr><tr><td colspan="1">**Delete**</td><td colspan="1">Click to delete the agent information from the site.</td></tr></tbody></table>

</div>### Adding a new Venue

To add a new venue for the event, click Insert New from the Venues tab.

For detailed information about information that needs to included in each field, see [Venues](https://wiki.comdev.eu/display/JV/Venue) in the Administrator's guide.

# User Membership

### Overview

You can view the user membership plan details on the Front Admin page. If eligible for, you can also upgrade the user membership plan to a higher plan.

<div bis_skin_checked="1" class="wiki-content" id="bkmrk-user-membership-plan"><div bis_skin_checked="1" class="confluence-information-macro confluence-information-macro-note conf-macro output-block" data-hasbody="true" data-macro-name="note"><div bis_skin_checked="1" class="confluence-information-macro-body">User membership plan can only be upgraded through the Front Admin. You can perform other membership tasks from the back end using information given in the [Membership](https://wiki.comdev.eu/books/jomevents/page/membership "Membership") section of the Administrator's Guide.</div><div bis_skin_checked="1" class="confluence-information-macro-body"></div></div></div>The following screen shows the Membership details for the user.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/bmWobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/bmWobraz.png)

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735407/userguide_membership_jv1.jpg)</span>

**Screen 1: Membership details**

To upgrade the user membership plan you can either click **Upgrade Your Membership NOW** or click the Membership Plans tab on the Front Admin page. The membership plans that are available for upgrade are shown as seen in the following image.

The Membership Plans tab on the Front Admin page is available only if you are logged in as a company.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/Zujobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/Zujobraz.png)

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735407/userguide_membership_jv3.jpg)</span>

**Screen 2: Membership plans**

Click **Upgrade** to upgrade to the higher plan. You can then select an appropriate mode of payments and complete the transaction.

<div bis_skin_checked="1" class="wiki-content" id="bkmrk-to-see-the-upgrade-b"><div bis_skin_checked="1" class="confluence-information-macro confluence-information-macro-note conf-macro output-block" data-hasbody="true" data-macro-name="note"><div bis_skin_checked="1" class="confluence-information-macro-body">To see the Upgrade button for any plan, ensure that you have configured PayPal or other payment gateway details. For more information, see [PayPal Configuration](https://wiki.comdev.eu/books/installation-requirements-language/page/paypal-configuration "PayPal Configuration").</div></div></div><div bis_skin_checked="1" class="wiki-content" id="bkmrk--4"><div bis_skin_checked="1">  
</div></div>

# Profile & Settings (User Profile)

## Overview

After creating a user, a user can edit his profile details such as password, email address, language settings, timezone settings, and much more.

To edit your profile, from the Front Admin, click **Profile**n.

### Editing a profile

On the Profile screen, click **Edit Profile**

The following screen shows the different fields you can edit for a profile.![](https://wiki.comdev.eu/download/attachments/5735000/Profile_Edit1.jpg)

Provide the values as given in the following table.

<div id="bkmrk-edit-your-profile-na"><table><tbody><tr><td>##### Edit Your Profile

</td><td>Name

</td><td>Provide a name.

</td></tr><tr><td> </td><td>Username

</td><td>Cannot be edited.

</td></tr><tr><td> </td><td>Password

</td><td>Provide a new password.

</td></tr><tr><td> </td><td>Confirm Password

</td><td>Confirm the new password.

</td></tr><tr><td> </td><td>Email Address

</td><td>Provide a new email address.

</td></tr><tr><td> </td><td>Confirm email Address

</td><td>Confirm the new email address.

</td></tr><tr><td>##### Basic Settings

</td><td>Editor

</td><td>Select one of the following:

- Editor – CodeMirror
- Editor-none
- Editor-TinyMCE

</td></tr><tr><td> </td><td>Timezone

</td><td>Select a timezone.

</td></tr><tr><td> </td><td>Frontend language

</td><td>Select the required language for front end.

</td></tr><tr><td> </td><td>Backend Template Style

</td><td>Select from the available templates or keep as default.

</td></tr><tr><td> </td><td>Backend language

</td><td>Select the required language for back end.

</td></tr><tr><td> </td><td>Help Site

</td><td>Select from the available Help site options for your required language.

</td></tr><tr><td>##### Additional Options

</td><td>Logo

</td><td>Click Choose File to select an image for the user profile picture.

</td></tr><tr><td> </td><td>Eventbrite User Key

</td><td>Provide the key for JomEvent extension.

</td></tr><tr><td> </td><td>Plan expiry

</td><td>This field is controlled by the site admin.

</td></tr></tbody></table>

</div>To save the settings you changed, click Submit. If you click the **Settings** link on the Front Admin screen, it will take you to the **Edit Profile** page.