# 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 JomEstate 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 JomEstate 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/jomestate/page/menu-items "Menu Items") documentation.

### Accessing the dashboard

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

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

<p class="callout warning">You can access Front Admin either as an agent or a company. Based on the login used, the pages displayed change too.</p>

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

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

**Screen 2: Dashboard screen for company login**

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

<div bis_skin_checked="1" class="wiki-content" id="bkmrk-report-most-viewed-g"><div bis_skin_checked="1" class="table-wrap"><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid" style="padding: 0px; width: 100%;"><tbody aria-live="polite" aria-relevant="all"><tr role="row"><td class="confluenceTd" style="width: 16.1879%;">##### Report

</td><td class="confluenceTd" style="width: 16.6922%;">Most Viewed graph

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

</td></tr><tr role="row"><td class="confluenceTd" style="width: 16.1879%;">##### Membership

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

</td><td class="confluenceTd" 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.

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

</td></tr><tr role="row"><td class="confluenceTd" style="width: 16.1879%;">##### Profile

</td><td class="confluenceTd" style="width: 16.6922%;">Profile

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

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

</div></div><div bis_skin_checked="1" id="bkmrk--1"></div>

# 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.

![](https://wiki.comdev.eu/download/attachments/5735706/frontadmin_listings.jpg)

**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: 15.9336%;">**Area**

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

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

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

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

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

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Text Area

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

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Short Description

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

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

</td><td style="width: 73.9184%;">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: 15.9336%;"> </td><td style="width: 10.2716%;">Page Break *Button*

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

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

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

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Read More Button

</td><td style="width: 73.9184%;">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: 15.9336%;"> </td><td style="width: 10.2716%;">Status

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

- Published
- Unpublished
- Trashed
- Archived

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Featured

</td><td style="width: 73.9184%;">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: 15.9336%;"> </td><td style="width: 10.2716%;">Language

</td><td style="width: 73.9184%;">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: 15.9336%;"> </td><td style="width: 10.2716%;">Category

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

</td></tr><tr><td colspan="1" style="width: 15.9336%;">Category Type</td><td colspan="1" style="width: 10.2716%;">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: 15.9336%;">Energy Class</td><td colspan="1" style="width: 10.2716%;">Select the energy class for the listing.</td></tr><tr><td style="width: 15.9336%;">**Address area**

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

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

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Full address

</td><td style="width: 73.9184%;">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: 15.9336%;">**Location area**

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

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

Provide the latitude information for the location mapping.

</td></tr><tr><td style="width: 15.9336%;"> </td><td style="width: 10.2716%;">Maps longitude

</td><td style="width: 73.9184%;">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: 15.9336%;"> </td><td style="width: 10.2716%;">Maps Search

</td><td style="width: 73.9184%;">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/jomestate/page/custom-fields "Custom Fields").

#### Price tab

This tab includes pricing information for the listing.

![](https://wiki.comdev.eu/download/attachments/5735706/frontadmin_listings3.jpg)

**Screen 4: Price tab**

Provide the options as given in the following table.

<div id="bkmrk-add-new-click-to-add"><table><tbody><tr><td>Add New</td><td>Click to add a new pricing item.</td></tr><tr><td colspan="1">Price Netto</td><td colspan="1">Provide a value.</td></tr><tr><td colspan="1">Price Group</td><td colspan="1">Select from the Pricing options you have created for the site.</td></tr></tbody></table>

</div>#### 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:

1. Click **Add Image**.
2. 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.

1. <div><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>
    
    </div>
2. Click **Save**.

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.

<div data-hasbody="true" data-macro-name="note" id="bkmrk--3">  
</div><p class="callout info">Attachments are detected automatically based on file extension that’s are allowed in Configuration.</p>

<div data-hasbody="true" data-macro-name="info" id="bkmrk--4"></div><p class="callout warning">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.</p>

# 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.

<p class="callout info">User membership plan can 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/jomestate/page/membership "Membership") section of the Administrator's Guide.</p>

The following screen shows the Membership details for the user.

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735705/membership_userguide.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.

<div bis_skin_checked="1" class="wiki-content" id="bkmrk--1"><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">  
</div></div></div>The Membership Plans tab on the Front Admin page is available only if you are logged in as a company.

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.comdev.eu/download/attachments/5735705/membership_userguide1.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><span class="confluence-embedded-file-wrapper">![](https://wiki.comdev.eu/download/attachments/5735705/userguide_membership_jv2.jpg)</span>

**Screen 3: PayPal configurations**

<div bis_skin_checked="1" class="wiki-content" id="bkmrk--4"><div bis_skin_checked="1">  
</div></div>

# Listings Messages

{{@111}}

# Adding a new Agent

### Overview

You can add agents that belong to your company and provide them separate access. The agents are listed in the Agents tab under Front Admin as shown in the following image.

![](https://wiki.comdev.eu/download/attachments/7439044/Agents_userguide.jpg)

**Screen 1: Agents tab**

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 Agent

To add a new agent to the company, click Insert New from the Agents tab.

![](https://wiki.comdev.eu/download/attachments/7439044/Agents_userguide1.jpg)

**Screen 2: Adding a new agent**

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

# 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** as shown in the following screen.

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

**Screen 1: Profile screen**

### Editing a profile

On the Profile screen, click **Edit Profile** as shown in the following screen.

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

**Screen 2: Edit Profile screen**

The following screen shows the different fields you can edit for a profile.

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

**Screen 3: Edit profile fields**

Provide the values as given in the following table.

<div bis_skin_checked="1" class="table-wrap" id="bkmrk--3">  
</div><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" id="bkmrk-edit-your-profile-na" role="grid" style="padding: 0px;"><tbody aria-live="polite" aria-relevant="all"><tr role="row"><td class="confluenceTd">##### Edit Your Profile

</td><td class="confluenceTd">Name

</td><td class="confluenceTd">Provide a name.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Username

</td><td class="confluenceTd">Cannot be edited.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Password

</td><td class="confluenceTd">Provide a new password.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Confirm Password

</td><td class="confluenceTd">Confirm the new password.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Email Address

</td><td class="confluenceTd">Provide a new email address.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Confirm email Address

</td><td class="confluenceTd">Confirm the new email address.

</td></tr><tr role="row"><td class="confluenceTd">##### Basic Settings

</td><td class="confluenceTd">Editor

</td><td class="confluenceTd">Select one of the following:

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

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Timezone

</td><td class="confluenceTd">Select a timezone.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Frontend language

</td><td class="confluenceTd">Select the required language for front end.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Backend Template Style

</td><td class="confluenceTd">Select from the available templates or keep as default.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Backend language

</td><td class="confluenceTd">Select the required language for back end.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Help Site

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

</td></tr><tr role="row"><td class="confluenceTd">##### Additional Options

</td><td class="confluenceTd">Logo

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

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Eventbrite User Key

</td><td class="confluenceTd">Provide the key for JomEstate extension.

</td></tr><tr role="row"><td class="confluenceTd"></td><td class="confluenceTd">Plan expiry

</td><td class="confluenceTd">This field is controlled by the site admin.

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