
*****************************************************************
GroupJive 1.7 integrates with FireBoard v1.0.3 and above, 
including The Kunena Fork. Support for earlier versions of 
JoomlaBoard and SimpleBoard has ended in the current version 
of GroupJive. These options have been removed completely from 
this Plugin. In this Readme, the word "Fireboard" may be swicthed
with "Kunena" depending on your setup. The two are interchangeable,
almost... ;-)
*****************************************************************
                *** About Plugin  ***

This code is released under the terms of the GNU/GPL, and as such 
is provided free, like both speech AND beer.
It is derived from copyrighted works licensed under the GNU General 
Public License.  This version has been modified pursuant to the GNU 
General Public License and as distributed, it includes or is 
derivative of works licensed under the GNU General Public License.

*****************************************************************
**             !!! New Features in this version !!!            **
*****************************************************************
** V1.3                                                        **
** Fixed the Forum Permissions Bug                             **
**                                                             **
** Added a couple Options in the plugin settings to control    **
** the display.                                                **
**                                                             **
** V1.2                                                        **
** Integration to the new Kunena Forum.                        **
**                                                             **
** The ability for Admins to choose the Template Position in   **
** which to show the Latest Posts.                             **
**                                                             **
** Select the Number of latest posts to show.                  **
**                                                             **
** The ability, at the Admin's discretion, to Automagically    **
** post a Welcome message into newly created Group Forums!     **
*****************************************************************
             View the Changelog for more details

+----------------------------------------------------+
|                 FIRST THINGS FIRST                 |
+----------------------------------------------------+

In this package you will find a Template File named
shownewposts.tmpl This file must be copied into your
templates folder. eg:

components\com_groupjive\templates\default\

This file is necessary as the previously hard coded 
output of the gjfireboard plugin has been changed to
run through the templating system to give us more 
display options for the future. It should only be
necessary to copy the file to the default folder for now
unless you need to customize it for another template. 
If you switch back to the previous gjfireboard plugin 
for any reason, this file will have no effect and can
safely be left.


+----------------------------------------------------+
|               FIREBOARD INTEGRATION                |
|               see below for Kunena                 |
+----------------------------------------------------+

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 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                 |
|----------------------------------------------------|

This hack is only nessasary if you would like to display Group 
Details in the area above your Private Group Forum. This hack
causes errors on some systems, and needs to be researched.


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

// get fireboards configuration params in

                  ADD THESE LINES

// this line integrates GroupJive
include_once ($mainframe->getCfg('absolute_path') . '/components/com_comprofiler/plugin/user/plug_gjfireboardextended/showgroup.php');


+----------------------------------------------------+
|                 EDIT fb_pathway.php                |
|----------------------------------------------------|

This Hack enables users to navigate to forums that are not published
to the front-end. 

components/com_fireboard/template/default/fb_pathway.php 

at or around line 46
$query = "select * from #__fb_categories where id=$catids and published=1";

>change to to

$query = "select * from #__fb_categories where id=$catids";

+----------------------------------------------------+
|                KUNENA  INTEGRATION                 |
|              see above for Fireboard               |
+----------------------------------------------------+

KUNENA 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 integration with Kunena first edit the       **
**      kunena.php file making it aware of GroupJive path      **
**      this is done by adding lines of code as follows        **
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **


+----------------------------------------------------+
|                 EDIT kunena.php                 |
|----------------------------------------------------|

This hack is only nessasary if you would like to display Group 
Details in the area above your Private Group Forum. This hack
causes errors on some systems, and needs to be researched.


open /components/com_kunena/kunena.php
                                                    
   somewhere after the FireBoard configuration 
   params comment which looks like                   

// get fireboards configuration params in

                  ADD THESE LINES

// this line integrates GroupJive
include_once ($mainframe->getCfg('absolute_path') . '/components/com_comprofiler/plugin/user/plug_gjfireboardextended/showgroup.php');


+----------------------------------------------------+
|                 EDIT fb_pathway.php                |
|----------------------------------------------------|

This Hack enables users to navigate to forums that are not published
to the front-end. 

components/com_kunena/template/default/fb_pathway.php

at or around line 46
$query = "select * from #__fb_categories where id=$catids and published=1";

>change to to

$query = "select * from #__fb_categories where id=$catids";


+----------------------------------------------------+
|                 Final Installation                 |
|----------------------------------------------------|

The instructions from here assume that you have GJ installed and
working, you have CB 1.2 STABLE installed and working, and you 
have installed and published the gjFireboardExtended plugin . 

________________________________________________________
:********:   This is a CB plugin and must be installed 
:* Note *:   through the CB plugin manager! 
:********:______________________________________________


1.) go to Components > FireBoard [ Kunena ]
2.) select Forum Administration
3.) create a Category for GroupJive in FireBoard
 ... - 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 (Kunena) and "mouseover" 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=#
4.) go to Components > community builder> Plugin Manager
5.) select the GJ Fireboard Extended Plugin
6.) Enter the FireBoard Category ID number (catid=?) in the FB Category field.
7.) Change any other parameters and click Save


