Subversion Repositories wimsdev

Each wims module has a private home directory in which go all the files

Each wims module has a private home directory in which go all the files

A module must have at least the following files:

A module must have at least the following files:

<ul>

<ul>

$tit A variable definition file $emph var.def$emphend. $titend

$tit A variable definition file $emph var.def$emphend. $titend

 This file defines $emph external$emphend variables of the module. A parameter given by the

 This file defines $emph external$emphend variables of the module. A parameter given by the

 user must have a name declared in this file, except parameter names reserved by

 user must have a name declared in this file, except parameter names reserved by

 wims (cmd, session, module, ...). And exactly variables declared in this

 wims (cmd, session, module, ...). And exactly variables declared in this

 file will be saved in the session directory (to be recalled at the next

 file will be saved in the session directory (to be recalled at the next

 request from the same session).

 request from the same session).

$tit A variable processing file $emph var.proc$emphend.$titend

$tit A variable processing file $emph var.proc$emphend.$titend

 This file is processed at EACH request of the module (except special

 This file is processed at EACH request of the module (except special

 requests: when cmd=intro or getins).

 requests: when cmd=intro or getins).

$tit A main phtml file $emph main.phtml$emphend.$titend

$tit A main phtml file $emph main.phtml$emphend.$titend

 This file will be processed at avery request to the module, except under

 This file will be processed at avery request to the module, except under

$tit An indexing file $emph INDEX$emphend, which defines the application's nature.$titend

$tit An indexing file $emph INDEX$emphend, which defines the application's nature.$titend

 This file will be used by wims database for searching available modules.

 This file will be used by wims database for searching available modules.

<p>

<p>

And it may often contain the following (optional) files too:

And it may often contain the following (optional) files too:

<ul>

<ul>

$tit A variable initialisation file $emph var.init$emphend.$titend

$tit A variable initialisation file $emph var.init$emphend.$titend

 This file has the same syntax as the file $emph var.proc$emphend, and is processed

 This file has the same syntax as the file $emph var.proc$emphend, and is processed

 exactly at requests with cmd=new or cmd=renew.

 exactly at requests with cmd=new or cmd=renew.

$tit A introductory page $emph intro.phtml$emphend.$titend

$tit A introductory page $emph intro.phtml$emphend.$titend

 This is a phtml file, which is processed when the module is

 This is a phtml file, which is processed when the module is

 accessed with cmd=intro. It is usually used to introduce the content of the

 accessed with cmd=intro. It is usually used to introduce the content of the

 module, and to let the user choose starting options.

 module, and to let the user choose starting options.

</ul>

</ul>

<p>There may be any number of other files, like a $emph README$emphend file, one or more

<p>There may be any number of other files, like a $emph README$emphend file, one or more

help pages, an $emph about$emphend page, one or more graphics files, files called by one

help pages, an $emph about$emphend page, one or more graphics files, files called by one

of the above mandatory or optional files, etc.

of the above mandatory or optional files, etc.

The files $emph var.init$emphend and $emph var.proc$emphend,

The files $emph var.init$emphend and $emph var.proc$emphend,

as well as any files called by these two

as well as any files called by these two

A variable processing file is divided into lines, separated by

A variable processing file is divided into lines, separated by

non-escaped new-line characters. A new-line character can be escaped by the

non-escaped new-line characters. A new-line character can be escaped by the

character $emph \$emphend, in which case it does not separate the two lines

character $emph \$emphend, in which case it does not separate the two lines

before and after it.

before and after it.

Every line of a variable processing file must be one of the following:

Every line of a variable processing file must be one of the following:

<ol>

<ol>

 <li>A comment line, whose first non-space character is either the character

 <li>A comment line, whose first non-space character is either the character

  $emph #$emphend, or $emph!$emphend followed by another $emph!$emphend.

  $emph #$emphend, or $emph!$emphend followed by another $emph!$emphend.

 <li>A variable definition line, in the form of

 <li>A variable definition line, in the form of

  $emph name$emphend=$(emph)value$emphend. The content of

  $emph name$emphend=$(emph)value$emphend. The content of

  $(emph)value$emphend may be a string (if this string contains a new-line

  $(emph)value$emphend may be a string (if this string contains a new-line

  character, it must be escaped by the character $emph \$emphend), or a wims

  character, it must be escaped by the character $emph \$emphend), or a wims

  variable command (which must then start with the character $emph!$emphend).

  variable command (which must then start with the character $emph!$emphend).

  $emph!$emphend, followed by the command name and optional parameters.

  $emph!$emphend, followed by the command name and optional parameters.

  <br/>If the command produces an output string, this output will be ignored.

  <br/>If the command produces an output string, this output will be ignored.

  $emph:$emphend, followed by the name of the label. Anything following the

  $emph:$emphend, followed by the name of the label. Anything following the

  label name will be considered as comment and ignored by the interpreter.

  label name will be considered as comment and ignored by the interpreter.

  <br/>Label is used in conjunction with the jumping command

  <br/>Label is used in conjunction with the jumping command

  $emph!goto$emphend.

  $emph!goto$emphend.

  <br/>A label starting with the character '*' is catch-all, matching any  

  <br/>A label starting with the character '*' is catch-all, matching any  

  $emph!goto$emphend label.

  $emph!goto$emphend label.

  message.

  message.

</ol>

</ol>

<hr/><h4>Phtml files</h4>

<hr/><h4>Phtml files</h4>

The files main.phtml and intro.phtml, as well as any files called by these

The files main.phtml and intro.phtml, as well as any files called by these

two files, are phtml files (programmable html).

two files, are phtml files (programmable html).

A phtml file is an ordinary html file, except for lines whose

A phtml file is an ordinary html file, except for lines whose

first non-space character is a $emph!$emphend or a $emph:$emphend.

first non-space character is a $emph!$emphend or a $emph:$emphend.

Lines can be escaped by $emph\$emphend, just as in the case of a variable

Lines can be escaped by $emph\$emphend, just as in the case of a variable

processing file.

processing file.

A line starting with $emph:$emphend is a label line, as in the case of a

A line starting with $emph:$emphend is a label line, as in the case of a

variable processing file.

variable processing file.

A line starting with $emph!$emphend is a command line, as in the case of a

A line starting with $emph!$emphend is a command line, as in the case of a

variable processing file. To the difference that if the command produces an

variable processing file. To the difference that if the command produces an

output string, this output will be inserted into the html page, at the place

output string, this output will be inserted into the html page, at the place

of the line.

of the line.

Lines not of the above two types will be sent to the http client, after

Lines not of the above two types will be sent to the http client, after

substitution of variables.

substitution of variables.