cbqspro_guide_1.5.pdf

17
Joomla 2.5/3.0 CB Quickstart PRO Version 1.5 Quick Guide document version 1.5 [build 7] – 28.January.2013 Copyright – No portions of this manual may be reproduced or redistributed without the written consent of the author! Author: Nick A. ([email protected])

Transcript of cbqspro_guide_1.5.pdf

  • Joomla 2.5/3.0

    CB Quickstart PRO Version 1.5

    Quick Guide

    document version 1.5 [build 7] 28.January.2013

    Copyright No portions of this manual may be reproduced or redistributed

    without the written consent of the author!

    Author: Nick A. ([email protected])

  • CB Quickstart PRO 1.5 Guide - Table of Contents

    Page 2 of 17

    Table of Contents

    1 Introduction ..................................................................................................................... 4 1.1 Whats it all about .................................................................................................... 4 1.2 Acknowledgements, Credits and Copyrights ........................................................... 5 1.3 Compatibility and Prerequisites ............................................................................... 5

    2 Installation ...................................................................................................................... 6 3 After Installation Inspection ............................................................................................ 7 4 Extra Documentation, Resources and Support ............................................................ 17

  • CB Quickstart PRO 1.5 Guide - Table of Figures

    Page 3 of 17

    Table of Figures

    Figure 1: CB Quickstart PRO package installation .............................................................. 6 Figure 2: CB Admin Navigation menus ................................................................................ 8 Figure 3: CB Quickstart PRO on empty Joomla 2.5 site ...................................................... 9 Figure 4: Preconfigured user profiles ................................................................................. 10 Figure 5: CB User list created for you ................................................................................ 11 Figure 6: CB Plugins installed for you ................................................................................ 12 Figure 7: CB Tabs configured for you ................................................................................ 13 Figure 8: Modules installed and positioned for you ............................................................ 14 Figure 9: CB Menu with related items configured for you .................................................. 14 Figure 10: CB Facebook Connect needs to be enabled and configured ........................... 15 Figure 11: CB Twitter needs to be enabled and configured ............................................... 15 Figure 12: Joomla plugins installed from CB Quickstart PRO ........................................... 16 Figure 13: Joomla CB Serahc plugin configuration ............................................................ 16

  • CB Quickstart PRO 1.5 Guide

    Page 4 of 17

    1 Introduction

    This document describes the basic functionality and key features of the Joomla 2.5 / 3.0

    Community Builder Quickstart PRO package along with the basic steps a Joomla 2.5.x

    /3.0.x website administrator should take to install the package and perform basic

    configuration actions needed to have the features blend in with the website template and

    menu structure.

    With the CB Quickstart PRO package you can quickly add social networking functionality

    and user profiles on your Joomla 2.5/3.0 website. CB and preselected add-ons will be

    installed and enabled for you and all that remains for you to do is to adjust the installation

    so it fits in with your website template and your menu structure. This guide will help you do

    this.

    1.1 Whats it all about

    Community Builder (CB) is the most popular and flexible social community networking

    solution for all versions of Joomla! (2.5/3.0 with ACL support, 1.5 and 1.0 series).

    With a growing 450,000+ member strong Joomlapolis community, for over 9 years now CB

    is the most widely used (over 2,500,000 public installations according to Google search)

    social networking solution. CB is FREE and has always been GPL and allows you to

    create your own social community oriented website on Joomla.

    You can learn more about CB here:

    http://extensions.joomla.org/extensions/clients-a-communities/communities/210

    http://www.joomlapolis.com/community-builder

    CB is extremely flexible and has many great features that can be configured in order to

    support special use cases instead of just creating a Facebook look alike site.

  • CB Quickstart PRO 1.5 Guide

    Page 5 of 17

    There are also many extra add-ons that can be installed and configured on top of CB in

    order to provide addional functionality and features. Most of these add-ons are offered as

    part of paid membership subscription offered on Joomlapolis:

    http://www.joomlapolis.com/memberships

    The CB Quickstart PRO package is available to Professional and Developer members. It is

    a single installable package for Joomla 2.5/3.0 that will install CB and preselected add-ons

    (a total of 23 separate entities) and enable everything for you.

    1.2 Acknowledgements, Credits and Copyrights

    The CB Quickstart PRO package is released under GPL v2.

    This document is not released under GPL and no reproduction or distribution may take

    place without the authors permission.

    1.3 Compatibility and Prerequisites

    Version 1.5 of CB Quickstart PRO is compatible with Joomla 2.5 and Joomla 3.0. You

    cannot install it on other Joomla versions.

    Regarding server environments CB Quickstart PRO 1.5 has the following

    required/recommended infrastructure:

    PHP upload_max_filesize parameter and the post_max_size parameter must be set to at least 8M (actual package is 6.2M).

    PHP version 5 or better (PHP version 5.2+ recommended)

    MYSQL 5.0 or better required.

    Relevant articles on Joomlapolis that might assist you with the above are:

    http://www.joomlapolis.com/support/tutorials/95-installation/18196-checking-your-

    php-settings

    http://www.joomlapolis.com/support/tutorials/95-installation/18200-checking-your-

    php-memory

  • CB Quickstart PRO 1.5 Guide

    Page 6 of 17

    2 Installation

    Installing the CB Quickstart PRO package is really simple.

    From your Joomla 2.5 / 3.0 Extensions Extensions Manager area just install the single

    CB Quickstart PRO package you downloaded from Joomlapolis.

    Figure 1: CB Quickstart PRO package installation

    If everything progresses successfully you should see an image similar to Figure 1 (please

    note that the success box may have more items that you will need to scroll to see).

    If you see any errors at all in the right column of your screen, then first try installing once

    again and if errors persist then start a new forum thread on the Professional support forums here:

    http://www.joomlapolis.com/forum/153-professional-member-support

    and a CB Team specialist will address it as soon as possible (same/next business day).

  • CB Quickstart PRO 1.5 Guide

    Page 7 of 17

    As you can see from Figure 1 the following have been installed for you:

    CB component

    CB Login module

    CB Workflows module

    CB Online module

    CB Bootstrap template plugin

    CB Activity plugin

    CB Activity module

    CB Invites plugin

    GroupJive plugin (10 total)

    GroupJive module

    CB ProfileBook plugin

    CB Latest PB entries module

    CB Profile Gallery plugin

    CB Profile Gallery module

    CB Facebook Connect plugin (not enabled you need to enable and configure)

    CB Twitter Connect plugin (not enabled you need to enable and configure)

    CB Captcha plugin

    CB Video field (you need to create new video fields from CB Field Manager)

    CB File field (you need to create new file fields from CB Field Manager)

    CB Rating field (you need to create new file fields from CB Field Manager)

    CB Latest views plugin

    CB Core redirect Joomla 2.5/3.0 plugin

    Joomla search plugin for CB (might need extra configuration for your CB fields)

    Joomla author plugin to link article authors back to their CB profiles

    Joomla search plugin for GroupJive

    3 After Installation Inspection

    Once you complete your CB Quickstart PRO package installation and refresh your Joomla

    2.5/3.0 administration area you will see the CB Admin Navigation module configured and

    enabled for you as shown in Figure 2.

  • CB Quickstart PRO 1.5 Guide

    Page 8 of 17

    Figure 2: CB Admin Navigation menus

    You should note that in addition to the Community Builder and GroupJive drop-down

    menus a third Paid Subscriptions menu will appear if you have installed the CBSubs

    Paid Subscriptions Membership Management solution from Joomlapolis.

    If you are installing CB Quickstart PRO on a clean (no content) Joomla 2.5/3.0

    environment you should see your website frontpage similar to Figure 3.

  • CB Quickstart PRO 1.5 Guide

    Page 9 of 17

    Figure 3: CB Quickstart PRO on empty Joomla 2.5 site

    These modules have been published to position-7 based on the default Joomla template. If your website has a different template then you might need to reposition these to fit in

    with your environment. See Figure 8 for module positioning.

  • CB Quickstart PRO 1.5 Guide

    Page 10 of 17

    Your user profiles have been configured with the pre-selected add-ons and are ready for

    your users as illustrated in Figure 4.

    Figure 4: Preconfigured user profiles

  • CB Quickstart PRO 1.5 Guide

    Page 11 of 17

    Figure 5: CB User list created for you

    As illustrated in Figure 5, a users list has already been created and configured for you.

    You can reference the CB Detailed documentation to see how you can create your own

    user list or you can modify the one that has already been created for you (CB User List

    Manager area).

  • CB Quickstart PRO 1.5 Guide

    Page 12 of 17

    Figure 6: CB Plugins installed for you

    In Figure 6 you see all the CB Plugins that have been installed for you as part of the CB

    Quickstart PRO package. Please note that there are some plugins that have not been

    enabled. These are:

    Forum Integration (you need to install Kunena first and then enable/configure)

    CB Facebook Connect (you need to configure a Facebook application and then

    configure see Figure 10 for instructions)

  • CB Quickstart PRO 1.5 Guide

    Page 13 of 17

    CB Twitter (you need to configure a Twitter application and then configure see

    Figure 11 for instructions)

    CB GroupJive Forums (you need to install Kunena first and then enable)

    Figure 7: CB Tabs configured for you

    As you can see in Figure 7 the Forum tab has not been enabled for you as you need to

    have Kunena installed on your website first.

  • CB Quickstart PRO 1.5 Guide

    Page 14 of 17

    Figure 8: Modules installed and positioned for you

    Figure 9: CB Menu with related items configured for you

  • CB Quickstart PRO 1.5 Guide

    Page 15 of 17

    Figure 10: CB Facebook Connect needs to be enabled and configured

    Figure 11: CB Twitter needs to be enabled and configured

  • CB Quickstart PRO 1.5 Guide

    Page 16 of 17

    Figure 12: Joomla plugins installed from CB Quickstart PRO

    Figure 13: Joomla CB Serahc plugin configuration

  • CB Quickstart PRO 1.5 Guide

    Page 17 of 17

    4 Extra Documentation, Resources and Support

    The CB Quickstart PRO package is just one of the benefits you get as a Professional or

    Developer member on Joomlapolis.

    The following resources will help you maximize your CB Quickstart PRO experience:

    CB Detailed documentation

    Can be downloaded from the Advanced download area on Joomlapolis

    CB Facebook documentation

    This is included in the CB Facebook distribution (downloaded from Advanced

    download area)

    CB Twitter documentation

    This is included in the CB Twitter distribution (downloaded from the Advanced

    download area)

    CB Profile Gallery documentation

    This is included in the CB Profile Gallery package (downloaded from Advanced

    download area)

    Please note that as a Professional/Developer member you can also access our CB

    Packager page on Joomlapolis:

    https://www.joomlapolis.com/downloads/cb-package-builder

    On this page you can manually select all the CB Quickstart PRO packages and install it

    over your existing CB Quickstart PRO installation in order to upgrade add-ons that have

    maintenance releases.

    If you have any issues or questions please post to the Professional or Developer Support

    forums on Joomlapolis and a specialist will assist you asap (same/next business day).