GlitterSet v.5
Author: Valerie Moore (valerie@magscene.net)
http://www.magscene.net
Released 27 July 2007

______________________________
1. Introduction
2. Disclaimer
3. Licence and terms of use
4. Installing

______________________________
1. INTRODUCTION

Thank you for downloading GlitterSet v.5!  This script 
is designed to allow your visitors to create a phrase 
using "letter sets" (images of individual letters).  
This is a very basic script, and not designed to 
accomodate special characters.  This .zip file includes 
two letter sets that I made, to start you off.

This is a very lightweight PHP script.  It is not 
complicated at all, and was made because of how basic 
it is.  When searching the internet looking for a 
glitter generator script to download, I only saw them 
for sale.  I decided to make my own, and made a more 
advanced glitter generator for myself (all one image, a 
credit tag on the image, uses fonts instead of images 
to create the glitter image).  Someone expressed 
interest in a glitter script that used lettersets, and 
I figured that it would be really easy to make and 
useful for a lot of people, especially those with 
myspace/graphic/resource sites who don't want to buy or 
create their own.

______________________________
2. DISCLAIMER

This script is provided AS-IS.  By using this script in 
any way, you agree not to hold Valerie Moore, 
magscene.net, or anything or anyone connected to Valerie 
Moore liable for any damages that you may incur.  Use at 
your own risk.

I am not a programmer by trade or training.  I play 
around with PHP for fun and for a change of pace, and am 
self-taught.  There are no guarantees that go along with
this script.

______________________________
3. LICENCE AND TERMS OF USE

This script is LINKWARE.  While you may change the 
wording (to a reasonable extent--nothing demeaning or 
untrue), a link to http://www.magscene.net must be 
present on every input page (where the form to create the 
glitter is located) and every output page (where the 
sample glitter and code is presented to the user).

Do not claim this script or the included letter sets as 
your own.

DO NOT REDISTRIBUTE!  If you are interested in 
redistributing, you must first get the express written 
permission of Valerie (e-mail: valerie@magscene.net)

If you build upon this script, contact valerie@magscene.net 
for redistribution information.  You are free to build upon 
it and modify it for your own use, but please don't 
distribute it without permission if it is based heavily on 
this script.

______________________________
4. INSTALLING

After unzipping, there are a few things to edit and become familiar with.

> Structure
The script is structured so that index.php contains the input form, and the submitted data is processed by glitter.php (located in the same directory/folder), which displays a preview and the HTML code for the user to use on another webpage.  Letter sets containing letters and numbers are in their own folders, and the folders must all be contained in the same directory.
  For example:
    http://www.example.com/glittergen/lettersets/1   
        contains all the images of the letters and 
        numbers in letter set "1" only.
    http://www.example.com/glittergen/lettersets/annie   
        contains all the images of the letters and 
        numbers in letter set "annie" only, and so on.

In index.php:
- In your form, data named "style" must correspond with the folder that contains that letter set.  <input type="radio" name="style" value="1" /> corresponds to letter set "1"
- You may want to set a maxlength of the word(s) your user inputs

In glitter.php
- Define the base URL for the location of the letter sets.  Following the example above, I would enter: $url = "http://www.example.com/glittergen/lettersets/";
  DO NOT FORGET THE TRAILING SLASH!
- You may also wish to edit the maximum length of characters allowed and the URL for the glitter to be linked to.
- Edit the layout of the page at the bottom of the file.

______________________________
5. GETTING HELP

This is the first readme I have written, and the first script I have distributed.  If you have any questions, please ask me by visiting http://www.magscene.net