*********************
WELCOME TO FLASHCARD!
*********************

GREETINGS!

Thanks for purchasing FlashCard.


REQUIREMENTS:

PHP 4.3+ with GD2 libraries (JPEG support must be enabled in GD2), TTF support, Macromedia Flash 7 client. Optional: MySQL is required ONLY if you intend to use FlashCard in the mode whereby users must register first. The user registration data is saved in MySQL.

To edit the .fla files (Flash source code), you must have Macromedia Flash 2004 Professional. You can download a free, 30-day trial of Flash 2004 from www.macromedia.com


INSTALLING:

Upload all files in the "html" folder, in BINARY mode, to a folder on your web server. You must have PHP with the GD2 libraries available. You must also have sendmail for sending e-mail using PHP.

After uploading, go to:

http://www.your_server.com/some_folder/install.php

"some_folder" is a folder of your choice where you uploaded the files to. Please note that you do NOT have to upload the files contained in the 'src' folder - this contains Flash MX source code only.

/install.php will start the FlashCard installation wizard, which will check your server environment, and setup the MySQL tables, if you are using FlashCard in a manner whereby users must register before creating cards.

Part of the installation involves CHMODing the /scripts folder to a writable setting (like 755 or 777). FlashCard saves temporary image files in this diretory before e-mailing. If you do not know how to do this, you can often skip this step, but it depends on your server settings. You may try the system without doing this CHMOD step, and if everything works, then you're set! If the images in the resulting e-mail are broken links, then you know that you have to CHMOD the /scripts directory.

IMPORTANT: There is one final step to the installer, which some users overlook. The "createThumbs.php" file must be executed to generate thumbnails from your graphic and background images, or they will not appear! You may create the thumbnails manually, but them must end with "_thumb.jpg" and they must be non-progressive JPG images.


CONFIGURATION:

Open the config.xml, default.xml (in the skins folder), strings.xml (in the scripts folder), and config.php (in the scripts folder), and edit these files as needed. I think that they are fairly self-explanatory. There are several versions of the XML files depending on which language you are using with FlashCard. Pleaes be careful that you do not introduce XML or PHP syntax errors when editing these files!

For an in-depth explanation of the various configuration options, and for direction to change the gallery images (and add/remove/rename) background image galleries, please refer to TUTORIAL.txt


CMS INTEGRATION:

If you wish to integrate FlashCard with an existing bulletin board or content management system, like phpBB, vBulletin, Mambo, phpNuke, or any of a variety of other systems, here are the steps:

1) Be sure that FlashCard is uploaded to the "flashcard" directory in your CMS system's root folder. For example, if you have phpBB installed at:

http://www.domain.com/phpBB/

... then FlashCard's "html" folder contents should be placed at:

http://www.domain.com/phpBB/flashcard/

In other words, to start the FlashCard installer, you would access:

http://www.domain.com/phpBB/flashcard/install.php

Then, in step 2 of the installer, choose the option to integrate with a CMS system, and choose the system that you wish to integrate with.

Please note that FlashCard should be able to auto-detect your database settings at step 2 (immediately after you select your CMS/BB from the combo list). If it does not, then your CMS system (or version) may be unsupported, or you may have FlashCard incompletely uploaded, or uploaded to the wrong directory.

If the integration is successfull, then you will be able to login to FlashCard using your CMS username & password - i.e, it will draw the data from your CMS database, not from FlashCard's users table. Please note that there is not an "auto-login" as there is for FlashCard. Thus, even if the user is already logged in to the CMS, they will need to re-login to FlashCard.

The CMS integration files are located in the /inc/cmses/ folder. They are identical to FlashChat's CMS integration files, so any time there is an updated FlashChat file, you may assume that it will also work with FlashCard.

After installation, the CMS of your choice is inputted into this file:

/scripts/config.php

... in the "CMSsystem" configuration variable. This value corresponds to the PHP file name found in /inc/cmses/.


ADDENDA:

The TTF (True Type Font) files for FlashCard can be downloaded from here (this is optional):

http://www.tufat.com/downloads/FlashCard_TTF_Files.zip

or

http://www.tufat.com/downloads/FlashCard_TTF_Files.rar

You can post feedback on the TUFaT.com support forum: http://www.tufat.com/phpBB2/, or email me at g8z@yahoo.com (reply is not always guaranteed, but I do read all emails). Donations are always welcome, and can be sent to g8z@yahoo.com via PayPal (hint: they will get your feature added much faster!). The forum is 'user-to-user' and not officially developer-supported. I encourge this to help free up my time for more development, which ultimately helps you, since upgrades are free.


Thanks for using FlashCard!
Darren