Set up further organizations

Admidio can manage multiple organizations. All data has always been stored as a function of one organization. After the initial installation of Admidio, one organization is available, which can be further set up. Via a wizard, any number of additional organizations can be added later.

By multi-organizational we mean that organizations that have some relationship with each other share one Admidio database. The individual organizations can have their own websites or share a common website.

Organizations that share an Admidio database can access a common person master. If a user works in more than one of these organizations, only one profile is stored for him in the database, which is displayed in all organizations. If the user updates this in organization X, organization Y can view this directly. The assignment to the organizations can be done here, as usual, freely by role assignments. Users with the appropriate rights can access the complete person master and thus make a user, who was previously only set up in organization X, conveniently also a member of their own organization through role assignment. The rights management is still role-dependent, so that a user can be an administrator in one organization and only have the right to maintain his profile in the other organization.

1. Log in to your Admidio installation as administrator and start the wizard to add another organization. You can find the wizard in the settings under Organization. Select the link Add another organization.
   
2. The wizard now first wants to know the abbreviation, the name of the organization, and an email address. The e-mail address will be used, among other things, as the sender address for notifications. Afterwards the organization can be set up with Set up organization.
   
3. The new organization has now been successfully set up.
   
   The following data has been added:
   1. The logged in user has become an administrator of the new organization.
   2. The new organization has got the roles: Administrator, Board and Members.
   3. Various categories have been added to the organization, including global categories.
   4. The list configurations Address list, Phone list, Contact details, Membership and Participants have been added.
4. If you now call the login dialog, a new field Organization appears where you can select the previous and the new organization. Here always the organization from the parameter $g_organization of the configuration file is preselected. To log in to the other organization, it must be selected and the user must be a member of at least one role of that organization.
   

If you have set up more than one organization in your database, there is only one organization from which the data for logged out users is displayed. This is the organization from the parameter $g_organization of the configuration file. The other organizations can be selected during login and are therefore only available to logged in users.

However, if you want to run other organizations as a standalone website, where the data is displayed even when logged out, you need to set up separate Admidio installations for these organizations.

For this purpose the following steps are necessary:

1. The database is set up for the new organization as described in the previous chapter.
2. Now you need to set up a new web space. To do this, download exactly the same Admidio version as in your initial configuration and place it in a new location on your server.
   If you have been using Admidio 3.3.x so far, the new organization must also get version 3.3.x. The version 3.2.x would cause problems. If exactly this version is no longer available, the initial configuration should be updated to the latest version and then this version should also be used for the new organization.
3. Do no installation or update on the new instance.
4. Now copy the config.php of your source installation from the folder adm_my_files to the new folder adm_my_files of your new installation. Then you have to change the variables $g_root_path and $g_organization accordingly. Make sure that the variable $g_root_path in the configuration file points to the correct path of your new organization.
5. Now you can log in to the new organization with the administrator's credentials and continue setting up Admidio.

If the organization selection box should no longer be displayed in the login dialog, it can be switched off in the Settings under Organization with the checkbox Display organization selection.

For future updates, make sure that all installations have the same major version. So organization A has version 3.3 and organization B must then also have version 3.3. If organization B had version 3.2 there would be errors on the page. The sub-version e.g. 3.3.2 can differ, but a synchronous version is recommended here.