################################################################
#
# SIGHT FX
#
# Copyright - Billy Smith
# http://www.vitalogix.com
# chicks_hate_me@hotmail.com
#
# Designed for use with the e107 website system.
# http://e107.org
#
# Mainly Released under the terms and conditions of the GNU GPL.
# GNU General Public License (http://gnu.org)
#
# Leave Acknowledgements in ALL Distributions and derivatives.
#
# Revision: 1.1.0
# Date: 2008-6-28
#
################################################################


################################################################

BEFORE YOU INSTALL - IMPORTANT

#####################################
STEP ONE
#####################################
You MUST Create a USER EXTENDED FIELD - Step - by - Step BELOW.

Use EXACT words and CASE.

1. Go To ADMIN - EXTENDED USER FIELDS
2. Click ADD NEW FIELD
3. Field name: enter 'sight_fx' (so it becomes user_site_fx).
4. Field text: enter 'Sight FX' (not the ' though, only words)
5. Field Type: Select Drop Down Menu.
6. Values - Create TWO - First one = 'Enabled' - 2nd one = 'Disabled' (exact spellings)
7. Default value - enter 'Enabled' (exact spelling) (Unless you want default = Disabled)
8. Required - set to 'No - Show on signup page'
9. Applicable - Members
10. Read access - Everyone (public)
11. Write access - Members
12. Allow user to hide - NO
13. Save it.

This will allow Members to use the Sight FX Menu Buttons to Enable or Disable Sight FX.

#####################################
STEP TWO
#####################################
Check to be sure you have UPLOADING Enabled in the system and that you have renamed the file in /admin called filetypes_.php to filetypes.php to allow uploading.

#####################################
STEP THREE
#####################################
INSTALL

Install the plugin. If it installs successfully, but you cannot see pages, then you will have to manually go to `sight_fx_menu` plugin directory using FTP or another means. Set ALL Folder attributes to 755 and all FILES to 644. You should now be able to see the SIGHT FX Plugin pages as well as some images.

#####################################
STEP FOUR
#####################################
Go into ADMIN - MENU and enable the sight_fx_menu. Enable it for whoever you want to view the Sight FX and which pages you want the effects on.

#####################################
STEP FIVE
#####################################
Go into the SIGHT FX ADMIN under PLUGINS and go to MANAGE OCCASION to select an OCCASION. Then GO to MANAGE FX and select DEFAULT then ACTIVATE.

#####################################
INSTALLATION IS DONE
#####################################
You should now be able to refresh your front page and see the SIGHT FX. To make changes, Go into the ADMIN - SIGHT FX Plugin and use the menu on the TOP-RIGHT.

#####################################
UPDATES AND CHANGES
#####################################
Check out the SIGHT FX GOLD DEMO

There is also a forum at http://www.vitalogix.com for users to share things such as;

HOWTO's
Language Files
Images
Occasions
Advanced settings to create unique effects
Comments and Ideas Future Ideas.

I hope those who install and use this SIGHT FX Plugin will get involved.

#####################################
NOTES
#####################################
To Disable Sight FX, Set the Sprite Count to 0 and activate.

The folders BLANK and SNOW and HEARTS should not be deleted.

You cannot edit images once an OCCASION is created. It's just as easy to delete the OCCASION and re-create it with the correct name and images. Be sure to have copies of the images BEFORE you DELETE an OCCASION as it will remove the folder and image files.

If you want different images for hearts or snow, just make an OCCASION called hearts2 or snow2.

DO NOT use spaces in the OCCASION NAME (FOLDER NAME).

WARNING: FX SETTINGS MAY CAUSE UNPREDICTABLE RESULTS. Make small changes and check them by refeshing the page.

If you only have ONE IMAGE, you can UPLOAD it in all 4 spots. If you don't the UNUSED spots will be taken up by a blank image.

You can have even more control of who sees the effects using the menu's VISIBILITY settings

#####################################
TROUBLESHOOTING
##################################### Make sure Occasion is set to hearts (or snow), and not Blank.

Also, the Spite Count must be between 1 and 20.

Setting Sprite Count to ZERO (o) disables it

Double-check the User_Extended_Field is 'user_sight_fx'

Make sure the words are 'Enable' and 'Disable' with only the FIRST LETTER Capitalized.

Check that you have UPLOADING enabled and properly configured in ADMIN PREFS and ADMIN-UPLOADS.

See if Attributes for folders are 755 and for Files 644. If not CHMOD them to those values.

#####################################
LICENSING AND DISTRIBUTION
#####################################
As a convienence to our customers, we have created a number of programs, plugins
and/or scripts that can be used to interface and/or work WITH GPL'd software. Our
commercial rights take precident over the GPL'd licence in as far as we wrote
these programs and scripts as a commercial product first. If you feel that
you cannot comply with the Commercial license then you CAN NOT purchase the
Commercial versions of the software and use them within and GPL environment.
#####################################
FINAL THOUGHTS
#####################################
ENJOY!!!!