Directory Apps¶
You can enhance the directory functionality with multiple directory applications that can be found on our store. It is possible for the apps to be installed in groups.
JBD Stripe¶
J-BusinessDirectory Stripe is a payment plugin that provides the possibility to receive payment using Stripe payment gateway. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#stripe-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Stripe 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Stripe archive (jbd-stripe.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Stripe payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
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. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#stripe-subscriptions-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Stripe Subscriptions 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Stripe Subscriptions archive (jbd-stripe-subscription.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Stripe Subscription payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
You will have to fill in the configuration parameters and make sure that the payment processor is enabled.
Name – the name of the processor that will be displayed on front-end
Type – the type of the processor. This is currently used for coding purposes
Timeout – time allocated until a pending payment will expire
Services - select in which service you want to use the payment processor
Mode – the mode the processor is in: Live or Test
Status – set whether the processor is active or disabled.
Display Front - set whether want to show on front or not
Secret key - provided by Stripe (check the image below)
Publishable key - provided by Stripe (published key)
The payment works in the following way.
1. The site admin has to create packages with a defined period of time and desired features on directory extension.
2. The site admin will create payment plans on stripe account dashboard with the exact name of the plans that have been created on directory extension.
3. Setup the webhook for notifying the site when the amount for the subscription is being charged from customer account. The webhook link can be found below.You just have to replace yoursite.com with your domain name: http://yoursite.com/index.php?option=com_jbusinessdirectory&task=payment.processSubscriptionResponse&processor=stripeSubscriptions
For the event type select charge only.
Setup the Products
For each package in the business directory you need to setup a product in Stripe. Setup the product to have the same pricing and recurring details as per the correspondent package in the business directory.
Important
When defining the product it is important to set the price description to be the same as the package name in the business directory.
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
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. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#paypal-subscriptions-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Paypal Subscription 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Paypal Subscription archive (jbd-paypal-subscription.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Stripe payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
The subscription mechanism works in the following way.
The site admin has to create packages with a defined period of time and desired features.
The business owner creates a business listings and associate it with a package. If the package is paid an order is generated and the user can pay for it with existing payment methods.
When the payment is made with subscription method a subscription is created for the user with the subscription period equal to package period.
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Authorize.net¶
J-BusinessDirectory Authorize is a payment plugin that provides the possibility to receive payment using Authorize payment gateway. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#authorize-net-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Authorize 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Authorize archive (jbd-authorize.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Authorize payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Authorize.net Subscription¶
J-BusinessDirectory Subscriptions is a payment plugin based on Authorize Subscriptions that enables the receiving of a recurring payment. It provides the possibility of having subscriptions only in J-BusinessDirectory extension. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#authorize-net-subscriptions-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Authorize Subscription 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Authorize archive (jbd-authorize-subscription.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Authorize Subscription payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
The payment works in the following way.
1. The site admin has to create an authorize account in order to retrieve the transaction key and API login ID
2. The site admin will have to set the credentials on the installed authorize subscriptions extension in the JBD component. The API credentials can be found on the account settings.
3. The site admin will have to request a transaction key for the payment processor, with the option to also disable an old one, if needed.
4. An email with the verification PIN will be received in the registered email address
After the PIN will be requested, the received one needs to be entered
5. When the identity of the user will be verified, the new transaction key can be obtained
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Payfast Subscription¶
JBD Payfast Subscriptions is a payment plugin based on Payfast Subscriptions that enables the receiving of a recurring payment. It provides the possibility of having subscriptions only in J-BusinessDirectory extension. You can find more information on this payment processor here: https://www.cmsjunkie.com/docs/jbusinessdirectory/businessdiradmin.html#payfast-payment-processor
Installing the application¶
To begin the installation of the J-BusinessDirectory Payfast Subscription 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Payfast archive (jbd-payfast-subscription.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Payfast Subscription payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
The payment works in the following way.
1. The site admin has to create a payfast account in order to retrieve the merchant ID, the merchant key and to generate the passphrase.
2. The site admin will have to set the credentials on the installed payfast subscriptions extension in the JBD component.
3. After all the data is set and saved, the payment processor can be used and all the payment details will be also shown on the payfast sandbox.
JBD Mollie¶
JBD Mollie is a payment plugin that provides the possibility to receive payment using Mollie payment gateway.
Installing the application¶
To begin the installation of the J-BusinessDirectory Mollie 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD MOllie archive (jbd-mollie.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Mollie payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
If you don’t have a Mollie account, visit the Mollie website (https://www.mollie.com/) and sign up for an account. After signing up, log in to your Mollie account.
Upon logging in, you’ll be directed to your Mollie account dashboard. This is where you can manage your payment settings and API keys.
There’s API keys option on the developers submenu on the user dashboard . This is where you’ll generate and manage your API keys.
Add the API key on the payment processor fields.
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Mollie Subscriptions¶
JBD Mollie SUbscriptions is a payment plugin that provides the possibility to receive payment using Mollie payment gateway.
Installing the application¶
To begin the installation of the J-BusinessDirectory Mollie Subscriptions 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Mollie Subscriptions archive (jbd-mollie-subscriptions.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Mollie Susbcriptions payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Cardlink¶
Cardlink is a Greek payment gateway solution that provides online payment processing services. JBD Cardlink is a payment plugin based on Cardlink payment gateway.
Installing the application¶
To begin the installation of the J-BusinessDirectory Cardlink 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Cardlink archive (jbd-cardlink.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Cardlink payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
Visit the Cardlink website (https://www.cardlink.gr/) and sign up or sign in if you have been already registered.
During the sign-up or registration process, you’ll need to provide information about your business, such as its name, website, contact details, and more. Make sure to provide accurate and complete information.
Once your registration is approved by Cardlink, they will provide you with a unique Merchant ID. This ID serves as an identifier for your business when processing payments.
Cardlink will provide you with a shared secret key, which is used for secure communication between your server and Cardlink’s server. This key is usually used to sign and verify data exchanged during transactions.
Add the Merchant ID and shared secret key on the payment processor fields.
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Cardlink Subscriptions¶
JBD Cardlink Subscriptions is a payment plugin based on Cardlink Subscriptions that enables the receiving of a recurring payment. It provides the possibility of having subscriptions only in J-BusinessDirectory extension.
Installing the application¶
To begin the installation of the J-BusinessDirectory Payfast Subscription 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Cardlink Subscriptions archive (jbd-cardlink-subscriptions.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Cardlink Subscriptions payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
JBD Razorpay¶
JBD Razorpay is a popular online payment gateway and financial technology company based in India. It is used by businesses and individuals to facilitate online payments, manage transactions, and accept payments from customers. You can find more information on this payment processor here: https://razorpay.com/
Installing the application¶
To begin the installation of the J-BusinessDirectory Razorpay 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Razorpay archive (jbd-razorpay.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the payment processors section the new Razorpay payment processor will be shown. The site administrator has to complete the details, make the processor available for the front-end and also choose for which of the apps this processor will be used.
How it works¶
If you haven’t already, go to the Razorpay website and sign up for an account. After signing up, log in to your Razorpay account.
Once logged in, you will be directed to your Razorpay dashboard. This is where you’ll manage your payment gateway settings and keys.
Look for an option like “API Keys” or “Settings” in the dashboard. This is where you’ll generate your API keys.
In the API Keys section, you should see options to generate both the Key ID (also known as the “key_id”) and the Secret Key (also known as the “key_secret”). The Key ID is used on the client-side, while the Secret Key is used on the server-side.
Click on a button or link to generate a new Key ID. You might be asked to provide a name or description for the key to help you identify its purpose later. The Key ID is a public identifier and is safe to be used in your frontend code.
Similarly, click on a button or link to generate a new Secret Key. This key is sensitive information and should never be exposed in client-side code. It’s used to authenticate and authorize requests made from your server to the Razorpay server.
Add the Razorpay Key ID and Razorpay secret key on the payment processor fields.
Once all the details are completed, the payment processor will be available on the payment screen, where it can be chosen by the front-end user and be used to compete the payment for the desired item.
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.
Installing the application¶
To begin the installation of the J-BusinessDirectory Recurring Events 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Recurring Events archive (jbd-recurring-event.zip).
You will receive a confirmation message upon successful installation completion
How it works¶
When the installation is completed on the edit event view the following section should be shown.
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.
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.
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:
Copy the plugin file, com_jbusinessdirectory.php, to {joomla}/components/com_sh404sef/sef_ext
Copy the language file to {joomla}/administrator/components/com_sh404sef/language/plugins/
Setup and configuration¶
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¶
Configuration/General/By component
JBD Quote Request¶
JBD Quote Request is an application that brings new ways for end users to get in contact easier with the businesses. The JBD Quote Request application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-quote-requests
Installing the application¶
To begin the installation of the J-BusinessDirectory Quote Request 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Quote Request archive (jbd-quote-requests.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, in the directory general settings, three new settings will be shown:
Enable request quote app (Business listings tab) – enables the request quotes views on both, admin and site
Choose request quote usergroup (Front-end tab) – the default usergroup set for the new users created during the quote requesting process
Request quote radius (Front-end tab) – the radius set for the location search
When the Enable request quote app 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.
How it works¶
The quote requests mechanism can be accessed in two ways:
by enabling the JBD Quote Request module, assigning it to a certain page and if a category search is performed, for which there are existing request questions, the button will be shown.
by enabling the Link with quote request option in the JBusinessCategories module; if this module is active and the selected category for the module has available request questions, the mechanism will be applied.
Quote request process
Step 1: Perform a category search
Search for the desired category and then press the Request Quote button, which appears on the search results on the position set on the JBD Quote Request module
Step 2: Enter the location
The user will be requested to enter his location. If no business listing is found in the area determined by the location and the radius (that is set on the general settings), a message will be show and the process is interrupted. Otherwise the user will move to step 3.
Step 3: Answer the questions
The user will be presented server questions (that are defined on the backend) and an answer has to be selected or input
Step 4: Fill in the user details
After all questions have been answered and if the user is not logged in he will be requested to enter his name and email, and a new account will be created. If he already has an account then he can be directed on the log in form to enter his credentials.
This user will belong to the default usergroup set in the directory’s general settings.
This step won’t be shown if the user is already logged in.
Step 5: Request notes
The user can add a title for the request at “Request title” box and then select a business on the second select box below.
The user can leave an optional note for the companies with some details that were not covered on the defined questions.
Step 6: Request confirmation
A confirmation screen will be shown to the user. All businesses from that category will receive an email to reply to the quote request and will have the possibility to reply to the request.
Step 7: Hire company
The client will decide for the best quote and hire the company for the job from his front-end control panel.
Request Questions¶
This section contains the questions that will be defined by the site admin to be used during the quote request process.
A request question contains the following details:
Name – name of the question
Category – set the category for which the question will be available
Type – the question type, radiobutton, checkbox or input field
Status – set to published or unpublished
Image – upload an image to represent the question
Question options – add as many question options as desired and set them to published or not
After all the details are filled by the admin and saved, the questions will be shown in the Request questions section.
Quote Request¶
The requested quotes will be available on the admin section and on the user dashboard, in the front-end section.
Business Owners Section¶
For the company owners, all the requested quotes will be shown on the Request Quotes section in the front-end Control Panel.
As it is seen in the above picture, when selecting the Apply button (second row), the page will be reloaded, adding the possibility for the company’s owner to chat with the client. When selecting the chat button (first row), a chat dialog box will be opened, adding the opportunity for a real-time conversation between the client and the company’s owner.
User Dashboard¶
All the companies that have replied will be shown in the user dashboard. The requested quote will contain:
creation date
searched area
searched category
number of replies
additional information (the optional note)
questions summary
Below all the information, will be also shown the listings that have replied to the client.
By selecting on the company name, the user can open the chat dialog box to contact the company’s owner.
After the client has made the decision, s/he can hire the desired listing.
Quote Request List View¶
All the created quote requests will be appearing on a new section on the front-end area which is the Quote Request List View.
If the user who has created the quote request is logged in then his quote request will have the “owned” title on the left, otherwise will appear the apply button if the user wants to apply on a new quote request.
JBD Trips¶
JBD Trips is an application that extends the J-BusinessDirectory Trips functionality by adding the possibility of managing and booking a trip. The JBD Trips application can be purchased separately from our strore on : https://www.cmsjunkie.com/joomla-business-directory/jbd-trips.
Installing the application¶
To begin the installation of the JBD Trips application, log in into you Joomla backend and follow the steps described below:
In the main menu, you will be presented with the Directory Apps section.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Trips archive (jbd-trips.zip).
You will receive a confirmation message upon successful installation completion.
Setup and configuration¶
When application is installed, in the general settings (Front-end tab) a new setting called “Trips search view mode” on the Trips section will be displayed.
There you can select the search view mode, list or grid view.
How it works¶
Each business owner has the possibility to define trips in order to promote their services or products. Trips can be shown on the front-end with the help of the Trips menu item. You can add/edit and delete a trip from the Manage Trips screen.
When editing/adding a new trip you’ll be presented with the following
Trip
Name - the name or the title of the trip
Alias - the alias of the trip
Description - the description of the trip
Contact Info
Organizer - the organizer of the trip
Telephone - the telephone number of the organizer
Email - the email of the organizer
Trip Dates
Start date - trip start date
End date - trip end date
Start time - trip start time
End time - trip end time
Repeat
Repeats - set the recurring method: no repeat, daily, weekly, monthly, yearly and by date (where the user can select manually the dates he wants for the trip).
Repeat every - set the recurring interval for the trip 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 trip start and end date.The trips 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.
After choosing one of the options click the apply button in order to save the changes, and all the relevant information will appear below.
Recurring Dates Capacity Overrides
Default capacity - set the capacity of the trip dates, and it will be applied on all the dates.
Add override - otherwise you can add a specified capacity for each of the trip dates specified on the previous section.If there is no override capacity for a specific date then the default capacity will be taken into consideration.
Pictures - You can upload multiple pictures for your trip.You can upload pictures and set a description for them in this section.To upload a picture simply click the Add Files button and choose the desired picture by navigating through your content.
All the information will be shown on front-end on the trips section.It will be displayed through a menu item. There are two different view styles as mentioned before which can be defined on the general settings.
Grid View
List View
And the details view for each of them.
User Packages¶
In order to do a trip booking, each user should have a package assigned, and they are called user packages .
On the menu items settings is added a new setting called packages type where you can define what type of package you want to show.
And the creation process is the same as on the business packages.
On search tools as it is shown on the image above you should select “User” if you want to create a user package and “Business Listings” if you want to create a business package.
User Package Details¶
A user package contains the following
Name - the name of the package
Descripton - the description of the package
Price description - text that will be shown under the price
Only for admin - when set to yes, the package will not display on business plans menu item, front-end
State - you can set whether want to activate the package or not
Type - you can choose between the following types:
Lifetime - the package is available for lifetime period
Fixed period - the package is available for a fixed period of time
Recurring - – the package is available for a fixed period of time with the possibility of automatically renewing the package. The package is activated each time a recurring payment is performed. (works only with recurring payment methods)
Recurring with trial - similar with recurring time packages, but it also provides a trial period where the user can determine its duration and price. After the trial period is finished a new order is created for the recurring package with full price and duration. Otherwise if you don’t want to continue using this package you can cancel the subscription during the trial period and will be paying only the trial price, if there is any.
Price - the price you are charging for a package. The price will be displayed in the frontend.
Renewal price - a price taken into consideration if the package period is extended.
Max nr of trips - set the maximum number of trips that is allowed
Show features - set whether want to show or not the features that are included in the package.
Show not contained package features -set whether to show or not the package features that are not included in the package
Show choose button - set whether want to show choose button or not
Background button - admin can set a background color for the package
Text color - admin can set a text color for the package
Border color - admin can set a border color for the package
Package features - the features you want to assign to your package
Trips -move the trips feature from the first box to the second one in order for trip to be included on the package
Custom features - the custom features are features, that the admin can offer to customers, supplementary to the current directory features. The custom features have no functionality related to business directory.
Trip Booking¶
All the trips will be displayed on the trip list/grid view on the frontend.
Step 1 : Access the desired trip details page
Step 2: Before doing the booking, the user must be logged in.
Step 3: The user should also have an active plan (user package), and if it is so the number of booked trips must not have exceeded.
Step 4: If everything is set, then the view will be as it follows, with all the available dates in a darker color, and a book button below.
Step 5: After clicking on the “book” button the booking details will appear with all the details for the trip and for the user.
NOTE: If the user doesn’t complete the booking for the next 15 minutes, then the reservation will be cancelled.
Step 6: Otherwise if the booking is complete than the reservation is made.
Manage Trip Bookings¶
All the necessary information about the packages that have been bought and the trips that have been reserved will be available on the user dashboard, on package orders and trip bookings sections.
The booked trips will be listed in the trip bookings section on admin area too.
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.
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 business services” will be displayed.
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.
A business service can be added from both admin or front-end area, and contains the following details:
Select a business - selecting the listing, that will contain this service
Name – name of the service
Description – description of the service
Attendance mode - select between Live, Virtual or Mixed
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
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.
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.
Select a business - the business which the provider belongs to
Name – name of the service provider
Description – description of the service provider
Add image - add a profile image for 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
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
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
Step 2: Select the service and the service provider
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.
Step 4: Complete the billing details
Step 5: Select the payment method and perform the payment
Step 6: Booking confirmation
Manage service bookings¶
The business service bookings will be listed in the company service bookings section.
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.
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) two new settings called “Enable offer selling” and “Enable shipping” will be displayed.
After these settings 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 settings on general settings are set to yes, in the offers edit view will be displayed two new sections.
Item Selling
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.
The item quantity and notify quantity fields will be shown only if there are no selling attributes for the actual offer.
To add selling attributes for offers, it is needed to be used the offers custom attributes. One of the custom attributes options is the “Use as offer selling attribute”. When this setting will be set to Yes, this custom attribute will be used as a selling attribute for the offer and will be shown in the Item selling section. Otherwise, when set to No, it will be shown as a custom attribute using the old functionality.
Once the setting is set to Yes, also other settings of the custom attributes will be affected:
mandatory setting will be set to yes automatically
show in front setting will be set to yes automatically
custom attribute type will be set to select-box
Category selection for offers custom attributes will always be available for selection.
The attributes with no selected categories will be shown automatically in all existing offers. And the ones with selected categories will be shown only in the offers that belong to these categories or their child categories.
After the selling attributes are created, a new section will be displayed. The “Use stock price” setting will be shown to enable or not a price field for each stock configuration. When the setting is set to Yes, you can set different prices for each stock along with the item quantity and notify quantity. In this case the main price will be ignored. If the setting is set to No, the main price will be taken into consideration and there will be only two fields shown: quantity & notify quantity.
Once the remaining quantity set on the Notify quantity field is reached, the offer owner will receive an email notifying him that the remaining quantity of the item is less than the set one.
Shipping Methods
The shipping methods will be shown when shipping methods will be created by the site administrator, at their respective section on admin. When the shipping method is selected, its price will be added to the offers’ price when the order will be made. The shipping method should also belong to the same business owner that owns the offer, in order to be shown. Or when creating a shipping method , the site admin can create default ones, by setting to yes the default option on the shipping methods edit view. And these shipping methods will be always available, despite the business owner.
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
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.
The user can either continue shopping or can view the shopping cart.
Step 3: Checkout the selected items
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
Step 5: Select the payment method and perform the payment
Step 6: Booking confirmation
Manage offer orders¶
The orders are listed in the Offer Orders menu item, where they can also be edited by the site admin.
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.
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.
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
Step 2: Fill in the details and book the appointment
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
Date – the date interval varies based in the start/end date of the event itself
Preferred time – the desired time asked for the booking
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.
Also, the event owner can access the event appointments in the front – end control panel section, to confirm or deny the appointment.
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.
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.
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.
Event tickets¶
This section contains the tickets that will be defined by the event owners.
An event ticket can be added from both admin or front-end area, and contains the following details:
Event - type or select the event which the ticket belongs to
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
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 billing details
Step 4: Select the payment method and perform the payment
Step 5: Booking confirmation
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.
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.
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.
After the conferences will be saved and listed in the conference section, they will display on front – end, with all the saved details.
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, the registration URL, a video and several attachments. After all the details are filled and saved, the sessions will be listed in their own section.
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.
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.
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.
Session Levels¶
In this section, you can define the level of sessions that are available on the created sessions.
After all information is saved and also completed on the session section, all the available sessions will display in the front – end section.
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.
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.
After all information is saved and also completed on the speakers section, all the available speakers will display in the front – end section.
JBD Campaigns¶
JBD Campaigns is an application that brings new ways of business listing advertising and also a new tool for monetizing your website. The JBD Campaigns application can be purchased separately from our store on https://www.cmsjunkie.com/joomla-business-directory/jbd-campaigns
Installing the application¶
To begin the installation of the J-BusinessDirectory Campaigns 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.
Click the Install button (on the bottom of the Directory Apps section).
Choose your downloaded JBD Campaigns archive (jbd-campaigns.zip).
You will receive a confirmation message upon successful installation completion
Setup and configuration¶
When the application is installed, two new menu items will be displayed in the sidebar called Campaigns and Campaign Plans. The Campaigns menu item will be visible also in the front-end Control Panel section.
How it works¶
The website owner can create multiple places on his website to offer the possibility for the business owner to advertise his business listing on those places. For each place, a new campaign plan and a new module position should be created. For each website place, the website owner can create a campaign plan with different prices, depending on the importance of the position.
A budget can be set for each campaign and after the budget limit will be reached, the campaign will not be active anymore.
Campaigns¶
This section contains the campaigns that will be defined by the business owners.
A campaign can be added from both admin or front-end area, and contains the following details:
Select a business – the site admin can select a listing to which this campaign will belong to
Select plans – all the campaign plans created will be listed here; only one plan per campaign can be selected.
Name – the name of the campaign
Budget – the budget set per campaign
Status – shows whether the campaign is paid or not
State – set whether the campaign is active or not
After all the details are filled by the user and saved, the campaigns will be displayed in the Campaigns section.
Campaign Plans¶
This section contains the campaign plans.
Each campaign has to contain a campaign plan in order to be functional. Campaign plans can be added only by the site admin.
A campaign plan contains:
Name – name of the campaign plan
Price per click - set the price per click
Image – set the image of the campaign plan
State – set the campaign plan to active or inactive
Manage Campaigns¶
When the JBD Campaigns application is installed, in the JBD Business Listings module, two new options are shown:
Campaign position – choose the campaign position
Only campaigns – set whether to display only campaigns or not
Only when this setting is set to yes, in the module will be shown only listings associated with paid campaigns in the chosen position.
Whenever one of the listings is clicked, the budget set per campaign will be decreased by the price per click set in the campaign plan. When the budget limit will be reached, then the listing associated with the campaign will not be visible anymore in the module.
JBD Videos¶
JBD Videos is an application that extends the J-BusinessDirectory VIdoes functionality by adding the possibility of managing and adding a video. The JBD Videos application can be purchased separately from our store on https://www.cmsjunkie.com/joomla/joomla-extensions/joomla-business-directory/jbd-videos
Installing the application¶
After purchasing the JBD Videos 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 Videos 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.
Click the Install button.
Choose your downloaded copy of the JBD Videos archive (jbd-videos.zip).
You will receive a confirmation message upon installation completion
Setup and configuration¶
When application is installed, in the listing features (Business Listings tab) a new setting called “Enable videos” will be displayed.
If the setting it’s enabled , the videos section will appear on the admin dashboard area.
How it works¶
Each business owner has the possibility to define videos in order to promote their services or products. Videos can be shown on the front-end with the help of the Videos menu item. You can add/edit and delete a video from the Manage Videos screen.
When editing/adding a new video you’ll be presented with the following
Name - the name or the title of the video
Alias - the alias of the video
URL - set the url of the video
Description - the description of the video
Transcript - you can set the text of the video
Duration - the video duration
Categories
Category - categories of the video
Main category - main categori which will be selected from all the categories above
Add video thumbnail
Upload an image. It will be used as a main image for the video on search results list and on the video list details
Custom Attributes¶
Please check chapter 3.3.4 Custom attributes for further details
Videos Categories¶
You can add/edit, delete and publish/unpublished a video category from the Manage Categories screen.
When all the details are completed, all the information will be shown on front-end on the videos section.
