Using the jDownloads Community Builder plugin

Introduction

NOTE: With Comunity Builder there are different versions of the plugin for the jD 3.9 series.
For CB 2.7 series use ext_jdownloads_cb_plugin_ v2.0.12
For CB 2.6.4 and higer 2.6.4 series use ext_jdownloads_cb_plugin_ v2.0.11
For CB 2.6.1 and lower use ext_jdownloads_cb_plugin_ v2.0.10A
IMPORTANT

If you have been using the CB 2.6.1 or earlier with the jD Plugin and intend to upgrade to to CB 2.6.4 or higher then REMOVE the existing version of the jD Community Builder plugin before you upgrade as described in section Upgrading from jD3.2 to jD 3.9 below.

------------------------------------------------------------------------------------------------------------


jDownloads has a Plugin designed specifically to work with the Community Builder component. This article shows how to use the jDownloads CB plugin to integrate the ability to access Downloads from within Community Builder. Because Community Builder is, as is obvious from its name, aimed at forming communities then the jDownloads plugin will show Downloads based upon who created the Download.

Brief notes on installing and configuring Community Builder sufficient to test the jD plugin are given below. More detailed information is given on getting and installing jDownloads Community Bulder plugin. Do not use the regular Joomla! installer as this plugin is CB specific.

The tests have been carried out using:
(1) Community Builder 2.6.0+build.2021.07.28.00.57.07.b796becaa with ext_jdownloads_cb_plugin_ v2.0.10A
(2) Community Builder 2.6.4+build.2021.11.15.17.48.12.4e5c3fdad with ext_jdownloads_cb_plugin_ v2.0.11
(3) Community Builder 2.7.2+build.2022.05.09.18.01.50.cff9cffac with ext_jdownloads_cb_plugin_2.0.12

Installation

Minimum CB setup

Download the appropriate Community Builder package and save somewhere convenient, Then use Joomla! Extensions - Manage - Install the search for the component and drag onto the install panel.
After install completes, Communutiy Builder will show a button start to config button or similar so click on the button.

Configuration

Clicking on the Configuration icon opens a page with multiple tabs. For this basic setup to checkout the jDplugin there are a few items that are useful to adjust.

Under the General tab suggest that the Name Style is set to 'First and Last Name Field', that the Name Format is set to 'Username Only'. It might also be useful to set the Date format appropriately.  At the bottom of the form it is suggested that the Login Method is set to 'Username'.

For the Registration tab it is recommended that Allow User Registration is set to 'Yes, Independent of CMS "allow registration" ', so that it is independent of Joomla! settings.

Under the User Profile tab set the Profile View Access Level to 'Registered' or as appropriate for your your site.

The other tabs are useful in practical use but are beyond the scope of this document. Basically the default settings are sufficient for initial use.

When done use the button save button and the on the button cancel  button to which will take you to the main Control Panel.

User Management

Select the Control panel again and Click on the User Management icon shows all the users that are already 'registered' with Joomla. Check and modify as appropriate so that the users are 'Enabled', 'Confirmed' and 'Approved'.

Menu Item

The last step is to create a CB menu item, specifically a CB User Profile.

Follow the usual procedure for creating a menu item in your Main menu - use the Main Menu not the Community Builder one!

Next Click on the cb plugin 21

cb plugin 20
Select 'User Profile (mandatory!) from the list.  As indicated having a User Profile menu item is a mandatory requirement for CB.

Ensure that the menu item is set with Public access and is Published. Then Save & Close as usual.

Installing jD Plugin

Obviously the first step is to get the jDownloads CB plugin. This is in the Special Extensions category of the jDownloads site, under Downloads.
For CB 2.7.1 series and above in the CB 2.7 series use ext_jdownloads_cb_plugin_ v2.0.12
For CB 2.6.4 and above in the 2.6 series use ext_jdownloads_cb_plugin_ v2.0.11
For CB 2.6.3 and lower use ext_jdownloads_cb_plugin_ v2.0.10A

Also if you are updating your Community Builder from CB 2.6.3 or lower to CB 2.6.4 or higher you will need to remove the existing jD plugin, this is described in section below Upgrading from 3.2 to 3.9.

Download the relevant version and save in a suitable location on your PC.

Note that this extension, which is called 'Community Builder Plugin for jDownloads', has to be installed using the Community Builder Plugin manager as described below.
So in the backend goto Components - Community Builder - Plugin Management.

This brings up the relevant page.

Click on the green 'Install CB Plugin' button.
cb plugin 01A


Step 1: Go to the Upload package tab,

Step 2: Browse for the jDownloads CB plugin on your PC

Step 3: Click on the Upload & install button.
cb plugin 02A
This will bring up the Success message such as shown opposite.

Click on the button close button at the top left which will return you to the main CB Plugin Management page.

cb plugin 03
Now scroll down and you should find the CB jDownloads plugin. Note that it is NOT published!cb plugin 04
So Publish by clicking on the red cross cb plugin 09 which will then turn to a green tick cb plugin 09A.cb plugin 12png

Illustration of jD Plugin within Community Builder

First we will illustrate using Community Builder with jDownloads.
Please note that you should address any operational aspect of Community Builder to its authors
as we have limited experience of actually using Community Builder in practice!

After installing Community Builder on a standard Joomla! release, you will see modules CB Login and CB Online in side panel position 7. Do NOT access these until you have created the mandatory menu item 'CB User Profile'.
The typical result of logging on to Community Builder and then looking at your profile could be like that opposite.

Of course after some use the number of Articles, Blogs and so on would rise.

cb plugin 08
After installing the jDownloads Community Builder plugin as described below then the view changes to show a Downloads link with an integer value indicating how many Downloads are available to you. cb plugin downloads Only those Downloads created by the CB Logged On user are shown at this stage. These are the same Downloads that would be shown by the jD menu item 'List My Downloads'.

cb plugin 06A

If you click on the Downloads tab it will list your Downloads, that is those Downloads which have you logon in the Created By option of the Download.

Clicking on the Download title will take you to the Download Details view for that Download.

Similarly if you click on the Category it will take you to the Category view.

This lists all of the Sub Categories and Downloads that you are able to view, not just those created by the logged on user.
cb plugin 08B


But suppose you have created no Downloads and click on the Downloads tab,
then you would get the 'You have no Downloads' message as shown opposite.
cb plugin 05

Upgrading from earlier CB jDownloads 3.2 to 3.9 and above

This basicly requires deleting the existing 3.2 jDownloads Plugin and then installing the relevant 3.9 version. So go to the CB Plugin Management Page and scroll down to find CBjDownloads.

Step 1: Click on the Unpublish button in the tool bar;
Step2: Click on the Delete button in the tool bar.

cb plugin 10
Now go to the installing jD Plugin section to add the relevant jDownloads 3.9 version of the plugin.
ColinM September, 2019 Modified January 2021, April 2022

Tags: index

Print Email