index

Files and File Permissions

Admin expects many files and directories to have write permissions. None of these write permissions are necessary for THIS to work once fully set-up and configured, except that some functionality will be limited.

Also, some files and directories are only used while "learning" the application and will not be needed after installation.

It is highly recommended that THIS be set-up and configured locally before being placed on an Internet server. THIS is still considered BETA software. Setting up Apache, MySQL and PHP on a computer is relatively easy to do for almost every operating system.

Setup File

The one file that must have write permission for set-up is:

        dat/defines.php

Out of the archive that file is empty (except for the PHP start-tag). During set-up some PHP defines are written to it.

Configuration Files

Admin can be used to edit all of the configuration files and the HTML templates file — or not. These files are:

        config.ini
        error.ini
        rules.ini
        sections.ini
        translate.ini
        htm/html.ini
        htm/usercode.ini
        htm/templates.php

These files need write permissions only if they are wanted to be editable via Admin. Otherwise they can be read-only. No sensitive data is stored in any of these files.

Because some INI files are required for Admin to run, if there is a syntax error in one of them Admin will fail. Therefore, it is highly recommended to not remotely edit CONFIG.INI or SECTIONS.INI for a live site. (But you can.)

The main program does have evaluations in place to survive syntax errors in the other configuration files. Still, one must be careful when remotely editing a live site — but again, doing so is not a requirement.

Directories

There are two directories that need to be writeable to support the functionality of editing "pages" and for exporting and importing posts. These directories are:

        pages
        import

The directory for the documentation and the directories for the highlighted source files are writeable because we use a PHP application to generate them. None of those files are at all required to be used (see file TEMPLATES for how to remove the links to them from the navigation menu).