Directory Apps¶
You can enhance the directory functionality will multiple directory applications that can be found on our store.
J-CategoryBanners¶
The module 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.
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.
The category banners can be created in the admin area in Components/Banners/Categories.
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.
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.
J-BusinessDirectory Stripe¶
J-BusinessDirectory Stripe is a payment plugin that provides the possibility to receive payment using Stripe payment gateway.
J-BusinessDirectory 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.
J-BusinessDirectory 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.
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.
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.
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 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
