0) If upgrading from a version BEFORE very old CB 1.0 beta 3, backup the
components/com_comprofiler/avatars directory.
They will be deleted when you uninstall Community Builder.
This first step is NOT needed for upgrade from CB beta 4, RC1, RC2,
1.0 or later
1) If upgrading from any previous version you may want to make a copy of
your configuration file:
administrator/components/com_comprofiler/ue_config.php
and of your language file and/or cb template if you modified them.
IMPORTANT As for any installation, specially for 1.0.13 and CB 1.1:
BACKUP FIRST your database and files.
2) If upgrading from any previous version, check in joomla/mambo installer
that the directories are writable first.
Then uninstall Community Builder (comprofiler).
NOTE: Don't uninstall CB plugins (this will keep their parameters).
This WILL NOT DELETE:
- any data in the database
- any parameters for fields, tabs, plugins, user data;
- images from CB beta 4, RC1 and RC2 are not deleted.
But IT WILL DELETE additional CB plugin program files only (not their
parameters). That's why you will need the CB plugin installers.
IMPORTANT: You will need to REINSTALL these CB plugins later at last
step.
WARNING: Some third-party CB plugins come with modules and/or mambots
which do not test for the CB plugin being installed, which can
result in errors or blank screens. If you don't reinstall the
corresponding CB plugin you may need to unpublish or uninstall
the corresponding modules and/or mambots.
3) Install comprofiler.zip as a component.
NOTE: In Joomla 1.5, you need to set legacy mode to ON in the legacy
plugin settings before being able to installand run CB 1.1 on Joomla 1.5.
NOTE: PHP Safe mode must be off for component and plugins installation
in Joomla! 1.0.x and Mambo.
4) Install mod_cblogin.zip as a module.
IMPORTANT if you use the core Joomla or Mambo login module the
users will become out of sync with community builder.
NOTE: Go to Joomla/Mambo Admin->Components->Community Builder->Tools
And use the synchronize users tool to synchronize your user
database if this happens.
NOTE: if upgrading you need to uninstall mod_comprofilerlogin or
mod_cblogin452 or mod_cbloginRC2 or mod_cblogin and install the
new mod_cblogin, as it contains added security needed by CB.
5) Install mod_comprofilerModerator.zip as a module
(Optional Module, only needed if using moderator features).
NOTE: if upgrading you need to uninstall and reinstall
mod_comprofilerModerator.
6) Enable the cblogin login module (CB Login), and other CB modules
from the administration backend (go to modules->site modules then
click on publish red cross or click on module name to set params).
IF UPGRADING PLEASE SKIP TO STEP 12 BELOW.
IF FIRST INSTALL, CONTINUE HERE:
7) Disable the Standard Joomla/Mambo Login Module. To do that, go to the
administration backend (go to modules->site modules then click
on the green publish checkmark of "Login form (mod_login) so that
it becomes a red cross).

Add a new user menu item for the comprofiler component
(this will be the users profile page).
For this, go to menu -> user menu, click New, select component,
then Community Builder (com_comprofiler), give a name and save.
9) Add a new user menu item as a Link-URL and point it to
index.php?option=com_comprofiler&task=usersList
(this will be the searchable users list).
Note: if you make the menu being the first of the main menu it will
become the site's homepage.
10) Go to Joomla/Mambo Admin->Components->Community Builder->Tools
And use the "Synchronize users" tool to synchronize CB with Joomla.
or Mambo.
11) Go to Joomla/Mambo Admin->Components->Community Builder->Tools
And use the "Load Sample Data" tool to pre-populate fields with
standard user contact fields (address, phone, etc).
12) If you want to allow registrations only through Community Builder
(recommended):
- in Admin->Components->Community Builder->Configuration->Registration:
set "Allow User Registration" to "yes, independently of global site setting"
- in Admin->Site->Global Configuration->Site(Joomla 1.0/Mambo) or ->Users (Joomla1.5):
set "Allow User Registration" to "No".
IMPORTANT: Check your registration page: the ordering of tabs is
now better respected for registrations too, so tabs may have moved
to previous versions. Typically, username is not anymore mandatorily
the first field on the registration page. The new ordering is now:
a) registration ordering of tab (new: can be set in "edit tab")
b) position of tab on user profile (top-down, left-right)
c) ordering of tab on position of user profile
d) ordering of field within tab position of user profile.
13) If upgrading from a version prior to 1.0 beta 3 place all the
images that were once in components/com_comprofiler/avatars into
images/comprofiler/ directory.
14) Community Builder is delivered with default language (English)
plugin preinstalled. For additional languages you will need
additional plugins. Language is auto-selected accordingly to site.
These can be downloaded from
www.joomlapolis.com
15) Install additional plugins that you had before upgrading or check
out additional plugins available at
www.joomlapolis.com
NOTE: plugins which have their parameters memorized by CB, but
have missing program files are displayed in plugin list
without clickable title-name, and with a barred plugin name.
These will be displayed normally and usable again once
plugin is installed again. If you don't wish to do so, you
can delete the plugin parameters by selecting delete.
16) Done !
Since CB 1.0.2, optimized connection paths allow to turn them on
in CB config now.
Known problem: a blank screen or error of language file on homepage
after upgrade can be due to cb.invite mambot (just unpublish mamobt or
reinstall the CB invite plugin).