formVista™ Installation Guide

Overview of the formVista directory structure

To make installation of formVista easier for the widest possible audience, especially those who use commodity hosting providers, all of formVista's files are located in a single directory tree. This includes not only code, templates and support files, but also session files, uploaded content and log files.

Note: For advanced users, the locations of some directories can be changed manually by editing the configuration files.

The directory structure under the root formvista directory is as follows:

  1. backend - the code for the backend adminstrative interface.
  2. conf - configuration files. Includes the master conf/config.php configuration file.
  3. cronjobs - background scheduled processes.
  4. docs - documentation
  5. etc - misc files include the htaccess template and keys.
  6. extensions - installable extensions
  7. frontend - code for the integrated manager frontend.
  8. fv_classes - code for some FVML tag handlers.
  9. fvtk - code for the formVista toolkit which implements the FVML language.
  10. lib - misc library functions including the central contact add/update library.
  11. site_local - files and directories specifically related to the current website.

    1. site_local/backend - site specific extensions and overrides to the backend adminitrative interface.
    2. site_local/frontend - site specific extensions and custom component overrides to the frontend content manager.
    3. site_local/themes - local site specific custom themes. This is where any third party web designer created themes should go.
    4. site_local/uploaded_files - placeholder directory for files distributed from this site. A location for PDFs, downloads etc.
    5. site_local/uploaded_graphics - directory where graphics uploaded through the image manager and htmleditor on the backend are stored.
    6. site_local/upload_html - a directory for flat HTML.
    7. site_local/user_files - a set of directories, one per user, of uploaded files that are either public, private or protected. Examples of public files would be images uploaded into blogs or forums.
    8. site_local/var - directory that contains session files, log files, etc. This directory should be monitored as these files can grow to be large.
    9. site_local/xml - directory where RSS feeds are generated.
  12. site_local.empty - placeholder template for a site_local heirarchy
  13. themes - directory of stock themes shipped with formVista.
  14. utils - misc command line utilities including a CSV contact importer.
  15. web_services - includes the MyLegalFirewall web service support.