alp.directory configuration
file contains settings about the current directory and its subdirectories. Global
(default) alp.directory file is found in the directory containing iewebsrv.dll. ALP engine
seeks alp.directory file in the current directory (pointed by the URL) and up to the root
of the current site. First found alp.directory file is the only file that takes place when
calculating directory settings. It is mixed with the global alp.directory file and the
resulting configuration is used by the engine.
ALP Settings shell extensions allow you
create and edit these settings more conveniently.
Here is one sample alp.directory file
containing all the possible values. Sample used here is used as a default configuration in
the ALP distribution.
; ALP Directory configuration
{ DIRECTORY:
{ Access:
; Default configuration grants everything
(int)Scripts=1
(int)Read=1
(int)Execute=1
(int)Browsing=1
; Cache record entry is available only in the registered version
; It allows ALP to create cache files for the content of the directory
; and its subtree.
(int)Cache=1
(int)OfflineExecution=1
(string)SecurityURL=http://www.mysite.com
(int)SafeEntrtance=0
(int)ContentIsSecure=0
(int)ContentIsSafe=0
} Access;
{ UseExtensions:
; Force usage of these extensions for the cache files
(string)text/rtf=rtf
} UseExtensions;
{ Documents:
(string)default=Default.asp
(string)default=Default.htm
} Documents;
{ CustomErrors:
(string)FileNotFound=/errs/err.asp
} CustomErrors;
} DIRECTORY;
In the current version (1.0) of the ALP there is only one global section in the
alp.directory file - DIRECTORY. It contains two possible subsections:
- Access - Describes allowed actions in the
directory
- Record (int)Scripts - Can be 0 or 1. This value
corresponds with the (int)IsScriptEngine
value in the subsections sections of the ExecutionMap
section of the alp.application file. Value of 1 allows executing modules
registered as script engines value of 0 denies it.
- Record (int)Read - Can be 0 or 1. Corresponds to the
File subsection of the InternalExecutionMap
section of the alp.application file that defines the component used to
process unknown files. Read value denies (0) or allows (1) processing of the unknown files
in a particular directory or subtree. Typically it was set if the directory contains for
example scripts includes that must not be shown to the user.
- Record (int)Execute - Can be 0 or 1. It denies
(0) or allows (1) execution of the modules handling certain file extensions and are not
registered as script engines - see (int)IsScriptEngine value in the alp.application.
- Record (int)Browsing - Can be 0 or 1. If no
default documents are found in a particular directory (see section below) component
registered for the section Directory
in the InternalExecutionMap
of the alp.application file. Its
purpose is to show the directory listing. Browsing value denies (0) or allows (1) that.
- Record (int)Cache - Allows creation of the cache
files into the Internet Explorer's cache. This option is available only in the registered
versions. It is important to enable caching if you want to use content types passed to
external applications - such as generating RTF files.
- (int)OfflineExecution - 0 - the expired pages are not
executed, for example if you press back to return to a page that
processes a submitted form. 1 - all the requests are executed.
- (int)SafeEntrtance - An URL in this directory will
succeed only if the previously the user has accessed one of the
default documents in the directory.
- (int)ContentIsSecure= - if set to 1 declares the
content as if it comes over an SSL.
- (string)SecurityURL - If exists and non-empty
specifies an impersonalization URL. The content will be treated
by the browser as if it comes from that URL.
- UseExtensions - This content type - file
extension map works together with the Cache option (see above). If caching is enabled it
specifies what file extensions to be used for the cache files created. By default ALP
looks in the HKEY_CLASSES_ROOT\MIME\Database registry key but not all applications
register their content types thus this map can be used to ensure that mapping exist. Also
this map forces using of the file extension specified here - if content type was found
here it will not be searched in the registry.
- Documents - Contains settings about the
documents/files that can be found in the folder.
- Record(s) (string)default - Contain the names of the
documents/resources automatically shown if the URL contains no file/resource name at the
end. Multiply records can be supplied. Search order is the same as the order of the
values.
- CustomErrors - contains virtual paths to pages executed
whenever certain error occurs
- (string)FileNotFound - specifies the file/document
served whenever ALP is unable to map an URL to a physical file.
|