JOMHOLIDAY

Booking Extension & Plugins 

Quick Start - JomHoliday

Overview

This guide will help you get started with using the JomHoliday extension quickly. It highlights preliminary steps that are a must for JomHoliday 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 JomHoliday:

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 JomHoliday. 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 documentation in the Administrative Guide.

Creating Groups

In order to add users to groups for membership plans, you must create a super group named JomHoliday, 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 documentation in the Administrative Guide.

Creating Membership Plans and Memberships

Memberships in JomHoliday 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 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 JomHoliday 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 documentation in the Administrative Guide.

Adding a New Category

Categories allow the site owner to categorise listings into appropriate sections. JomHoliday categories are independent of the Joomla category system. Nested categories (sub-categories) are supported in JomHoliday. 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 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 JomHoliday 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 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 section in the Administrative Guide.

Configuration Steps

Overview

These configuration steps need to be done in order for the component to work correctly

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 JomHoliday. Each of the plans needs to be placed under that JomHoliday parent group e.g. 

JomHoliday

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

obraz.png


Setting permissions for the JomHoliday Extension

obraz.png

Menu Items

Overview

In this section, we will learn how to create menu items to access JomHoliday. 

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

Creating Administration Menu Links

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 JomHoliday:

screenshot-2021-12-22-19-30-33-536.jpeg

Creating Menu Items to access JomHoliday

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:

    Screen 3: Items menu item screen

    obraz.png


    Provide the values based on the following table.

  1. Menu Item Type

    Click Select. A pop up is displayed. In this case, since we are creating the Items menu item, click Directory > Items from the list.

    Category

    Select the appropriate category, if creating direct category link.

    Address

    Select the appropriate address if, creating direct address link.

    Link

    This field is auto populated based on the menu item type selected.

    Target Window

    Select the parent for this menu item.

    Template Style

    Select the template style you want for this menu.

  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. 


It is very important to notice that listing details and proper URL's does not build if the category menu is missing (each category must have a link). You have to ensure that for each category on your site, you create a corresponding link in the Joomla menu. The best approach is to create a separate Joomla menu e.g. Categories and link each category there.

Creating Menu to access JomHoliday 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:

    Screen4: JomHoliday Front Admin menu item screen

  4. Click Save.

Front Admin Options

For the Menu to be able to access the JomHoliday Front Admin, certain settings need to be made. The following table shows the three menu links that need to be made and linked with JomHoliday Options. You can create these 3 menu items anywhere on the site e.g. link them under User Menu.

Profile Edit Menu Link

This link should point to Edit profile menu item created using Edit User Profile menu item type.

  1. Click Menu > <your_menu>>Add New Menu Item.
  2. Provide the Title as Edit Profile and the menu item type as Edit User Profile.
  3. Click Save.
 

This link should point to the login form menu item created using Login Form menu item type.

  1. Click Menu > <your_menu>>Add New Menu Item.
  2. Provide the Title as Login Form and the menu item type as Login Form.
  3. Click Save.

 The following image shows how the Login Form menu item is used

Bez nazwy.jpeg

When user is not logged into the front page, he will be redirected to the built-in Joomla login form. After successful login, he will be redirected to the JomHoliday Front Admin.
The following image shows the redirect URL that needs to be provided. The value you provide in the Login Redirect field depends on the following:

  • http://domain.com/index.php/front-admin - Use if URL rewriting is not applicable.
  • http://domain.com/front-admin - Use if URL rewriting is applicable.

In our example, we are using the http://domain.com/front-admin URL as shown in the following image where front-admin is the alias of the JomHoliday Front Admin Menu Link:

Profile View Menu Link

This link should point to the user profile created using User Profile menu item type.

  1. Click Menu > <your_menu>>Add New Menu Item.
  2. Provide the Title as User Profile and the menu item type as User Profile.
  3. Click Save.

Make the following settings for the Front Admin are made in the JomHoliday 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 JomHoliday.
  3. Click Options in the top right-hand corner of the screen.
  4. Click the Front Admin tab. 
  5. Change the Profile Menu LinkLogin Menu Link, and View Profile Menu Link field as per the following image.

    Screen5: JomHoliday 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 Listings

Administrator's Guide

Administrator's Guide

Dashboard

Overview

Administration dashboard gives you an overview of all the activities you can do using the JomHoliday 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 menu items are present in a grid format format for easy access. The following image shows the Menu items present on the dashboard screen.

Screen 2: Menu items area

The following table provides an explanation about different menu items available:

Dashboard

Home or dashboard for the JomHoliday extension

Listings

Shows the Listings administration screen

Categories

Shows the Categories administration screen

Custom Fields

Shows the Custom Fields administration screen

Resource Custom Fields Shows the Resource Custom Fields administration screen

Addresses

Shows the Address administration screen

Business Types Shows the Business Types administration screen
Bookings Shows the Bookings administration screen
Booking Addons Shows the Booking addons administration screen

Membership Plans

Shows the Membership Plans administration screen

Messages

Shows the messages received

Reviews: Categories

Shows the Reviews administration screen to add review parameters for each category. For example, Quality, Customer Service, and so on.

Reviews: Recommended

Shows screen to add recommended audience for the listing or category. For example, For young people, Gizmodo, and so on.

Documentation

Access the JomHoliday 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

Administrator's Guide

Address

Overview

The Address feature, as the name suggests, lets you provide the country, region and city for the respective product listing. The advantage with the Address field in Extensions is that after you configure a particular address, it is shared across various components in the Comdev extension.

Based on the depth of levels you want, such as the continent as Europe, country as the UK and region as Wales, you can configure the Address tree to have unlimited levels. The Address feature provides multilingual support. This means you can specify different names based on your language preference. For more information, see Languages.

Creating A New Address

The following image shows the Address Feature screen. To add an address, click Components > Comdev > Address. Click New to create a new address. 

obraz.png

Screen 1: New Address screen

Let us understand each of the buttons seen on the screen using the following table.

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.

Rebuild

Refreshes to incorporate the changes made to the entries in the Address feature.

Address Structure

The structure of the Address tree is maintained as follows in our example. You can create any structure as per your requirement.

 <Continent>

-- <Country>

-- – <Region>

-- – -- <City> 

Editing address entries

If you want to edit existing entries, you can either click the entry from the Address screen or select the check box next to the entry, and then click Edit.

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

Custom Address Field

Alias

URL alias for “SEF/SEO” URL

Parent

Select the parent address 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.

Category Image

Upload an address 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 address entry.

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.

Modified by

User name who modified the entry.

Modified Date

Date when the entry was modified.

Metadata tab

The metadata tab is used to provide metadata information for a particular address 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.

Meta Description

Meta-description for search-engine listings.

Meta Keywords

Meta Keywords for the search-engine

Author

Content author metadata.

Robots

Robots instructions:

  • Use Global
  • Index, Follow
  • No Index, Follow
  • Index, No Follow
  • No Index, No Follow
Administrator's Guide

Categories

Overview

Categories allow the site owner to categorize listings into appropriate sections. Extension categories are independent from the Joomla category system. Nested categories (sub-categories) are supported in Extension. Component comes with a category named "UNCATEGORIZED", which is the default setting. This category holds listing items that are not attached to any category (same function as the default Joomla system).

You can create a categories menu link under Menus using information provided here. Ensure that for creating this link you use the Item menu type as Categories.

Creating A New Category

The following image shows the Category Feature screen. 

obraz.png

Screen 1: Adding a new category

Let us understand each of the buttons seen on the screen using the following table.

New

Creates a new Category 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 in the Category feature.

Editing 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:

obraz.png

Screen 2: New Category tab

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

Custom Category Field

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.

Category Image

Upload a category image

Publishing tab

After you have provided the above information, you can provide the publishing information in the Publishing 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.

Modified by

User name who modified the entry.

Modified Date

Date when the entry was modified.

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. 

Meta Description

Meta-description for search-engine listings.

Meta Keywords

Meta Keywords for the search-engine

Author

Content author metadata.

Robots

Robots instructions:

  • Use Global
  • Index, Follow
  • No Index, Follow
  • Index, No Follow
  • No Index, No Follow
Administrator's Guide

Custom Fields

Overview

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 into a single category or all categories.

Creating a Custom Field

Creating a custom field involves setting certain options. To create a custom field, click New as shown in the following image.

obraz.png

Screen 1: Custom Field screen

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

New

Creates a new Custom Field.

Edit

Provides the edit mode to make changes to the existing level or titles created.

Publish

Publishes the created custom field.

Unpublish

Removes the entry from the list of published custom fields.

Archive

Archives custom fields that are not used anymore.

Trash

Deletes the custom fields that are not required anymore.

Options

Navigates to the Extension options screen.

Editing Custom Fields

If you want to edit existing entries, you can either click the entry from the Custom Fields screen or select the checkbox next to the entry, and then click Edit.

Custom Field Edit

After you click the required entry that you need to edit, you can change the configurations for the fields as shown in the following image.

obraz.png

Screen 2: Custom Field Edit tab

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

Custom Field Edit

Title

Title for the Custom Field.

 

Alias

URL alias for “SEF/SEO” URL.

 

Order

Provide a value from 1 onwards. The lowest value will appear on the top.

 

Field Required?

Enable whether to make the field required.

 

Category

Category where the Custom Field will be published.

When you select a custom field for a particular category, it is visible only for that category. While creating a listing if you select the said category and save, the custom field is available only then.
 

Field Type

Set the Field Type for the Custom Field. For more information, see the Field Type Table.

 

Field Database Type

Set the field type, needed for database settings.

  • String - Used for text
  • Decimal - Decimal number e.g. 10.060
  • Integer - Number e.g. 1232
 

Field Group

There are 5 custom field groups. Custom fields are grouped into groups. It has many advantages, one of them is display purposes. There are few groups available:

  • Items - group displayed on the listings page under the description
  • Item - group displayed on the left-hand side of the slideshow under detailed view.
  • Tabs - special group to create own Tabs in detailed view.
  • Features - special group for featured listings.
  • Paid Items - Paid group displayed on the listings page under the description.
  • Paid Item - Paid group displayed on the left-hand side of the slideshow under detailed view.

JomEstate, JomEvents only

  • Location - group displayed under the Location Tab in listing details.
Groups are static and cannot be created.
Paid groups are related to the membership plans that are applied to custom fields. Paid Items are displayed in the Items list, while the Paid Item is displayed in an Item (detailed) view.
 

Field Can Be Searched

Enable to make the field values searchable.

This setting applies only for the Search Module -> Layout Filter.
 

Field Search Type

Provide the type of search option to include:

  • Single Input Field Type
  • Range Input Field Type
  • Range Dropdown Field Type
  • Range Slider

Depending on the Field search type you select, the search criteria field will be displayed in the search module – layout side search.

This field is functional when the Field Type is selected as Input and Field can be searched set to Yes
 

Minimum Value

When, as an example, the Range Dropdown option is selected, you can select the range between which the options can be selected. For example, for Price range between X and Y, with incremental steps of 2, you can set x value in this field.

 

 

Maximum Value

Set the Y value for the range in this field.

 

Steps

Define the incremental steps. For example, for increments of x+2, provide the value as 2.

 

Custom Field Template

Custom fields have own templates that can be used and customized. There are 3 templates available:

  • default
  • horizontal
  • horizontal float 
  • horizontal float + icon
  • horizontal no label
  • default no label

If you would like to create and customize your own templates, see the Developer Guide.

 

ID

This field is auto - generated.

Custom fields values area

Add new

If the field type is selected to hold multiple values, this button lets you create the multiple values.

 

Delete

Delete the value.

Custom Field Values

This area lets you create values when the field type requires multiple options to be provided. 

For custom fields that can have values, to add multiple values, navigate to the custom fields listing screen. Click the  icon next to the field where you want to add values as shown in the following image.

obraz.png

Screen 3: Adding values to custom fields area

Here, the Field Type is selected as Checkbox and the Field Database Type has been stated as String. This means the Custom fields value area should provide options that can be seen when editing listing and displayed on the component front page. Hence, the Sample Values are provided in this area as Street, Garage, Underground. The following screen shows the values added at the back end. Click Delete to delete the entry.

obraz.png

Screen 4: Values added to custom field area

The following image shows how the field looks on the add listings page.

obraz.png

Screen 5: Custom Field as seen on new listing page

The custom field is seen on the listings page as shown in the following image:

obraz.png

Screen 6: Custom Field as seen on published listing page

Field Types

With Extension extension, you get several field types that you can create based on your requirement. The following image shows the available field types.

Screen 7: Field Types

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

Type

Multiple select

Multiple Values

Description

Radio button

No

Yes

Standard radio button with multiple values

Checkbox

Yes

Yes

Standard check boxes with multiple values

Dropdown

No

Yes

Dropdown (select) field with multiple values

Multiple Select

Yes

Yes

Select box with multiple values

Input

No

No

Single text box

Web Address

No

No

Single text box for URL, it will display as the link in the front page

Email

No

No

Single text box for email

Text

No

No

Text area

Date Time

No

No

Select a date and time from the Calendar icon on screen.

Date

No

No

Select a date from the Calendar icon on screen.

Editor textarea

No

No

Creates a rich text editor box, it can be combined with Tabs group.

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.

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.

Language

Select the language for the address entry.

To create a custom field that applies to a particular language, you need to select the appropriate language from the drop down. For each language that you want it to appear for, create a separate entry.

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.

JomEstate custom fields: Beds, Baths, Garage

For custom fields such as Bed, Bath, and Garage, icons are displayed alongside. To change the style css for these icons, edit the jomestate.css file located in the components/com_jomestate/assets/css folder. These icons are only available for the single language. If the site is multilingual than additional suffixes are added, therefore additional styles needs to be created.

.beds .jd-lab-horizontal-float-icon {background: url("../images/beds.png") 0 50% no-repeat;}
.baths .jd-lab-horizontal-float-icon {background: url("../images/baths.png") 0 50% no-repeat;}
.garage .jd-lab-horizontal-float-icon {background: url("../images/car.png") 0 50% no-repeat;}


Administrator's Guide

Listings

Overview

Listings are nothing but the product listings that you want to create in the site. 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.

obraz.png

Screen 1: Listing 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 check box 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:

obraz.png

Screen 2: Edit Listing screen

The following table shows the options available:

Edit Listing area

Title

Title for the Listing.

 

Alias

URL alias for “SEF/SEO” URL.

 

Category

Category where the listing will be published.

Business Type
Select the type of accomodation you need.
Advance Payment Required
Select the percentage of advance payment required from 0 to 100 percent.
 

Text Area

Provide a description for the listing.

You can create a short description as well a long description.

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

Choose Article

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 demarcate text that needs to be displayed as short description.
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

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.

 

Book Type

Select if you would like to add e.g. Apartment with resource or Tours 

 

Book Now Type

Select an Online Booking with build in calendar or by only Contact Form, 3'rd option is a redirect to external URL

 

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, you must create separate entries for each language.

 

Status

Select the required status.

  • Published
  • Unpublished
  • Trashed
  • Archived
Owner
Select the owner of the listing.
 

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.

 

Start Publishing

Select a date when you want to publish the listing. Here too, you can schedule to post the listing at a future date.

 

Finish Publishing

Select a date when the listing should stop being published.

 

Modified Date

Select a date when the listing was modified.

 

Tags

Provide the tags for the listing. Tags are integrated and maintained with Joomla Tags Component.

 

ID

This is an auto-generated field.

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 listings, 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.

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.

Screen 4: Map using Map Search Field values

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.

obraz.png

Screen 5: Custom Fields tab

For more information about creating custom fields, see 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.

The Images tab can be seen as shown in the following image:

obraz.png

Screen 6: 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.

 

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.


Booking Addons tab

This tab provides options to select additional amenities or resources that the listing provides at additional cost. These are visible when booking process is started.

obraz.png

Screen 7: Booking Addons tab

For each addon that is added for a listing, you must set the Addon Price. Provide the price for each addon under the Addon Price column.

Metadata tab

This tab includes the Meta title and Meta description for the listing

Administrator's Guide

Listings Resources

Overview

Resources are specific details about a listing. For example, in case of a Hotel, they can be the different types of rooms that the hotel offers, while in case of a property with multiple villas, it can be different types of villas that are offered. Bookings are always made against a resource type that exist for a listing.

Managing resources for a listing

For a listing created, you can either add a new resource or view the existing resources for that listing. These resources include the custom fields that were created using the Objects Custom Fields screen. The following screen shows the resources options. Please notice that for booking calendar Booking type must be Resource. Tours have static dates.

Screen 2: Resources options

To view the resources attached to a listing, click the FOLDER icon. To quickly create and add a new resource to the listing, click the PLUS icon. List of resources will appear. Click on resource title:

Add/Edit Resource tab

This tab provides options to create a name and alias for the type of resource. 

obraz.png

Provide the options as seen in the following table.

Title Provide a name for the resource.
Alias Provide an SEO-friendly alias.
Number of Resources Number of resources same type available
Maximum Persons Maximum number of people that can be accomodated.
Toggle Approve Approved or not.
Modify Date Select a effective date for the resource.
ID This is an auto-generated field.

Description tab

This tab provides the option to provide a detailed description about the resource.

obraz.png

Screen 3: Description tab

Provide the options as seen in the following table.

Description Provide a description for the resource.
Toggle Editor Click to toggle between rich text and plain text editor.

Custom Fields tab

This tab provides options to add required objects that were created using the Objects Custom Fields screen.

obraz.png

Screen 4: Custom Fields tab

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:

obraz.png

Screen 4: 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 options as seen 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.

Pricing for Resources

In the calendar seen in the earlier image, the dates marked with black ink are booked dates. This means there are no additional resources available for those dates. While, the dates marked with red ink are dates when resources are still available. This means a guest can make bookings against these dates marked in red. 

Each date shows the price of the resource on that day and how many resources are left as shown in the following image.

Screen 4: Dates display

You can modify the price for the resource on each day by clicking on the date. Provide the pricing for that day for the resource. The following image shows the price window for the resource.

Screen 5: Price window

You can also provide promotional discounts for the listing on specific dates. After you provide the price for a date, the promotional discount window is seen as shown in the following image. Provide a percentage value as seen here.

Screen 6: Promotional discount

If you need to set the same price and promotional discount for a range of dates, you can drag the mouse across the required dates and provide the price details as shown in the following image.

Administrator's Guide

Resource Custom Fields

Overview

For every listing that is created, you can create custom fields that act as additional resources. For example, if a listing needs to add a resource such as utilities that include TV, Radio, DVD, and so on, this resource can be created using the Objects Custom Fields screen. The following image shows the listing for this field.

obraz.png

Screen 1: Resource Custom Fields listing

For more information about how to create custom fields, see the Custom Fields documentation in the Administrator Guide.

Administrator's Guide

Listing as Tours

Overview

Tours are time based trips with fixed dates and prices, just like Resources, multiple Tours can be created. To create a tour for the listing, first it needs to be set under listing.

Managing Tours for a listing

For a listing created, you can either add a new tour or view the existing tours for that listing.

obraz.pngScreen 2: tours access

To view the tours attached to a listing, click the red folder icon. and Click on Tour title:

obraz.png

Edit tour tab

This tab provides options to create a name and edit a tour. 

obraz.png

Provide the options as seen in the following table.

Title Provide a name for the tour.
Maximum Persons Maximum number of people that can be accommodated within a tour.
Start Date Tour start date
Days Duration of the trip in days
Price Price per one Adult
Price for kids Price per one Child
Transport Type Available Transport (configured under Tours Transport)
Description Description of the trip

Images tab

This tab includes information about images and videos attached to the listing. Before you can add images to the tour, you must save your tour 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:

obraz.png

Screen 4: 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 tour.

Provide options as seen 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.

Administrator's Guide

Tours Transport

Overview

Multiple tours transport can be defined, which will be available under tours creation. Tours transport can be e.g. Plane or Bus.

obraz.png

Creating A New Tour Transport 

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

New

Creates a new Tour Transport entry.

Edit

Provides the edit mode to make changes to the existing ones.

Publish

Publishes the created tour entry.

Unpublish

Removes the entry from the list of published tour entries

Archive

Archives tour entries that are not used anymore.

Trash

Deletes the tour entry that is not required anymore.

Edit TourTransport 

If you want to edit existing entries, you can either click the entry from the Tours screen or select the check box next to the entry (title), and then click Edit.

The New Tour tab is seen as shown in the following image:

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

Provide a name for the Transport Type

Alias

URL alias for “SEF/SEO” URL

Parent

Select the parent 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.

Category Imageyeh

Upload an image for the type.

Administrator's Guide

Listing Property Type

Overview

Each of the listing that you create must be linked to a business type. Business type may include the type of accommodation the listing is about, such as Spa, cottage, apartment, and so on. The following image shows the Business Types listing.

obraz.png

Screen 1: Business Types listing

Editing Business Types

To create a new business type, click New. If you want to edit an existing Business Type, either click the entry or select the check box next to the entry, and then click Edit or just click on a title.

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

Provide a name for the Business Type

Alias

URL alias for “SEF/SEO” URL

Parent

Select the parent 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.

Category Image

Upload an image for the type.

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

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.

Administrator's Guide

Bookings

Overview

The bookings made through the site for any listing can be seen on this screen. The following image shows the list of bookings made on the site.

obraz.png

Screen 1: Bookings list

Viewing a booking

You can view the bookings seen on the screen by clicking on the entry. For a booking made, you can modify parameters such as payment status, resources, and so on.

Booking Details tab

This tab provides options to modify the payment status, no of guests, and so on as shown in the following image.

obraz.png

Screen 2: Booking Details tab

Edit the booking details as per the options in the following table.

Arrive Date Date of arrival
Depart Date Date of departure
Booking Status Edit the booking status as per the current payment status of the guest.
Payment Summary Provide the amount paid by the guest.
Maximum Persons Number of adults in the accomodation.
Children Number of children in the accomodation.
User User who created the listing.
ID This is an auto generated field
Resources This is an auto generated field based on the resources attached to the listing.
Notes Additional information shared by the guest.
Toggle editor Click to toggle between plain text and rich text editor.

Payments & Checkout tab

This tab provides information about the payment method used by the guest for the booking and related details. This is a read only tab.

obraz.png

Administrator's Guide

Booking Addons

Overview

After you click book for a particular listing, you can select additional facilities that the listing provides for an extra cost. These addons are added using the Booking Addons screen in the back end. The following image shows a list of addons.

obraz.png

Screen 1: Booking Addons listing

Editing an addon

To create a new addon, click New. To modify an existing addon, either click the entry or select the check box next to that entry, and then click Edit. The following image shows the Edit screen for an addon.

obraz.png

Screen 2: Editing an Addon 

Provide the options as shown in the following table.

Title Provide a title for the addon.
Alias Provide an SEO friendly alias.
Modify Date Select the date when the addon entry was modified.
Toggle Approve Approved
ID This is an auto-generated field.

Though you create an addon from the Booking Addons tab, the price for each addon varies based on the listing it is added too. Hence, the price is set as per the particular listing it is linked to. For more information about how to set the price, see Listings.

The addons options can be seen when you book a listing before confirming payment as seen in the following image.

Screen 3: Addons as seen on the listing

Administrator's Guide

Memebership

Overview

Memberships in Extension 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 for a particular membership plan.

Membership are well integrated with Joomla groups and have a dependency on each other. Ensure that you have created Joomla groups before creating membership plans. By doing this, you can select groups when creating membership. 

Create a new Membership Plan

Click Components > Extension > Membership Plans > New to create a new membership plan as shown in the following image:

obraz.png

Screen 1: Create new membership plan

First membership plan should be a Free (basic plan). When user logs into the Front Admin, he will be assigned to that plan. From that point, User can upgrade his membership to paid plans.

Edit Membership Plan

If you want to edit existing entries, you can either click the entry from the Membership screen or select the check box next to the entry, and then click Edit. 

The following image shows the Edit Plan screen.

obraz.png

Screen 2: Edit Plan screen

The following table explains the different options seen.

Name

Provide a name for the membership plan.

Number of Listings

Provide the number of listings the users in the plan can create.

Group ID

Select the Joomla user group ID for the plan.

It is recommended that you create your membership under the Registered group.

Number of Images

Provide the number of images the users in the plan can add.

Price Monthly

Provide the monthly charge for the plan.

Price Annually

Provide the annual charge for the plan.

Best Value

Best value badge, that shows in Front Admin (informative)

No of Premium Listings

Provide the number of premium listings the users in the plan can create.

Attachments

Enable to allow users to add attachments to listings.

Video

Enable to allow users to add Video link to the listings.

Custom Fields

Enable custom fields for particular plan.

Custom field needs to be assign into Paid Groups to be shown here.

ID

This field is auto generated.

Adding paid custom fields to the Membership plans

For adding a custom field to the membership plan, the field group needs to be set to Paid item. Click Extension > Custom Fields. Click the field you want to add to the membership plan as a paid item. Change the Field Group to Paid item for the Item view and Paid items for the Items view as shown in the following image:

obraz.png

Screen 4: Adding a paid custom field

This field needs to be enabled in the membership plan as shown in the following image.

obraz.png


Screen 5: Enabling the paid custom field

This field can be seen in the front admin under the membership plan as follows:

obraz.png


Screen 6: Viewing the paid custom field

Membership expiry email configurations

Before the membership expires, an email can be sent to a user that informs them about his membership nearing expiration. The setting can be seen in the following image:

Screen 3: Configure expiry email field

Cron Setting for Membership expiry check

Under your hosting panel a link needs to be added that launches a script. This script checks all users’ membership and sends an email if membership is about to expire:

curl -sS 'http://yourdomain.com?option=com_jomdirectory&task=expiry.send'

or

wget -q -O /dev/null 'http://yourdomain.com?option=com_jomdirectory&task=expiry.send'

If you are unaware about where the cron setting needs to configured in the hosting panel, contact your hosting support center.

Ensure that the script is launched every day at a particular time consistently.

Set Single User expiry date and group

To set plan expiry and attach a group for each user, do the following:

  1. Click Users > User Manager.
  2. Click the user for whom you want to set the membership expiry.
  3. Click the Additional Options tab.
  4. Provide the expiration date in the Plan expiry field.
  5. Click the Assigned User Groups tab.
  6. Select the check box next to the group you want to attach the user to for a particular membership plan as shown in the following image.
  7. Click Save.

For more information about membership expiration setting, see Configuration documentation.

User Guide

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 JomHoliday 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 JomHoliday Front Admin configurations to be able to access Front Admin. For more information, see the Front Admin Options section in the Menu Items documentation.

Accessing the dashboard

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

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

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

obraz.png

Screen 1: Dashboard screen

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

Report

Most Viewed graph

View the statistics for the site based on the listings viewership.

Membership

Upgrade Your Membership NOW!

Upgrade to another membership plan. Click Upgrade on the plan tab for the plan you want to upgrade to as shown here.

obraz.png

Profile

Profile

View the profile details for your profile.

Latest Bookings
 

Click the review to see the listing page it applies to. If you want to delete the comment, click Delete.

Approve comments appears only when enabled under JomHoliday Options -> Front Admin settings
User Guide

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

Screen 1: Listing screen

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

Button

Usage

Insert New

Creates a new Address entry. You must create separate entries for each level of depth that you need.

Publish

Publishes the created address entry.

Unpublish

Removes the entry from the list of published address entries

Delete

Deletes the address entry that is not required anymore.

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.

Alias Provide an SEO-friendly alias.
Category Select the category for the listing.
Types Select the business type for the listing.
Advance Payment Select the advance payment that the guests should pay to confirm the booking in percentage.
 

Text Area

Provide a description for 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 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, you must create separate entries for each language.

 

Tags

Provide the tags related to 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

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.

 

Maps Search

Search for a specific location. Type in the location and press Enter to go to the exact location.

For more information about how the location mapping is done in the listing, see Listings in the Administrative Guide.

More Options 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 More Options tab screen.

obraz.png

Screen 3: Other Details tab

For more information about creating custom fields, see Custom Fields.

Images tab

Screen 4: Images tab

To add an image, do the following:

  1. Click Add Image.
  2. Provide options as seen in the following image.

    You can provide values using the following table.

  1. Title or alias

    Provide a title for the Image.

    Categories

    Select from the following options:

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

    Status

    Select the required status.

    • Published
    • Unpublished
    • Trashed
    • Archived

    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.

    Click Save.

For more information about editing images or deleting images, see Images in the Administrative Guide.

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

Addons tab

You can select the addons that will be provided for the listing.

Screen 5: Addons tab

Attachments tab

Click the Edit icon to edit an attachment that is linked to the listing. Click the  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.
User Guide

Manage Resources

Overview

Resources are specific details about a listing. For example, in case of a Hotel, they can be the different types of rooms that the hotel offers, while in case of a property with multiple villas, it can be different types of villas that are offered. Bookings are always made against a resource type that exist for a listing.

Editing a resource

You can edit an existing resource that belongs to the listing, or click Insert New to create a new resource. The existing resources can be seen by clicking the icon next to the listing on the Listings tab. The following screen is seen.

obraz.png

Screen 1: Resources screen

Click on the existing resource to make edits to it. The following image shows the editing screen for the resource. 

obraz.png

Screen 3: Edit resources screen

For more information about each of these specific fields, see Resources documentation in the Administrative Guide.

In the calendar seen in the above image, the dates marked with black ink are booked dates. This means there are no additional resources available for those dates. While, the dates marked with red ink are dates when resources are still available. This means a guest can make bookings against these dates marked in red. 

Each date shows the price of the resource on that day and how many resources are left as shown in the following image.

Screen 4: Dates display

You can modify the price for the resource on each day by clicking on the date. Provide the pricing for that day for the resource. The following image shows the price window for the resource.

Screen 5: Price window

You can also provide promotional discounts for the listing on specific dates. After you provide the price for a date, the promotional discount window is seen as shown in the following image. Provide a percentage value as seen here.

Screen 6: Promotional discount

User Guide

Manage Resource Bookings

Overview

Each user that is logged in to the front admin can create listings. Whenever a guest makes a booking against the listing created by the user, the booking details can be seen by navigating to the Listings tab.

Viewing the bookings

To view bookings against a listing, do the following:

  1. From Front Admin, click the Listings tab. 
  2. Click the icon to view the resources associated with the listing
  3. Click the icon from the resources listings as shown in the following image. All the resources that are available for that listing will be seen here. The bookings are made against each of the resource.

    obraz.png

The bookings can be seen as shown in the following image. To delete a booking, select the check box next to the booking and click Delete.

obraz.png

Screen 1: Bookings list

Editing a booking

As the owner of the listings, you can provide additional notes to the bookings by editing the booking information. Otherwise you can see details of the booking.

obraz.png

Screen 2: Edit screen

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

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 section of the Administrative Guide.

The following screen shows the Membership details for the user.

obraz.png


Screen 1: Membership details

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

obraz.png


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.

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.

Screen 3: PayPal configurations

User Guide

Listing Messages

Overview

Additional send email copy to admin can be set under Configuration

The messages are always sent to the owner of the listing. The user email address is taken from the User Account settings.

The Contact area on the listing page is as seen in the following image. The options are provided as given here:

Screen 1: Sending a message on the site

Viewing messages

Once the user accepts the Terms and Conditions and the Privacy Policy, he clicks Send Email. The email is now available for the owner of the listing to view as seen in the following image:

All the messages that are sent through the site from the Extension listings can be seen on backend Messages section.

To view a message, hover the mouse pointer over the message as shown in the following image.

Screen 2: View the message

If you want to archive older messages or any message, select the checkbox next to the message and click Archive

Messages sent using the contact form are available on the Messages tab for the owner of the listings. You can view the message or delete it based on your requirement.

Front Admin Messages

To view messages, from Front Admin, click the Messages tab to see the following screen.

obraz.png


Modules

Modules

Latest Items Module

Overview

Modules are extensions that assist in creating blocks of information on your site. They aggregate information from components and can be placed in predefined positions on the page based on your Joomla template.

JomHoliday Latest module

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 > JomHoliday Items

Editing the JomHoliday Latest module

To edit the module, click on the module link or select the checkbox next to the module name, and then click Edit.

The following image shows the module edit screen.

obraz.png

Screen 7: Module tab

Module tab

This tab controls the layout where the latest listings panel is to be displayed on the screen.

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 the default format.

 

  • Grid – Displays the latest listings in a grid format.
     
  • Clean - Displays the latest listings in a clean format
Columns count Number of columns of listing that should be listed in the panel

Count

Number of listings that should be listed in the panel.

A 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 the 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.

Latest or IDs

Select how you want the listings to be displayed as:

  • Latest
  • IDs

Enter IDs

If ID is selected in the column above, mention the starting ID of the listing.

Featured

Enable to show only featured listings.

Show Address

Enable to show the address of the listing.

Show Description

Enable to show the description up to the character limit set.

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 Settings

Heading

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 JomHoliday Latest module.

Note

Provide additional information.

Menu Assignment tab

This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages.

obraz.png


Screen 9: Menu Assignment tab

Select the required menu for module assignment. The available options are:

Modules

Search Module

JomHoliday Search module

This module helps you create the search panel with fields that are searchable. All the fields that are defined as searchable during creation can be seen on this panel. You can decide where to position the search panel on the page and also control on which pages the panel should appear. To view all the available modules, click Extension > Module Manager > JomHoliday Search

To create a new module, click New. Select the JomHoliday Search module. Provide the information as given in the following sections. Click Save to save the module.

Editing the JomHoliday Search module

To edit the module, click on the module link or select the checkbox next to the module name, and then click Edit.

The following image shows the module edit screen.

obraz.png

Screen 2: Search Module 

Module tab

This tab controls the layout where the search panel is to be displayed on the screen.

Layout

Select the required layout in the Layout field. The available options are:

  • Horizontal – 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 in the Administrative Guide.
  • Modern Search – Single keyword search field as seen in the following image:

 

Show Address Hide or Show the address field in the frontend
Show category Hide or Show category selection in the frontend
Custom Fields Select if search should process custom fields
Default category Select a default category that will be preselected in the frontend

Show Title

Show or hide the title for the search panel.

Position

Select the position based on your Joomla Template.

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 JomHoliday Search module.

Note

Provide additional information.

Menu Assignment tab

This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages.


Screen 4: Menu Assignment tab

Select the required menu for module assignment. The available options are:

For the last two options, the screen is as shown in the following image:


Screen 5: Menu Assignment options

Modules

Live Search Maps Module

Overview

This is an extra paid module available for Business Package, can be also purchased separately. 

This module helps you view all the listings under full view or windowed map To view all the available modules, click Extension > Module Manager

To create a new module, click New. Select the EXTENSION_NAME Maps module. Provide the information as given in the following sections. Click Save to save the module.

Editing the Maps Module

To edit the module, click on the module link or select the checkbox next to the module name, and then click Edit.

The following image shows the module edit screen.

obraz.png

Screen 2: Module tab

Module tab

This tab controls the layout where the search panel is to be displayed on the screen.

Screen 3: Module tab

Provide the options as per the following table.

Layout

Select the required layout in the Layout field. The available options are:

Maps Wide – layout with the search module on the left side and big map area on the right side, as seen in the following image:

 

Maps – layout showing items on a map as seen in the following image:

 

Display limit Limit number of items shown on the map
Map width Set width of the map
Map height Set height of the map

Top margin

Set top margin of the map

Display category selection on the left of the wide map layout
Display address selection on the left of the wide map layout
Display keywords selection on the left of the wide map layout

Position

Select the position based on your Joomla Template.

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 JomDirectory Search module.

Note

Provide additional information.

Menu Assignment tab

This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages.

obraz.png

Screen 4: Menu Assignment tab

Select the required menu for module assignment. The available options are:

Creating custom category markers

When any listing is displayed on the map, it is shown as a pin. This pin icon is as in the default template. To modify this pinned icon as per your category, marker image needs to be placed under module images directory:

modules/mod_EXTENSION-NAME_maps/images/markers/...
The file name should be same as the category. The spaces need to be replaced with dashes " - " and the "marker" prefix. So, suppose category name is Auto Parts, then the file name for the marker should be marker_auto-parts.png.
Modules

Slideshow PRO Module

Overview

This is an extra paid module available for Business Package, can be also purchased separately. 

This module showcases the listings in a slideshow format. Users can see the image along with the title of the listing.

Slideshow PRO Module upon activation is seen as follows on the pages:

obraz.png

Screen 1: Slideshow Module on front page

Editing Slideshow 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.

obraz.png

Screen 2: Module tab

Provide the options as per the following table.

Count

Number of listings for which images need to be shown in the slideshow

Number of characters

Number of characters from the description that will be shown in the slideshow.

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.

Show Description

Enable to show the description up to the character limit set.

Category

Select 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

Use Listings IDs

Enable to make the next set of settings work.

IDs CSS Item Styling

Provide comma separated IDs in this field. Such as, 21, 22 and so on.

Use IDs for the CSS Classes

If set to yes, to each Caption, CSS Class ID will be added e.g. .jd-slide-title21 where 21 is ID of the listing.

Listing ID can be found under JomEvents Listing View in Table - Column ID. It works best with Use Listings ID's setting

You can select individual listings and promote them with different captions.


If set to No, the default CSS will be used for all captions.

Slider Module Tab

This tab controls the layout where the map panel is to be displayed on the screen.

obraz.png

Screen 3: Slider Module tab

Slider Width

Slider width in pixels

Slider Height

Slider height in pixels

Slide Delay (seconds)

Slideshow delay in seconds

Full Width

Enable to cover the entire width of the slideshow image.

Slide Transition

Select from the following options.

  • Random
  • Fade
  • Boxslide
  • Slotzoom-horizontal
  • Slotzoom-vertical
  • Curtain-1
  • Curtain-2
  • slideup

Slide Navigation

Select from the following options.

  • Bullet
  • Thumb
  • None

Autoplay

Start slider when page loaded 

Menu Assignment tab

This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages.

YVJobraz.png


Screen 4: Menu Assignment tab

Select the required menu for module assignment. The available options are: