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.

JomDirectory 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. The modules available are listed as seen in the following image.

Editing the JomDirectory 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.

Module tab

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

obraz.png

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

Search Module

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

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

Editing the JomDirectory 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.

Module tab

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

obraz.png

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:

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

ClJobraz.png


Screen 4: Menu Assignment tab

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

Shopping Cart Addon Module

JomDirectory includes a shopping cart and checkout, so users can purchase items straight from your product catalogue. Shopping cart addon extends Products functionality by adding possibility to purchase products directly on the list or from the product details page. When addon is installed a new section Orders will appear where all purchases are being logged and also Order status can be changed.

Installing the Shopping Cart Module

The shopping cart module does not need to be installed in order for users to be able to make purchases. However, it does make it easier for users to keep track of their purchases and navigate to checkout.

Start by downloading the shopping cart module. Once downloaded, install the module using Joomla's Extension Manager. Atlernatively, you can install directly from the web.

Configuring JomDirectory's Checkout

The first thing you must do is enable JomDirectory's checkout otherwise users will not be able to add items to the shopping cart and checkout those items for purchase.

To configure JomDirectory's checkout:

  1. Log into the Joomla! administration control panel then navigate to the JomDirectory dashboard (Components -> Directory),
  2. Click on the Options button (top right corner),
  3. Select Product from the list of tabs,
  4. Change Enable Cart to Yes,
  5. Save & Close.

Configuring the Module

Once the JomDirectory shopping cart module has been successfully installed, you will need to configure, position and publish it.

The JomDirectory shopping cart is just like any other module and so many of the configuration options will look familiar. Go through the options and configure it to you liking. In particular, configure the position and menu assignment and make sure that Status is set to Published.

IMPORTANT: Cart module should be assigned on all menus related to products!

Adding a Checkout Menu Item

If you have enabled the shopping cart module, you MUST create a shopping cart checkout page menu item otherwise the View Cart button will not work.

To create a new menu item for the JomDirectory's cart and checkout:

  1. Log into the Joomla! administration control panel if you haven't already,
  2. Navigate to the Menu Manager (Menus -> All Menu Items or select the menu you wish to add the item to),
  3. Click on New,
  4. Specify a menu item of "Shopping Cart",
  5. Configure your menu item to your liking,
  6. Save & Close.

If you are unfamiliar with Menu Manager check out Joomla!'s menu management documentation.

Configure Shipping Providers

Shipping Providers can be configured under custom fields. To create a new shipping provider, access Product custom fields, click create new, field type input and choose group shipping. Once saved it will be available under Product custom fields.

Configure Online and Offline payments.

  1. Log into the Joomla! administration control panel then navigate to the JomDirectory dashboard (Components -> Directory),
  2. Click on the Options button (top right corner),
  3. Select Payments from the list of tabs,
  4. Configure online and if needed offline payments
  5. Save & Close.

Purchasing a Product

On the frontend, navigate to Product Search or Product Filter; you should now see a cart icon against each product. Click on it, and the product will be added to your shopping cart. Once you have completed your purchase, click on View Cart. You will be redirected to your shopping cart where you will be able to purchase your items using JomDirectory's checkout process.

That's it! You're ready to start selling your goods.

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.

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: