J-BusinessDirectory Extensions

There are several modules that come together with the J-BusinessDirectory to enhance the functionality and user experience. Each module has a specific function and layout.

They are presented in the section below.

JBusinessDirectory Listing Search module

The JBusinessDirectory module allows your visitors to search through the existing companies. It provides different search parameters that will be explained in the following section.

If a field is selected mandatory the search will not be done unless the field is complete.

_images/search_module.png _images/search_module_2.png
  • Title – the title of module that will be displayed in front-end
  • Description – text that will be displayed on front-end
  • Base Layout – base layout of the module
  • Layout type – the orientation of search fields. It can be horizontal or vertical.
  • Menu item id – set the menu item id that is associated with the search. The menu item id will be shown when the search is done.
  • Background color- define the background color of the listing search module
  • Custom attributes – dropdown of custom attributes that will be shown on front-end
  • Maximum radius – the maximum radius that will appear on slider
  • Show map – show a map with result business listing above the search fields
  • Map height – set the height of the map
  • Map width – set the width of the map
  • Show only map - show only map on search module
  • Enable Autosuggestion – enables the location autosuggestion
  • Max listings – determine the max number of map markers, when there are no search results
  • Min number of letters – minimum number of letters required for the search
  • Show keyword – show the keyword input
  • Mandatory keyword – set the keyword mandatory
  • Enable keyword suggestion – enables suggestions (categories or company names) while searching on keyword
  • Show categories – show categories dropdown
  • Mandatory categories – set categories mandatory
  • Show subcategories – show subcategories dropdown
  • Available categories – the admin can decide which categories to display in the search module
  • Separate categories – separates categories and subcategories on different select boxes
  • Show types – show business listing type
  • Mandatory types – set the business listing type mandatory
  • Available Types – You can add the business types that are available
  • Show cities – show cities
  • Mandatory cities – set cities mandatory
  • Show regions – show regions
  • Mandatory regions – set regions mandatory
  • Show countries – show countries
  • Mandatory countries – set countries mandatory
  • Show Zip code – show zip code
  • Mandatory zip code – set zip code mandatory
  • Show province – show province
  • Mandatory province – set province mandatory
  • Enable autocomplete – enable autocomplete functionality on select boxes
  • Enable autolocation – enable autolocation functionality on browsers
  • Enable link location – enable link location functionality between countries, regions and cities.
  • Preserve search values – enable/disable preserving values between searches
_images/118.png

If the search module is set in the new position dir–search-listing-top, it will display on the left side of the site, on top of the search filter.

_images/listing_search_vertical.png

JBusinessDirectory - Business Listings

_images/latest_listing_module_1.png
  • Shows the latest business listings added based on category, featured attributes.
  • View type – the view on which of the listings will be displayed
  • Layout type – set the layout type
  • Categories – you can choose to display only the listings that belong to the set categories
  • Type - you can choose to display only the listings that belong to the set type
  • City – you can choose to display only the listings that belong to the set city
  • Region - you can choose to display only the listings that belong to the set region
  • Country - you can choose to display only the listings that belong to the set country
  • Number of businesses – set the max number of events to display on the module
  • Only featured – choose the possibility to whether display or not only the featured listings
  • Only with logo – display or not only the businesses with logo
  • User geo location – display listings based on user geo location
  • Enable nearby listings – enable or disable nearby listings
  • Geo location radius – show listings based on the radius set
  • Ordering – set the default ordering for the listings
  • Show view all – set whether to display or not the “View all” button
  • Item background color – set the background color of the latest listings
  • Item border color - set the border color of the latest listings
_images/latest_listing_module_2.png

J-BusinessDirectory Listing Search plugin

After installation you can access the plugins section of Joomla administration and filter by search plugins. You should be able to see the J-BusinessDirectory Listing Search plugin and you can click on it to access the settings.

_images/listing_search_plugin.png

On the settings page you can choose to enable the plugin.

Order by – the listings are ordered by the business name

Ascending/Descending – the listings can be ordered in an ascending or descending order

Search fields – the user can set where s/he wants to search the submitted data (business listing or category)

Open links in – the links can be open in the same tab or in a new one

J-BusinessDirectory Business Finder plugin

After installation you access the plugins section of Joomla administration and filter by content plugins. You should be able to see the J-BusinessDirectory Business Finder plugin and you can click on it to access the settings.

On the settings page you can choose to enable the plugin.

_images/listing_finder_plugin.png

Functionality

Joomla Smart Search Extension

After installing and enabling the plugin, you will have to access the Smart Search extension and press the index button, in order for the directory listings to be indexed.

_images/indexing.png

When the indexing of the listings is finished, a new option will be shown on the search tools type of content, the business type. So, after selecting the business type from the search filter, all the existing directory listings will be shown.

_images/listing_index.png

Only in this way, the listings can be accessed by the smart search.

The site administrator can create a new menu item available for the smart search and assign it to his/her own convenience and search the listings.

_images/listing_smart.png

JBusinessDirectory Offer Search module

_images/offer_module_1.png _images/offer_module_2.png
  • Title – the title of module that will be displayed in front-end
  • Description– text that will be displayed on front-end
  • Background color- define the background color of the listing search module
  • Layout type– the orientation of search fields. It can be horizontal or vertical.
  • Menu item id – set the menu item id that is associated with the search. The menu item id will be shown when the search is done.
  • Search filter distance – set the default distance in case of a zip code search
  • Show map– show a map with result business listing above the search fields
  • Max Offers – max number of map markers, when there are no search results
  • Map height – set the height of the map
  • Map width – set the width of the map
  • Show only map – show only map on search module
  • Enable Autosuggestion – enables the location autosuggestion
  • Min number of letters – minimum number of letters required for the search
  • Show keyword- show the keyword input
  • Mandatory keyword– set the keyword mandatory
  • Enable keyword suggestion – enables suggestions (categories or offer names) while searching on keyword
  • Show categories– show categories dropdown
  • Mandatory categories– set categories mandatory
  • Show subcategories – show subcategories dropdown
  • Available categories – the admin can decide which categories to display in the search module
  • Show types - show offer types
  • Mandatory types - set the offer types to mandatory
  • Show cities – show cities
  • Mandatory cities – set cities mandatory
  • Show regions – show regions
  • Mandatory regions – set regions mandatory
  • Show Zipcode– show zip code
  • Mandatory zipcode – set the zipcode field to mandatory
  • Show province – show province
  • Mandatory province – set province mandatory
  • Show countries – show countries
  • Mandatory countries – set countries mandatory
  • Show min price – show the min price field
  • Show max price – show the max price field
  • Enable link location – enable link location functionality between countries, regions and cities.
  • Enable autocomplete – enable autocomplete functionality on select boxes
  • Preserve search values – enable/disable preserving values between searches
_images/offer_module_3.png

If the search module is set in the new position dir–search-offers-top, it will display on the left side of the site, on top of the search filter.

_images/offer_search_vertical.png

JBusinessOffer module

  • The JBusinessOffer module displays the offers of the day in a cyclic manner. Offers of the day can be set via the backend in the Manage Offers section. A click on the offer will redirect visitor to the offer description.

JBusinessDirectory – Offers

  • The module displays the latest offers published.
_images/latest_offer_1.png
  • View type – the view on which the offers will be displayed
  • Layout type – set the layout type
  • Categories – you can choose to display only the offers that belong to the set categories
  • City – you can choose to display only the offers that belong to the set city
  • Region - you can choose to display only the offers that belong to the set region
  • Number of offers – set the max number of offers to display on the module
  • Only featured – choose the possibility to whether display or not only the featured offers
  • User geo location – display offers based on user geo location
  • Geo location radius – show offers based on the radius set
  • Ordering – set the default ordering for the offers
  • Item ID – the item ID associated with offers
  • Item background color – set the background color of the latest offer
  • Item border color - set the border color of the latest offer
  • Show view all – set whether to display or not the “View all” button
  • Show listing name – show the name of the listing associated with the offer
  • Show location – show offer location
_images/latest_offer_2.png

J-BusinessDirectory Offer Search plugin

After installation you can access the plugins section of Joomla administration and filter by search plugins. You should be able to see the J-BusinessDirectory Offer Search plugin and you can click on it to access the settings.

_images/offer_search_plugin.png

On the settings page you can choose to enable the plugin.

Order by – the offers are ordered by the offers’ name, offers’ start date and offers’ end date

Ascending/Descending – the offers can be ordered in an ascending or descending order

Search fields – the user can set where s/he wants to search the submitted data (offers or category)

Open links in – the links can be open in the same tab or in a new one

J-BusinessDirectory Offer Finder plugin

After installation you can access the plugins section of Joomla administration and filter by content plugins. You should be able to see the J-BusinessDirectory Offer Finder plugin and you can click on it to access the settings.

On the settings page you can choose to enable the plugin.

_images/offer_finder_plugin.png

Functionality

Joomla Smart Search Extension

After installing and enabling the plugin, you will have to access the Smart Search extension and press the index button, in order for the directory listings to be indexed.

_images/indexing.png

When the indexing of the offers is finished, a new option will be shown on the search tools type of content, the offer type. So, after selecting the offer type from the search filter, all the existing directory offers will be shown.

_images/offer_index.png

Only in this way, the offers can be accessed by the smart search.

The site administrator can create a new menu item available for the smart search and assign it to his/her own convenience and search the offers.

_images/offer_smart.png

JBusinessDirectory Event Search module

_images/event_module_1.png _images/event_module_2.png
  • Title – the title of module that will be displayed in front-end
  • Description– text that will be displayed on front-end
  • Background color- define the background color of the listing search module
  • Layout type– the orientation of search fields. It can be horizontal or vertical.
  • Menu item id – set the menu item id that is associated with the search. The menu item id will be shown when the search is done.
  • Search filter distance – set the default distance in case of a zip code search
  • Show map– show a map with result business listing above the search fields
  • Map height – set the height of the map
  • Map width – set the width of the map
  • Show only map – show only map on search module
  • Enable Autosuggestion – enables the location autosuggestion
  • Max events – determine the max number of map markers, when there are no search results
  • Min number of letters – minimum number of letters required for the search
  • Show keyword- show the keyword input
  • Mandatory keyword– set the keyword mandatory
  • Enable keyword suggestion – enables suggestions (categories or event names) while searching on keyword
  • Show categories– show categories dropdown
  • Mandatory categories– set categories mandatory
  • Show subcategories – show subcategories dropdown
  • Available categories – the admin can decide which categories to display in the search module
  • Show types– show the events’ type
  • Mandatory types- set the events type mandatory
  • Show cities – show cities
  • Show date range – show the events date range
  • Mandatory date range – set events date range mandatory
  • Mandatory cities – set cities mandatory
  • Show regions – show regions
  • Mandatory regions – set regions mandatory
  • Show countries – show countries
  • Mandatory countries – set countries mandatory
  • Show Zipcode– show zip code
  • Mandatory zipcode – set the zipcode field to mandatory
  • Show province – show province
  • Mandatory province – set province mandatory
  • Enable link location – enable link location functionality between countries, regions and cities.
  • Enable autocomplete – enable autocomplete functionality on select boxes
  • Preserve search values – enable/disable preserving values between searches
_images/event_module_3.png

If the search module is set in the new position dir–search-events-top, it will display on the left side of the site, on top of the search filter.

_images/event_search_vertical.png

JBusinessDirectory – Events

  • The module displays the latest events published.
_images/latest_event_module_1.png
  • View type – the view on which the events will be displayed
  • Layout type – set the layout type
  • Categories – you can choose to display only the events that belong to the set categories
  • City – you can choose to display only the events that belong to the set city
  • Region - you can choose to display only the events that belong to the set region
  • Number of events – set the max number of events to display on the module
  • Only featured – choose the possibility to whether display or not only the featured events
  • User geo location – display events based on user geo location
  • Geo location radius – show events based on the radius set
  • Ordering – set the default ordering for the events
  • Item ID – the item ID associated with events
  • Item background color – set the background color of the latest event
  • Item border color - set the border color of the latest event
  • Show view all – set whether to display or not the “View all” button
  • Show listing name – show the name of the listing associated with the event
  • Show location – show event location
_images/latest_event_module_2.png

J-BusinessDirectory Event Search plugin

After installation you can access the plugins section of Joomla administration and filter by search plugins. You should be able to see the J-BusinessDirectory Event Search plugin and you can click on it to access the settings.

_images/event_search_plugin.png

On the settings page you can choose to enable the plugin.

Order by – the events are ordered by the events’ name, events’ start date and the events’ end date

Ascending/Descending – the events can be ordered in an ascending or descending order

Search fields – the user can set where s/he wants to search the submitted data (events or category)

Open links in – the links can be open in the same tab or in a new one

J-BusinessDirectory Event Finder plugin

After installation you can access the plugins section of Joomla administration and filter by content plugins. You should be able to see the J-BusinessDirectory Event Finder plugin and you can click on it to access the settings.

On the settings page you can choose to enable the plugin.

_images/event_finder_plugin.png

Functionality

Joomla Smart Search Extension

After installing and enabling the plugin, you will have to access the Smart Search extension and press the index button, in order for the directory listings to be indexed.

_images/indexing.png

When the indexing of the events is finished, a new option will be shown on the search tools type of content, the events type. So, after selecting the events type from the search filter, all the existing directory events will be shown.

_images/event_index.png

Only in this way, the events can be accessed by the smart search.

The site administrator can create a new menu item available for the smart search and assign it to his/her own convenience and search the listings.

_images/event_smart.png

JBusinessDirectory Categories Module

_images/category_module_1.png

The JBusinessCategory displays a list with all the available categories and subcategories. Currently only two levels are displayed, the main categories and their subcategories. Subcategories are displayed on mouse over the main category. Clicking on a category will display all the businesses available for that specific category.

View type - the view on which the categories will be displayed. If the slider type is selected, also on slider view options, there is the possibility to choose the visible items, number of items to scroll, enable or disable autoplay and the speed of autoplay. (It is the same also for JBusinessCategoriesOffersModule and JBusinessCategoriesEventsModule).

Categories - you can set whether to display all the categories or only some of them

Show view all - you can set whether you want the “View all” button to show or not in the end of the module

_images/category_module_2.png

JBusinessCategoriesOffers module

_images/category_offer_module_1.png
  • The module displays a list with all the available categories and subcategories. Currently only two levels are displayed, the main categories and their subcategories. Subcategories are displayed on mouse over the main category. Clicking on a category will displayed all the offers available for that specific category. It has the same edit view and functionalities as the JBusinessCategories module.

JBusinessCategoriesEvents module

_images/category_event_module_1.png
  • The module displays a list with all the available categories and subcategories. Currently only two levels are displayed, the main categories and their subcategories. Subcategories are displayed on mouse over the main category. Clicking on a category will displayed all the events available for that specific category. It has the same edit view and functionalities as the JBusinessCategories module.

J-CategoryBanners

The module that is designed to provide a link between Joomla Banners extension and J-BusinessDirectory extension. When a user is doing a search, the module will provide the possibility to show related banners based on search category. The module retrieves the search category from directory extension and based on that it retrieves all banners from a banner category that has the exact name with the directory category.

In order to setup the module, you will have to go to the admin area in Extensions/Modules section.

The J-CategoryBanners module has the following parameters that will be explained in the section below.

_images/cat_banner_1.png

Width – set the width of banners or slideshow. If the slideshow is set to yes and width to 0 the slideshow will expand to the container limit (width will become 100%).

Height – set the height of banners or slideshow

Slideshow – set the possibility of showing the banners in a slideshow mode.

Slide duration – set the duration for each slide

Slider crop - defines how the image will be cropped inside its container:

  • True - means that all images will be scaled to fill the stage, centered and cropped.
  • False - will scale down so the entire image fits.
  • Height - will scale the image to fill the height of the stage.
  • Width - will scale the image to fill the width of the stage.
  • Landscape - will fill up images that have landscape proportions, but scale portrait images, to fit inside the container.
  • Portrait it is like ‘landscape’ but the other way around.

Slider transition – define what transition to use

  • Fade - crossfade between images
  • Flash - fades into background color between images
  • Pulse - quickly removes the image into background color, then fades the next image
  • Slide - slides the images depending on image position
  • Fadeslide - fade between images and slide, slightly at the same time

Slider thumbnails - sets how and if thumbnails should be created

  • Empty - Galleria will create empty spans with the classNameimg instead of thumbnails.
  • Numbers - Galleria will create empty spans with numbers instead of thumbnails.
  • Lazy - Galleria will create empty images with the class ‘lazy’.

Target – defines the target of the link, it the link will be open on same tab or on a separate tab

Count – number of banners that will be loaded.

Client – set the client of banners that will be loaded

Randomise – set the order of banners

Header Text – text that will appear above the banners

Footer Text – text that will appear below the banners

Other than setting up the features, the admin of the site needs to create also banner categories that will have the exact same name as the directory category, so that they can be linked together. And so, when a user is doing a search, the module will provide the possibility to show related banners based on the searched category.

_images/cat_banner_2.png

The category banners can be created in the admin area in Components/Banners/Categories.

_images/cat_banner_3.png

The new category banner can be created by selecting the “New” button in the left upper corner, and the category banner has to have the exact same name as the directory category. For the category banner to display, it is needed to add also a banner that will be related to the created category. Banners can be added in the admin area Components/Banners/Banners.

_images/cat_banner_4.png

The new banner can be created by selecting the “New” button in the left upper corner. As it is also displayed in the above picture, the new banner is related to the category banner.

In the j-CategoryBanner module itself, the admin has to set the module position as: dir-search-category_alias, so that when the user will search for that category in front-end, the banner will display.

As displayed in the picture, the position set is dir-search-home-garden, with “home-garden” being the alias of the category banner, which is auto – generated from the title, if not set manually by the admin.

If the user will search for the category that has the same name as the category banner, the banner will display at the bottom of the search filter, like displayed in the below picture.

_images/cat_banner_5.png

JBusinessDirectory – Reviews

This module displays all the saved reviews for business listings.

_images/review_module_1.png
  • Categories – display only the reviews for those listings that belong to the categories set
  • Number of reviews – the number of reviews to be displayed on the module
  • Minimum score – the minimum score of the reviews to be displayed
  • Ordering – set the ordering on which the reviews will be displayed
  • Review text limit – set the max number of characters the review description can gave
  • Item circle color – the color of the review user circle
  • Item background color – the background color of the reviews module
  • Item border color - the border color of the reviews module
_images/review_module_2.png

JQuery login module

  • This module creates a login as a popup. This was created for a better user experience.

JBusinessDirectory - Progress

  • Track the progress of a user to add his own business listing.

JBusinessDirectory - Icons

  • Shows a section with some quick links in Joomla’s Control Panel.

JBanners

  • The module can be used in 2 ways.

    • as a slideshow (by setting slideshow to yes)
    • as a banner
_images/119.png

JUserLogin

  • Module for user actions.
_images/120.png

JBusinessDirectory URL Translator plugin

  • This plugin is used to enable the business listing name to be part of the URL Link. This was created for SEO purposes. For the directory to work you need to enable this plugin. Instructions on how to do this are available in the installation section.

J-BusinessDirectory Content Plugin

J-BusinessDirectory Content Plugin is a plugin that allows the site administrator and the business owners to create articles that will be associated with business listings.

After the installation, you access the plugins section of Joomla administration and filter by content plugins. You should be able to see the J-BusinessDirectory Content plugin and you can click on it to access the settings.

On the settings page you can choose the Category that will be used for the article category. On the front-end the category field for the Joomla articles will be hidden and populated with the category that is selected on the plugin.

_images/content_plugin.png