About

PHP Fan Fiction is a flat file database script designed to allow better management of story archive sites.

The script is very easy to set up and use and can easily be integrated into existing sites. All in all it is a simple way to turn your html story archive into a simple to manage database run one.

Best of all it requires no MySql databases or fancy coding skills and can be set up in minutes, even on a free host. All you need to run this script is a web host that supports PHP coding (Most do) and FTP (it can work with the file manager as well) access to your site.

Our aim is for the script to be simple to use for even people with very little coding knowledge, but flexible enough to be included in more advanced scripts/programs as needed.

Download

You should always download the latest release to obtain the best experience for your site. The current release is Version 1.3. See the change log for details of improvements over other versions. You can download the current release by clicking the download button below. Or if you are looking for an archived version for testing you will find them listed on our archived download page.

Download Now!

Installation

Download and Unzip the latest script release from the downloads page or by emailing our auto responder , which will send you a direct download link and then follow the instructions below:

1. Upload the following files and folders to your website using FTP
   phpfanfictionscript.php - This file contains the script code
   storydb.txt - The database file that will hold all your story data
   /stories/ - This folder will hold your uploaded stories
   
2. CHMODD the /stories/ folder and storydb.txt file to 0777 so that they are writable
3. Include the PHP statement in your template in the place you want the stories to display
4. Test your site and add your stories

Adding Stories

The script has been set up to make adding stories a simple two step process.

1. Upload the stories in .html, .txt or .pdf format to the /stories/ folder
2. Add the details to the database (storydb.txt file) either using the included form or manually in the format below. Each new entry should be on a new line (as shown)

Story Title|Author|A short summary of the story|storyfilelink.html|Author Email
Story Title|Author|A short summary of the story|storyfilelink.html|Author Email

Note:

To use the upload form you will need to upload the relevant files to your site. Full details can be found in the Readme.txt file contained in the Upload Form folder from within the main download file. You can always create your own form if you feel comfortable in doing so. The files are well commented so it shouldn't be difficult for someone with some HTML and PHP knowledge.

Extensions

This script can be modified and extended with any number of external code snippets including javascript and PHP. With a little tweaking the possibilities are endless. The following plugins are already in our repository and are free to download and use. They have been tested to ensure compatibility with this script and are well documented.

If you can't find what you are looking for you may also try hotscripts.com or dynamicdrive.com which provide a number of scripts that you may be able to customise to work with this script.

License

This script is subject to the Creative Commons 3.0 License. You are free to use it for both free and commercial purposes providing all links back to us remain intact. If you wish to remove the link we request a donation of $10 per site/URL. Please contact us with a valid email address and the intended URL of your site to arrange payment.

THIS PACKAGE, DESIGN AND ACCOMPANYING DIGITAL MATERIALS ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THE PACKAGE MAY BE USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS PACKAGE. IN NO CASE SHALL 'COFFEE DESIGNS' BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR THE INABILITY TO USE EQUIPMENT OR ACCESS DATA, WHETHER SUCH DAMAGES ARE BASED UPON A BREACH OF EXPRESS OR IMPLIED WARRANTIES, BREACH OF CONTRACT, NEGLIGENCE, STRICT TORT, OR ANY OTHER LEGAL THEORY. THIS IS TRUE EVEN IF 'COFFEE DESIGNS' IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

WARNING: This package is protected by copyright law. Unauthorised reproduction or distribution of this package, or any portion of it, may result in severe civil and criminal penalties, and will be prosecuted to the maximum extent possible under the law. If you wish to share this package/script with others, please direct them to our website at http://www.phpfanfiction.com.

PHP Fan Fiction - a flat file story archiving database script.

Troubleshooting

Below you will find the answers to some frequently asked questions. If your question isn't listed then send us an and we will try to answer it.

Q. Script not displaying correctly?

A. Have you included the statement on the page where you want the script to display? Is the page a PHP page? (Change the filename ending to .php or if your server allows it upload the .htaccess file to the same directory as your script.)

Q. Unable to add stories to the database?

A. Have you uploaded the upload form to your web server or added stories manually using the structure above?

Q. Receiving a 'Database Not Found' error?

A. Make sure you have uploaded the story database storydb.txt to the same directory as the page you want the story list to appear on. It won't work if it's in a different directory.