﻿/*
+-----------------------------------------+
+ Ajax Forum Post Ratings by LOA & Fangree Productions
+-----------------------------------------+
+-----------------------------------------+
| Developers: Matias Casas (PhAnToM) & Craig dewar (Fangree_Craig)
| Email: phAnToM - phantom@loa-team.com.ar
| Email: Fangree_Craig - admin@fangree.co.uk
| Support: http://www.fangree.co.uk	
|-----------------------------------------+
+--------------------------------------------------------*
| Based on Forum Post Ratings from  fusionBoard 4
| by php-Invent Team
| http://www.php-invent.com
| Developer: Ian Unruh (SoBeNoFear)
| ianunruh@gmail.com
+--------------------------------------------------------*
==================================================================================
|                                                                                |
|    This program is free software: you can redistribute it and/or modify        |
|    it under the terms of the GNU Affero General Public License as              |
|    published by the Free Software Foundation, either version 3 of the          |
|    License, or (at your option) any later version.                             |
|                                                                                |
|    This program is distributed in the hope that it will be useful,             |
|    but WITHOUT ANY WARRANTY; without even the implied warranty of              |
|    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
|    GNU Affero General Public License for more details.                         |
|                                                                                |
|   You should have received a copy of the GNU Affero General Public License     |
|    along with this program.  If not, see <http://www.gnu.org/licenses/>.       |
|                                                                                |
==================================================================================
|-----------------------------------------+
| PHP-Fusion
| Copyright © 2002 - 2009 Nick Jones
| http://www.php-fusion.co.uk/
|-----------------------------------------+
*/


GENERAL:
-------------------------------------------
A simple JavaScript and Ajax Rating system that gives users the ability to rate forum posts (Thanks, Very Good, Good Idea, disagree etc.).

Users rate posts by clicking a small graphic representing what they think of the users post (Very Good, Useful, Disagree etc).

When a post has been rated the small graphic will appear on the bottom left of the post,  move your mouse over the icon and a box over will appear with the info.

All Ratings Users have given and received are displayed in their profile.

To see an example of what the Ajax Forum Post Ratings  looks like in the Forum viewthread.php and Profiles please refer to the Screenshot in the folder Ajax_Forum_Post_Ratings/Screenshot_Demos/viewthread_Demo/

-------------------------------------------


!!ATTENTION!!

PLEASE NOTE:: BEFORE YOU UPLOAD THE FILES BACKUP /FORUM/VIEWTHREAD.PHP

!!ATTENTION!!

PLEASE NOTE:: BEFORE YOU UPLOAD THE FILES BACKUP /FORUM/VIEWTHREAD.PHP

!!ATTENTION!!

PLEASE NOTE:: BEFORE YOU UPLOAD THE FILES BACKUP /FORUM/VIEWTHREAD.PHP



INSTALL INSTRUCTIONS:
-------------------------------------------
1. Upload all files in /files/ folder to your PHP-Fusion site route AND ALLOW TO OVERWRITE FORUM/VIEWTHREAD.PHP

2. Go to your site Admin >>> System Admin >>> Infusions and infuse Loa Rates.

3. Go to your site Admin >>> Infusions >>> Select LOA Forum Rates.

3. Define your Ratings. Below is an example how Ratings can be defined, however you can choose what you want and you can choose as many as you want.

4. Go to your site Admin >>> User Admin >>> User Fields >>> Enable User Ratings.

5. Done Ajax Forum Post Ratings should be successfully installed.

PLEASE READ ON.....

+------------------------------------------------------------+
EXAMPLE FOR DEFINING RATINGS IN ADMIN
+------------------------------------------------------------+
To see an example of what the Ajax Forum Post Ratings Admin looks like please refer to the Screenshot in the folder Ajax_Forum_Post_Ratings/Screenshot_Demos/Admin_Demo/

      Name                   Icon
	  
    * Thanks     ------- >   tick.png
    * Very Good  ------- >   rosette.png
    * Agree      ------- >   accept.png
    * Disagree   ------- >   cross.png
    * Good Idea  ------- >   lightbulb.png
    * Funny      ------- >   emoticon_evilgrin.png
    * Usefull    ------- >   wrench.png
    * Informative ------- >  information.png
    * Bad Reading ------- >  book_error.png
    * Code King   ------- >  wand.png

+------------------------------------------------------------+
 CHANGING BOX OVER COLOURS & Styles
+------------------------------------------------------------+

IF you would like to change the colours and text for the Ratings box over...

Open loa_rates/includes/js/boxover.js

Look at lines 65 to 77
you should see::

function defHdrStyle() {
	dvHdr.innerHTML='<img  style="vertical-align:middle"  src="info.gif">&nbsp;&nbsp;'+dvHdr.innerHTML;
	dvHdr.style.fontWeight='bold';
	dvHdr.style.width='200px';
	dvHdr.style.fontFamily='tahoma';
	dvHdr.style.border='1px solid #CCCCCC';
	dvHdr.style.padding='5px';
	dvHdr.style.fontSize='12';
	dvHdr.style.color='#CCCCCC';
	dvHdr.style.background='#0070b2';
	dvHdr.style.filter='alpha(opacity=80)'; // IE
	dvHdr.style.opacity='0.85'; // FF
}

Edit this part to change, colours, fonts and sizes of box over.

+------------------------------------------------------------+
NOTES: 
+------------------------------------------------------------+

Users post can be given as many ratings as a user wishes to rate the post.

EXAMPLE: A user might wish to rate a post both Thanks and Very Good to do this they Rate their first choice, lets say we choose Thanks we select Thanks and then Refresh page. We can now rate the post again with our second choice and so on.  This can be done until the user has used all rating choices for the post. The Same user can not rate the same post more than once with the same rating.

+------------------------------------------------------------+
SUPPORT: 
+------------------------------------------------------------+
If you require any Support for this Infusion or would like to give us some feedback please visit the Fangree Productions Forums at::
http://www.fangree.co.uk/forum/index.php

+------------------------------------------------------------+
CHANGELOG: 
+------------------------------------------------------------+
- v1.00  - First public release


+------------------------------------------------------------+
CREDITS: 
+------------------------------------------------------------+

AJAX FORUM POST RATINGS 
Idea Based on Forum Post Ratings from  fusionBoard 4 by php-Invent Team  http://www.php-invent.com

Developer: Matias Casas (PhAnToM)            http://www.loa-team.com.ar
Developer: Craig dewar (Fangree_Craig)      http://www.fangree.co.uk
Code Checking & Assistance: Dallas             http://dtawebdesigns.com/
Admin Bug fix Assistance: mve designs         http://www.mvedesigns.eu/
Testing: Fangree_Craig, Taco, jitzy & PaulM

+------------------------------------------------------------+

