System Folder Notes
-------------------------
The System folder holds all the logic used by the web application. Everything that allows the program to run and function is contained here. Most of these files are accessed as ASP 'includes'. So all web pages share the same processing pages contained inside this System folder. Therefore, any changes made to any of the files in this folder affect nearly every page in the system. Because of this, it is possible to remove specific pages accessed from the System folder by either commenting out the pages 'include' to that page, or commenting out or deleting the code inside the System pages themselves.

Because some pages are absoluetly necessary to basic data pulls and display functionality, those System files are marked the starting word "System". For example: "SystemSettings.asp" is a required file. Deleting or altering this file could shut down all web pages in the application, and create system wide errors.

Menu, message, and error capture pages may be commented or removed if necessary but still may cause issues with the application and how it runs. For example, if you removed ALL "ErrorMessage" files in the System folder by commenting out their include statements as found in the "PAGE" includes, your app may appear to run correctly but any error will cause a white page to appear with errors printed to the users browser window, rather than captured neatly at the bottom of the web page. If you have blocks of visual elements you need to remove, its best to either use the Settings module to change those items, or create a new style sheet skin based on the default skin and hide areas as needed in the web application interface.

In general, the System folder and its include file system is designed for maximum flexibility, simplicity, and control by the developer over the web application, so that he/she may go in and safely comment out or delete non-essential includes accessed from the System folder if absolutely necessary with minimal interference in how the app runs. Certain pages may also need to be hidden, revealed, modified, recoded, or deleted from the system, so exercise care when doing that. Just remember, changes made in the System folder affect all pages and features in the system that use them. Only module specifict featurs and functionality may not use these System files when say pulling data or styling their content, so you may modify those on a module-by-module basis.

--------------------------

In general we cannot support changes made to any file included under the Systems folder, or any file inside the web application, as a whole. Any customization is allowed under the license for the software, but we cannot address bugs or errors generated by code customization and modification made by outside parties. At intervals, when newer versions are released, or when special update files are written for certain files found in System, we will update files therein and support those changes via documentation on our web site, as they become available.

- White Pacific Software, www.whitepacificsoftware.com