Library of admin functions. More...

Functions
	versiontostring ($versionarray)
	Return a version in a string from a version into an array.

	versioncompare ($versionarray1, $versionarray2)
	Compare 2 versions (stored into 2 arrays), to know if a version (a,b,c) is lower than (x,y,z) To check using a string version do a preg_split('/[.

	versionphparray ()
	Return version PHP.

	versiondolibarrarray ()
	Return version Dolibarr.

	run_sql ($sqlfile, $silent=1, $entity=0, $usesavepoint=1, $handler='', $okerror='default', $linelengthlimit=32768, $nocommentremoval=0, $offsetforchartofaccount=0, $colspan=0, $onlysqltoimportwebsite=0, $database='')
	Launch a sql file.

	dolibarr_del_const ($db, $name, $entity=1)
	Delete a constant.

	dolibarr_get_const ($db, $name, $entity=1)
	Get the value of a setup constant from database.

	dolibarr_set_const ($db, $name, $value, $type='chaine', $visible=0, $note='', $entity=1)
	Insert a parameter (key,value) into database (delete old key then insert it again).

	modules_prepare_head ($nbofactivatedmodules, $nboftotalmodules, $nbmodulesnotautoenabled)
	Prepare array with list of tabs.

	ihm_prepare_head ()
	Prepare array with list of tabs.

	security_prepare_head ()
	Prepare array with list of tabs.

	modulehelp_prepare_head ($object)
	Prepare array with list of tabs.

	translation_prepare_head ()
	Prepare array with list of tabs.

	defaultvalues_prepare_head ()
	Prepare array with list of tabs.

	listOfSessions ()
	Return list of session.

	purgeSessions ($mysessionid)
	Purge existing sessions.

	form_constantes ($tableau, $strictw3c=2, $helptext='', $text='')
	Show array with constants to edit.

	showModulesExludedForExternal ($modules)
	Show array with constants to edit.

	addDocumentModel ($name, $type, $label='', $description='')
	Add document model used by doc generator.

	delDocumentModel ($name, $type)
	Delete document model used by doc generator.

	phpinfo_array ()
	Return the php_info into an array.

	company_admin_prepare_head ()
	Return array head with list of tabs to view object information.

	email_admin_prepare_head ()
	Return array head with list of tabs to view object information.

	GetContentPolicyDirectives ()
	Prepare array of directives for HTTP headers.

	GetContentPolicySources ()
	Prepare array of sources for HTTP headers.

	GetContentPolicyToArray ($forceCSP)
	Transform a Content Security Policy to an array.

Detailed Description

Library of admin functions.

Definition in file admin.lib.php.

Function Documentation

◆ addDocumentModel()

addDocumentModel	(	$name,
		$type,
		$label = '',
		$description = '' )

Add document model used by doc generator.

Parameters

string	$name	Model name
string	$type	Model type
string	$label	Model label
string	$description	Model description

Returns: int Return integer <0 if KO, >0 if OK

Definition at line 2010 of file admin.lib.php.

References $conf, $db, dol_print_error(), and dol_syslog().

◆ company_admin_prepare_head()

company_admin_prepare_head ( )

Return array head with list of tabs to view object information.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 2099 of file admin.lib.php.

References $conf, and complete_head_from_modules().

◆ defaultvalues_prepare_head()

defaultvalues_prepare_head ( )

Prepare array with list of tabs.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 1023 of file admin.lib.php.

References $conf, and complete_head_from_modules().

◆ delDocumentModel()

delDocumentModel	(		$name,
			$type )

Delete document model used by doc generator.

Parameters

string	$name	Model name
string	$type	Model type

Returns: int Return integer <0 if KO, >0 if OK

Definition at line 2041 of file admin.lib.php.

References $conf, $db, dol_print_error(), and dol_syslog().

◆ dolibarr_del_const()

dolibarr_del_const	(	$db,
		$name,
		$entity = 1 )

Delete a constant.

Parameters

DoliDB	$db	Database handler
int \| string	$name	Name of constant or rowid of line
int	$entity	Multi company id, -1 for all entities

Returns: int Return integer <0 if KO, >0 if OK

See also: getDolGlobalString(), dolibarr_get_const(), dolibarr_set_const(), dol_set_user_param()

Definition at line 581 of file admin.lib.php.

References $conf, $db, dol_print_error(), and dol_syslog().

◆ dolibarr_get_const()

dolibarr_get_const	(	$db,
		$name,
		$entity = 1 )

Get the value of a setup constant from database.

This method is used only when you need toget a constant and can't use getDolGlobalXXX method because you need a constant that is saved into another entity.

Parameters

DoliDB	$db	Database handler
string	$name	Name of constant
int	$entity	Multi company id

Returns: string Value of constant

See also: getDolGlobalString(), dolibarr_del_const(), dolibarr_set_const(), dol_set_user_param()

Definition at line 637 of file admin.lib.php.

References $db, and dolDecrypt().

◆ dolibarr_set_const()

dolibarr_set_const	(	$db,
		$name,
		$value,
		$type = 'chaine',
		$visible = 0,
		$note = '',
		$entity = 1 )

Insert a parameter (key,value) into database (delete old key then insert it again).

Parameters

DoliDB	$db	Database handler
string	$name	Name of constant
int \| string	$value	Value of constant
string	$type	Type of constant. Deprecated, only strings are allowed for $value. Caller must json encode/decode to store other type of data.
int	$visible	Is constant visible in Setup->Other page (0 by default)
string	$note	Note on parameter
int	$entity	Multi company id (0 means all entities)

Returns: int -1 if KO, 1 if OK

See also: getDolGlobalString(), dolibarr_del_const(), dolibarr_get_const(), dol_set_user_param()

Definition at line 672 of file admin.lib.php.

References $conf, $db, dol_print_error(), dol_syslog(), dolEncrypt(), and string.

Referenced by modGeneratePassPerso\__construct(), DolibarrApiAccess\__isAllowed(), BlockedLog\getOrInitFirstSignature(), mod_codeclient_elephant\info(), modEventOrganization\init(), modProductBatch\init(), modTakePos\init(), migrate_accountingbookkeeping(), migrate_blockedlog_add_hmac_key(), migrate_invoice_export_models(), FormSetupItem\saveConfValue(), and top_htmlhead().

◆ email_admin_prepare_head()

email_admin_prepare_head ( )

Return array head with list of tabs to view object information.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 2138 of file admin.lib.php.

References $conf, complete_head_from_modules(), getDolGlobalString(), and isModEnabled().

◆ form_constantes()

form_constantes	(	$tableau,
		$strictw3c = 2,
		$helptext = '',
		$text = '' )

Show array with constants to edit.

Parameters

	array<string,array{type:string,label:string,tooltip?:string}>\|array<int,string>	$tableau Array of constants array('key'=>array('type'=>type, 'label'=>label, 'tooltip'=>tooltip) where type can be 'string', 'text', 'textarea', 'html', 'yesno', 'emailtemplate:xxx', ...
	int<2,3>	$strictw3c 0=Include form into table (deprecated), 1=Form is outside table to respect W3C (deprecated), 2=No form nor button at all, 3=No form nor button at all and each field has a unique name (form is output by caller, recommended) (typed as int<2,3> to highlight the deprecated values)
string	$helptext	Tooltip help to use for the column name of values
string	$text	Text to use for the column name of values

Returns: void

Definition at line 1785 of file admin.lib.php.

References $conf, $db, dol_escape_htmltag(), dol_syslog(), dolBuildUrl(), img_down(), img_picto(), and isModEnabled().

◆ GetContentPolicyDirectives()

GetContentPolicyDirectives ( )

Prepare array of directives for HTTP headers.

Returns: array<string,array<string,string>> Array of directives

Definition at line 2201 of file admin.lib.php.

◆ GetContentPolicySources()

GetContentPolicySources ( )

Prepare array of sources for HTTP headers.

Returns: array<string,array<string,array<string,string>>> Array of sources

Definition at line 2243 of file admin.lib.php.

Referenced by GetContentPolicyToArray().

◆ GetContentPolicyToArray()

GetContentPolicyToArray ( $forceCSP )

Transform a Content Security Policy to an array.

Parameters

string $forceCSP Content security policy string

Returns: array<string,array<string|int,array<string|int,string>|string>> Array of sources

Definition at line 2298 of file admin.lib.php.

References GetContentPolicySources().

◆ ihm_prepare_head()

ihm_prepare_head ( )

Prepare array with list of tabs.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 810 of file admin.lib.php.

References $conf, complete_head_from_modules(), and dolBuildUrl().

◆ listOfSessions()

listOfSessions ( )

Return list of session.

Returns: array<string,array{login:string,age:int,creation:null|int|false,modification:int|false,raw:string,remote_ip:?string,user_agent:?string}> Array list of sessions

Definition at line 1075 of file admin.lib.php.

References $conf, dol_osencode(), dol_syslog(), dolListSessions(), getDolGlobalString(), and string.

◆ modulehelp_prepare_head()

modulehelp_prepare_head ( $object )

Prepare array with list of tabs.

Parameters

DolibarrModules $object Descriptor class

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 955 of file admin.lib.php.

References $conf, $object, complete_head_from_modules(), and dolBuildUrl().

◆ modules_prepare_head()

modules_prepare_head	(	$nbofactivatedmodules,
		$nboftotalmodules,
		$nbmodulesnotautoenabled )

Prepare array with list of tabs.

Parameters

int	$nbofactivatedmodules	Number if activated modules
int	$nboftotalmodules	Nb of total modules
int	$nbmodulesnotautoenabled	Nb of modules not auto enabled that are activated

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 764 of file admin.lib.php.

References dolBuildUrl(), getDolGlobalInt(), getDolGlobalString(), and img_picto().

◆ phpinfo_array()

phpinfo_array ( )

Return the php_info into an array.

Returns: array<string,array<string,string|array{local:string,master:string}>> Array with PHP info

Definition at line 2070 of file admin.lib.php.

◆ purgeSessions()

purgeSessions ( $mysessionid )

Purge existing sessions.

Parameters

string $mysessionid To avoid to try to delete my own session

Returns: int >0 if OK, <0 if KO

Definition at line 1139 of file admin.lib.php.

References $conf, dol_osencode(), dol_syslog(), and getDolGlobalString().

◆ run_sql()

run_sql	(	$sqlfile,
		$silent = 1,
		$entity = 0,
		$usesavepoint = 1,
		$handler = '',
		$okerror = 'default',
		$linelengthlimit = 32768,
		$nocommentremoval = 0,
		$offsetforchartofaccount = 0,
		$colspan = 0,
		$onlysqltoimportwebsite = 0,
		$database = '' )

Launch a sql file.

Function is used by:

Migrate process (dolibarr-xyz-abc.sql)
Loading sql menus (auguria)
Running specific Sql by a module init
Loading sql file of website import package Install process however does not use it. Note that SQL files must have all comments at start of line. Also this function take ';' as the char to detect end of sql request

Parameters

string	$sqlfile	Full path to sql file
int	$silent	1=Do not output anything, 0=Output line for update page
int	$entity	Entity targeted for multicompany module
int	$usesavepoint	1=Run a savepoint before each request and a rollback to savepoint if error (this allow to have some request with errors inside global transactions).
string	$handler	Handler targeted for menu (replace HANDLER with this value between quotes)
string	$okerror	Family of errors we accept ('default', 'none')
int	$linelengthlimit	Limit for length of each line (Use 0 if unknown, may be faster if defined)
int	$nocommentremoval	Do no try to remove comments (in such a case, we consider that each line is a request, so use also $linelengthlimit=0)
int	$offsetforchartofaccount	Offset to use to load chart of account table to update sql on the fly to add offset to rowid and account_parent value
int	$colspan	2=Add a colspan=2 on td
int	$onlysqltoimportwebsite	Only sql requests used to import a website template are allowed. This is a security feature to disallow SQL injection when loading a template.
string	$database	Database (replace DATABASE with this value)

Returns: int Return integer <=0 if KO, >0 if OK

Definition at line 174 of file admin.lib.php.

References $conf, $db, checkPHPCode(), dol_htmlentities(), dol_syslog(), dolKeepOnlyPhpCode(), string, and versioncompare().

Referenced by DolibarrModules\_load_tables(), and migrate_reload_menu().

◆ security_prepare_head()

security_prepare_head ( )

Prepare array with list of tabs.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 862 of file admin.lib.php.

References $conf, $db, dol_print_error(), dolBuildUrl(), and getDolGlobalString().

◆ showModulesExludedForExternal()

showModulesExludedForExternal ( $modules )

Show array with constants to edit.

Parameters

DolibarrModules[] $modules Array of all modules

Returns: string HTML string with warning

Definition at line 1960 of file admin.lib.php.

References dol_sort_array(), and getDolGlobalString().

◆ translation_prepare_head()

translation_prepare_head ( )

Prepare array with list of tabs.

Returns: array<array{0:string,1:string,2:string}> Array of tabs to show

Definition at line 993 of file admin.lib.php.

References $conf, complete_head_from_modules(), and dolBuildUrl().

◆ versioncompare()

versioncompare	(		$versionarray1,
			$versionarray2 )

Compare 2 versions (stored into 2 arrays), to know if a version (a,b,c) is lower than (x,y,z) To check using a string version do a preg_split('/[.

-]/', strinversion) to convert the string into an array. To check with Dolibarr version use versiondolibarrarray() to get the array of Dolibarr current version

For example: if (versioncompare(versiondolibarrarray(),array(4,0,-5)) >= 0) is true if version is 4.0 alpha or higher. For example: if (versioncompare(versiondolibarrarray(),array(4,0,0)) >= 0) is true if version is 4.0 final or higher. For example: if (versioncompare(versiondolibarrarray(),array(4,0,1)) >= 0) is true if version is 4.0.1 or higher. Alternative way to compare: if ((float) DOL_VERSION >= 4.0) is true if version is 4.0 alpha or higher (works only to compare first and second level)

Parameters

array<int\|string>	$versionarray1 Array of version (vermajor,verminor,patch)
array<int\|string>	$versionarray2 Array of version (vermajor,verminor,patch)

Returns: int<-4,4> -4,-3,-2,-1 if versionarray1<versionarray2 (value depends on level of difference) 0 if same 1,2,3,4 if versionarray1>versionarray2 (value depends on level of difference)

See also: versiontostring()

Definition at line 72 of file admin.lib.php.

Referenced by ImportCsv\__construct(), ImportXlsx\__construct(), migrate_invoice_export_models(), migrate_restore_missing_links(), and run_sql().

◆ versiondolibarrarray()

versiondolibarrarray ( )

Return version Dolibarr.

Returns: array<int<0,2>,string> Array of version (vermajor,verminor,vermaintenance,other)

See also: versioncompare()

Definition at line 145 of file admin.lib.php.

◆ versionphparray()

versionphparray ( )

Return version PHP.

Returns: array<int<0,2>,string> Tableau de version (vermajeur,vermineur,autre)

See also: versioncompare()

Definition at line 134 of file admin.lib.php.

Referenced by ImportCsv\__construct(), and ImportXlsx\__construct().

◆ versiontostring()

versiontostring ( $versionarray )

Return a version in a string from a version into an array.

Parameters

array<int<0,2>,int|string> $versionarray Array of version (vermajeur,vermineur,autre)

Returns: string String version

See also: versioncompare()

Definition at line 40 of file admin.lib.php.

Functions

Detailed Description

Function Documentation

◆ addDocumentModel()

◆ company_admin_prepare_head()

◆ defaultvalues_prepare_head()

◆ delDocumentModel()

◆ dolibarr_del_const()

◆ dolibarr_get_const()

◆ dolibarr_set_const()

◆ email_admin_prepare_head()

◆ form_constantes()

◆ GetContentPolicyDirectives()

◆ GetContentPolicySources()

◆ GetContentPolicyToArray()

◆ ihm_prepare_head()

◆ listOfSessions()

◆ modulehelp_prepare_head()

◆ modules_prepare_head()

◆ phpinfo_array()

◆ purgeSessions()

◆ run_sql()

◆ security_prepare_head()

◆ showModulesExludedForExternal()

◆ translation_prepare_head()

◆ versioncompare()

◆ versiondolibarrarray()

◆ versionphparray()

◆ versiontostring()