Tour of the file system
5 February 2018 805 views | Documentation v1
The organisation of the Tuskfish file system is described below.
/admin
Houses the back end pages for managing the site and adding content. Access is restricted to administrator only.
/cache
Stores image thumbnails associated with content objects to reduce processor load. The thumbnails are built by the image caching system.
/installation (removed after installation)
The installation directory for a new site. Access this to begin the installation process, after configuring mainfile.php. You must delete it after installation is complete.
/js
Holds javascript libraries and other components used for presentation purposes, namely: Bootstrap, jQuery, TinyMCE and FontAwesome.
/themes
Stores template sets ("themes") for presenting and formatting the site and individual content objects. Each theme resides in it's own subdirectory.
/trust_path (normally moved outside of the web root)
Holds as much of the non-public facing code as possible to reduce the risk of access and abuse. This directory should be placed outside of the web root to prevent contents being accessed via browser.
/trust_path/cache
Stores pages built by the page caching system (when enabled in preferences) to reduce processor load.
/trust_path/database
Holds the SQLite database file for the site. The file should be readable/writeable by the server only (chmod 0600). This is important, as SQLite database access is controlled by file permissions, only.
/trust_path/extras
Holds a collection of scripts and tools you may find useful in customising your site, such as an offline password reset tool and Yubikey two-factor authentication script.
/trust_path/libraries
Holds code libraries, including the core Tuskfish library and HTMLPurifier.
/trust_path/log
Holds the error logfile for the site. Don't forget to check it occasionally, it will help you identify problems.
/trust_path/modules/
Each module resides in here as a subdirectory. Currently there is only one module (content).
/trust_path/modules/content
The content module class files, forms, language constants and optional templates.
/uploads
Stores uploaded image and media files associated with content objects, in respective subdirectories.
enclosure.php
Returns associated media / file attachments from content objects as forced downloads.
error.php
A custom 404 error page that looks nice and offers a search form. If you are using cPanel, point your custom error page to this file.
gallery.php
Presents a gallery of thumbnails from image content.
index.php
The main content page for the site. By default it presents a mixed stream of the most recent content in teaser (summary) review. The full descriptions of individual content items can also be viewed.
mainfile.php
Defines the base file path and URL constants for the site and includes essential files such as the configuration file. This file should be readable by the server only (chmod 0400).
rss.php
Generates RSS feeds for the whole site. Feeds for individual tags or collections can also be accessed by passing in the ID.
search.php
Presents a search form and search results to the public.
Copyright, all rights reserved.