IMPORTANT: Joomla Community Builder 1.0.1 stable ("CB") is for: - Joomla! 1.0.x (including 1.0.10) and Joomla! 1.5. - Mambo 4.5.0, 4.5.1, 4.5.2.0-4.5.2.3, 4.5.3h, 4.6 (no guarantee!) IMPORTANT - If you are upgrading from 1.0 RC 2 or 1.0 stable, You should have all Community Builder plugin installers that you installed before at hand, or use the expert installation procedure below. DO NOT uninstall from RC2 plugins that you want to keep after upgrade. DIRECTORY/FILE OWNERSHIP/PERMISSIONS (common joomla/mambo problem): If you have uploaded Community Builder by ftp to the web server without changing directory permissions or ownership, you should ask your hoster to do so first, otherwise mambo/joomla will not be able to delete old files on uninstall in step 3 below. Alternatively, or if you are expert, look at alternative 4-steps upgrade instructions at end, otherwise read on. IMPORTANT - If you are upgrading from a version of Community Builder prior to 1.0 Beta 3 you will want to back up your users images directory. They will be deleted when you uninstall Community Builder. 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. 1) If upgrading from a version BEFORE very old CB 1.0 beta 3, backup the components/com_comprofiler/avatars directory. This first step is NOT needed for upgrade from CB beta 4, RC1 and RC2. 2) 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. 3) Install comprofiler.zip as a component. NOTE: You will have to uninstall the previous Community Builder version first. 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. 4) Install mod_cblogin.zip as a module. IMPORTANT if you use the core mambo login module the users will become out of sync with community builder. NOTE: Go to 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 and install mod_cblogin. 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 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). 8) 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). 10) Go to Mambo Admin->Components->Community Builder->Tools And use the "Synchronize users" tool to synchronize CB with Joomla. or Mambo. 11) Go to 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 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. 13) 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 http://www.joomlapolis.com 14) Install additional plugins that you had before upgrading or check out additional plugins available at http://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. 15) Done ! There is a free installation guide available for download as well as a full doucmentation available for contributors at http://www.joomlapolis.com . Please check latest information there. =================================================================== This section is for expert users only, for alternative upgrade: WARNING: no support provided for these alternate methods ! ------------------------------------------------------------------- Update from CB 1.0 STABLE to 1.0.1 *ONLY*: a) backup files and SQL database, including ue_config.php b) unzip the packages and overwrite corresponding CB 1.0 STABLE files in: - administrator/components/com_comprofiler - components/com_comprofiler - modules c) restore backed-up ue_config.php ------------------------------------------------------------------- Update from CB 1.0 RC2 to 1.0.1 *ONLY*: a) backup files and SQL database, including ue_config.php b) unzip the packages and overwrite corresponding CB 1.0 RC2 files c) restore backed-up ue_config.php and check AND SAVE CB configuration from backend. d) do following SQL queries in your SQL admin (no need to do them with normal update): ALTER TABLE `jos_comprofiler_fields` CHANGE `default` `default` MEDIUMTEXT DEFAULT NULL; ALTER TABLE `jos_comprofiler_fields` CHANGE `tabid` `tabid` int(11) DEFAULT NULL; UPDATE `jos_users` SET usertype='Registered' WHERE usertype=''; =================================================================== 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 Installation Guide Document, under "Downloads". (need to register for additional downloads and forum posting). FOR BUG REPORTS AND FEATURE REQUESTS VISIT: http://forge.joomla.org/sf/sfmain/do/viewProject/projects.cb and click Tracker (need also to register to log bugs).