Page Extension to be parsed
Extension of content files to be parsed by phpCMS
Each file has an extension. HTML-files usually end with ".html" or ".htm".
This setting tells phpCMS what extension files have that it should look out for and parse.
In addition the web server has to be configured so as to send files with this extension to the parser (e.g. via a .htaccess file).
Default configuration is ".htm".
Regular HTML-files might be given the extension ".html" and phpCMS-files the extension ".htm". But even ".htm"-files that do not contain phpCMS fields would be passed through unchanged.
Name of Default Page
Page to display when directory is requested
When a client sends a request that does not specify a page name phpCMS will try to display this page.
Example: If your default page is set to "index" and your page extension is ".htm", then a request for http://server.com/docs/ would return http://server.com/docs/index.htm, if it exists.
Extension for Templates
File extension of template files
The file extension used for templates can of course also be chosen freely.
But the parser must know it...
Global Project File
Optional: project file valid for entire project
Here a global project-file can be defined that is used if a requested content-file contains phpCMS fields but no project-file or an invalid project-file is defined there.
Global Home-Directory for all Projects
Optional: home directory valid for entire project
Here a global home-directory can be defined that is used if the project-file doesn't contain a value to set the home-directory.
Plug-In Directory
Directory that stores phpCMS plug-ins
The directory containing the Plug-Ins for phpCMS. Throughout your project you may use "/parser/plugs" to access this directory.
Field-Delimiter Start Tag
Character signaling start of field
With this character the start of a field in templates and content-files is marked.
Field-Delimiter End Tag
Character signaling end of field
With this character the end of a field in templates and content-files is marked.
Use PAXPHP in your files
Parse embedded PHP code
PAXPHP lets you use regular PHP code within content, and template files.
So called DynaTags are an application of PAXPHP. DynaTags are user-defined tags that are substituted by a PHP expression marked up as PAXPHP
Parse PAX TAGS
Execute hard coded PAX TAGS
PAX TAGS are special functions that are hard coded within the PAX-Module.
Available PAX TAGS are: PAXINC, PAXLASTMOD, PAXCOMBO, PAXCOMBOALL, PAXMENU, PAXHIGLIGHT and PAXRTF.
Mail2Crypt (Anti Spam)
Hide e-mail addresses from SPAM bots
By using a tag like <!-- MAIL2CRYPT mail@domain.xyz --> e-mail addresses are scrambled on the fly to protect them from being harvested by SPAM bots. When turned off, addresses inside the tag are displayed as plain text. Mail2Crypt is configurable. See the manual for details. (Currently still under “PAX”)
In phpCMS 1.2.0 and higher Mail2Crypt is fully integrated into the Parser and works independent of PAX.
Mail2Crypt JavaScript Directory
Path to Mail2Crypt JS file
Here you may specify the path to the directory that contains the Mail2Crypt JavaScript file. The file "js_mail2crypt.js" which is needed to display scrambled e-mail addresses in the browser is located in the document root by default.
Mail2Crypt Icon Directory
Path to Mail2Crypt icon file
Here you may specify the path to the directory that contains the Mail2Crypt icon files. The Mail2Crypt standard icons are located in "/parser/gif/" by default.
Server Cache / Server Cache Directory
Allow storage and reuse of parsed pages on the server
Pages and parts of pages that have already been parsed by phpCMS can be stored (cached) on the server for reuse. A page thus cached does not have to be re-parsed on subsequent requests. Through this technique phpCMS significantly reduces the server’s response time.
When deactivating this feature the server cache needs to be cleaned (flushed) manually since pages still in the cache otherwise remain to be served to visitors.
Note to Linux users: PHP needs to have write access to the cache directory. Should you not want to grant write access - e.g. for security reasons - the phpCMS cache feature can not be used.
Client Cache
Allow storage of pages in the browser
Gives visitor’s browsers permission to store pages in their local cache. This setting takes effect for pages that are, or could be, cached server side. If this is not the case (e.g. because pages contain dynamic plug-ins) phpCMS deactivates this setting automatically.
Live time of Proxy/Client Cache in days:
Amount of time pages may be stored by clients
Specifies the amount of time clients are allowed to keep pages stored in local cache. After this time clients must send a request for a fresh copy of a page. This setting will be ignored if pages contain dynamic content, i.e. scripts or dynamic plug-ins.
A value of "1" means that proxy servers or clients must request a fresh copy of a page after one day.
G-Zip Compression
Compress pages before transmission
Specifies whether G-Zip compression should be used to transmit pages if available. All of today’s major browsers can handle G-Zip compressed files.
With this option switched on HTML files will be compressed in size by up to 70% before they are transmitted over the Internet. Pages thus transmitted load faster in your visitors’ browsers, and cause less traffic volume on your server!
This feature can be used only if PHP runs with the "zlib" extension loaded. Please refer to the PHP documentation for further details...
File-Stealth-Mode
Make URLs search engine friendly
Use of this feature is recommended.
In Stealth-Mode pages are accessed through “normal” looking URLs, i.e. without the “parser.php?file=” showing in the address bar. This makes sure that pages can be found and are indexed by search engines. Search engines often will not index pages whose URL contains a “?”!
Stealth-Mode requires that you be able to use .htaccess files to configure your server. If you cannot use .htaccess files and cannot configure your server so that ".htm" files will be parsed by phpCMS, this feature must be deactivated.
Secure Stealth-Mode
Disallow access to secured directories
Use of this feature is recommended.
Secure Stealth-Mode blocks requests via “parser.php?file=filename.htm” to prevent unauthorized access to files located in directories secured through a .htaccess file.
Non-changeable extensions in Non-Stealth-Mode
File types not to be sent to the Parser
Specifies extensions of files references to which, in Non-Stealth-Mode, should not be changed to "parser.php?file=".
In Non-Stealth-Mode HTML links are automatically converted so that requests are correctly sent to the Parser. Here you may specify those kinds of files links to which should remain unchanged.
Error on empty TAG
Handling of empty substitute tags
With this option activated an error-message will be displayed should a tag be encountered that does not have its substitution string defined.
When deactivated, such a tag will be substituted with an empty string, i.e. it will not produce any output in the parsed page.
Debug-Mode
Display error messages during development cycle
When Debug-Mode is activated phpCMS’s internal error messages will be displayed if a file cannot be found or some other error occurs.
In Debug-Mode you may also use the phpCMS Debug-Tool. The Debug-Tool can be accessed by appending “?debug” to the URL of any content page.
Custom Error-Page / Custom 404-Error-Page
Use of customized error pages
When Debug-Mode is not activated, the Error-Page will be displayed should phpCMS encounter an internal error condition.
Special treatment is given to “Error 404s”. Since, from the server’s perspective, the file “parser.php” is the only one that is ever requested, the server cannot detect a missing content page and, consequently, cannot generate a 404 error message.
The difference between the regular “Error-Page” and the 404-Error-Page is that the 404-Error-Page is not sent via HTTP redirect, but instead is send directly by and though the parser. This way the status of the browser address bar remains unchanged.
In the event that no 404-Error-Page is specified or none exists, the regular Error-Page will be displayed.
Send P3P Header
Send P3P statement with HTTP header
P3P stands for “Platform for Privacy Preferences Project”. P3P offers a way to send machine readable privacy information to the browser. Some browsers base the acceptance of cookies on this information.
A starting point for finding further information is http://w3c.org/P3P/...
Global P3P Policy Header
Content of global P3P header
Here you may enter the machine readable P3P compact policy.
P3P Policy href
Directory of P3P Policy
Directory that stores the comprehensive P3P privacy policy. Usually this is “/w3c/p3p.xml”.
Statistics
Activate phpCMS’s statistics feature
This will activate phpCMS’s statistics function. When activated, phpCMS logs information about every request it handles which can then be viewed through the statistics module in the GUI.
Statistics-Directory / Log-Directory / Backup-Directory
Statistics data directories
Specifies directories for storing several statistics data. phpCMS needs write permission for these directories!
Statistics - Log File
Name of the statistics log file
Name of the log file that stores raw data on every page request.
Referrer Logging
Log and display top and last referrer data
Keeps a log of referrers that point to your site. This function works independently of the statistics module. To display a list of top and last referrers on your pages, you may use the plug-in "topref.php", located in the plug-ins directory, which can be integrated as a plug-in, script or via PAX.
Referrer - Directory
Directory of referrer log file
Directory that is used to store the referrer log file. phpCMS needs write permission for this directory!
Referrer - Log File
Name of referrer log file
Specifies the name of the log file that stores referrer data.
Referrer - Reload Lock
Duration of referrer reload lock
Specifies the amount of time in seconds during which repeat page requests originating from the same client IP will be ignored. This prevents, to some extent, an unwanted “counting up” of top referrers.
Startup directory of FileManager
Default display of the FileManager
Specifies which directory should be displayed in the FileManager when it is opened from the main navigation.
Show dirsize in FileManager
Calculate directory sizes
Specifies whether the size of directories should be calculated. Since this requires some heavy processing when a directory contains many files, it may lead to performance problems on slow servers or servers that are under high load.
Size of Editing Area in FileManager
Adjust dimensions of editing area
Specifies the dimensions of the editing area in the FileManager.
Shorten display of long file names
Length of file names displayed in FileManager
Specifies how many characters of file names should be displayed in the FileManager.
Shorten display of long URL aliases in CacheView
Length of URL aliases displayed in FileManager
Specifies how many characters of URL aliases should be displayed in the FileManager.