This is an old revision of the document!
A client is a group of configuration settings by a specified name. The name of the client is an identifier that has to be provided mandatary in the URL of the login page.
Each client has got its own connection-, formatting-, system-default, … file, image folder, script folder, etc. There can be multiple clients defined inside one niota installation. A client can be addressed by the ?client= parameter in the URL of the login page.
https://localhost/niota/app/login.php?client=ABC
All client specific data are located in folder conf below your niota root folder. At the very beginning you may download a sample conf folder from niota download page and adapt given samples to your needs.
Please take care not to update your conf folder with sample data after go live! An update package or a product fix should not update your conf folder
There is always a system (default) client configured. The home folder of the system default client is located in app/conf folder. Avoid to change the system (default) client. Use an own client instead
You can address the system client by explicitly adding the ?client=system parameter at the end of the login URL.
http://localhost/niota/app/login.php?client=system
For example:
my-department.my-server/niota/app/login.php?client=myclient
1)
Client-folders are placed inside niota/conf folder. Each client has a home or root folder and must have a specified set of config files in a given structure below the root folder.
One client is bound to exactly one configuration folder in file 'client.ini'
connections.php debug_defaults.php formatting_defaults.php hosts.php system_defaults.php </code === create a client === Make a copy of folder 'client_sample' and name it - for example 'myclientfolder'. Also make a copy of file 'client.sample.ini' and name it exactly '**client.ini**'. In file client.ini redefine the following section: <code> [SAMPLE] conffolder=client_sample [/SAMPLE]
Client name has to be defined inside brackets […] and it is also necessary to define the name of the new client folder - it is 'myclientfolder' in the previous example. The content of the client.ini file is the following according to the examples:
[MYCLIENT] conffolder=myclientfolder [/MYCLIENT]
After finishing these steps niota has the following folder structure:
2)
Client set up continues with system, connection and formatting configuration:
default system configuration
configure connections
configure format / look and feel