|
+-------------------------------------------------------------------------+
|
|
| |
|
|
| New Installation Readme file for the Community Builder Suite, CB 1.2.2 |
|
|
| This file contains instructions that should be followed for new |
|
|
| (first-time) CB installations. |
|
|
| |
|
|
| Copyright 2004-2010 Beat, MamboJoe/JoomlaJoe and CB team on |
|
|
| joomlapolis.com. |
|
|
| This component is released under the GNU/GPL version 2 License and |
|
|
| parts under Community Builder Free License. |
|
|
| All copyright statements must be kept and derivate work must |
|
|
| prominently acknowledge original work on web interface and on website |
|
|
| where downloaded. |
|
|
| |
|
|
| Joomla/Mambo Community Builder 1.2.2 Stable |
|
|
| native for Joomla! 1.0.0 - 1.0.15, 1.5.3 - 1.5.15 and |
|
|
| Mambo 4.5.0 - 4.6.5. |
|
|
+-------------------------------------------------------------------------+
|
|
|
|
IMPORTANT - This component does not work with any other registration or
|
|
login modules or hacks. It is recommended that you uninstall all such
|
|
modifications as the effects of using them with this component are
|
|
unknown.
|
|
|
|
IMPORTANT - As for any installation: BACKUP FIRST your database and files.
|
|
|
|
SUMMARY OVERVIEW
|
|
----------------
|
|
1) Install com_comprofiler component
|
|
2) Install mod_cblogin module
|
|
3) Install mod_comprofilerModerator module
|
|
4) Install mod_comprofilerOnline module
|
|
5) Enable CB Login, CB Workflows and CB Online modules
|
|
6) Select Name Style parameter from Community Builder Configuration and Save.
|
|
Run Community Builder Synchronize Users tool.
|
|
7) Disable Joomla/Mambo login modules
|
|
8) Add new Public menu item to Community Builder component
|
|
9) Add new User List menu item
|
|
10) Run Load Sample Data tool (optional)
|
|
11) Adjust Community Builder and Joomla/Mambo CMS settings to allow registrations
|
|
only through Community Builder
|
|
12) Done!
|
|
|
|
You can also download from http://www.joomlapolis.com/ in Downloads/Documentation
|
|
the free "Including a free "Install_Pages_from_CB_1.2_STABLE_v1-2.pdf" Document,
|
|
which includes first configuration steps, or consider supporting CB team by
|
|
ubscribing for full documentation at http://www.joomlapolis.com/
|
|
|
|
|
|
|
|
DETAILED INSTRUCTIONS
|
|
---------------------
|
|
|
|
1) Install com_comprofiler.zip as a component. (see notes below first)
|
|
NOTE: Please be patient. comprofiler.zip is large (1.7 MB) and takes
|
|
time to upload and install (sometimes over 5 minutes on large sites !).
|
|
The installation of CB will be done automatically
|
|
in 2 pages (2 step process), which will load automatically.
|
|
Please wait for the green message saying that installation is finished.
|
|
In case o problems, see troubleshooting section further down in this
|
|
file.
|
|
|
|
NOTE: In Joomla 1.5, starting with CB 1.2 RC, legacy mode is not
|
|
required but doesn't interfer with native components, like CB 1.2.2.
|
|
So legacy plugin (page 2 of Joomla 1.5 system plugins) doesn't have
|
|
to be enabled for this CB 1.2.2 installation and operation, but
|
|
might be required depending on the CB plugins you are using, most
|
|
CB 1.1 plugins will require it.
|
|
|
|
NOTE: PHP Safe mode must be off for component and plugins installation
|
|
in Joomla! 1.0.x and Mambo.
|
|
|
|
NOTE: Mambo 4.6.0 - 4.6.5 don't handle multiple xml files properly, so:
|
|
a) you need to first unzip com_comprofiler.zip, remove the file ending
|
|
with j.xml and re-zip before installing on these Mambo versions.
|
|
b) For each module used below, you need to unzip the package, replace
|
|
the XML file which is inside the "files" folder by the one which is
|
|
outside that folder, and then rezip the "files" folder for Mambo 4.6.
|
|
|
|
IMPORTANT: if install fails, see "In case of failed install section"
|
|
below.
|
|
|
|
2) 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.
|
|
|
|
3) Install mod_comprofilerModerator.zip as a module
|
|
(Optional Module, only needed if using moderator features).
|
|
|
|
4) Install mod_comprofilerOnline.zip as a module
|
|
(Optional Module, displays list of online users).
|
|
|
|
5) 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).
|
|
|
|
6) Go to Joomla/Mambo Admin->Components->Community Builder->Configuration
|
|
and at least choose the user name type (first/lastname mode choice)
|
|
corresponding to how you want to split or not split the existing users'
|
|
name during existing users synchronization of the next installation step.
|
|
Make sure to click "Save" on the configuration page.
|
|
|
|
6b)Go to Joomla/Mambo Admin->Components->Community Builder->Tools
|
|
And use the "Synchronize users" tool to synchronize CB with Joomla.
|
|
or Mambo.
|
|
|
|
7) Disable the Standard Joomla/Mambo Login Module. To do that, go to the
|
|
administration backend then:
|
|
- in Mambo/joomla 1.0 go to modules->site modules then click on the
|
|
green publish checkmark of "Login form" (mod_login) so that it
|
|
becomes a red cross.
|
|
- in Joomla 1.5 go to Extensions->modules then click on the green
|
|
"Enabled" checkmark of "Login form" (mod_login) so that it becomes
|
|
a red cross.
|
|
|
|
8) Add a new user menu item to the "User Menu" for Community Builder:
|
|
(this will be the link to the user's profile page).
|
|
For this, go to "Menus" -> "User Menu", click New, then:
|
|
- in Mambo/joomla 1.0 select "component", "Community Builder
|
|
(comprofiler)", leaving access public for the item,
|
|
give a name and save.
|
|
- in Joomla 1.5 click in internal links "Community Builder",
|
|
then "User Profile",
|
|
leave access public for the item, give a title and alias and save.
|
|
NOTE: This is not a security issue, CB checkes access.
|
|
As you don't want this menu item to appear publically,
|
|
you can put it in the User Menu as explained in this step,
|
|
or another menu with Registered access level at least.
|
|
|
|
9) Add a list menu item:
|
|
(this will be the link to the searchable users-listing).
|
|
For this, go to "Menus" -> "User Menu" (for non-public lists) or
|
|
"Menus" -> "Main Menu" (for public lists), click New, then:
|
|
- in Mambo/Joomla 1.0 select Link-URL / External-URL and point it to
|
|
index.php?option=com_comprofiler&task=usersList
|
|
(no 'http://domain' name) and save.
|
|
- in Joomla 1.5 click internal links "Community Builder",
|
|
then "Users-list", leave parameters as is, and save
|
|
NOTE: if you want the list to be accessible publically, make this
|
|
menu entry public (and make also public the one under point 8)
|
|
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 "Load Sample Data" tool to pre-populate fields with
|
|
standard user contact fields (address, phone, etc), and also create a
|
|
default users list.
|
|
NOTE: To edit this default users list/add other users lists: Go to
|
|
Joomla/Mambo Admin->Components->Community Builder->List management
|
|
and change/add list(s) with the corresponding access level.
|
|
Make sure they are published.
|
|
|
|
11) 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".
|
|
|
|
12) Done !
|
|
Since CB 1.2, re-optimized connection paths allow to turn them on
|
|
in CB config now.
|
|
|
|
You can also download from http://www.joomlapolis.com/ in Downloads/Documentation
|
|
the free "Including a free "Install_Pages_from_CB_1.2_STABLE_v1-2.pdf" Document,
|
|
which includes first configuration steps, or consider supporting CB team by
|
|
ubscribing for full documentation at http://www.joomlapolis.com/
|
|
|
|
=====================================================================
|
|
TROUBLESHOOTING section
|
|
|
|
IN CASE OF FAILED COMPONENT INSTALL:
|
|
- Blank screen: check error logs of your webserver, or enable PHP errors
|
|
display.
|
|
Or try both fixes below blindly.
|
|
|
|
- Maximum Execution time reached:
|
|
On very slow servers, IF installation timeouts (not seen yet): you
|
|
can fix that as follows: Open file:
|
|
- joomla 1.0/mambo: administrator/index2.php
|
|
- joomla 1.5: administrator/index.php
|
|
and add line
|
|
set_time_limit( 240 );
|
|
right after the <? line, remove directories components/com_comprofiler
|
|
and administrator/components/com_comprofiler and re-install.
|
|
|
|
- Memory exhausted error (sometimes Error 500):
|
|
Joomla 1.5 with legacy ON and FTP layer ON on PHP 4.x may give error
|
|
Memory exhausted if memory limit is 8 Megabytes. In that case, simply
|
|
switch legacy plugin to OFF just for the CB 1.2.2 installation, then
|
|
you can switch it back to ON if needed. Or add line (similarly as above):
|
|
ini_set( 'memory_limit', '16M' ); @ini_set( 'memory_limit', '32M' );
|
|
|
|
- If component installation step 2 failed: Do not panic ! :
|
|
|
|
Just access CB component from backend, it's safe.
|
|
|
|
In all backend tasks there is a test if step 1 has been completed or not.
|
|
|
|
- If you don't see any warnings at top of screen then installation
|
|
completed successfully.
|
|
|
|
- if you see a warning like:
|
|
|
|
"Warning: file 'components/com_comprofiler/pluginsfiles.tgz' still
|
|
exists.
|
|
This is probably due to the fact that first installation step did not
|
|
complete, or second installation step did not take place. If you are
|
|
sure that first step has been performed, you need to execute second
|
|
installation step before using CB. You can do this now by clicking here:
|
|
(link: please click here to continue next and last installation step)."
|
|
|
|
Then you can just click on the link to complete the second step.
|
|
This step simply uncompresses that 'pluginsfiles.tgz' file into the
|
|
same place and then deletes the file. The second step can be safely
|
|
redone.
|
|
|
|
In case it still doesn't work, it's probably a permissions problem
|
|
either on the folder 'components/com_comprofiler', not allowing the
|
|
webserver to write into (or in case of joomla 1.5 ftp installer active,
|
|
the credentials not being correct).
|
|
|
|
You can fix that by fixing the permissions of that folder,
|
|
and retry step 2.
|
|
|
|
At last resort you can uncompress pluginsfiles.tgz, and rename the
|
|
resulting directory 'pluginsfiles' to 'plugin' at the same place.
|
|
You need to make sure that the plugin and all directories inside
|
|
plugin (user, templates, language) are also writable, otherwise you
|
|
won't be able to install CB plugins at a later stage.
|
|
|
|
|
|
UNINSTALLING CB
|
|
|
|
To uninstall CB, simply uninstall CB Component and CB modules from your CMS.
|
|
User data will be preserved in MySQL tables starting with jos_comprofiler.
|
|
Main CB Configuration is deleted on uninstall of CB component as it is
|
|
stored in file administrator/components/com_comprofiler/ue_config.php .
|
|
CB module configurations are deleted on module uninstall, per CMS methods.
|
|
CB plugins, tabs and field configurations, as well as user data is preserved
|
|
for reinstallation (see README-UPGRADE.txt for details upgrading/reinstalling).
|
|
To remove all database records, delete tables starting with jos_comprofiler
|
|
in a MySQL tool like PhpMyAdmin.
|
|
|
|
-----------------------------------------------------------------------
|
|
|
|
KNOWN PROBLEMS:
|
|
|
|
- none, check www.joomlapolis.com forum "Identified Issues" for latest.
|
|
|
|
NOTE: Community Builder includes a version checker that accesses
|
|
joomlapolis website to query for the latest version of CB and, if
|
|
available, latest information displayed together with the latest
|
|
version number in backend. This query doesn't disclose any private
|
|
information. Only information needed for this standard http query
|
|
are version number and referrer (site address). If you don't have
|
|
Internet access, after a timeout of 20 to 90 seconds an error message
|
|
will be displayed instead of latest version when showing your config
|
|
or "about CB" from the backend. You can switch this check to "manual"
|
|
in CB configuration: "integration" tab (Not recommended).
|
|
|
|
FOR DOCUMENTATION, SUPPORT AND LATEST NEWS VISIT:
|
|
http://www.joomlapolis.com
|
|
Including a free "Install_Pages_from_CB_1.2_STABLE_v1-2.pdf" Document,
|
|
under "Downloads"/"Documents".
|
|
(need to register for additional downloads and forum posting).
|
|
|
|
FOR BUG REPORTS AND FEATURE REQUESTS VISIT:
|
|
http://www.joomlapolis.com/
|
|
|
|
LICENCE:
|
|
Community Builder is licenced under GNU/GPL version 2 as a whole,
|
|
provided that some parts used are subject to other licences for which
|
|
CB Team has rights of use for Community Builder.
|
|
|
|
TRADEMARK:
|
|
Community Builder is a trademark of the authors of Community Builder
|
|
at www.joomlapolis.com .
|
|
You are welcome to use the "Community Builder" trademark to refer to
|
|
this software or manuals provided that you make clear that you are
|
|
not the Community Builder project, that you do not represent it,
|
|
and do not incorpore the trademark or logo into your own trademarks.
|
|
If you have any questions regarding the use of our trademarks, please
|
|
contact us using the contact form of www.joomlapolis.com .
|
|
|
|
|