In the element info, there are some purely indicative informations about the application, like its name, a description, the copyright, the creator name etc. Note that this element can be used also in module.xml files to identify a module. Here is an example:

<info id="testapp@jelix.org" name="testapp" createdate="2017-01-01">
    <version>1.0</version>
    <label lang="en_US">Testapp</label>
    <description lang="en_US">Application to test Jelix</description>
    <licence URL="http://www.gnu.org/licenses/gpl.html">GPL</licence>
    <copyright>2017 Laurent Jouanneau and other contributors</copyright>
    <creator name="Laurent Jouanneau" email="laurent@jelix.org"/>
    <contributor name="Superman" email="superman@superville.com"/>
    <homepageURL>http://jelix.org</homepageURL>
</info>

Only the <version> element and attributes id and name on <info> are required. Others are optionals.

The id attribute should be a unique identifiant. That's why it is recommended to use an email as an identifiant (or a UUID but it is less readable).

The attribute name should be a "technical" name (the name of the directory of the application or of the module for instance). The label element can contain a displayable name.

Usually its parameters are at the beginning of file. They define default or global values of the framework.

locale = "en_US"
charset = "UTF-8"
timeZone = "US/Pacific"

theme = default

domainName=

forceHTTPPort=
forceHTTPSPort=

chmodFile=0664
chmodDir=0775

Parameters in details :

• locale, charset: default language and encoding of responses
• timeZone: set the time zone for every date and time functions
• theme: default selected theme. Read theme system description.
• domainName: domain name of the application. Most of time you can leave empty if $_SERVER['SERVER_NAME'] is correctly set. Else indicate the domain name so Jelix could generate correctly URLs of the application
• forceHTTPPort, forceHTTPSPort: When the application is behind a reverse proxy, the current port of http or https may not be the same port of the frontend. Set them to on or with the right port value when this is the case.
• chmodFile, chmodDir: chmod values for files created by Jelix

Contains the list of all enabled modules, parameters for their installers, and other informations when needed.

List all coordinator plugins Jelix has to activate. They will be loaded from the list of path declared with jApp::declarePluginsDir() in the file application.init.php.

The example below demonstrates the activation of an authentication plugin. Its own set of options are defined in auth.coord.ini.php file. Learn more about authentication.

[coordplugins]
auth = "auth.coord.ini.php"

To know more about configuration of coordinator plugins.

this section allows to customize each response type and its alias. each line consists of a couple <response alias>=<response class>.

As for example, it is usual to overload html default response (jResponseHtml) by such a line html=myhtmlresponse. Find more details in customizing common response

Below are the default alias and response types:

[responses]
html = jResponseHtml
redirect = jResponseRedirect
redirectUrl = jResponseRedirectUrl
binary = jResponseBinary
text = jResponseText
jsonrpc = jResponseJsonrpc
json = jResponseJson
xmlrpc = jResponseXmlrpc
xml = jResponseXml
zip = jResponseZip
rss2.0 = jResponseRss20
atom1.0 = jResponseAtom10
css= jResponseCss

Defines the behavior of some components which "compile" some files into the temp directory. This is the case of the template engine (Find in-depth details in templates), but also jDao, jForms...

[compilation]
sourceFileResolutionInCache = off
checkCacheFiletime  = on
force  = off

• sourceFileResolutionInCache: if on, it memorize into a cache the target file. It is particulary useful in production, for templates or locales for exemple, for which files can be found in different directories.
• checkCacheFiletime: if on the source file will be compiled if its file modification date is more recent than its already PHP compiled file.
• force: if on, target file is systematically compiled

There is an option to globally disable zone caching. It is useful during development environment but should be set to off in production.

To disable zone caching :

[zones]
disableCache = on  # default to off

Configuration du moteur d'urls

[urlengine]

multiview = off

scriptNameServerVariable =
pathInfoInQueryParameter =

basePath = ""
jelixWWWPath = "jelix/"

Détails des paramètres :

• multiView: if the parameter multiview or acceptpathinfo is activated into the Apache configuration or if Nginx is configured in a specific manner, it is possible to have urls without the ".php" suffix. It this is the case, set this parameter to on so Jelix will generate urls without .php.
• scriptNameServerVariable: contain the variable name $_SERVER that contain the script name. Example: if you call http://mysite.com/foo/index.php, this is the variable which contain /foo/index.php. This name could be SCRIPT_NAME, ORIG_SCRIPT_NAME, PHP_SELF or REDIRECT_SCRIPT_URL. Most of time it is automatically detected by Jelix, but sometime it could fail, so you must indicate the name here.
• pathInQueryParameter: if you are using some rewrite rules that move the pathinfo into a query parameter, like RewriteRule ^(.*)$ index.php/?jpathinfo=$1 [L,QSA] then you should indicate into pathInfoInQueryParameter the name of the parameter, here jpathinfo. Keep empty if you are not using such rewrite rules.
• basePath: this parameter is the web path to your index.php. Example: if you access to your application by http://foo.com/aaa/bbb/www/index.php then your base path is /aaa/bbb/www/. Or if the url is http://foo.com/index.php, then just indicate /. Keep empty to let Jelix to detect it automatically.
• jelixWWWPath : contains web path to web ressources of Jelix, those which are stored into lib/jelix-www/.

There are also other parameters to install the application behind a reverse proxy. See the chapter to configure the app on a production server.

notfound ¶

notfoundAct ="mymodule~main:errornotfound"