Home

CB User Manual

1. ssssss 162 Figure 90 CB Moderator Module Pending Approval Processing J 1 0 X 162 Figure 91 Rejection Email Message Sent to User J 1 0 X sus 163 Figure 92 Initial User Profile Page J 1 5 X occ cccccscsesessesescsesecseseseeseseseseeeesees 165 Figure 93 Selecting of Uploading Image J 1 0 X sss 166 Figure 94 Image Pending Approval User Page J 1 5 X sssssssss 167 Figure 95 CB Login Details J 3 5 X agadonsatu tta iic etr Ee poe dta 169 Figure 96 CB Login Module Parameters J 1 5 X sssssssssee 170 Figure 97 CB Login module front end view J 1 0 X sse 179 Page 9 of 181 Community Builder 1 2 1 Introduction This document describes the basic functionality and key features of the Joomla Mambo Community Builder suite Throughout this document the use of CB will be used to denote the Community Builder 1 1 What s it all about The Community Builder suite is the most popular Joomla Mambo extension The suite contains a single component which along with three additional modules integrates with the Joomla Mambo CMS extending its functionality This extended functionality replaces and augments existing features of the default Joomla Mambo installation in order to facilitate the creation and management of an online community on a Joomla Mambo driven website The default Joomla Mambo CMS user registration system does not provide
2. sss 57 3 2 4 Workflow No Requirements eere 58 53 UserLisis Tabusucuesnt dedu ani oque D M ME UR MM D 59 Bur UTO IET D ee ne ee Eee ene ee Ribes Der ud 60 341 Tab Templates and CSS essais meta men GEN o E PH 65 9 9 ENG SS VJabecuicebitunmdiede adir mOsbedet vase edipi bite duet dia 66 3 5 Moderaron VOD escaso dated eee bad itecto tu nieder oed 69 S COMME CTIONS VOD assessed eise aad dasererat oed 72 20 Ihteokdbloh OO cnni aont E E E E t cde tee ram 75 Be Debo TADE ocu RUE UEM NE MM E sete 76 Ad Predefined Plugin TaD Seasin enm p a MEUM eO E 81 Ait Contact Info Tab ADpDpIICQTO usi pO NIS Epi iem ois 93 4L2 Article Tab ADDIICOTlOF setis oio reco E Praet iom A N 93 ALS For m TaD AD DICOTION it cette cm tte o eed tedio iens 94 AAA Blog VAD ADDI CGM OM oa teer edente he tome babeo 95 415 Connections Tab Application sss 96 41 6 Newsletter Tab Application essere 98 Ac WOSIMONING TODSusnuieadnnecasedtamemddntaemst E tcs anrea 99 D 3SeopdePihg TIOS esten outs EMI EILEEN dA IE 102 O De nro eldest be met meat ue EM 103 6l Predef med CB Fields ccce ee a RUNS aes 115 6 2 Sample of CB Defined Fields in CB Defined Tab sus 119 Z Defiming User LISTS esrecco rona o t bt onte bit Mae rotten bebat 129 L5 Dynamic USI LISTS inet vette edat etsa ma NN 139 5 Plugin Malage melios unc U EN EE RUM EE M EE MM IE 140 Bl emblabte d id9glscssniue tad Eau N
3. 94 Figure 37 Blog pl gsin OD usce ERREUR EDU UNI tances 95 Fig re 36 Connections WOPKTIOW ous retenti tones e tbi alt os aio 96 Figure 39 Connections personalized invitation sese 97 Figure 40 Connections plug in Tab s eessssssseeseseeeeneeeenrentenntntnnnes 97 Figure 41 Manage Actions and Manage Connections areas 98 Figure 42 Newsletter Tab Application essere 98 Figure 43 User Status tab with PositionzPV1 and Display TypezDVA 100 Figure 44 Portrait tab with PV4 and Status tab with PV2 suus 101 Figure 45 Field specific Parameters essere 114 Figure 46 CB Predefined fields J 1 5 X sse 115 Figure 47 Tab and Fields example Personal Info tab 119 Figure 48 Definition and positioning of Personal Info tab J 1 5 X 120 Figure 49 City State text Field Example J 1 5 X ssessssus 121 Figure 50 Gender radio Field Example J 1 5 X sss 122 Figure 51 Languages multiple check box Field Example J 1 5 X 123 Figure 52 Values for Language Field Example J 1 5 X sss 124 Page 7 of 181 Community Builder 1 2 Figure 53 Age group Field Example J 1 5 X e 125 Figure 54 Values for Age Group Field Example J 1 5 X susu 126 Fi
4. Choose whether you want the version to be checked automatically each time you go to Community Builder general configuration highly recommended so you see immediately a message in case of a critical security release or manually when you click on the link not recommended Your installed Community Builder does not disclose any information during this version check except the current installed version and standard http parameters There is no automatic update service Further settings see plugins and tabs parameters More settings are available in menu Components Community Builder Plugin Management and Tab Management Each plugin and each tab can be edited and have its own parameters Plugins and tabs must be published to be active Figure 31 Configuration Manager Integration TAB View J 1 5 X The version checking option is recommended to be set to its default value This way the website administrator will be always immediately informed of new developments and potential security related releases on CB You should only turn this off if your site is on a local test environment without internet access Page 75 of 181 Community Builder 1 2 4 Defining Tabs Once the CB suite has been properly installed the initial default Joomla Mambo user fields username name email address password are organized under the tab heading Contact Info To define a new TAB that will eventually host new fields and appear in the user profile pages
5. Joomla Mambo Community Builder 1 2 RC beta 10 native for Joomla 1 0 0 1 0 15 1 5 3 and Mambo 4 5 0 4 6 4 POWERED BY COMMUNITY BUILDER Copyright 2004 2007 MamboJoe JoomlaJoe Beat 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 Derivate work must prominently duly acknowledge original work and include visible online links Official site v v v joomlapolis com Installation Process Automatic database upgrade to current version applied successfully Click to Show details Core CB database upgrades done If all lines above are in green database upgrade completed successfully Otherwise please report exact errors and queries to forum and try checking database again in components community builder tools check database Second and last installation step of Community Builder Component comprofiler done successfully Installation finished Important Please read README TXT and installation manual for further settings We also have a PDF installation guide as well as a complete documentation available on www joomlapolis com which will help you making the most out of your Coomunity Builder installation while supporting this project Figure 2 CB Component Installation Messages for second step J 1 5 X After installation is completed you will see the Community Builder as an active
6. PV6 Bottom area below main area Grid area a 9x9 logical grid Not displayed on profile 9 items e Display Type e O O DV1 Tabbed pane DV2 Div with title DV3 Raw display without title DV4 Overlay moving with mouse DV5 Fixed overlay closing on mouseout DV6 Button with Sticky overlay Page 99 of 181 Community Builder 1 2 CB administrators should experiment with these parameters to reach a combination that gives the desired appearance and functional effect on the various tabs Some examples are illustrated in the following figures Home diCBPraofile amp nant Community Edit Connections nant Profile Page User Status 1 Online Status ONLIME Member Since 05 06 2006 14 07 05 Last Online 05 08 2006 22 02 51 Last Updated Never Figure 43 User Status tab with Position PV1 and Display Type DV4 Page 100 of 181 Community Builder 1 2 Community Edit Connections nant Profile Page Hits 1 Online Status ONLINE Member Since 050672006 14 07 05 Last Online 05 08 2006 22 02 51 Last Updated Never Figure 44 Portrait tab with PV4 and Status tab with PV2 Page 101 of 181 Community Builder 1 2 5 Reordering Tabs CB Tabs whether defined by plugins or site administrators can be reordered for their appearance in front end profiles or as field groupings during the registration process Profile tab reordering can be accomplished by clicking on the up and down amp
7. this setting is optional You can check the index php file of your template or just turn this on and see if the user profile tabs display In the current release we made progress towards W3C XHTML compliance but only a few pages are fully compliant yet Of course you need to use a compliant Joomla Mambo template as well to be compliant Allow user to edit his CMS parameters in Yes ow Shows user parameters and allows the user to change them in the user s own edit profile page frontend Do not filter following tags on editor area Type in tags that you would like to not be filtered separated by single spaces for example applet body bgsound embed fields WARNING this is at your own risk as users could insert malware code The default filtering avoids this following tags are fitered by default and can be removed from filtering by typing them in applet body bgsound base basefont embed frame frameset head html id iframe ilayer layer link meta name object script style title xml Figure 22 Configuration Manager User Profile TAB View J 1 5 X The fields that may be configured from this TAB along with some basic guidelines regarding available settings are e Field Name Username o Available options via dropdown list Page 60 of 181 Community Builder 1 2 Yes This option will permit users to change usernames No This setting will instruct CB to make the username field read only Y Note You should
8. Please enter the City and or State area you are located in Description field tip text or HTML Contact Image Pagebreak Readmore y Default value Required No Profile Yes on Line User Read No gt No Yes nly Show at Registration Published 1 Size Max Length 3 Figure 49 City State text Field Example J 1 5 X age 121 of 181 Community Builder 1 2 Type Radio Buttons Tab Fersonal Info Mame cb gender Title Gender bey Ww Il ni Select you gender Description i field tip text or HTML Contact Image Pagebreak Default value Required No mari Ho oe ves Published Yes Size 1 Cols 2 Rows 1 Use the table belowe to add news values Add a Value Hame Male Female Figure 50 Gender radio Field Example J 1 5 X Styles Paragraph Font family i b Fem 8 GO GRET 2 s Readmore 4 Ey 44 ee Notice the settings Cols 2 and Rows 1 in Figure 5O This causes the gender radio field values to be placed horizontally as illustrated in Figure 47 instead of vertically if the settings Cols 1 and or Rows 2 were used Page 122 of 181 Community Builder 1 2 Type Check Box Multiple z Tab Fersonal Info Mame cb languages Title Spoken Languages Styles v Paragraph Font famiy 3 be fom g t
9. icons in the Tab Management area or by modifying the Profile ordering parameter of a specific tab In addition each Tab that contains registration fields can also be reordered Tabs of course are not displayed during registration however their field contents as a group are ordered in respect to other tab field groupings according to the Registration ordering parameters of these tabs Page 102 of 181 Community Builder 1 2 6 Defining Fields The CB suite supports the definition of new fields that can be grouped together under tabs and presented to authorized users in user profile pages Users are also able to update contents of certain non read only fields Fields may also be characterized as Required at Registration and thus will appear in the registration process When defining new fields in the CB a number of generic non field type related characteristics must be specified These generic characteristic settings are Tab Specifies via a dropdown list which Tab this field will appear under E g Additional Info tab Name The name of the field No spaces or special characters are allowed in this field and if used they will be automatically removed Also by default all field names have the string cb_ as a prefix E g cb_birthadate cb education cb_maidenname cb Telephone cb userlevel etc Title The title of the field which is used as a label E g Birth Date Education Maiden Name Telephone
10. 14 CMS COmDGlDIIU DE ussscHen iden Un NU dNMR UM R DE ELE E 15 LO RING WIN SS SS meron E 15 LO Current CB Version NOTE xi cuustei aou DE e d EV cU Lu ete 15 1 7 Current Document Version Note cccccccccsscsscsscsecsscsscsscescssessecsscseesecseeseens 16 Z xEInSralatiOlosaenemteste eatem uon dust ut Ua tatus eee ne ere eee eo quet 16 El CDISIEIDITION ui deco ok ee teh uu tiu uei Eu 17 Gs CR COMDONEN Torsen etn oslo drole te dece mde 19 23 CBNoonMOOUIG amag duda decens Egienda tet ditata ies 23 4 Moderation MOGUI 6 oie Dt ct edet es 24 25 CB On ne Mod le sc ast a ice eee cate han M diei eun 26 205 WadingTRhe CB PROG 6 ecd toU ET OE dte E nM 26 2 Adding a CB Login Menu Item eese 28 2 8 Adding a CB Logout Action Menu Item eese 28 29 COLUSEr List MENU ETOlm usu oro siitiio date O dec iae ied 29 2 10 Activating the CB Login Module senes 30 2 11 Activating the CB Workflows Module sse 31 212 Expert Upgrade Overview sss 32 3 COGIC Tonos cedet eU IE EMI MENU MM AM EU RUD NM pi 35 S1 General TaDiustienudeum UMEN MHUMEIIENMUME 35 32 Registhatloh TaD eene aE eoa eia ici AEG 43 3 21 Workflow Require Confirmation and Approval 52 Page 3 of 181 Community Builder 1 2 8 22 Workflow Require Confirmation only DB 3 2 43 Workflow Require Admin Approval only
11. Contact Info Hame Nicholas G Antimisiaris Username nant Figure 94 Image Pending Approval User Page J 1 5 X Notice the Pending Approval picture that is displayed and the comment on the top part of the figure indicating that approval is pending A user may also remove an image at any time by selecting the Remove Image URL link from this page If approval is not required this page will have the uploaded image in place of the Pending Approval picture The user may also select one of the predefined images that have been uploaded by the administrator see chapter 10 8 by selecting one of the radio buttons next to each one of the images that appear in Figure 93 and clicking on the Confirm Choice button Moe As of CB 1 1 special user groups CB Moderators can modify user profiles of other users from the front end This option is configured by the Allow Moderators to Edit User Profiles parameter located in the CB Configuration Moderation tab see chapter 69 Page 167 of 181 Community Builder 1 2 11 Configuring CB Login Module After you have installed the CB Login module and disabled the Joomla Mambo login module see chapter 2 3 you should take some time to properly configure your CB Login instance The CB Login parameters can be reached by visiting the Modules gt Site Modules backend of your Joomla Mambo site and then selecting the CB Login URL in the Module Name column This should produce a view similar with
12. Email address username and password to appear and finally place CONFIRM were you want an email confirmation URL to appear As of RCZ the CB admin can add CB fields to further personalize this email message These CB fields must be placed in brackets e g cb nickname The following is an example of a Welcome Email message that could be sent Welcome NAME Your application has been approved by our administration team Your account with the following details DETAILS has been activated We welcome you to our online community and trust that together we will grow Enjoy the experience Kind Regards Website Administration Team Wrote Leave blank to suppress welcome message e Setting Name Introduction text for registration o Option set by populating a text area field Page 49 of 181 Community Builder 1 2 This field should be populated with text html content that is to appear just before the first registration field is displayed in the registration application process This field is also language friendly meaning that a UE type name may be used in order to support multi language sites e Setting Name Concluding text for registration o Option set by populating a text area field This field should be populated with text html content that is to appear at the end of the registration form just before the Send Registration button This field is also language friendly meaning that a_UE_ type name be used in o
13. Forum and Mamboblog J1 0 only must be downloaded and installed separately Fifteen field types supported checkbox date dropdown Email Address Editor Text Area Text Area Text Field Radio Button Web Address multi select drop down multi select checkbox fields delimiter password integer and image New field types can be added by developing CB plugins Ability to specify whether a field is optional or required publicly viewable or not required during registration or not Ability to specify whether a field is searchable during front end user list displaying if user list configuration permits this Ability to specify which Joomla Mambo User Groups are permitted to view other user profiles Ability to specify which of the Joomla Mambo User Groups are permitted to view specific tabs Page 11 of 181 Community Builder 1 2 Avatar gallery support along with the ability to allow users to upload their own image to be displayed in their profile during registration or later on Image moderation supported Image resizing support via GD1 GD2 Imagemagick NetPBM server installed applications Extensive and flexible fully configurable registration process using a combination of email confirmation functionality Terms of Acceptance verification moderator notification email messages personalized applicant pending approval and welcome email messages Ability to integrate CB defined field data in workflow email messages Regist
14. 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 Joomla Mambo driven website This Community Builder menu item has six sub menu items e User Management chapter 10 1 e Tab Management chapter 4 Page 21 of 181 Community Builder 1 2 e Field Management chapter 6 e List Management chapter 7 e Plugin Management chapter 8 e Tools chapter 9 e Configuration chapter 3 This is also illustrated in the following figures Figure 3 or Figure 4 V Joomlal Administrator By Banners k Community Builder 88 User Management e Contacts HEL Tab Management a Donations HEE Field Management La Joomlaboard Forum List Management x joomlaxplorer 1b Plugin Management e3 Mass Mail Tools d Mews Feeds H Configuration Pols m og du Syndicate SY Web Links Home Site Menu Content Modules Mambots Installers Message Joomilapolis The home of E contro Pa Add Hey Content intent Frontpage Man ger Figure 3 CB Component Backend Menu Tree J 1 0 X Page 22 of 181 Community Builder 1 2 Aus lelolae e MEL Lp Site Menus Content Components Extensions Tools Help ee Banner b m Community Builder User Management m Contacts T Tab Management News Feeds b Field Manageme
15. the Contact Info tab or of any CB fields that have been added to CB Tabs in this screenshot there are two additional CB tabs Personal Info and Additional Info Important administrative tasks that may be performed from this screen include Page 151 of 181 Community Builder 1 2 o Changing the assigned group for this user by selecting one of the lines in the Group field scroll box Valid values are Registered Author Editor Publisher Public Backend Manager Administrator and Super Administrator o Blocking a user barring access by selecting the Yes value in the drop down list of values associated with the Block User field Assigning a Yes value to this field will prevent the user from accessing this account o Approving a user by selecting the Yes value in the drop down list of values associated with the Approve User field Assigning a Yes value to this field will activate the user account and will trigger the sending of the Welcome email message to the user this is also triggered from the CB Moderator module Approving a user may also be accomplished by clicking on the pending icon in the Approved column of figure 32 Clicking on the El or icon of this Approved column basically acts as a toggle and each time a toggle is performed between from amp to v a Welcome email message is sent to the user between the two icons and between the Yes and No values of the Approve User field o Observe all the other values dis
16. user has requested the un banning of his her profile one user report submitted against a profile of another user needs to be addressed an uploaded image needs approval before its viewable in user profiles and one new user application must be processed this means that the Email Confirmation phase if applicable has been completed and the status of the application is pending approval The last workflow request Page 154 of 181 Community Builder 1 2 M ore The items displayed in Figure 78 are controlled by the mod login class mentioned in chapter 2 3 10 3 CB Moderator Handling of User Reports If a moderator clicks on the URL 1 User report s of the page simulated in Figure 78 the Moderator User Reports processing page would appear as shown in the figure that follows Moderator Moderate User Reports Reported Report Reported User Report Date By This user has an offensive photo in his profile and has also been sending me 2006 05 10 tester offensive private messages ES I LoudogiZi Process Figure 79 CB Moderator Module Handling User Reports J 1 0 X The moderator at this point may review the offending profile by clicking on the URL link located in the Reported User column this would be nikos in the screenshot of Figure 79 and take the appropriate actions Once these actions are completed the moderator may revisit this screen and click the Process button to mark this user report as processed so it no longer
17. E g if we define a Fields delimiter type field and place the HTML code lt hr gt in the field s Description I field tip text or HTML parameter we will get a horizontal line displayed Page 113 of 181 Community Builder 1 2 As of CB 1 2 each field automatically can be further characterized by Field Specific parameters as illustrated in the following figure Field specific Parameters Minimum length p Forbidden words at registration http https mailto url Forbidden words in user profile edits eo Figure 45 Field specific Parameters More As of CB 1 2 it is possible to install field type plugins that basically add new field types to CB The CB Team and 3PD will be releasing field type plugins e g Number field type and birthdate field type Page 114 of 181 6 1 Predefined CB Fields Community Builder 1 2 As of CB 1 2 core CMS fields are treated as predefined CB fields and are managed in the CB Fields management area There are eighteen 18 predefined fields that are automatically created in the CB Field Manager backend as illustrated in the following figure H LI LIE cO eLa Ci eaS c ee LI BC c gaa LIC ee LT BENI LT MCI Hame avatar hits onlinestatus regizterDate lastvisitbate lastupdatedate connections forumrank forumposts forumkarma formatname name firstname middlename lastname email username password params Title Profile image Hits Online
18. Everybody Everybody Everybody Position Notice that the Tab Management area gives a consolidated view of key tab related fields Backend viewers can easily see if a tab is published if it s connected to a plugin the tab s display type the tab s position etc Also if the tab is connected to a plugin that is currently not published then the plugin name is displayed in red e g Yanc Newsletters Private Message System and Fireboard Forum in the figure The twelve predefined plug in tabs are e Menu tab This tab is associated with the CB Menu core user plugin o Its parameters also displayed in the following figure are First Menu Name Page 82 of 181 e Default value UE MENU CB Re Order Community Builder 1 2 First Sub Menu Name e Default value UE MENU ABOUT CB Whore if you do not want the About CB menu to appear on your site s user profiles you can just leave this field blank First Sub Menu URL e Default value index php option com_comprofiler amp task teamCredits Second Sub Menu Name e Default value empty Second Sub Menu URL e Default value empty o Its Tab Details settings are Title e Initial value UE MENU Description e Initial value empty Published e Initial value Yes Position e Initial value Header above left middle right Display Type e Initial value Raw display without title Page 83 of 181 Community Builder 1 2 e Connection Paths tab Thi
19. Figure 96 First of all as with any Joomla Mambo module instances you can change the default title of the module instance CB Login to something more friendly e g Member Access You can also specify that you do not want the title of the module displayed at all by selecting the No option in the Yes No radio field titled Show title The position of the module instance is specified by the drop down Position field always with respect to your active template The order can also be configured along with the Access Level For your login module the access level should always be set to Public Page 168 of 181 Community Builder 1 2 Details Module Type Title Show Title Enabled Position Order Access Level ID 57 Description Login to be used with Community Builder instead of the Login module Figure 95 CB Login Details J 1 5 X Page 169 of 181 Community Builder 1 2 Parameters Module Parameters Module Class Suffix Module orientation Display type Login Pre text Login Post text Logout Pre text Logout Post text Login Redirection URL Logout Redirection URL Lost password Create account Display username password labels as Username length Password length Display login logout button as Display login reminder register as Login Message Logout Message Remember me checkox Greeting Hame Username Show avatar when logged in Avatar position Profile link
20. JoomlaFish Mamblefish Field Name Published o Available options via dropdown list Yes No Field Name Profile Ordering o This field is populated by a dropdown list of tab names Select the value of the ordering you want this tab to appear in on the user profile Field Name Registration Ordering o This field is populated by a text field It should contain the order you want this tabs field grouping to appear in the registration application Only fields that have registrationzYes will of course appear during registration Field Name Position Sample output related with available settings can be found in Chapter 4 2 later on in this document o Available options via dropdown list Header above left middle right Left side of middle area Middle area Right side of middle area Page 77 of 181 Community Builder 1 2 Main area below left middle right e Field Name Bottom area below main area Grid positions as of CB 1 2 a 9x9 grid has been added to extend the layout possibilities in the CB profile area Not displayed on profile position 1 9 These positions will basically hide the tab from your profile Display Type Sample output related with available settings can be found in Chapter 4 2 later on in this document o Available option via dropdown list e Field Name Tabbed pane Div with title Raw display without title Overlay moving with mouse Fixed overlay closing on mouseout Button with
21. Mambo features or other Joomla Mambo components Some CB plugins may also be stand alone or self contained in the sense that they do not integrate with other components see Nant s Gallery plugin or JoomlaJoe s ProfileBook plugin The tabs associated with plugins will most likely contain various plugin and tab related parameters The Tab Management area of your CB 1 2 installation should look something like the following figure the Additional Info tab and the Personal Info tab have been added by the sample data CB Tool option in CB backend Page 81 of 181 Community Builder 1 2 Title Menu Connection Paths User Profile Page Title Portrait User Status Quick Message Contact Info Articles Forum Blog Additional Info Lt LI BER LE BIS CL BED C PLES LI Bee O LI Connections Newsletters 14 Personalinfo Description Display Plugin Private Message System Al Fireboard Forum mbiog B T a ntains a i onnectior elimiterCell Ed newslet lt div gt div cle IdCell In rvie e our newsle ailable t The ront of each n tter indica ethe cribed or not n change this and p Y aNC Newsletters nge subscript new If y ubscriptions eto n this ou wi cen ette e mail for ther gt n nal I Figure 33 Tab Management area J 1 5 X Published NON UE M Ww Kj BR VW Ww amp X A Access Everybody Everybody Everybody Everybody Everybody Everybody Everybody Everybody Everybody Everybody Everybody
22. No Only the Required icon With this setting fields will be presented in front end edit mode with these icons depending on field settings Only the Profile No profile icons With this setting fields will be presented in front end edit mode with these icons depending on field settings Only info icon explanation With this setting fields will be presented in front end edit mode with these icons depending on field settings Required and info explanation icons With this setting fields will be presented in front end edit mode with these icons depending on field settings Profile icon and info explanation icons With this setting fields will be presented in front end edit mode with these icons depending on field settings s gt Page 41 of 181 Community Builder 1 2 All icons required profile and info explanation With this setting fields are presented in front end edit mode with these icons depending on field settings e Field Name Login field type o Available Options via drop down list Page 42 of 181 Username With this setting the CB login authentication is performed using the username value The CB login module will adjust to this setting and present the login form using the username and password fields Username or email With this setting the CB login authentication is performed using the username or email address values The CB login module will adjust
23. Special if you want it to be viewable for moderators only Once we have successfully performed the activities outlined in chapters 2 6 and 2 10 we will be able to see the CB Login module and the CB Workflows module as new line items in your Joomla Mambo Site Modules listing The following Page 31 of 181 Community Builder 1 2 figure illustrates a section of the Site Modules area depicting the installation and publication of the 3 CB modules CB Login CB Workflows and CB Online in addition to the unpublished Joomla Mambo Login Form module Module Name Fublished Reorder Order Access Position Pages ID Type 1 Banners ir 1 Public banner All 18 mod banners 2 CE Login r F 1 Public left All 40 mod_cblogin 3 CB Workflows re a F 2 Public left All 41 mod comprofilermoderator 4 CB Online a 3 Public left All 42 mod comprofileronline 5 7 LoginForm x a 4 Public left Varies 4 mod_login Main Menu i a F 5 Public left All 3 mod mainmenu Figure 9 Site Module Management Area J 1 0 X 2 12 Expert Upgrade Overview For those of you who already have a CB powered website and wish to painlessly upgrade to version CB 1 2 without losing any parameters or installed plugins there is an expert upgrade process that can help you There are 2 tar gz files in your CB 1 2 distribution package see chapter 2 1 One of the files is used for upgrading CB installations on a Joomla CMS environment and one for a Mambo CMS envir
24. be gum 4 xg o F i nu A aH x lt Q B Hi name this is a list of all members of our community Description Contact Image Pagebreak Readmore Figure 65 CB User List Direct Access URL J 1 5 X Page 138 of 181 Community Builder 1 2 7 1 Dynamic User Lists As of CB 1 2 field substitutions in the form cb_fieldname are supported in all titles descriptions and even advanced queries of CB user lists This simple functionality can lead to many nice features and setups that can be easily designed As an example suppose we want to create a dynamic user list that adjusts itself depending on the viewer Let s say that want to present our CB powered website members with a list of members that are located in the same country as they are If the country field used in our hypothetical site is cb country then our expert advanced user list query would look like cb country LIKE cb country Figure 66 Using field substitutions in advanced query to create dynamic user list We can also personalize the list description by using other field substitutions like the following Hi username this list contains all the Joomlapolitans that live in the same country as you cb country This illustrates the power of dynamic user lists Figure 67 Using field substitutions in user list description Page 139 of 181 Community Builder 1 2 8 Plugin Management As of 1 0 RC2 CB introduces the plugi
25. be very careful when using this option If you allow users to change their usernames then you might run into problems if other components also trigger their data off usernames instead of userid s e Field Name Required Fields in Admin o Available options via dropdown list Yes Instructs CB to enforce all user field restrictions and validations everywhere front end and back end even for the administrator account No Instructs CB not enforce required fields in the back end This allows the authorized administrators to quickly add new users via the backend without the hassle of filling in all reguired fields e Field Name Allow Access to o Available options via drop down list Selecting one will automatically allow access to all groups below E g If you select Author then all Editor Publisher and Public Backend groups are authorized Everybody All Registered Users gt Public Frontend Registered gt Author gt Editor gt Publisher gt Public Backend gt Manager Page 61 of 181 Community Builder 1 2 gt Administrator gt Super Administrator e Field Name Minimum hits interval minutes o The default value is 60 mins 1 hour This value is used to define the minimum amount of time that should elapse between two consecutive profile views by the same user in order to increase the hit count e Field Name Community Builder Template o Available options via dro
26. by the user that is the owner of the profile This is illustrated in Figure 84 All other users trying to access the banned user profile e g via a user list link will encounter a message stating that This profile has been banned by a moderator The actual user whose profile has been banned will receive an email message containing a banning notification Such a sample email message appears in the following figure Figure 83 From Registrar registrar yoursite com To user userdomain com Subject Site Name User Profile Banned Your User Profile was banned by an Administrator Please login and review why it was banned NOTE This email was automatically generated from Site Name http www yoursite com Figure 83 Banning Notification Email sent to Email Address of User J 1 0 X Page 157 of 181 Community Builder 1 2 When the user with a banned profile accesses his her profile from the CB Details user menu item he she will see a similar page as the one illustrated in the following figure Figure 84 This profile has been banned by a moderator Moderator Response Your profile has been banned because of inappropriate behaviour If you feel this action is unjustified you can issue an unban request Submit Unban Request tester Profile Page Submit a request to the site moderator to unban your Hits profile i Online Status ONLINE Member Since 2005 10 30 08 09 26 Last Online 2006 05 10 19 50 58 Last Updated 2006
27. creates the filtering to be performed for the produced list User list administrators are also allowed to use other non CB fields in user lists E g Last Online Member Since Last Updated Thumbnail Username etc You can see all these fields along with all the CB fields by clicking on the down arrow if the drop down list This is illustrated in figure that follows s simple Advanced Gender Equal Ta r Maie Acted Gender Male Greater Than Greater Than or Equal To Less Than Less Than or Equal To EqualTo Bl E Mot Equal To Remove Figure 60 Using the Simple filter builder Page 133 of 181 Community Builder 1 2 C Simple Advanced ch language LIKE english or cb language LIKE tugreekt AND ch gender Hale Figure 61 Using the Advanced filter builder In order to take full advantage of the Advanced filter builder knowledge of SQL is needed The script displayed in the previous screenshot is When such a list is actually implemented it will produce all English or Greek speaking male users e Item Name Column 1 2 3 or 4 set In this part of the user list administration panel the user list administrator must define the corresponding column 1 2 3 or 4 of the user list First of all the Enable Column check box must be activated checked Then the Column Title must be specified In case of multiple fields in this column we might choose to enable the Column Captions ch
28. directory field contains websitestructure mywebsitefolder com_comprofiler before you click on the Install button Page 19 of 181 Community Builder 1 2 For Joomla 1 5 X series e Method 1 single upload and install method Via the Administration panel using the Extensions Install Uninstall selection followed by the specification of the location of the com comprofiler zip file on your local hard drive via the Browse button and then clicking on the Upload File amp Install button e Method 2 two step method In some cases you will not be able to use method 1 because your host might time out in the middle of uploading or during installation The CB component is rather large and might cause this problem on certain hosting environments In this case you may manually unzip the com_comprofiler zip file and upload via FTP the resulting com_comprofiler folder along with all its contents and structure to your website folder you can substitute mywebsitefolder with any name of your liking as long as it exists and can accept you FTP upload websitestructure mywebsitefolder and then make sure that the Install directory field contains websitestructure mywebsitefolder com_comprofiler before you click on the Install button As of CB 1 2 the component installation process follows a two step approach to accommodate larger component distribution package and slower CMS installer Relevant messages will be displa
29. experimental feature added in CB 1 1 o Available Option via drop down list Yes Use this setting to instruct CB to dynamically check the existence of the selected username during the registration application process No default Use this setting to instruct CB not to dynamically check the use of the selected username during the registration process e Setting Name Ajax email checker This feature has been added in CB 1 2 and should be viewed as experimental o Available Option via drop down list No Yes Check only for email server accepting email Page 46 of 181 Community Builder 1 2 e Setting Name Show login on registration page o Available Options via drop down list No Yes e Setting Name Registration Email Name o Option set by populating a text field This field should be populated with the name you want the CB to use when sending Pending Approval and Required Email Confirmation messages to applicants E g Registration Service At MamboJoe s Site e Setting Name Registration Email Address o Option set by populating a text field This field should contain the email address you want CB to display when sending Pending Approval and Required Email Confirmation messages to applicants E g registrar amp mambo joe com Y Note This email address should be a legal and existing address Some servers will block emails sent by the CB workflow engine because of fierce spamming rules e Setting
30. full name Field Name Name Format o Available Options via a drop down list Username Only Use this setting if you want CB to display the username by itself E g jdow Username Name Use this setting to display the username along with the users full name in parenthesis E g jdow John Dow Name Only Use this setting to display full names instead of usernames E g John Dow Name username This setting is used to instruct CB to display users by their full name and the username in parenthesis E g John Dow jdow Field Name Date Format o Available Options via a drop down list Page 37 of 181 Community Builder 1 2 mm dd yyyy All dates are displayed starting with the two digit month followed by the 2 digit day and then the four digit year E g Christmas day of the year 2004 would be displayed as 12 25 2004 dd mm yyyy E g Christmas day of the year 2004 would be displayed as 25 12 2004 Many more settings that are self explanatory Field Name Calendar Type This setting is used to specify the calendar type used by CB when dealing with date fields As of CB 1 1 new date field functionality has been implemented you can now populate date fields by 3 drop down select fields day month year M The format of the date supported by the Calendar date fields is determined by the previous Date format field o Available Options via a drop down list Popup calendar default setting Us
31. 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 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 14 Conclusions Having spent some time reviewing the Community Builder suite in order to document it and use it of course I must conclude that it is an excellent opensource effort that truly provides the Joomla Mambo Community no pun intended with a set of much needed functionalities Hopefully all of you who have taken the time to read this will agree with this comment and visit us at www joomlapolis com and share your thoughts with the rest of the Community Builder community and why not contribute to the cause by donating money or effort to the project The functionality provided by CB for free is amazing considering that many commercial alternatives available lack many of these features Page 181 of 181
32. may receive errors erroneous replies Email Links wes ow Allow Email Links NOTE this setting only applies to custom fields of type email Website Links ves Allow Website Links Online Status ves show Online Status show icons on fields an icons required profile and info explanation Whether the icons and icons explanations should be shown at registration and user edit screens The info icons are always shown if field descriptions are present Login field type Email Login can be by username password username or email password or email password The CB login module also adapts accordingly Figure 10 Configuration Manager General TAB view J1 5 X The fields that may be configured from this TAB along with some basic guidelines regarding available settings are e Field Name Name Style o Available Options via a drop down list Single Name Field Use this setting to indicate that the CB should use a single field to populate the user s full name E g the value of this single name field may be John Doe Page 36 of 181 Community Builder 1 2 First amp Last Name Field Use this setting to indicate that the CB should use two fields to express the user s full name One of these fields will contain the first name e g John and the other will contain the last name e g Doe First Middle amp Last Name Field Use this setting to indicate that CB should use three fields to express the user s
33. numbers must be further verified Please visit www joomlapolis com to post your suggestions so we can improve this document Thank you for your understanding 2 Installation This chapter describes the initial steps an administrator of a Joomla Mambo driven website should take to correctly install the CB suite At this point the document describes all steps necessary to correctly install the CB suite without paying any specific attention to additional configuration options which will be Page 16 of 181 Community Builder 1 2 addressed in chapter 3 You are strongly encouraged to really read the readme txt file s in the distribution package 2 1 Distribution The distribution package of the CB 1 2 is a compressed zip file comprised of the following 8 files Com comprofiler zip This contains the installation package of the CB component mod cblog n zip This is the module package that will be used to substitute the default Joomla Mambo Login module mod_comprofilerOnline zip This is the module package that displays online members mod_comprofilerModerator zip This is the moderation package used to support the delegation of registration approval tasks to moderators and pending connection items to registered users cbh_expert_files_only_m_4_j_1 0 tar gz This compressed file contains 3 folder hierarchies that can be used to upgrade previous installations on Mambo and Joomla 1 0 X series without uninstalling
34. of CB the Tabs Management menu item must be selected from the relative Community Builder menu list Selecting Components Community Builder Tabs Management from the Joomla Mambo driven site administration panel will activate the Tabs Manager panel of CB Once in the Tabs Manager panel we can add a new tab by clicking on the New Tab icon The Add Tab panel then requires us to complete a number of parameter fields in order to define all aspects of the new tab These fields are e Field Name Title o Option set by populating a text field This text field should be populated with the desired title of the tab e g Additional Info Y Note As of CB 1 1 this field can contain cb_fieldname type content that is substituted during the presentation phase So for example one might use a field title of NAME s birthday e Field Name Description o Option set by populating a text area field This HTML text area field contains a more detailed description of the tab we are defining This description will appear only when editing the tab in front end or backend Page 76 of 181 Community Builder 1 2 expert s Note You can use underscore values as tab names or tab descriptions This will cause the CB code to look into the active language file to find the value of this string For example UE CONTACT INFO HEADER is set as the default value of the Contact Info title field With this method you can partially have multiple language support using
35. presents a relatively simple searching mechanism to front end user list viewers o Advanced all possibilities WARNING can be slow This setting presents an advanced searching mechanism that is very powerful but might be difficult for most users to cope with The General list settings set contains 3 parameters Page 136 of 181 Community Builder 1 2 e Number of entries per page This parameter is populated via a text box that should be populated with the number of search result entries to be displayed per page e Show pagination This parameter is populated via a drop down Yes No option e Hot link protection for the users list This parameter is populated via a drop down Yes No option List parameters Multi Criteria Searches Users lists can be searchable by multiple criterias according to settings below and the searchable attribute of the listed fields searchable fields Searchable fields displayed ones only search crieterias Simple Only is and ranges General list settings Number of entries per page Show pagination Yes gt Hot linking protection for this users list Ma Figure 63 List Parameters section of user lists If you populate your CB database using the Components gt Community Builder gt Tools option and clicking on the Load Sample Data URL you should be able to see a default list appearing in the CB List Management area This is illustrated in the following figure Figure 64 Be d s CB
36. specify the maximum length in chars allowed for the password box not the password field Default value 10 e Parameter Name Display login logout button as o Available options via drop down list Button with text This is the default presentation mode where the login form button has only text e g Login Logout Button with icon and text This setting instructs the CB login module to use icons and text labels for the login logout button Icons only This setting instructs the CB login module to use only clickable icons for the login logout button e Parameter Name Display login reminder register as o Available options via drop down list Text links This is the default presentation mode where the login form has only text links to reminder register options Icons and texts This setting instructs the CB login module to use icons and text links for the reminder register options Page 174 of 181 Community Builder 1 2 Icons This setting instructs the CB login module to use only clickable icons for the reminder register options e Parameter Name Login Message o Available options via radio choices Show This setting will cause a javascript popup to be presented upon successful login Hide default This setting will suppress the javascript popup from being presented upon successful login e Parameter Name Logout Message o Available options via radio choices Show This setting will cause a javascript popup to be pre
37. the functionality necessary to properly support the creation and maintenance of an online community The CB suite attempts and hopefully succeeds to address these matters and provides the basic building blocks to allow the Joomla Mambo CMS administrators and moderators to attract manage and increase their specific online community The current feature list of the CB suite which is addressed in this document includes e Ability to define additional fields associated with user profiles that are organized using tabs Field definitions also allow pop up tool tip like help messages to be specified in order to assist front end users during field completion Page 10 of 181 Community Builder 1 2 Profile avatar that can be uploaded or selected during registration process Profile avatar may also be modified at a later time if so allowed by CB avatar field settings and can also be published based on an approval process Tab template system available for tab presentation Four predefined templates included Ability to create your own tab template Tab templates have their own css file all tab templates share one css file Ability to include one or more of five predefined tab component plugins The currently preinstalled plugins are Author tab Forum tab Fireboard SimpleBoard JoomlaBoard Blog tab Mamboblog PMS tab Connections tab and Newsletter tab Yanc New plugins can be released at a later time and installed PMS Newsletter
38. the Synchronize Users option in the tools manager Page 147 of 181 Community Builder 1 2 1OBackend and Semi backend Operations Once the administrator of a Joomla Mambo driven CB powered site has completed the initial configuration of CB to support the website s community building goals and the system is released a number of day to day operational tasks must be performed The backend tasks can be performed by the administrator or authorized moderators These operational tasks along with the processing method used are Manually adding or modifying users via the Components gt Community Builder User Management menu item accessible via the administration panel Banning a user profile via the User Management panel Processing new registration applications via the CB Moderator links Processing user reports made against other users via the CB Moderator links Processing user image uploads if approval is needed via the CB Moderator links Synchronizing the default user tables with the CB user tables via the Components Community Builder Tools menu item from the admin panel This is only needed if for some reason both default Login module and CB Login module are active in parallel The above operations are described in the rest of this chapter Page 148 of 181 Community Builder 1 2 10 1 Using the User Manager Backend Panel The User Management administration screen is accessed from your Joomla Mambo driven CB
39. the Tab Template and Nested Tabs parameter settings Please note that the final result also depends on the Joomla Mambo site template as far as content elements are concerned Contact Info Articles Forum Blog Family Heritage Language s 9 English French 4rabic www karpathiantree info index php set_albumname admin amp option com_ gallery amp itemid 273 include view_album php My Gallery Figure 23 Front end Tab view with Tab Template set to default Contact Info articles Forum Blog Family Heritage Language s English French amp rabic www karpathiantree nfoandex php pane Ne amp et albumname admin amp option com qgallery amp itemid 23 amp include view _album php Figure 24 Front end Tab view with Tab Template set to luna Contact Info Articles Forum Blog Family Heritage Language sy English French Arabic www karpathiantree infoandex php My Gallery zet albumname admin amp option com qgallery amp rtemid 23 amp include view alburn php Figure 25 Front end Tab view with Tab Template set to webfx Page 64 of 181 Community Builder 1 2 Contact Info Articles Forum Blag Family Heritage Language s Endlish French Arabic www karpathiantree infa indes php sek albumname admin amp option com_gallery amp itemid 273 amp include view_album php My Gallery Figure 26 Front end Tab view with Tab Te
40. will help you get started quicker vith CB This will synchronize the Joomla Mambo User table with the JoomlaMambo Community Builder User Table Please make sure before synchronizing that the user name type firstlastname mode choice is set correctly in Components gt Community Builder Configuration gt General sa that the user synchronization imports the names in the appropriate format This will perform a series of tests on the Community Builder database and report back potential inconsistencies without changing or correcting the database This will perform a series of tests on the Community Builder User fields database and report back potential inconsistencies without changing or correcting the database This will check the database of installed CE plugins and report back potential inconsistencies without changing or correcting the database This will perform a series of tests on the Users database of the CMS the Community Builder users database and ACL and report back potential inconsistencies without changing ar correcting the database Figure 72 The Tools Manager back end J 1 5 X Community Builder 1 2 The only reason to synchronize users is if for some reason users were added to the Joomla Mambo user tables via some method other than the official CB channels If the CB front end login modules or the CB backend User Management section have been used since the initial installation of CB then there is no reason to access
41. with the total number of forum posts when forum plugin is published and forum compatible component has been installed and integrated with CB Name forumkarma Title Karma Type forumstats Tab User Status This predefined field will be populated with forum Karma value when the forum plugin is published and forum compatible component has been installed and integrated with CB By default this is not enabled see red forumstats because forum plugin is not published Name name Title Name Type predefined Tab Contact Info This predefined field matches the CMS name field It can be marked as searchable It can also be marked to be displayed on profile or not and can be configured like any other CB field Name firstname Title First Name Type predefined Tab Contact Info This field may hold the first name of a member and can be configured just like any other CB field Name middlename Title Middle Name Type predefined Tab Contact Info Page 117 of 181 Community Builder 1 2 This field may hold the middle name of a member and can be configured just like any other CB field e Name lastname Title Last Name Type predefined Tab Contact info This field may hold the last name of a member and can be configured just like any other CB field e Name email Title Email Type primaryemailaddress Tab Contact Info e Name username Title Username Type predefined Tab Contact Info e Name password Title Password Ty
42. 0 CBWM 5 Message displayed after registration submission 58 Figure 21 Configuration Manager User List TAB View J 1 5 X 59 Figure 22 Configuration Manager User Profile TAB View J 1 5 X 60 Figure 23 Front end Tab view with Tab Template set to default 64 Figure 24 Front end Tab view with Tab Template set to luna 64 Figure 25 Front end Tab view with Tab Template set to webfx 64 Page 6 of 181 Community Builder 1 2 Figure 26 Front end Tab view with Tab Template set to winclassic 65 Figure 27 Front end Tab view with Tab Template set to winclassic and nested WGN SSC E A eect AA A eee one aoe ced E AA 65 Figure 28 Configuration Manager Images TAB View J 1 5 X eseese 66 Figure 29 Configuration Manager Moderation TAB View J 1 5 X 69 Figure 30 Configuration Manager Connections TAB View J 1 5 X 72 Figure 31 Configuration Manager Integration TAB View J 1 5 X 75 Figure 32 Additional Info Tab specification J 1 5 X ssssssssssssss 79 Figure 33 Tab Management area J 1 5 X sse 82 Figure 934 Contact IN o plug in TOb eoe rtt trito eti tnt eee reto 93 IQUE SDAP TICS plug in TOD EE URN AMEN IRL EUR EISE Hd 94 Figure 36 Forum plug in Tab Joomlaboard forum component
43. 04 11 08 33 38 Fresh Joomlapolitan Forum Ranking Total Posts 2 Avg Profile Rating P90 uu D m gt v re Articles Blog Forum Connections Personal Info Joornlapolitan Card Zoom Gallery Last Visitors Profile Book CB Profile Gallery This user has no published articles Figure 84 User Access to his her Banned Profile J 1 0 X In this figure we can see that the banning message that was typed in the screen depicted in Figure 84 is also displayed here From this screen the user owner of the banned profile may use the Update Your Profile URL link from the Edit Menu to change the offending profile and then request an un banning of the profile by clicking on the Submit Unban Request URL link from the Moderation Menu that will also trigger an email message to the moderators as shown in Figure 87 Clicking on this URL will also allow the user to input comments for the moderator for review during the processing of the unban request Page 158 of 181 Community Builder 1 2 10 4 CB Moderator Handling of Unban User Profile Requests This request is triggered by a user accessing his her banned profile via the CB Details user menu item On this screen the user may click on the Submit Unban Request URL link as shown in Figure 84 This will result in a notification email message sent to the moderator group and a new Unban Request action item appearing in the CB Moderator module as shown in Figure 78 When a
44. 1 Community Builder 1 2 Page 108 of 181 Display on profile as Takes values from a dropdown list of e Full date default e Age in years e Time ago e Birthday only without year Display N years text Takes values from a dropdown list of e Display N years default e Display just N If searchable then search by Takes values from a dropdown list of e Full date default e Age Alternate display for age time ago birthday only display Text box used to enter alternative title for this field leave blank to use same title as in normal date display mode Display date and time Takes values from a dropdown list of e Yes date and also time if available default e Date only e Date and time Community Builder 1 2 Dropdown Single Select These fields can accept values from a specific list of predefined items that will be presented in a dropdown list format When defining fields of this type the CB will prompt the administrator to add additional list items until the entire list is completed E g the cb_education field may be of field type dropdown which has defined 5 possible values Elementary High School College University Other Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is not used for this type of field Dropdown Multi Select These fields can accept one or more values from a list of predefined v
45. 1 position of tab on user profile top down left right 3 changed after this item is saved 2 This ordering of tab on position of user profile 3 ordering of field within tab of user profile Tabs and fields on registration are ordered as follows ise n 1 This registration ordering of tab default SE 10 2 position of tab on user profile top down left right 10 l 3 ordering of tab on position of user profile cd 4 ordering of field within tab position of user profile Position Main area below left middle right Position on profile and ordering on registration Display type Tabbed pane m In which way the content of this tab will be displayed on the profile User Group to All Registered Users ESE aa in Public Front end All above that level will also have access to the list Registered Figure 32 Additional Info Tab specification J 1 5 X Page 79 of 181 Community Builder 1 2 Page 80 of 181 Community Builder 1 2 4 1 Predefined Plugin Tabs There are currently twelve 12 predefined Tabs that are automatically generated when the CB component is initially installed and extra 13 tab named Additional Info is generated when you select the load sample data option from the CB Tools backend Installation of new plugins via the CB Plugin Management Backend area will most likely install additional tabs in this area These plugins are created to provide specific integrated functionality with other Joomla
46. 1 1 Test Site com comprafiler showLists 5 Display 30 Search Title Description Published Default ACCESS Re Order E listid 1 Members List my Description Everybody 0 2 lt lt Start Previous 1 Next gt End gt Results 1 1 of 1 Page 137 of 181 E 200 Community Builder 1 2 Figure 64 CB User List Management Area J 1 0 X Notice that as of CB 1 1 each user list has a listid column containing the actual id value of each list This is useful if you want to add a menu item to directly access a specific user list In addition if you click on a URL of a saved CB list you will see the actual URLs needed to directly access the list There are 2 URLs The first one directly accesses the list but does not allow user list searching The second URL is used if user list searching is to be enabled allowed In our specific case the direct access URLs for the Member List listid 4 are index php option com_comprofiler amp task usersList amp listid 4 index php option com_comprofiler amp task usersList amp listid 4 amp searchmode 1 b Community Builder List Edit All Members URL for menu link to this list index php option com comprafiler amp task usersL ist amp listid 4 URL for search link to this list index php option zcom camprofiler amp task usersList amp listid 4 amp searchmodez1 Title All Members B J U sx d Styles Format Font family lt i
47. 2 CB Component Installation Messages for second step J 1 5 X 21 Figure 3 CB Component Backend Menu Tree J 1 0 X essees 22 Figure 4 CB Component Backend Menu Tree J 1 5 X essees 23 Figure 5 CB Login Module Installation J 1 0 X ssssssssesseerereree 24 Figure 6 CB Moderator Module Installation J 1 0 X sss 25 Figure 7 CB User Profile internal menu item J 1 5 X sess 27 Figure 8 User Lists Menu Item Basic Parameters in Joomla 1 5 X 30 Figure 9 Site Module Management Area J 1 0 X sse 32 Figure 10 Configuration Manager General TAB view J1 5 X ssssssss 36 Figure 11 Configuration Manager Registration TAB View J 1 5 X 44 Figure 12 Require Confirmation and Approval Workflow diagram 52 Figure 13 CBWM 1 Message displayed after registration submission 53 Figure 14 CBWM 2 Message displayed after successful email confirmation 53 Figure 15 Action Required email message sent to moderator group 54 Figure 16 Confirmation Only Workflow Diagram essere 55 Figure 17 CBWM 3 Message displayed after registration submission 56 Figure 18 CBWM 4 Message displayed after email confirmation 56 Figure 19 Require Approval Only Workflow Diagram sss 57 Figure 2
48. 9 of 181 Community Builder 1 2 Tab Details Title Personal Info Title as will appear on tab B Z U E z ZZ sues T Fomast l Fontany 7 LE EE E Lem HALO Lal t A 2 jE x x 2 nm P E This description This tab contains personal information about this Joomlapolitan appears only on user edit not on profile For profile text use delimiter fields Contact Image Pagebreak Readmore z Publish Yes Y Tabs and fields on profile are ordered as follows 1 of tab on user profile top down left right desees doses 2 This ordering of tab on position of user profile 3 ordering of field within tab position of user profile Tabs and fields on registration are ordered as follows Miis mim 1 This registration ordering of tab i pe 10 2 position of tab on user profile top down left right 4 0 E 3 of tab on of user profile doi 4 ordering of field within tab position of user profile Position Main area below left middle right osition on profile and ordering on regi Display type Tabbed pane In which way the content of this tab will be displayed on the profile Everybody User Group to All Registered Users ERN ic Public Front en All groups that level will also have access to the list Registered Figure 48 Definition and positioning of Personal Info tab J 1 5 X Page 120 of 181 Community Builder 1 2 LEJA OON L4 e alae EEL
49. CB 1 2 fields would only appear in profile front end mode if they had been populated with some value No This option basically emulates CB behaviour prior to CB 1 2 e Field Name Text to display for empty fields Option is set by populating a text field This is the value to be used when an unpopulated field is to be displayed in front end profile viewing Default value is a character You can also populate this parameter with a language string e Field Name Nested Tabs o Available options via drop down list Yes If you have a lot of user defined tabs that you want to be nested under a common profile tab select this option No If you want all your tabs displayed at the same level select this option e Field Name W3C XHTML 1 0 Tans Compliance o Available options via a drop down list No default value Yes Page 63 of 181 Community Builder 1 2 e Field Name Do not filter following tags on editor area fields o Option is set by populating a text field A space separated list of HTML tags that should be allowed in editor area fields You should be aware that not filtering some HTML tags might compromise security of your site The following tags are currently filtered applet body bgsound base basefont embed frame frameset head html id iframe ilayer layer link meta name object script style title xml A series of screenshots is provided in order to illustrate the potential end result of
50. D 142 56 2 Ldnoudge PUGIN S css ou EUM ipn NEUEM NUM DEIN EU D 143 Page 4 of 181 Community Builder 1 2 B U errs eoo omatus E id 144 9 Pools Manager uoscdeeso cesta tu mtaicesi icd tem e idee UE eem UE 146 10 Backend and Semi backend Operations ees 148 10 1 Using the User Manager Backend Panel sss 149 10 2 Accessing the CB Moderator CB Workflow Module 152 10 3 CB Moderator Handling of User Reports sse 155 10 4 CB Moderator Handling of Unban User Profile Requests 159 10 5 CB Moderator Handling of Image Approval Requests 161 10 6 CB Moderator User Registration Handling ssss 162 10 7 USING TNE Tools SEF COM acc secre bs eos enis teo befreit eon id ases elut 163 10 8 Uploading Gallery Images seen 164 10 9 Frontend Operaio custo po te bett eius ascetic 164 10 10 Selecting or Uploading an Image for User Profile 165 11 Configuring CB Login Module essere 168 12 Language fle Changes scs a et tud edet cde ote d Etpe rest 180 13 OUDDOP D soo dteted duc eterne ee Seer E een ete eee 181 MEME un RR 181 Page 5 of 181 Community Builder 1 2 Table of Figures Figure 1 CB Component Installation Messages for first step J 1 5 X 21 Figure
51. Details Peer rrr Contact Info Forum settings Newsletters Newsletter Description Products This newsletter is published 2 3 times each month and contains the latest happenings about the ira Mambo Community Builder r Security lerts This newsletter is published once a month and contains news regarding the latest release of the Mambo Community Builder and identified bugs m Test Select newsletters Format Receive newsletters fe as emails Formatted in HTML as plain text emails Update Cancel D Field description Move mouse ower icon This Field iz required E This Field IS visible on profile A This Field l5 MOT visible on profile Figure 42 Newsletter Tab Application Page 98 of 181 Community Builder 1 2 Whore The Yanc component must be downloaded and installed separately Also note that the Yanc component is not Joomla 1 5 X native compatible yet and may also have problems with legacy plugin enabled 4 2 Positioning Tabs All tabs whether created by plugins or by user intervention via CB Tab Management area have two parameters in the tab details area that influence the appearance of the tab in the front end The two parameters along with their drop down selectable values are e Position O O O O O PV1 Header above left middle right PV2 Left side of middle area PV3 Middle area PV4 Right side of middle area PV5 Main area below left middle right
52. E WELCOME DESC This field may contain a Leave blank for not displaying any message Enter the text html to display on the bottom of the registration page or a language dependent constant like UE WELCOME DESC This field may contain a thank you and or special instructions Leave blank for not displaying any message Set to Yes to require users to accept your terms and conditions before bibe Enter the URL to your terms amp conditions Enter the URL to display on the very first login after registration This page may contain your welcome message to new members and or special instructions or redirect the user to complete his profile Leave blank for normal login also the first time url for showing user profile is index php option com comprofiler amp ltemid 1 replace Itemid 1 by the same Itemid as your profile menu Figure 11 Configuration Manager Registration TAB View J 1 5 X Page 44 of 181 Community Builder 1 2 The fields that may be configured from this TAB along with some basic guidelines regarding available settings are e Setting Name Allow User Registration o Available Options via drop down list same as global allow registration site setting Use this setting fo instruct CB fo adhere by the Joomla Mambo Global site setting parameter to allow or not front end registrations applications yes independently of global site setting Use this setting to instruct CB not to look at the Joomla Mambo global site config
53. IRM Inserts confirmation link if the confirmation functionality is enabled FIELDNAME This will insert the value relative to the user who the email is addressed to Just include the database field name of the field you want to include between Your Registration is Pend Greetings NAME Thank you for applying for registration with us We have received your request and we will process it as soon as you confirm your email address by clicking on the following New User Details Welcome NAME Your application has been approved by our administration team Your account with the following details DETAILS has been activated We welcome you to our online community and trust Top and Bottom Enable Terms amp Conditions No URL To Terms amp Conditions URL for first login visit index php option com_content amp task view 4id 18 index php option com_comprofiler Subject of mail sent to user when Pending Approval you can use language strings or leave subject and email blank to suppress the email sending Subject of mail sent to user to welcome him once he can login upon registration you can use language strings or leave subject and email blank to suppress the email sending Whether the icons explanations should be shown at top and or bottom of registration page default is top and bottom Enter the text html to display on the top of the registration page or a language dependent constant like U
54. Joomla Mambo Community Builder Version 1 2 stable codename eleftheria Detailed Guide COMMUNITY BUILDER Version 1 2 stable doc version 1 Revision date 2 January 2009 Author Nick A nant joomlapolis com Copyright No portion of this document may be reproduced or re distributed without the consent of the author Community Builder 1 2 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 DJ Trail m Trail Lead Tester Co founder Pete PeterMixt Tester Nick A NENNEN Nant Documentation Public Relations JP co admin e 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 181 Community Builder 1 2 Table of Contents b sEHPPOSUEEIOD decir oe irn EUdict binc tinet ten eee eee deine 10 Id Wiharsdtl doll eere eaten dnte odere deo dotem keene dats 10 L2 Document OUTING osito oO Oeo tipa biete Eo ades 13 1 3 Acknowledgements Credits and Copyrights esses 14
55. MTP checking will not be possible unless this PHP function is enabled Allow to check if an email is valid during registration checking exact accept incomming emails to this address by SMTP You can also check for the email to not be already registered WARNING this additional emai already registered check might raise a PRIVACY ISSUE on your website and or in your country as on registration anybody could check if a given email address is registered Please enable only after checking your local regulations applicable to your site For SMTP check your server must have a fixed IP address the site s email address must be valid and this server be listed in its authorized originators SPF record for this feature to work properly with most email addresses Y ou need to be aware that even though this feature is protected under some circumstances it could be misused This is an experimental feature not yet optimized for large sites test first Whether the login module content should be shown side by side on registration page IMPORTANT CB login module must be installed for this to work Please enter the name that you want to be displayed when sending email Email address you want to when emailing registrants Email address you want be used as the reply to addressed DETAILS Account Details of the User such as Email Address and Username PASSWORD Password choosen by the User only at the first email sent upon pressing Register CONF
56. Name Registration Reply To Email Address o Option set by populating a text field This field should contain the reply to address may be different from the Registration Email Address which may be fake that CB should use when sending Pending Approval and Required Email Confirmation messages to applicants E g mambo joe mambojoe com e Setting Name Pending Approval Subject o Option set by populating a text field Page 47 of 181 Community Builder 1 2 This field should be populated with the subject you want the CB to use when sending Pending Approval Email Messages to website applicants Example Your Registration is Pending Approval e Setting Name Pending Approval Email o Option set by populating a text area field This field should contain the content of the message you want the CB to send applicants to notify them that their application is Pending Approval and give instructions if needed to continue the process This message may be personalized by using one of the following strings in this text area field use NAME were you want the applicants name to appear USERNAME were you want the applicants username to appear DETAILS were you want the applicants account details Email address username and password to appear and finally place CONFIRM were you want an email confirmation URL to appear As of RCZ the CB admin can add CB fields to further personalize this email message These CB fields must be placed in bra
57. Number User Competence Level etc expert s Note You can use underscore values as field titles This will cause the CB code to look into the active language file to find the value of this string For example UE CONTACT INFO HEADER is set as the default value of the Contact Info title field With this method you can partially have multiple language support using Joomlafish Mamblefish Page 103 of 181 Community Builder 1 2 You can also use cb fieldname type concepts and other replacement tags in the Title fields e Description I field tip text or HTML This field parameter is used in one of two ways depending on the field type In most cases it is used to define the contents of the tool tip popup used to provide online help for users when they are to populate or modify the field If we are dealing with a field of type Fields delimiter this area is used to provide the field delimiter HTML code You can also use cb_fieldname type concepts and other replacement tags in the Description fields As of CB 1 2 the description parameter is handled with an HTML editor e Default Value This field parameter is used to specify a default initial value for the field in question For example you could specify a default value of Not Specified for a text field M uere The Default Value does not apply to Delimiter field types thus it is hidden in this case e Required A Yes No value indicating if this field must be completed dur
58. Public Access viewing You may of course use the v arrow buttons to Page 30 of 181 Community Builder 1 2 reorder the positioning of this new module To deactivate the mod login module this is the default login module provided with Joomla Mambo find it in the installed modules and Unpublish it More 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 You can also further configure your CB Login module instance by using the many parameters located in your CB Login parameter module area More of this is discussed in Chapter 11 page 168 2 11 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 by accessing the Modules3 Site Modules in Joomla 1 0 X and Mambo installations or Extensions Module Manager in Joomla 1 5 X series and clicking on the Publish icon having first selected via the check box the specific module line with the wording CB Workflows The module should be published as Registered if you want it to be available for registered users or
59. S Enhanced 2 x uddeIM recommended by CB Team Clexus PMS Missus PMS JIM PMS Primezilla JAM e Parameter Name Private Messages Notification o Available options via drop down list Do not show default Show only if message Show always e Parameter Name Connections Notification o Available options via drop down list Do not show default Show only if pending connections Page 178 of 181 Community Builder 1 2 e Parameter Name HTTPS encrypted login registered and lost password M ee This feature is only for Joomla 1 0 13 and 1 5 X o Available options via drop down list Same as page default Use https for posting login then same Use https encrypted for login and after login e Parameter Name CB Plugins integration o Available options via drop down list Yes at this time this is used to integrate the CB Captcha plugin with the CB Login No default You should experiment with the CB Login module parameters for the best combination for your site usability and template The following figure Figure 97 illustrates what the CB Login module would look like to a logged in member of website with some tweaking of its parameters AR You hawe 1 Connection Reguesti s Figure 97 CB Login module front end view J 1 0 X Page 179 of 181 Community Builder 1 2 12 Language file changes All front end messages and pages displayed by CB are generated by language strings th
60. Selecting Components gt Community Builder List Management from the Joomla Mambo driven site administration panel will activate the List Manager panel of CB With this panel the administrator may define user lists online reports that may be browsed by authorized users via the CB User List menu item that was added to the User Menu back in chapter 2 9 From this panel administrators can click on the New List icon to add a new user list AS a starting point we must mention that any user list may in fact must result in one to four columns of one or more fields in each column For example a user list in column 1 may contain two CB fields the Username and the Name Column 2 may contain the fields Member Since Last Online and Last Update M uere If you are planning to construct user lists with multiple columns you need to take a close look at your Joomla Mambo template E g a fixed width template might cause problems when displaying a list with a lot of columns and a lot of fields in each column When adding new user lists the following items that appear on the Add List panel or the Edit List panel in case we are editing a previously specified list must be specified e Item Name Title This field is used to specify the title of the list that will appear in the dropdown list of available user lists once the CB User List menu item is selected Page 129 of 181 Community Builder 1 2 e Item Name Description A short HTML editor d
61. Status Member Since Last Online Last Updated Connections Forum Ranking Total Post Karma Formatted Mame Mame First Mame Middle Mame Last Mame Email Username Password User Parameters Type image counter status date date date connections forumstatz forumstatz forumstats formatname predefined predefined predefined predefined primaryemailacddress predefined password WEEP parame Tab Portrait User Status User Status Uzer Status User Status User Status User Status User Status User Status User Status Contact Info Contact Into Contact Info Contact Into Contact Info Contact Info Contact Info Contact Info Contact Info Required x 4 4 X 4 4 X X X X X X X X X X X Profile t Ling t Ling t Line v Line v 4 Line t Ling v 1 Line v Line v 4 Line t Ling 4 Line x X X X X X X X Registration Searchable x 4 4 4 Q 4 X X X X X XY X X X X X Published Re Order x x wf 1 x 4 7 22 x wf a v 21 x ff a T 20 x v a v as x Y a 7 18 x wf acj Me x wf 4 18 x zi a T 15 x v a 14 x wf bi 52 wf x a 7 51 E wf a y 50 x wf a tT 4g x a 48 x wf a T 47 wf wf a 7 46 x v a tT 45 x wf a 30 Figure 46 CB Predefined fields J 1 5 X The predefined CB fields along with a brief description regarding some associated use cases follow Name avatar Titl
62. above will have access IMPORTANT the Public Front end nd CB Profile menu item must also have a corresponding access level e g public if everybody should have access to user Registered profiles Author Minimum hits interwal minutes 60 Set a minimum interval between views and hits count of a given user profile by a given user Default is 60 minutes fone hour Community Builder Template Default Select a template to apply to the tabs tooltips panne and menus used throughout community builder You can add your own or other ones using the Community Builder Plug in management 2 columns layout widths Left 50 Right the rest Layout widths in Yo for 2 columns profiles 3 columns layout widths Left 32 Right 32 ag Layout widths in for 3 columns profiles Middle column the rest Show empty tabs Yes ow Show all tabs also if a tab has no content or only show tabs with content Show empty fields Yes ow Show all fields alao if a field has no content or only show fields with content Text to display for empty fields a Text that is displayed for empty fields Language strings and field substitutions work too The language string ME MO ANSWER displays No answer Nest Tabs No F Nest all tabs under a single profile panel This is very helpful when there are large amounts of tabs W3C XHTML 1 0 Trans compliance Yes ow As some Joomla Mambo templates do not include the necessary statement php mosShowHeadi 7 gt
63. acterize the field o Size The value in this field is used to specify the width in characters default 40 chars of the table that controls the spread of boxes o Cols This value defines the number of columns the checkboxes should occupy when they are rendered Page 106 of 181 Community Builder 1 2 o Rows This value defines the number of rows the checkboxes should occupy when they are rendered o Field Specific Parameters Date Display on profile as which can take values from a drop down list containing e Comma separated line default e Unnumbered list ul e Ordered list ol CSS class of the list which is a text box that can be used to enter the name of the class to use for ul or ol tag These fields accept dates Such fields are populated via a popup calendar window and are displayed in the format specified by the contents of the Date Format field that was selected in the Configuration Manager General TAB page see chapfer 3 1 Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is not used for this type of field o Field Specific Parameters Minimum Year shown default 110 means that minimum year displayed in dropdown is 110 years before this year Maximum Year shown default 25 means that maximum year displayed in dropdown is 25 years after this year Page 107 of 18
64. agegroup Age Group Community Builder 1 2 L F HTML d gu YO ay H x 3 Select the age group you belong in Contact Image Pagebreak Readmore 4 Figure 53 Age group Field Example J 1 5 X Styles Format Font Family Li 4 A Page 125 of 181 Community Builder 1 2 addaa fee Hame Between 20 and 25 Between 26 and 30 Between 3d and35 Between 36 and 40 Between 41 and50 Between 51 and ED Between 6 and 70 Between 71 and8D Between 8l and 30 Over Oyeasckd 4 de e 4h dA 4 oA 4 4 09 Figure 54 Values for Age Group Field Example J 1 5 X As of CB 1 2 these value boxes can be moved AJ AX to reorder them Articles Blog Forum Connections Personal Info Joomlapolitan Card About Me zoom Gallery Last Visitors Profile Book CB Profile Gallery This area may be used in the future to provide important information and announcements concerning my life and my interaction with this community It s really an open space area that should be viewed as the most important and possible upto date blog about myself I am not really sure how it should be organized or even how often it should be updated The better organized it is and maintained the more people will be visiting my profile ta check up on this I can imagine on same sites that this may contain very personal information or even an
65. alues Such a field is presented for completion as a drop down list Multiple values may be selected using the control key When defining fields of this type the CB will prompt the administrator to add additional checkbox list items until the entire list is completed E g the cb anguages field may be of field type checkbox multiple which has defined 5 possible values English Greek French Italian German A completed field of this type is displayed as a list of semi colon separated items e g English Italian Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is not used for this type of field Page 109 of 181 Community Builder 1 2 e Email Address These fields are designed to accept email addresses as contents Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is used to specify the number of viewable characters in the field box o Max Length This value is used to specify the maximum allowable characters in the field box e Editor Text Area These fields accept formatted text that can be edited via the embedded editor set in the Joomla Mambo Admin panel Global Configuration Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field pleas
66. am releases section of download area Additional add ons in the form of language or user plug in packages may also be downloaded from the previous sites Page 18 of 181 Community Builder 1 2 2 2 CB Component 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 eight files described in chapter 2 1 and then complete one of the following Methods For Joomla 1 0 X series and Mambo Method 1 single upload and install method Via the Administration panel using the Components Install Uninstall selection followed by the specification of the location of the com comprofiler zip file on your local hard drive via the Browse button and then clicking on the Upload File amp Install button Method 2 two step method In some cases you will not be able to use method 1 because your host might time out in the middle of uploading or during installation The CB component is rather large and might cause this problem on certain hosting environments In this case you may manually unzip the com_comprofiler zip file and upload via FTP the resulting com_comprofiler folder along with all its contents and structure to your website folder you can substitute mywebsitefolder with any name of your liking as long as it exists and can accept you FTP upload websitestructure mywebsitefolder and then make sure that the Install
67. an also be marked as searchable for user list front end searching e Name lastvisitDate Title Last Online Type date Tab User Status This predefined field keeps track of the last date the member visited the website By default this is placed on the User status predefined tab and can also be marked as searchable for user list front end searching e Name lastupdatedate Title Last Updated Type date Tab User Status This predefined field tracks the last date the user updated his her profile By default this is placed on the User status predefined tab and can also be marked as searchable for user list front end searching e Name connections Title Connections Type connections Tab User Status This predefined field contains the number of connections a user has Of Page 116 of 181 Community Builder 1 2 course it depends on the actual activation of the connections feature in the CB configuration backend and the publishing of the Connections plugin This field cannot be marked as searchable Name forumrank Title Forum Ranking Type forumstats Tab User Status This predefined field will be populated with forum ranking when the forum plugin is published and forum compatible component has been installed and integrated with CB By default this is not enabled see red forumstats because forum plugin is not published Name forumposts Title Total Posts Type forumstats Tab User Status This predefined field will be populated
68. appears in the CB Moderator module Clicking on the Reported User column URL will take the administrative user moderator to the offending profile were the moderator may select to ban is by selecting the appropriate Moderation MENU sub item as shown in the following figures Page 155 of 181 Community Builder 1 2 Community Loudogi 1 Profile Page Hits 1158 Online Status OFFLINE Member Since 2005 11 08 18 40 47 Last Online 2006 05 10 15 27 11 Last Updated 006 03 21 20 38 14 Avg Profile Rating Figure 80 CB Moderator Module Reviewing Suspect User Profile Reported by Users J 1 0 X This figure allows the moderator to review the offending based on the user report profile and take actions to ban the profile if needed Clicking on the Ban Profile in the Moderation Menu will start the banning profile process Reject Image Ban Profile s Site Moderator Ban this profile making it invisible to other users Online Status OFFLINE Figure 81 CB Moderator Banning a Profile J 1 0 X Following the selection of the Ban Profile menu sub item the moderator is presented with a text area to provide the reason for this banning action Page 156 of 181 Community Builder 1 2 Ban Report Reason far Ban This profile is offensive to our community and it has been banned Submit Figure 82 CB Moderator Ban Report J 1 0 X This message will appear as a header message on the banned profile when viewed
69. as illustrated in the following figure Figure 29 General Registration User List User Profile Images Moderation Connections Integration Current Setting Explanation Moderator Groups Public Back end T All users in the group selected and above will be moderators Manager Super Administrator Y Moderator Approve Users This configuration allows Moderators to approve users pending approval via the front end of the website 4 4 Send Moderators Email If Yes moderators will receive emails when actions happen that require their attention Allow User Reports Allows users to report inappropriate behavior of other users to moderators 7 4 Require Upload Image Approval Require all images uploaded by users to be approved prior to being displayed Allow Moderators to Edit User Allows moderators to edit a users profile and to add change or delete users avatars Moderators cannot edit same or Profiles higher level moderators Allow Profile Banning Allows moderators to prevent a users profile from being publicly displayed 5 4 Figure 29 Configuration Manager Moderation TAB View J 1 5 X The fields that may be configured from this TAB along with some basic guidelines regarding available settings are e Field Name Moderator Groups o Available options via drop down list Selecting one will automatically allow access to all groups below E g If you select Author then all Editor Publisher and Public Backend gro
70. at are defined in the CB language file As mentioned in chapter 8 2 CB language plugins are used to extend CB to work in other languages CB is installed with one default language plugin that just happens to be English This default language plugin appears as a folder in our website root gt components com comprofiler plugin language path and it contains the following files of interest e default language xml is the XML file defining the language plugin e default language php is the PHP file containing all the language string definitions e calendar locals js is a javascript file that contains language definitions used by the calendar pop embedded in CB The default language plugin is used if CB cannot find the proper language plugin based on the CMS language specified on our site Language plugins are available on Joomlapolis as they are contributed by community members If you open the default language php file with any text editor you will see all the language string definitions used by CB component and modules You can easily make any wording changes you see fit to make CB better and easier for your community project Particular care must be taken not to break the PHP language syntax so be cautious when making changes and always keep backup copies You will also see similar language related strings in the calendar locals js file that you can re word Page 180 of 181 Community Builder 1 2 13 Support If your CB experience
71. at have not completed the email confirmation phase of course one must consider that depending on the selected registration workflow this step might not be significant The v icon in this column will indicate that email confirmation has been successfully completed The authorized administrator may manually confirm an applicant by selecting the URL connected to the applicants name the Name column in the previous figure and changing the value of Confirm User field from No to Yes a drop down list The next figure illustrates what appears when the administrator clicks on one of the user URLs of the previous figure actual screenshot is from a different user Page 150 of 181 Community Builder 1 2 Author oS author ose author jp com oA Password EAL Verify Password User Editor Help Site Time Zone Group Public Front end Registered Fublisher Fublic Back end Administrator Super Administrator Block User No Approve User Yes Confirm User Yes R we Moderator Ho Users group level doesn t allow this Emails Register Date 2002 03 30 16 29 35 Last Visit Date 0000 00 00 00 00 00 wo Required field ae Field visible on your profile Field mot on profile 7 Information Point mouse to icon Figure 74 User Management Edit User Screen J 1 5 X e From this screen the authorized administrator may change any value of
72. ay OF February 2005 Welcome to the Project Saturday 29 January 2005 Welcome Testers Friday 20 August 2004 Mambo License Guidelines Monday 09 August 2004 Newsflash 1 Monday 09 August 2004 Newsflash 2 Monday 09 August 2004 Newsflash 3 Figure 35 Article plug in Tab 4 1 3 Forum Tab Application The forum plugin tab is used to integrate with the Fireboard Joomlaboard Simpleboard forum components available by other developers please search the internet A typical forum tab is illustrated in Figure 36 that follows Contact Info Articles Forum Blog Connections Forum Statistics Administrator Forum Ranking m Total Posts Karma Your Subscriptions D tnsubschbe From al 1 Geneo password by george unsubscribe Last 10 Forum Posts Date Subject Category zir2r2005 16 02 17 Re Geneo password Software Figure 36 Forum plug in Tab Joomlaboard forum component Page 94 of 181 Community Builder 1 2 M uere In order for the CB Forum tab to integrate with one of the 3 forum components it supports Simpleboard Joomlaboard or Fireboard the forum component must be installed This is a separate process that must be done by the website administrator The forum component package must be downloaded and installed As of this writing the Fireboard forum component is not Joomla 1 5 X native compatible thus it may have problems even with legacy plugin enabled 4 1 4 Blog Tab Application The Blog p
73. blic user TOON OMe nts Public user cb profie bonos Public user cbpsidsubscriplians Public user cb captcha Figure 71 CB User Plugin Management J 1 0 X Page 145 of 181 Community Builder 1 2 9 Tools Manager The Tools Manager provides the administrator with three functions e theobility to load sample data e theobility to synchronize the CB user table with the Joomla Mambo user table e the ability to execute a number of integrity tests against the CB database and the file system e the ability to execute a number of tests against the CB fields related database e the ability to execute a number of integrity tests against CB plugin databases and e the ability to execute a number of checks against the users database CB Tools Manager Load Sample Data Synchronize Users Check community Builder Database Check Community Builder User Fields Database Check CB plugins database Check Users Database Page 146 of 181 This will load sample data into the JoomlasMambo Community Builder component Precisely an additional information tab that ou can change Unpublish or delete in CB Tabs manager vill be created containing fields for location occupation interests campany address city state zipcode country phone and fax Cyou can then change unpublish ar delete those fields which you dont need in CB Fields Manager Also a users list will be created that you can edit from the CB Lists manager This
74. bo User Details item from the same User Menu Mambo and Joomla 1 0 X installations should follow these directions To add the CB Profile item to the User Menu we must take the following steps e Select Menu 3 User Menu from your Joomla Mambo website administration panel e Select the New Item button and you will see the Details TAB of the Add Menu Item Component panel e Choose Component from the Select a Component to Add item list then press the Next button e Select the Community Builder item from the Component list e Populate the Name field with CB Details e Select Top from the drop down list of the Parent Item field e Select Public from the drop down list of the Access field e Select the Yes radio button for the value of the Published field Page 26 of 181 Community Builder 1 2 Click on the Save icon Joomla 1 5 X installations should follow these directions To add the CB Profile item to the User Menu we must take the following steps Select Menus gt User Menu from your Joomla 1 5 X website administration panel Select the New Item button and you will see the Select Menu Item Type panel with a tree structure of items Choose Community Builder from the Internal Link tree item to further open the tree and reveal addition Community Builder items as illustrated in Figure 7 Select the User Profile mandatory item from the expanded list Populate the Name field with CB Details or any wording or your
75. c features that influence many aspects of the CB suite The General TAB view of the CB Configuration panel should appear as illustrated in the following figure Page 35 of 181 Community Builder 1 2 o CB Configuration Manager e Save Cancel Your version is 1 2 RC 2 B3 Latest version 1 2 RC 2 B3 DRM see ee ee M i j Y cm Es Ar r General Registration User List User Profile IL Images l Moderation Connections Integration Current Setting Explanation Name Style Single Name Field r The name style details how you what to capture the name field in Joomla Mambo Name Format Username Only Choose which format you would like the Name Username fields to be displayed Date Format mmidd vyyy oF Choose which date format you would like your date fields to be dispayed in Calendar Type Drop down popup calendar Choose which calendar you would like to use for dates selection Email Handling Display Link to Email Form NOTE This setting only applies to the users primary email address Emails sent From User Address setting for Send ta User Email forms Sender formating Choose between 1 From User Email Address no Reply To field User receives all replies and error reports for better privacy 2 From Admin Email Address with Reply To User Email Address This is SPF spam checking compliant but admin
76. cessing a user list and clicking on a user row When you have the users profile you want to connect to in your browser you will see the Add Connection link By clicking on this link the invitation process is initiated If the Notification Method is set to PMS or Email you will be presented with a pop up Page 96 of 181 Community Builder 1 2 window allowing you to personalize the invitation request An example of sucha _ personalization pop up window is presented in the following figure Connect to and Personalize your invitation ta connect by adding a message that will be included with your connection Message Hi Please accept this connection invitation El Add Figure 39 Connections personalized invitation Once the connections invitation is sent the recipient may act on this and other connections by clicking on the Manage Connections link in the Connections tab as shown in Figure 40 which will take us to the Manage Actions and Manage Connections area as illustrated in Figure 41 Contact Info Articles Forum Blog Manage Connections Figure 40 Connections plug in Tab To approve a pending connection just select the corresponding radio option and clicking on the button Page 97 of 181 Community Builder 1 2 Manage Actions Manage Connections E o editor Figure 41 Manage Actions and Manage Connections areas 4 1 6 Newsletter Tab Application Edit Your
77. choice Select Public 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 Internal Link g Articles 3 Community Builder B User Profile mandatory H serg lists D User profile edit O Username Passyord reminder D Registration page B Login page B Logout action s Contacts Figure 7 CB User Profile internal menu item J 1 5 X Page 27 of 181 Community Builder 1 2 Whore In both cases Mambo Joomla 1 0 X or Joomla 1 5 X methods you must publish the above menu item as Public If you do not you will run into various not authorized to view problems 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 gt User Menu admin panel 2 7 Adding a CB Login Menu Item You can add a CB Login menu item by following the process outlined in Chapter 2 6 This item should of course be a published as Public and for Joomla 1 0 X and Mambo series the URL should be index php option com comprofiler amp task login For Joomla 1 5 X series you should select the Login Page item illustrated in Figure 7 2 8 Adding a CB Logout Action Menu Item You can add a CB Logout menu item by f
78. ckets e g cb nickname The following is an example Pending Approval Email message that could be sent in case the Require Email Confirmation parameter is set to YES Greetings NAME Thank you for applying for registration with us We have received your request and we will process it as soon as you confirm your email address by clicking on the following hyperlink CONF IRM Once your email address is confirmed our moderators will be notified to continue the activation process You will be notified by email of the progress of the process DETAILS Kind Regards Website Administration Team e Setting Name Welcome Subject o Option set by populating a text field Page 48 of 181 Community Builder 1 2 This field should be populated with the subject you want the CB to use when sending Welcome Email Messages to website applicants that have been activated Example Welcome to the Joomlapolis website M Leave blank to suppress welcome message e Setting Name Welcome Email o Option set by populating a text area field This field should contain the content of the message you want the CB to send applicants that have been activated to notify them of this event This message may be personalized by using one of the following strings in this text area field use NAME were you want the applicants name to appear USERNAME were you want the applicants username to appear DETAILS were you want the applicants account details
79. d plugins Do not worry if this check returns some issues with your existing non core plugins these are just warnings of 3PD CB plugins that have not been appropriately coded to take advantage of the nice database upgrading features of the CB 1 2 APT Check Users Database This will identify any issues related with your user tables and will try to fix the issues for you Page 33 of 181 Community Builder 1 2 You should of course verify that your existing installation has all the appropriate initial configurations described in the previous sections of chapter 2 Special care should be given to assure that you have the appropriate menu items configured for CB Profile and CB Lists see chapter 2 6 and 2 9 Page 34 of 181 Community Builder 1 2 3 Configuration Having completed the installation and activation of the CB suite we are probably quite eager to investigate the various options that are offered and can assist us in organizing and structuring the foundation for our community building tasks By accessing the CB Configuration panel from our Joomla Mambo Administration area we are presented with the CB Configuration Manager that structures the various available options in a seven TAB layout The TAB names along with the available options are described in the following chapters 3 1 General Tab The contents of the General TAB section enable the administrator to configure the appearance and the functionality of various generi
80. d title username password is followed in the next line by its input box Compact With this setting a more compact presentation is rendered Here each title appears in the relevant input box thus saving space e Parameter Name Login Pre text Page 171 of 181 Community Builder 1 2 o This setting is configured by populating a text area The text area can contain HTML rich content that will appear just before the login form area field titles and input boxes e Parameter Name Login Post text o This setting is configured by populating a text area The text area can contain HTML rich content that will appear just after the login form area field titles and input boxes e Parameter Name Logout Pre text o This setting is configured by populating a text area The text area can contain HTML rich content that will appear just before the logout form area field titles and input boxes e Parameter Name Logout Post text o This setting is configured by populating a text area The text area can contain HTML rich content that will appear just after the logout form area field titles and input boxes e Parameter Name Login Redirection URL o This setting is used to specify a URL that will be presented after the login form is successfully processed Default value is a blank string meaning no redirection e Parameter Name Logout Redirection URL o This setting is used to specify a URL that will be presented after the logout form is successful
81. e Thumbnail Type image Tab portrait This is the avatar field a place holder for the avatar image By marking this field as present during registration you will present the website applicant with an option to upload or specify an avatar image see settings in CB Configuration Images tab chapter 3 5 You may also specify this Page 115 of 181 Community Builder 1 2 field as Required this forcing the user to specify an avatar or upload an image This field can also be marked as searchable in which case you can search a user list for all members that have or don t have an avatar e Name hits Title Hits Type counter Tab User Status This is the profile visits counter field It holds a count of all times a profile has been viewed You can decide not to show this on the profile by turning off the relevant field setting You can also move this field to any tab you want You can also mark this as searchable e Name onlinestatus Title Online Status Type status Tab User Status This predefined status field is originally placed on the User Status tab predefined tab and displays a green or red shinny icon along with an Online Offline text message language string definable This field can not be marked as searchable due to performance constraints e Name registerDate Title Member Since Type date Tab User Status This is the registration date of the member By default this is placed on the User status predefined tab and c
82. e note that not all editors correspond to these settings o Size This is the size of the editor text area in number of characters o Max Length This is the maximum number of characters allowed in the field o Cols The number of character columns of the editor text area o Rows The number of character rows of the editor text area Whore HTML tags are by default stripped by CB when editor field content is saved to the database You should the Do not filter following tags on editor area fields parameter see chapter 3 4 to specify which HTML tags you want CB to permit Page 110 of 181 Community Builder 1 2 Text Area These fields accept unformatted text no HTML code as input as opposed to the Editor Text Area field type Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size This is the size of the text area box in number of characters o Max Length This is the maximum number of characters allowed in the field o Cols The number of character columns of the editor box o Rows The number of character rows of the editor box Text Field These fields are one row height fields that accept text input Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size This is the number of characters that are shown in the field box o Max Length This is the number of charac
83. e value of this string For example UE CONTACT INFO HEADER is set as the default value of the Contact Info title field With this method you can have multiple language support using Joomlafish Mamblefish As of CB 1 2 each CB user list also has an extra List Parameters section see Figure 63 that currently has two parameter sets the Multi Criteria Searches set and the General lists settings set The Multi Criteria Searches set contains 2 parameters e Searchable fields This parameter is populated via a drop down mechanism that can take the following values Page 135 of 181 Community Builder 1 2 o No This setting will present a front end user list that is not searchable even if it contains fields that have been marked as searchable in the CB Fields management area o Searchable fields displayed ones only This setting will present a user list that is front end searchable but only on fields that are contained and addressed in the specific user list o All searchable fields This setting will present a user list that is front end searchable on all fields that have been specified as searchable in the CB Fields Management area Even fields that do not appear in the specific user list but have been marked searchable will be presented as search criteria e Search criteria This parameter is populated via a drop down mechanism that accepts the following values o Simple Only is and ranges This setting
84. eckbox to display the field labels Finally we must select a subset of CB fields and order them by desired appearance preference order This is accomplished by selecting the desired CB field from the list and clicking on the corresponding lt Add or Add button In case of multiple CB fields in a column the Remove button and the and buttons may be used to remove a selected field or reorder it An example of a completed column definition section for a user list id given in the following figure Page 134 of 181 Enable Column 1 E Column 1 Title History Column 1 Captions E Last Online Member Since EE Remove Enable Column 3 E Column 3 Title Birth amp Origin Column 3 Captions Place af Origin E E Remove Field ee Thumbnail Formatted Mame First Mame Middle Mame Last Mame Last Updated Gender Level af Education Degree Received z Add Add gt Community Builder 1 2 Enable Column 2 m Column z Title User Column 2 Captions v arme User Mame E Bl Remove Enable Column 4 Iv Column 4 Title Parents Column 4 Captions v Father s Mame Father s Place af Origin Mother s Maiden Mame Mother s Place af Origin eae Remove Figure 62 Column Definitions in User Lists M experts Note You can use underscore values as user list column titles This will cause the CB code to look into the active language file to find th
85. ed o Rows This value defines the number of rows the radio options should occupy when they are rendered Page 112 of 181 Community Builder 1 2 Web Address This field type is used to specify web addresses Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is used to specify the number of viewable characters in the field o Type Specified by a drop down selection with the options URL Only or Hypertext and URL Password This field type is used to specify password fields A password field appears in front end with instead of actual contents Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is used to specify the number of viewable characters in the field o Max Length This is the number of characters allowed in the field Fields delimiter This field is actually a constant html field It is not used to solicit any information Its purpose is to allow the CB administrator to specify some kind of separator or delimiter before or after a group of regular non delimiter fields Since fields of this type gather no information from users it has no need for a tool tip Thus the Description I field tip text or HTML parameter is used to provide the actual HTML code used to provide the field delimiter
86. erience boils down to the following activities e Filling out the registration application and following us on the registration process depending on the selected workflow e Viewing their own User Profile via the CB Details user link e Modifying their User Profile data e Selecting or uploading an image for their user profile e Viewing a user profile of another community member e Viewing or searching for users via the User List functionality accessible from the CB User List link on the User Menu Some of these operations have more or less been indirectly demonstrated and discussed in the previous chapters We will focus on the uploading an image process that has not really been discussed in detail in the previous chapters Page 164 of 181 Community Builder 1 2 10 10 Selecting or Uploading an Image for User Profile The initial user profile page of a newly registered user is accessed via the CB Details user menu link and looks similar to the following screenshot Community Edit admin Profile Page Hits 3 Online Status ONLINE Member Since 0513 2008 21 29 49 Last Online 05 30 2008 20 51 29 Last Updated 05 30 2008 22 52 43 Connections Contact Info Hame Administrator Username admin Figure 92 Initial User Profile Page J 1 5 X Clicking on the E Update Your Profile URL link located in the Edit menu of the User Profile Page will allow the user to edit his her profile This means that all CB field
87. es PMS When this option is selected connection workflow notifications will be managed by the private messaging system integrated with CB M ore The actual PMS component has to be installed separately and must be selected in the PMS MyPMS and Pro plugin parameters see CB Plugin Management Backend area e Field Name Cross Connections o Available options via dropdown list Yes Chose this option to instruct the CB component to treat all connections as bi directional No When this option is selected connections are uni directional This means that user A can be connected to user B but user B is not connected to user A e Field Name Connection Types o Option set by populating a text area field A list of connection type names is specified here Each connection may be characterized by one or more of these names These names are also language friendly Page 74 of 181 Community Builder 1 2 3 8 Integration Tab This section of the CB configuration options allows the Joomla Mambo driven CB powered website administrator to set various parameters that influence the way that the CB integrates with other Joomla Mambo components The Integration TAB view of the CB Configuration Manager panel should appear as illustrated in the following figure General Registration User List User Profile Images Moderation Connections Integration Current Setting Explanation Version checking on Configuration Automatic
88. escription of the user list this is just used to remind the administrator what this list is really about Meer Note You can use underscore values as a user list title or user list description This will cause the CB code to look into the active language file to find the value of this string For example UE CONTACT INFO HEADER is set as the default value of the Contact Info title field With this method you can partially have multiple language support using JoomlaFish Mamblefish You can also use cb fieldname substitution tags in descriptions and titles e Item Name User Groups to allow access to User list administrators can select which group and above can view this list The list of groups is Everybody All Registered Users gt Public Frontend Registered gt Author e Foi Lor gt Publisher Public Backend gt Manager gt Administrator O O O O O O O O O OQ Q gt Super Administrator Selecting for example Author will instruct CB to only allow Authors and above to have access to this list This means that ordinary registered users are not allowed to view this list e Item Name User Groups to Include User list administrators can select one or more user groups to be included in the list The list of groups is Page 130 of 181 Community Builder 1 2 gt Public Frontend gt Registered gt Author gt Editor gt Publisher gt Public Backend Mana
89. ese can be found in the CB Team releases area of the Joomlapolis download area Some of these CB Team Released Plugins appear in the Plugin Manager screen shot illustrated in Figure 71 These include e CB Auto Welcome e CB Profile Gallery e CB LastViews Tab e CB ProfileBook e CB Captcha for doc subscribers only Page 144 of 181 10 11 E 13 id 15 ie Ll NLIS Ce CI I LE DT BELTS DI ey I NEL ELI Plugin Manager Site Install Plugin Pingin Name CB Auto Welcome CB Prote Gallery PMS MAIS and Pro CB Core CB Connections Joona Content Author CB Meng Mamm bon Bing YaNC 1 453 Newsletters Simpleboard Forum CA Zoom Tab CA Lastliews Tab CB Zoom Comments Tab CB Profile Book CA Paid Subserations impor subscriptions CB Captcha Filter stalled Published Reorder Order E W i i w a F 2 w r a F 3 W a F 4 w a F 5 w a F 6 w ry a F 7 W a F W a F a W ro a F 10 w a 7 14 w a F 12 w a F 13 w ir a F id w a F 15 v i ag az Sfant Previous 1 Mex Eng Oiselayh 50 oF Results 1 16 of 16 Community Builder 1 2 user iei Access Type INractory Public user cb autowelcome Public user cb profienallen Public user PMS mypmaspro Public user cb core Public user cb connections Public user cb authortab Public user cb meng Public user cb mambiogiab Public user vanc Public user cb simpleboardtab Public user zoom Public user fastviews Pu
90. et to show Page 176 of 181 Community Builder 1 2 First Name This setting will cause the CB Login module to use the First Name of the member in the successful login Greeting message if the Greeting parameter is set to show e Parameter Name Show avatar when logged in o Available options via drop down list Hide This will cause the CB Login module to hide the members avatar in the successful login Show only if chosen This will show the member s avatar only if it exists in other words it will not show the No Image default picture Show always With this setting the members avatar is always displayed in the login module e Parameter Name Avatar position o Available options via drop down list Default Avatar will be presented on one line centered Left Avatar will be flushed left with text flowing on the right Right Avatar will be flushed right with text flowing on the left e Parameter Name Profile link text o This setting is used to display text or HTML message as a link back to the user s profile e Parameter Name Profile edit link text Page 177 of 181 Community Builder 1 2 o This setting is used to display text or HTML message as a link back to the users profile edit screen e Parameter Name Private Messaging System o Available options via drop down list No system installed default No PMS system installed PMS Open Source PMS Pro PMS Enhanced 1 x PM
91. ew J 1 5 X The fields that may be configured from this TAB along with some basic guidelines regarding available settings are e Field Name Path to ImageMagick o Option set by populating a text field Page 66 of 181 Default value is auto Community Builder 1 2 Field Name Path to NetPBM o Option set by populating a text field Default value is auto Field Name Image Software o Available options via dropdown list ImageMagick This option instructs CB fo use ImageMagick as the image processing application NetPBM This option instructs CB to use NetPBM as the image processing application GD1 This option instructs CB to use the GDI library as the image processing application GD2 This option instructs CB to use GD2 library as the image processing application Field Name Picture o Available options via dropdown list Field Name Yes This option allows registered users to have an image in their profile No Allow Image Upload o Available options via dropdown list Yes Allow registered users to upload an image for their profile this image might be set to a pending approval status depending on settings located in the Moderation TAB see chapter 3 6 Page 67 of 181 Community Builder 1 2 No e Field Name Use Image Gallery o Available options via dropdown list Yes Allow registered users to select an image from the gallery No e Field Name Maximum Image Height o Option
92. ewusername Please do not respond to this message as it is automatically generated and is for information purposes only NOTE This email was automatically generated from My Site Name http www yoursite com Figure 15 Action Required email message sent to moderator group M note These messages are not hard coded You can open the default php file located in the default plugin language folder or other language folders in case of international sites and change them to suit your specific needs The moderator group also receives an ACTION REQUIRED email message similar to the one shown in Figure 15 Page 54 of 181 Community Builder 1 2 3 2 2 Workflow Require Confirmation only If the Require Email Confirmation field is set to YES and the Require Admin Approval field is set to NO then the following workflow diagram is triggered Application Form Completed Y User is automatically enabled by the CB suite Application Form Submission CBWM 4 CBWM 3 S Y Pending Approval Message sent to applicants email address WECOME WESSagE sent to user Y Applicant Confirms Notification Message sent Email by clicking on the to Moderators embedded URL link C ss Figure 16 Confirmation Only Workflow Diagram This workflow also generates two web messages Specifically CBWM 3 is posted after successful meaning that all required fields
93. field may be set as Required at Registration to enable moderators to evaluate applications based on the age of the applicant Published A Yes No value indicating if this field is published thus available for viewing and editing or not Page 105 of 181 Community Builder 1 2 In addition to the previous generic characteristics each field must also be characterized by a field type Thirteen different field types are currently supported These are e Checkbox single These fields can basically accept Yes No values depending if the checkbox is checked or not Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is not used for this type of field e Checkbox multiple These fields can accept one or more values from a list of predefined values Such a field is presented for completion as a horizontal list of checkboxes When defining fields of this type the CB will prompt the administrator to add additional checkbox list items until the entire list is completed E g the cb anguages field may be of field type checkbox multiple which has defined 5 possible values English Greek French Italian German A completed field of this type is displayed as a list of semi colon separated items e g English Italian Additionally when a field of this type is defined the following parameters are also allowed and further char
94. ger gt Administrator O OF O O O O O OQ gt Super Administrator Use the Shift key to select adjacent items or the Ctrl key to select disperses items in the list Selecting for example Author and Editor will instruct CB to build the list using only user accounts that belong to these groups The following figure illustrates what the User Groups to Include field looks like when Author and Editor are selected URL for menu link to this list index php option com comprofiler amp task usersList amp listid Z Title All Users Styles jl Paragraph Font Family bey Il ll E b Egt HO Bm 4 A e x 3 B A All Users Description Contact Image Pagebreak Readmore 4 Everybody All Registered Users Public Front end _ Registered User Group to alow access to Public Front end Registered User Groups to Include in List Author Editor Published Default Sort By E Remove Figure 58 User List User Groups to Include field J 1 5 X Page 131 of 181 Community Builder 1 2 e Item Name Published Value set to Yes or No e Item Name Default Value set to Yes or No to indicate if the specific user list should be the default list presented to users in the drop down selection list e Item Name Sort By This combination of CB defined field names and ascending descending ASC DES values creates the sorting
95. gistrar registrar yoursite com To Moderator Group Subject Site Name User Report Pending Review A user has submitted a report regarding a user that requires review Please login and take the appropriate action NOTE This email was automatically generated from Site Name http www yoursite com Figure 76 Moderator Notification Email for User Reports Actions Page 153 of 181 Community Builder 1 2 From Registrar registrar yoursite com To Moderator Group Subject Site Name Image Pending Approval A user has submitted an image for approval Please login and take the appropriate action NOTE This email was automatically generated from Site Name http www yoursite com Figure 77 Moderator Notification Email for Image Pending Approval Actions A moderator once logged into the Joomla Mambo driven CB powered website will be able to see the CB Moderator Workflow module A sample screenshot of this module appears in the following figure CE Workflows 1 Unban request s 1 User reportis 1 Image s 1 Useris 1 Connection Request s Figure 78 CB Moderator Workflow Module Operational View J 1 0 X In this instance shown in the figure above there are 5 pending actions that need to be addressed Four of these action types are related with the moderator status of the user viewing the CB Workflows module and one of these actions relates with the Connections feature described in chapter 4 1 5 One
96. gure 55 About Me Tab front end Example sss 126 Figure 56 About Me Tab update mode Example suus 127 Figure 57 About Me editor text area Field Example J 1 5 X 128 Figure 58 User List User Groups to Include field J 1 5 X sss 131 Figure 59 Selecting Sort By fields for User Lists sss 132 Figure 60 Using the Simple filter builder sse 133 Figure 61 Using the Advanced filter builder sss 134 Figure 62 Column Definitions in User Lists sss 135 Figure 63 List Parameters section of user lists sess 137 Figure 64 CB User List Management Area J 1 0 X ssssssseeeeees 138 Figure 65 CB User List Direct Access URL J 1 5 X ssssssssssssssss 138 Figure 66 Using field substitutions in advanced query to create dynamic user I 139 Figure 67 Using field substitutions in user list description 139 Figure 68 Plugin Management Joomla 1 5 X sees 141 Figure 69 CB Template Plugins J 1 5 X sees 142 Figure 70 CB Language Plugins J 1 5 X sse 143 Figure 71 CB User Plugin Management J 1 0 X ssssssssssseseseeeerenes 145 Figure 72 The Tools Manager back end J 1 5 X s
97. has been optimized to work very efficiently from a database perspective it is very secure and robust and has been thoroughly tested in many different environments The development team takes true pride in releasing quality builds CB integrates nicely with your CMS of choice with absolutely no tampering with any core files or core tables CB itself can be extended by CB plugins that build upon the powerful CB API layer making CB the best choice for building your social networking website And most of all it s free and opensource 1 2 Document Outline This document is organized in 14 chapters and basically follows an administrator s perspective Thus the topics discussed start with the CB suite installation guidelines followed by a detailed presentation of the available configuration options and instructions regarding all processes related with the creation of community builder user profiles using tabs and fields Special attention is given to registration workflows The last chapters of the document Page 13 of 181 Community Builder 1 2 deal with the CB suite from an operations view from all three perspectives administrator moderator and end user 1 3 Acknowledgements Credits and Copyrights Any documentation that does not acknowledge the efforts of the development team and the community involved isn t worth the paper it s printed on or the KB it occupies The driving source and the heart beat of CB is of course JoomlaJoe a
98. have been populated submission of the online registration application which is initiated by clicking on the Send Registration button located at the end of the registration form This web page message is illustrated in the following figure Page 55 of 181 Community Builder 1 2 Registration Complete An email with further instructions on how to complete your registration has been sent to the email address you provided Please check your email to complete your registration Figure 17 CBWM 3 Message displayed after registration submission The second message CBWM 4 appears in the applicant s browser after the applicant clicks on the confirmation URL included in the Pending Approval email message This web page message is illustrated in the following figure Your account is now active You may now login Figure 18 CBWM 4 Message displayed after email confirmation The moderators also receive an email message similar to the one shown in Figure 15 with the exception that the subject does not contain the phrase ACTION REQUIRED It is just a notification email message and its subject is My site name New User Registration note These messages are not hard coded You can open the default php file located in the default plugin language folder or other language folders in case of international sites and change them to suit your specific needs Page 56 of 181 Community Builder 1 2 3 2 3 Workflow Re
99. hould be able to see the mod cblogin in the installed modules area of your Joomla Mambo Administration panel If not please refer to chapter 13 entitled Support for additional guidance Please note that at this time the module is inactive see how to activate in chapter 2 10 B Note The mod cblogin module now supports the login class for the styling of the login module URL links Specifically a mod 1ogin 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 Lost password Register etc 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 image approval and user reporting tasks to moderators that may be installed via the mod comprofilerModerator zip file using the standard Joomla Mambo module Page 24 of 181 Community Builder 1 2 installation procedure Either Package File or manual upload and Install Directory methods can be used We will focus on the package file method e 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 amp Install button Hopefully your chosen installation method will complete properly and y
100. i HO Ope t A Please select all relevant languages you are fluent in This will allow you to connect with members of similar Description interests fiekd tip text or by c W Il ni BL E mii I HTML Contact Image Pagebreak Readmore 4 Default value Required No Show on Profile Yes oniLine User Read Only No Show at Reqistration ves Published ves Size p Cols ci Rows 3 Figure 51 Languages multiple check box Field Example J 1 5 X Moe Notice the Rows 3 setting in Figure 51 This causes the Language checkboxes to be spaced out in 3 rows in Figure 47 Page 123 of 181 Community Builder 1 2 AddaVaue fe Hame Engish French Spanish Russian Chinese Geman Japanese Dutch Arabie 0 Greek Swedish Danish Finnish Other 7 4 4b 4b i e f Sf SA SA 0S4 oS 0S4 S oS 0S8 0S8 S Figure 52 Values for Language Field Example J 1 5 X aM Notice the blue up down arrows v in Figure 52 These are AJAX powered handles that can by used to reorder field values Page 124 of 181 Type Tab Name Title Description T field tip text or HTML Default value Required Show on Profile User Read Onbh Show at Registration Cole Rows Radio Buttons Personal Info cb
101. ing any applicable editing process user profile update or registration process E g the cb_birthdate field may be set as required and the telephone as optional M se If a field is set as required it is probably a good idea not to give it a default value Page 104 of 181 Community Builder 1 2 Show on Profile A Yes on 1 line Yes on 2 lines No value indicating whether or not this field will appear on the User Profile and how it might appear in relation to its title E g the cb user eve field may be hidden from the user profile This setting refers to the front end viewing of the profile In edit mode the field will appear Display field title in Profile A Yes No value indication whether or not this field s title should be displayed in the front end profile view E g take a look at the predefined avatar field that has this setting turned off Searchable in users lists NEW in CB 1 2 A Yes No value indicating whether or not the field should be searchable when it is added to a CB user list see chapter 7 User Read Only A Yes No value indicating whether or not the field value is allowed to be modified by the user E g the cb user eve field may be set to read only so that even if it appears on a user profile via the Show on Profile setting it cannot be changed by the user Required at Registration A Yes No value indicating whether or not the field appears during the registration process E g the cb_birthdate
102. ing every user to view the connection lists of other users Private When this option is selected all connections are treated as private thus users can only see their own connections When this option is specified no connection tab will appear at all on visited profiles e Field Name Display Connection Path o Available options via dropdown list Yes Chose this option to instruct the CB component to display the connection path between the active user and the visited profile Whore Please take care Activating this would have a large performance impact on your site No When this option is selected no path information is displayed e Field Name Mutual Consent o Available options via dropdown list Yes Chose this option to instruct the CB component to require that both parties agree to the initiated connection before an official connection is established No When this option is selected connections do not require mutual consent This means that a user can add other users to his her connection list without their knowledge and consent Page 73 of 181 Community Builder 1 2 e Field Name Notification Method o Available options via dropdown list None When this option is selected no connection workflow notification method is used Parties must use manual notifications to instruct each other of needed activities Email When this option is selected connection workflow notifications will be managed by email messag
103. ing this setting will instruct CB to use a popup calendar for date field population Drop down popup calendar Using this setting will instruct CB to use a combination of 3 drop down fields day month year and a calendar popup for date field population Field Name Email Handling o Available Options via a drop down list Page 38 of 181 Field Name Community Builder 1 2 Display Email Only Use this setting to instruct CB to display the users email address as it is E g mambo joe mambo joe com Display Email w Mailto Link Use this setting to display CB user email addresses with a mailto hyperlink E g mailto mambo joe mambo joe com Display Link to Email Form Use this setting to instruct CB to place a link to an Email form instead of the users email address Do Not Display Email This setting hides the users email altogether Whore This setting only applies to the primary email address used during the registration process It does not apply to additional email type fields added via the CB backend field management process Emails sent From This setting is used when emails are sent to users via email forms The constructed email must contain a From user address and perhaps a Reply To address o Available Options via drop down list User address Use this setting to instruct CB to use the user s member s email address when emails are sent by CB Admin Reply To user Use this sett
104. ing to instruct CB to use the admins email address as a from address when using email send forms and a Reply To value containing the users email address Page 39 of 181 Community Builder 1 2 e Field Name Email Links o Available Options via a drop down list No Use this setting to indicate that Email Links should not be activated for Email Address type fields Yes Use this option to activate Email Links for all fields of type Email Address Wrote This field only applies to email type fields created by the CB backend field management process It does not apply to the primary email address given when registering a new Joomla Mambo user e Field Name Website Links o Available Options via drop down list Yes Use this to display all Web Address type fields as hyperlinks pointing the website address No Use this setting to display all Web Address type fields without a hyperlink e Field Name Online Status o Available Options via a drop down list Yes To instruct CB to display whether or not the user is currently online in the various CB screens and user lists Page 40 of 181 Community Builder 1 2 No CB will hide information about the online status of users if this setting is selected e Field Name Show icons on fields o Available Options via drop down list Only the Required and profile icons default setting With this setting fields will be presented in front end edit mode with these icons 9
105. ion has been rejected Your registration at Site Name has been rejected for the following reason Please give us your real name NOTE This email was automatically generated from Site Name http www yoursite com Figure 91 Rejection Email Message Sent to User J 1 0 X 10 7 Using the Tools Screen If for some strange reason you decide to move back to the standard Joomla Mambo Login modules discarding the CB suite the CB suite gives the administrator a synchronization tool to synchronize the various database tables This is accessible via the Components gt Community Builder Tools menu item from the backend Joomla Mambo administration panel On this screen there is a Synchronize Users link that will update the Joomla Mambo database with the CB users database This tool may also be of use in the case that other modules or components access the standard Joomla Mambo tables Page 163 of 181 Community Builder 1 2 10 8 Uploading Gallery Images The CB suite allows users to select predefined images from an online image gallery something like avatars There are some default images that are placed in this gallery during the installation phase of the component More images can be uploaded manually via FTP directly to the gallery folder on your website This folder is located in the cms site root directory images comprofiler gallery path 10 9 Front end Operations From a non administrative user perspective the CB operational exp
106. is often also referred to as a buddy or friend system Display Type Public w Choose whether to make the display of each users connections public or priwate Display Connection Path Yez Choose whether to display the connection path between a user and the profile he she visits Mutual Consent Wes ow Enabling this feature will require that both parties agree to the initiated connection before an official connection is established Notification Method None Choose whether you want connection notifications and which method you would like you users to received notifications related to connections workflow Cross Connections Yes ow Enabling this feature will make a connection for both parties instead of just the requesting party Connection Types Friend al Enter a list of types to allow your users to further categorize there connections Press enter after each type Co Worker El Figure 30 Configuration Manager Connections TAB View J 1 5 X e Field Name Enable Connections o Available options via dropdown list No This is the default value Yes Select this option to enable the Connections plugin tab feature in the CB component the Connections plugin must also be published in the CB Plugin Management backend area e Field Name Display Type Page 72 of 181 Community Builder 1 2 o Available options via dropdown list Public Chose this option to instruct the CB component to treat all connections as public thus allow
107. ka mambo joe Additional support is provided by trail beat and petermixt The author of this document Nick A aka nant having evaluated CB has created this all in one manual to augment and highlight the effort of the developers Special mention must be made to the numerous community members that have helped out during the various development phases of the project The following third party components are referenced in this document e Fireboard Simpleboard JoomlaBoard e PMS II OS and Pro e Enhanced PMS e JIMPMS e UddeIM e YANC e Mamboblog The component and modules of the CB suite are released under GPL with the following clause This document is not released under GPL and no reproduction or distribution may take place without the author s permission Page 14 of 181 Community Builder 1 2 1 4 CMS Compatibility Version 1 2 of CB is compatible with Mambo versions 4 5 2 0 up to 4 6 2 and also with Joomla 1 0 X series and Joomla 1 5 X series in native mode ue Although CB 1 2 is natively compatible meaning that the Joomla legacy plugin does not have to be enabled many third party CB plugins have not been converted yet 1 5 Known Issues No known issues exist at the time of the writing of this document For latest identified issues please check the appropriate forum area on Joomlapolis 1 6 Current CB Version Note The latest CB suite version as of this document version is CB 1 2 Details about this
108. key for the produced list User list administrators are also allowed to use other non CB fields in user lists E g Last Online Member Since Last Updated Thumbnail Username etc You can see all these fields along with all the CB fields by clicking on the down arrow if the drop down list This is illustrated in figure that follows Registered E User Groups ta gt Author Include Editor Published Default sort By Enable Column 1 E Column 1 Tithe Date of Birth Figure 59 Selecting Sort By fields for User Lists Once the desired Sort by field is selected from the drop down list and the desired sort order is selected from the ACS DESC drop down list the Add button must be selected to record the selected pair CB field and Page 132 of 181 Community Builder 1 2 order In a similar process multiple pairs may be added to create a compound Sort by field Administrators may remove a pair by selecting it and pressing the Remove button or they may change the order of a selected pair by clicking on the button to move the selected pair up the list or the button to move it down the list these buttons are hidden by the Sort by drop down list in Figure 59 but are clearly displayed in Figure 58 Item name Filter This combination of CB defined field names and comparison clauses Greater Than Greater Than or Equal To Less Than Less Than or Equal To Equal To Not Equal To Is Empty Not Empty Like values
109. ll na langer cause problems to the community Please unban my profile Moderator Response Your profile has been banned because of inappropriate behaviour If you feel this action is unjustified you can issue an unban request Community View Messages Connections Reject Image tester Profile Page Unban Profile Hits As Site Moderator Unban this profile making it visible to _ other users a Online Status is Figure 86 CB Moderator Unbanning User Profiles J 1 0 X As we can see in the screenshot the reasoning and the user comments are displayed once again to further assist the moderator Clicking on the Unban Profile URL link will unban the user profile and also send a notification message to the user as outlined in the following figure Figure 87 From Registrar registrar yoursite com To user userdomain com Subject Site Name User Profile Unbanned Your User Profile was unbanned by an administrator Your profile is now visible to all users again NOTE This email was automatically generated from Site Name http www yoursite com Figure 87 Unbanning Notification Email sent to Email Address of User J 1 0 X If the moderator decides not to unban the profile the unban request count in the CB Moderator module in Figure 78 will remain and the specific request will continue to show up in the Moderator Unban Profile Requests screen in Figure 85 Page 160 of 181 Communit
110. lug in tab is used to integrate with the mamboblog component available over at http mambo theyard org Like the Articles tab plug in the Blog plug in presents blog rows with date title and hits columns as illustrated in Figure 37 that follows Articles Forum Connections Blog Personal Parents My News Date Title Tuesday 14 06 2005 Summer Plans 2005 Figure 37 Blog plug in Tab M ore The mamblog component package must be downloaded and installed separately Page 95 of 181 Community Builder 1 2 4 1 5 Connections Tab Application The Connections workflow is illustrated in the diagram illustrated in the following figure nn comecion Notification enabled Yes Y Send PMS or Email to No invited profile Mutual Consent enabled Y Perana Comecion Invited User processes pending connections via Manage Actions enabled Yes Notification Accept invitation Send PMS or Email to initiating profile No No Notification enabled Yes Connection Completed Send PMS or Email to initiating profile J Connection Declined Figure 38 Connections workflow In order to initiate a connection the user wishing to establish a connection must first visit the profile of the user he wants to connect to In most cases this is accomplished by ac
111. ly processed Default value is index php meaning that the viewer will be taken to the website homepage upon logout e Parameter Name Lost password o Available options via radio choices Page 172 of 181 Community Builder 1 2 Show default This setting will show the lost password link in the CB Login module Hide This setting will hide the lost password link from the CB Login module e Parameter Name Create account o Available options via radio choices Show default This setting will show the create account link in the CB Login module Hide This setting will hide the create account link from the CB Login module e Parameter Name Display username password labels as o Available options via drop down list Text This is the default presentation mode where the login form fields have only text labels e g Username Password etc Icons and text This setting instructs the CB login module to use icons and text labels for the login form Icons This setting instructs the CB login module to use only icons in the login form this setting is suitable for compact horizontal login form used on some templates e Parameter Name Username length Page 173 of 181 Community Builder 1 2 o This setting is used to specify the maximum length in chars allowed for the username box not the username field Default value 10 e Parameter Name Password length o This setting is used to
112. moderator reviews an Unban Request by clicking for example on the 1 Unban Request s of Figure 78 he she is presented with a screen similar to the one illustrated in the following figure Figure 85 Moderator Unban Profile Requests Click on the Banned User name ta view the corresponding user profile Then choose Maderate Lnban user from the user profile menu if you wish ta unban this user Banned Banned Reason Banned Date Banned User By User Response I have corrected by profile and will na longer cause problems to the community Please unban my profile 2006 05 10 tester 13 49 34 Moderator Response ate Your profile has been banned because of inappropriate behaviour If you feel this action is unjustified you can issue an unban request a Lu zi or Figure 85 CB Moderator Unban Profile Requests J 1 0 X The Unban Profile Requests page provides the moderator with all relevant information regarding the request This information includes the reasoning expressed for the original banning of the profile and the banned profile user s comments requesting the unbanning The moderator may then click on the Banned User column URL in the figure this would be tester and access the banned profile were there will now be a Unban Profile URL link as shown in the following figure Figure 86 Page 159 of 181 Community Builder 1 2 This profile has been banned by 4 moderator User Response I have corrected by profile and wi
113. mplate set to winclassic Profile Articles Forum Blog Contact Info Family Heritage Language s English French Arabic Waw kKarpathiantree infoindex php Ra a zet albumname adminzoption com qgallery amp iternid 23 amp include view alburn php Figure 27 Front end Tab view with Tab Template set to winclassic and nested tabs set The front end tab template system built into CB is based on the Tab Pane effort You can learn more about this system and learn to create your own tab templates by following this URL http webfx eae net dhtml tabpane tabpane html Meer Note With the exception of the luna tab template all others will auto stretch to accommodate the actual tab title length The luna tab template needs extra work on its image files in order to manually change the tab s width 3 4 1 Tab Templates and CSS Each one of the 5 available tab templates in CB is supported by code located in the corresponding based on the template name folder in the websitestructure components com_installer templates Page 65 of 181 Community Builder 1 2 path You can change the look and feel of your template by altering various files css and images located in this folder The css file in this folder also manages the appearance of the fields in the profile 3 5 Images Tab This section of the CB configuration options allows the Joomla Mambo driven CB powered website administrator to set various parameters tha
114. n framework as a method to enhance basic functionality in future proof fashion The plugin framework is based upon a well defined set of function hooks that comprise the plugin API The APT is described in detail in a PDF document available on Joomlapolis com With the plugin framework the administrator of a CB site can add additional languages additional tabs integrations with other components etc When the Plugin Management backend option is selected a screen similar to the following figure is produced With CB 1 2 the API has been expanded to handle field type plugins This method has been used to add the image field type and the integer field type More field type plugins will be released by the CB Team and hopefully additional ones will also be released by other community members Page 140 of 181 User Management ak CB Plugin Manager Install Plugin Filter l 11 D Default language English 2l 1 Default 3 D WinClassic 4 U WebFX 5 m OSX e Luna 710 Dark 8 L CB Core 9 CB Menu 10 1 CB Connections 141 L Content Author Fireboard Forum Ii TF Mamblog Blog a YaNC Newsletters amp Private Message System Install New Plugin Tab Management Upload Package File Package File Install from directo Install directory C dev xampp htdocs J15CB12 components com_comprofiler plugin Install package from web http https ry Field Management Plugin Name Display amp 20 i Installatio
115. n package URL http www w joomlapolis com plugins List Management Installed Published lt lt Start lt Prev 1 Next gt End gt gt A KIRATA ESEI KIKIKI KIKIKI 4 Install Plugin Management v v a Ei E o a a a x a 2 X a x a Upload File amp Install Download Package amp Install Tools Community Builder 1 2 Reorder Order 8 9 Configuration Results 1 15 of total 15 Figure 68 Plugin Management Joomla 1 5 X Q Publish Access Public Public Public Unpublish Type language templates templates templates templates templates templates user user user user user Edit Delete Select Type v Directory default language default cb core cb menu cb connections cb authortab cb simpleboardtab From this screen we see that plugins have various type characteristics Thus we have template plugins language plugins and user plugins The user plugins may either be core plugins menu plugins pms plugins or third party plugins Each one of these plugins may also have additional parameters that influence the appearance of functionality of the actual plugin A plugin may also have one or more tabs associated with it Page 141 of 181 Community Builder 1 2 8 1 Template Plugins You can see all your template plugins by selecting templates from the filte
116. ngs are e Field Name Users Per Page o Option set by populating a text field This field should be populated with a numeric value indicating the number of user list lines to display per page on all active User Lists The default number is 30 e Field Name Allow Link to Profile o Available options via drop down list Yes default Select this setting to instruct CB to display all users in active User Lists as hyperlinks to user profile pages Page 59 of 181 Community Builder 1 2 No Instruct CB not to use hyperlinked user items in active User Lists 3 4 User Profile Tab This section of the CB configuration options allows the Joomla Mambo driven CB suite website administrator to set various parameters that influence features related to the User Profile functionality of the CB suite The User Profile TAB view of the CB Configuration Manager panel should appear as illustrated in the following figure Current Setting Explanation Username Yes ow Set to Ves to allow the username to be changed If set to Mo then the username will not be editable after registration Fields validation in Admin Yes ow Set to Yes to make the User Management section in the administrator respect the fields validation required size etc settings of fields and set to No to ignore the fields validation in the admin user management Allow Access To Pick the group that you want to be able to view the profiles All users of that level and
117. nt Add New Article Artic iT m Pols _ List Management 4 Search Plugin Management gl uddelM Tools m Web Links b Configuration Media Manager Menu Manager Language mariage Uer manage Figure 4 CB Component Backend Menu Tree J 1 5 X Hopefully your chosen installation method will complete properly If not please refer to chapter 13 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 mod_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 For Joomla 1 0 X series and Mambo e Via the Administration panel using the Modules Install Uninstall selection followed by the specification of the location of the mod cblogin zip file on your local hard drive using the Browse button and then by clicking on the Upload File amp Install button Page 23 of 181 Community Builder 1 2 Hopefully your chosen installation method will complete properly and you will see something similar to the following figure see Figure 5 fa Upload module Success CB Login Used as the login module to be used with com_comprofiler Continue j Figure 5 CB Login Module Installation J 1 0 X If the installation completes properly you s
118. ntact Info title field With this method you can have multiple language support using JoomlaFish Mamblefish Page 92 of 181 Community Builder 1 2 4 1 1 Contact Info Tab Application The contact info TAB initially contains the basic information needed to authenticate a Joomla Mambo CB front end user In its initial state the contact info tab only appears when updating a CB profile You may however add new CB created fields to this tab in which case the contact info tab will also appear in the profile front end in non edit mode This is illustrated in the following Figure 34 were a field delimiter a date field a text field and a multi selection field is demonstrated Contact Info Articles Forum Blog Connections Personal Questions This section contains data regarding personal data about the user All questions must be answered my site Click here birth date 19 07 1958 Place of Birth USA Languages English areek Figure 34 Contact Info plug in Tab 4 1 2 Article Tab Application The article plugin tab displays all the articles published by the CB profile user A hyperlink is created over the title of the article that links the article tab row with the actual article Finally date and hits columns are also present This is illustrated in the following Figure 35 Page 93 of 181 Community Builder 1 2 Contact Info Articles Forum Blog Connections Date Title Wednesday 09 February 2005 DFT access Mond
119. ollowing the process outlined in Chapter 2 6 This item should of course be a published as Registered most likely in a User menu and for Joomla 1 0 X and Mambo series the URL should be index php optionzcom comprofiler amp task logout Page 28 of 181 Community Builder 1 2 For Joomla 1 5 X series you should select the Logout Action item illustrated in Figure 7 2 9 CB User List Menu Item Add a new Menu item named CB User List as a URL pointing to index php option zcom comprofiler amp task usersList This will eventually support the searchable user list functionality which will be addressed later on in this document see chapter 7 Depending on your CMS Joomla 1 0 X series Mambo series or Joomla 1 5 X series you will need to follow a slightly different process to accomplish this Menu item addition In Joomla 1 0 X and Mambo you add this new menu item by first selecting which menu you want to place this new item on e g Main menu or User Menu and then out the Name e g CB Lists and Link e g index php option com comprofiler amp task usersList fields The CB Lists menu item should be placed in the Main Menu or other public menu if you anticipate displaying member lists to guests non registered users In this case the actual CB Lists menu should be set to Public Otherwise the CB Lists menu item should be placed on some other non public menu e g User Menu and it should be published as Registe
120. ome Subject Welcome Email Show icons explanations Introduction text for registration Concluding text for Current Setting same as global allow registration site setting xl Yes z No Yes x No zl No E User Registration registration amp whatever registration amp whatever NAME Name of the User USERNAME Username of the User Registration UserList User Profile Images Moderation Connections Integration Explanation Whether to allow user registration as configured in global site configuration or through CB anyway Recommened setting only through CB set Y es here and No in global site setting Whether the password is autogenerated and emailed to the user Y es setting or if it is asked to the user on the registration page No setting default recommended Require all user registrations to be approved by an administrator Set yes to send an email to users upon registration with a confirmation link Allow to check if a username is available during registration Y ou need to be aware that even though this feature is protected under some circumstances it could be used for username guessing making password guessing easier This is an experimental feature not yet optimized for large sites test first WARNING your PHP system doesn t have function getmxrr installed and enabled As this is a Linux only function this is normal on Windows servers and email DNS and S
121. onment You can directly ftp the appropriate file to your root website folder and decompress it as explained in detail in the README UPGRADE txt file or if you re hosting environment does not permit you to do this you can manually decompress the appropriate file locally using for example 7zip to reveal the three folders administrator components modules that contain the necessary Page 32 of 181 Community Builder 1 2 CB files that must be updated Just use your favorite ftp client e g FireFTP FireFox plugin to upload these three folders over your root folder of your website Your ftp client should alert you asking you to permit over writing of existing files Just go ahead and authorize your client to over write all and the upgrade process will commence Do not worry only CB related files will be over written all other CMS related files will remain intact Once the CB expert update files have been uploaded you should immediately visit the CB Tools backend see chapter 9 and run all the CB Tools checks Specifically you should execute Check Community Builder Database This will identify any database upgrades that must take place and will prompt you to upgrade Check Community Builder User Fields Database This will identify any needed database upgrades related with your user fields and will prompt you to upgrade Check CB plugins database This will identify any database changes needed for your installe
122. open invitation for some It could contain a list of products I am looking for who knows I have no idea how I will use this are hopefully someone else will think of something better and give me some good ideas Well depending an the editor you have installed and activated for your site you should be able to upload pictures Or even input tables ear Expenses Income 2003 10 000 20 000 2004 20 000 40 000 Figure 55 About Me Tab front end Example Page 126 of 181 Community Builder 1 2 Forum settings Contact Info Mewsletters Personal Info Joornlapoalitan Card About Me Profile Book CB Profile Gallery This tab is comprised of one and only editor area field used by the users for whatever purpose they see fit Sample usage may include short biography my life purpose my ongoing projects my latest developments etc a A 4 aB ala eja aE h Format Font Size BEB 7 U is area may be used in the future to provide important mformation and announcements concerning my life and my interaction with this community t s really an open space area that should be viewed as the most important and possible upto date blog about myself I am not really sure how it should be organized or even how often it should be updated The better organized itis and maintained the more people will be visiting my profile to check up on this can imagine on some sites that this may contan very personal information or even an
123. open mitation for some It could contain a list of products I am looking for who knows T have no idea how I will use this are hopefully someone else wall think of something better and give me some good Use Shift Enter for a lt BR gt tag guidelines visible ah inzert i insert ak image page break iT B Figure 56 About Me Tab update mode Example Page 127 of 181 Community Builder 1 2 Type Editor Text Area Tab About Me p Name cb aboutme Title About me H J U sz Styles Format z Font Family i SE A Hm jn s EE d m g d i o 9B Lal 2 B lt x 2 cd B Use this text area field as you like to freely express yourself for whatever purpose you see appropriate field tip text or HTML Contact Image Pagebreak Readmore g BE J U sz gt Styles Format z Font Family S n amp mpm z sau T i E p Egonga ie mo 9 B Ld 2g x e 2 83 3 A few words about myself Default value Contact Image Pagebreak Readmore g Required No show on NUR Profile Ie mc Display field title in No Profile Searchable in users lists ves x User Read nbly m Show at Registration No Published Yes T hax Length 1000 Cols 60 Rows 15 Figure 57 About Me editor text area Field Example J 1 5 X Page 128 of 181 A Community Builder 1 2 7 Defining User Lists
124. ou will see a screen similar to the one illustrated in the following figure see Figure 6 Upload module Success CB Workflows Displays Notifications of pending actions for the moderator and connections functionality of Community Builder Continue Figure 6 CB Moderator Module Installation J 1 0 X 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 13 entitled Support for additional guidance Please note that at this time the module is inactive see how to activate it in chapter 2 11 As of 1 0 RC2 the CB Moderator module contains notification links to support the connections feature These links are of course activated or deactivated from the module backend parameters More about the CB Login module parameterization process is discussed in chapter 11 Page 25 of 181 Community Builder 1 2 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 2 6 Adding the CB Profile The CB component has been successfully installed in chapter 2 2 We must add the CB Profile item in the User Menu for registered Users and deactivate the original Joomla Mam
125. p down list Default variable width tabs Luna fixed width tabs osx works well on Mac computers and IE 4 5 2 osx webfx dark winclassic M ore Additional CB templates may be added at a later time via the plugin framework Actually there is a nice thread going here http www joomlapolis com component option com_joomlabo ard Itemid 38 func view id 10981 catid 13 limit 6 limitstart Oy e Field Name 2 columns layout widths o This field value is set by filling out a left subfield containing the width percentage used ina 2 column profile layout Initial value is 50 You need to experiment with this setting and your overall Joomla Mambo template e Field Name 3 columns layout widths o This field value is set by filling out left and right width subfields Default values are 32 each e Field Name Show empty tabs o Available options via drop down list Page 62 of 181 Community Builder 1 2 Yes This option forces the front end display of user defined tabs even if there is no content to display Prior to CB 1 2 tabs would only appear in profile front end mode if they had at least one published field with a populated value No This option basically emulates CB behaviour prior to CB 1 2 e Field Name Show empty fields o Available options via drop down list Yes This option forces the front end display of user defined fields even if there is no content populated in the field Prior to
126. pdated to show other pending approval images or a No Images to Process message appears in the screen If the image is approved no notification message is sent to the user 10 6 CB Moderator User Registration Handling Clicking on the User s URL link of the CB Moderator module see Figure 78 will take the moderator to the User Approval Rejection screen shown in the figure bellow Moderator User Approval Rejection User Email Date Registered Reject Comment P e snifer snifer amp pz2 pl 2006 05 10 12 58 10 x Approve Reject Figure 90 CB Moderator Module Pending Approval Processing J 1 0 X This screen allows the moderator to approve or reject sets of user registration requests by clicking on the Approve or Reject buttons Clicking on the Approve Page 162 of 181 Community Builder 1 2 button will activate the user account and send the user a welcome message as described in chapter 3 2 The moderator may click on the User column URL in the figure example this would be sniffer to review the application of the user by viewing the user profile In case the moderator decides to reject an application extra space is available so a Reject Comment may be given This is eventually included in a notification email that will be sent to the user A sample rejection email message is shown in the following figure From Registrar registrar yoursite com To user userdomain com Subject Site Name Your Registrat
127. pe password Tab Contact Info e Name params Title User Parameters Type userparams Tab Contact Info This predefined field is used to group the various CMS parameters that a user can set E g language setting locale etc Page 118 of 181 Community Builder 1 2 6 2 Sample of CB Defined Fields in CB Defined Tab In order to illustrate some of the capabilities outlined in the previous sections we have provided a number of real life examples implemented on our Joomlapolis com site The samples that follow refer to the Personal Info tab and the About Me tab of the profiles created on Joomlapolis The Personal Info tab in profile update mode looks like the following figure Figure 47 Forum settings Contact Info Newsletters Personal Info Jeomlapolitan Card About Me Profile Book CB Profile Gallery This tab contains personal information regarding the current Joomlapolitan city tate Ox county Ox Gender Male Female TEF Age Group Under 20 years old Between 31 and 35 Between 51 and 60 Between 81 and 90 Between 20 and 25 Between 36 and 40 Between 61 and 70 Over 90 years old Between 26 and 30 Between 41 and 50 Between 71 and 80 TE M English Russian German Arabic Danish italian French Arabic Japanese Greek Portuguese Finnish Spanish Chinese Dutch Swedish Norwegian Other Q x a8 PM to Registration Team Name of Site KarpathianTree Figure 47 Tab and Fields example Personal Info tab Page 11
128. played in the various columns shown in Figure 73 These include Name userid username email address group and last visit 10 2 Accessing the CB Moderator CB Workflow Module Installation of the CB Moderator CB Workflow module has been outlined back in chapter 2 4 This section describes the functionality present in this module depends on the group the user viewing it is in If the user viewing the module is Page 152 of 181 Community Builder 1 2 in the moderator group then the user is able to view up to 5 different event URLs Four of these potential event URLs are related with the moderator status of the user and the fifth one is related with the connections feature A moderator receives one of four types of email messages We have already seen one of these ACTION REQUIRED messages back in chapter 3 2 1 and Figure 15 The other three messages refer to e user requests for profile un banning e user reports against other profiles and e image approval activities Samples of these messages are given in the following three figures From Registrar registrar yoursite com To Moderator Group Subject Site Name Unban Request Pending Review A user has submitted a request to unban their profile Please login and take the appropriate action NOTE This email was automatically generated from Site Name http www yoursite com Figure 75 Moderator Notification Email for Image Pending Approval Actions From Re
129. plugin for your specific needs Also the forums on Joomlapolis have a dedicated area for language plugins All language plugins in the Plugin Manager area should be published see Figure 70 CB Language plugins are activated by the Joomla site language management area Also CB Langauge plugins are JoomlaFish ready so changing the language via front end Joomlafish module will automatically activate the appropriate CB Language w amp CB Plugin Manager install Plugin o e Ff Q Publish Unpublish Edit Delete Filter language 3 E Plugin Name nstalled Published Reorder Order A Access Type Directory bI Default language English A A 1 Public anguage default language Display amp 20 lt lt Start Prev 1 Next gt End gt gt Results 1 1 of total 1 Figure 70 CB Language Plugins J 1 5 X Page 143 of 181 Community Builder 1 2 8 3 User Plugins CB User plugins can be developed to extend the functionality of CB without compromising the core code A set of CB event triggers have been implemented in CB Core and a detailed plugin API has been documented see download area on Joomlapolis to assist third party developers to develop CB plugins The CB community has been very active in developing CB plugins that extend CB functionality These contributions may be found on the Joomlapolis download area on the forums and also on the Joomla Extensions site Additionally the CB Core Team is very active in releasing its own plugins Th
130. powered website via the administration panel by following the Components Community Builder User Management menu item The CB User Management page should be similar to the screenshot illustrated in the following figure Q7 B amp CB User Manager Q New Edit Delete Search Select Login State x Select Group i Select User Status i lt lt Start lt Prev 1 Next gt End gt gt EU Name UserName Logged In Group E Mail Registered Last Visit Enabled Confirmed Approved ID 1 _ test test test test Registered test jp com ibis eie ae Ris iae wf UU JO 3J IO U 32I 2 testertester tester testet Registered tester joomlapolis com es n esp d 4 A 4 3 help help Registered help jp com 4 author author author Author author jp com eR E CIE ARUM CARE Jf Jv 5 Nicholas G Antimisiaris admin wv Super Administrator nant joomlapolis com gie qais i A A Display 20 x lt lt Start lt Prev 1 Next gt End gt gt Results 1 5 of total 5 Figure 73 CB User Management Initial Screen J 1 5 X Vote As of CB 1 1 the CB User Management backend includes a column containing the Joomla Mambo user id see last column of Figure 73 From this interface authorized administrators may perform the following operations Page 149 of 181 Community Builder 1 2 e Monitor which applications have completed the email confirmation process Rows on this screen that have the X icon in the Confirmed column represent applications th
131. previous versions Should be used only by expert users closely following detailed instructions in README UPGRADE txt file included in distribution package Expert method upgrading also needs direct database modification via PhpmyAdmin applicable SQL scripts see README UPGRADE txt Page 17 of 181 Community Builder 1 2 e cb expert files only j 1 5 far gz This compressed file contains 3 folder hierarchies that can be used to upgrade previous installations on Joomla 1 5 X series without uninstalling previous versions Should be used only by expert users closely following detailed instructions in README UPGRADE txt file included in distribution package Expert method upgrading also needs direct database modification via PhpmyAdmin applicable SQL scripts see README UPGRADE txt e README NEW INSTALL txt The traditional text file that contains condensed information regarding the distribution functionality and quick installation instructions targeting new first time CB installations A must read and make sure you backup before you start e README UPGRADE txt This text file contains information that should guide you through upgrading a pre existing CB installation to the latest CB version An expert mode process is described to help you preserve existing plugins and parameters Must read carefully and of course backup first The latest CB distribution package may be downloaded either from the www joomlapolis com website see CB Te
132. process Page 51 of 181 Community Builder 1 2 3 2 1 Workflow Require Confirmation and Approval If the Require Email Confirmation field is set to YES and the Require Admin Approval is set the YES then the following workflow diagram is triggered Application Form Completed Y Action Required Message sent to CB moderators Application Form Submission CBWM 2 M Moderator Processes the completed and email confirmed Form Pending Approval Message sent to applicants email address CB Moderator Applicant Confirms decides to Email by clicking on the embedded URL link Accept T CB Moderator CB Moderator rejects the user enables the user and provides optional rejection reasoning Rejection Message Welcome Message sent to user containing sent to user optional rejection TW ou reasoni Reject Application Figure 12 Require Confirmation and Approval Workflow diagram Studying the above workflow process diagram we can observe two Community Builder Web Messages CBWM that are posted at specific states of the process Page 52 of 181 Community Builder 1 2 Specifically CBWM 1 is posted after successful meaning that all required fields have been populated submission of the online registration application which is initiated by clicking on the Send Registration button located at the end of the registra
133. pty Published e Initial value Yes Position e Initial value Middle Area Display Type e Initial value Raw display without title Page 85 of 181 Community Builder 1 2 e User Status tab This tab basically positions and configures the User status to be displayed when visiting a profile o Ithas the following tab parameter Hits e Initial value Online Status e Initial value Member Since e Initial value Last Online e Initial value Last Updated e Initial value Show in status e Initial value o Its Tob Details are Page 86 of 181 Title e Initial value Description e Initial value Published e Initial value Position e Initial value Display Type Show Show Show Show Show Date and time UE USER STATUS empty yes Right Side of Middle Area Community Builder 1 2 e Initial value Raw display without title Quick Message tab This tab basically positions the Quick Message text area to be displayed when visiting a user profile with a PMS component configured o It has the following tab parameters Show Tab Title e Initial value Yes Show Subject Field e Initial value Yes Width chars e Initial value 30 Height chars e Initial value 5 o Its Tab Details are Title e Initial value UE PMSTAB Description e Initial value empty Published e Initial value Yes Position e Initial value Righ
134. quire Admin Approval only If the Require Email Confirmation field is set to NO and the Require Admin Approval field is set to YES then the following workflow diagram is triggered Application Form Completed Application Form Submission O Zo 9 Cun Pending Approval Message sent to applicants email address Y Action Required Message sent to CB moderators w o0 CB Moderator Processes the completed Form CB Moderator decides to Reject Application Accept Application CB Moderator rejects the user and provides optional rejection reasoning CB Moderator enables the user Rejection Message sent to user containing optional rejection Welcome Message sent to user RM a reasoni Figure 19 Require Approval Only Workflow Diagram This workflow only generates one web message CBWM 5 which is posted after successful meaning that all required fields have been populated submission of message is illustrated in the following figure Page 57 of 181 Community Builder 1 2 Registration Complete Your registration requires approval Once approved you will be sent an acceptance notice to the e mail address you entered When you receive approval then you will be able to login Figure 20 CBWM 5 Message displayed after registration submission Meer note This mes
135. r drop down field in the CB Plugin Manager This is illustrated in Figure 69 db CB Plugin Manager Install Plugin Filter Plugin Name Default WinClassic WebFX OSX Luna L1 EE SEES E DLE T EDI Dark Display amp 20 lt lt Start lt Prev 1 Next gt End gt gt Installed Published Reorder Order A a A 4 A a of z z Z v A 1 lt 3 4 Results 1 6 of total 6 Figure 69 CB Template Plugins J 1 5 X CB Template plugins are loaded in the Ac Public Public Public Public Public Public Q Publish cess Unpublish B Edit Delete templates i Directory components com comprofiler plugin templates area Expert users can study the code in these existing templates and modify it to create different CB template themes As of CB 1 2 CB templates can be constructed to control many more aspects of the profile the tabs and the fields A multitude of id tags have been included and a php index file is now used to control the template Page 142 of 181 Community Builder 1 2 8 2 Language Plugins CB language files are installed as CB language plugins You can study the default language plugin located in the components com comprofiler plugin languages area and create your own language plugin First you should visit the download area on Joomlapolis com or the project area on the forge and see if someone has contributed a language
136. ration introductory html text and registration conclusion html text data may also be specified Front end editing of user profiles by moderation group Ability to delegate specific registration approval and maintenance image upload approval banning of offensive profiles from public display activities to moderators via a front end access module Creation of user specific lists based on CB fields e g directory listing etc Up to four columns may be specified for each list Each column may contain one or more field values List sorting options may be specified A filter may also be placed on a list by either using the basic filter constructor tool or populating the expert filter field WHERE clause of the list SQL select statement Specific list group access rights may be specified Front end user lists searching based on pre specified allowable to be searched fields Advanced and simple search modes available Page 12 of 181 Community Builder 1 2 e Private message system integration supported via preinstalled plugin UddeIM MyPMS IT free version plus Professional version JIM and MyPMS enhanced currently supported New systems may be supported via plugin API framework Private Messaging component must be downloaded and installed separately e All field values and parameters may accept UE language strings e Language support via plugin framework e Login Page URL e Logout Action URL CB 1 2 is a very mature product It
137. rd forum component and displays a list of forum posts made by the profile owner You are of course free to rename this fab if you want This tab assumes that the forum component has been installed o It has the following tab parameters Number of Posts to display e Initial value 10 Show all forum posts with paging e Initial value Only last ones Allow Search Function e Initial value disabled o Its Tab Details are Title e Initial value UE FORUMTAB Description e Initial value empty Page 89 of 181 Community Builder 1 2 Published e Initial value No Position e Initial value Main area below left middle right Display Type e Initial value Tabbed pane e The Blog tab This tab integrates with the Mamboblog component and displays all mamboblogs published by the profile owner You are of course free to rename this tab if you want This tab assumes that the mamboblog component has been installed o It has the following tab parameters Number of Blog entries to display e Initial value 10 Show all blogs with paging e Initial value Only last ones Allow Search Function e Initial value disabled o Its Tab Details are Title e Initial value UE BLOGTAB Description e Initial value empty Published e Initial value No Position Page 90 of 181 Community Builder 1 2 e Initial value Main area below left middle right Display Type e Initial value Tabbed pane e The Connection
138. rder to support multi language sites e Setting Name Enable Terms amp Conditions o Available Options via a drop down list Yes select this option if you want to present the registration applicant with the Terms amp Conditions of your website and verify that the conditions have been read No select this option if you don t want to present the registration applicant with the Terms amp Conditions of your website e Setting Name URL to Terms amp Conditions o Option set by populating a text field Page 50 of 181 If the Enable Terms and Conditions field is populated with YES then this field should be populated with the URL that must be used by CB to display the Terms amp Conditions content to the applicant This must be relative to your Joomla Mambo site E g index php option com content amp task view amp id 18 Y Note The actual content item should be marked as public otherwise the applicant will not be able to view it Community Builder 1 2 e Setting Name URL for first login visit o Option set by populating a text field This field when populated will redirect the user to this URL the very first and only time they login successfully to the site This may be used in various ways For example the field may contain index php option com comprofiler amp Itemid 8 which will cause the first time user to be redirected to his her profile page in order to complete additional fields not required in the registration
139. red Page 29 of 181 Community Builder 1 2 The process for Joomla 1 5 X series CMS instances is slightly different The menu selection aspect and logic is similar but in Joomla 1 5 X series you will see a new Internal Link item in the Community Builder component as illustrated in Figure 7 You need to select the Users lists item and continue the menu creation process When creating a menu item for CB User Lists in Joomla 1 5 X series you will also be able to specify two additional Basic Parameters as illustrated in Figure 8 Parameters Basic List id Searchmode only Show List b Parameters System Figure 8 User Lists Menu Item Basic Parameters in Joomla 1 5 X These extra parameters are used to specify a direct list for the menu to display and also the searchmode characteristics of the user list These options will become clearer after we have covered Chapter 7 2 10 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 This is accomplished by accessing the Site Module Manager from the Joomla 1 0 X Mambo Administration panel and selecting the Modules3 Site Modules menu item On Joomla 1 5 X installations you access the equivalent module manager by selecting Extensions Module Manager Make sure to verify that the CB Login module set for
140. release of CB and past or future releases can be found on Joomlapolis com The basic highlights of release 1 2 include e Compatibility with Joomla 1 5 X series in native mode e Compatibility with Mambo 4 6 2 e Many security problems have been addresses and fortified e Joomla Mambo ACL support for tabs e fieldname substitutions in titles and descriptions e Extended substitution functionality for delimiter fields e Fields now have default value capabilities e Integer and Image field types are now supported Page 15 of 181 Community Builder 1 2 Individual fields can now be marked as searchable for front end user list searching e User lists are now searchable in front end e Advanced and simple search options e HTML editor for descriptions in backend e fieldname substitutions also in user lists advanced filter box aka dynamic lists e Updated date field to permit age display on profile and age searching in user lists e Ajax email checker on registration form e Ajax username checker e API extended to support field type plugins e Login Page and Logout Action URLs 1 7 Current Document Version Note This document is always under development Many of the screenshots included in this document are taken from various CMS versions Most of these figure captions contain references to the actual CMS series or version used to generate them e g J 1 0 X or J 1 5 1 etc Also the integrity of the chapter references and figure
141. s tab This tab integrates the connections functionality released with the CB component and managed via the CB configuration connection tab in the backend panel Additional information about the Connection feature is available in chapter 4 1 5 o It has the following tab parameters Enable Paging e Initial value Yes Max entries shown per page e Initial value 10 o Its Tab Details are Title e Initial value UE CONNECTION Description e Initial value empty Published e Initial value No Position e Initial value Main area below left middle right Display Type e Initial value Tabbed pane Page 91 of 181 Community Builder 1 2 e The Newsletter tab This tab integrates with the Yanc component and allows users to manage their newsletter subscriptions from their CB profile The Yanc component must be installed for this tab to work and the Yanc plugin must be published o It has no tab parameters o Its Tab Details are Title e Initial value UE NEWSLETTER HEADER Description e Initial value UE NEWSLETTER INTRODCUTION Published e Initial value No Position e Initial value Main area below left middle right Display Type e Initial value Tabbed pane Vexpert s note You can use UE values as tab names or tab descriptions This will cause the CB code to look into the active language file to find the value of this string For example UE CONTACT INFO HEADER is set as the default value of the Co
142. s tab is associated with the CB Connections user plugin It basically positions the Connection Paths to be displayed when visiting someone else s profile in order to see how these 2 users are connected the connection path This tab is only active if the Display Connection Path variable is set to yes in the Connections tab of the CB configuration area o It has no tab parameters o Its Tab Details are Title e Initial value UE CONNECTIONPATHS Description e Initial value empty Published e Initial value Yes Position e Initial value Header above left middle right Display Type e Initial value Raw display without title e User Profile Page Title tab This tab basically positions the Profile Page Title to be displayed when visiting a user profile o It has one tab parameter User Profile Title Text e Initial value UE PROFILE TITLE TEXT o Its Tab Details are Page 84 of 181 Portrait tab Title Community Builder 1 2 e Initial value UE PROFILE PAGE TITLE Description e Initial value empty Published e Initial value Yes Position e Initial value Header above left middle right Display Type e Initial value Raw display without title This tab basically positions the Profile Portrait Avatar to be displayed when visiting a user profile o It has no tab parameter o Its Tob Details are Title e Initial value UE PORTRAIT Description e Initial value em
143. s that are visible in the user profile and are not read only see chapter 6 can be modified by the user from this page Clicking on the Update Your Image URL link located in the Edit menu of the User Profile Page will take the user to Submit a new Image for Upload A sample of such a page is shown in the figure that follows Page 165 of 181 Community Builder 1 2 Edit Your Details Submit a new Image for Upload Your image file can be maximum width x height size 200x500 100 KB Select file Browse Upload Choose one from the Image Gallery Confirm Choice Figure 93 Selecting of Uploading Image J 1 0 X From this page you can either upload an image from your local storage hard drive by pressing the Browse button and upload it to the website using the Upload button where it might have to wait for approval before it is viewable Only jpeg jpg gif or png type images are allowed The image file size and the dimensions are set via the parameters discussed back in chapter 3 5 Once the image is uploaded having passed the various validation checks file type file size and image dimensions and an approval is required the user will see a screen similar to the following figure Page 166 of 181 Community Builder 1 2 Community Edit nant Profile Page Hits 1 Online Status we ONLINE Member Since 053 2008 23 08 40 Last Online 05 30 2008 21 14 33 Last Updated 05 30 2008 23 15 01 Connections
144. sage is not hard coded You can open the default php file located in the default plugin language folder and change it to suit your specific needs The moderator group also receives an ACTION REQUIRED email message similar to the one shown in Figure 15 3 2 4 Workflow No Requirements If both the Require Email Confirmation and the Require Admin Approval fields are set to NO then the successful application one that completes all required registration fields is automatically approved and the applicant receives a Welcome Message A notification email message is also sent to the moderation Team Page 58 of 181 Community Builder 1 2 3 3 User Lists Tab This section of the CB configuration options allows the Joomla Mambo driven CB suite website administrator to set various parameters that influence the User List functionality of the suite The User List TAB view of the CB Configuration Manager panel should appear as illustrated in the following figure General Registration User List User Profile Images Moderation Connections Integration Current Setting Explanation Users Per Page 30 Humber of Users Per Page Allow Link to Profile Yes ow Select Yes to allow each row to link to the related users profile and No to prevent profile links on lists Figure 21 Configuration Manager User List TAB View J 1 5 X The fields that may be configured from this TAB along with some basic guidelines regarding available setti
145. sented upon successful logout Hide default This setting will suppress the javascript popup from being presented upon successful logout e Parameter Name Remember me checkbox o Available options via drop down list Show unchecked default This setting will cause the CB Login module to show an unchecked remember me option in the login form Show checked This setting will cause the CB Login module to show a checked remember me option in the login form Page 175 of 181 Community Builder 1 2 Hide unchecked This setting will cause the CB Login module to hide an unchecked remember me option in the login form Hide checked This setting will cause the CB Login module to hide a checked remember me option in the login form e Parameter Name Greeting o Available options via radio choices Yes default This setting will cause a welcome message to be displayed in the CB Login module after successful login No With this setting no welcome message will be displayed upon successful login e Parameter Name Name Username o Available options via drop down list Username default This setting will cause the CB Login module to use the username of the member in the successful login Greeting message if the Greeting parameter is set to show Name This setting will cause the CB Login module to use the Name of the member in the successful login Greeting message if the Greeting parameter is s
146. set by populating a text field Populate this text field with the maximum allowable height of an image expressed in pixels Default value is 500 e Field Name Maximum Image Width o Option set by populating a text field Populate this text field with the maximum allowable width of an image expressed in pixels Default value is 200 e Field Name Maximum Image Filesize in Kbytes o Option set by populating a text field Populate this text field with the maximum allowable size of an image file expressed in Kbytes Default value is 100 e Field Name Maximum Thumbnail Height o Option set by populating a text field Populate this text field with the maximum allowable thumbnail height of an image expressed in pixels Default value is 86 Image thumbnails are automatically created by the Image Software application e Field Name Maximum Thumbnail Width o Option set by populating a text field Page 68 of 181 Community Builder 1 2 Populate this text field with the maximum allowable thumbnail width of an image expressed in pixels Default value is 60 Image thumbnails are automatically created by the Image Software application 3 6 Moderation Tab This section of the CB configuration options allows the Joomla Mambo driven CB suite website administrator to set various parameters that influence Moderation related features supported by the CB suite The Moderation TAB view of the CB Configuration Manager panel should appear
147. setting instructs CB that front end editing of a user profile is only allowed by owner of profile CB Moderators and levels above Using this setting permits front end profile editing even avatar changing by CB Moderators Administrators and Super administrators only This setting permits front end profile editing by members of the Admin and Super Admin groups Super administrators only This setting permits members of the Super Administrator group to modify user profiles from the front end Allow Profile Banning o Available options via dropdown list Yes Permit moderators to ban specific user profiles if offensive usually an action taken as a result of a user report No Page 71 of 181 Community Builder 1 2 3 7 Connections Tab This section of the CB configuration options deals with the Connections tabs plugin and corresponding functionality In order for these parameters to be active the Connections plugin must be published in the CB Plugin Management backend area and the relevant Connect Tab must also be published in the CB Tab Management backend area The Connections TAB view of the CB Configuration Manager panel should appear as illustrated in the following figure Figure 30 General Registration User List User Profile Images Moderation Connections Integration Current Setting Explanation Enable Connections Ho Enabling this feature will alow your users to connect with one another This
148. ss 146 Figure 73 CB User Management Initial Screen J 1 5 X sssssus 149 Figure 74 User Management Edit User Screen J 1 5 X eseese 151 Figure 75 Moderator Notification Email for Image Pending Approval Actions 153 Figure 76 Moderator Notification Email for User Reports Actions 153 Figure 77 Moderator Notification Email for Image Pending Approval Actions 154 Figure 78 CB Moderator Workflow Module Operational View J 1 0 X 154 Figure 79 CB Moderator Module Handling User Reports J 1 0 X 155 Page 8 of 181 Community Builder 1 2 Figure 80 CB Moderator Module Reviewing Suspect User Profile Reported by Users J LOX EPOR RORIS 156 Figure 81 CB Moderator Banning a Profile J 1 0 X sss 156 Figure 82 CB Moderator Ban Report J 1 0 X sse 157 Figure 83 Banning Notification Email sent to Email Address of User J 1 0 X 157 Figure 84 User Access to his her Banned Profile J 1 0 X sss 158 Figure 85 CB Moderator Unban Profile Requests J 1 0 X sssss 159 Figure 86 CB Moderator Unbanning User Profiles J 1 0 X sss 160 Figure 87 Unbanning Notification Email sent to Email Address of User J 1 0 X En m 160 Figure 88 CB Moderator Module Image Approval Processing J 1 0 X 161 Figure 89 User Image Rejection Email Message J 1 0 X
149. sticky overlay User Group to allow access to o Available options via drop down list Selecting one will automatically allow access to all groups below E g If you select Author then all Editor Publisher and Public Backend groups are authorized Everybody All Registered Users gt Public Frontend Registered e Author ce Edit tOr gt Publisher Public Backend gt Manager Administrator Page 78 of 181 Community Builder 1 2 gt Super Administrator Once these tab related fields have been specified the Save icon will complete the creation of the new tab We may of course revisit the Tab Manager panel to edit an existing tab or reorder tab appearance on user profile pages Deletion of a Tab is also possible only if no fields are referenced in them or they do not belong to a plugin Using the CB Tools Load Sample Data option will create a new tab named Additional Info tab This is illustrated in the following figure Figure 32 Tab Details Title Title as wil appear on tab B 7 U Z Z Styes Faemat Femfamip EIE p X 44 83 0 9 HB Lal uA 2 H x x a a E Description This description appears only on user edit not on profile For profile text use delimiter fields Contact Image Pagebreak Readmore 4 Publish Ho Tabs and fields on profile are ordered as follows eae New items default to the last place Ordering can be
150. t Side of Middle Area Display Type e Initial value Raw display without title Page 87 of 181 Community Builder 1 2 e The Contact Info tab This tab contains the basic user account fields username email password etc and will definitely appear when updating your profile on the front end It will also appear on the front end if you have created a new field and added it under this tab You are free to rename this field if you want The CB admin may of course add new fields to this tab This tab cannot be unpublished o It has no tab parameters o Its Tab Details are Title e Initial value UE CONTACT INFO HEADER Description e Initial value empty Published e Locked value Yes Position e Initial value Main area below left middle right Display Type e Initial value Tabbed pane e The Articles tab This tab accesses a plug in to the Joomla Mambo authoring system and gathers all articles published by the profiles owner and displays them along with date and hit columns You are of course free to rename this tab if you want o It has no tab parameters o Its Tab Details are Title Page 88 of 181 Community Builder 1 2 e Initial value UE AUTHORTAB Description e Initial value empty Published e Locked value Yes Position e Initial value Main area below left middle right Display Type e Initial value Tabbed pane e The Forum tab This tab integrates with the Fireboard Joomlaboard Simpleboa
151. t influence image related features supported by the CB suite The Images TAB view of the CB Configuration Manager panel should appear as illustrated in the following figure General Registration i User List User Profile Images Moderation Connections Integration Path to ImageMagick Path to NetPBM Image Software Image Allow Image Upload Always resample avatar uploads Use Image Gallery Max Image Height Max Image Width Max Image Filesize in Kilobyte Max Thumbnail Height Max Thumbnail Width auto GDZ library esl 500 5 200 2000 85 Explanation Directory path to ImageMagick ending with a Or leave auto for auto detection for most current Linux installation directories Directory Path to NetPBM ending with a Or leave auto for auto detection for most current Linux installation directories ImageMagick Mot installed HetPBM Mot installed GD1 library Not installed GODZ library Auto detected bundled 2 0 28 compatible Set to rez if you want registered users to have an image manageable through their profile Set to res if you want registered users to be able to upload an image Resampling avatar uploads adds security for the users browsing the website but only ImageMagic will keep animated GIFs animated Set to Yes if you want registered users to be able to choose an image from a Gallery Figure 28 Configuration Manager Images TAB Vi
152. ters allowed in the field o Cols The number of character columns of the text editor box o Rows The number of character rows of the text editor box Integer Number These fields are one row height fields that accept text input that must correspond to an integer number Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field Page 111 of 181 Community Builder 1 2 o Size This is the number of characters that are shown in the field box o Max Length This is the number of characters allowed in the field o Field Specific Parameters Minimum value allowed Maximum value allowed Forbidden values at registration Forbidden values in user profile edits Authorized input Perl regular Expression Error in case of invalid input if Authorized input is set to Custom Perl regular expression e Radio Button The radio button type fields are similar to the dropdown type fields The available option values are presented in a radio button view instead of a drop down view Additionally when a field of this type is defined the following parameters are also allowed and further characterize the field o Size The value in this field is used to specify the width in characters default 40 chars of the table that controls the spread of radio options o Cols This value defines the number of columns the radio options should occupy when they are render
153. text Profile edit link text Private Messaging System Private Messages Notification Connections Notification HTTPS encrypted login register and lost password CB Plugins integration Vertical w Default 1 n m m m m m E index php Hide Show Hide Show 14 14 Icon only Y loons T Hide Show Hide Show Show unchecked C No ves Username Show always Defaut Mo system installed Do not show Do not show same as page default No Figure 96 CB Login Module Parameters J 1 5 X Page 170 of 181 Community Builder 1 2 The CB Login module parameters that may be configured in the CB Login module along with some basic guidelines regarding available settings are e Parameter Name Module Class Suffix o This parameter is configured by filling in a desired suffix for your css class This allows individual module styling your template designer should know what to do with this e Parameter Name Module orientation o Available Options via a drop down list Vertical default Use this setting if your module position is designed to accommodate a vertical layout Horizontal Use this setting if your module position is designed to accommodate a horizontal layout e Parameter Name Display type o Available options via a drop down list Default This setting will present a default login layout were each relevant fiel
154. tion form This web page message is illustrated in the following figure Registration Complete Your registration requires approval and email confirmation Please follow the confirmation steps sent to you in email Once approved you will be sent an acceptance notice to the e mail address you entered When you receive approval then you will be able to login Figure 13 CBWM 1 Message displayed after registration submission The second message CBWM 2 appears in the applicant s browser after the applicant clicks on the confirmation URL included in the Pending Approval email message This web page message is illustrated in the following figure Thank you for confirming your Email Address Your account requires approval by a moderator You will receive an email with the outcome of the review Figure 14 CBWM 2 Message displayed after successful email confirmation Now that the new applicant has confirmed the given email address the moderators will receive an ACTION REQUIRED email message so they can continue the registration process A sample message is shown in the next figure Page 53 of 181 Community Builder 1 2 From Registrar registrar yoursite com To Moderator Group Subject ACTION REQUI RED New User Registration Pending Approval A new user has registered at http www yoursite com and requires approval This email contains their details Name Applicants name email newuser hissite com Username n
155. to this setting and present the login form using the username email address and password fields Email With this setting the CB login authentication is performed using the primary email address field The CB login module will adjust to this setting and present the login form using the email address and password fields Community Builder 1 2 3 2 Registration Tab This section of the CB configuration options allows the Joomla Mambo driven CB suite website administrator to take control of one of the most powerful features of the CB suite the registration process Careful planning and organization of the registration process is a key ingredient to any community building task The parameters on this TAB allow us to enable and customize one of the four available registration workflow processes These workflow processes are illustrated as diagrams Figure 12 Figure 16 Figure 19 in chapters 3 2 1 3 2 2 3 2 3 3 2 4 The Registration TAB view of the CB Configuration panel should appear as illustrated in the following figure Figure 11 Page 43 of 181 Community Builder 1 2 General Allow User Registration Autogenerate random registration password Require Admin Approval Require Email Confirmation Ajax Username checker Ajax Email checker Show login on registration page Registration Email Name Registraton Email Address Registration Reply To Email Address Pending Approval Subject Pending Approval Email Welc
156. ups are authorized Everybody All Registered Users Page 69 of 181 Community Builder 1 2 gt Public Frontend gt Registered gt Author gt Badrtotrt gt Publisher Public Backend gt Manager Administrator gt Super Administrator e Field Name Moderator Approve Users o Available options via dropdown list e Field Name Yes This option is used to instruct CB to allow moderators to approve new applicants No Send Moderators Email o Available options via dropdown list Yes Instruct CB to send email notification message to moderators e g action required messages when a new application is pending No M ue You can manually over ride this setting on an individual user basis by setting the Receive Moderator Emails setting in the Contact Info tab of a user in the CB User Management backend area e Field Name Allow User Reports o Available options via dropdown list e Field Name Page 70 of 181 Yes Allow users to submit reports against other users for inappropriate user profiles see chapter 7 3 No Require Upload Image Approval Community Builder 1 2 o Available options via dropdown list Field Name Yes Require all uploaded images 1o be approved by a moderator before allowed fo appear on a user profile page No Allow Moderators to Edit User Profiles o Available options via dropdown list Field Name No default Using this
157. uration setting and to allow front end registrations applications Whore Recommended settings if front end applications are desired you should disallow them in the Joomla Mambo global site parameter and use the yes independently of global site setting option above e Setting Name Autogenerate random registration password o Available Options via a drop down list Yes Selecting Yes will instruct CB to automatically generate a password for the applicant No default e Setting Name Require Admin Approval o Available Options via a drop down list Page 45 of 181 Community Builder 1 2 Yes Selecting YES will instruct the CB suite to enable a registration workflow that requires the administrator or authorized moderators to manually approve all user applications see chapters 3 2 1 and 3 2 3 No Selecting NO will instruct the CB suite to enable a registration workflow that does not require manual approval by authorized administrators see chapters 3 2 2 and 3 2 4 e Setting Name Require Email Confirmation o Available Options via a drop down list Yes Selecting YES will instruct the CB suite to enable a registration workflow that requires email address confirmation see chapters 3 2 1 and 3 2 2 No Selecting NO will instruct the CB suite to enable a registration workflow that does not require email address confirmation see chapters 3 2 3 and 3 2 4 e Setting Name Ajax Username checker This is an
158. y Builder 1 2 10 5 CB Moderator Handling of Image Approval Requests Clicking on the Image s URL link of the CB Moderator module see Figure 78 will take the moderator to the Moderate Images screen shown in the figure Figure 88 bellow Moderator Moderate Images tester v vxo fi Approve Reject Figure 88 CB Moderator Module Image Approval Processing J 1 0 X This screen allows the moderator to view all pending approval images in this case the Visa MasterCard Donate icon and either approve or reject the image by pressing the Approve or REJECT button The moderator may also approve or reject the uploaded image by clicking on the v or X icons Additionally from this screen the moderator may review the profile of the user requesting approval for the image by clicking on the E icon and also ban the user profile by selecting the icon If the REJECT button is selected the user will receive a rejection message like the one outlined in the following figure Figure 89 Page 161 of 181 Community Builder 1 2 From Registrar registrar yoursite com To user userdomain com Subject Site Name Image Rejected Your image has been rejected by a moderator Please login and submit a new image NOTE This email was automatically generated from Site Name http www yoursite com Figure 89 User Image Rejection Email Message J 1 0 X Additionally after the REJECT or Accept button is pressed the screen is u
159. yed during the install process to inform you regarding the overall process If all complete properly you should be able to follow the 2 step installation progress as illustrated in the following two figures Page 20 of 181 Community Builder 1 2 o Install Component Success Joomla Mambo Community Builder 1 2 RC beta 10 native for Joomla 1 0 0 1 0 15 1 5 3 and Mambo 4 5 0 4 6 4 POWERED BY COMMUNITY TDI Copyright 2004 2007 MamboJoe JoomlaJoe Beat 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 Derivate work must prominently duly acknowledge original work and include visible online links Official site v v w joomlapolis com Installation Process Automatic database upgrade to current version applied successfully Click to Show details Core CB database upgrades done If all lines above are in green database upgrade completed successfully Otherwise please report exact errors and queries to forum and try checking database again in components community builder tools check database WAIT PLEASE DO NOT INTERRUPT INSTALLATION PROCESS PERFORMING SECOND INSTALLATION STEP UNCOMPRESSING CORE PLUGINS If this screen stays for over 2 minutes please click here to continue next and last installation step Figure 1 CB Component Installation Messages for first step J 1 5 X

CB User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents