# JOMESTATE
# Quick Start - JomEstate
### Overview
This guide will help you get started with using the JomEstate extension quickly. It highlights preliminary steps that are a must for JomEstate configurations. After you are done with them, you can go ahead and create the listings on your site.
### Creating Administration Menu Links
This step is not needed if new installation being made.
Go to the System -> Administrator modules and insert new. Than choose Administrator Menu. From the presets, select Comdev and place it under menu position. Do the same for the JomEstate:
### Creating Menu Links
Menus are used to control website navigation. A menu contains one or more menu items which provides your users with a navigational experience.
The menu items in our case must point to the JomEstate. It is mandatory that you create menu links such that Items menu and the Front Admin access is created.
Get started with creating menu links using the information given in the [Menu Items](https://wiki.comdev.eu/books/JomEstate/page/menu-items "Menu Items") documentation in the Administrative Guide.
### Creating Groups
In order to add users to groups for membership plans, you must create a super group named JomEstate, then create groups for each of your membership plans underneath your super group. 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 begin creating groups for membership plans, follow the [Creating a Group](https://wiki.comdev.eu/books/JomEstate/page/membership "Membership") documentation in the Administrative Guide.
### Creating Membership Plans and Memberships
Memberships in JomEstate are required to set user group level based on the monthly/Yearly pay plan the user selects. Using membership plans, you can decide how much to charge a user and how many listings a user can make a particular membership plan.
Before you can create a membership plan, you must create Joomla groups using the above section information. Read more about creating membership plans for your site using the [Memberships](https://wiki.comdev.eu/books/JomEstate/page/membership "Membership") section in the Administrative Guide.
### Adding a New Address
The Address feature lets you provide the country, region and city for the associated product listing. The advantage with the Address field in JomEstate is that after you configure a particular address, it is shared across various components in the Comdev extension.
Get started with creating addresses that will be used in your listings by referring to the [Address](https://wiki.comdev.eu/display/JD2/Address) documentation in the Administrative Guide.
### Adding a New Category
Categories allow the site owner to categorise listings into appropriate sections. JomEstate categories are independent of the Joomla category system. Nested categories (sub-categories) are supported in JomEstate. The component comes with a default category named "UNCATEGORIZED", which holds listing items that are not attached to any category (same function as the default Joomla system).
To start creating categories, follow the [Categories](https://wiki.comdev.eu/books/JomEstate/page/categories "Categories") documentation in the Administrative Guide.
### Adding Custom Fields
Custom fields are a powerful tool to build content. We provide a variety of field types with the ability to outline into groups. Each field can be assigned to a single category or all categories. Custom fields in JomEstate provide multiple options such as dropdowns, text area, radio buttons, and so on. Based on your requirement create a custom field and make it searchable for better user experience.
Read more about how to create custom fields in the [Custom Fields](https://wiki.comdev.eu/books/JomEstate/page/custom-fields "Custom Fields") section from the Administrative Guide.
### Creating a New Listing
Listings are nothing but the product listings that you want to create in the directory. 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 the definition.
Get started with creating listings for each category by referring to the [Listings](https://wiki.comdev.eu/books/JomEstate/page/listings "Listings") section in the Administrative Guide.
# Configuration Steps
### Overview
These configuration steps need to be done in order for the component to work correctly
### Create Menu links
More about menu links can be [found here.](https://wiki.comdev.eu/books/jomestate/page/menu-items "Menu Items")
Items menu link needs to be created.
### Joomla / Groups
Membership Plans are based on the Joomla Groups therefore before creating any of the Membership plans - corresponding Joomla groups needs to be created. The main group for the component needs to be called JomEstate. Each of the plans needs to be placed under that JomEstate parent group e.g.
**JomEstate**
- Free
- Basic
- Silver
- Gold
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/YLAobraz.png)
### Permissions
It is important to set the right permissions for the components: Comdev and Directory, in order for the users to access the Front Admin. Otherwise, Users won't be able to access the Front Admin (Permissions Denied) or get 500 Error when trying to upload the images.
An example below shows access for the Registered Group. Same settings should be applied for each group that should have access to the Front Admin.
#### Setting permissions for the Comdev Extension
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/3m6obraz.png)
#### Setting permissions for the JomEstate Extension
[](https://wiki.comdev.eu/uploads/images/gallery/2024-02/2iOobraz.png)
# Menu Items
### Overview
In this section, we will learn how to create menu items to access JomEstate.
Menus are used to control website navigation and are a set of menu items. Menu items provide the navigational experience to your users. The menu items in our case must point to the JomEstate.
### Creating Administration Menu Links
This step is not needed if new installation being made.
Go to the System -> Administrator modules and insert new. Than choose Administrator Menu. From the presets, select Comdev and place it under menu position. Do the same for the JomEstate
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/screenshot-2021-12-22-19-30-33-536.jpeg)
### Creating Menu Items to access JomEstate
Creating an Items menu link is mandatory. If you have a multilingual site, ensure that **you create an Items menu link for each language.** You can hide this menu link, but it needs to be create nonetheless. Though you are creating an Items link that does not point to any category or address, you can create other links with Items menu type that can point to an address or a category once main Items link has been created.
To create menu items with Items menu item type, do the following:
1. Click **Menus** > **<your\_menu>** > **Add New Menu Items**.
2. Provide a title in our case is **Latest Listings** in the **Menu Title** field. Now, since the Latest Listings menu item provides a list of all the latest postings on the site, we have selected the menu type as Items. The Alias field will build URL for the site. When search is done this will be the landing page for the search results as well.
3. Provide the options as seen in the following image:
[](https://xwiki.comdev.eu/uploads/images/gallery/2024-02/huVobraz.png)
**Screen 3:** Items menu item screen
Provide the values based on the following table.
1.
2. Click **Save**.
Ensure that you see a green tick next to this menu item. The green tick indicates that the item is published. To publish an item, select the checkbox next to the item and click **Publish**.
To view the created menu item, go the front end of your site. The new menu item is displayed.
### Creating Menu to access JomEstate Front Admin
To create menu items with Front Admin menu item type, do the following:
1. Click **Menus** > **<your\_menu>** > **Add New Menu Items**.
2. Provide a title as **Front Admin** and the alias as **front-admin** in the Menu Title field.
3. Provide the options as seen in the following image:
[](https://xwiki.comdev.eu/uploads/images/gallery/2024-02/HiSobraz.png)
**Screen4:** JomEstate Front Admin menu item screen
4. Click **Save**.
Front Admin Options
For the Menu to be able to access the JomEstate Front Admin, certain settings need to be made. The following table shows the three menu links that need to be made and linked with JomEstate Options. You can create these 3 menu items anywhere on the site e.g. link them under User Menu.
**Now link menus with JomEstate Options**:
Make the following settings for the Front Admin are made in the JomEstate options for the user to be redirected correctly to the Front Admin, when he is not logged in.
1. Click **System** > **Control Panel**.
2. Under **Extensions**, click **JomEstate**.
3. Click **Options** in the top right-hand corner of the screen.
4. Click the **Front Admin** tab.
5. Change the **Profile Menu Link**, **Login Menu Link**, and **View Profile Menu Link** field as per the following image.
**Screen5:** JomEstate Front Admin options
6. Click **Save**.
The Front Admin lets users add listings in the front of the site. For more information about how to add listings, see [Front Admin](https://wiki.comdev.eu/books/jomestate/page/front-admin-overview "Front Admin Overview"). The following image shows the Front Admin.
**Screen 6:** Front Admin screen
# Administrator's Guide
# Dashboard
### Overview
Administration dashboard gives you an overview of all the activities you can do using the JomEstate 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 JomEstate extension
|
| Address | Shows the Address administration screen |
| Custom Fields
| Shows the Custom Fields administration screen
|
| Categories
| Shows the Categories administration screen
|
| Price Types | Shows the Price Types administration screen |
| Property Types | Shows the Property Types administration screen |
| Companies | Shows the Companies administration screen |
| Agents | Shows the Agents administration screen |
| Membership Plans
| Shows the Membership Plans administration screen
|
| Messages
| Shows the messages received
|
| Add New | Click to quickly add a listing to the site |
| Documentation
| Access the JomEstate documentation.
|
| **Title**
| Title for the Property Type.
|
| **Alias**
| URL alias for “SEF/SEO” URL.
|
| **Parent**
| Choose the parent category item.
|
| **Text area**
| Provide a description in the text area.
|
| **Toggle editor *Button*** | Click to toggle between rich text and plain text editor. |
| **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 *Button*** | Click to select an image you want to add to the listing. |
| **Category Image** | Currently not being used. |
| **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 property type.
|
| **ID**
| Address 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.
|
| 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 area
| Title
| Title for the Listing.
|
| | Alias
| URL alias for “SEF/SEO” URL.
|
| | Category
| Category where the listing will be published.
|
| Property Type | Select the property type from the drop down. |
| | 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/pv9obraz.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.
|
| | Page Break *Button*
| Insert a page break in the displayed text.
|
| | Toggle editor *Button*
| Toggle between plain text and rich text editor
|
| ##### Address area
| Address
| Address of the listing
|
| | Street, House No.
| Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.
|
| ##### Location area
| Maps latitude
| It utilizes the GEO-location based on Google Maps.
Provide the latitude information for the location mapping.
|
| | Maps 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.
|
| | Maps Search
| Search for a specific location. Type in the location and press Enter to go to the exact location.
|
| ##### Sidebar
| 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/JE/Multilingual+Site), you must create separate entries for each language.
|
| | Status
| Select the required status.
- Published
- Unpublished
- Trashed
- Archived
|
| | Created by
| Select the user who created 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.
|
| Add New | Click to add new pricing category. You can provide weekly, monthly, and other offers per listing.
|
| Price Netto | Provide the pricing value. |
| Price Group | Select from the following options:
- Price
- Price per day
- Price per week
- Price per month
- Auction
- Offers from
After installation, the price types are not defined. You should insert [your own](https://wiki.comdev.eu/display/JE/Price+Types), they will be populated in this drop-down field. When searching, price type always needs to be provided as part of the search criteria. |
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.
|
| | 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 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 .
|
| ##### YouTube Video
| Provide the YouTube video URL in this field as shown in the following image.
|
---
#### Opeh House Calendar tab
This tab includes an ajax calendar where you can add the date-wise information related to the listing. Based on the services you offer, you can show the availability for that service.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/0ZKobraz.png)**Screen 8: Open House**
To set the availability for a range of dates, drag and click the required range of dates. Provide the information about availability as shown in the following image.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/tNEobraz.png)**Screen 9: Availability information**
Click Save to save the availability information. If you want to delete a particular entry, click the colored band of availability and click OK as shown in the following image.
# Price Types
### Overview
Price types allow the site owner to categorize price types into appropriate sections. Nested price types (sub-price types) are supported in JomEstate. JomEstate comes with a price type named "**UNCATEGORISED**" which is the default setting. This price type will list properties which are not attached to any price type (same function as the default Joomla categories system).
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/wCZobraz.png)**Screen 1: Price type listing**
### Creating A New Price Type
To add a Price type to JomEstate, click New.
Provide the values as given in the following table.
| **Title**
| Title for the price type.
|
| **Alias**
| URL alias for “SEF/SEO” URL.
|
| **Parent**
| Choose the parent category item.
|
| **Text area**
| Provide a description in the text area.
|
| **Toggle editor *Button*** | Click to toggle between rich text and plain text editor. |
| **Image *Button*** | Click to select an image you want to add to the listing. |
| **Category Image** | Currently not being used. |
| **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 price type.
|
| **ID**
| Address 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.
|
- This user needs to be unique for each Company or Agent
- When adding an Agent from the Front Admin by the Company, Joomla user account needs to be created for that Agent
- Agent does **NOT** have any membership.The Agent inherits the membership details of the company he belongs to.
- Public User who can add listings.
- Companies that have Agents.
| Options | **Usage** |
|---|
| **Name**
| Title for the Company.
|
|---|
| **Alias**
| URL alias for “SEF/SEO” URL.
|
|---|
| **Logo**
| Click to upload the company logo. This logo will be seen on the company tab on listings and item view.
|
|---|
| **Phone** | Provide the phone number for your company. |
|---|
| **Website** | Provide the website URL for your company. |
|---|
| **Background** | Set desired tab background color to match the Company logo. |
|---|
| **User**
| Select a Joomla user account that will be assigned to the Company. **It has to be unique for each Company**.
|
|---|
| **Membership**
| Choose a membership plan assigned for the Company.
|
|---|
| **Address**
| Select the appropriate locations to provide your address.
|
|---|
| **Street, House no.**
| Detailed address like street and house number. |
|---|
| **Intro text**
| Provide a short description about the company.
|
|---|
| **Text area** | Provide a description for the listing.
You can create a short description as well a long description.
|
|---|
| **Article *Button***
| Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.
|
|---|
| **Page Break *Button***
| Insert a page break in the displayed text.
|
|---|
| **Toggle editor *Button***
| Toggle between plain text and rich text editor
|
|---|
| **Read More** | Click to separate the short description in the text area.
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. |
|---|
| **Add Image** | Click to upload images to the company gallery. |
| **Images area** | 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.
|
| Options | **Usage** |
|---|
| **First Name**
| First Name
|
|---|
| **Last Name** | Last Name |
|---|
| **Status** | Select from the following status:
- Published
- Unpublished
- Archived
- Trashed
|
|---|
| **Alias**
| URL alias for “SEF/SEO” URL.
|
|---|
| **Image**
| Upload a photo of the Agent.
|
|---|
| **Phone** | Provide the phone number of the agent. |
|---|
| **Website** | Provide the website URL of the company or agent's personalized page.
|
|---|
| **Fax** | Provide the fax number of the agent. |
|---|
| **User**
| Select a Joomla user account that will be assigned to the Agent. It has to be unique for each Agent.
|
|---|
| **Company** | Choose a Company that Agent belongs to. |
|---|
| **Address**
| Select the required address levels to create the address of the agent.
|
|---|
| **Street, House no.**
| Detailed address like street and house number. |
|---|
| **Text area**
| Provide a description for the listing.
You can create a short description as well a long description.
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.
|
|---|
| **Page Break *Button***
| Insert a page break in the displayed text.
|
|---|
| **Toggle editor *Button***
| Toggle between plain text and rich text editor
|
|---|
| **Read More** | Click to separate the short description in the text area. |
|---|
| **MSN** | Provide the msn id of the agent. |
|---|
| **Google Talk** | Provide the google talk id of the agent. |
|---|
| **Skype** | Provide the skype id of the agent |
|---|
| **Twitter** | Provide the twitter handle of the agent. |
|---|
| **ID** | This field is auto-populated. |
|---|
Name **JomEstate** for the main group is mandatory, however groups for membership under that group can have any names e.g. Lite, Pro or Free, Basic etc...
Users, which belongs to Joomla group JomEstate, 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 JomEstate 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.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/A5Cobraz.png)
**Screen 1: General tab**
The following table explains the different options seen on the screen.
#### 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/6dAobraz.png)
**Screen 2: Media tab**
The following table explains the options seen on the screen.
#### Currency & Price tab
This tab provides options to control display of currency formats for listings.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/hpXobraz.png)
**Screen 3: Currency & Price tab**
The following table explains options seen on the screen.
#### Integrations tab
This tab provides options to control map integration for listings.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/EdGobraz.png)
**Screen 4: Integrations tab**
The following table explains the options seen on the screen.
#### Front Admin
This tab controls how the menu links are seen on the front admin for JomEstate. It also provides other options related to front admin.
[](https://wiki.comdev.eu/uploads/images/gallery/2024-03/51sobraz.png)
**Screen 5: Front Admin tab**
The following table explains the options seen on the screen.
#### Permissions
This tab provides options to control permissions for different groups.
For more information about how to configure permissions, see the Joomla documentation.
# 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**.
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.
**Screen 2: Dashboard screen for company login**
You can click the options as seen in the following 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.
**Screen 1: Listing screen**
The following table explains the different options seen on the screen.
## 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:
| **Area**
| **Options**
| **Usage**
|
| **Edit Listing area**
| Title
| Title for the Listing.
|
| | Text Area
| Provide a description for the listing.
|
| | Short Description
| Provide a short description for the listing.
|
| | Article *Button*
| Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.
***Buttons*** for the editor are available when enabled under Site Backadmin -> Plugins and WYSIWYG editor turned On in Joomla Configuration. |
| | Page Break *Button*
| Insert a page break in the displayed text.
|
| | Toggle editor *Button*
| Toggle between plain text and rich text editor
|
| | Read More Button
| Insert a separation for creating short description. Any content above the dotted line is displayed as the short description.
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. |
| | Status
| Select the required status.
- Published
- Unpublished
- Trashed
- Archived
|
| | Featured
| Enable to make the listing appear as featured listing.
Feature Count is being checked when saving listing for the selected Membership Plan. |
| | Language
| 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.
|
| | Category
| Category where the listing will be published.
|
| Category Type | Category Type such as house, apartment and so on based on the category types for your site. |
| Energy Class | Select the energy class for the listing. |
| **Address area**
| Address
| Address of the listing
|
| | Full address
| Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.
|
| **Location area**
| Maps latitude
| It utilizes the GEO-location based on Google Maps.
Provide the latitude information for the location mapping.
|
| | Maps 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.
|
| | Maps Search
| Search for a specific location. Type in the location and press Enter to go to the exact location.
|
| Add New | Click to add a new pricing item. |
| Price Netto | Provide a value. |
| Price Group | Select from the Pricing options you have created for the site. |
| Title or alias
| Provide a title for the Image.
|
| Categories
| Select from the following options:
- Slideshow - detailed view main gallery
- Gallery - in gallery tab
- Features- displayed under features.
|
| Status
| Select the required status.
- Published
- Unpublished
|
| Order
| Order in which you want the image to appear.
|
| File
| Click Choose File and provide the image.
|
| Description
| Provide a description about the image.
|
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.
# 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.
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.
The following screen shows the Membership details for the user.
**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.
**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.
**Screen 3: PayPal configurations**
# 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.
**Screen 1: Agents tab**
You can select what to do next based on the following table.
| Insert New | Click to add a new agent information. |
| Publish | Click to publish the agent information. |
| Unpublish | Click to unpublish agent information. |
| Delete | Click to delete the agent information from the site. |
# Modules
# Latest Items Module
### Overview
This module helps you create the panel where latest listings are displayed. You can decide where to position the latest panel on the page and also control on which pages the panel should appear. To view all the available modules, click **Extension** > **Module Manager**. The modules available are listed as seen in the following image.
**Screen 6: Module Manager listing**
### Editing the JomEstate Latest module
To edit the module, click on the module link or select the check box next to the module name, and then click **Edit**.
The following image shows the module edit screen.
#### Module tab
This tab controls the layout where the latest listings panel is to be displayed on the screen.
**Screen 8: Module tab**
Provide the options as per the following table.
| **Layout**
| Select the required layout in the Layout field. The available options are:
- Slider – Displays the latest listings in the form of a slideshow.
- Default –Displays the latest listings in default format.
|
| **Count**
| Number of listings that should be listed in the panel.
|
| **Number of Characters**
| Number of characters that will be displayed in the short description for listing thumbnail.
|
| **Image Width**
| Provide the image width for the thumbnail image.
If Slider Layout set, image width must be same size than Slider Width or larger. |
| **Image Format**
| The format for the thumbnail 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.
|
| **Featured**
| Enable to show only featured listings.
|
| **Show Address**
| Enable to show the address of the listing.
|
| **Custom Fields** | Enable to show custom fields. |
| **Short Description** | Enable to show short description along with the listing image. |
| **Show Category** | Enable to show category for the listing. |
| **Show Price** | Enable to show the listing price. |
| **Category**
| Enable either of the following options.
- Current Browse (auto) – Automatically displayed based on the category.
- Selected Below – Listings belonging to only these categories are shown.
|
| **Choose Category**
| If Selected Below is selected for the above field, select the required category.
|
| **Sort Options**
| Select how the displayed listings should be sorted by.
- Latest
- Most Viewed
- Alphabetically
- Updated
- Most Rated DESC
- Most Rated ASC
|
| **Slider Width**
| Slider width in pixels
|
| **Slider Height**
| Slider height in pixels
|
| **Slide Delay (seconds)**
| Slideshow delay in seconds
|
| **Slider Shadow**
| Enable to provide the shadow effect.
|
| **Slider Thumbs**
| Enable to show image thumbnails
|
| **Slider Caption**
| Enable to show the image caption.
|
| **Show Title**
| Show or hide the title for the search panel.
|
| **Position**
| Select the position based on your Joomla Template.
|
| **Status**
| Select from the given options.
- Published
- Unpublished
- Trashed
|
| **Start Publishing**
| Provide a date when the latest listings panel should be published.
|
| **Finish Publishing**
| Provide a date when the latest listings panel should be unpublished.
|
| **Access**
| Provide access level for the panel.
- Guest
- Public
- Registered
- Special
|
| **Ordering**
| Provide the order in which the side panel should appear. If more than one module is positioned at the same location, you can set the order of appearance in this field.
|
| **Language**
| Select the language for which you want to display this panel. For each language, you must create a new JomEstate Latest module.
|
| **Note**
| Provide additional information.
|
| **Layout**
| Select the required layout in the Layout field. The available options are:
- Address – Horizontal Keyword field, category and address search field as seen in the following image:
- Side Search – Vertical Side panel to filter search results as seen in the following image:
Custom fields that have the Field can be Searched field enabled are seen in this panel. For more information, see [Custom Fields](https://wiki.comdev.eu/display/JE/Custom+Fields) in the Administrative Guide. |
| **Show Title**
| Show or hide the title for the search panel.
|
| **Position**
| Select the position based on your Joomla Template.
|
| **Status** | Select from the following options.
- Published
- Unpublished
- Trashed
|
| **Start Publishing**
| Provide a date when the search panel should be published.
|
| **Finish Publishing**
| Provide a date when the search panel should be unpublished.
|
| **Access**
| Provide access level for the panel.
- Guest
- Public
- Registered
- Special
|
| **Ordering**
| Provide the order in which the side panel should appear. If more than one module is positioned at the same location, you can set the order of appearance in this field.
|
| **Language**
| Select the language for which you want to display this panel. For each language, you must create a new JomEstate Search module.
|
| **Note**
| Provide additional information.
|