Downloading eFiction is super easy, and doesn’t require much technical knowledge. It can be done in literally three simple steps!
New Installation - Easy Method
Note: you’ll need to create your own database before installing eFiction for the first time.
Step 1
Download eFiction using the Direct Download button below, and extract it to a safe place, such as your desktop.
Step 2
Using FTP, or your hosts file manager, upload all of the files to your root directory, or wherever it is you want to install eFiction to.
Step 3
Go to your website and follow the installation guide to set up your new eFiction archive.
Github Repository
eFiction is entirely open source software, and you’re welcome to view all of our files via our Github repository. You’ll find the most stable version of eFiction there, as well as some tester versions that are incomplete. We only recommend using the stable version.
You can view our Github here – https://github.com/eFiction/
Detailed Installation or Upgrade Guide
There are notes in the docs/ folder about the changes to skins in this version. However, there is no tutorial as of yet. It's also strongly suggested that you NOT put the site into maintenance mode or start modifying the script (even by adding modules or blocks) until you've actually confirmed that the install was successful. Upgrading from v.1.1: BACK UP YOUR FILES AND YOUR DATABASE FIRST!! Upload the 3.0 files OVER your 1.1 files. DO NOT DELETE YOUR 1.1 FILES UNTIL THE UPGRADE IS COMPLETE! Go to your site. The script will detect that the config.php file is for 1.1 and start the upgrade. Note: You're encouraged to choose one of the skins provided with the 3.0 script until you can update your 1.1 skins. There are numerous changes in the skins from 1.1 to 3.0. Note 2: Make sure your config.php file is CHMOD'd to 666. Upgrading from v.2.0.X: BACK UP YOUR FILES AND YOUR DATABASE FIRST!! Upload the 3.0 files OVER your 2.0 files. DO NOT DELETE YOUR 2.0 FILES UNTIL THE UPGRADE IS COMPLETE! Go to your site. The script will detect that the config.php file is for 2.0 and start the upgrade. Note: You're encouraged to choose one of the skins provided with the 3.0 script until you can update your 2.0 skins. Note 2: Make sure your config.php file is CHMOD'd to 666. Note 3: If you have installed blocks that did not come with the 2.0 package, turn them off before starting the upgrade. They will most likely be incompatible! Minor Upgrade from v.3.X to v.3.Y: BACK UP YOUR FILES AND YOUR DATABASE FIRST!! Upload the 3.Y files OVER your 3.X files making sure you do not over-write your config.php file. Generally, the images, tinymce, and skins folders will contain no updates and do not need to be replaced. Go to your eFiction site. The script should detect the updated files and ask you to update. If it doesn't go to http://www.yoursite.com/update.php. NOTE: If you have your site bridged, remember to put the bridge back in place before running the update. Brand New Install: If you know basic web stuff like CHMODing, look below at step #1. If you have no clue what you're doing, just go to http://www.yoursite.com/ after uploading all the files to your server. 1) If you intend to write the story texts to the server or allow image uploads, you must create a folder where these files will be stored. CHMOD this folder to 777. During installation, the script will ask you for the location of this folder. If this folder is missing the script will attempt to create it for you during the install, but it is best if you create the folder yourself before beginning the installation script. 2) Move config.php from the docs folder to the main eFiction folder. This file was placed in the docs folder to help prevent accidental overwriting of config.php for upgrades. If the config.php is missing the install script will attempt to create it, but it's best if you move it. 3) CHMOD config.php to 666. 4) Go to http://www.yoursite.com/ to run the install and set up the admin login. 5) Login with the admin login and password set in step #4, and complete the configuration of your site through the Admin panel. Other info: 1) As written, the script is intended to be used in the following way: - Categories: you can have only one category, or as many as you want, including sub-categories. Categories were written with the intention that they would indicate different fandoms or categories of story. - Characters: Intended to mean the characters that fall within that fandom or category. - Classifications: Beyond categories and characters you can set up your own classifications such as genres, warnings, spoilers, story type, couple, etc. - Series: Series are collections of related stories by the same or multiple authors. A story and its sequels, for example, would be a series. Series might also be used for a "shared universe" in which multiple authors write. The person who creates the series is considered the series "owner" and controls whether or not the series is "open" to contributions by other authors or not. Even if the series is "closed", the series owner has the option to include stories from other authors in the series. - Challenges: Challenges are ideas/wishes for stories that a member or an anonymous visitor "challenges" authors to write. Stories written in response to the challenge can be listed under the challenge by the story author or an admin. Note: in 3.0 challenges have been made into an optional module. To install challenges goto http://www.yoursite.com/modules/challenges/install.php. Check out the Admin area for more information on all of these settings and more. 2) You can modify most of the text that is displayed in the script by changing the language file in the languages/ folder for the language you selected. Just change the text within the quotes for each line to whatever you want it to say. Some wording is included within the skin's files. If you have created a translation for eFiction, we encourage you to share it!
Need Help?
If you need any help, or if you have any questions regarding the installation, feel free to reach out on our Community forums!