• What is a Project File and how is it used?
• Description of the fields used at present.

A Project File is the main file in a new project. I this file are all paths which are needed to parse a content-file.

Projectfiles are normal text files and you can edit them with every texteditor. The Extention of the Authors Project Files are always ".ini" but you can name them like you want!

Example of a Project File:

If a semikolon (;) is at the start of a line, the entire line is interpreted as comment and is not considered by the parser. You can insert as many as desired comments.
Note: Whitin a contents line comments are not permitted!

On the left side is alwaay the field name, followed from the separator ":=" and the value of the field.

• HOME
  Indicates the path to that directory, under which all files are. The specification is optional. If you define HOME, this value must be defined in the first place in the Project File! If you do not use HOME, you have to use the absolute path everywhere.
• TAGS
  Indicates the path to that file, which contains the definition of the tags, which the parser has to replace.
• TEMPLATE
  The path to the template, with which the content page has to be parsed.
• MENU
  This file contains the menu definitions for the homepage
• MENUTEMPLATE
  The path to the template, with which the menu definitions has to be parsed.

Those are at present all fields, which are used from the Project File reader. With future versions of phpCMS new fields can be added.

If you do not use $home then you always have to write the paths absolutely to the document root of your webserver. Only then it is guaranteed that the parser also finds these files.