L_OK = 0
Define some variables which need to be globally accessible and some general purpose methods
$knownFederations : mixed|string|int
all known federation, in an array with ISO short name as an index, and localised version of the pretty-print name as value.
The static value is only filled with meaningful content after the first object has been instantiated. That is because it is not possible to define static properties with function calls like _().
createTemporaryDirectory( purpose = installer, failIsFatal = 1) : mixed|string|int
create a temporary directory and return the location
one of 'installer', 'logo', 'test' defined the purpose of the directory
decides if a creation failure should cause an error; defaults to true
the tuple of: base path, absolute path for directory, directory name
listAllIdentityProviders( activeOnly, country) : mixed|string|int
Lists all identity providers in the database adding information required by DiscoJuice.
if set to non-zero will cause listing of only those institutions which have some valid profiles defined.
if set, only list IdPs in a specific country
the list of identity providers
printCountryList( activeOnly) : mixed|string|int
Prepares a list of countries known to the CAT.
is set and nonzero will cause that only countries with some institutions underneath will be listed
Array indexed by (uppercase) lang codes and sorted according to the current locale
getExternalDBEntityDetails( externalId, realm = NULL) : mixed|string|int
get additional details about an institution from the EXTERNAL customer DB (if any; for eduroam, this would be the official eduroam database)
the ID of the institution in the external DB
the function can also try to find an inst by its realm in the external DB
a list of institutions, ideally with only one member