Directory Apps

You can enhance the directory functionality with multiple directory applications that can be found on our store.

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

JBD Stripe

J-BusinessDirectory Stripe is a payment plugin that provides the possibility to receive payment using Stripe payment gateway.

JBD Stripe Subscription

J-BusinessDirectory Subscriptions is a payment plugin based on Stripe Subscriptions that enables the receiving of a recurring payment. It provides the possibility of having subscriptions only in J-BusinessDirectory extension.

JBD Paypal Subscriptions

J-BusinessDirectory Subscriptions is a payment plugin based on Paypal Subscriptions. It provides the possibility of having subscriptions in J-BusinessDirectory extension.

JBD Recurring Events

JBD Recurring Events is an add-on that extends the J-BusinessDirectory Events functionality by adding the possibility of having recurring events. To install the add-on you will need an FTP connection to your existing Joomla installation.

When the installation is completed on the edit event view the following section should be shown.

_images/recurring_1.png

You can find below the description for each field.

  • Repeats: set the recurring method: daily, weekly, monthly and yearly.
  • Repeat every: set the recurring interval for the events series
  • Start on: set the start date of the recurring series.
  • Ends: there are 2 options available. You can set an end date or you can set the number of occurrences. The start and end date are always linked to the event start and end date. The events will be created until the end date is lower than the end day set on the date field or when the number of occurrences is reached.

When an event that is part of a recurring series is saved the following popup is shown.

_images/recurring_2.png

You have the possibility to save the modifications for the recurring event, for the events that follow the current event or for all the events in the series.

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

JBD sh404SEF

JBD-sh404sef is a plugin that provides an integration between J-BusinessDirectory extension and sh404SEF extension. All links generation from J-BusinessDirectory extension will be handled by sh404SEF extension.

Installing the plugin

To install the plugin you will need an FTP connection to you existing Joomla! installation. First, you will have to unzip the jbd-sh404sef.zip and extract the content. There are 2 files on the zip archive, the plugin file which is called com_jbusinessdirectory.php and the language file that is located on language folder which has the same name, com_jbusinessdirectory.php.

You will have to copy the files to their corresponding folders as following:

  1. Copy the plugin file, com_jbusinessdirectory.php, to {joomla}/components/com_sh404sef/sef_ext
  2. Copy the language file to {joomla}/administrator/components/com_sh404sef/language/plugins/

Setup the plugin

In order to setup the plugin you will have to edit the file {joomla}/components/com_sh404sef/sef_ext/com_jbusinessdirectory.php

On the beginning of the file there are several options that you can configure

$sefConfig->shInsertJBDName = false; Allows the possibility to add/remove the extension name on the generated URL

$sefConfig->shJBDInsertListingName = true; Allows the possibility to add/remove the listing alias on the generated URL

$sefConfig->shJBDInsertListingId = false; Allows the possibility to add/remove the listing id on the generated URL

$sefConfig->shJBDPrependListingId = false; Allows the possibility to add the listing id at the end of the generated URL

$sefConfig->shJBDInsertListingCategories = 0; Allows the possibility to add/remove the category on the generated listing URL

/* integer, if 0, no categories will be inserted in URL for an item

If 1, only ‘last’ category will be inserted in URL

If 2, all nested categories will be inserted in URL */

$sefConfig->shJBDInsertCategories = 2; Allows the possibility to add/remove the category on the generated search results URL /* integer, if 0, no categories will be inserted in URL for a product.

If 1, only ‘last’ category will be inserted in URL

If 2, all nested categories will be inserted in URL */

$sefConfig->shJBDInsertCountry = 1; Allows the possibility to add/remove the country on the generated search results URL

$sefConfig->shJBDInsertRegion = 1; Allows the possibility to add/remove the region on the generated search results URL

$sefConfig->shJBDInsertCity = 1; Allows the possibility to add/remove the city on the generated search results URL

$sefConfig->shJBDInsertType = 1; Allows the possibility to add/remove the type on the generated search results URL

$sefConfig->shJBDInsertCategoryId = false; Allows the possibility to add/remove the category ID on the generated search results URL

Proposal setup for sh404 plugin

_images/sh404_1.png

Configuration/General/By component

_images/sh404_2.png

JBD Appointments

JBD Appointments is an application that extends the directory functionality by adding the possibility of booking services and appointments for a business. The JBD Appointments application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-appointments

Installing the application

To begin the installation of the J-BusinessDirectory Appointments application, log in into your Joomla backend, access the directory dashboard and follow the steps as described below:

  • In the main dashboard, you will be presented with the Directory Apps section.
_images/dashboard.jpg
  • Click the Install button (on the bottom of the Directory Apps section).
  • Choose your downloaded JBD Appointments archive (jbd-appointments.zip).
  • You will receive a confirmation message upon successful installation completion

Setup and configuration

When application is installed, in the general settings (business listings tab) a new setting called “Enable company services” will be displayed.

_images/general_settings_services.png

When the setting will be set to yes by the administrator, on the dashboard menu items, for both admin and front-end Control Panel, new menu items will be visible under the Business Listings menu item.

How it works

For each business you can define a different number of services that will be performed by the service providers based on an availability schedule. When services are defined for a business listing, on the front-end business listing details page, a new section will appear, Services. The services can be booked by the end users based on the current availability, and for each booking the business owner and the site admin will be notified with the booking details.

Business services

This section contains the services that will be defined by the business owners.

_images/service_list.png

A business service can be added from both admin or front-end area, and contains the following details:

Name – name of the service

Description – description of the service

Status – setting if the service will be published or not

Duration – setting the duration of the service in hours and minutes

Show duration – setting if the duration of the service will display or not in front – end

Business – selecting the listing, that will contain this service

Currency – the currency

Price – the price of the service

Max number of bookings per service – the max number of time that the service can be booked

After all the details are filled by the user and saved, the services will be displayed in the Business Services section.

Service providers

This section contains the business service providers.

_images/serviceProviders_list.png

Each service has to be associated with a provider, in order to display in the listings details view and to be booked. A service provider can be added from both, admin area and front – end control panel and contains the following details.

Name – name of the service provider

Description – description of the service provider

Email – the email of the service provider

Telephone – the phone number

Max number of clients to be served – the max number of persons that can book the same service on the same date and the same time

Business – the business which the provider belongs to

Services – services that belong to the actual provider; the services are showing based on the selected business

Status - setting if the service will be published or not

Working hours – the hours for which the service provider will be available for booking

Break hours – the break hours of the provider

Yearly availability – the vacation period of the provider; the user can add several vacation periods for the provider and during these periods, the provider dates won’t be active and available for booking.

Booking a service

All services that are associated with at least one service provider will be shown on the business listing details page and it will be available for booking.

Step 1: Access the services section of the business listing details page

_images/company_service3.png

Step 2: Select the service and the service provider

_images/company_service4.png

Step 3: Select the available dates After the provider is selected, the available dates and working hours for each date will display so that the user can book the desired date and time.

_images/company_service5.png

Step 4: Complete the guest details

_images/service_pay_1.png

Step 5: Select the payment method and perform the payment

_images/service_pay_2.png

Step 6: Booking confirmation

_images/thank_you_appointments.png

Manage service bookings

The business service bookings will be listed in the company service bookings section.

_images/serviceReservation_list.png

JBD Sell Offers

JBD Sell Offers is an application that extends the J-BusinessDirectory Offers functionality by adding the possibility of selling/buying an offer. The JBD Sell Offers application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-sell-offers

Installing the application

After purchasing the JBD Sell Offers application, you can install the zip with all the files. After running the installation, you will be able to access the application from the component menu in the backend. To begin the installation of the JBD Sell Offers application, log in into your Joomla backend and follow the steps as described below:

  • In the main menu, you will be presented with the Directory Apps section.
_images/dashboard.jpg
  • Click the Install button.
  • Choose your downloaded copy of the JBD Sell Offers archive (jbd-sell-offers.zip).
  • You will receive a confirmation message upon installation completion

After the plugin has been installed successfully, you will be able to access the Offer Orders menu item in the administrator and front - end areas, under the Offers menu item.

Setup and configuration

When this application is installed, in the general settings (offers tab) a new setting called “Enable offer selling” will be displayed.

_images/general_settings_offers.png

After this setting will be set to yes by the administrator, also the menu items will be visible under the Business Listings menu item, on both admin area and front – end Control Panel.

How it works

Once the setting on general settings is set to yes, in the offers edit view will be displayed a new section.

_images/offer_selling1.png

The “Enable offer selling” setting will also be shown on offer level to enable or not the selling for the actual offer. The item quantity can be set here, to set a restriction on the quantity of orders that can be done on the actual offer. Also, the minimum and maximum number of purchases can be added to set a minimum and maximum on the user on how many orders he can do at the same time.

Once all the information is set, in the offers’ detail view will display a quantity selector and a “Add to cart” button. Once, the maximum of purchases has been reached, the quantity selector will not be displayed anymore.

Buying an offer

Once all the details are filled in and set, the user can proceed to add items (offers) to the cart.

Step 1: Access the offer and select a certain quantity to add to the cart

_images/offer_selling.png

Step 2: Access the shopping cart view

After selecting the desired quantity and the “Add to cart” button, a popover will be displayed notifying the user that the item has been successfully added to the cart.

_images/offer_selling2.png

The user can either continue shopping or can view the shopping cart.

Step 3: Checkout the selected items

_images/offer_selling3.png

The chosen item can be edited or also removed.

After selecting the “Checkout” button, the user will be redirected to the guest details to fill in the personal information and after that to the payment page to complete the payment of the items that were on the cart.

Step 4: Complete the guest details

_images/offer_pay_1.png

Step 5: Select the payment method and perform the payment

_images/offer_pay_2.png

Step 6: Booking confirmation

_images/thank_you_offers.png

Manage offer orders

The orders are listed in the Offer Orders menu item, where they can also be edited by the site admin.

_images/offer_selling_list.png

Or they can be accessible and edited by the offer owner, in the front – end control panel section.

JBD Event Appointments

JBD Event Appointments is an application that extends the J-BusinessDirectory Events functionality by adding the possibility of booking an appointment. The JBD Event Appointments application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-event-appointments

Installing the application

After purchasing the JBD Event Appointments application, you can install the zip with all the files. After running the installation, you will be able to access the application from the component menu in the backend. To begin the installation of the JBD Event Appointments application, log in into your Joomla backend and follow the steps as described below:

  • In the main menu, you will be presented with the Directory Apps section.
_images/dashboard.jpg
  • Click the Install button.
  • Choose your downloaded copy of the JBD Event Appointments archive (jbd-event-appointments.zip).
  • You will receive a confirmation message upon installation completion

Setup and configuration

When this application is installed, in the general settings (events tab) a new setting called “Enable event appointments” will be displayed.

_images/general_settings_eventAppointments.png

After this setting will be set to yes by the administrator, also the menu item will be visible under the Events menu item, on both admin area and front – end Control Panel.

How it works

For each event, you can define the participating companies. The event, for which these companies are chosen, will be displayed in each of the selected companies details views under the “Attending events” section.

So, once the JBD Event appointments option is set to yes, in each event a new button will be displayed, called Book appointment.

Booking an appointment

Once all the details are filled in and set, the user can proceed to book the event.

Step 1: Access the business listing details view and go in the Attending events section

_images/event_appointment.png

Step 2: Fill in the details and book the appointment

_images/book_appointment.png

First name – the first name of the client

Last name – the last name of the client

Business name – the business name

Phone – the phone number

Email address – the email address of the client; a confirmation email is sent to the client after the appointment is booked

Preferred time – the desired time asked for the booking

Date – the date interval varies based in the start/end date of the event itself

Remarks – remarks from the client, if any

Manage event appointments

An event appointment is created with an ‘Unconfirmed’ status by default. It is up to the events’ owner whether to confirm or deny the appointment. For both cases, the client that booked the appointment will be notified by email.

The appointments are listed in event appointment menu item, in the administrator area.

_images/event_appointment_back.png

Also, the event owner can access the event appointments in the front – end control panel section, to confirm or deny the appointment.

_images/event_appointment_front.png

JBD Event Booking

JBD Event Booking is an application that extends the J-BusinessDirectory Events functionality by adding the possibility of booking an event. The JBD Event Booking application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-event-booking

Installing the application

After purchasing the JBD Event Booking application, you can install the zip with all the files. After running the installation, you will be able to access the application from the component menu in the backend. To begin the installation of the JBD Event Booking application, log in into your Joomla backend and follow the steps described below:

  • In the main menu, you will be presented with the Directory Apps section.
_images/dashboard.jpg
  • Click the Install button.
  • Choose your downloaded copy of the JBD Event Booking archive (jbd-event-bookings.zip).
  • You will receive a confirmation message upon installation completion

Setup and configuration

When this application is installed, in the general settings (events tab) a new setting called “Enable event reservation” will be displayed.

_images/general_settings_eventBooking.png

Once this setting is set to yes, the “Event tickets” and the “Event reservations” menu items will be shown on both, admin area and front – end Control Panel.

How it works

For each event, you can define a total number of tickets and the start/end booking dates. The total of tickets set on event level will always have priority and sets the total capacity for the actual event.

When tickets are defined for an event, on the front-end event details page, a new section containing the tickets will appear. The tickets can be booked by the end users based on the current quantity, and for each booking the event owner and the site admin will be notified with the booking details.

_images/booking_dates.png

Event tickets

This section contains the tickets that will be defined by the event owners.

_images/event_ticket2_back.png

An event ticket can be added from both admin or front-end area, and contains the following details:

Name – the ticket name

Description – the ticket description

Status – setting the ticket to published or not

Min number of tickets per booking – the minimum number of tickets that can be booked

Max number of tickets per booking – the maximum number of tickets that can be booked

Ticket price – the price of the ticket

Ticket quantity – the available quantity for the actual ticket

After all the details are filled in and saved, the tickets will be listed in the event tickets section.

Booking an event ticket

All the tickets associated with an actual event will be displayed in the events details view.

Step 1: Access the tickets section in the events details view

_images/event_ticket3.png

Step 2: Select the desired ticket quantity and book them

The user can select the quantity for the desired ticket and book them. After the “Book now” button is selected, the user will be redirected to the guest details page.

Step 3: Complete the guest details

_images/event_pay_1.png

Step 4: Select the payment method and perform the payment

_images/event_pay_2.png

Step 5: Booking confirmation

_images/thank_you_event.png

Manage event bookings

The booked tickets will be listed in the event bookings section on both, admin area and also in the front – end Control Panel.

_images/event_reservation.png

Both, event tickets and event reservations can be accessed, edited and deleted also by the event owners, in the front – end control panel section.

JBD Conference

JBD Conference is a plugin that extends the J-BusinessDirectory functionality by adding the possibility of conferences, sessions and speakers. The JBD Conference applications can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-conference

Installing the application

After purchasing the JBD Conference application, you can install the zip with all the files. After running the installation, you will be able to access the application from the component menu in the backend. To begin the installation of the JBD Conference plugin, log in into your Joomla backend and follow the steps described below:

  • In the main menu, you will be presented with the Directory Apps section.
_images/dashboard.jpg
  • Click the Install button.
  • Choose your downloaded copy of the JBD Conference archive (jbd-conference.zip).
  • You will receive a confirmation message upon installation completion

Conferences

When this plugin is installed, the conferences, sessions and speakers menu items will display. A conference will contain its name, description, the place where it will be held, the start/end date, the registration link, and the conference logo.

_images/conference2.png

After the conferences will be saved and listed in the conference section, they will display on front – end, with all the saved details.

_images/conference.png

Sessions

A session will contain its name, the date in which will be held alongside the start/end time, the category, the business (which are listed from the business listings section), the speakers, the description, the session type, the session location, the session level, the conference in which this session will be part of, a video and several attachments. After all the details are filled and saved, the sessions will be listed in their own section.

_images/sessions2.png

Session Categories

Session categories section works the same way as the listing categories. The created categories will be listed under this section and can be chosen in the sessions edit view.

_images/session_category.png

Session Types

In this section, you can define the types of sessions that are allowed/available on the created sessions. The type of sessions will also be displayed in the sessions’ section, in front – end, as filters for the available sessions.

_images/session_type.png

Session Locations

In this section, you can define the location of sessions that are available on the created sessions. The location of sessions will also be displayed in the sessions’ section, in front – end.

_images/session_loc.png

Session Levels

In this section, you can define the level of sessions that are available on the created sessions.

_images/session_level.png

After all information is saved and also completed on the session section, all the available sessions will display in the front – end section.

_images/sessions.png

Speakers

A speaker will contain his own name, his title, the business in which he works alongside the business logo, the country where he’s from, his biography, the session for which he will be a speaker, the speaker type, email and telephone number, social network pages, additional info in the form of link or text and an image.

Multiple speakers can belong to one session and only one speaker can be chosen for one conference. After all the details are filled and saved, the speakers will be listed in their own section.

_images/speakers2.png

Speaker Types

In this section, you can define the types of speakers that are allowed/available on the created speakers. The type of speakers will also be displayed in the speakers’ section, in front – end, as filters for the available speakers.

_images/speaker_type.png

After all information is saved and also completed on the speakers section, all the available speakers will display in the front – end section.

_images/speakers.png