Joomla / Mambo Community Builder Version 1.9.1 Detailed Guide Software Version 1.9.1 Document Version 1.9.1 version 1 [020] Revision date 06.November.2013 Author Nick A. [email protected] Copyright No portion of this document may be reproduced or re- distributed without the consent of the author. Community Builder 1.9.1 Project Team The Community Builder project is an Open Source project supported by the following CB Core Team members: Community Builder Core Team Membership Name Username Role JoomlaJoe Joomlajoe Lead Developer, Founder Beat B. Beat Lead Developer Nick A. Nant Documentation, Public Relations, JP co-admin Kyle L. Krileon Forums, Developer • The official home of the Community Builder project is located at www.joomlapolis.com Document Distribution The CB Team has decided to offer this documentation on a subscription basis. The reason is to gather some expense money to be used against hosting costs, development tools, libraries, third party service, etc. Page 2 of 170 Community Builder 1.9.1 Table of Contents 1 Introduction .......................................................................................................... 10 1.1 What’s it all about .......................................................................................... 10 1.2 Document Outline .......................................................................................... 12 1.3 Acknowledgements, Credits and Copyrights ................................................. 13 1.4 CMS Compatibility Prerequisites ................................................................... 13 1.5 Known Issues ................................................................................................ 14 1.6 Current CB Version Note ............................................................................... 14 1.7 Current Document Version Note ................................................................... 15 2 Installation ............................................................................................................ 15 2.1 Distribution .................................................................................................... 15 2.2 CB Component .............................................................................................. 18 2.3 CB Login Module ........................................................................................... 22 2.4 Moderation Module ........................................................................................ 24 2.5 CB Online Module ......................................................................................... 25 2.6 Adding the CB Profile .................................................................................... 25 2.7 Adding a CB Login Menu Item ...................................................................... 28 2.8 Adding a CB Logout Action Menu Item ......................................................... 28 2.9 CB User List Menu Item ................................................................................ 28 2.10 Activating the CB Login Module .................................................................. 29 2.11 Activating the CB Moderation (Workflows) Module ..................................... 30 2.12 Upgrading in a Joomla 1.5.x/2.5.x/3.x Environment .................................... 31 2.13 Expert Upgrade Overview for Non-Joomla 1.5.x/2.5.x/3.x Environments ... 31 3 CB Component Configuration .............................................................................. 34 3.1 General Tab .................................................................................................. 34 3.2 Registration Tab ............................................................................................ 41 3.2.1 Workflow Require Confirmation and Approval ........................................ 50 3.2.2 Workflow Require Confirmation (only) .................................................... 53 3.2.3 Workflow Require Admin Approval (only) ............................................... 55 3.2.4 Workflow No Requirements .................................................................... 56 3.3 User Lists Tab ............................................................................................... 57 3.4 User Profile Tab ............................................................................................ 57 3.4.1 Tab Templates and CSS ........................................................................ 63 Page 3 of 170 Community Builder 1.9.1 3.5 Images Tab .................................................................................................... 63 3.6 Moderation Tab .............................................................................................. 66 3.7 Connections Tab ............................................................................................ 69 3.8 Integration Tab ............................................................................................... 71 4 Defining Tabs ....................................................................................................... 73 4.1 Predefined Plugin Tabs ................................................................................. 77 4.1.1 Contact Info Tab Application ................................................................... 87 4.1.2 Article Tab Application ............................................................................ 87 4.1.3 Forum Tab Application ............................................................................ 88 4.1.4 Blog Tab Application ............................................................................... 89 4.1.5 Connections Tab Application .................................................................. 90 4.1.6 Newsletter Tab Application ..................................................................... 92 4.2 Positioning Tabs ............................................................................................ 93 5 Reordering Tabs ................................................................................................... 95 6 Defining Fields ...................................................................................................... 96 6.1 Predefined CB Fields ................................................................................... 106 6.2 Sample of CB Defined Fields in CB Defined Tab ........................................ 109 7 Defining User Lists ............................................................................................. 118 7.1 Dynamic User Lists ...................................................................................... 128 8 Plugin Management ........................................................................................... 129 8.1 Template Plugins ......................................................................................... 131 8.2 Language Plugins ........................................................................................ 132 8.3 User Plugins ................................................................................................ 133 9 Tools Manager .................................................................................................... 135 10 Joomla 2.5 ACL and Community Builder ......................................................... 136 11 Backend and Semi-backend Operations .......................................................... 139 11.1 Using the User Manager Backend Panel ................................................... 140 11.2 Accessing the CB Moderator (CB Workflow) Module ................................ 144 11.3 CB Moderator Handling of User Reports ................................................... 146 11.4 CB Moderator Handling of Unban User Profile Requests .......................... 150 11.5 CB Moderator Handling of Image Approval Requests ............................... 151 11.6 CB Moderator User Registration Handling ................................................ 153 11.7 Using the Tools Screen ............................................................................. 154 11.8 Uploading Gallery Images ......................................................................... 154 11.9 Front-end Operations ................................................................................. 154 Page 4 of 170 Community Builder 1.9.1 11.10 Selecting or Uploading an Image for User Profile ................................... 155 12 Configuring CB Login Module .......................................................................... 158 13 Language file changes ..................................................................................... 167 13.1 Official CB Languages Forge Area ............................................................ 168 14 Your Advanced/Professional/Developer Membership ..................................... 169 15 Support ............................................................................................................ 170 16 Conclusions ..................................................................................................... 170 Page 5 of 170 Community Builder 1.9.1 Table of Figures Figure 1: CB Component Installation Messages for first step (J 1.5.x) ...................... 20 Figure 2: CB Component Installation Messages for second step (J 1.6.x) ................ 20 Figure 3: CB Component Backend Menu Tree (J 1.0.x) ............................................ 21 Figure 4: CB Component Backend Menu Tree (J 1.5.x) ...........................................