          # # - GROUPJIVE - # #



GroupJive is a component for the Joomla! Content Management System.

To use GroupJive, Community Builder -OR- Community Builder Enhanced
must be present in your Joomla! installation.

GroupJive is currently integrating with the following Joomla!
software and components:

+ Joomla! 1.0.13 stable
+ Community Builder 1.1 stable
+ Community Builder Enhanced
+ FireBoard 1.0.2 RC2+ or SVN builds
+ Personal Messaging (various PMS components)
+ EventList 0.8.10+ (see readme_eventlist.txt in this package)


!! GroupJive is "not" compatible with current versions of Mambo. !!

!! Please post feedback and sBUG report to http://joomlacode.org/gf/project/groupjive !!



- - - - - - - -  READ ME  - - - - - - - -
*********** updated 2007/08/24 ***********


GroupJive is a Group social networking component enabling users to create Groups with other users.

* Users can create groups (from the frontend)
* Admins can create groups (from the backend)

Groups are based on three privilege levels which determine a users ability to access and join groups:

* Open to all
* Approval to join
* Invite to join

Open groups can be joined by anyone. Approval requires that a moderator must approve each new member. Invite is designed so that a User must be invited to join a Group.

Features support numerous mods, compatibility with almost all Joomla! PMS systems, a group bulletin with WYSIWYG options, a CB plugin and integration with components like EventList, FireBoard and more.

NOTE TO COMMUNITY: The GroupJive team is scheduled to release GroupJive stable in September 2007. Please support the project by testing today. More info at http://groupjive.org. -- Thank You!



- - - - - - - - INSTALLATION - - - - - - - -
*********** please read carefully ***********



PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!!
PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!!

        *** GroupJive requires MySQL ver 4.1 or higher ***
        *** You must UPGRADE if you user a lower version ***

*** GroupJive requires one of the following two Profile components ***
            *** Community Builder be installed ***
                            -OR-
              *** Community Builder Enhanced ***

Please see GroupJive *Installation and Upgrade* Forums http://groupjive.org
for links to these Joomla! User Profile / User Management components.

PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!!
PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!! - PRIORITY !!!  



>> UPGRADING GROUPJIVE ON "EXISTING" INSTALLATIONS

To upgrade GroupJive please:

1.) GO TO the Administrator module (backend) of your Joomla installation
2.) UNPUBLISH all existing GroupJive menu links from Joomla menus
3.) DELETE all existing menu links from Joomla menus
4.) DELETE the GroupJive CB Plug in (if it exists). This will also delete
    the GroupJive CB [tab]
5.) UNINSTALL GROUPJIVE
    - GO TO Installers > Components
    - Select the GroupJive radio button (o)
    - CLICK Uninstall button (top right)
6.) Use your FTP file manager to to confirm directories/files are gone
7.) INSTALL "new" com_groupjive component
8.) RE-INSTALL CB Plug-in (and publish)
9.) RE-INSTALL all mod_groupjive modules you may use (and publish)
10.) RE-CREATE and PUBLISH menus for the GroupJive component
11.) Call Mom and Dad and tell them what a wonderful job you have done :D

NOTES:
*** The database tables are not dropped (DELETED) when you uninstall
*** GroupJive has an install script that upgrades your tables if needed
*** You should always make a backup before you upgrade
*** Various uninstall issues with Joomla! itself can cause issues
*** Always have your backups ready and available to restore




>> INSTALLING GROUPJIVE AS "NEW" COMPONENT

GroupJive installs and uninstalls as a Joomla! component.

To install GroupJive

1.) GO TO joomla/administrator
2.) GO TO Installation
3.) GO TO Components
4.) [Browse] for the the com_groupjive.zip install package
5.) CLICK [Upload File and Install]

Each time the site Admin installs or uninstalls GroupJive, a script checks
your database tables to confirm the required fields are present and the
values work with the version of GroupJive you are installing.

If no error is cast, the installation is successful.

6.) click Continue
7.) go to Components
8.) select GroupJive
9.) select Settings to configure

Data is not deleted when you uninstall GroupJive or when you reinstall.
The component itself is added or removed from the administration panel
and the directories and files are added or removed. However you must
manually delete the GroupJive tables from your database if you choose
to stop using GroupJive.


+----------------------------------------------------+
|                   CONFIGURATION                    |
+----------------------------------------------------+

>> CONFIGURING GROUPJIVE


To configure GroupJive go to Components > GroupJive > Settings.
You will see 5 tabs:

* Main Options
* Front End
* WYSIWYG
* AJAX
* Integration

There are many settings available here to configure. Please review and
setup according to your preferences.





             !!!!!!!!! PRIORITY !!!!!!!!!
             ****************************
To use FireBoard / JoomlaBoard intergration, you must set the Integrate
with FireBoard/JoomlaBoard before anything else is done.
The next section explains how >>>
             ****************************
             !!!!!!!!! PRIORITY !!!!!!!!!




+----------------------------------------------------+
|                   INTEGRATION                      |
+----------------------------------------------------+


>>> EVENTLIST INTEGRATION

Eventlist integration is described in a seperate readme file.
Please OPEN readme_eventlist.txt in this package for instructions.


>>> FIREBOARD INTEGRATION


GroupJive can integrate with FireBoard v1.0.3 and older.

HOWEVER !! GroupJive strongly suggests using a BestOfJoomla FireBoard
build that is later than 8/23/2007. The FireBoard team patched a Bug on
this date. This specific BUG allowed "unpublished" categories to be publicly
viewable in the FireBoard recent posts module. Since one of GroupJive's
primary functions is to keep Bulletins and Forum posts within the Group,
the BUG fix was an important fix that ensured Group privacy in Forum posting.
Please confirm your FireBoard build is from code later than 8/23/2007. If
it is not, please consider upgrading your FireBoard installation.

FIREBOARD INTEGRATION gives the admin/users the ability to configure "private"
forums and/or public forums based on the different types of Groups available in
GroupJive.


TO SET UP GROUPJIVE WITH FIREBOARD / JOOMLABOARD



** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **
**     to set up integration with FireBoard first edit the     **
**    FireBoard .php file making it aware of GroupJive path    **
**      this is done by adding lines of code as follows        **
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **


+----------------------------------------------------+
|                 EDIT fireboard.php                 |
|----------------------------------------------------|
|  open /components/com_fireboard/fireboard.php      |
|                                                    |
|                 somewhere after                    |
|   the FireBoard configuration params comment       |
|                 which looks like                   |

// get fireboards configuration params in

                  ADD THESE TWO LINES

// this line integrates GroupJive
include_once ($mainframe->getCfg('absolute_path') . '/components/com_groupjive/groupjive_jb.php');


|                                                    |
|----------------------------------------------------|
|                 Save fireboard.php                 |
+----------------------------------------------------+

*** next > follow intructions completing FireBoard/Joomlaboard integration

1.) Go to Components > GroupJive > Settings
2.) select the Integration [tab]
3.) set "Integrate with Joomlaboard or Fireboard? > drop down to "Yes"
4.) click Save

to enable a private forum for every group...
5.) go to Components > FireBoard
6.) select Forum Administration
7.) create a Category for GroupJive in FireBoard / JoomlaBoard
 ... - NOTE: (the Category will be published only temporarily)
 ... - go to Components > FireBoard Forum
 ... - select Forum Administration
 ... - select "New"
 ... - create a Forum Category, set to Publish and click Save
 ... - you will return to the previous Forum Administration screen
       (verify that the Category is published)
 ... - GO TO the front end (the public facing side) and login
 ... - GO TO FireBoard and "mouseover" and click the Category link
       for the new Category
 ... - the URL for this link should now appear in your Browser's
       address bar
 ... - the final part of the address contains the : catid=?
 ... - WRITE DOWN THE NUMBER catid=#
9.) go to Components > GroupJive > Settings
10.) select the Integration [tab]
11.) Enter the FireBoard Category ID number (catid=?) in the field following
     this description
     ..... Assign an unpublished FireBoard Category to GroupJive. Please enter the catid #  ["# only"]
12.) click Save
13.) Every Group Forum will be created under this Category
14.) FINAL STEP > go back and unpublish the Category so that the Group Forum
     posts remain private




+----------------------------------------------------+
|    CREATING CATEGORIES AND GROUPS  (BackEnd)       |
+----------------------------------------------------+

>> CATEGORY CREATION (Categories Manager)

In order to create groups, you must create at least one category.
To create a Category in the backend (administrator)

1.) Go to Components > GroupJive > Catgories Manager
2.) click "New" to Name a new Category and Save it

You can assign a seperate Adminisrator to each Cateogry you create.
Access to Categories can be controlled using the built in Joomla!
settings of Public, Registered or Special.

The Group Types that can be created in a Category are:

* Open to all
* Approval to join
* Invite to join

To determine what Group types can be in a Category you simply turn the
ability to create that Group type either ON (Yes) or OFF (No).

You can also upload a category picture.

REMEMBER: **Publish** your Categories or they will not appear in the
front end!


>> GROUP CREATION (Groups Manager)

Groups can be created in the front end - usually by "registered" users.
- The Admin must FIRST enable Group creation for FrontEnd users
  for this to be possible.
- The Admin can also disable Group creation from the FrontEnd
  if they choose to Administer Group creation from Backend only.
When creating groups from the frontend, the creator will automatically
become the group moderator.

If Admins create groups in the backend, the Admin will need to select a moderator 
(from your user base) to moderate each group that is created.

Group Settings include:

Group Name, Description, Category in which to place the Group, 
Group Type (Open, Approval, Invite), Published (Yes, No),
Administrator (select whom from users), Group Logo (image upload)
.

>> MEMBER MANAGER (user add/remove/invite utility)

GroupJive Member Manager enables the Admin to complete common user manangment
tasks without having to search through Groups in the FrontEnd to find which
Groups a user may have joined. Member Manager enables 3 basic functions to 
simplify administration. These are:

- Invite members
- Add members
- Remove members

Member manager also includes a Username filter (to search large userbases)
and a Group List filter to select specific Groups from which to choose members.



+----------------------------------------------------+
|                EXTENDING GROUPJIVE                 |
+----------------------------------------------------+

>> GROUPJIVE ADD-ONS


Currently there are four GroupJive modules available for download.
The modules can be downloaded from the File Release System at joomlacode
HERE>  http://joomlacode.org/gf/project/groupjive/frs

The modules for GroupJive are
- mod_largestgroups
- mod_latestbulletins
- mod_mygroups
- mod_newestgroups

There is also a plugin for Community Builder and Community Builder Enhanced
that creates a TAB in Community Builder profiles displaying the Groups
that a member has joined and allowing other users to click the Groups
from the profile page.


+----------------------------------------------------+
|               SUPPORT AND COMMUNITY                |
+----------------------------------------------------+

>> SUPPORT

GroupJive wants to create an environment that is friendly, fun and informative.
Users can find support in
- the forums at http://www.groupjive.org
- by emailing team@groupjive.org
- for Community Builder issues at http://joomlapolis.com
- for EventList issues at http://www.schlu.net
- for FireBoard issues at http://bestofjoomla.com
For BUG REPORTING, please visit the GroupJive TRACKER at http://joomlacode.org/gf/project/groupjive/tracker
For FEATURE REQUESTS, please visit the GroupJive TRACKER at http://joomlacode.org/gf/project/groupjive/tracker

If you are a more experienced user, our community invites you to take part in
GroupJive's development and planning. Visit our forums. Give your support to
new users. Translate language files. Contribute design work. We enjoy our community
and the insights and benefits users bring to GroupJive is what continues to 
make developing an open source program one of the best places to be on the internet.

Thank you.

| == == END == == |


thank you for choosing GroupJive
:)