Joomla/Mambo Community Builder Version 1.0 Stable Installation Guide document version 1.0 – 10.May.2006 Copyright – No portions of this manual may be reproduced or redistributed without the written consent of the author! Author : Nick A. ([email protected])
17
Embed
Joomla/Mambo Community Builderjoomlacode.org/gf/download/frsrelease/127/361/CB1.0_STABLE-INST.pdf · This document describes the basic functionality and key features of the Joomla/Mambo
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Joomla/Mambo
Community Builder Version 1.0 Stable
Installation Guide
document version 1.0 – 10.May.2006
Copyright – No portions of this manual may be reproduced or redistributed
Community Builder 1.0 Stable Installation Guide - Table of Contents
Page 2 of 17
Table of Contents
1 Introduction...................................................................................................................4 1.1 What’s it all about ..................................................................................................4
The CB component (as any Joomla/Mambo component) is installed in one of the following
two ways:
First you must unzip the CB suite package in order to produce the four files (five with the
README.txt file) described in chapter 2.1 and then complete one of the following steps:
• Via the Administration panel using the Components Install/Uninstall selection
followed by the specification of the location of the comprofiler.zip file on your local
hard-drive via the Browse… button and then clicking on the Upload File & Install
button
• If you want (for whatever reason) you may manually unzip the comprofiler.zip file
and upload via FTP the resulting comprofiler folder (along with all its contents and
structure) to your website folder:
{websitestructure}\administrator\components\com_installer\component and then make sure that the Install directory: field contains {websitestructure}\administrator\components\com_installer\component\comprofiler
before you click on the Install button.
If all complete properly you should see a screen similar to the one outlined in the following
figure.
Community Builder 1.0 Stable – Installation Guide
Page 9 of 17
Figure 1: CB Component Installation Messages
After pressing the [Continue …] link you will see the Community Builder as an active
component in the Installed Components area of your Joomla/Mambo Administration Panel.
You will also be able to see a new item entitled Community Builder in the Components
drop down menu of the Administrator panel of your Mambo driven website. This
Community Builder menu item has seven sub-menu items:
• User Management
• Tab Management
• Field Management
Community Builder 1.0 Stable – Installation Guide
Page 10 of 17
• List Management
• Plugin Management
• Tools
• Configuration
This is also illustrated in the following figure.
Figure 2: CB Component Backend Menu Tree
Hopefully, your chosen installation method will complete properly. If not please refer to
chapter 3 entitled Support for additional guidance.
2.3 CB Login Module
The CB login module (which is ultimately going to replace the default Joomla/Mambo
Login module) is installed via the cblogin.zip file using the standard Joomla/Mambo
module installation procedure. Either Package File or manual upload and Install Directory
methods can be used. We will focus on the package file method.
Community Builder 1.0 Stable – Installation Guide
Page 11 of 17
• Via the Administration panel using the Modules Install/Uninstall selection
followed by the specification of the location of the cblogin.zip file on your local
hard-drive using the Browse… button and then by clicking on the Upload File &
Install button.
Hopefully, your chosen installation method will complete properly and you will see
something similar to the following figure.
Figure 3: CB Login Module Installation
If the installation completes properly, you should be able to see the mod_cblogin in the
installed modules area of your Joomla/Mambo Administration panel.
If not please refer to chapter 3 entitled Support for additional guidance.
Please note that at this time the module is inactive (see how to activate in chapter 2.8).
CSS Note: The mod_cblogin module now supports the login class for the styling of the
login module URL links.
Specifically a.mod_login:link, a.mod_login:visited and a.mod_login:hover
included in your active template’s .css file will be applicable in the links of this module
(Forgotten password, create on, logout).
2.4 Moderation Module
The CB moderation module is an optional module (which should definitely be installed if
you want to delegate the administrative registration approval tasks to moderators) that
may be installed via the mod_comprofilermoderator.zip file using the standard
Joomla/Mambo module installation procedure. Either Package File or manual upload and
Community Builder 1.0 Stable – Installation Guide
Page 12 of 17
Install Directory methods can be used. We will focus on the package file method.
• Via the Administration panel using the Modules Install/Uninstall selection
followed by the specification of the location of the mod_comprofilermoderator.zip
file on your local hard-drive by using the Browse… button and then by selecting the
Upload File & Install button
Hopefully, your chosen installation method will complete properly and you will see a
screen similar to the one illustrated in the following figure.
Figure 4: CB Moderator Module Installation
If the installation completes properly, you should be able to see the
mod_comprofilermoderator in the installed modules area of your Joomla/Mambo
Administration panel. If not please refer to chapter 3 entitled Support for additional
guidance.
Please note that at this time the module is inactive (see how to activate it in chapter 2.9).
2.5 CB Online Module
The CB Online module is an optional module that may be installed via the
mod_comprofileronline.zip file using the standard Joomla/Mambo module installation
procedure. Either Package File or manual upload and Install Directory methods can be
used.
Community Builder 1.0 Stable – Installation Guide
Page 13 of 17
2.6 CB User List Link
Add a new User Menu item named CB User List as a URL pointing to: index.php?option=com_comprofiler&task=usersList
This will eventually support the searchable user list functionality which is configured via the
List Management backend menu item. The actual menu item backend setup screen should
look something like the following figure.
Figure 5: Menu Item for CB Lists
The CB LISTS menu item can be set to Public access level (to support public access to
CB Lists that have been so configured) or to Registered access level.
2.7 Adding the CB Profile
The CB component has been successfully installed as described in chapter 2.2. We must
add the CB Profile item in the User Menu (for registered Users) and deactivate the
original Joomla/Mambo User Details item from the same User Menu.
To add the CB Profile item to the User Menu we must take the following steps:
Community Builder 1.0 Stable – Installation Guide
Page 14 of 17
• Select Menu User Menu from your Joomla/Mambo website administration panel
• Select the New Item button and you will see the Details TAB of the Add Menu Item :: Component panel
• Choose Component from the Select a Component to Add: item list then press
the Next button
• Select the Community Builder item from the Component: list
• Populate the Name: field with CB Details
• Select Top from the drop down list of the Parent Item: field
• Select Registered from the drop down list of the Access: field
• Select the Yes radio button for the value of the Published: field
• Click on the Save icon
Completing the above steps will result in the appearance of a new menu item named CB Details under the User menu of your Joomla/Mambo driven website. The new item is
placed by default in the last position of the User menu but you may change its position by
clicking on the up arrow in the reorder column in the Menu User Menu admin panel.
2.8 Activating the CB Login Module
Now that we have successfully installed the components of the CB suite we can continue
with the basic configuration by activating the CB Login module and deactivating the
Joomla/Mambo Login module and the Mambo Logout module. This is accomplished by
accessing the Site Module Manager from the Joomla/Mambo Administration panel and
selecting the Modules Site Modules menu item. Make sure to verify that the CB Login
module set for Public Access viewing. You may of course use the arrow buttons to
reorder the positioning of this new module. To deactivate the mod_login module (this is
the default login module provided with Mambo) find it in the installed modules and
Unpublish it.
Once successfully activated the CB Login module should appear on your website
homepage as illustrated in the following figure.
Community Builder 1.0 Stable – Installation Guide
Page 15 of 17
Figure 6: CB Login Module
Note: Once CB is in operation the default Joomla/Mambo Site User Manager menu items
from the administration panel should no longer be used (or at least it should be used with
extreme caution since it may desynchronize the original CMS user table with the CB user
table). Using this will cause problems.
2.9 Activating the CB Workflows Module
If we have chosen to take advantage of the moderation features of the CB suite or if you
just want to show connection workflow pending activities for users we must activate the
mod_comprofilermoderator module. Publish the mod_comprofilermoderator module
(default title CB Workflows) by accessing the Modules Site Modules and clicking on the
Publish icon having first selected (via the check box) the specific module line. The CB
Workflows Module contains notification links supporting the connections feature as well as
links to support the handling (moderation) of various items that need manual approval by
authorized moderators (e.g., image uploads, new members, reports, etc). Make sure to
verify that the CB Workflows module set for Registered Access viewing.
Once we have successfully performed the activities outlined above a logged in user will be
able to see the CB Workflows module as illustrated in the following figure.
Figure 7: CB Workflows Module
Community Builder 1.0 Stable – Installation Guide
Page 16 of 17
3 Support
If your CB experience is unsuccessful in any way or you feel that something is wrong and
should be fixed or you want to express the need for a new feature or enhancement or just
want to express your gratitude for this suite please take the time and visit us at the
www.joomlapolis.com website. A forum is maintained and monitored by the development
team and many expert CB users are always lending a hand. This website also contains
additional modules and plugins that have been developed by other CB users throughout
the world. In any case, requesting a helping hand is a good idea and the CB users
worldwide are a very nice bunch always willing to assist.
4 Detailed Documentation
The CB Team has also created a more detailed document entitled “Community Builder 1.0
– Reference Guide”. This document provides additional information regarding the
parameterization and usage of the Community Builder suite. This additional document is
provided on a paid subscription basis (donations are used towards development
expenses, hosting hosts, development tools, etc). The detailed documentation contains
over 120+ pages of Community Builder specifics. Information about this service is
available at http://www.joomlapolis.com/content/view/140/37/ .