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

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

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

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

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

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

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

  • 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

  • Memberships – filter the displayed listings by the selected memberships

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

  • 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

  • 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

  • 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, which will redirect the user to set categories above

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

  • 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

  • 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 offer search module

  • 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

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

  • 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 Offers – max number of map markers, when there are no search results.

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

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

  • Mandatory zipcode – set the zipcode field to mandatory

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

  • Show countries – show countries

  • Mandatory countries – set countries mandatory

  • Show province – show province

  • Mandatory province – set province mandatory

  • Show min price – show the min price field

  • Show max price – show the max price field

  • Show bookmark - show bookmarks

  • 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

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
  • View type – the view on which the offers will be displayed

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

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

  • Mobile Layout – layout for the mobile devices

  • Tablet Layout – layout for the tablet devices

  • Desktop Layout – layout for the desktops

  • 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

  • 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

  • Type – filter the offers based on type

  • 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

  • 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

  • Ordering – set the default ordering for the 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, which will redirect the user to set categories above

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

  • Show location – show offer location

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

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

_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

  • 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 event search module

  • 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

  • Map height – set the height of the map

  • Map width – set the width of the map

  • 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 only map – show only map on search module

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

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

  • Mandatory zipcode – set the zipcode field to mandatory

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

  • 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

J-BusinessDirectory – 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. For list view type the layout will be always vertical.

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

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

  • Type – filter the events based on type

  • 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

  • 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

  • Ordering – set the default ordering for the 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, which will redirect the user to set categories above

  • 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

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