niota

fascinating. logical.

User Tools

Site Tools


niota-docs:niota_install_clients

This is an old revision of the document!


setting up a client

Introduction

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.

url.html
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.

url.html
http://localhost/niota/app/login.php?client=system

For example:
my-department.my-server/niota/app/login.php?client=myclient 1)

folder structure

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'

this files are mandatory for a client configuration and must be found in the client's home folder

connections.php
debug_defaults.php
formatting_defaults.php
hosts.php
system_defaults.php

create a client

Make a copy of folder 'client_sample' and rename it to your desired name. In case there is no client.ini file in your conf folder, make a copy of file 'client.sample.ini' and rename it exactly 'client.ini'. In file client.ini redefine the following section:

[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

1)
Figure 1 - URL with client parameter
2)
Figure 4 - client folder and client.ini file content
niota-docs/niota_install_clients.1745502718.txt.gz · Last modified: 2025/07/17 14:11 (external edit)