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.

J-BusinessDirectory 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 will be selected 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

  • Radius – set the default radius for the search

  • Maximum radius – the maximum radius that will appear on slider

  • Show map – show a map with result business listing above the search fields

  • Set auto focus – enable/disable auto focus

  • Overlay effect – add an overlay offect when the search input field receives the focus

  • Map height – set the height of the map

  • Map width – set the width of the map

  • 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

  • Field Label – switch the label of the fields between text and icons

  • Show only map – show only map on search module

  • Enable Autosuggestion –enables the location autosuggestion

  • 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

  • Separate categories – separates categories and subcategories on different select boxes

  • Available categories – the admin can decide which categories to display in the search module

  • Show category suggestion - if the setting is set to yes, all the categories below will be shown on the search filter

  • Suggested Categories - select the categories to show on the filter as suggested

  • 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 Zipcode – show zip code

  • Mandatory zipcode – set zipcode mandatory

  • Enable location suggestion - if set to yes, all the suggested locations will show

  • Show Location Popup – show/hide the location popup that is shown when clicking on the zip code field

  • Mandatory location autosuggestions - force the user to select a value from the location autosuggestions

  • Show province – show province

  • Mandatory province – set province mandatory

  • Show bookmark – show bookmark

  • Enable autocomplete – enable autocomplete functionality on select boxes

  • Enable autolocation – enable auto location 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

J-BusinessDirectory - Business Listings

_images/latest_listing_module_1.png
  • Shows the latest business listings added based on category, featured attributes.

  • Menu item id – the menu item that will be associated with the view all link

  • View type – the layout in which the listings will be displayed

  • Ordering – set the default ordering for the listings

  • Layout type – set the layout type. For list view type the layout will be always vertical.

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

  • Title characters - set the number of characters for the title

  • Packages - you can choose to display only the listings that belong to the set packages

  • Number of businesses – set the max number of events to display on the module

  • Categories – you can choose to display only the listings that belong to the set categories

  • Custom Attributes Displayed - you can choose to display only the listing that belong to the set custom attributes (only for style simple 2)

  • 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

  • Memberships – filter the displayed listings by the selected memberships

  • Link target – Associate the item link with the listing page or with the listing website

  • Link with listing view - Link with listing category, display related listings that have the same category.Used to display related items.

  • Link with video – display listings that are in the category with the same name as the video category

  • Link with country – display items from the country selection from the country module

  • Enable nearby listings – enable or disable nearby listings

  • Campaign Position – sets the campaign plans that are used for displaying the listings

  • Only Campaigns - show only campaign businesses

  • 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

  • Show recently viewed - display only recently viewed listings. Other conditions are applied too.

  • Listings geo location – display businesses based on the listing location- this will do a refresh of the page and the coordinates will be added on the current URL

  • Geo location radius – show listings based on the radius set

  • Show view all – set whether to display or not the “View all” button, which will redirect the user to set categories above

  • Item background color - set the background color of 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

J-BusinessDirectory 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

  • Menu item id – set the menu item id that is associated with the search. The menu item will be selected when the search is done.

  • Layout type – the orientation of search fields. It can be horizontal or vertical.

  • Background color - define the background color of the offer search module

  • Max Offers – max number of map markers, when there are no search results.

  • Min number of letters – minimum number of letters required for the search

  • Custom attributes - dropdown of custom attributes that will be shown on front-end

  • 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

  • Show only map – show only map on search module

  • Map height – set the height of the map

  • Map width – set the width of the map

  • 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

  • Available categories – the admin can decide which categories to display in the search module

  • Show subcategories – show subcategories dropdown

  • Show types – show offer type

  • 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 countries – show countries

  • Mandatory countries – set countries mandatory

  • Show province – show province

  • Mandatory province – set province mandatory

  • Show Zipcode – show zip code

  • Mandatory zipcode – set the zipcode field to mandatory

  • Enable Autosuggestion – enables the location autosuggestion

  • Show location popup – show/hide the location popup that is shown when clicking on the zip code field

  • Enable link location – enable link location functionality between countries, regions and cities.

  • Show min price – show the min price field

  • Show max price – show the max price field

  • Maximum price – max number of map markers, when there are no search results.

  • Show bookmark - show bookmarks

  • Select item type – filter the offers based on type selected

  • Overlay effect - add an overlay offect when the search input field receives the focus

  • 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

J-BusinessOffer 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.

J-BusinessDirectory – Offers

  • The module displays the latest offers published.

_images/latest_offer_1.png
  • Menu item id – the menu item that will be associated with the view all link

  • View type – the view on which the offers will be displayed

  • Ordering – set the default ordering for the offers

  • Layout type – set the layout type. For list view type the layout will be always vertical.

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

  • Packages - you can choose to display only the offers that belong to the set packages

  • Number of offers – set the max number of offers to display on the module

  • Select item type –filter the offers based on the type selected

  • Categories – you can choose to display only the offers that belong to the set categories

  • Type – filter the offers based on type

  • 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

  • Show location – show offer location

  • Offers geo location – display offers based on the offer location – this will do a refresh of the page and the coordinates will be added on the current URL

  • Geo location radius – show offers based on the radius set

  • Link with offer category – show related offers , display the offers that are relevant to the current offer category

  • Only featured – choose the possibility to whether display or not only the featured offers

  • Show listing name – show the name of the listing associated with the offer

  • Show offer free text – show/hide the free offer text

  • Show view all – set whether to display or not the “View all” button, which will redirect the user to set categories above

  • Item background color – set the background color of the latest offer

  • Item border color - set the border color of the latest offer

_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

J-BusinessDirectory 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

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

  • Layout type – the orientation of search fields. It can be horizontal or vertical.

  • Background color - define the background color of the event search module

  • 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

  • Custom Attributes - dropdown of custom attributes that will be shown on front-end

  • Search filter distance – set the default distance in case of a zip code search

  • Maximum radius - the maximum radius that will appear on slider

  • Show map – show a map with result business listing above the search fields

  • Show only map – show only map on search module

  • Map height – set the height of the map

  • Map width – set the width of the map

  • 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

  • Available categories – the admin can decide which categories to display in the search module

  • Show subcategories – show subcategories dropdown

  • Show types – show the events’ type

  • Mandatory types - set the events type mandatory

  • Show date range – show the events date range

  • Mandatory date range – set events date range mandatory

  • Show age – show the events age limit

  • Mandatory age – set events age limit mandatory

  • Show time – show the events time

  • Mandatory time – set events time mandatory

  • 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 province – show province

  • Mandatory province – set province mandatory

  • Show Zipcode – show zip code

  • Mandatory zipcode – set the zipcode field to mandatory

  • Enable Autosuggestion – enables the location autosuggestion

  • Show location popup - show/hide the location popup that is shown when clicking on the zip code field

  • Enable link location – enable link location functionality between countries, regions and cities.

  • Overlay effect - add an overlay offect when the search input field receives the focus

  • 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

J-BusinessDirectory – Events

  • The module displays the latest events published.

_images/latest_event_module_1.png
  • Menu item id – the menu item that will be associated with the view all link

  • View type – the view on which the events will be displayed

  • Ordering – set the default ordering for the events

  • Layout type – set the layout type. For list view type the layout will be always vertical.

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

  • Packages - you can choose to display only the events that belong to the set packages

  • Number of events – set the max number of events to display on the module

  • Categories – you can choose to display only the events that belong to the set categories

  • Type – filter the events based on type

  • 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

  • Show location – show event location

  • Events geo location – display events based on events location – this will do a refresh of the page and the coordinates will be added on the current URL

  • Geo location radius – show events based on the radius set

  • Link with event view - Link with event category. Display related events that have the same category. Used to display related items.

  • Only featured – choose the possibility to whether display or not only the featured events

  • Show listing name – show the name of the listing associated with the event

  • Show view all – set whether to display or not the “View all” button, which will redirect the user to set categories above

  • Item background color – set the background color of the latest event

  • Item border color - set the border color of the latest event

_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

J-BusinessDirectory 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).

Mobile Layout - layout for the mobile devices

Table Layout - layout for the tablet devices

Desktop Layout - layout for the desktops

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

Link with quote requests - display the quote request dialog instead of the search results (will work only with JBD Quote Request app)

Show related categories - display the related categories to the searched category, it will be shown when performing a category search on the results page

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

J-BusinessCategoriesOffers 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.

J-BusinessCategoriesEvents 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

J-BusinessDirectory – 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

J-Query login module

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

J-BusinessDirectory - Progress

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

J-BusinessDirectory - Icons

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

J-Banners

  • The module can be used in 2 ways.

    • as a slideshow (by setting slideshow to yes)

    • as a banner

_images/119.png

J-BusinessDirectory 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

J-BusinessDirectory User Module

Enable J-BusinessDirectory User Module

After installing the module from the Directory Extensions section in the dashboard, you can access the modules section of Joomla administration and filter by user module. You should be able to see the J-BusinessDirectory User module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

_images/user_module_1.jpg

The settings of the module include:

  • Pre-text – the text or HTML that is displayed above the login form

  • Post-text – the text or HTML that is displayed below the login form

  • Login Redirection Page – set the redirection page after logging in, whether an existing menu item or you can create a new one

  • Logout Redirection Page – set the redirection page after logging out, whether an existing menu item or you can create a new one

  • Show greeting – set whether you want to show/hide the greeting

  • Encrypt login form – HTTPS must be enabled to use this option

  • Social login – set whether to show/hide the Facebook and Google login buttons

  • Show cart – set whether to show/hide the shopping cart button

  • Show create listing – set whether to show/hide the “Create listing” button

After all the settings of the module are set, it will be shown anywhere on the website depending on menu assignment and the position.

The user can either login or register also by using the social networks like Facebook and Google.

_images/user_module_2.jpg

To make use of the social networks, the site admin needs to setup the project for both platforms on these sites:

After everything will be ready, the site admin will have to enter the authentication keys on the directory’s general settings, for the social networks login to work.

_images/user_module_3.png

When the user will be logged in, s/he can access directly one of the sections (dashboard, profile), or logout, as shown in the below picture.

_images/user_module_4.jpg

Social Network Login

Facebook

Setup the Facebook oAuth Login by going to the Facebook Developer platform: https://developers.facebook.com/docs/facebook-login/

Select the Websites or mobile websites option

_images/facebook1.png

If you don’t have a Facebook developer account, you need to create one first before continuing to the next step.

Once you have logged in with your developer account, go to the My Apps section:

_images/facebook2.png

In order to set up the login by Facebook you need to create an App first that will be linked with your webpage. Click on the Create App, and select the last option on the modal window:

_images/facebook3.png _images/facebook4.png

Enter the details for your application and then click Next. Once the app is created, you need to select the Facebook Login and set it up.

_images/facebook5.png

Once on your App Page, select the settings on the left sidebar menu and click Basic.

_images/facebook6.png

Enter your website domain on the App Domains field and your site URL on the Website section at the end.

Copy the App ID and the App Secret and paste them on the User authentication section under General Settings on the J-BusinessDirectory admin panel.

Now you need to access the Settings for the Facebook Login:

_images/facebook7.png

Enable the Client OAuth Login and Web OAuth Login. On the Valid OAuth Redirect URIs, you need to enter the following redirect URL:

https://yoursite.com/index.php?option=com_jbusinessdirectory&task=userprofile.oauthCallback&type=facebook

_images/facebook8.png

Replace yoursite.com with the domain of your website. Also note that the URL must be HTTPS. Please make sure your website has an SSL certificate active, otherwise it will not work with http websites

Save all the changes, and lastly, make sure you set the app mode to Live:

_images/facebook9.png

Google

Before continuing the setup for the Google OAuth, make sure you have created a Project on the google developers console.

First you need to create the credentials for Google OAuth:

https://console.developers.google.com/apis/credentials

_images/google1.png

Click on Create Credentials and select OAuth Client ID. If needed, setup the consent screen configurations by following all the necessary steps provided by google. After setting up the configuration for the consent screen, click on Create Credentials again, and on the Application Type, select Web Application.

_images/google2.png

Add a name of your choosing and save. Once saved, you will be redirected back to the Credentials screen and now you can select the credentials you just created inside the OAuth 2.0 Client IDs section.

Under Authorized Redirect URI-s, click the Add URI button twice

_images/google3.png

https://yoursite.com/index.php?option=com_jbusinessdirectory&task=userprofile.oauthCallback&type=google

http://yoursite.com/index.php?option=com_jbusinessdirectory&task=userprofile.oauthCallback&type=google

Replace yoursite.com with the domain of your website. Please note that we are adding the same URI twice, once with http:// and once with https://

Now copy the Client ID and Client Secret and paste them on the User authentication section under General Settings on the J-BusinessDirectory admin panel.

LinkedIn

Before setting up the Linkedin OAuth, make sure you first create an app by following the instructions on the page below:

https://www.linkedin.com/developers/apps/

Once you have created the app, go the app details screen and click on the Auth tab:

_images/linkedin1.png

Copy the Client Secret and Client ID and paste them on the User authentication section under General Settings on the J-BusinessDirectory admin panel.

Under the OAuth 2.0 Settings section, enter the following redirect URLs:

Replace yoursite.com with the domain of your website. Please note that we are adding the same URI twice, once with http:// and once with https:// Now go to the Product Tabs, and select the Sign in with Linkedin product:

_images/linkedin2.png

Once the product has been reviewed and approved, under the Auth tab, the OAuth 2.0 Scopes should have been updated and should look like this:

_images/linkedin3.png

J-BusinessDirectory Locations Module

After installing the module from the Directory Extensions section in the dashboard, you can access the modules section of Joomla administration and filter by location module. You should be able to see the J-BusinessDirectory Location module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

_images/location_1.png

The settings of the module include:

  • The regions and cities that will be shown; they should be separated by a comma

  • Columns per row – set the number of columns per row

After all the settings of the module are set, it will be shown anywhere on the website depending on menu assignment and the position.

A search can be performed for each of the regions and cities added on the module.

_images/location_2.png

J-BusinessDirectory Map Module

After installation you access the modules section of Joomla administration and filter by map module. You should be able to see the J-BusinessDirectory Map module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

_images/map_module_1.png

The settings of the module include:

  • Map height – set the map height

  • Map width – set the map width

  • Max listings – set the maximum number of listings to be shown on the map

  • Categories – filter the shown listings by the categories set on the module

  • Type – filter the shown listings by the type set on the module

  • City – filter the shown listings by the city set on the module

  • Region – filter the shown listings by the region set on the module

  • Country – filter the shown listings by the country set on the module

  • Only featured – if set to yes, only featured listings are shown

After all the settings of the module are set, it will be shown anywhere on the website depending on menu assignment and the position.

_images/map_module_2.png

J-BusinessDirectory Listing Videos Module

After installation you access the modules section of Joomla administration and filter by listing videos module. You should be able to see the J-BusinessDirectory Listing Videos module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

The module displays the latest listing videos published.

_images/listing_videos_1.png
  • View type – the layout in which the listings videos will be displayed

  • Ordering – set the default ordering for the videos

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

  • Categories – you can choose to display only the videos that belong to the set categories

  • Number of videos – set the max number of videos to display on the widget

  • Show listing name - choose rather to show or not the listing name on the video widget

After installation you access the modules section of Joomla administration and filter by listing videos module. You should be able to see the Joomla-BusinessDirectory Listing Videos module and you can click on it to access the settings.The site administrator can assign the module anywhere on the website.

_images/listing_videos_2.png

J-BusinessDirectory Announcements Module

After installation you access the modules section of Joomla administration and filter by announcements module. You should be able to see the J-BusinessDirectory Announcements module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

The module displays the latest announcements published.

_images/announcements_1.png
  • Ordering – set the default ordering for the announcements

  • Alphabetical/ID ordering - set the ordering type

  • Number of announcements – set the max number of announcements to display on the widget

  • Categories – you can choose to display only the announcements that belong to the set categories

  • Link target - set item link target

  • Listings geo location – display announcements based on announcements location – this will do a refresh of the page and the coordinates will be added on the current URL

  • Geo location radius – show announcements based on the radius set

  • Title characters - set the number of characters to show as announcement title, the rest of the characters with be truncated

  • Description characters - set the number of characters to show as announcement description, the rest of the characters with be truncated

  • Item background color – set the background color of the latest announcements

  • Item border color - set the border color of the latest announcements

After installation you access the module section of Joomla administration and filter by announcements module. You should be able to see the J-BusinessDirectory Announcements module and you can click on it to access the settings.The site administrator can assign the module anywhere on the website.

_images/announcements_2.png

J-BusinessDirectory Packages Module

_images/package_module_1.png

After installation you access the modules section of Joomla administration and filter by packages module. You should be able to see the J-BusinessDirectory Pacakges module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

On this module you will have to select the packages that will show on the front-end area and also the text next to it.

Note:If packages are disabled the module will just a preview of the functionality. In order to enable packages please set Enable Packages to yes on J-BusinessDirectory General Settings | Business Listings tab

_images/package_module_2.png

J-BusinessDirectory Keyword Feed Module

_images/keyword-2.png

After installation you access the modules section of Joomla administration and filter by keyword feed module. You should be able to see the J-BusinessDirectory Keyword Feed module and you can click on it to access the settings.

The site administrator can assign the module anywhere on the website.

The module gets a list of keywords, the ones which have been used the most and displays them in a section. Upon clicking on each keyword it performs a keyword search.

_images/keyword-1.png