EFiction 2.0.X
From Efiction
(→Brand New Install) |
(→Common Installation Problems) |
||
| (2 intermediate revisions not shown) | |||
| Line 20: | Line 20: | ||
7) Login with the admin login and password set in step #4, and set your settings. | 7) Login with the admin login and password set in step #4, and set your settings. | ||
| - | + | == Common Installation Problems == | |
====I am receiving mySQL errors.==== | ====I am receiving mySQL errors.==== | ||
| Line 29: | Line 29: | ||
To prevent users upgrading from eFiction 1.1 from over-writing these files, they have been placed in the docs/ folder. You will need to move config.php to the main eFiction folder and the dbconfig.php to your chosen location before installation. | To prevent users upgrading from eFiction 1.1 from over-writing these files, they have been placed in the docs/ folder. You will need to move config.php to the main eFiction folder and the dbconfig.php to your chosen location before installation. | ||
| + | |||
| + | ====I can't post stories. Stories aren't showing up==== | ||
| + | |||
| + | First check to see if unsolicited submissions is turned off. You can do so by going to Admin -> Settings and finding the question "Turn off unsolicited submissions completely?" If you plan on allowing submissions then this needs to be set to "No". | ||
| + | |||
| + | Secondly check to see if you have any submissions that have not been validated, if they are not validated, they will not show up. You can do so by going to Admin -> View Submitted. | ||
| + | |||
| + | Third, if you are storing the stories in files make sure the stories folder is CHMOD'ed to 777 (on some systems use 755) and that the path you gave in your configuration (Admin -> Settings) is correct. If you needed to make a change to either of these settings, the stories previously submitted were probably not saved and you'll need to re-upload them. | ||
| + | |||
| + | ====Sub-categories and/or characters are not showing up in the forms==== | ||
| + | |||
| + | If this happens, it is most likely because the formselect.js has not generated the list of categories and characters. Either it got over-written in an update or didn't get written in the first place in the upgrade process. | ||
| + | |||
| + | Go Admin -> Categories and click on the button at the bottom of the page that says "Re-generate Form Select List" | ||
| + | |||
| + | Also be sure the formselect.js is CHMOD'd to 666 or the script will not be able to write to it. You may need to do a hard refresh of the page (Ctrl-F5) and/or clear your browser's cache before these changes will take effect. | ||
==Administration== | ==Administration== | ||
Current revision as of 18:51, 20 July 2006
Contents |
Installation
Upgrading from v.1.1
Back up your files and your database before you begin! Replace the files on your server with the 2.0 files EXCEPT for config.php and your dbconfig.php file whereever you placed it. CHMOD the messages folder to 777. CHMOD blocks_config.php, formselect.js and naughtywords.php to 666. Go run upgrade.php, and follow the instructions on the screen.
Brand New Install
1) Following the instructions from your webhost, create a mySQL database for your site.
2) CHMOD the messages folder to 777. If you intend to write the story texts to the server or allow image uploads also CHMOD the stories folder to 777.
3) Move config.php from the docs/ folder to the main eFiction folder.
4) CHMOD config.php, blocks_config.php, naughtywords.php, formselect.js and the files within the messages folder to 666.
5) Modify data/dbconfig.php with the appropriate MySQL database info, and put outside the web directory.
6) Run install.php to install the tables and set up the admin login.
7) Login with the admin login and password set in step #4, and set your settings.
Common Installation Problems
I am receiving mySQL errors.
If you receiving mySQL errors during or after installation check that the information you supplied in dbconfig.php is correct. You must also create a database for your website before starting the install.
Where are dbconfig.php and config.php?
To prevent users upgrading from eFiction 1.1 from over-writing these files, they have been placed in the docs/ folder. You will need to move config.php to the main eFiction folder and the dbconfig.php to your chosen location before installation.
I can't post stories. Stories aren't showing up
First check to see if unsolicited submissions is turned off. You can do so by going to Admin -> Settings and finding the question "Turn off unsolicited submissions completely?" If you plan on allowing submissions then this needs to be set to "No".
Secondly check to see if you have any submissions that have not been validated, if they are not validated, they will not show up. You can do so by going to Admin -> View Submitted.
Third, if you are storing the stories in files make sure the stories folder is CHMOD'ed to 777 (on some systems use 755) and that the path you gave in your configuration (Admin -> Settings) is correct. If you needed to make a change to either of these settings, the stories previously submitted were probably not saved and you'll need to re-upload them.
Sub-categories and/or characters are not showing up in the forms
If this happens, it is most likely because the formselect.js has not generated the list of categories and characters. Either it got over-written in an update or didn't get written in the first place in the upgrade process.
Go Admin -> Categories and click on the button at the bottom of the page that says "Re-generate Form Select List"
Also be sure the formselect.js is CHMOD'd to 666 or the script will not be able to write to it. You may need to do a hard refresh of the page (Ctrl-F5) and/or clear your browser's cache before these changes will take effect.
