Documentation

Configuration

Print

Overview

Community Builder Configuration interface.

Description

In this screen you can configure core settings of Community Builder.

How to Access

You can access the Community Builder Configuration page by clicking on the top menu bar Components → Community Builder → Configuration or selecting Community Builder → Configuration.

Screenshot

configuration

Details

The Community Builder Configuration page contains core parameter settings organized in the following tabs:

  1. General. Has general purpose parameter settings.
  2. Registration. Lets you configure the registration process.
  3. User Profile. Configuration parameters for user profiles.
  4. Images. Parameters that deal with image handling.
  5. Moderation. How moderation processes are configured.
  6. Connections. Connections feature parameter settings.
  7. Integrations. Various integration parameters.

 

General tab

The General tab has the following parameters:

  1. Name Style. Lets you select how user names will be styled based on following options:
    1. Single Name Field
    2. First and Last Name Fields
    3. First, Middle and Last Name Fields
  2. Name Format. How to display the Formatted Name field (with Name Style applied)  based on following options:
    1. Name Only
    2. Name (Username)
    3. Username Only
    4. Username (Name)
  3. Date Format. Date format selection for Community Builder date fields.
  4. Time Format. Time format selection for Community Builder datetime fields.
  5. Calendar Type. Choose which calendar you would like to use for date fields based on following options:
    1. Drop-down, with Popup Calendar
    2. Drop-down, without Popup Calendar
    3. Popup Calendar
  6. Email Handling. Choose how to handle Primary Email Address (email) field:
    1. Display Email Only
    2. Display Email with Mail-To Link
    3. Display Link to Email Form
    4. Do Not Display Email
  7. Public Email Form. Choose if Primary Email Address form (see previous parameter) is publicly accessible. 
  8. Emails Sent From. Choose how sent from property or sent emails should appear based on following options:
    1. User Email Address
    2. Admin Email Address with Reply-To User Email Address
  9. Email Links. Choose if email fields (not primary email address field) should be linked to email address or not.
  10. Website Links. Choose if website fields should be linked to website field URL or not.
  11. Online Status. Choose if user online status should be displayed or not.
  12. Field Icons. Choose which field icons shoulf be shown during editing. Following options are available:
    1. No Icons
    2. Only Required Icon
    3. Only Profile and No Profile Icons
    4. Only Required and Profile Icons
    5. Only Info Icon
    6. Only Info Text
    7. Only Required and Info Icons
    8. Only Required Icon and Info Text
    9. Only Profile and Info Icons
    10. Only Profile Icons and Info Text
    11. All Icons (Required, Profile and Info)
    12. All Icons (Required and Profile) and Info Text
  13. Login Method. Choose how users should login when using CB Login module and Login form. Following options are available:
    1. Username
    2. Username of Email Address
    3. Email Address
    4. Username, Email Address, or CMS Authentication Plugins

 

Registration tab

The Registration tab has the following parameters:

  1. Allow User Registration. Choose if registration access should be same as the CMS or allow registration regardless of CMS settings. Recommended to set Yes to be independent of CMS and turn off registration within the CMS settings. Available options are:
    1. Same as CMS "allow registration"
    2. Yes, independent of CMS "allow regostration"
  2. Generate Registration Password. Yes/No selection to auto-generate passwords for user during registration process.
  3. Admin Approval. Yes/No selection to require administrative approval from CB Moderators for each frontend registration.
  4. Email Confirmation. Yes/No selection to require email confirmation (via confirmation link) for each frontend registration.
  5. Ajax Username Checker. Turn on or off the ajax username checker.
  6. Login on Registration. Choose if login form should be displayed on registration form.
  7. Registration Email Name. The email name to use when sending emails for the registration workflow process.
  8. Registration Email Address. The email address to use to send emails during the registration workflow process.
  9. Registration Reply-To Email Address. The Reply-To email address for the registration process email messages.
  10. Registration Email HTML. Enable HTML messages for registration process.
  11. Pending Email Subject. The subject of the pending approval email message. CB field substitutions are supported.
  12. Pending Email Body. The body of the pending approval email message. CB field substitutions are supported.
  13. Welcome Email Subject. The subject of the welcoming email sent after successful registration process completion.
  14. Welcome Email Body. The body of the welcoming email sent.
  15. Registration Layout. The layout to be used on the registration form. Available options are:
    1. Flat
    2. Tabbed
    3. Step by Ttep
  16. Registration Title Image. Choose image for registration form canvas. Dropped down field options are populated with image filenames stored in the images folder.
  17. Registration Header. Input the text (HTML supported) message to display above the registration form.
  18. Registration Footer. Input the text (HTML supported) message to display below the registration form.
  19. First Login Redirect. Input the URL to redirect user after very first login. Default value is: index.php?option=com_comprofiler

 

Screenshot

configuration-registration

User Profile tab

The User Profile tab has the following parameters:

  1. Username Edit. Select Ye/No to allow users to change their username.
  2. Username Fallback. Choose which field to use as username if username field is not present during form storage.
  3. Fields Validation in User Management. Select Yes/No if backend admin editing of user profiles should also enforce required CB fields.
  4. Profile View Access Level. Select the View Access Level required for profile viewing.
  5. Maximum Emails per Hour. Input maximum emails per hour a single user is allowed to send.
  6. Maximum Hits Interval in Minutes. Input minumum interval in minutes for profile viewing calculations.
  7. Template. Select the Community Builder template.
  8. Template Output. Select the output method for template. Options are:
    1. Divs
    2. Tables
  9. 2 Column Layout Left. Input percentaage of left column width for 2-column layout.
  10. 2 Column Layout Right. Automatically calculated.
  11. 3 Column Layout Left. Input percentage of left column width for 3-column layout.
  12. 3 Column Layout Middle. Automatically calculated.
  13. 3 Column Layout Right. Input percentage of right column width for 3-column layout.
  14. Show Empty Tabs. Choose if empty tabs should be displayed in frontend profiles.
  15. Show Empty Fields. Choose if empty fields should be displayed in frontend fields.
  16. Empty Field Text. Input the text that should appear when displaying empty fields.
  17. Allow CMS User Parameters. Choose is users can edit their CMS parameter fields (frontend language, default editor, etc.).
  18. Profile Edit Layout. Choose the layout to be used during frontend profile editing. Available options are:
    1. Flat
    2. Tabbed
  19. Profile Edit Icon Legend. Choose how to display profile edit icons. Options are:
    1. Hidden
    2. Top
    3. Bottom
    4. Top and Bottom
  20. Exclude Tags from Filtering. Input space separated HTML tags that should not be stripped during profile rendering.

Screenshot

configuration-user-profile

Images tab

The Images tab has the following parameters:

  1. Image Software. Choose the software to use for image processing. Options are automatically populated based on PHP configuration.
  2. Always Resample Image Uploads. Choose if images uploaded should be resampled.
  3. Default Maximum Image Height. Default maximum image height in pixels. Can be over-ridden on an image field basis.
  4. Default Maximum Image Width. Default maximum image width in pixels.
  5. Default maximum Image Filesize. Default maximum image filesize in kilobytes.
  6. Default Maximum Thumbnail Height. Default maximum thumbnail image height in pixels.
  7. Default Maximum Thumbnail Width. Default maximum thumbnail image width in pixels.
  8. Maintain Aspect Ratio. Choose how aspect ration should be maintained during image resizing. Options are:
    1. Yes
    2. Yes, with Cropping
    3. No

 

Screenshot

configuration-images

Moderation tab

The Moderation tab has the following parameters:

  1. Moderators View Access Level. Select the view access level required for CB moderators.
  2. Moderator Approve Users. Select if moderators can approve user registrations.
  3. Send Moderators Email. Choose is moderators should be sent notification emails for pending actions.
  4. Allow User Reports. Choose is users are allowed to sumbit reports against other users.
  5. Require Upload Image Approval. Choose if uploaded images require approval before appearing in profiles. Can be over-ridden on an image field basis.
  6. Allow Moderators to Edit User Profiles. Choose if moderators can edit user profiles.
  7. Allow Profile Banning. Choose is profile banning is enabled.

 

Screenshot

configuration-moderation

Connections tab

The Connections tab has the following parameters:

  1. Enable Connections. Yes/No field to enable the connections functionality.
  2. Display Type. Select the display type of connections. Options are:
    1. Public
    2. Private
  3. Display Connection Path. Choose is the connections path should be displayed between two users.
  4. Mutual Consent. Select if connections need to be mutually approved or not.
  5. Notification Method. Choose notification method to be used for connection workflow. Options are:
    1. None
    2. Email
    3. PMS
    4. PMS and Email
  6. Cross Connections. Choose if connections are bidirectional or single direction.
  7. Connection Types. Enter the connection types you want.

 

Screenshot

configuration-connections

Integrations tab

The Integrations tab has the following parameters:

  1. Translations Highlighting. Translations highlighting tool can be used to identify and debug Community Builder translation strings. Available options are:
    1. No
    2. Text Markers
    3. HTML and Text Markers
    4. Markers and List Untranslated Strings
    5. Markers and List All Strings
  2. Spoof Checking. Choose if anti-spoof session checking should be used or not. 
  3. Version Checking. Choose is version checking should be automatic or manual.
  4. Twitter Bootstrap. Choose if Twitter bootstrap CSS should be loaded from Community Builder template automatically or not.
  5. Fontawesome. Choose if Fontawesome CSS should be loaded from Community Builder template automatically or not.
  6. jQuery. Choose if jQuery should be loaded from Community Builder automatically or not.
  7. Show Footer. Shows or hides powered by footer. Removal plugin must be present in order to enable removal setting.

Screenshot

configuration-integrations

Toolbar

configuration-toolbar

Quick Tips

TBS

Related Information

In addition to this online reference it is highly recommended that
you download the latest CB Primer Book here!