// ----------------------------------------------------------------------
// Copyright (c) 2007 by Tammy Keefer
// Recommendations Module developed for eFiction 3.0
// // http://efiction.hugosnebula.com/
// ----------------------------------------------------------------------
// LICENSE
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License (GPL)
// as published by the Free Software Foundation; either version 2
// 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 General Public License for more details.
//
// To read the license please visit http://www.gnu.org/copyleft/gpl.html
// ----------------------------------------------------------------------

This module adds the ability for members (and anonymous users if you choose) to recommend
off-site stories.  These recommendations have their own page in the browse listings. Site
administrators may choose to auto-validate or manually validate recommendations.  This 
setting is separate from the story validation setting.  Links to off-site stories may 
also be set to open in the same window or a new window.  Members (and anonymous users 
dependent on site settings) may leave reviews for recommended off-site stories and flag
them as favorites.  The module also follows your submission settings in your main script.
So if you have submissions turned off for the site, recommendation submissions are turned
off as well.

To install this module:

1. Upload the entire recommendations folder to the the modules folder within your 
eFiction installation.

2. Go to http://www.yoursite.com/modules/recommendations/install.php where 
www.yoursite.com is your eFiction site's address.  Or alternatively, go to the Modules admin panel
and click on the install link.

3. A default recommendations block is included in the modules/recommendations/default_tpls/
folder.  DO NOT MOVE IT!  The script will look there first for the recommendations.tpl.  To
customize this .tpl copy it to the specific skin folder and make adjustments there.

To uninsall this module:

1. Go to http://www.yoursite.com/modules/recommendations/uninstall.php where 
www.yoursite.com is your eFiction site's address.  You may also click on the uninstall link
in the modules admin panel. Or go to the Modules admin panel and click the uninstall link.

Skin variables for the Info/Stats block:

{totalrecs} - the total number of recommendations
{reccers} - the total number of recommenders