A set of functions for Dolibarr This file contains all frequently used functions. More...

Functions
if(!function_exists( 'utf8_encode')) if(!function_exists('utf8_decode')) if(!function_exists( 'str_starts_with')) if(!function_exists('str_ends_with')) if(!function_exists( 'str_contains'))	getMultidirOutput ($object, $module='')
	Return the full path of the directory where a module (or an object of a module) stores its files.

	getDolGlobalString ($key, $default='')
	Return dolibarr global constant string value.

	getDolGlobalInt ($key, $default=0)
	Return a Dolibarr global constant int value.

	getDolUserString ($key, $default='', $tmpuser=null)
	Return Dolibarr user constant string value.

	getDolUserInt ($key, $default=0, $tmpuser=null)
	Return Dolibarr user constant int value.

	isModEnabled ($module)
	Is Dolibarr module enabled.

	getDoliDBInstance ($type, $host, $user, $pass, $name, $port)
	Return a DoliDB instance (database handler).

	getEntity ($element, $shared=1, $currentobject=null)
	Get list of entity id to use.

	setEntity ($currentobject)
	Set entity id to use when to create an object.

	isASecretKey ($keyname)
	Return if string has a name dedicated to store a secret.

	num2Alpha ($n)
	Return a numeric value into an Excel like column number.

	getBrowserInfo ($user_agent)
	Return information about user browser.

	dol_shutdown ()
	Function called at end of web php process.

	GETPOSTISSET ($paramname)
	Return true if we are in a context of submitting the parameter $paramname from a POST of a form.

	GETPOSTISARRAY ($paramname, $method=0)
	Return true if the parameter $paramname is submit from a POST OR GET as an array.

	GETPOST ($paramname, $check='alphanohtml', $method=0, $filter=null, $options=null, $noreplace=0)
	Return value of a param into GET or POST supervariable.

	GETPOSTINT ($paramname, $method=0)
	Return value of a param into GET or POST supervariable.

	checkVal ($out='', $check='alphanohtml', $filter=null, $options=null)
	Return a sanitized or empty value after checking value against a rule.

	sanitizeVal ($out='', $check='alphanohtml', $filter=null, $options=null)
	Return a sanitized or empty value after checking value against a rule.

if(!function_exists( 'dol_getprefix'))	dol_include_once ($relpath, $classname='')
	Make an include_once using default root and alternate root if it fails.

	dol_buildpath ($path, $type=0, $returnemptyifnotfound=0)
	Return path of url or filesystem.

	dol_clone ($object, $native=0)
	Create a clone of instance of object (new instance with same value for each properties) With native = 0: Property that are reference are different memory area in the new object (full isolation clone).

	dol_size ($size, $type='')
	Optimize a size for some browsers (phone, smarphone, ...)

	dol_sanitizeFileName ($str, $newstr='_', $unaccent=1)
	Clean a string to use it as a file name.

	dol_sanitizePathName ($str, $newstr='_', $unaccent=1)
	Clean a string to use it as a path name.

	dol_sanitizeUrl ($stringtoclean, $type=1)
	Clean a string to use it as an URL (into a href or src attribute)

	dol_sanitizeEmail ($stringtoclean)
	Clean a string to use it as an Email.

	dol_string_unaccent ($str)
	Clean a string from all accent characters to be used as ref, login or by dol_sanitizeFileName.

	dol_string_nospecial ($str, $newstr='_', $badcharstoreplace='', $badcharstoremove='', $keepspaces=0)
	Clean a string from all punctuation characters to use it as a ref or login.

	dol_string_nounprintableascii ($str, $removetabcrlf=1)
	Clean a string from all non printable ASCII chars (0x00-0x1F and 0x7F).

	dol_escape_js ($stringtoescape, $mode=0, $noescapebackslashn=0)
	Returns text escaped for inclusion into javascript code.

	dol_escape_json ($stringtoescape)
	Returns text escaped for inclusion into javascript code.

	dol_escape_php ($stringtoescape, $stringforquotes=2)
	Returns text escaped for inclusion into a php string, build with double quotes " or '.

	dol_escape_all ($stringtoescape)
	Returns text escaped for all protocols (so only alpha chars and numbers)

	dol_escape_xml ($stringtoescape)
	Returns text escaped for inclusion into a XML string.

	dolPrintLabel ($s)
	Return a string label (so on 1 line only and that should not contains any HTML) ready to be output on HTML page To use text that is not HTML content inside an attribute, use can simply only dol_escape_htmltag().

	dolPrintHTML ($s, $allowiframe=0)
	Return a string ready to be output on HTML page To use text inside an attribute, you can simply use dolPrintHTMLForAttribute() or dol_escape_htmltag()

	dolPrintHTMLForAttribute ($s)
	Return a string ready to be output on an HTML attribute (alt, title, data-html, ...)

	dolPrintHTMLForTextArea ($s, $allowiframe=0)
	Return a string ready to be output on input textarea To use text inside an attribute, use can use only dol_escape_htmltag()

	dolPrintPassword ($s)
	Return a string ready to be output on an HTML attribute (alt, title, ...)

	dol_escape_htmltag ($stringtoescape, $keepb=0, $keepn=0, $noescapetags='', $escapeonlyhtmltags=0, $cleanalsojavascript=0)
	Returns text escaped for inclusion in HTML alt or title or value tags, or into values of HTML input fields.

	dol_strtolower ($string, $encoding="UTF-8")
	Convert a string to lower.

	dol_strtoupper ($string, $encoding="UTF-8")
	Convert a string to upper.

	dol_ucfirst ($string, $encoding="UTF-8")
	Convert first character of the first word of a string to upper.

	dol_ucwords ($string, $encoding="UTF-8")
	Convert first character of all the words of a string to upper.

	dol_syslog ($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
	Write log message into outputs.

	dolButtonToOpenUrlInDialogPopup ($name, $label, $buttonstring, $url, $disabled='', $morecss='classlink button bordertransp', $jsonopen='', $backtopagejsfields='', $accesskey='')
	Return HTML code to output a button to open a dialog popup box.

	dol_fiche_head ($links=array(), $active='0', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='')
	Show tab header of a card.

	dol_get_fiche_head ($links=array(), $active='', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='', $dragdropfile=0)
	Show tabs of a record.

	dol_fiche_end ($notab=0)
	Show tab footer of a card.

	dol_get_fiche_end ($notab=0)
	Return tab footer of a card.

	dol_banner_tab ($object, $paramid, $morehtml='', $shownav=1, $fieldid='rowid', $fieldref='ref', $morehtmlref='', $moreparam='', $nodbprefix=0, $morehtmlleft='', $morehtmlstatus='', $onlybanner=0, $morehtmlright='')
	Show tab footer of a card.

	fieldLabel ($langkey, $fieldkey, $fieldrequired=0)
	Show a string with the label tag dedicated to the HTML edit field.

	dol_bc ($var, $moreclass='')
	Return string to add class property on html element with pair/impair.

	dol_format_address ($object, $withcountry=0, $sep="\n", $outputlangs='', $mode=0, $extralangcode='')
	Return a formated address (part address/zip/town/state) according to country rules.

	dol_strftime ($fmt, $ts=false, $is_gmt=false)
	Format a string.

	dol_print_date ($time, $format='', $tzoutput='auto', $outputlangs='', $encodetooutput=false)
	Output date in a string format according to outputlangs (or langs if not defined).

	dol_getdate ($timestamp, $fast=false, $forcetimezone='')
	Return an array with locale date info.

	dol_mktime ($hour, $minute, $second, $month, $day, $year, $gm='auto', $check=1)
	Return a timestamp date built from detailed informations (by default a local PHP server timestamp) Replace function mktime not available under Windows if year < 1970 PHP mktime is restricted to the years 1901-2038 on Unix and 1970-2038 on Windows.

	dol_now ($mode='auto')
	Return date for now.

	dol_print_size ($size, $shortvalue=0, $shortunit=0)
	Return string with formated size.

	dol_print_url ($url, $target='_blank', $max=32, $withpicto=0, $morecss='')
	Show Url link.

	dol_print_email ($email, $cid=0, $socid=0, $addlink=0, $max=64, $showinvalid=1, $withpicto=0)
	Show EMail link formatted for HTML output.

	getArrayOfSocialNetworks ()
	Get array of social network dictionary.

	dol_print_socialnetworks ($value, $cid, $socid, $type, $dictsocialnetworks=array())
	Show social network link.

	dol_print_profids ($profID, $profIDtype, $countrycode='', $addcpButton=1)
	Format professional IDs according to their country.

	dol_print_phone ($phone, $countrycode='', $cid=0, $socid=0, $addlink='', $separ=" ", $withpicto='', $titlealt='', $adddivfloat=0)
	Format phone numbers according to country.

	dol_print_ip ($ip, $mode=0)
	Return an IP formated to be shown on screen.

	getUserRemoteIP ()
	Return the IP of remote user.

	isHTTPS ()
	Return if we are using a HTTPS connexion Check HTTPS (no way to be modified by user but may be empty or wrong if user is using a proxy) Take HTTP_X_FORWARDED_PROTO (defined when using proxy) Then HTTP_X_FORWARDED_SSL.

	dolGetCountryCodeFromIp ($ip)
	Return a country code from IP.

	dol_user_country ()
	Return country code for current user.

	dol_print_address ($address, $htmlid, $element, $id, $noprint=0, $charfornl='')
	Format address string.

	isValidEmail ($address, $acceptsupervisorkey=0, $acceptuserkey=0)
	Return true if email syntax is ok.

	isValidMXRecord ($domain)
	Return if the domain name has a valid MX record.

	isValidPhone ($phone)
	Return true if phone number syntax is ok TODO Decide what to do with this.

	dolGetFirstLetters ($s, $nbofchar=1)
	Return first letters of a strings.

	dol_strlen ($string, $stringencoding='UTF-8')
	Make a strlen call.

	dol_substr ($string, $start, $length=null, $stringencoding='', $trunconbytes=0)
	Make a substring.

	dol_trunc ($string, $size=40, $trunc='right', $stringencoding='UTF-8', $nodot=0, $display=0)
	Truncate a string to a particular length adding '…' if string larger than length.

	getPictoForType ($key)
	Return the picto for a data type.

	img_picto ($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
	Show picto whatever it's its name (generic function)

	img_object ($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0)
	Show a picto called object_picto (generic function)

	img_weather ($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $morecss='')
	Show weather picto.

	img_picto_common ($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $notitle=0)
	Show picto (generic function)

	img_action ($titlealt, $numaction, $picto='', $moreatt='')
	Show logo action.

	img_pdf ($titlealt='default', $size=3)
	Show pdf logo.

	img_edit_add ($titlealt='default', $other='')
	Show logo +.

	img_edit_remove ($titlealt='default', $other='')
	Show logo -.

	img_edit ($titlealt='default', $float=0, $other='')
	Show logo editer/modifier fiche.

	img_view ($titlealt='default', $float=0, $other='class="valignmiddle"')
	Show logo view card.

	img_delete ($titlealt='default', $other='class="pictodelete"', $morecss='')
	Show delete logo.

	img_printer ($titlealt="default", $other='')
	Show printer logo.

	img_split ($titlealt='default', $other='class="pictosplit"')
	Show split logo.

	img_help ($usehelpcursor=1, $usealttitle=1)
	Show help logo with cursor "?".

	img_info ($titlealt='default')
	Show info logo.

	img_warning ($titlealt='default', $moreatt='', $morecss='pictowarning')
	Show warning logo.

	img_error ($titlealt='default')
	Show error logo.

	img_next ($titlealt='default', $moreatt='')
	Show next logo.

	img_previous ($titlealt='default', $moreatt='')
	Show previous logo.

	img_down ($titlealt='default', $selected=0, $moreclass='')
	Show down arrow logo.

	img_up ($titlealt='default', $selected=0, $moreclass='')
	Show top arrow logo.

	img_left ($titlealt='default', $selected=0, $moreatt='')
	Show left arrow logo.

	img_right ($titlealt='default', $selected=0, $moreatt='')
	Show right arrow logo.

	img_allow ($allow, $titlealt='default')
	Show tick logo if allowed.

	img_credit_card ($brand, $morecss=null)
	Return image of a credit card according to its brand name.

	img_mime ($file, $titlealt='', $morecss='')
	Show MIME img of a file.

	img_search ($titlealt='default', $other='')
	Show search logo.

	img_searchclear ($titlealt='default', $other='')
	Show search logo.

	info_admin ($text, $infoonimgalt=0, $nodiv=0, $admin='1', $morecss='hideonsmartphone', $textfordropdown='')
	Show information for admin users or standard users.

	dol_print_error ($db='', $error='', $errors=null)
	Displays error message system with all the information to facilitate the diagnosis and the escalation of the bugs.

	dol_print_error_email ($prefixcode, $errormessage='', $errormessages=array(), $morecss='error', $email='')
	Show a public email and error code to contact if technical error.

	print_liste_field_titre ($name, $file="", $field="", $begin="", $moreparam="", $moreattrib="", $sortfield="", $sortorder="", $prefix="", $tooltip="", $forcenowrapcolumntitle=0)
	Show title line of an array.

	getTitleFieldOfList ($name, $thead=0, $file="", $field="", $begin="", $moreparam="", $moreattrib="", $sortfield="", $sortorder="", $prefix="", $disablesortlink=0, $tooltip='', $forcenowrapcolumntitle=0)
	Get title line of an array.

	print_titre ($title)
	Show a title.

	print_fiche_titre ($title, $mesg='', $picto='generic', $pictoisfullpath=0, $id='')
	Show a title with picto.

	load_fiche_titre ($titre, $morehtmlright='', $picto='generic', $pictoisfullpath=0, $id='', $morecssontable='', $morehtmlcenter='')
	Load a title with picto.

	print_barre_liste ($titre, $page, $file, $options='', $sortfield='', $sortorder='', $morehtmlcenter='', $num=-1, $totalnboflines='', $picto='generic', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limit=-1, $hideselectlimit=0, $hidenavigation=0, $pagenavastextinput=0, $morehtmlrightbeforearrow='')
	Print a title with navigation controls for pagination.

	print_fleche_navigation ($page, $file, $options='', $nextpage=0, $betweenarrows='', $afterarrows='', $limit=-1, $totalnboflines=0, $hideselectlimit=0, $beforearrows='', $hidenavigation=0)
	Function to show navigation arrows into lists.

	vatrate ($rate, $addpercent=false, $info_bits=0, $usestarfornpr=0, $html=0)
	Return a string with VAT rate label formated for view output Used into pdf and HTML pages.

	price ($amount, $form=0, $outlangs='', $trunc=1, $rounding=-1, $forcerounding=-1, $currency_code='')
	Function to format a value into an amount for visual output Function used into PDF and HTML pages.

	price2num ($amount, $rounding='', $option=0)
	Function that return a number with universal decimal format (decimal separator is '.

	showDimensionInBestUnit ($dimension, $unit, $type, $outputlangs, $round=-1, $forceunitoutput='no', $use_short_label=0)
	Output a dimension with best unit.

	get_localtax ($vatrate, $local, $thirdparty_buyer="", $thirdparty_seller="", $vatnpr=0)
	Return localtax rate for a particular vat, when selling a product with vat $vatrate, from a $thirdparty_buyer to a $thirdparty_seller Note: This function applies same rules than get_default_tva.

	isOnlyOneLocalTax ($local)
	Return true if LocalTax (1 or 2) is unique.

	get_localtax_by_third ($local)
	Get values of localtaxes (1 or 2) for company country for the common vat with the highest value.

	getTaxesFromId ($vatrate, $buyer=null, $seller=null, $firstparamisid=1)
	Get tax (VAT) main information from Id.

	getLocalTaxesFromRate ($vatrate, $local, $buyer, $seller, $firstparamisid=0)
	Get type and rate of localtaxes for a particular vat rate/country of a thirdparty.

	get_product_vat_for_country ($idprod, $thirdpartytouse, $idprodfournprice=0)
	Return vat rate of a product in a particular country, or default country vat if product is unknown.

	get_product_localtax_for_country ($idprod, $local, $thirdpartytouse)
	Return localtax vat rate of a product in a particular country or default country vat if product is unknown.

	get_default_tva (Societe $thirdparty_seller, Societe $thirdparty_buyer, $idprod=0, $idprodfournprice=0)
	Function that return vat rate of a product line (according to seller, buyer and product vat rate) VATRULE 1: If seller does not use VAT, default VAT is 0.

	get_default_npr (Societe $thirdparty_seller, Societe $thirdparty_buyer, $idprod=0, $idprodfournprice=0)
	Function that returns whether VAT must be recoverable collected VAT (e.g.: VAT NPR in France)

	get_default_localtax ($thirdparty_seller, $thirdparty_buyer, $local, $idprod=0)
	Function that return localtax of a product line (according to seller, buyer and product vat rate) Si vendeur non assujeti a TVA, TVA par defaut=0.

	yn ($yesno, $case=1, $color=0)
	Return yes or no in current language.

	get_exdir ($num, $level, $alpha, $withoutslash, $object, $modulepart='')
	Return a path to have a the directory according to object where files are stored.

	dol_mkdir ($dir, $dataroot='', $newmask='')
	Creation of a directory (this can create recursive subdir)

	dolChmod ($filepath, $newmask='')
	Change mod of a file.

	picto_required ()
	Return picto saying a field is required.

	dol_string_nohtmltag ($stringtoclean, $removelinefeed=1, $pagecodeto='UTF-8', $strip_tags=0, $removedoublespaces=1)
	Clean a string from all HTML tags and entities.

	dol_string_onlythesehtmltags ($stringtoclean, $cleanalsosomestyles=1, $removeclassattribute=1, $cleanalsojavascript=0, $allowiframe=0, $allowed_tags=array(), $allowlink=0)
	Clean a string to keep only desirable HTML tags.

	dol_string_onlythesehtmlattributes ($stringtoclean, $allowed_attributes=null)
	Clean a string from some undesirable HTML tags.

	dol_string_neverthesehtmltags ($stringtoclean, $disallowed_tags=array('textarea'), $cleanalsosomestyles=0)
	Clean a string from some undesirable HTML tags.

	dolGetFirstLineOfText ($text, $nboflines=1, $charset='UTF-8')
	Return first line of text.

	dol_nl2br ($stringtoencode, $nl2brmode=0, $forxml=false)
	Replace CRLF in string with a HTML BR tag.

	dol_htmlwithnojs ($stringtoencode, $nouseofiframesandbox=0, $check='restricthtml')
	Sanitize a HTML to remove js, dangerous content and external link.

	dol_htmlentitiesbr ($stringtoencode, $nl2brmode=0, $pagecodefrom='UTF-8', $removelasteolbr=1)
	This function is called to encode a string into a HTML string but differs from htmlentities because a detection is done before to see if text is already HTML or not.

	dol_htmlentitiesbr_decode ($stringtodecode, $pagecodeto='UTF-8')
	This function is called to decode a HTML string (it decodes entities and br tags)

	dol_htmlcleanlastbr ($stringtodecode)
	This function remove all ending and br at end.

	dol_html_entity_decode ($a, $b, $c='UTF-8', $keepsomeentities=0)
	Replace html_entity_decode functions to manage errors.

	dol_htmlentities ($string, $flags=ENT_QUOTES\|ENT_SUBSTITUTE, $encoding='UTF-8', $double_encode=false)
	Replace htmlentities functions.

	dol_string_is_good_iso ($s, $clean=0)
	Check if a string is a correct iso string If not, it will not be considered as HTML encoded even if it is by FPDF.

	dol_nboflines ($s, $maxchar=0)
	Return nb of lines of a clear text.

	dol_nboflines_bis ($text, $maxlinesize=0, $charset='UTF-8')
	Return nb of lines of a formated text with and (WARNING: string must not have mixed and br separators)

	dol_textishtml ($msg, $option=0)
	Return if a text is a html content.

	dol_concatdesc ($text1, $text2, $forxml=false, $invert=false)
	Concat 2 descriptions with a new line between them (second operand after first one with appropriate new line separator) text1 html + text2 html => text1 + ' ' + text2 text1 html + text2 txt => text1 + ' ' + dol_nl2br(text2) text1 txt + text2 html => dol_nl2br(text1) + ' ' + text2 text1 txt + text2 txt => text1 + ' ' + text2.

	getCommonSubstitutionArray ($outputlangs, $onlykey=0, $exclude=null, $object=null, $include=null)
	Return array of possible common substitutions.

	make_substitutions ($text, $substitutionarray, $outputlangs=null, $converttextinhtmlifnecessary=0)
	Make substitution into a text string, replacing keys with vals from $substitutionarray (oldval=>newval), and texts like __(TranslationKey\|langfile)__ and [ConstantKey] are also replaced.

	complete_substitutions_array (&$substitutionarray, $outputlangs, $object=null, $parameters=null, $callfunc="completesubstitutionarray")
	Complete the $substitutionarray with more entries coming from external module that had set the "substitutions=1" into module_part array.

	print_date_range ($date_start, $date_end, $format='', $outputlangs='')
	Format output for start and end date.

	get_date_range ($date_start, $date_end, $format='', $outputlangs='', $withparenthesis=1)
	Format output for start and end date.

	dolGetFirstLastname ($firstname, $lastname, $nameorder=-1)
	Return firstname and lastname in correct order.

	setEventMessage ($mesgs, $style='mesgs', $noduplicate=0)
	Set event message in dol_events session object.

	setEventMessages ($mesg, $mesgs, $style='mesgs', $messagekey='', $noduplicate=0)
	Set event messages in dol_events session object.

	dol_htmloutput_events ($disabledoutputofmessages=0)
	Print formated messages to output (Used to show messages on html output).

	get_htmloutput_mesg ($mesgstring='', $mesgarray='', $style='ok', $keepembedded=0)
	Get formated messages to output (Used to show messages on html output).

	get_htmloutput_errors ($mesgstring='', $mesgarray=array(), $keepembedded=0)
	Get formated error messages to output (Used to show messages on html output).

	dol_htmloutput_mesg ($mesgstring='', $mesgarray=array(), $style='ok', $keepembedded=0)
	Print formated messages to output (Used to show messages on html output).

	dol_htmloutput_errors ($mesgstring='', $mesgarray=array(), $keepembedded=0)
	Print formated error messages to output (Used to show messages on html output).

	dol_sort_array (&$array, $index, $order='asc', $natsort=0, $case_sensitive=0, $keepindex=0)
	Advanced sort array by second index function, which produces ascending (default) or descending output and uses optionally natural case insensitive sorting (which can be optionally case sensitive as well).

	utf8_check ($str)
	Check if a string is in UTF8.

	utf8_valid ($str)
	Check if a string is in UTF8.

	ascii_check ($str)
	Check if a string is in ASCII.

	dol_osencode ($str)
	Return a string encoded into OS filesystem encoding.

	dol_getIdFromCode ($db, $key, $tablename, $fieldkey='code', $fieldid='id', $entityfilter=0, $filters='')
	Return an id or code from a code or id.

	isStringVarMatching ($var, $regextext, $matchrule=1)
	Check if a variable with name $var start with $text.

	verifCond ($strToEvaluate)
	Verify if condition in string is ok or not.

	dol_eval ($s, $returnvalue=0, $hideerrors=1, $onlysimplestring='1')
	Replace eval function to add more security.

	dol_validElement ($element)
	Return if var element is ok.

	picto_from_langcode ($codelang, $moreatt='', $notitlealt=0)
	Return img flag of country for a language code or country code.

	getLanguageCodeFromCountryCode ($countrycode)
	Return default language from country code.

	complete_head_from_modules ($conf, $langs, $object, &$head, &$h, $type, $mode='add', $filterorigmodule='')
	Complete or removed entries into a head array (used to build tabs).

	printCommonFooter ($zone='private')
	Print common footer : conf->global->MAIN_HTML_FOOTER js for switch of menu hider js for conf->global->MAIN_GOOGLE_AN_ID js for conf->global->MAIN_SHOW_TUNING_INFO or $_SERVER["MAIN_SHOW_TUNING_INFO"] js for conf->logbuffer.

	dolExplodeIntoArray ($string, $delimiter=';', $kv='=')
	Split a string with 2 keys into key array.

	dol_set_focus ($selector)
	Set focus onto field with selector (similar behaviour of 'autofocus' HTML5 tag)

	dol_getmypid ()
	Return getmypid() or random PID when function is disabled Some web hosts disable this php function for security reasons and sometimes we can't redeclare function.

	natural_search ($fields, $value, $mode=0, $nofirstand=0)
	Generate natural SQL search string for a criteria (this criteria can be tested on one or several fields)

	showDirectDownloadLink ($object)
	Return string with full Url.

	getImageFileNameForSize ($file, $extName, $extImgTarget='')
	Return the filename of file to get the thumbs.

	getAdvancedPreviewUrl ($modulepart, $relativepath, $alldata=0, $param='')
	Return URL we can use for advanced preview links.

	ajax_autoselect ($htmlname, $addlink='', $textonlink='Link')
	Make content of an input box selected when we click into input field.

	dolIsAllowedForPreview ($file)
	Return if a file is qualified for preview.

	dol_mimetype ($file, $default='application/octet-stream', $mode=0)
	Return MIME type of a file from its name with extension.

	getDictionaryValue ($tablename, $field, $id, $checkentity=false, $rowidfield='rowid')
	Return the value of a filed into a dictionary for the record $id.

	colorIsLight ($stringcolor)
	Return true if the color is light.

	isVisibleToUserType ($type_user, &$menuentry, &$listofmodulesforexternal)
	Function to test if an entry is enabled or not.

	roundUpToNextMultiple ($n, $x=5)
	Round to next multiple.

	dolGetBadge ($label, $html='', $type='primary', $mode='', $url='', $params=array())
	Function dolGetBadge.

	dolGetStatus ($statusLabel='', $statusLabelShort='', $html='', $statusType='status0', $displayMode=0, $url='', $params=array())
	Output the badge of a status.

	dolGetButtonAction ($label, $text='', $actionType='default', $url='', $id='', $userRight=1, $params=array())
	Function dolGetButtonAction.

	dolGetButtonTitleSeparator ($moreClass="")
	Add space between dolGetButtonTitle.

	getFieldErrorIcon ($fieldValidationErrorMsg)
	get field error icon

	dolGetButtonTitle ($label, $helpText='', $iconClass='fa fa-file', $url='', $id='', $status=1, $params=array())
	Function dolGetButtonTitle : this kind of buttons are used in title in list.

	getElementProperties ($element_type)
	Get an array with properties of an element.

	fetchObjectByElement ($element_id, $element_type, $element_ref='')
	Fetch an object from its id and element_type Inclusion of classes is automatic.

	isAFileWithExecutableContent ($filename)
	Return if a file can contains executable content.

	newToken ()
	Return the value of token currently saved into session with name 'newtoken'.

	currentToken ()
	Return the value of token currently saved into session with name 'token'.

	getNonce ()
	Return a random string to be used as a nonce value for js.

	startSimpleTable ($header, $link="", $arguments="", $emptyRows=0, $number=-1)
	Start a table with headers and a optinal clickable number (don't forget to use "finishSimpleTable()" after the last table row)

	finishSimpleTable ($addLineBreak=false)
	Add the correct HTML close tags for "startSimpleTable(...)" (use after the last table line)

	addSummaryTableLine ($tableColumnCount, $num, $nbofloop=0, $total=0, $noneWord="None", $extraRightColumn=false)
	Add a summary line to the current open table ("None", "XMoreLines" or "Total xxx")

	readfileLowMemory ($fullpath_original_file_osencoded, $method=-1)
	Return a file on output using a low memory.

	showValueWithClipboardCPButton ($valuetocopy, $showonlyonhover=1, $texttoshow='')
	Create a button to copy $valuetocopy in the clipboard (for copy and paste feature).

	jsonOrUnserialize ($stringtodecode)
	Decode an encode string.

	forgeSQLFromUniversalSearchCriteria ($filter, &$errorstr='', $noand=0, $nopar=0, $noerror=0)
	forgeSQLFromUniversalSearchCriteria

	dolCheckFilters ($sqlfilters, &$error='')
	Return if a $sqlfilters parameter has a valid balance of parenthesis.

	dolForgeDummyCriteriaCallback ($matches)
	Function to forge a SQL criteria from a Dolibarr filter syntax string.

	dolForgeCriteriaCallback ($matches)
	Function to forge a SQL criteria from a Dolibarr filter syntax string.

	getTimelineIcon ($actionstatic, &$histo, $key)
	Get timeline icon.

	getActionCommEcmList ($object)
	getActionCommEcmList

	show_actions_messaging ($conf, $langs, $db, $filterobj, $objcon='', $noprint=0, $actioncode='', $donetodo='done', $filters=array(), $sortfield='a.datep, a.id', $sortorder='DESC')
	Show html area with actions in messaging format.

	GETPOSTDATE ($prefix, $hourTime='', $gm='auto')
	Helper function that combines values of a dolibarr DatePicker (such as Form\selectDate) for year, month, day (and optionally hour, minute, second) fields to return a timestamp.

	buildParamDate ($prefix, $timestamp=null, $hourTime='', $gm='auto')
	Helper function that combines values of a dolibarr DatePicker (such as Form\selectDate) for year, month, day (and optionally hour, minute, second) fields to return a a portion of URL reproducing the values from the current HTTP request.

Detailed Description

A set of functions for Dolibarr This file contains all frequently used functions.

Definition in file functions.lib.php.

Function Documentation

◆ addSummaryTableLine()

addSummaryTableLine	(	$tableColumnCount,
		$num,
		$nbofloop = 0,
		$total = 0,
		$noneWord = "None",
		$extraRightColumn = false )

Add a summary line to the current open table ("None", "XMoreLines" or "Total xxx")

Parameters

integer	$tableColumnCount	The complete count columns of the table
integer	$num	The count of the rows of the table, when it is zero (0) the "$noneWord" is shown instead
integer	$nbofloop	(optional) The maximum count of rows thaht the table show (when it is zero (0) no summary line will show, expect "$noneWord" when $num === 0)
integer	$total	(optional) The total value thaht is shown after when the table has minimum of one entire
string	$noneWord	(optional) The word that is shown when the table has no entires ($num === 0)
boolean	$extraRightColumn	(optional) Add a addtional column after the summary word and total number

Returns: void

Definition at line 12418 of file functions.lib.php.

◆ ajax_autoselect()

ajax_autoselect	(	$htmlname,
		$addlink = '',
		$textonlink = 'Link' )

Make content of an input box selected when we click into input field.

Parameters

string	$htmlname	Id of html object ('#idvalue' or '.classvalue')
string	$addlink	Add a 'link to' after
string	$textonlink	Text to show on link or 'image'

Returns: string

Definition at line 10893 of file functions.lib.php.

Referenced by dol_print_cron_urls(), FormFile\list_of_documents(), print_barre_liste(), showDirectPublicLink(), and FormFile\showdocuments().

◆ ascii_check()

ascii_check ( $str )

Check if a string is in ASCII.

Parameters

string $str String to check

Returns: boolean True if string is ASCII, False if not (byte value > 0x7F)

Definition at line 9489 of file functions.lib.php.

Referenced by CMailFile\__construct(), Login\index(), and CMailFile\sendfile().

◆ buildParamDate()

buildParamDate	(	$prefix,
		$timestamp = null,
		$hourTime = '',
		$gm = 'auto' )

Helper function that combines values of a dolibarr DatePicker (such as Form\selectDate) for year, month, day (and optionally hour, minute, second) fields to return a a portion of URL reproducing the values from the current HTTP request.

Parameters

string	$prefix	Prefix used to build the date selector (for instance using Form\selectDate)
int	$timestamp	If null, the timestamp will be created from request data
bool	$hourTime	If timestamp is null, will be passed to GETPOSTDATE to construct the timestamp
bool	$gm	If timestamp is null, will be passed to GETPOSTDATE to construct the timestamp

Returns: string Portion of URL with query parameters for the specified date

Definition at line 13604 of file functions.lib.php.

References dol_print_date(), and GETPOSTDATE().

◆ checkVal()

checkVal	(	$out = '',
		$check = 'alphanohtml',
		$filter = null,
		$options = null )

Return a sanitized or empty value after checking value against a rule.

Deprecated

Parameters

string \| array	$out	Value to check/clear.
string	$check	Type of check/sanitizing
int	$filter	Filter to apply when $check is set to 'custom'. (See http://php.net/manual/en/filter.filters.php for détails)
mixed	$options	Options to pass to filter_var when $check is set to 'custom'

Returns: string|array Value sanitized (string or array). It may be '' if format check fails.

Definition at line 954 of file functions.lib.php.

References sanitizeVal().

◆ colorIsLight()

colorIsLight ( $stringcolor )

Return true if the color is light.

Parameters

string $stringcolor String with hex (FFFFFF) or comma RGB ('255,255,255')

Returns: int -1 : Error with argument passed |0 : color is dark | 1 : color is light

Definition at line 11314 of file functions.lib.php.

Referenced by Categorie\getNomUrl(), and Categorie\print_all_ways().

◆ complete_head_from_modules()

complete_head_from_modules	(		$conf,
			$langs,
			$object,
		&	$head,
		&	$h,
			$type,
			$mode = 'add',
			$filterorigmodule = '' )

Complete or removed entries into a head array (used to build tabs).

For example, with value added by external modules. Such values are declared into $conf->modules_parts['tab']. Or by change using hook completeTabsHead

Parameters

Conf	$conf	Object conf
Translate	$langs	Object langs
object \| null	$object	Object object
array	$head	Object head
int	$h	New position to fill
string	$type	Value for object where objectvalue can be 'thirdparty' to add a tab in third party view 'intervention' to add a tab in intervention view 'supplier_order' to add a tab in purchase order view 'supplier_invoice' to add a tab in purchase invoice view 'invoice' to add a tab in sales invoice view 'order' to add a tab in sales order view 'contract' to add a tabl in contract view 'product' to add a tab in product view 'propal' to add a tab in propal view 'user' to add a tab in user view 'group' to add a tab in group view 'member' to add a tab in fundation member view 'categories_x' to add a tab in category view ('x': type of category (0=product, 1=supplier, 2=customer, 3=member) 'ecm' to add a tab for another ecm view 'stock' to add a tab for warehouse view
string	$mode	'add' to complete head, 'remove' to remove entries
string	$filterorigmodule	Filter on module origin: 'external' will show only external modules. 'core' only core modules. No filter (default) will add both.

Returns: void

Definition at line 10154 of file functions.lib.php.

References complete_substitutions_array(), dol_buildpath(), dol_include_once(), dol_syslog(), make_substitutions(), and verifCond().

◆ complete_substitutions_array()

complete_substitutions_array	(	&	$substitutionarray,
			$outputlangs,
			$object = null,
			$parameters = null,
			$callfunc = "completesubstitutionarray" )

Complete the $substitutionarray with more entries coming from external module that had set the "substitutions=1" into module_part array.

In this case, method completesubstitutionarray provided by module is called.

Parameters

array	$substitutionarray	Array substitution old value => new value value
Translate	$outputlangs	Output language
Object	$object	Source object
mixed	$parameters	Add more parameters (useful to pass product lines)
string	$callfunc	What is the name of the custom function that will be called? (default: completesubstitutionarray)

Returns: void

See also: make_substitutions()

Definition at line 8943 of file functions.lib.php.

References dol_buildpath(), dol_dir_list(), dol_is_dir(), dol_syslog(), and getDolGlobalString().

◆ currentToken()

currentToken ( )

Return the value of token currently saved into session with name 'token'.

For ajax call, you must use this token as a parameter of the call into the js calling script (the called ajax php page must also set constant NOTOKENRENEWAL).

Since: Dolibarr v10.0.7

Returns: string

Definition at line 12303 of file functions.lib.php.

Referenced by dragAndDropFileUpload(), and Form\selectExpenseCategories().

◆ dol_banner_tab()

dol_banner_tab	(	$object,
		$paramid,
		$morehtml = '',
		$shownav = 1,
		$fieldid = 'rowid',
		$fieldref = 'ref',
		$morehtmlref = '',
		$moreparam = '',
		$nodbprefix = 0,
		$morehtmlleft = '',
		$morehtmlstatus = '',
		$onlybanner = 0,
		$morehtmlright = '' )

Show tab footer of a card.

Note: $object->next_prev_filter can be set to restrict select to find next or previous record by $form->showrefnav.

Parameters

Object	$object	Object to show
string	$paramid	Name of parameter to use to name the id into the URL next/previous link
string	$morehtml	More html content to output just before the nav bar
int	$shownav	Show Condition (navigation is shown if value is 1)
string	$fieldid	Nom du champ en base a utiliser pour select next et previous (we make the select max and min on this field). Use 'none' for no prev/next search.
string	$fieldref	Nom du champ objet ref (object->ref) a utiliser pour select next et previous
string	$morehtmlref	More html to show after the ref (see $morehtmlleft for before)
string	$moreparam	More param to add in nav link url.
int	$nodbprefix	Do not include DB prefix to forge table name
string	$morehtmlleft	More html code to show before the ref (see $morehtmlref for after)
string	$morehtmlstatus	More html code to show under navigation arrows
int	$onlybanner	Put this to 1, if the card will contains only a banner (this add css 'arearefnobottom' on div)
string	$morehtmlright	More html code to show before navigation arrows

Returns: void

Definition at line 2339 of file functions.lib.php.

References ajax_object_onoff(), dol_convert_file(), dol_escape_htmltag(), dol_sanitizeFileName(), get_exdir(), getDolGlobalString(), img_picto(), and setEventMessages().

Referenced by displayPositionCard().

◆ dol_bc()

dol_bc	(		$var,
			$moreclass = '' )

Return string to add class property on html element with pair/impair.

Parameters

string	$var	0 or 1
string	$moreclass	More class to add

Returns: string String to add class onto HTML element

Definition at line 2678 of file functions.lib.php.

◆ dol_buildpath()

dol_buildpath	(	$path,
		$type = 0,
		$returnemptyifnotfound = 0 )

Return path of url or filesystem.

Can check into alternate dir or alternate dir + main dir depending on value of $returnemptyifnotfound.

Parameters

string	$path	Relative path to file (if mode=0) or relative url (if mode=1). Ie: mydir/myfile, ../myfile
int	$type	0=Used for a Filesystem path, 1=Used for an URL path (output relative), 2=Used for an URL path (output full path using same host that current url), 3=Used for an URL path (output full path using host defined into $dolibarr_main_url_root of conf file)
int	$returnemptyifnotfound	0:If $type==0 and if file was not found into alternate dir, return default path into main dir (no test on it) 1:If $type==0 and if file was not found into alternate dir, return empty string 2:If $type==0 and if file was not found into alternate dir, test into main dir, return default path if found, empty string if not found

Returns: string Full filesystem path (if path=0) or '' if file not found, Full url path (if mode=1)

Definition at line 1176 of file functions.lib.php.

Referenced by availabilitiesPrepareHead(), bookcalAdminPrepareHead(), calendarPrepareHead(), checkLoginPassEntity(), CommonObject\commonGenerateDocument(), complete_head_from_modules(), complete_substitutions_array(), ActionsMyModule\completeTabsHead(), InterfaceTicketEmail\composeAndSendCustomerMessage(), conferenceorboothPrepareHead(), conferenceorboothProjectPrepareHead(), Adherent\create(), Project\createFromClone(), doc_label_pdf_create(), dol_include_once(), dol_print_address(), emailcollectorPrepareHead(), evaluationPrepareHead(), fichinter_create(), CommonObject\formAddObjectLine(), ProductAttribute\formAddObjectLine(), Utils\generateDoc(), Don\generateDocument(), DolibarrCollector\getAssets(), Canvas\getCanvas(), DolibarrModules\getChangeLog(), Ticket\getDefaultRef(), DolibarrModules\getDescLong(), DolibarrModules\getDescLongReadmeFound(), Translate\getLabelFromNumber(), Asset\getNextNumRef(), Availabilities\getNextNumRef(), BOM\getNextNumRef(), Calendar\getNextNumRef(), Commande\getNextNumRef(), CommandeFournisseur\getNextNumRef(), ConferenceOrBoothAttendee\getNextNumRef(), Contrat\getNextNumRef(), Evaluation\getNextNumRef(), EvaluationLine\getNextNumRef(), Expedition\getNextNumRef(), ExpenseReport\getNextNumRef(), Facture\getNextNumRef(), FactureFournisseur\getNextNumRef(), Fichinter\getNextNumRef(), Holiday\getNextNumRef(), Job\getNextNumRef(), KnowledgeRecord\getNextNumRef(), Mo\getNextNumRef(), MyObject\getNextNumRef(), Paiement\getNextNumRef(), PaiementFourn\getNextNumRef(), Partnership\getNextNumRef(), Position\getNextNumRef(), ProductFournisseurPrice\getNextNumRef(), Propal\getNextNumRef(), Reception\getNextNumRef(), RecruitmentCandidature\getNextNumRef(), RecruitmentJobPosition\getNextNumRef(), RemiseCheque\getNextNumRef(), Skill\getNextNumRef(), Skilldet\getNextNumRef(), SkillRank\getNextNumRef(), StockTransfer\getNextNumRef(), StockTransferLine\getNextNumRef(), SupplierProposal\getNextNumRef(), Target\getNextNumRef(), TimeSpent\getNextNumRef(), Workstation\getNextNumRef(), Asset\getNomUrl(), AssetModel\getNomUrl(), Availabilities\getNomUrl(), Calendar\getNomUrl(), EmailCollectorAction\getNomUrl(), EmailCollectorFilter\getNomUrl(), Evaluation\getNomUrl(), EvaluationLine\getNomUrl(), Inventory\getNomUrl(), Job\getNomUrl(), KnowledgeRecord\getNomUrl(), MyObject\getNomUrl(), Position\getNomUrl(), ProductAttribute\getNomUrl(), ProductFournisseurPrice\getNomUrl(), Project\getNomUrl(), RecruitmentCandidature\getNomUrl(), RecruitmentJobPosition\getNomUrl(), Skill\getNomUrl(), Skilldet\getNomUrl(), SkillRank\getNomUrl(), StockTransfer\getNomUrl(), StockTransferLine\getNomUrl(), Target\getNomUrl(), TimeSpent\getNomUrl(), Workstation\getNomUrl(), Interfaces\getTriggersList(), ModeleBoxes\getWidgetsList(), inventoryPrepareHead(), jobPrepareHead(), PrintingDriver\listDrivers(), llxHeaderTicket(), llxHeaderVierge(), ActionsMyModule\loadDataForCustomReports(), members_card_pdf_create(), moPrepareHead(), mrpAdminPrepareHead(), multicurrencyAdminPrepareHead(), mymoduleAdminPrepareHead(), myobjectPrepareHead(), Ticket\newMessage(), oauthadmin_prepare_head(), partnershipAdminPrepareHead(), partnershipPrepareHead(), positionCardPrepareHead(), print_auguria_menu(), print_eldy_menu(), print_left_auguria_menu(), print_left_eldy_menu(), CommonObject\printObjectLine(), ProductAttribute\printObjectLine(), CommonObject\printObjectLines(), ProductAttribute\printObjectLines(), CommonObject\printOriginLine(), recruitmentAdminPrepareHead(), recruitmentCandidaturePrepareHead(), recruitmentjobpositionPrepareHead(), resource_prepare_head(), Interfaces\run_triggers(), FormCompany\select_state_ajax(), FormCompany\selectCompaniesForNewContact(), FormProjets\selectInvoiceAndLine(), DataPolicy\sendMailDataPolicyAdherent(), DataPolicy\sendMailDataPolicyCompany(), DataPolicy\sendMailDataPolicyContact(), Conf\setValues(), show_actions_messaging(), show_skin(), showDirectPublicLink(), FormFile\showdocuments(), FormTicket\showForm(), Form\showLinkedObjectBlock(), MenuManager\showmenu(), showSkins(), skilldetPrepareHead(), skillPrepareHead(), skillrankPrepareHead(), stocktransferAdminPrepareHead(), stocktransferPrepareHead(), targetPrepareHead(), top_htmlhead(), webhookAdminPrepareHead(), websiteaccountPrepareHead(), workstationPrepareHead(), and zapierAdminPrepareHead().

◆ dol_clone()

dol_clone	(		$object,
			$native = 0 )

Create a clone of instance of object (new instance with same value for each properties) With native = 0: Property that are reference are different memory area in the new object (full isolation clone).

This means $this->db of new object may not be valid. With native = 1: Use PHP clone. Property that are reference are same pointer. This means $this->db of new object is still valid but point to same this->db than original object. With native = 2: Property that are reference are different memory area in the new object (full isolation clone). Only scalar and array values are cloned. This means method are not availables and $this->db of new object is not valid.

Parameters

object	$object	Object to clone
int	$native	0=Full isolation method, 1=Native PHP method, 2=Full isolation method keeping only scalar and array properties (recommended)

Returns: object Clone object

See also: https://php.net/manual/language.oop5.cloning.php

Definition at line 1275 of file functions.lib.php.

Referenced by MouvementStock\_createSubProduct(), Ticket\assignUser(), Ticket\markAsRead(), Products\put(), InterfaceWebhookTriggers\runTrigger(), InterfaceZapierTriggers\runTrigger(), Fichinter\setDraft(), Fichinter\setRefClient(), ContratLigne\update(), Dolresource\update(), Product\update(), and Productlot\update().

◆ dol_concatdesc()

dol_concatdesc	(	$text1,
		$text2,
		$forxml = false,
		$invert = false )

Concat 2 descriptions with a new line between them (second operand after first one with appropriate new line separator) text1 html + text2 html => text1 + '
' + text2 text1 html + text2 txt => text1 + '
' + dol_nl2br(text2) text1 txt + text2 html => dol_nl2br(text1) + '
' + text2 text1 txt + text2 txt => text1 + '
' + text2.

Parameters

string	$text1	Text 1
string	$text2	Text 2
bool	$forxml	true=Use instead of if we have to add a br tag
bool	$invert	invert order of description lines (we often use config MAIN_CHANGE_ORDER_CONCAT_DESCRIPTION in this parameter)

Returns: string Text 1 + new line + Text2

See also: dol_textishtml()

Definition at line 8105 of file functions.lib.php.

References dol_escape_htmltag(), dol_nl2br(), and dol_textishtml().

◆ dol_escape_all()

dol_escape_all ( $stringtoescape )

Returns text escaped for all protocols (so only alpha chars and numbers)

Parameters

string $stringtoescape String to escape

Returns: string Escaped string for XML content.

Definition at line 1633 of file functions.lib.php.

◆ dol_escape_htmltag()

dol_escape_htmltag	(	$stringtoescape,
		$keepb = 0,
		$keepn = 0,
		$noescapetags = '',
		$escapeonlyhtmltags = 0,
		$cleanalsojavascript = 0 )

Returns text escaped for inclusion in HTML alt or title or value tags, or into values of HTML input fields.

When we need to output strings on pages, we should use:

dolPrintHTML... that is dol_escape_htmltag(dol_htmlwithnojs(dol_string_onlythesehtmltags(dol_htmlentitiesbr(), 1, 1, 1)), 1, 1) for notes or descriptions into textarea, add 'common' if into a html content
dolPrintLabel... that is dol_escape_htmltag(dol_htmlentitiesbr()) for simple labels.
dolPrintPassword that is abelhtmlspecialchars( , ENT_COMPAT, 'UTF-8') for passwords.

Parameters

string	$stringtoescape	String to escape
int	$keepb	1=Keep b tags, 0=remove them completely
int	$keepn	1=Preserve \r strings, 0=Replace them with escaped value, -1=Remove them. Set to 1 when escaping for a <textarea>.
string	$noescapetags	'' or 'common' or list of tags to not escape. TODO Does not works yet when there is attributes into tag.
int	$escapeonlyhtmltags	1=Escape only html tags, not the special chars like accents.
int	$cleanalsojavascript	Clean also javascript. @TODO switch this option to 1 by default.

Returns: string Escaped string

See also: dol_string_nohtmltag(), dol_string_onlythesehtmltags(), dol_string_nospecial(), dol_string_unaccent(), dol_htmlentitiesbr()

Definition at line 1728 of file functions.lib.php.

References dol_string_onlythesehtmltags().

Referenced by pdf_standard_myobject\_pagehead(), ActionsStripeconnect\addMoreActionsButtons(), barcode_encode(), modPhpbarcode\buildBarCode(), Form\buttonsSaveCancel(), Form\constructProductListOption(), DolEditor\Create(), dol_banner_tab(), dol_concatdesc(), dol_get_fiche_head(), dol_print_email(), dol_print_error(), dol_print_profids(), dol_print_socialnetworks(), dol_syslog(), dolButtonToOpenUrlInDialogPopup(), dolGetButtonAction(), dolGetButtonTitle(), dolPrintHTML(), dolPrintHTMLForAttribute(), dolPrintHTMLForTextArea(), dolPrintLabel(), DolGraph\draw_chart(), DolGraph\draw_jflot(), Form\editfieldval(), Form\form_conditions_reglement(), form_constantes(), Form\form_date(), Form\form_modes_reglement(), Form\form_remise_dispo(), Form\formconfirm(), mailing_contacts1\formFilter(), mailing_partnership\formFilter(), mailing_thirdparties\formFilter(), FormSetup\generateAttributesStringFromArray(), FormSetup\generateOutput(), Dolistore\get_categories(), FormMail\get_form(), Dolistore\get_next_link(), Dolistore\get_previous_link(), Dolistore\get_products(), FormOther\getHTMLScannerForm(), DolibarrModules\getKanbanView(), Holiday\getKanbanView(), AccountingAccount\getNomUrl(), ActionComm\getNomUrl(), Adherent\getNomUrl(), Asset\getNomUrl(), Commande\getNomUrl(), CommandeFournisseur\getNomUrl(), Deplacement\getNomUrl(), DiscountAbsolute\getNomUrl(), Don\getNomUrl(), EcmDirectory\getNomUrl(), Facture\getNomUrl(), FactureFournisseur\getNomUrl(), FactureFournisseurRec\getNomUrl(), FactureRec\getNomUrl(), FichinterRec\getNomUrl(), Localtax\getNomUrl(), PaymentDonation\getNomUrl(), PaymentExpenseReport\getNomUrl(), PaymentLoan\getNomUrl(), PaymentSocialContribution\getNomUrl(), PaymentVAT\getNomUrl(), Position\getNomUrl(), ProductAttribute\getNomUrl(), Propal\getNomUrl(), Societe\getNomUrl(), Subscription\getNomUrl(), SupplierProposal\getNomUrl(), getSocialNetworkSharingLinks(), getTitleFieldOfList(), ActionComm\getTooltipContentArray(), Cronjob\getTooltipContentArray(), Societe\getTooltipContentArray(), img_help(), img_search(), img_searchclear(), info_admin(), left_menu(), FormFile\list_of_documents(), FormFile\listOfLinks(), Form\load_tva(), box_boms\loadBox(), box_clients\loadBox(), box_commandes\loadBox(), box_contacts\loadBox(), box_contracts\loadBox(), box_dolibarr_state_board\loadBox(), box_external_rss\loadBox(), box_factures\loadBox(), box_factures_fourn\loadBox(), box_factures_fourn_imp\loadBox(), box_factures_imp\loadBox(), box_ficheinter\loadBox(), box_fournisseurs\loadBox(), box_last_knowledgerecord\loadBox(), box_last_modified_knowledgerecord\loadBox(), box_last_modified_ticket\loadBox(), box_last_ticket\loadBox(), box_members_by_tags\loadBox(), box_members_by_type\loadBox(), box_members_last_modified\loadBox(), box_members_last_subscriptions\loadBox(), box_mos\loadBox(), box_produits\loadBox(), box_propales\loadBox(), box_prospect\loadBox(), box_services_contracts\loadBox(), box_services_expired\loadBox(), box_supplier_orders\loadBox(), main_area(), Form\multiselectarray(), EmailCollector\overwritePropertiesOfObject(), print_auguria_menu(), print_eldy_menu(), print_fleche_navigation(), print_text_menu_entry(), print_text_menu_entry_auguria(), print_text_menu_entry_empty(), printDropdownBookmarksList(), projectLinesa(), projectLinesPerAction(), projectLinesPerDay(), projectLinesPerWeek(), Form\searchComponent(), FormAccounting\select_accounting_category(), Form\select_all_categories(), Form\select_company(), Form\select_country(), Form\select_dolresources_forevent(), Form\select_dolusers(), Form\select_dolusers_forevent(), FormAdmin\select_language(), Form\select_produits_fournisseurs_list(), Form\select_thirdparty_list(), FormEcm\selectAllSections(), Form\selectAvailabilityDelay(), FormCompany\selectCompaniesForNewContact(), Form\selectCurrency(), FormTicket\selectGroupTickets(), Form\selectMassAction(), FormCompany\selectProspectStatus(), FormProjets\selectTasks(), FormAdmin\selectTypeOfFields(), Utils\sendBackup(), Adherent\sendReminderForExpiredSubscription(), show_actions_messaging(), show_contacts(), CommonObject\show_photos(), show_projects(), show_subsidiaries(), ModeleBoxes\showBox(), FormFile\showdocuments(), FormTicket\showForm(), CommonObject\showInputField(), ExtraFields\showInputField(), Form\showLinkToObjectBlock(), FormTicket\showMessageForm(), showSkins(), showSocialNetwork(), showValueWithClipboardCPButton(), Form\textwithtooltip(), Diff\toHTML(), top_menu(), top_menu_user(), and treeOutputForAbsoluteDir().

◆ dol_escape_js()

dol_escape_js	(	$stringtoescape,
		$mode = 0,
		$noescapebackslashn = 0 )

Returns text escaped for inclusion into javascript code.

Parameters

string	$stringtoescape	String to escape
int	$mode	0=Escape also ' and " into ', 1=Escape ' but not " for usage into 'string', 2=Escape " but not ' for usage into "string", 3=Escape ' and " with \
int	$noescapebackslashn	0=Escape also . 1=Do not escape .

Returns: string Escaped string. Both ' and " are escaped into ' if they are escaped.

Definition at line 1566 of file functions.lib.php.

Referenced by ajax_combobox(), ajax_constantonoff(), ActionsCardCompany\assign_values(), constructGanttLine(), DolEditor\Create(), dolButtonToOpenUrlInDialogPopup(), dolJSToSetRandomPassword(), dragAndDropFileUpload(), DolGraph\draw_chart(), DolGraph\draw_jflot(), FormFile\form_attach_new_file(), FormActions\form_select_status_action(), Form\formconfirm(), get_htmloutput_mesg(), FormOther\getHTMLScannerForm(), DolibarrModules\getKanbanView(), Form\multiselectarray(), rebuildObjectClass(), FormAccounting\select_auxaccount(), Form\selectArrayFilter(), FormCompany\selectCompaniesForNewContact(), Form\selectDate(), FormTicket\selectGroupTickets(), FormFile\showdocuments(), FormTicket\showForm(), and showSocialNetwork().

◆ dol_escape_json()

dol_escape_json ( $stringtoescape )

Returns text escaped for inclusion into javascript code.

Parameters

string $stringtoescape String to escape

Returns: string Escaped string for JSON content.

Definition at line 1599 of file functions.lib.php.

Referenced by getStructuredData().

◆ dol_escape_php()

dol_escape_php	(		$stringtoescape,
			$stringforquotes = 2 )

Returns text escaped for inclusion into a php string, build with double quotes " or '.

Parameters

string	$stringtoescape	String to escape
	int<1,2>	$stringforquotes 2=String for doublequotes, 1=String for simple quotes

Returns: string Escaped string for PHP content.

Definition at line 1611 of file functions.lib.php.

Referenced by rebuildObjectClass().

◆ dol_escape_xml()

dol_escape_xml ( $stringtoescape )

Returns text escaped for inclusion into a XML string.

Parameters

string $stringtoescape String to escape

Returns: string Escaped string for XML content.

Definition at line 1644 of file functions.lib.php.

Referenced by build_rssfile().

◆ dol_eval()

dol_eval	(	$s,
		$returnvalue = 0,
		$hideerrors = 1,
		$onlysimplestring = '1' )

Replace eval function to add more security.

This function is called by verifCond() or trans() and transnoentitiesnoconv().

Parameters

string	$s	String to evaluate
int	$returnvalue	0=No return (used to execute eval($a=something)). 1=Value of eval is returned (used to eval($something)).
int	$hideerrors	1=Hide errors
string	$onlysimplestring	'0' (deprecated, used for computed property of extrafields)=Accept all chars, '1' (most common use)=Accept only simple string with char 'a-z0-9\s^$_+-.*>&\|=!?():"\',/@';', '2' (rarely used)=Accept also '[]'

Returns: mixed Nothing or return result of eval

See also: verifCond()

Definition at line 9650 of file functions.lib.php.

References dol_syslog(), and getDolGlobalString().

Referenced by InterfaceTicketEmail\composeAndSendCustomerMessage(), CommonObject\fetch_optionals(), fillArrayOfGroupBy(), fillArrayOfMeasures(), fillArrayOfXAxis(), CommonObject\getTooltipContent(), CommonObject\insertExtraFields(), box_scheduled_jobs\loadBox(), AssetDepreciationOptions\setDeprecationOptionsFromPost(), ExtraFields\setOptionalsFromPost(), CommonObject\setValuesForExtraLanguages(), show_contacts(), ExtraFields\showInputField(), CommonObject\showOptionals(), ExtraFields\showOutputField(), CommonObject\updateExtraField(), and verifCond().

◆ dol_fiche_end()

dol_fiche_end ( $notab = 0 )

Show tab footer of a card.

Parameters

int $notab -1 or 0=Add tab footer, 1=no tab footer

Returns: void

Deprecated: Use print dol_get_fiche_end() instead

Definition at line 2300 of file functions.lib.php.

References dol_get_fiche_end().

◆ dol_fiche_head()

dol_fiche_head	(	$links = array(),
		$active = '0',
		$title = '',
		$notab = 0,
		$picto = '',
		$pictoisfullpath = 0,
		$morehtmlright = '',
		$morecss = '',
		$limittoshow = 0,
		$moretabssuffix = '' )

Show tab header of a card.

Parameters

array	$links	Array of tabs (0=>url, 1=>label, 2=>code, 3=>not used, 4=>text after link, 5=>morecssonlink). Currently initialized by calling a function xxx_admin_prepare_head. Note that label into $links[$i][1] must be already HTML escaped.
string	$active	Active tab name (document', 'info', 'ldap', ....)
string	$title	Title
int	$notab	-1 or 0=Add tab header, 1=no tab header (if you set this to 1, using print dol_get_fiche_end() to close tab is not required), -2=Add tab header with no sepaaration under tab (to start a tab just after), -3=Add tab header but no footer separation
string	$picto	Add a picto on tab title
int	$pictoisfullpath	If 1, image path is a full path. If you set this to 1, you can use url returned by dol_buildpath('/mymodyle/img/myimg.png',1) for $picto.
string	$morehtmlright	Add more html content on right of tabs title
string	$morecss	More Css
int	$limittoshow	Limit number of tabs to show. Use 0 to use automatic default value.
string	$moretabssuffix	A suffix to use when you have several dol_get_fiche_head() in same page

Returns: void

Deprecated: Use print dol_get_fiche_head() instead

Definition at line 2091 of file functions.lib.php.

References dol_get_fiche_head().

◆ dol_format_address()

dol_format_address	(	$object,
		$withcountry = 0,
		$sep = "\n",
		$outputlangs = '',
		$mode = 0,
		$extralangcode = '' )

Return a formated address (part address/zip/town/state) according to country rules.

See https://en.wikipedia.org/wiki/Address

Parameters

Object	$object	A company or contact object
int	$withcountry	1=Add country into address string
string	$sep	Separator to use to separate info when building string
Translate	$outputlangs	Object lang that contains language for text translation.
int	$mode	0=Standard output, 1=Remove address
string	$extralangcode	User extralanguage $langcode as values for address, town

Returns: string Formated string

See also: dol_print_address()

Definition at line 2701 of file functions.lib.php.

References getDolGlobalString().

Referenced by CommonObject\getFullAddress(), Adherent\getTooltipContentArray(), Contact\getTooltipContentArray(), Societe\getTooltipContentArray(), and pdf_build_address().

◆ dol_get_fiche_end()

dol_get_fiche_end ( $notab = 0 )

Return tab footer of a card.

Parameters

int $notab -1 or 0=Add tab footer, 1=no tab footer

Returns: string

Definition at line 2311 of file functions.lib.php.

Referenced by ActionsAdherentCardDefault\assign_values(), ActionsCardCommon\assign_values(), ActionsCardProduct\assign_values(), ActionsCardService\assign_values(), ActionsContactCardDefault\assign_values(), displayPositionCard(), dol_fiche_end(), journalHead(), and report_header().

◆ dol_get_fiche_head()

dol_get_fiche_head	(	$links = array(),
		$active = '',
		$title = '',
		$notab = 0,
		$picto = '',
		$pictoisfullpath = 0,
		$morehtmlright = '',
		$morecss = '',
		$limittoshow = 0,
		$moretabssuffix = '',
		$dragdropfile = 0 )

Show tabs of a record.

Parameters

array	$links	Array of tabs (0=>url, 1=>label, 2=>code, 3=>not used, 4=>text after link, 5=>morecssonlink). Currently initialized by calling a function xxx_admin_prepare_head. Note that label into $links[$i][1] must be already HTML escaped.
string	$active	Active tab name
string	$title	Title
int	$notab	-1 or 0=Add tab header, 1=no tab header (if you set this to 1, using print dol_get_fiche_end() to close tab is not required), -2=Add tab header with no seaparation under tab (to start a tab just after), -3=-2+'noborderbottom'
string	$picto	Add a picto on tab title
int	$pictoisfullpath	If 1, image path is a full path. If you set this to 1, you can use url returned by dol_buildpath('/mymodyle/img/myimg.png',1) for $picto.
string	$morehtmlright	Add more html content on right of tabs title
string	$morecss	More CSS on the link
int	$limittoshow	Limit number of tabs to show. Use 0 to use automatic default value.
string	$moretabssuffix	A suffix to use when you have several dol_get_fiche_head() in same page
int	$dragdropfile	0 (default) or 1. 1 enable a drop zone for file to be upload, 0 disable it

Returns: string

Definition at line 2112 of file functions.lib.php.

References dol_escape_htmltag(), dol_trunc(), dragAndDropFileUpload(), getDolGlobalString(), and img_picto().

Referenced by ActionsAdherentCardDefault\assign_values(), ActionsCardCommon\assign_values(), ActionsCardProduct\assign_values(), ActionsCardService\assign_values(), ActionsContactCardDefault\assign_values(), displayPositionCard(), dol_fiche_head(), journalHead(), report_header(), and FormTicket\showForm().

◆ dol_getdate()

dol_getdate	(	$timestamp,
		$fast = false,
		$forcetimezone = '' )

Return an array with locale date info.

WARNING: This function use PHP server timezone by default to return locale informations. Be aware to add the third parameter to "UTC" if you need to work on UTC.

Parameters

int	$timestamp	Timestamp
boolean	$fast	Fast mode. deprecated.
string	$forcetimezone	'' to use the PHP server timezone. Or use a form like 'gmt', 'Europe/Paris' or '+0200' to force timezone.

Returns: array Array of informations 'seconds' => $secs, 'minutes' => $min, 'hours' => $hour, 'mday' => $day, 'wday' => $dow, 0=sunday, 6=saturday 'mon' => $month, 'year' => $year, 'yday' => floor($secsInYear/$_day_power) '0' => original timestamp

See also: dol_print_date(), dol_stringtotime(), dol_mktime()

Definition at line 3075 of file functions.lib.php.

Referenced by modAdherent\__construct(), modFacture\__construct(), modFournisseur\__construct(), modHoliday\__construct(), modMultiCurrency\__construct(), modPartnership\__construct(), MouvementStock\_create(), Asset\calculationDepreciation(), ExpenseReport\computeTotalKm(), Facture\createFromClone(), FactureFournisseurRec\createRecurringInvoices(), FactureRec\createRecurringInvoices(), dol_get_first_day_week(), dol_get_first_hour(), dol_get_last_hour(), dol_get_next_day(), dol_get_next_week(), dol_get_prev_day(), dol_get_prev_week(), dolWebsiteIncrementCounter(), Accountancy\exportData(), getCommonSubstitutionArray(), getCurrentPeriodOfFiscalYear(), Paiement\getNomUrl(), GETPOST(), Facture\initAsSpecimen(), FactureFournisseurRec\initAsSpecimen(), FactureRec\initAsSpecimen(), Paiement\initAsSpecimen(), PaiementFourn\initAsSpecimen(), RemiseCheque\initAsSpecimen(), box_birthdays\loadBox(), box_birthdays_members\loadBox(), box_graph_invoices_permonth\loadBox(), box_graph_invoices_peryear\loadBox(), box_graph_invoices_supplier_permonth\loadBox(), box_graph_orders_permonth\loadBox(), box_graph_orders_supplier_permonth\loadBox(), box_graph_product_distribution\loadBox(), box_graph_propales_permonth\loadBox(), projectLinesPerDay(), projectLinesPerWeek(), Adherent\sendReminderForExpiredSubscription(), show_actions_done(), show_actions_messaging(), and FormActions\showactions().

◆ dol_getIdFromCode()

dol_getIdFromCode	(	$db,
		$key,
		$tablename,
		$fieldkey = 'code',
		$fieldid = 'id',
		$entityfilter = 0,
		$filters = '' )

Return an id or code from a code or id.

Store also Code-Id into a cache to speed up next request on same key.

Parameters

DoliDB	$db	Database handler
string	$key	Code or Id to get Id or Code
string	$tablename	Table name without prefix
string	$fieldkey	Field to search the key into
string	$fieldid	Field to get
int	$entityfilter	Filter by entity
string	$filters	Filters to add. WARNING: string must be escaped for SQL and not coming from user input.

Returns: int Return integer <0 if KO, Id of code if OK

See also: $langs->getLabelFromKey

Definition at line 9549 of file functions.lib.php.

References dol_syslog().

Referenced by pdf_azur\_tableau_info(), Invoices\addPayment(), SupplierInvoices\addPayment(), Invoices\addPaymentDistributed(), Societe\create_from_member(), CommonInvoice\demande_prelevement(), Salary\demande_prelevement(), pdf_cyan\drawInfoTable(), AccountancyCategory\getCptsCat(), CProductNature\getProductNatureFromCode(), CUnits\getUnitFromCode(), Form\load_cache_vatrates(), box_funnel_of_prospection\loadBox(), num_public_holiday(), print_projecttasks_array(), RemiseCheque\rejectCheck(), Notify\send(), BlockedLog\setObjectData(), Societe\setThirdpartyType(), and Adherent\subscriptionComplementaryActions().

◆ dol_getmypid()

dol_getmypid ( )

Return getmypid() or random PID when function is disabled Some web hosts disable this php function for security reasons and sometimes we can't redeclare function.

Returns: int

Definition at line 10573 of file functions.lib.php.

◆ dol_html_entity_decode()

dol_html_entity_decode	(	$a,
		$b,
		$c = 'UTF-8',
		$keepsomeentities = 0 )

Replace html_entity_decode functions to manage errors.

Parameters

string	$a	Operand a
string	$b	Operand b (ENT_QUOTES\|ENT_HTML5=convert simple, double quotes, colon, e accent, ...)
string	$c	Operand c
string	$keepsomeentities	Entities but &, <, >, " are not converted.

Returns: string String decoded

Definition at line 7902 of file functions.lib.php.

Referenced by Project\createFromClone(), Task\createFromClone(), dol_htmlentitiesbr_decode(), dol_string_nohtmltag(), Mailing\fetch(), jsUnEscape(), pdf_getlinedesc(), and sanitizeVal().

◆ dol_htmlcleanlastbr()

dol_htmlcleanlastbr ( $stringtodecode )

This function remove all ending
and br at end.

Parameters

string $stringtodecode String to decode

Returns: string String decoded

Definition at line 7886 of file functions.lib.php.

Referenced by ActionComm\create(), ExportCsv\csvClean(), getInvoice(), ExtraFields\getOptionalsFromPost(), getSupplierInvoicesForThirdParty(), and ActionComm\update().

◆ dol_htmlentities()

dol_htmlentities	(	$string,
		$flags = ENT_QUOTES\|ENT_SUBSTITUTE,
		$encoding = 'UTF-8',
		$double_encode = false )

Replace htmlentities functions.

Goal of this function is to be sure to have default values of htmlentities that match what we need.

Parameters

string	$string	The input string to encode
int	$flags	Flags (see PHP doc above)
string	$encoding	Encoding page code
bool	$double_encode	When double_encode is turned off, PHP will not encode existing html entities

Returns: string $ret Encoded string

See also: dol_htmlentitiesbr()

Definition at line 7926 of file functions.lib.php.

Referenced by dol_htmlentitiesbr(), dol_print_error(), FormSetupItem\generateInputFieldTextarea(), FormMail\get_form(), getTaskProgressView(), box_task\loadBox(), run_sql(), Form\showrefnav(), and top_htmlhead().

◆ dol_htmlentitiesbr()

dol_htmlentitiesbr	(	$stringtoencode,
		$nl2brmode = 0,
		$pagecodefrom = 'UTF-8',
		$removelasteolbr = 1 )

This function is called to encode a string into a HTML string but differs from htmlentities because a detection is done before to see if text is already HTML or not.

Also, all entities but &,<,>," are converted. This permits to encode special chars to entities with no double encoding for already encoded HTML strings. This function also remove last EOL or BR if $removelasteolbr=1 (default). For PDF usage, you can show text by 2 ways:

writeHTMLCell -> param must be encoded into HTML.
MultiCell -> param must not be encoded into HTML. Because writeHTMLCell convert also
into
, if function is used to build PDF, nl2brmode must be 1. Note: When we output string on pages, we should use
dolPrintHTML... that is dol_escape_htmltag(dol_htmlwithnojs(dol_string_onlythesehtmltags(dol_htmlentitiesbr(), 1, 1, 1), 1, 1) for notes or descriptions,
dolPrintLabel... that is dol_escape_htmltag(dol_htmlentitiesbr()) for simple labels.
dolPrintPassword that is abelhtmlspecialchars( , ENT_COMPAT, 'UTF-8') for passwords.

Parameters

string	$stringtoencode	String to encode
int	$nl2brmode	0=Adding br before , 1=Replacing by br (for use with FPDF writeHTMLCell function for example)
string	$pagecodefrom	Pagecode stringtoencode is encoded
int	$removelasteolbr	1=Remove last br or lasts (default), 0=Do nothing

Returns: string String encoded

See also: dol_escape_htmltag(), dolGetFirstLineOfText(), dol_string_onlythesehtmltags()

Definition at line 7836 of file functions.lib.php.

References dol_htmlentities(), dol_nl2br(), and dol_textishtml().

Referenced by pdf_crabe\_tableau_info(), dolPrintHTML(), dolPrintHTMLForAttribute(), dolPrintHTMLForTextArea(), dolPrintLabel(), pdf_sponge\drawInfoTable(), Form\editfieldval(), getCommonSubstitutionArray(), Skill\getNomUrl(), box_services_contracts\loadBox(), make_substitutions(), Adherent\makeSubstitution(), Form\multiselectarray(), pdf_getlinedesc(), pdf_getlinenum(), pdf_getlineref(), pdf_getlineref_supplier(), pdf_pagefoot(), CommonObject\printObjectLine(), Adherent\sendEmail(), show_ldap_content(), show_list_sending_receive(), pdf_aurore\write_file(), pdf_azur\write_file(), pdf_baleine\write_file(), pdf_ban\write_file(), pdf_beluga\write_file(), pdf_canelle\write_file(), pdf_cornas\write_file(), pdf_crabe\write_file(), pdf_cyan\write_file(), pdf_eagle\write_file(), pdf_eagle_proforma\write_file(), pdf_einstein\write_file(), pdf_eratosthene\write_file(), pdf_espadon\write_file(), pdf_merou\write_file(), pdf_muscadet\write_file(), pdf_rouget\write_file(), pdf_sepamandate\write_file(), pdf_soleil\write_file(), pdf_sponge\write_file(), pdf_squille\write_file(), pdf_standard\write_file(), pdf_standard\write_file(), pdf_standard_asset\write_file(), pdf_standard_myobject\write_file(), pdf_standard_recruitmentjobposition\write_file(), pdf_storm\write_file(), pdf_strato\write_file(), pdf_timespent\write_file(), pdf_typhon\write_file(), pdf_vinci\write_file(), and pdf_zenith\write_file().

◆ dol_htmlentitiesbr_decode()

dol_htmlentitiesbr_decode	(		$stringtodecode,
			$pagecodeto = 'UTF-8' )

This function is called to decode a HTML string (it decodes entities and br tags)

Parameters

string	$stringtodecode	String to decode
string	$pagecodeto	Page code for result

Returns: string String decoded

Definition at line 7870 of file functions.lib.php.

References dol_html_entity_decode().

Referenced by CommActionRapport\_pages(), AdherentType\getMailOnExclude(), AdherentType\getMailOnResiliate(), AdherentType\getMailOnSubscription(), and AdherentType\getMailOnValid().

◆ dol_htmloutput_errors()

dol_htmloutput_errors	(	$mesgstring = '',
		$mesgarray = array(),
		$keepembedded = 0 )

Print formated error messages to output (Used to show messages on html output).

Parameters

string	$mesgstring	Error message
array	$mesgarray	Error messages array
int	$keepembedded	Set to 1 in error message must be kept embedded into its html place (this disable jnotify)

Returns: void

See also: dol_print_error(); dol_htmloutput_mesg()

Definition at line 9359 of file functions.lib.php.

References dol_htmloutput_mesg().

◆ dol_htmloutput_events()

dol_htmloutput_events ( $disabledoutputofmessages = 0 )

Print formated messages to output (Used to show messages on html output).

Note: Calling dol_htmloutput_events is done into pages by standard llxFooter() function, so there is no need to call it explicitely.

Parameters

int $disabledoutputofmessages Clear all messages stored into session without diplaying them

Returns: void

See also: dol_htmloutput_mesg()

Definition at line 9164 of file functions.lib.php.

References dol_htmloutput_mesg().

◆ dol_htmloutput_mesg()

dol_htmloutput_mesg	(	$mesgstring = '',
		$mesgarray = array(),
		$style = 'ok',
		$keepembedded = 0 )

Print formated messages to output (Used to show messages on html output).

Parameters

string	$mesgstring	Message string or message key
string[]	$mesgarray	Array of message strings or message keys
string	$style	Which style to use ('ok', 'warning', 'error')
int	$keepembedded	Set to 1 if message must be kept embedded into its html place (this disable jnotify)

Returns: void

See also: dol_print_error(); dol_htmloutput_errors(); setEventMessages()

Definition at line 9291 of file functions.lib.php.

References dol_syslog(), and get_htmloutput_mesg().

Referenced by dol_htmloutput_errors(), dol_htmloutput_events(), and ActionsStripeconnect\formObjectOptions().

◆ dol_htmlwithnojs()

dol_htmlwithnojs	(	$stringtoencode,
		$nouseofiframesandbox = 0,
		$check = 'restricthtml' )

Sanitize a HTML to remove js, dangerous content and external link.

This function is used by dolPrintHTML... function for example.

Parameters

string	$stringtoencode	String to encode
int	$nouseofiframesandbox	0=Default, 1=Allow use of option MAIN_SECURITY_USE_SANDBOX_FOR_HTMLWITHNOJS for html sanitizing (not yet working)
string	$check	'restricthtmlnolink' or 'restricthtml' or 'restricthtmlallowclass' or 'restricthtmlallowunvalid'

Returns: string HTML sanitized

Definition at line 7659 of file functions.lib.php.

References dol_string_onlythesehtmlattributes(), dol_string_onlythesehtmltags(), dol_textishtml(), getDolGlobalInt(), getDolGlobalString(), and realCharForNumericEntities().

Referenced by dolPrintHTML(), dolPrintHTMLForTextArea(), Form\editfieldval(), and sanitizeVal().

◆ dol_include_once()

if(!function_exists('dol_getprefix')) dol_include_once	(		$relpath,
			$classname = '' )

Make an include_once using default root and alternate root if it fails.

To link to a core file, use include(DOL_DOCUMENT_ROOT.'/pathtofile') To link to a module file from a module file, use include './mymodulefile'; To link to a module file from a core file, then this function can be used (call by hook / trigger / speciales pages)

Parameters

string	$relpath	Relative path to file (Ie: mydir/myfile, ../myfile, ...)
string	$classname	Class name (deprecated)

Returns: bool True if load is a success, False if it fails

Definition at line 1147 of file functions.lib.php.

References dol_buildpath(), and dol_syslog().

Referenced by FileUpload\__construct(), ActionsCardCommon\assign_values(), Export\build_file(), Product\check_barcode(), Societe\check_codeclient(), Societe\check_codefournisseur(), Utils\cleanUnfinishedCronjob(), Societe\codeclient_modifiable(), Societe\codefournisseur_modifiable(), complete_head_from_modules(), Utils\compressSyslogs(), Contrat\create(), Product\create(), Contrat\createFromClone(), Project\createFromClone(), Propal\createFromClone(), Commande\createFromProposal(), Societe\delete(), CommonObject\deleteCommon(), dolGetElementUrl(), fetchObjectByElement(), CommonObject\fetchObjectLinked(), CommonDocGenerator\fill_substitutionarray_with_extrafields(), fillArrayOfGroupBy(), fillArrayOfMeasures(), fillArrayOfXAxis(), Form\form_multicurrency_code(), Utils\generateDoc(), Product\get_barcode(), Societe\get_codeclient(), Societe\get_codecompta(), Societe\get_codefournisseur(), MouvementStock\get_origin(), CommonDocGenerator\get_substitutionarray_shipment(), Ticket\getDefaultRef(), ImportCsv\import_insert(), ImportXlsx\import_insert(), HookManager\initHooks(), CommonObject\insertExtraFields(), FormFile\list_of_autoecmfiles(), InfoBox\listBoxes(), migrate_reload_modules(), AdvanceTargetingMailing\query_contact(), Cronjob\run_jobs(), CSMSFile\sendfile(), Conf\setValues(), show_actions_done(), show_actions_messaging(), FormSms\show_form(), and FormTicket\showForm().

◆ dol_mimetype()

dol_mimetype	(	$file,
		$default = 'application/octet-stream',
		$mode = 0 )

Return MIME type of a file from its name with extension.

Parameters

string	$file	Filename we looking for MIME type
string	$default	Default mime type if extension not found in known list
int	$mode	0=Return full mime, 1=otherwise short mime string, 2=image for mime type, 3=source language, 4=css of font fa

Returns: string Return a mime type family (text/xxx, application/xxx, image/xxx, audio, video, archive)

See also: dolIsAllowedForPreview(), image_format_supported() from images.lib.php

Definition at line 10953 of file functions.lib.php.

Referenced by FormMail\add_attached_files(), Documents\builddoc(), vCard\buildVCardString(), doc_label_pdf_create(), dol_init_file_process(), getDocument(), FormFile\getDocumentsLink(), FileUpload\getFileObject(), FileUpload\handleFileUpload(), img_mime(), Documents\index(), Facture\sendEmailsRemindersOnInvoiceDueDate(), show_actions_messaging(), FormFile\showdocuments(), FormTicket\showMessageForm(), ActionsTicket\viewTicketMessages(), and pdf_standard\write_file().

◆ dol_mkdir()

dol_mkdir	(	$dir,
		$dataroot = '',
		$newmask = '' )

Creation of a directory (this can create recursive subdir)

Parameters

string	$dir	Directory to create (Separator must be '/'. Example: '/mydir/mysubdir')
string	$dataroot	Data root directory (To avoid having the data root in the loop. Using this will also lost the warning, on first dir, saying PHP has no permission when open_basedir is used)
string	$newmask	Mask for new file (Defaults to $conf->global->MAIN_UMASK or 0755 if unavailable). Example: '0444'

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

Definition at line 7208 of file functions.lib.php.

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

◆ dol_mktime()

dol_mktime	(	$hour,
		$minute,
		$second,
		$month,
		$day,
		$year,
		$gm = 'auto',
		$check = 1 )

Return a timestamp date built from detailed informations (by default a local PHP server timestamp) Replace function mktime not available under Windows if year < 1970 PHP mktime is restricted to the years 1901-2038 on Unix and 1970-2038 on Windows.

Parameters

int	$hour	Hour (can be -1 for undefined)
int	$minute	Minute (can be -1 for undefined)
int	$second	Second (can be -1 for undefined)
int	$month	Month (1 to 12)
int	$day	Day (1 to 31)
int	$year	Year
mixed	$gm	True or 1 or 'gmt'=Input informations are GMT values False or 0 or 'tzserver' = local to server TZ 'auto' 'tzuser' = local to user TZ taking dst into account at the current date. Not yet implemented. 'tzuserrel' = local to user TZ taking dst into account at the given date. Use this one to convert date input from user into a GMT date. 'tz,TimeZone' = use specified timezone
int	$check	0=No check on parameters (Can use day 32, etc...)

Returns: int|string Date as a timestamp, '' or false if error

See also: dol_print_date(), dol_stringtotime(), dol_getdate()

Definition at line 3122 of file functions.lib.php.

References dol_syslog().

Referenced by modAdherent\__construct(), modFacture\__construct(), modFournisseur\__construct(), modHoliday\__construct(), modMultiCurrency\__construct(), modPartnership\__construct(), MouvementStock\_create(), Product\_get_stats(), pdf_paiement\_pagehead(), mailing_fraise\add_to_target(), CommonInvoice\calculate_date_lim_reglement(), Facture\createFromClone(), Project\createFromClone(), Task\createFromClone(), FactureFournisseurRec\createRecurringInvoices(), FactureRec\createRecurringInvoices(), dol_get_first_day(), dol_get_first_day_week(), dol_get_first_hour(), dol_get_last_day(), dol_get_last_hour(), dol_get_next_day(), dol_get_next_week(), dol_get_prev_day(), dol_get_prev_week(), dol_print_date(), dol_stringtotime(), dol_time_plus_duree(), dolSqlDateFilter(), dolWebsiteIncrementCounter(), Accountancy\exportData(), get_next_value(), getCurrentPeriodOfFiscalYear(), getDefaultDatesForTransfer(), ExtraFields\getOptionalsFromPost(), GETPOSTDATE(), ICal\ical_date_to_unix(), Facture\initAsSpecimen(), FactureFournisseurRec\initAsSpecimen(), FactureRec\initAsSpecimen(), Paiement\initAsSpecimen(), PaiementFourn\initAsSpecimen(), RemiseCheque\initAsSpecimen(), DoliDB\jdate(), Adherent\sendReminderForExpiredSubscription(), AssetDepreciationOptions\setDeprecationOptionsFromPost(), ExtraFields\setOptionalsFromPost(), CommonObject\setValuesForExtraLanguages(), show_actions_done(), show_bookcal_day_events(), show_contacts(), show_day_events(), and CommonObject\showOptionals().

◆ dol_nboflines()

dol_nboflines	(		$s,
			$maxchar = 0 )

Return nb of lines of a clear text.

Parameters

string	$s	String to check
int	$maxchar	Not yet used

Returns: int Number of lines

See also: dol_nboflines_bis(), dolGetFirstLineOfText()

Definition at line 7974 of file functions.lib.php.

Referenced by CommActionRapport\_pages().

◆ dol_nboflines_bis()

dol_nboflines_bis	(	$text,
		$maxlinesize = 0,
		$charset = 'UTF-8' )

Return nb of lines of a formated text with
and
(WARNING: string must not have mixed
and br separators)

Parameters

string	$text	Text
int	$maxlinesize	Largeur de ligne en caracteres (ou 0 si pas de limite - defaut)
string	$charset	Give the charset used to encode the $text variable in memory.

Returns: int Number of lines

See also: dol_nboflines(), dolGetFirstLineOfText()

Definition at line 7995 of file functions.lib.php.

References dol_strlen(), and dol_textishtml().

Referenced by pdf_aurore\_pagehead().

◆ dol_nl2br()

dol_nl2br	(	$stringtoencode,
		$nl2brmode = 0,
		$forxml = false )

Replace CRLF in string with a HTML BR tag.

WARNING: The content after operation contains some HTML tags (the
) so be sure to also have encoded the special chars of stringtoencode into HTML before with dol_htmlentitiesbr().

Parameters

string	$stringtoencode	String to encode
int	$nl2brmode	0=Adding br before , 1=Replacing by br
bool	$forxml	false=Use , true=Use

Returns: string String encoded

See also: dol_htmlentitiesbr(), dol_nboflines(), dolGetFirstLineOfText()

Definition at line 7636 of file functions.lib.php.

Referenced by CMailFile\__construct(), DolEditor\__construct(), ActionsAdherentCardCommon\assign_values(), ActionsCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), InterfaceTicketEmail\composeAndSendAdminMessage(), InterfaceTicketEmail\composeAndSendCustomerMessage(), dol_concatdesc(), dol_htmlentitiesbr(), Form\editInPlace(), FormSetupItem\generateOutputField(), FormMail\get_form(), make_substitutions(), Ticket\newMessage(), InterfaceTicketEmail\runTrigger(), and FormTicket\showMessageForm().

◆ dol_now()

dol_now ( $mode = 'auto' )

Return date for now.

In most cases, we use this function without parameters (that means GMT time).

Parameters

string $mode 'auto' => for backward compatibility (avoid this), 'gmt' => we return GMT timestamp, 'tzserver' => we add the PHP server timezone 'tzref' => we add the company timezone. Not implemented. 'tzuser' or 'tzuserrel' => we add the user timezone

Returns: int $date Timestamp

Definition at line 3210 of file functions.lib.php.

References dol_now(), and getServerTimeZoneInt().

◆ dol_osencode()

dol_osencode ( $str )

Return a string encoded into OS filesystem encoding.

This function is used to define value to pass to filesystem PHP functions.

Parameters

string $str String to encode (UTF-8)

Returns: string Encoded string (UTF-8, ISO-8859-1)

Definition at line 9513 of file functions.lib.php.

References getDolGlobalString().

Referenced by CMailFile\_encode_file(), activateModulesRequiredByCountry(), Product\add_photo(), addFileIntoDatabaseIndex(), CommonObject\addThumbs(), Documents\builddoc(), checkLoginPassEntity(), complete_dictionary_with_modules(), complete_elementList_with_modules(), completeFileArrayWithDatabaseInfo(), Website\createFromClone(), Documents\delete(), EcmDirectory\delete(), Product\delete_photo(), dol_copy(), dol_count_nb_of_line(), dol_delete_dir(), dol_delete_dir_recursive(), dol_delete_file(), dol_dir_is_emtpy(), dol_dir_list(), dol_filemtime(), dol_fileperm(), dol_filesize(), dol_getImageSize(), dol_imageResizeOrCrop(), dol_is_dir(), dol_is_file(), dol_is_link(), dol_mkdir(), dol_move(), dol_move_dir(), dol_move_uploaded_file(), dolCopyDir(), dolReplaceInFile(), Translate\file_exists(), Product\get_image_size(), Translate\getLabelFromNumber(), Interfaces\getTriggersList(), ModeleBoxes\getWidgetsList(), ImportCsv\import_open_file(), Documents\index(), CommonObject\indexFile(), Product\is_photo_available(), Ticket\is_photo_available(), Product\liste_photos(), listOfSessions(), Translate\load(), Export\load_arrays(), Import\load_arrays(), migrate_product_photospath(), migrate_user_filespath(), migrate_user_photospath(), migrate_user_photospath2(), purgeSessions(), rebuildObjectClass(), rebuildObjectSql(), Interfaces\run_triggers(), Conf\setValues(), and vignette().

◆ dol_print_address()

dol_print_address	(	$address,
		$htmlid,
		$element,
		$id,
		$noprint = 0,
		$charfornl = '' )

Format address string.

Parameters

string	$address	Address string, already formatted with dol_format_address()
int	$htmlid	Html ID (for example 'gmap')
int	$element	'thirdparty'\|'contact'\|'member'\|'other'
int	$id	Id of object
int	$noprint	No output. Result is the function return
string	$charfornl	Char to use instead of nl2br. '' means we use a standad nl2br.

Returns: string|void Nothing if noprint is 0, formatted address if noprint is 1

See also: dol_format_address()

Definition at line 4042 of file functions.lib.php.

References dol_buildpath(), and getDolGlobalString().

◆ dol_print_date()

dol_print_date	(	$time,
		$format = '',
		$tzoutput = 'auto',
		$outputlangs = '',
		$encodetooutput = false )

Output date in a string format according to outputlangs (or langs if not defined).

Return charset is always UTF-8, except if encodetoouput is defined. In this case charset is output charset

Parameters

int	$time	GM Timestamps date
string	$format	Output date format (tag of strftime function) "%d %b %Y", "%d/%m/%Y %H:%M", "%d/%m/%Y %H:%M:%S", "%B"=Long text of month, "%A"=Long text of day, "%b"=Short text of month, "%a"=Short text of day "day", "daytext", "dayhour", "dayhourldap", "dayhourtext", "dayrfc", "dayhourrfc", "...inputnoreduce", "...reduceformat"
string	$tzoutput	true or 'gmt' => string is for Greenwich location false or 'tzserver' => output string is for local PHP server TZ usage 'tzuser' => output string is for user TZ (current browser TZ with current dst) => In a future, we should have same behaviour than 'tzuserrel' 'tzuserrel' => output string is for user TZ (current browser TZ with dst or not, depending on date position)
Translate	$outputlangs	Object lang that contains language for text translation.
boolean	$encodetooutput	false=no convert into output pagecode

Returns: string Formated date or '' if time is null

See also: dol_mktime(), dol_stringtotime(), dol_getdate(), selectDate()

Definition at line 2823 of file functions.lib.php.

References dol_mktime(), dol_now(), dol_print_error(), dol_strlen(), dol_substr(), and dol_syslog().

◆ dol_print_email()

dol_print_email	(	$email,
		$cid = 0,
		$socid = 0,
		$addlink = 0,
		$max = 64,
		$showinvalid = 1,
		$withpicto = 0 )

Show EMail link formatted for HTML output.

Parameters

string	$email	EMail to show (only email, without 'Name of recipient' before)
int	$cid	Id of contact if known
int	$socid	Id of third party if known
int	$addlink	0=no link, 1=email has a html email link (+ link to create action if constant AGENDA_ADDACTIONFOREMAIL is on)
int	$max	Max number of characters to show
int	$showinvalid	1=Show warning if syntax email is wrong
int \| string	$withpicto	Show picto

Returns: string HTML Link

Definition at line 3335 of file functions.lib.php.

References dol_escape_htmltag(), dol_trunc(), getDolGlobalString(), img_object(), img_picto(), img_warning(), and isValidEmail().

Referenced by ActionsAdherentCardCommon\assign_values(), ActionsCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), Form\editfieldval(), box_last_modified_ticket\loadBox(), box_last_ticket\loadBox(), and ExtraFields\showOutputField().

◆ dol_print_error()

dol_print_error	(	$db = '',
		$error = '',
		$errors = null )

Displays error message system with all the information to facilitate the diagnosis and the escalation of the bugs.

This function must be called when a blocking technical error is encountered. However, one must try to call it only within php pages, classes must return their error through their property "error".

Parameters

DoliDB \| string	$db	Database handler
string \| string[]	$error	String or array of errors strings to show
array	$errors	Array of errors

Returns: void

See also: dol_htmloutput_errors()

Definition at line 5372 of file functions.lib.php.

References dol_escape_htmltag(), dol_htmlentities(), dol_now(), dol_print_date(), dol_syslog(), getDolGlobalInt(), top_httphead(), and utf8_check().

◆ dol_print_error_email()

dol_print_error_email	(	$prefixcode,
		$errormessage = '',
		$errormessages = array(),
		$morecss = 'error',
		$email = '' )

Show a public email and error code to contact if technical error.

Parameters

string	$prefixcode	Prefix of public error code
string	$errormessage	Complete error message
array	$errormessages	Array of error messages
string	$morecss	More css
string	$email	Email

Returns: void

Definition at line 5521 of file functions.lib.php.

References dol_now(), and dol_print_date().

◆ dol_print_ip()

dol_print_ip	(		$ip,
			$mode = 0 )

Return an IP formated to be shown on screen.

Parameters

string	$ip	IP
int	$mode	0=return IP + country/flag, 1=return only country/flag, 2=return only IP

Returns: string Formated IP, with country if GeoIP module is enabled

Definition at line 3908 of file functions.lib.php.

References dolGetCountryCodeFromIp().

Referenced by ExtraFields\showOutputField().

◆ dol_print_phone()

dol_print_phone	(	$phone,
		$countrycode = '',
		$cid = 0,
		$socid = 0,
		$addlink = '',
		$separ = " ",
		$withpicto = '',
		$titlealt = '',
		$adddivfloat = 0 )

Format phone numbers according to country.

Parameters

string	$phone	Phone number to format
string	$countrycode	Country code to use for formatting
int	$cid	Id of contact if known
int	$socid	Id of third party if known
string	$addlink	''=no link to create action, 'AC_TEL'=add link to clicktodial (if module enabled) and add link to create event (if conf->global->AGENDA_ADDACTIONFORPHONE set), 'tel'=Force "tel:..." link
string	$separ	Separation between numbers for a better visibility example : xx.xx.xx.xx.xx. You can also use 'hidenum' to hide the number, keep only the picto.
string	$withpicto	Show picto ('fax', 'phone', 'mobile')
string	$titlealt	Text to show on alt
int	$adddivfloat	Add div float around phone.

Returns: string Formated phone number

Definition at line 3596 of file functions.lib.php.

References dol_strlen(), getDolGlobalString(), img_object(), img_picto(), and make_substitutions().

Referenced by ActionsAdherentCardCommon\assign_values(), ActionsCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), Form\editfieldval(), getCommonSubstitutionArray(), Project\getKanbanView(), Contact\getTooltipContentArray(), Societe\getTooltipContentArray(), User\getTooltipContentArray(), and ExtraFields\showOutputField().

◆ dol_print_profids()

dol_print_profids	(	$profID,
		$profIDtype,
		$countrycode = '',
		$addcpButton = 1 )

Format professional IDs according to their country.

Parameters

string	$profID	Value of profID to format
string	$profIDtype	Type of profID to format ('1', '2', '3', '4', '5', '6' or 'VAT')
string	$countrycode	Country code to use for formatting
int	$addcpButton	Add button to copy to clipboard (1 => show only on hoover ; 2 => always display )

Returns: string Formated profID

Definition at line 3540 of file functions.lib.php.

References dol_escape_htmltag(), dol_strlen(), and showValueWithClipboardCPButton().

Referenced by top_menu_user().

◆ dol_print_size()

dol_print_size	(	$size,
		$shortvalue = 0,
		$shortunit = 0 )

Return string with formated size.

Parameters

int	$size	Size to print
int	$shortvalue	Tell if we want long value to use another unit (Ex: 1.5Kb instead of 1500b)
int	$shortunit	Use short label of size unit (for example 'b' instead of 'bytes')

Returns: string Link

Definition at line 3249 of file functions.lib.php.

Referenced by DolMemoryCollector\collect(), FormFile\list_of_autoecmfiles(), FormFile\list_of_documents(), and FormFile\showdocuments().

◆ dol_print_socialnetworks()

dol_print_socialnetworks	(	$value,
		$cid,
		$socid,
		$type,
		$dictsocialnetworks = array() )

Show social network link.

Parameters

string	$value	Social network ID to show (only skype, without 'Name of recipient' before)
int	$cid	Id of contact if known
int	$socid	Id of third party if known
string	$type	'skype','facebook',...
array	$dictsocialnetworks	List of socialnetworks availables

Returns: string HTML Link

Definition at line 3453 of file functions.lib.php.

References dol_escape_htmltag(), dol_string_nospecial(), getDolGlobalString(), img_object(), and img_warning().

◆ dol_print_url()

dol_print_url	(	$url,
		$target = '_blank',
		$max = 32,
		$withpicto = 0,
		$morecss = '' )

Show Url link.

Parameters

string	$url	Url to show
string	$target	Target for link
int	$max	Max number of characters to show
int	$withpicto	With picto
string	$morecss	More CSS

Returns: string HTML Link

Definition at line 3288 of file functions.lib.php.

References dol_trunc(), and img_picto().

Referenced by ActionsCardCommon\assign_values(), Form\editfieldval(), and ExtraFields\showOutputField().

◆ dol_sanitizeEmail()

dol_sanitizeEmail ( $stringtoclean )

Clean a string to use it as an Email.

Parameters

string $stringtoclean String to clean. Example 'abc@m.nosp@m.ycom.nosp@m.pany..nosp@m.com <My name>'

Returns: string Escaped string.

Definition at line 1426 of file functions.lib.php.

Referenced by CMailFile\__construct().

◆ dol_sanitizeFileName()

dol_sanitizeFileName	(	$str,
		$newstr = '_',
		$unaccent = 1 )

Clean a string to use it as a file name.

Replace also '–' and ' -' strings, they are used for parameters separation (Note: ' - ' is allowed).

Parameters

string	$str	String to clean
string	$newstr	String to replace bad chars with.
int	$unaccent	1=Remove also accent (default), 0 do not remove them

Returns: string String cleaned (a-zA-Z_)

See also: dol_string_nospecial(), dol_string_unaccent(), dol_sanitizePathName()

Definition at line 1343 of file functions.lib.php.

References dol_string_nospecial(), and dol_string_unaccent().

◆ dol_sanitizePathName()

dol_sanitizePathName	(	$str,
		$newstr = '_',
		$unaccent = 1 )

Clean a string to use it as a path name.

Similare to dol_sanitizeFileName but accept / and \ chars. Replace also '–' and ' -' strings, they are used for parameters separation (Note: ' - ' is allowed).

Parameters

string	$str	String to clean
string	$newstr	String to replace bad chars with
int	$unaccent	1=Remove also accent (default), 0 do not remove them

Returns: string String cleaned (a-zA-Z_)

See also: dol_string_nospecial(), dol_string_unaccent(), dol_sanitizeFileName()

Definition at line 1369 of file functions.lib.php.

References dol_string_nospecial(), and dol_string_unaccent().

Referenced by FileUpload\__construct(), CommonObject\commonGenerateDocument(), dol_uncompress(), AntiVir\getCliCommand(), EmailCollector\getpart(), FileUpload\handleFileUpload(), Website\importWebSite(), dolReceiptPrinter\initPrinter(), and Documents\post().

◆ dol_sanitizeUrl()

dol_sanitizeUrl	(		$stringtoclean,
			$type = 1 )

Clean a string to use it as an URL (into a href or src attribute)

Parameters

string	$stringtoclean	String to clean
int	$type	0=Accept all Url, 1=Clean external Url (keep only relative Url)

Returns: string Escaped string.

Definition at line 1390 of file functions.lib.php.

◆ dol_set_focus()

dol_set_focus ( $selector )

Set focus onto field with selector (similar behaviour of 'autofocus' HTML5 tag)

Parameters

string $selector Selector ('id' or 'input[name="ref"]') to use to find the HTML input field that must get the autofocus. You must use a CSS selector, so unique id preceding with the '#' char.

Returns: void

Definition at line 10559 of file functions.lib.php.

◆ dol_shutdown()

dol_shutdown ( )

Function called at end of web php process.

Returns: void

Definition at line 500 of file functions.lib.php.

References dol_syslog().

◆ dol_size()

dol_size	(		$size,
			$type = '' )

Optimize a size for some browsers (phone, smarphone, ...)

Parameters

int	$size	Size we want
string	$type	Type of optimizing: '' = function used to define a size for truncation 'width' = function is used to define a width

Returns: int New size after optimizing

Definition at line 1318 of file functions.lib.php.

Referenced by box_members_by_tags\loadBox(), and box_members_by_type\loadBox().

◆ dol_sort_array()

dol_sort_array	(	&	$array,
			$index,
			$order = 'asc',
			$natsort = 0,
			$case_sensitive = 0,
			$keepindex = 0 )

Advanced sort array by second index function, which produces ascending (default) or descending output and uses optionally natural case insensitive sorting (which can be optionally case sensitive as well).

Parameters

array	$array	Array to sort (array of array('key1'=>val1,'key2'=>val2,'key3'...) or array of objects)
string	$index	Key in array to use for sorting criteria
int	$order	Sort order ('asc' or 'desc')
int	$natsort	If values are strings (I said value not type): 0=Use alphabetical order, 1=use "natural" sort (natsort) If values are numeric (I said value not type): 0=Use numeric order (even if type is string) so use a "natural" sort, 1=use "natural" sort too (same than 0), -1=Force alphabetical order
int	$case_sensitive	1=sort is case sensitive, 0=not case sensitive
int	$keepindex	If 0 and index key of array to sort is a numeric, than index will be rewrote. If 1 or index key is not numeric, key for index is kept after sorting.

Returns: array Sorted array

Definition at line 9378 of file functions.lib.php.

Referenced by dol_dir_list(), Categorie\get_full_arbo(), EcmDirectory\get_full_arbo(), User\get_full_tree(), Setup\getCheckIntegrity(), FormFile\list_of_autoecmfiles(), FormFile\list_of_documents(), Form\load_cache_availability(), Form\load_cache_invoice_subtype(), Form\load_cache_transport_mode(), Form\load_cache_types_paiements(), Form\loadCacheInputReason(), print_auguria_menu(), print_eldy_menu(), rebuildObjectClass(), Form\select_country(), FormCompany\select_juridicalstatus(), show_contacts(), CommonObject\show_photos(), FormFile\showdocuments(), MenuManager\showmenu(), and showModulesExludedForExternal().

◆ dol_strftime()

dol_strftime	(	$fmt,
		$ts = false,
		$is_gmt = false )

Format a string.

Parameters

string	$fmt	Format of strftime function (http://php.net/manual/fr/function.strftime.php)
int	$ts	Timesamp (If is_gmt is true, timestamp is already includes timezone and daylight saving offset, if is_gmt is false, timestamp is a GMT timestamp and we must compensate with server PHP TZ)
int	$is_gmt	See comment of timestamp parameter

Returns: string A formatted string

Definition at line 2793 of file functions.lib.php.

◆ dol_string_is_good_iso()

dol_string_is_good_iso	(		$s,
			$clean = 0 )

Check if a string is a correct iso string If not, it will not be considered as HTML encoded even if it is by FPDF.

Example, if string contains euro symbol that has ascii code 128

Parameters

string	$s	String to check
string	$clean	Clean if it is not an ISO. Warning, if file is utf8, you will get a bad formated file.

Returns: int|string 0 if bad iso, 1 if good iso, Or the clean string if $clean is 1

Deprecated: Duplicate of ascii_check()

See also: ascii_check()

Definition at line 7942 of file functions.lib.php.

References dol_strlen().

◆ dol_string_neverthesehtmltags()

dol_string_neverthesehtmltags	(	$stringtoclean,
		$disallowed_tags = array('textarea'),
		$cleanalsosomestyles = 0 )

Clean a string from some undesirable HTML tags.

Note: You should use instead dol_string_onlythesehtmltags() that is more secured if you can.

Parameters

string	$stringtoclean	String to clean
array	$disallowed_tags	Array of tags not allowed
string	$cleanalsosomestyles	Clean also some tags

Returns: string String cleaned

See also: dol_escape_htmltag() strip_tags() dol_string_nohtmltag() dol_string_onlythesehtmltags() dol_string_onlythesehtmlattributes()

Definition at line 7536 of file functions.lib.php.

Referenced by Form\editfieldval().

◆ dol_string_nohtmltag()

dol_string_nohtmltag	(	$stringtoclean,
		$removelinefeed = 1,
		$pagecodeto = 'UTF-8',
		$strip_tags = 0,
		$removedoublespaces = 1 )

Clean a string from all HTML tags and entities.

This function differs from strip_tags because:

are replaced with
if removelinefeed=0 or 1
if entities are found, they are decoded BEFORE the strip
you can decide to convert line feed into a space

Parameters

string	$stringtoclean	String to clean
integer	$removelinefeed	1=Replace all new lines by 1 space, 0=Only ending new lines are removed others are replaced with , 2=Ending new lines are removed but others are kept with a same number of than nb of when there is both "...<br>\n..."
string	$pagecodeto	Encoding of input/output string
integer	$strip_tags	0=Use internal strip, 1=Use strip_tags() php function (bugged when text contains a < char that is not for a html tag or when tags is not closed like '<img onload=aaa')
integer	$removedoublespaces	Replace double space into one space

Returns: string String cleaned

See also: dol_escape_htmltag() strip_tags() dol_string_onlythesehtmltags() dol_string_neverthesehtmltags(), dolStripPhpCode()

Definition at line 7319 of file functions.lib.php.

References dol_html_entity_decode().

Referenced by Adherent\_load_ldap_info(), AdherentType\_load_ldap_info(), Contact\_load_ldap_info(), User\_load_ldap_info(), UserGroup\_load_ldap_info(), CommActionRapport\_pages(), mailing_xinputfile\add_to_target(), ajax_dialog(), build_calfile(), build_rssfile(), pdf_cyan\defineColumnField(), pdf_eagle_proforma\defineColumnField(), pdf_eratosthene\defineColumnField(), pdf_sponge\defineColumnField(), dol_add_file_process(), dol_trunc(), DolGraph\draw_chart(), ExportExcel2007\excel_clean(), FormMail\get_form(), getCommonSubstitutionArray(), CommonDocGenerator\getExtrafieldContent(), getFullName(), Adherent\getNomUrl(), Commande\getNomUrl(), CommandeFournisseur\getNomUrl(), FactureFournisseur\getNomUrl(), Propal\getNomUrl(), SupplierProposal\getNomUrl(), User\getNomUrl(), GETPOST(), getStructuredData(), Societe\getTooltipContentArray(), User\getTooltipContentArray(), pdf_build_address(), print_left_auguria_menu(), print_left_eldy_menu(), sanitizeVal(), show_contacts(), AccountancyExport\toAnsi(), and ExportTsv\tsv_clean().

◆ dol_string_nospecial()

dol_string_nospecial	(	$str,
		$newstr = '_',
		$badcharstoreplace = '',
		$badcharstoremove = '',
		$keepspaces = 0 )

Clean a string from all punctuation characters to use it as a ref or login.

This is a more complete function than dol_sanitizeFileName().

Parameters

string	$str	String to clean
string	$newstr	String to replace forbidden chars with
array \| string	$badcharstoreplace	Array of forbidden characters to replace. Use '' to keep default list.
array \| string	$badcharstoremove	Array of forbidden characters to remove. Use '' to keep default list.
int	$keepspaces	1=Do not treat space as a special char to replace or remove

Returns: string Cleaned string

See also: dol_sanitizeFilename(), dol_string_unaccent(), dol_string_nounprintableascii()

Definition at line 1516 of file functions.lib.php.

Referenced by barcode_encode_genbarcode(), BonPrelevement\buildRumNumber(), check_value(), Societe\contact_get_property(), Product\create(), ProductAttribute\create(), ProductAttributeValue\create(), CommonObject\createCommon(), PartnershipUtils\doCancelStatusOfMemberPartnership(), dol_buildlogin(), dol_print_socialnetworks(), dol_sanitizeFileName(), dol_sanitizePathName(), PartnershipUtils\doWarningOfPartnershipIfDolibarrBacklinkNotfound(), DolGraph\draw_chart(), DolGraph\draw_jflot(), BonPrelevement\EnregDestinataireSEPA(), BonPrelevement\EnregEmetteurSEPA(), AccountancyExport\exportFEC(), AccountancyExport\exportFEC2(), BonPrelevement\generate(), get_next_value(), AntiVir\getCliCommand(), GETPOST(), Product\update(), ProductAttribute\update(), ProductAttributeValue\update(), CommonObject\updateCommon(), and doc_generic_odt\write_file().

◆ dol_string_nounprintableascii()

dol_string_nounprintableascii	(		$str,
			$removetabcrlf = 1 )

Clean a string from all non printable ASCII chars (0x00-0x1F and 0x7F).

It can also removes also Tab-CR-LF. UTF8 chars remains. This can be used to sanitize a string and view its real content. Some hacks try to obfuscate attacks by inserting non printable chars. Note, for information: UTF8 on 1 byte are: \x00-\7F 2 bytes are: byte 1 \xc0-\xdf, byte 2 = \x80-\xbf 3 bytes are: byte 1 \xe0-\xef, byte 2 = \x80-\xbf, byte 3 = \x80-\xbf 4 bytes are: byte 1 \xf0-\xf7, byte 2 = \x80-\xbf, byte 3 = \x80-\xbf, byte 4 = \x80-\xbf

Parameters

string	$str	String to clean
int	$removetabcrlf	Remove also CR-LF

Returns: string Cleaned string

See also: dol_sanitizeFilename(), dol_string_unaccent(), dol_string_nospecial()

Definition at line 1549 of file functions.lib.php.

Referenced by dol_string_onlythesehtmltags().

◆ dol_string_onlythesehtmlattributes()

dol_string_onlythesehtmlattributes	(		$stringtoclean,
			$allowed_attributes = null )

Clean a string from some undesirable HTML tags.

Note: Complementary to dol_string_onlythesehtmltags(). This method is used for example by dol_htmlwithnojs() when option MAIN_RESTRICTHTML_REMOVE_ALSO_BAD_ATTRIBUTES is set to 1.

Parameters

string	$stringtoclean	String to clean
array	$allowed_attributes	Array of tags not allowed

Returns: string String cleaned

See also: dol_escape_htmltag() strip_tags() dol_string_nohtmltag() dol_string_onlythesehtmltags() dol_string_neverthesehtmltags()

Definition at line 7460 of file functions.lib.php.

Referenced by dol_htmlwithnojs().

◆ dol_string_onlythesehtmltags()

dol_string_onlythesehtmltags	(	$stringtoclean,
		$cleanalsosomestyles = 1,
		$removeclassattribute = 1,
		$cleanalsojavascript = 0,
		$allowiframe = 0,
		$allowed_tags = array(),
		$allowlink = 0 )

Clean a string to keep only desirable HTML tags.

WARNING: This also clean HTML comments (because they can be used to obfuscate tag name).

Parameters

string	$stringtoclean	String to clean
int	$cleanalsosomestyles	Remove absolute/fixed positioning from inline styles
int	$removeclassattribute	1=Remove the class attribute from tags
int	$cleanalsojavascript	Remove also occurence of 'javascript:'.
int	$allowiframe	Allow iframe tags.
array	$allowed_tags	List of allowed tags to replace the default list
int	$allowlink	Allow "link" tags.

Returns: string String cleaned

See also: dol_htmlwithnojs() dol_escape_htmltag() strip_tags() dol_string_nohtmltag() dol_string_neverthesehtmltags()

Definition at line 7391 of file functions.lib.php.

References dol_string_nounprintableascii().

Referenced by dol_escape_htmltag(), dol_htmlwithnojs(), dolPrintHTML(), dolPrintHTMLForAttribute(), dolPrintHTMLForTextArea(), and Form\editfieldval().

◆ dol_string_unaccent()

dol_string_unaccent ( $str )

Clean a string from all accent characters to be used as ref, login or by dol_sanitizeFileName.

Parameters

string $str String to clean

Returns: string Cleaned string

See also: dol_sanitizeFilename(), dol_string_nospecial()

Definition at line 1444 of file functions.lib.php.

References getDolGlobalString(), and utf8_check().

Referenced by CMailFile\__construct(), BonPrelevement\buildRumNumber(), dol_buildlogin(), dol_sanitizeFileName(), dol_sanitizePathName(), DolGraph\draw_chart(), DolGraph\draw_jflot(), BonPrelevement\EnregDestinataireSEPA(), BonPrelevement\EnregEmetteurSEPA(), AccountancyExport\exportCegid(), AccountancyExport\exportCiel(), AccountancyExport\exportFEC(), AccountancyExport\exportFEC2(), AccountancyExport\exportQuadratus(), AccountancyExport\exportWinfic(), BonPrelevement\generate(), get_next_value(), mod_codeproduct_elephant\getNextValue(), and Form\select_country().

◆ dol_strlen()

dol_strlen	(		$string,
			$stringencoding = 'UTF-8' )

Make a strlen call.

Works even if mbstring module not enabled

Parameters

string	$string	String to calculate length
string	$stringencoding	Encoding of string

Returns: int Length of string

Definition at line 4203 of file functions.lib.php.

◆ dol_strtolower()

dol_strtolower	(		$string,
			$encoding = "UTF-8" )

Convert a string to lower.

Never use strtolower because it does not works with UTF8 strings.

Parameters

string	$string	String to encode
string	$encoding	Character set encoding

Returns: string String converted

Definition at line 1792 of file functions.lib.php.

◆ dol_strtoupper()

dol_strtoupper	(		$string,
			$encoding = "UTF-8" )

Convert a string to upper.

Never use strtolower because it does not works with UTF8 strings.

Parameters

string	$string	String to encode
string	$encoding	Character set encoding

Returns: string String converted

See also: dol_ucfirst(), dol_ucwords()

Definition at line 1809 of file functions.lib.php.

Referenced by Adherent\getmorphylib().

◆ dol_substr()

dol_substr	(	$string,
		$start,
		$length = null,
		$stringencoding = '',
		$trunconbytes = 0 )

Make a substring.

Works even if mbstring module is not enabled for better compatibility.

Parameters

string	$string	String to scan
string	$start	Start position
int \| null	$length	Length (in nb of characters or nb of bytes depending on trunconbytes param)
string	$stringencoding	Page code used for input string encoding
int	$trunconbytes	1=Length is max of bytes instead of max of characters

Returns: string substring

Definition at line 4226 of file functions.lib.php.

Referenced by calEncode(), Project\create(), dol_print_date(), dol_trunc(), dolEncrypt(), dolGetFirstLetters(), get_next_value(), Job\getKanbanView(), Skill\getKanbanView(), Societe\getTypeUrl(), removeGlobalParenthesis(), Cronjob\run_jobs(), Form\searchComponent(), AccountancyExport\toAnsi(), and ExportExcel2007\write_record().

◆ dol_syslog()

dol_syslog	(	$message,
		$level = LOG_INFO,
		$ident = 0,
		$suffixinfilename = '',
		$restricttologhandler = '',
		$logcontext = null )

Write log message into outputs.

Possible outputs can be: SYSLOG_HANDLERS = ["mod_syslog_file"] file name is then defined by SYSLOG_FILE SYSLOG_HANDLERS = ["mod_syslog_syslog"] facility is then defined by SYSLOG_FACILITY Warning, syslog functions are bugged on Windows, generating memory protection faults. To solve this, use logging to files instead of syslog (see setup of module). Note: If constant 'SYSLOG_FILE_NO_ERROR' defined, we never output any error message when writing to log fails. Note: You can get log message into html sources by adding parameter &logtohtml=1 (constant MAIN_LOGTOHTML must be set) This function works only if syslog module is enabled. This must not use any call to other function calling dol_syslog (avoid infinite loop).

Parameters

string	$message	Line to log. ''=Show nothing
int	$level	Log level On Windows LOG_ERR=4, LOG_WARNING=5, LOG_NOTICE=LOG_INFO=6, LOG_DEBUG=6 si define_syslog_variables ou PHP 5.3+, 7 si dolibarr On Linux LOG_ERR=3, LOG_WARNING=4, LOG_NOTICE=5, LOG_INFO=6, LOG_DEBUG=7
int	$ident	1=Increase ident of 1 (after log), -1=Decrease ident of 1 (before log)
string	$suffixinfilename	When output is a file, append this suffix into default log filename. Example '_stripe', '_mail'
string	$restricttologhandler	Force output of log only to this log handler
array \| null	$logcontext	If defined, an array with extra informations (can be used by some log handlers)

Returns: void

Definition at line 1873 of file functions.lib.php.

References dol_escape_htmltag(), dol_print_date(), getDolGlobalInt(), getDolGlobalString(), and getUserRemoteIP().

◆ dol_textishtml()

dol_textishtml	(		$msg,
			$option = 0 )

Return if a text is a html content.

Parameters

string	$msg	Content to check
int	$option	0=Full detection, 1=Fast check

Returns: boolean true/false

See also: dol_concatdesc()

Definition at line 8038 of file functions.lib.php.

Referenced by CMailFile\__construct(), DolEditor\__construct(), ajax_dialog(), InterfaceTicketEmail\composeAndSendAdminMessage(), InterfaceTicketEmail\composeAndSendCustomerMessage(), dol_concatdesc(), dol_htmlentitiesbr(), dol_htmlwithnojs(), dol_nboflines_bis(), dol_trunc(), dolGetButtonAction(), dolGetFirstLineOfText(), envoi_mail(), Mailing\fetch(), FormMail\get_form(), ActionComm\getNomUrl(), getTitleFieldOfList(), ActionComm\getTooltipContentArray(), make_substitutions(), Adherent\makeSubstitution(), Ticket\newMessage(), pdf_getlinedesc(), Adherent\sendEmail(), sendEmailTo(), and FormTicket\showMessageForm().

◆ dol_trunc()

dol_trunc	(	$string,
		$size = 40,
		$trunc = 'right',
		$stringencoding = 'UTF-8',
		$nodot = 0,
		$display = 0 )

Truncate a string to a particular length adding '…' if string larger than length.

If length = max length+1, we do no truncate to avoid having just 1 char replaced with '…'. MAIN_DISABLE_TRUNC=1 can disable all truncings

Parameters

string	$string	String to truncate
int	$size	Max string size visible (excluding …). 0 for no limit. WARNING: Final string size can have 3 more chars (if we added …, or if size was max+1 so it does not worse to replace with ...)
string	$trunc	Where to trunc: 'right', 'left', 'middle' (size must be a 2 power), 'wrap'
string	$stringencoding	Tell what is source string encoding
int	$nodot	Truncation do not add … after truncation. So it's an exact truncation.
int	$display	Trunc is used to display data and can be changed for small screen. TODO Remove this param (must be dealt with CSS)

Returns: string Truncated string. WARNING: length is never higher than $size if $nodot is set, but can be 3 chars higher otherwise.

Definition at line 4265 of file functions.lib.php.

References dol_string_nohtmltag(), dol_strlen(), dol_substr(), dol_textishtml(), dol_trunc(), and getDolGlobalString().

◆ dol_ucfirst()

dol_ucfirst	(		$string,
			$encoding = "UTF-8" )

Convert first character of the first word of a string to upper.

Never use ucfirst because it does not works with UTF8 strings.

Parameters

string	$string	String to encode
string	$encoding	Character set encodign

Returns: string String converted

See also: dol_strtoupper(), dol_ucwords()

Definition at line 1826 of file functions.lib.php.

◆ dol_ucwords()

dol_ucwords	(		$string,
			$encoding = "UTF-8" )

Convert first character of all the words of a string to upper.

Parameters

string	$string	String to encode
string	$encoding	Character set encodign

Returns: string String converted

See also: dol_strtoupper(), dol_ucfirst()

Definition at line 1843 of file functions.lib.php.

◆ dol_user_country()

dol_user_country ( )

Return country code for current user.

If software is used inside a local network, detection may fails (we need a public ip)

Returns: string Country code (fr, es, it, us, ...)

Definition at line 4011 of file functions.lib.php.

References getDolGlobalString(), and getUserRemoteIP().

◆ dol_validElement()

dol_validElement ( $element )

Return if var element is ok.

Parameters

string $element Variable to check

Returns: boolean Return true of variable is not empty

See also: getElementProperties()

Definition at line 9836 of file functions.lib.php.

◆ dolButtonToOpenUrlInDialogPopup()

dolButtonToOpenUrlInDialogPopup	(	$name,
		$label,
		$buttonstring,
		$url,
		$disabled = '',
		$morecss = 'classlink button bordertransp',
		$jsonopen = '',
		$backtopagejsfields = '',
		$accesskey = '' )

Return HTML code to output a button to open a dialog popup box.

Such buttons must be included inside a HTML form.

Parameters

string	$name	A name for the html component
string	$label	Label shown in Popup title top bar
string	$buttonstring	button string (HTML text we can click on)
string	$url	Relative Url to open. For example '/project/card.php'
string	$disabled	Disabled text
string	$morecss	More CSS
string	$jsonopen	Some JS code to execute on click/open of popup
string	$backtopagejsfields	The back to page must be managed using javascript instead of a redirect. Value is 'keyforpopupid:Name_of_html_component_to_set_with id,Name_of_html_component_to_set_with_label'
string	$accesskey	A key to use shortcut

Returns: string HTML component with button

Definition at line 1992 of file functions.lib.php.

References dol_escape_htmltag(), and dol_escape_js().

Referenced by top_menu_user().

◆ dolCheckFilters()

dolCheckFilters	(		$sqlfilters,
		&	$error = '' )

Return if a $sqlfilters parameter has a valid balance of parenthesis.

Parameters

string	$sqlfilters	sqlfilter string
string	$error	Error message

Returns: boolean True if valid, False if not valid ($error is filled with the reason in such a case)

Definition at line 12611 of file functions.lib.php.

References dol_syslog().

Referenced by DolibarrApi\_checkFilters(), and forgeSQLFromUniversalSearchCriteria().

◆ dolChmod()

dolChmod	(		$filepath,
			$newmask = '' )

Change mod of a file.

Parameters

string	$filepath	Full file path
string	$newmask	Force new mask. For example '0644'

Returns: void

Definition at line 7280 of file functions.lib.php.

References getDolGlobalString().

◆ dolExplodeIntoArray()

dolExplodeIntoArray	(	$string,
		$delimiter = ';',
		$kv = '=' )

Split a string with 2 keys into key array.

For example: "A=1;B=2;C=2" is exploded into array('A'=>1,'B'=>2,'C'=>3)

Parameters

string \| null	$string	String to explode
string	$delimiter	Delimiter between each couple of data. Example: ';' or '[ ;]+' or '( \r\|\r\| \|;)'
string	$kv	Delimiter between key and value

Returns: array Array of data exploded

Definition at line 10521 of file functions.lib.php.

Referenced by EmailCollector\overwritePropertiesOfObject().

◆ dolForgeCriteriaCallback()

dolForgeCriteriaCallback ( $matches )

Function to forge a SQL criteria from a Dolibarr filter syntax string.

This method is called by forgeSQLFromUniversalSearchCriteria()

Parameters

array $matches Array of found string by regex search. Example: "t.ref:like:'SO-%'" or "t.date_creation:<:'20160101'" or "t.date_creation:<:'2016-01-01 12:30:00'" or "t.nature:is:NULL"

Returns: string Forged criteria. Example: "t.field LIKE 'abc%'"

Definition at line 12665 of file functions.lib.php.

Referenced by DolibarrApi\_forge_criteria_callback().

◆ dolForgeDummyCriteriaCallback()

dolForgeDummyCriteriaCallback ( $matches )

Function to forge a SQL criteria from a Dolibarr filter syntax string.

This method is called by forgeSQLFromUniversalSearchCriteria()

Parameters

array $matches Array of found string by regex search. Example: "t.ref:like:'SO-%'" or "t.date_creation:<:'20160101'" or "t.nature:is:NULL"

Returns: string Forged criteria. Example: "" or "()"

Definition at line 12643 of file functions.lib.php.

◆ dolGetBadge()

dolGetBadge	(	$label,
		$html = '',
		$type = 'primary',
		$mode = '',
		$url = '',
		$params = array() )

Function dolGetBadge.

Parameters

string	$label	label of badge no html : use in alt attribute for accessibility
string	$html	optional : label of badge with html
string	$type	type of badge : Primary Secondary Success Danger Warning Info Light Dark status0 status1 status2 status3 status4 status5 status6 status7 status8 status9
string	$mode	default '' , 'pill', 'dot'
string	$url	the url for link
array	$params	various params for future : recommended rather than adding more fuction arguments. array('attr'=>array('title'=>'abc'))

Returns: string Html badge

Definition at line 11406 of file functions.lib.php.

◆ dolGetButtonAction()

dolGetButtonAction	(	$label,
		$text = '',
		$actionType = 'default',
		$url = '',
		$id = '',
		$userRight = 1,
		$params = array() )

Function dolGetButtonAction.

Parameters

string	$label	Label or tooltip of button if $text is provided. Also used as tooltip in title attribute. Can be escaped HTML content or full simple text.
string	$text	Optional : short label on button. Can be escaped HTML content or full simple text.
string	$actionType	'default', 'danger', 'email', 'clone', 'cancel', 'delete', ...
string \| array	$url	Url for link or array of subbutton description ('label'=>, 'url'=>, 'lang'=>, 'perm'=> ) Example when an array is used: $arrayforbutaction = array( 10 => array('lang'=>'propal', 'enabled'=>isModEnabled("propal"), 'perm'=>$user->hasRight('propal', 'creer'), 'label' => 'AddProp', 'url'=>'/comm/propal/card.php?action=create&projectid='.$object->id.'&socid='.$object->socid), 20 => array('lang'=>'orders', 'enabled'=>isModEnabled("commande"), 'perm'=>$user->hasRight('commande', 'creer'), 'label' => 'CreateOrder', 'url'=>'/commande/card.php?action=create&projectid='.$object->id.'&socid='.$object->socid), 30 => array('lang'=>'bills', 'enabled'=>isModEnabled("facture"), 'perm'=>$user->hasRight('facture', 'creer'), 'label' => 'CreateBill', 'url'=>'/compta/facture/card.php?action=create&projectid='.$object->id.'&socid='.$object->socid), );
string	$id	Attribute id of action button. Example 'action-delete'. This can be used for full ajax confirm if this code is reused into the ->formconfirm() method.
int \| boolean	$userRight	User action right // phpcs:disable
array	$params	= [ // Various params for future : recommended rather than adding more function arguments 'attr' => [ // to add or override button attributes 'xxxxx' => '', // your xxxxx attribute you want 'class' => 'reposition', // to add more css class to the button class attribute 'classOverride' => '' // to replace class attribute of the button ], 'confirm' => [ 'url' => 'http://', // Overide Url to go when user click on action btn, if empty default url is $url.?confirm=yes, for no js compatibility use $url for fallback confirm. 'title' => '', // Overide title of modal, if empty default title use "ConfirmBtnCommonTitle" lang key 'action-btn-label' => '', // Overide label of action button, if empty default label use "Confirm" lang key 'cancel-btn-label' => '', // Overide label of cancel button, if empty default label use "CloseDialog" lang key 'content' => '', // Overide text of content, if empty default content use "ConfirmBtnCommonContent" lang key 'modal' => true, // true\|false to display dialog as a modal (with dark background) 'isDropDrown' => false, // true\|false to display dialog as a dropdown (with dark background) ], ] // phpcs:enable

Returns: string html button

Definition at line 11588 of file functions.lib.php.

References dol_escape_htmltag(), dol_textishtml(), dolGetButtonAction(), and setEventMessages().

Referenced by displayPositionCard(), and dolGetButtonAction().

◆ dolGetButtonTitle()

dolGetButtonTitle	(	$label,
		$helpText = '',
		$iconClass = 'fa fa-file',
		$url = '',
		$id = '',
		$status = 1,
		$params = array() )

Function dolGetButtonTitle : this kind of buttons are used in title in list.

Parameters

string	$label	label of button
string	$helpText	optional : content for help tooltip
string	$iconClass	class for icon element (Example: 'fa fa-file')
string	$url	the url for link
string	$id	attribute id of button
int	$status	0 no user rights, 1 active, 2 current action or selected, -1 Feature Disabled, -2 disable Other reason use param $helpText as tooltip help
array	$params	various params for future : recommended rather than adding more function arguments

Returns: string html button

Definition at line 11794 of file functions.lib.php.

References dol_escape_htmltag(), and getDolGlobalString().

Referenced by show_contacts(), show_contacts_projects(), show_projects(), and FormActions\showactions().

◆ dolGetButtonTitleSeparator()

dolGetButtonTitleSeparator ( $moreClass = "" )

Add space between dolGetButtonTitle.

Parameters

string $moreClass more css class label

Returns: string html of title separator

Definition at line 11759 of file functions.lib.php.

◆ dolGetCountryCodeFromIp()

dolGetCountryCodeFromIp ( $ip )

Return a country code from IP.

Empty string if not found.

Parameters

string $ip IP

Returns: string Country code ('us', 'fr', ...)

Definition at line 3985 of file functions.lib.php.

References getDolGlobalString().

Referenced by dol_print_ip().

◆ dolGetFirstLastname()

dolGetFirstLastname	(	$firstname,
		$lastname,
		$nameorder = -1 )

Return firstname and lastname in correct order.

Parameters

string	$firstname	Firstname
string	$lastname	Lastname
int	$nameorder	-1=Auto, 0=Lastname+Firstname, 1=Firstname+Lastname, 2=Firstname, 3=Firstname if defined else lastname, 4=Lastname, 5=Lastname if defined else firstname

Returns: string Firstname + lastname or Lastname + firstname

Definition at line 9044 of file functions.lib.php.

References getDolGlobalString().

Referenced by pdf_standard\_pagehead(), ActionComm\build_exportfile(), Societe\contact_array(), Societe\contact_get_property(), Societe\contact_property_array(), Tickets\getCommon(), getCommonSubstitutionArray(), ConferenceOrBoothAttendee\getFullName(), getFullName(), RecruitmentCandidature\getFullName(), UserGroup\getFullName(), mod_expensereport_jade\getNextValue(), ExpenseReportRule\getUserName(), Ticket\newMessage(), InterfaceTicketEmail\runTrigger(), FormAccounting\select_auxaccount(), Notify\send(), BonPrelevement\set_infotrans(), and User\user_get_property().

◆ dolGetFirstLetters()

dolGetFirstLetters	(		$s,
			$nbofchar = 1 )

Return first letters of a strings.

Example with nbofchar=1: 'ghi' will return 'g' but 'abc def' will return 'ad' Example with nbofchar=2: 'ghi' will return 'gh' but 'abc def' will return 'abde'

Parameters

string	$s	String to truncate
int	$nbofchar	Nb of characters to keep

Returns: string Return first chars.

Definition at line 4184 of file functions.lib.php.

References dol_substr().

Referenced by Adherent\getmorphylib().

◆ dolGetFirstLineOfText()

dolGetFirstLineOfText	(	$text,
		$nboflines = 1,
		$charset = 'UTF-8' )

Return first line of text.

Cut will depends if content is HTML or not.

Parameters

string	$text	Input text
int	$nboflines	Nb of lines to get (default is 1 = first line only)
string	$charset	Charset of $text string (UTF-8 by default)

Returns: string Output text

See also: dol_nboflines_bis(), dol_string_nohtmltag(), dol_escape_htmltag()

Definition at line 7561 of file functions.lib.php.

References dol_textishtml().

Referenced by CommActionRapport\_pages(), FormMail\get_form(), ActionComm\getNomUrl(), Skill\getNomUrl(), ActionComm\getTooltipContentArray(), and show_actions_messaging().

◆ dolGetStatus()

dolGetStatus	(	$statusLabel = '',
		$statusLabelShort = '',
		$html = '',
		$statusType = 'status0',
		$displayMode = 0,
		$url = '',
		$params = array() )

Output the badge of a status.

Parameters

string	$statusLabel	Label of badge no html : use in alt attribute for accessibility
string	$statusLabelShort	Short label of badge no html
string	$html	Optional : label of badge with html
string	$statusType	status0 status1 status2 status3 status4 status5 status6 status7 status8 status9 : image name or badge name
int	$displayMode	0=Long label, 1=Short label, 2=Picto + Short label, 3=Picto, 4=Picto + Long label, 5=Short label + Picto, 6=Long label + Picto
string	$url	The url for link
array	$params	Various params. Example: array('tooltip'=>'no\|...', 'badgeParams'=>...)

Returns: string Html status string

Definition at line 11470 of file functions.lib.php.

References getDolGlobalString(), and img_picto().

◆ dolIsAllowedForPreview()

dolIsAllowedForPreview ( $file )

Return if a file is qualified for preview.

Parameters

string $file Filename we looking for information

Returns: int 1 If allowed, 0 otherwise

See also: dol_mimetype(), image_format_supported() from images.lib.php

Definition at line 10918 of file functions.lib.php.

Referenced by Form\showphoto().

◆ dolPrintHTML()

dolPrintHTML	(		$s,
			$allowiframe = 0 )

Return a string ready to be output on HTML page To use text inside an attribute, you can simply use dolPrintHTMLForAttribute() or dol_escape_htmltag()

Parameters

string	$s	String to print
int	$allowiframe	Allow iframe tags

Returns: string String ready for HTML output

Definition at line 1669 of file functions.lib.php.

References dol_escape_htmltag(), dol_htmlentitiesbr(), dol_htmlwithnojs(), and dol_string_onlythesehtmltags().

Referenced by ActionsTicket\viewTicketOriginalMessage().

◆ dolPrintHTMLForAttribute()

dolPrintHTMLForAttribute ( $s )

Return a string ready to be output on an HTML attribute (alt, title, data-html, ...)

Parameters

string $s String to print

Returns: string String ready for HTML output

Definition at line 1680 of file functions.lib.php.

References dol_escape_htmltag(), dol_htmlentitiesbr(), and dol_string_onlythesehtmltags().

◆ dolPrintHTMLForTextArea()

dolPrintHTMLForTextArea	(		$s,
			$allowiframe = 0 )

Return a string ready to be output on input textarea To use text inside an attribute, use can use only dol_escape_htmltag()

Parameters

string	$s	String to print
int	$allowiframe	Allow iframe tags

Returns: string String ready for HTML output into a textarea

Definition at line 1695 of file functions.lib.php.

References dol_escape_htmltag(), dol_htmlentitiesbr(), dol_htmlwithnojs(), and dol_string_onlythesehtmltags().

◆ dolPrintLabel()

dolPrintLabel ( $s )

Return a string label (so on 1 line only and that should not contains any HTML) ready to be output on HTML page To use text that is not HTML content inside an attribute, use can simply only dol_escape_htmltag().

In doubt, use dolPrintHTMLForAttribute().

Parameters

string $s String to print

Returns: string String ready for HTML output

Definition at line 1656 of file functions.lib.php.

References dol_escape_htmltag(), and dol_htmlentitiesbr().

◆ dolPrintPassword()

dolPrintPassword ( $s )

Return a string ready to be output on an HTML attribute (alt, title, ...)

Parameters

string $s String to print

Returns: string String ready for HTML output

Definition at line 1706 of file functions.lib.php.

◆ fetchObjectByElement()

fetchObjectByElement	(	$element_id,
		$element_type,
		$element_ref = '' )

Fetch an object from its id and element_type Inclusion of classes is automatic.

Parameters

int	$element_id	Element id (Use this or element_id but not both)
string	$element_type	Element type ('module' or 'myobject@mymodule' or 'mymodule_myobject')
string	$element_ref	Element ref (Use this or element_id but not both)

Returns: int|object object || 0 || <0 if error

See also: getElementProperties()

Definition at line 12223 of file functions.lib.php.

References dol_include_once(), and getElementProperties().

Referenced by FileUpload\__construct(), Dolresource\fetch_element_resource(), and Dolresource\fetchElementResources().

◆ fieldLabel()

fieldLabel	(	$langkey,
		$fieldkey,
		$fieldrequired = 0 )

Show a string with the label tag dedicated to the HTML edit field.

Parameters

string	$langkey	Translation key
string	$fieldkey	Key of the html select field the text refers to
int	$fieldrequired	1=Field is mandatory

Returns: string

Deprecated: Form\editfieldkey

Definition at line 2655 of file functions.lib.php.

◆ finishSimpleTable()

finishSimpleTable ( $addLineBreak = false )

Add the correct HTML close tags for "startSimpleTable(...)" (use after the last table line)

Parameters

bool $addLineBreak (optional) Add a extra line break after the complete table (<br>)

Returns: void

See also: startSimpleTable()

Definition at line 12397 of file functions.lib.php.

◆ forgeSQLFromUniversalSearchCriteria()

forgeSQLFromUniversalSearchCriteria	(		$filter,
		&	$errorstr = '',
			$noand = 0,
			$nopar = 0,
			$noerror = 0 )

forgeSQLFromUniversalSearchCriteria

Parameters

string	$filter	String with universal search string. Must be '(aaa:bbb:...) OR (ccc:ddd:...) ...' with aaa is a field name (with alias or not) and bbb is one of this operator '=', '<', '>', '<=', '>=', '!=', 'in', 'notin', 'like', 'notlike', 'is', 'isnot'. Example: '((client:=:1) OR ((client:>=:2) AND (client:<=:3))) AND (client:!=:8) AND (nom:like:'a')'
string	$errorstr	Error message string
int	$noand	1=Do not add the AND before the condition string.
int	$nopar	1=Do not add the perenthesis around the condition string.
int	$noerror	1=If search criteria is not valid, does not return an error string but invalidate the SQL

Returns: string Return forged SQL string

Definition at line 12568 of file functions.lib.php.

References dolCheckFilters().

Referenced by Products\getAttributes(), Setup\getAvailability(), BankAccounts\getLines(), Proposals\getLines(), Setup\getListOfCivilities(), Setup\getListOfContactTypes(), Setup\getListOfCountries(), Setup\getListOfCurrencies(), Setup\getListOfEventTypes(), Setup\getListOfExpenseReportsTypes(), Setup\getListOfExtrafields(), Setup\getListOfLegalForm(), Setup\getListOfMeasuringUnits(), Setup\getListOfsocialNetworks(), Setup\getListOfStaff(), Setup\getListOfStates(), Setup\getListOfTowns(), Setup\getOrderingMethods(), Setup\getOrderingOrigins(), Setup\getPaymentTerms(), Setup\getPaymentTypes(), Setup\getShippingModes(), Products\getSupplierProducts(), Setup\getTicketsCategories(), Setup\getTicketsSeverities(), Setup\getTicketsTypes(), AgendaEvents\index(), BankAccounts\index(), Boms\index(), Categories\index(), Contacts\index(), Contracts\index(), Donations\index(), ExpenseReports\index(), Interventions\index(), Invoices\index(), KnowledgeManagement\index(), Members\index(), MembersTypes\index(), Mos\index(), MyModuleApi\index(), Orders\index(), Partnerships\index(), Products\index(), Projects\index(), Proposals\index(), Receptions\index(), Shipments\index(), StockMovements\index(), Subscriptions\index(), SupplierInvoices\index(), SupplierOrders\index(), SupplierProposals\index(), Tasks\index(), Thirdparties\index(), Tickets\index(), Users\index(), Warehouses\index(), Zapier\index(), Recruitments\indexCandidature(), Recruitments\indexJobPosition(), Users\listGroups(), Form\searchComponent(), Form\select_thirdparty_list(), and CommonObject\showInputField().

◆ get_date_range()

get_date_range	(	$date_start,
		$date_end,
		$format = '',
		$outputlangs = '',
		$withparenthesis = 1 )

Format output for start and end date.

Parameters

int	$date_start	Start date
int	$date_end	End date
string	$format	Output date format ('day', 'dayhour', ...)
Translate	$outputlangs	Output language
integer	$withparenthesis	1=Add parenthesis, 0=no parenthesis

Returns: string String

Definition at line 9013 of file functions.lib.php.

References dol_print_date().

Referenced by box_members_last_subscriptions\loadBox(), print_date_range(), and CommonObject\printOriginLine().

◆ get_default_localtax()

get_default_localtax	(	$thirdparty_seller,
		$thirdparty_buyer,
		$local,
		$idprod = 0 )

Function that return localtax of a product line (according to seller, buyer and product vat rate) Si vendeur non assujeti a TVA, TVA par defaut=0.

Fin de regle. Si le (pays vendeur = pays acheteur) alors TVA par defaut=TVA du produit vendu. Fin de regle. Sinon TVA proposee par defaut=0. Fin de regle.

Parameters

Societe	$thirdparty_seller	Thirdparty seller
Societe	$thirdparty_buyer	Thirdparty buyer
int	$local	Localtax to process (1 or 2)
int	$idprod	Id product

Returns: integer localtax, -1 si ne peut etre determine

See also: get_default_tva(), get_default_npr()

Definition at line 7046 of file functions.lib.php.

References get_product_localtax_for_country().

◆ get_default_npr()

get_default_npr	(	Societe	$thirdparty_seller,
		Societe	$thirdparty_buyer,
			$idprod = 0,
			$idprodfournprice = 0 )

Function that returns whether VAT must be recoverable collected VAT (e.g.: VAT NPR in France)

Parameters

Societe	$thirdparty_seller	Thirdparty seller
Societe	$thirdparty_buyer	Thirdparty buyer
int	$idprod	Id product
int	$idprodfournprice	Id supplier price for product

Returns: float 0 or 1

See also: get_default_tva(), get_default_localtax()

Definition at line 7010 of file functions.lib.php.

Referenced by Commande\add_product(), Propal\add_product(), SupplierProposal\add_product(), Product\getSellPrice(), and Form\load_tva().

◆ get_default_tva()

get_default_tva	(	Societe	$thirdparty_seller,
		Societe	$thirdparty_buyer,
			$idprod = 0,
			$idprodfournprice = 0 )

Function that return vat rate of a product line (according to seller, buyer and product vat rate) VATRULE 1: If seller does not use VAT, default VAT is 0.

End of rule. VATRULE 2: If the (seller country = buyer country) then the default VAT = VAT of the product sold. End of rule. VATRULE 3: If (seller and buyer in the European Community) and (property sold = new means of transport such as car, boat, plane) then VAT by default = 0 (VAT must be paid by the buyer to the tax center of his country and not to the seller). End of rule. VATRULE 4: If (seller and buyer in the European Community) and (buyer = individual) then VAT by default = VAT of the product sold. End of rule VATRULE 5: If (seller and buyer in European Community) and (buyer = company) then VAT by default=0. End of rule VATRULE 6: Otherwise the VAT proposed by default=0. End of rule.

Parameters

Societe	$thirdparty_seller	Objet societe vendeuse
Societe	$thirdparty_buyer	Objet societe acheteuse
int	$idprod	Id product
int	$idprodfournprice	Id product_fournisseur_price (for supplier order/invoice)

Returns: float|string Vat rate to use with format 5.0 or '5.0 (XXX)', -1 if we can't guess it

See also: get_default_npr(), get_default_localtax()

Definition at line 6896 of file functions.lib.php.

References dol_syslog(), get_product_vat_for_country(), getDolGlobalString(), Societe\isACompany(), isInEEC(), and isValidVATID().

Referenced by Commande\add_product(), Propal\add_product(), SupplierProposal\add_product(), Propal\createFromClone(), Product\getSellPrice(), Form\load_tva(), Adherent\subscriptionComplementaryActions(), and doc_generic_project_odt\write_file().

◆ get_exdir()

get_exdir	(	$num,
		$level,
		$alpha,
		$withoutslash,
		$object,
		$modulepart = '' )

Return a path to have a the directory according to object where files are stored.

New usage: $conf->module->multidir_output[$object->entity].'/'.get_exdir(0, 0, 0, 1, $object, '').'/' or: $conf->module->dir_output.'/'.get_exdir(0, 0, 0, 0, $object, '') if multidir_output not defined. Example out with new usage: $object is invoice -> 'INYYMM-ABCD' Example out with old usage: '015' with level 3->"0/1/5/", '015' with level 1->"5/", 'ABC-1' with level 3 ->"0/0/1/"

Parameters

string \| int	$num	Id of object (deprecated, $object will be used in future)
int	$level	Level of subdirs to return (1, 2 or 3 levels). (deprecated, global option will be used in future)
int	$alpha	0=Keep number only to forge path, 1=Use alpha part afer the - (By default, use 0). (deprecated, global option will be used in future)
int	$withoutslash	0=With slash at end (except if '/', we return ''), 1=without slash at end
Object	$object	Object to use to get ref to forge the path.
string	$modulepart	Type of object ('invoice_supplier, 'donation', 'invoice', ...'). Use '' for autodetect from $object.

Returns: string Dir to use ending. Example '' or '1/' or '1/2/'

Definition at line 7154 of file functions.lib.php.

References dol_sanitizeFileName(), and getDolGlobalInt().

Referenced by FileUpload\__construct(), pdf_standard\Add_PDF_card(), Categorie\add_photo(), FactureFournisseur\delete(), dol_banner_tab(), AccountancyExport\exportFEC(), AccountancyExport\exportFEC2(), AccountancyExport\exportQuadratus(), facturefourn_prepare_head(), CommonDocGenerator\get_substitutionarray_user(), getCategory(), FormFile\getDocumentsLink(), Documents\getDocumentsListByElement(), getProductOrService(), getProductsForCategory(), CommonDocGenerator\getSubstitutionarrayMember(), FormFile\list_of_documents(), member_prepare_head(), migrate_product_photospath(), migrate_user_filespath(), migrate_user_photospath(), Documents\post(), product_prepare_head(), Notify\send(), CommonObject\show_photos(), Form\showphoto(), FactureFournisseur\validate(), BordereauChequeBlochet\write_file(), doc_generic_supplier_invoice_odt\write_file(), pdf_aurore\write_file(), pdf_azur\write_file(), pdf_canelle\write_file(), pdf_cornas\write_file(), pdf_crabe\write_file(), pdf_cyan\write_file(), pdf_eagle\write_file(), pdf_eagle_proforma\write_file(), pdf_eratosthene\write_file(), pdf_espadon\write_file(), pdf_muscadet\write_file(), pdf_rouget\write_file(), pdf_sponge\write_file(), pdf_squille\write_file(), pdf_standard\write_file(), pdf_standard\write_file(), pdf_storm\write_file(), and pdf_zenith\write_file().

◆ get_htmloutput_errors()

get_htmloutput_errors	(	$mesgstring = '',
		$mesgarray = array(),
		$keepembedded = 0 )

Get formated error messages to output (Used to show messages on html output).

Parameters

string	$mesgstring	Error message
array	$mesgarray	Error messages array
int	$keepembedded	Set to 1 in error message must be kept embedded into its html place (this disable jnotify)

Returns: string Return html output

See also: dol_print_error(); dol_htmloutput_mesg()

Definition at line 9273 of file functions.lib.php.

References get_htmloutput_mesg().

Referenced by ActionsCardCommon\assign_values(), ActionsCardProduct\assign_values(), and ActionsCardService\assign_values().

◆ get_htmloutput_mesg()

get_htmloutput_mesg	(	$mesgstring = '',
		$mesgarray = '',
		$style = 'ok',
		$keepembedded = 0 )

Get formated messages to output (Used to show messages on html output).

This include also the translation of the message key.

Parameters

string	$mesgstring	Message string or message key
string[]	$mesgarray	Array of message strings or message keys
string	$style	Style of message output ('ok' or 'error')
int	$keepembedded	Set to 1 in error message must be kept embedded into its html place (this disable jnotify)

Returns: string Return html output

See also: dol_print_error(); dol_htmloutput_errors(); setEventMessages()

Definition at line 9204 of file functions.lib.php.

References dol_escape_js(), and getDolGlobalString().

Referenced by ActionsCardCommon\assign_values(), dol_htmloutput_mesg(), and get_htmloutput_errors().

◆ get_localtax()

get_localtax	(	$vatrate,
		$local,
		$thirdparty_buyer = "",
		$thirdparty_seller = "",
		$vatnpr = 0 )

Return localtax rate for a particular vat, when selling a product with vat $vatrate, from a $thirdparty_buyer to a $thirdparty_seller Note: This function applies same rules than get_default_tva.

Parameters

float	$vatrate	Vat rate. Can be '8.5' or '8.5 (VATCODEX)' for example
int	$local	Local tax to search and return (1 or 2 return only tax rate 1 or tax rate 2)
Societe	$thirdparty_buyer	Object of buying third party
Societe	$thirdparty_seller	Object of selling third party ($mysoc if not defined)
int	$vatnpr	If vat rate is NPR or not

Returns: mixed 0 if not found, localtax rate if found

See also: get_default_tva()

Definition at line 6404 of file functions.lib.php.

References dol_syslog(), getDolGlobalString(), and isOnlyOneLocalTax().

Referenced by Commande\add_product(), Propal\add_product(), SupplierProposal\add_product(), Expedition\fetch_lines(), getLocalTaxesFromRate(), ProductFournisseur\update_buyprice(), and Product\updatePrice().

◆ get_localtax_by_third()

get_localtax_by_third ( $local )

Get values of localtaxes (1 or 2) for company country for the common vat with the highest value.

Parameters

int $local LocalTax to get

Returns: string Values of localtax (Can be '20', '-19:-15:-9') or 'Error'

Definition at line 6557 of file functions.lib.php.

References getEntity().

Referenced by isOnlyOneLocalTax(), and FormCompany\select_localtax().

◆ get_product_localtax_for_country()

get_product_localtax_for_country	(	$idprod,
		$local,
		$thirdpartytouse )

Return localtax vat rate of a product in a particular country or default country vat if product is unknown.

Parameters

int	$idprod	Id of product
int	$local	1 for localtax1, 2 for localtax 2
Societe	$thirdpartytouse	Thirdparty with a ->country_code defined (FR, US, IT, ...)

Returns: int Return integer <0 if KO, Vat rate if OK

See also: get_product_vat_for_country()

Definition at line 6824 of file functions.lib.php.

References dol_print_error(), and dol_syslog().

Referenced by get_default_localtax().

◆ get_product_vat_for_country()

get_product_vat_for_country	(	$idprod,
		$thirdpartytouse,
		$idprodfournprice = 0 )

Return vat rate of a product in a particular country, or default country vat if product is unknown.

Function called by get_default_tva().

Parameters

int	$idprod	Id of product or 0 if not a predefined product
Societe	$thirdpartytouse	Thirdparty with a ->country_code defined (FR, US, IT, ...)
int	$idprodfournprice	Id product_fournisseur_price (for "supplier" proposal/order/invoice)

Returns: float|string Vat rate to use with format 5.0 or '5.0 (XXX)'

See also: get_product_localtax_for_country()

Definition at line 6732 of file functions.lib.php.

References dol_print_error(), dol_syslog(), and getDolGlobalString().

Referenced by get_default_tva().

◆ getActionCommEcmList()

getActionCommEcmList ( $object )

getActionCommEcmList

Parameters

ActionComm $object Object ActionComm

Returns: array Array of documents in index table

Definition at line 12809 of file functions.lib.php.

Referenced by show_actions_messaging().

◆ getAdvancedPreviewUrl()

getAdvancedPreviewUrl	(	$modulepart,
		$relativepath,
		$alldata = 0,
		$param = '' )

Return URL we can use for advanced preview links.

Parameters

string	$modulepart	propal, facture, facture_fourn, ...
string	$relativepath	Relative path of docs.
int	$alldata	Return array with all components (1 is recommended, then use a simple a href link with the class, target and mime attribute added. 'documentpreview' css class is handled by jquery code into main.inc.php)
string	$param	More param on http links

Returns: string|array Output string with href link or array with all components of link

Definition at line 10851 of file functions.lib.php.

Referenced by FormFile\getDocumentsLink(), FormFile\list_of_documents(), CommonObject\show_photos(), Form\showphoto(), FormFile\showPreview(), and showWebsiteTemplates().

◆ getArrayOfSocialNetworks()

getArrayOfSocialNetworks ( )

Get array of social network dictionary.

Returns: array Array of Social Networks Dictionary

Definition at line 3411 of file functions.lib.php.

References dol_getcache(), and dol_setcache().

Referenced by Adherent\_load_ldap_info(), User\_load_ldap_info(), show_contacts(), and User\update_ldap2dolibarr().

◆ getBrowserInfo()

getBrowserInfo ( $user_agent )

Return information about user browser.

Parameters

string $user_agent Content of $_SERVER["HTTP_USER_AGENT"] variable

Returns: array Check function documentation

Definition at line 391 of file functions.lib.php.

◆ getCommonSubstitutionArray()

getCommonSubstitutionArray	(	$outputlangs,
		$onlykey = 0,
		$exclude = null,
		$object = null,
		$include = null )

Return array of possible common substitutions.

This includes several families like: 'system', 'mycompany', 'object', 'objectamount', 'date', 'user'

Parameters

Translate	$outputlangs	Output language
int	$onlykey	1=Do not calculate some heavy values of keys (performance enhancement when we need only the keys), 2=Values are trunc and html sanitized (to use for help tooltip)
array	$exclude	Array of family keys we want to exclude. For example array('system', 'mycompany', 'object', 'objectamount', 'date', 'user', ...)
Object	$object	Object for keys on object
array	$include	Array of family keys we want to include. For example array('system', 'mycompany', 'object', 'objectamount', 'date', 'user', ...)

Returns: array Array of substitutions

See also: setSubstitFromObject()

Definition at line 8133 of file functions.lib.php.

References dol_convertToWord(), dol_get_next_day(), dol_get_next_month(), dol_get_prev_day(), dol_get_prev_month(), dol_getdate(), dol_htmlentitiesbr(), dol_now(), dol_print_date(), dol_print_phone(), dol_string_nohtmltag(), dol_trunc(), dolGetFirstLastname(), getDolGlobalString(), getUserRemoteIP(), price(), and price2num().

◆ getDictionaryValue()

getDictionaryValue	(	$tablename,
		$field,
		$id,
		$checkentity = false,
		$rowidfield = 'rowid' )

Return the value of a filed into a dictionary for the record $id.

This also set all the values into a cache for a next search.

Parameters

string	$tablename	Name of table dictionary (without the MAIN_DB_PREFIX, example: 'c_holiday_types')
string	$field	The name of field where to find the value to return
int	$id	Id of line record
bool	$checkentity	Add filter on entity
string	$rowidfield	Name of the column rowid (to use for the filter on $id)

Returns: string The value of field $field. This also set $dictvalues cache.

Definition at line 11270 of file functions.lib.php.

Referenced by Holiday\approve(), Facture\createDepositFromOrigin(), CommonObject\setPaymentTerms(), Holiday\update(), and Holiday\validate().

◆ getDolGlobalInt()

getDolGlobalInt	(		$key,
			$default = 0 )

Return a Dolibarr global constant int value.

The constants $conf->global->xxx are loaded by the script master.inc.php included at begin of any PHP page.

Parameters

string	$key	key to return value, return 0 if not set
int	$default	value to return

Returns: int

Definition at line 165 of file functions.lib.php.

◆ getDolGlobalString()

getDolGlobalString	(		$key,
			$default = '' )

Return dolibarr global constant string value.

Parameters

string	$key	key to return value, return '' if not set
string	$default	value to return

Returns: string

Definition at line 151 of file functions.lib.php.

◆ getDoliDBInstance()

getDoliDBInstance	(	$type,
		$host,
		$user,
		$pass,
		$name,
		$port )

Return a DoliDB instance (database handler).

Parameters

string	$type	Type of database (mysql, pgsql...)
string	$host	Address of database server
string	$user	Authorized username
string	$pass	Password
string	$name	Name of database
int	$port	Port of database server

Returns: DoliDB A DoliDB instance

Definition at line 248 of file functions.lib.php.

Referenced by MailmanSpip\connectSpip(), and dolSessionOpen().

◆ getDolUserInt()

getDolUserInt	(	$key,
		$default = 0,
		$tmpuser = null )

Return Dolibarr user constant int value.

Parameters

string	$key	key to return value, return 0 if not set
int	$default	value to return
User	$tmpuser	To get another user than current user

Returns: int

Definition at line 197 of file functions.lib.php.

Referenced by vCard\buildVCardString(), and dol_check_secure_access_document().

◆ getDolUserString()

getDolUserString	(	$key,
		$default = '',
		$tmpuser = null )

Return Dolibarr user constant string value.

Parameters

string	$key	key to return value, return '' if not set
string	$default	value to return
User	$tmpuser	To get another user than current user

Returns: string

Definition at line 179 of file functions.lib.php.

◆ getElementProperties()

getElementProperties ( $element_type )

Get an array with properties of an element.

Parameters

string $element_type Element type (Value of $object->element). Example: 'action', 'facture', 'project', 'project_task' or 'myobject@mymodule' or 'myobject_mysubobject' (where mymodule = myobject, like 'project_task')

Returns: array array('module'=>, 'classpath'=>, 'element'=>, 'subelement'=>, 'classfile'=>, 'classname'=>, 'dir_output'=>)

See also: fetchObjectByElement()

Definition at line 11898 of file functions.lib.php.

Referenced by FileUpload\__construct(), fetchObjectByElement(), and Validate\isFetchableElement().

◆ getEntity()

getEntity	(	$element,
		$shared = 1,
		$currentobject = null )

Get list of entity id to use.

Parameters

string	$element	Current element 'societe', 'socpeople', 'actioncomm', 'agenda', 'resource', 'product', 'productprice', 'stock', 'bom', 'mo', 'propal', 'supplier_proposal', 'invoice', 'supplier_invoice', 'payment_various', 'categorie', 'bank_account', 'bank_account', 'adherent', 'user', 'commande', 'supplier_order', 'expedition', 'intervention', 'survey', 'contract', 'tax', 'expensereport', 'holiday', 'multicurrency', 'project', 'email_template', 'event', 'donation' 'c_paiement', 'c_payment_term', ...
int	$shared	0=Return id of current entity only, 1=Return id of current entity + shared entities (default)
object	$currentobject	Current object if needed

Returns: mixed Entity id(s) to use ( eg. entity IN ('.getEntity(elementname).')' )

Definition at line 274 of file functions.lib.php.

Referenced by CommandeStats\__construct(), FichinterStats\__construct(), modCommande\__construct(), modFacture\__construct(), modProduct\__construct(), modProjet\__construct(), modPropale\__construct(), modSociete\__construct(), modTicket\__construct(), PropaleStats\__construct(), ProductAttribute\attributeOrder(), Form\constructProductListOption(), ProductAttribute\countChildProducts(), AdherentStats\countMembersByTagAndStatus(), AdherentStats\countMembersByTypeAndStatus(), ProductCombination\countNbOfCombinationForFkProductParent(), Cpaiement\create(), PaymentTerm\create(), Products\deleteAttributeValueByRef(), Categorie\fetch(), PaymentTerm\fetch(), ProductAttribute\fetch(), ProductAttributeValue\fetch(), ProductCombination\fetch(), Propal\fetch(), Societe\fetch(), ProductAttribute\fetch_lines(), Position\fetchAll(), ProductAttribute\fetchAll(), ProductCombination\fetchAllByFkProductParent(), ProductCombination\fetchByFkProductChild(), Project\get_element_list(), get_localtax_by_third(), CommonInvoice\getArrayOfInvoiceSubtypes(), AccountingJournal\getAssetData(), Products\getAttributesByRef(), Products\getAttributesByRefExt(), Products\getAttributeValueById(), Products\getAttributeValueByRef(), BookKeeping\getCountByMonthForFiscalPeriod(), Project\getElementCount(), Translate\getLabelFromKey(), Lettering\getLinkedLines(), ProductAttribute\getMaxAttributesPosition(), mod_commande_saphir\getNextValue(), mod_facture_mercure\getNextValue(), mod_project_universal\getNextValue(), mod_propale_saphir\getNextValue(), mod_takepos_ref_universal\getNextValue(), mod_ticket_universal\getNextValue(), Contact\getNoEmail(), Societe\getNoEmail(), ProductAttribute\getPositionOfAttribute(), mailing_fraise\getSqlArrayForStats(), CdavLib\getSqlCalEvents(), Societe\id_prof_exists(), SupplierInvoices\index(), Product\isVariant(), Commande\load_board(), Propal\load_board(), SupplierProposal\load_board(), Ticket\load_board(), Form\load_cache_conditions_paiements(), Form\load_cache_transport_mode(), Form\load_cache_types_paiements(), CommonObject\load_previous_next_ref(), Commande\load_state_board(), CommandeFournisseur\load_state_board(), Contact\load_state_board(), Facture\load_state_board(), Fichinter\load_state_board(), Propal\load_state_board(), SupplierProposal\load_state_board(), Ticket\load_state_board(), box_members_subscriptions_by_year\loadBox(), FormProduct\loadLotStock(), AdvanceTargetingMailing\query_contact(), Form\select_bom(), Form\select_comptes(), Form\select_dolusers(), FormProjets\select_element(), Form\select_product_fourn_price(), Form\select_produits_fournisseurs_list(), Form\select_produits_list(), FormProjets\select_projects_list(), Form\select_thirdparty_list(), FormCompany\selectCompaniesForNewContact(), Form\selectcontacts(), Form\selectExpenseCategories(), FormProjets\selectInvoiceAndLine(), Form\selectInvoiceRec(), Form\selectMultiCurrency(), Form\selectSituationInvoices(), FormProjets\selectTasks(), Contact\setNoEmail(), Societe\setNoEmail(), Form\showLinkToObjectBlock(), ProductAttribute\updateAttributePositionDown(), ProductAttribute\updateAttributePositionUp(), and Contact\updateRoles().

◆ getFieldErrorIcon()

getFieldErrorIcon ( $fieldValidationErrorMsg )

get field error icon

Parameters

string $fieldValidationErrorMsg message to add in tooltip

Returns: string html output

Definition at line 11770 of file functions.lib.php.

◆ getImageFileNameForSize()

getImageFileNameForSize	(	$file,
		$extName,
		$extImgTarget = '' )

Return the filename of file to get the thumbs.

Parameters

string	$file	Original filename (full or relative path)
string	$extName	Extension to differenciate thumb file name ('', '_small', '_mini')
string	$extImgTarget	Force image extension for thumbs. Use '' to keep same extension than original image (default).

Returns: string New file name (full or relative path, including the thumbs/). May be the original path if no thumb can exists.

Definition at line 10800 of file functions.lib.php.

Referenced by CommonObject\delThumbs(), FormFile\list_of_documents(), CommonObject\show_photos(), Form\showphoto(), and vignette().

◆ getLanguageCodeFromCountryCode()

getLanguageCodeFromCountryCode ( $countrycode )

Return default language from country code.

Return null if not found.

Parameters

string $countrycode Country code like 'US', 'FR', 'CA', 'ES', 'IN', 'MX', ...

Returns: string Value of locale like 'en_US', 'fr_FR', ... or null if not found

Definition at line 9900 of file functions.lib.php.

References dol_syslog().

Referenced by FormAdmin\select_language(), and Adherent\sendReminderForExpiredSubscription().

◆ getLocalTaxesFromRate()

getLocalTaxesFromRate	(	$vatrate,
		$local,
		$buyer,
		$seller,
		$firstparamisid = 0 )

Get type and rate of localtaxes for a particular vat rate/country of a thirdparty.

This does not take into account the seller setup if subject to vat or not, only country.

TODO This function is ALSO called to retrieve type for building PDF. Such call of function must be removed. Instead this function must be called when adding a line to get the array of possible values for localtax and type, and then provide the selected value to the function calcul_price_total.

Parameters

int \| string	$vatrate	VAT ID or Rate+Code. Value can be value or the string with code into parenthesis or rowid if $firstparamisid is 1. Example: '8.5' or '8.5 (8.5NPR)' or 123.
int	$local	Number of localtax (1 or 2, or 0 to return 1 & 2)
Societe	$buyer	Company object
Societe	$seller	Company object
int	$firstparamisid	1 if first param is ID into table instead of Rate+code (use this if you can)

Returns: array array(localtax_type1(1-6 or 0 if not found), rate localtax1, localtax_type2, rate localtax2, accountancycodecust, accountancycodesupp)

See also: getTaxesFromId()

Definition at line 6668 of file functions.lib.php.

References dol_syslog(), and get_localtax().

Referenced by Commande\addline(), CommandeFournisseur\addline(), Contrat\addline(), ExpenseReport\addline(), Facture\addline(), FactureFournisseur\addline(), FactureFournisseurRec\addline(), FactureRec\addline(), Propal\addline(), SupplierProposal\addline(), ContratLigne\update(), Commande\updateline(), CommandeFournisseur\updateline(), Contrat\updateline(), ExpenseReport\updateline(), Facture\updateline(), FactureFournisseur\updateline(), FactureFournisseurRec\updateline(), FactureRec\updateline(), Propal\updateline(), SupplierProposal\updateline(), pdf_aurore\write_file(), pdf_azur\write_file(), pdf_cornas\write_file(), pdf_crabe\write_file(), pdf_cyan\write_file(), pdf_eagle_proforma\write_file(), pdf_einstein\write_file(), pdf_eratosthene\write_file(), pdf_muscadet\write_file(), pdf_sponge\write_file(), pdf_standard_asset\write_file(), pdf_standard_myobject\write_file(), and pdf_zenith\write_file().

◆ getMultidirOutput()

if(!function_exists('utf8_encode')) if(!function_exists( 'utf8_decode')) if(!function_exists('str_starts_with')) if(!function_exists( 'str_ends_with')) if(!function_exists('str_contains')) getMultidirOutput	(		$object,
			$module = '' )

Return the full path of the directory where a module (or an object of a module) stores its files.

Path may depends on the entity if a multicompany module is enabled.

Parameters

CommonObject	$object	Dolibarr common object
string	$module	Override object element, for example to use 'mycompany' instead of 'societe'

Returns: string|void The path of the relative directory of the module

Since: Dolibarr V18

Definition at line 123 of file functions.lib.php.

Referenced by pdf_eratosthene\_pagehead(), pdf_standard_myobject\_pagehead(), pdf_eratosthene\write_file(), and pdf_standard_myobject\write_file().

◆ getNonce()

getNonce ( )

Return a random string to be used as a nonce value for js.

Returns: string

Definition at line 12313 of file functions.lib.php.

References dolGetRandomBytes().

Referenced by Form\buttonsSaveCancel(), Form\formconfirm(), Form\getSelectConditionsPaiements(), Form\multiselectarray(), Form\select_dolresources_forevent(), Form\select_dolusers_forevent(), Form\select_produits(), FormCompany\selectCompaniesForNewContact(), Form\selectExpenseCategories(), Form\selectMassAction(), FormBarCode\setBarcodeEncoder(), Form\showCheckAddButtons(), Form\showLinkToObjectBlock(), and Form\widgetForTranslation().

◆ getPictoForType()

getPictoForType ( $key )

Return the picto for a data type.

Parameters

string $key Key

Returns: string Pïcto for the key

Definition at line 4326 of file functions.lib.php.

References img_picto().

Referenced by FormAdmin\selectTypeOfFields().

◆ GETPOST()

GETPOST	(	$paramname,
		$check = 'alphanohtml',
		$method = 0,
		$filter = null,
		$options = null,
		$noreplace = 0 )

Return value of a param into GET or POST supervariable.

Use the property $user->default_values[path]['createform'] and/or $user->default_values[path]['filters'] and/or $user->default_values[path]['sortorder'] Note: The property $user->default_values is loaded by main.php when loading the user.

Parameters

string	$paramname	Name of parameter to found
string	$check	Type of check ''=no check (deprecated) 'none'=no check (only for param that should have very rich content like passwords) 'array', 'array:restricthtml' or 'array:aZ09' to check it's an array 'int'=check it's numeric (integer or float) 'intcomma'=check it's integer+comma ('1,2,3,4...') 'alpha'=Same than alphanohtml since v13 'alphawithlgt'=alpha with lgt 'alphanohtml'=check there is no html content and no " and no ../ 'aZ'=check it's a-z only 'aZ09'=check it's simple alpha string (recommended for keys) 'aZ09arobase'=check it's a string for an element type 'aZ09comma'=check it's a string for a sortfield or sortorder 'san_alpha'=Use filter_var with FILTER_SANITIZE_STRING (do not use this for free text string) 'nohtml'=check there is no html content 'restricthtml'=check html content is restricted to some tags only 'custom'= custom filter specify $filter and $options)
int	$method	Type of method (0 = get then post, 1 = only get, 2 = only post, 3 = post then get)
int	$filter	Filter to apply when $check is set to 'custom'. (See http://php.net/manual/en/filter.filters.php for détails)
mixed	$options	Options to pass to filter_var when $check is set to 'custom'
string	$noreplace	Force disable of replacement of xxx strings.

Returns: string|array Value found (string or array), or '' if check fails

Definition at line 621 of file functions.lib.php.

References dol_get_next_day(), dol_get_next_month(), dol_get_prev_day(), dol_get_prev_month(), dol_getdate(), dol_now(), dol_string_nohtmltag(), dol_string_nospecial(), dol_syslog(), getDolGlobalString(), and sanitizeVal().

Referenced by ImportCsv\__construct(), mailing_contacts1\add_to_target(), mailing_eventorganization\add_to_target(), mailing_fraise\add_to_target(), mailing_mailinglist_mymodule_myobject\add_to_target(), mailing_partnership\add_to_target(), mailing_pomme\add_to_target(), mailing_thirdparties\add_to_target(), mailing_thirdparties_services_expired\add_to_target(), mailing_xinputuser\add_to_target(), ActionsAdherentCardCommon\assign_post(), ActionsCardCommon\assign_post(), ActionsContactCardCommon\assign_post(), ActionsCardIndividual\assign_values(), check_user_password_googleoauth(), check_user_password_openid(), check_user_password_openid_connect(), Propal\classifyBilled(), Propal\closeProposal(), RecruitmentJobPosition\cloture(), SupplierProposal\cloture(), Facture\create(), FactureFournisseur\create(), StockTransfer\create(), Workstation\create(), FileUpload\delete(), Mo\deleteLine(), displayPositionCard(), Asset\dispose(), ActionsDatapolicy\doActions(), PartnershipUtils\doCancelStatusOfMemberPartnership(), dol_add_file_process(), dol_check_secure_access_document(), PartnershipUtils\doWarningOfPartnershipIfDolibarrBacklinkNotfound(), Utils\dumpDatabase(), Form\editfieldkey(), Form\editfieldval(), fieldList(), fieldListAccountingCategories(), mailing_contacts1\formFilter(), mailing_partnership\formFilter(), mailing_thirdparties\formFilter(), ActionsStripeconnect\formObjectOptions(), FormSetupItem\generateInputFieldSecureKey(), FormMail\get_form(), get_left_menu_hrm(), get_left_menu_projects(), Setup\getCheckIntegrity(), CommonObject\getDefaultCreateValueFor(), ExtraFields\getOptionalsFromPost(), GETPOSTINT(), hash_call(), FormFile\list_of_documents(), box_graph_invoices_permonth\loadBox(), box_graph_invoices_peryear\loadBox(), box_graph_invoices_supplier_permonth\loadBox(), box_graph_nb_ticket_last_x_days\loadBox(), box_graph_orders_permonth\loadBox(), box_graph_orders_supplier_permonth\loadBox(), box_graph_product_distribution\loadBox(), box_graph_propales_permonth\loadBox(), box_task\loadBox(), MenuManager\loadMenu(), main_area(), CommonInvoice\makeStripeSepaRequest(), Ticket\newMessage(), EmailCollector\overwritePropertiesOfObject(), print_auguria_menu(), ActionsDatapolicy\printCommonFooter(), printCommonFooter(), printingAdminPrepareHead(), CommonObject\printObjectLine(), Asset\reopen(), restrictedArea(), InterfaceStripe\runTrigger(), InterfaceTicketEmail\runTrigger(), FormTicket\selectGroupTickets(), Stripe\sepaStripe(), AssetAccountancyCodes\setAccountancyCodesFromPost(), AssetDepreciationOptions\setDeprecationOptionsFromPost(), ExtraFields\setOptionalsFromPost(), FormSetupItem\setValueFromPost(), CommonObject\setValuesForExtraLanguages(), show_actions_done(), show_contacts(), FormSms\show_form(), show_list_sending_receive(), FormTicket\showForm(), Form\showLinkToObjectBlock(), FormTicket\showMessageForm(), CommonObject\showOptionals(), ExtraFields\showSeparator(), showSocialNetwork(), societe_prepare_head(), Adherent\subscriptionComplementaryActions(), top_htmlhead(), top_menu(), Workstation\update(), ActionsTicket\viewTicketMessages(), ActionsTicket\viewTicketOriginalMessage(), ActionsTicket\viewTicketTimelineMessages(), Form\widgetForTranslation(), pdf_einstein\write_file(), and pdf_standard\write_file().

◆ GETPOSTDATE()

GETPOSTDATE	(	$prefix,
		$hourTime = '',
		$gm = 'auto' )

Helper function that combines values of a dolibarr DatePicker (such as Form\selectDate) for year, month, day (and optionally hour, minute, second) fields to return a timestamp.

Parameters

string	$prefix	Prefix used to build the date selector (for instance using Form\selectDate)
string	$hourTime	'getpost' to include hour, minute, second values from the HTTP request, 'XX:YY:ZZ' to set hour, minute, second respectively (for instance '23:59:59')
string	$gm	Passed to dol_mktime

Returns: int|string Date as a timestamp, '' or false if error

Definition at line 13573 of file functions.lib.php.

References dol_mktime(), and GETPOSTINT().

Referenced by buildParamDate().

◆ GETPOSTINT()

GETPOSTINT	(		$paramname,
			$method = 0 )

Return value of a param into GET or POST supervariable.

Use the property $user->default_values[path]['creatform'] and/or $user->default_values[path]['filters'] and/or $user->default_values[path]['sortorder'] Note: The property $user->default_values is loaded by main.php when loading the user.

Parameters

string	$paramname	Name of parameter to found
int	$method	Type of method (0 = get then post, 1 = only get, 2 = only post, 3 = post then get)

Returns: int Value found (int)

Definition at line 938 of file functions.lib.php.

References GETPOST().

Referenced by mailing_partnership\add_to_target(), and GETPOSTDATE().

◆ GETPOSTISARRAY()

GETPOSTISARRAY	(		$paramname,
			$method = 0 )

Return true if the parameter $paramname is submit from a POST OR GET as an array.

Can be used before GETPOST to know if the $check param of GETPOST need to check an array or a string

Parameters

string	$paramname	Name or parameter to test
int	$method	Type of method (0 = get then post, 1 = only get, 2 = only post, 3 = post then get)

Returns: bool True if we have just submit a POST or GET request with the parameter provided (even if param is empty)

Definition at line 574 of file functions.lib.php.

Referenced by ExtraFields\getOptionalsFromPost().

◆ GETPOSTISSET()

GETPOSTISSET ( $paramname )

Return true if we are in a context of submitting the parameter $paramname from a POST of a form.

Warning: For action=add, use: $var = GETPOST('var'); // No GETPOSTISSET, so GETPOST always called and default value is retreived if not a form POST, and value of form is retreived if it is a form POST. For action=update, use: $var = GETPOSTISSET('var') ? GETPOST('var') : $object->var;

Parameters

string $paramname Name or parameter to test

Returns: boolean True if we have just submit a POST or GET request with the parameter provided (even if param is empty)

Definition at line 521 of file functions.lib.php.

◆ getTaxesFromId()

getTaxesFromId	(	$vatrate,
		$buyer = null,
		$seller = null,
		$firstparamisid = 1 )

Get tax (VAT) main information from Id.

You can also call getLocalTaxesFromRate() after to get only localtax fields.

Parameters

int \| string	$vatrate	VAT ID or Rate. Value can be value or the string with code into parenthesis or rowid if $firstparamisid is 1. Example: '8.5' or '8.5 (8.5NPR)' or 123.
Societe	$buyer	Company object
Societe	$seller	Company object
int	$firstparamisid	1 if first param is id into table (use this if you can)

Returns: array array('rowid'=> , 'code'=> ...)

See also: getLocalTaxesFromRate()

Definition at line 6594 of file functions.lib.php.

References dol_print_error(), and dol_syslog().

◆ getTimelineIcon()

getTimelineIcon	(		$actionstatic,
		&	$histo,
			$key )

Get timeline icon.

Parameters

ActionComm	$actionstatic	actioncomm
array	$histo	histo
int	$key	key

Returns: string String with timeline icon

Deprecated: Use actioncomm->getPictoType() instead

Definition at line 12745 of file functions.lib.php.

References getDolGlobalString(), and img_picto().

◆ getTitleFieldOfList()

getTitleFieldOfList	(	$name,
		$thead = 0,
		$file = "",
		$field = "",
		$begin = "",
		$moreparam = "",
		$moreattrib = "",
		$sortfield = "",
		$sortorder = "",
		$prefix = "",
		$disablesortlink = 0,
		$tooltip = '',
		$forcenowrapcolumntitle = 0 )

Get title line of an array.

Parameters

string	$name	Translation key of field to show or complete HTML string to show
int	$thead	0=To use with standard table format, 1=To use inside

, 2=To use with

Parameters

string	$file	Url used when we click on sort picto
string	$field	Field to use for new sorting. Empty if this field is not sortable. Example "t.abc" or "t.abc,t.def"
string	$begin	("" by defaut)
string	$moreparam	Add more parameters on sort url links ("" by default)
string	$moreattrib	Add more attributes on th ("" by defaut). To add more css class, use param $prefix.
string	$sortfield	Current field used to sort (Ex: 'd.datep,d.id')
string	$sortorder	Current sort order (Ex: 'asc,desc')
string	$prefix	Prefix for css. Use space after prefix to add your own CSS tag, for example 'mycss '.
string	$disablesortlink	1=Disable sort link
string	$tooltip	Tooltip
string	$forcenowrapcolumntitle	No need for use 'wrapcolumntitle' css style

Returns: string

Definition at line 5584 of file functions.lib.php.

References dol_escape_htmltag(), dol_textishtml(), and getDolGlobalString().

Referenced by print_liste_field_titre(), show_actions_done(), show_actions_messaging(), show_contacts(), and FormActions\showactions().

◆ getUserRemoteIP()

getUserRemoteIP ( )

Return the IP of remote user.

Take HTTP_X_FORWARDED_FOR (defined when using proxy) Then HTTP_CLIENT_IP if defined (rare) Then REMOTE_ADDR (no way to be modified by user but may be wrong if user is using a proxy)

Returns: string Ip of remote user.

Definition at line 3942 of file functions.lib.php.

Referenced by callSetExpressCheckout(), Stripe\cardStripe(), check_user_password_dolibarr(), Events\create(), Stripe\createPaymentStripe(), Stripe\customerStripe(), dol_syslog(), dol_user_country(), dolSessionWrite(), getCommonSubstitutionArray(), Stripe\getPaymentIntent(), Stripe\getSetupIntent(), User\getTooltipContentArray(), Documents\post(), Stripe\sepaStripe(), and User\update_last_login_date().

◆ img_action()

img_action	(	$titlealt,
		$numaction,
		$picto = '',
		$moreatt = '' )

Show logo action.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$numaction	Action id or code to show
string	$picto	Name of image file to show ('filenew', ...) If no extension provided, we use '.png'. Image must be stored into theme/xxx/img directory. Example: picto.png if picto.png is stored into htdocs/theme/mytheme/img Example: picto.png@mymodule if picto.png is stored into htdocs/mymodule/img Example: /mydir/mysubdir/picto.png if picto.png is stored into htdocs/mydir/mysubdir (pictoisfullpath must be set to 1)
string	$moreatt	More attributes

Returns: string Return an img tag

Definition at line 4824 of file functions.lib.php.

References img_picto().

Referenced by Societe\LibProspCommStatut(), Contact\libProspCommStatut(), and FormCompany\selectProspectStatus().

◆ img_allow()

img_allow	(		$allow,
			$titlealt = 'default' )

Show tick logo if allowed.

Parameters

string	$allow	Allow
string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.

Returns: string Return img tag

Definition at line 5199 of file functions.lib.php.

References img_picto().

◆ img_credit_card()

img_credit_card	(		$brand,
			$morecss = null )

Return image of a credit card according to its brand name.

Parameters

string	$brand	Brand name of credit card
string	$morecss	More CSS

Returns: string Return img tag

Definition at line 5221 of file functions.lib.php.

◆ img_delete()

img_delete	(	$titlealt = 'default',
		$other = 'class="pictodelete"',
		$morecss = '' )

Show delete logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img
string	$morecss	More CSS

Returns: string Retourne tag img

Definition at line 4957 of file functions.lib.php.

References img_picto().

Referenced by Export\list_export_model(), FormFile\list_of_documents(), FormFile\listOfLinks(), and CommonObject\show_photos().

◆ img_down()

img_down	(	$titlealt = 'default',
		$selected = 0,
		$moreclass = '' )

Show down arrow logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
int	$selected	Selected
string	$moreclass	Add more CSS classes

Returns: string Return img tag

Definition at line 5124 of file functions.lib.php.

References img_picto().

Referenced by form_constantes(), and FormFile\list_of_documents().

◆ img_edit()

img_edit	(	$titlealt = 'default',
		$float = 0,
		$other = '' )

Show logo editer/modifier fiche.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
integer	$float	If you have to put the style "float: right"
string	$other	Add more attributes on img

Returns: string Return tag img

Definition at line 4917 of file functions.lib.php.

References img_picto().

Referenced by ActionsCardCommon\assign_values(), Form\editfieldkey(), AdherentType\getKanbanView(), FormFile\list_of_documents(), FormFile\listOfLinks(), show_contacts(), show_subsidiaries(), and ActionsTicket\viewTicketOriginalMessage().

◆ img_edit_add()

img_edit_add	(		$titlealt = 'default',
			$other = '' )

Show logo +.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Return tag img

Definition at line 4881 of file functions.lib.php.

References img_picto().

◆ img_edit_remove()

img_edit_remove	(		$titlealt = 'default',
			$other = '' )

Show logo -.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Return tag img

Definition at line 4898 of file functions.lib.php.

References img_picto().

◆ img_error()

img_error ( $titlealt = 'default' )

Show error logo.

Parameters

string $titlealt Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.

Returns: string Return img tag

Definition at line 5067 of file functions.lib.php.

References img_picto().

◆ img_help()

img_help	(		$usehelpcursor = 1,
			$usealttitle = 1 )

Show help logo with cursor "?".

Parameters

int	$usehelpcursor	1=Use help cursor, 2=Use click pointer cursor, 0=No specific cursor
int \| string	$usealttitle	Text to use as alt title

Returns: string Return tag img

Definition at line 5009 of file functions.lib.php.

References dol_escape_htmltag(), and img_picto().

Referenced by Form\formconfirm(), and Form\textwithpicto().

◆ img_info()

img_info ( $titlealt = 'default' )

Show info logo.

Parameters

string $titlealt Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.

Returns: string Return img tag

Definition at line 5030 of file functions.lib.php.

References img_picto().

◆ img_left()

img_left	(	$titlealt = 'default',
		$selected = 0,
		$moreatt = '' )

Show left arrow logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
int	$selected	Selected
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"')

Returns: string Return img tag

Definition at line 5162 of file functions.lib.php.

References img_picto().

◆ img_mime()

img_mime	(	$file,
		$titlealt = '',
		$morecss = '' )

Show MIME img of a file.

Parameters

string	$file	Filename
string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$morecss	More css

Returns: string Return img tag

Definition at line 5254 of file functions.lib.php.

References dol_mimetype().

Referenced by FormMail\get_form(), FormFile\getDocumentsLink(), FormFile\list_of_autoecmfiles(), FormFile\list_of_documents(), show_actions_messaging(), FormFile\showdocuments(), FormTicket\showMessageForm(), FormFile\showPreview(), and ActionsTicket\viewTicketMessages().

◆ img_next()

img_next	(		$titlealt = 'default',
			$moreatt = '' )

Show next logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"')

Returns: string Return img tag

Definition at line 5085 of file functions.lib.php.

◆ img_object()

img_object	(	$titlealt,
		$picto,
		$moreatt = '',
		$pictoisfullpath = false,
		$srconly = 0,
		$notitle = 0 )

Show a picto called object_picto (generic function)

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$picto	Name of image to show object_picto (example: user, group, action, bill, contract, propal, product, ...) For external modules use imagename@mymodule to search into directory "img" of module.
string	$moreatt	Add more attribute on img tag (ie: class="datecallink")
int	$pictoisfullpath	If 1, image path is a full path
int	$srconly	Return only content of the src attribute of img.
int	$notitle	1=Disable tag title. Use it if you add js tooltip, to avoid duplicate tooltip.

Returns: string Return img tag

See also: img_picto(), img_picto_common()

Definition at line 4738 of file functions.lib.php.

References img_picto().

Referenced by Notify\confirmMessage(), dol_print_email(), dol_print_phone(), dol_print_socialnetworks(), DolibarrModules\getKanbanView(), User\getLoginUrl(), Account\getNomUrl(), AccountingAccount\getNomUrl(), AccountingJournal\getNomUrl(), ActionComm\getNomUrl(), Adherent\getNomUrl(), AdherentType\getNomUrl(), Asset\getNomUrl(), AssetModel\getNomUrl(), Availabilities\getNomUrl(), BOM\getNomUrl(), BOMLine\getNomUrl(), BonPrelevement\getNomUrl(), BookKeeping\getNomUrl(), Bookmark\getNomUrl(), Calendar\getNomUrl(), CashControl\getNomUrl(), Categorie\getNomUrl(), ChargeSociales\getNomUrl(), Commande\getNomUrl(), CommandeFournisseur\getNomUrl(), CompanyPaymentMode\getNomUrl(), ConferenceOrBooth\getNomUrl(), ConferenceOrBoothAttendee\getNomUrl(), Contact\getNomUrl(), Contrat\getNomUrl(), Cronjob\getNomUrl(), Dolresource\getNomUrl(), Don\getNomUrl(), EcmDirectory\getNomUrl(), EmailCollector\getNomUrl(), EmailCollectorAction\getNomUrl(), EmailCollectorFilter\getNomUrl(), Entrepot\getNomUrl(), Establishment\getNomUrl(), Evaluation\getNomUrl(), EvaluationLine\getNomUrl(), Expedition\getNomUrl(), ExpenseReport\getNomUrl(), Facture\getNomUrl(), FactureFournisseur\getNomUrl(), FactureFournisseurRec\getNomUrl(), FactureRec\getNomUrl(), Fichinter\getNomUrl(), Fiscalyear\getNomUrl(), Holiday\getNomUrl(), Hook\getNomUrl(), Inventory\getNomUrl(), Job\getNomUrl(), KnowledgeRecord\getNomUrl(), Loan\getNomUrl(), Mailing\getNomUrl(), Mo\getNomUrl(), MyObject\getNomUrl(), Opensurveysondage\getNomUrl(), Paiement\getNomUrl(), PaiementFourn\getNomUrl(), Partnership\getNomUrl(), PartnershipType\getNomUrl(), PaymentLoan\getNomUrl(), PaymentSalary\getNomUrl(), PaymentVarious\getNomUrl(), Position\getNomUrl(), Product\getNomUrl(), ProductAttribute\getNomUrl(), ProductFournisseur\getNomUrl(), ProductFournisseurPrice\getNomUrl(), Productlot\getNomUrl(), Project\getNomUrl(), Propal\getNomUrl(), Reception\getNomUrl(), RecruitmentCandidature\getNomUrl(), RecruitmentJobPosition\getNomUrl(), RemiseCheque\getNomUrl(), Salary\getNomUrl(), Skill\getNomUrl(), Skilldet\getNomUrl(), SkillRank\getNomUrl(), Societe\getNomUrl(), SocieteAccount\getNomUrl(), StockTransfer\getNomUrl(), StockTransferLine\getNomUrl(), Subscription\getNomUrl(), SupplierProposal\getNomUrl(), Target\getNomUrl(), Task\getNomUrl(), Ticket\getNomUrl(), TimeSpent\getNomUrl(), Tva\getNomUrl(), User\getNomUrl(), UserGroup\getNomUrl(), Workstation\getNomUrl(), Interfaces\getTriggersList(), ModeleBoxes\getWidgetsList(), Export\list_export_model(), Account\load_board(), ActionComm\load_board(), Adherent\load_board(), Commande\load_board(), CommandeFournisseur\load_board(), Contrat\load_board(), ExpenseReport\load_board(), Facture\load_board(), FactureFournisseur\load_board(), Holiday\load_board(), Project\load_board(), Propal\load_board(), RemiseCheque\load_board(), SupplierProposal\load_board(), Task\load_board(), Ticket\load_board(), box_dolibarr_state_board\loadBox(), box_services_contracts\loadBox(), Categorie\print_all_ways(), CommonObject\printOriginLine(), Form\select_produits_fournisseurs_list(), show_actions_done(), show_actions_messaging(), show_contacts(), show_list_sending_receive(), show_stats_for_batch(), show_stats_for_company(), box_actions\showBox(), box_actions_future\showBox(), ModeleBoxes\showBox(), ExtraFields\showOutputField(), mailing_contacts1\url(), mailing_eventorganization\url(), mailing_fraise\url(), mailing_mailinglist_mymodule_myobject\url(), mailing_partnership\url(), mailing_pomme\url(), mailing_thirdparties\url(), and mailing_thirdparties_services_expired\url().

◆ img_pdf()

img_pdf	(		$titlealt = 'default',
			$size = 3 )

Show pdf logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
int	$size	Taille de l'icone : 3 = 16x16px , 2 = 14x14px

Returns: string Retourne tag img

Definition at line 4863 of file functions.lib.php.

References img_picto().

◆ img_picto()

img_picto	(	$titlealt,
		$picto,
		$moreatt = '',
		$pictoisfullpath = false,
		$srconly = 0,
		$notitle = 0,
		$alt = '',
		$morecss = '',
		$marginleftonlyshort = 2 )

Show picto whatever it's its name (generic function)

Parameters

string	$titlealt	Text on title tag for tooltip. Not used if param notitle is set to 1.
string	$picto	Name of image file to show ('filenew', ...). For font awesome icon (example 'user'), you can use picto_nocolor to not have the color of picto forced. If no extension provided and it is not a font awesome icon, we use '.png'. Image must be stored into theme/xxx/img directory. Example: picto.png if picto.png is stored into htdocs/theme/mytheme/img Example: picto.png@mymodule if picto.png is stored into htdocs/mymodule/img Example: /mydir/mysubdir/picto.png if picto.png is stored into htdocs/mydir/mysubdir (pictoisfullpath must be set to 1) Example: fontawesome_envelope-open-text_fas_red_1em if you want to use fontaweseome icons: fontawesome_<icon-name>_<style>_<color>_<size> (only icon-name is mandatory)
string	$moreatt	Add more attribute on img tag (For example 'class="pictofixedwidth"')
boolean \| int	$pictoisfullpath	If true or 1, image path is a full path
int	$srconly	Return only content of the src attribute of img.
int	$notitle	1=Disable tag title. Use it if you add js tooltip, to avoid duplicate tooltip.
string	$alt	Force alt for bind people
string	$morecss	Add more class css on img tag (For example 'myclascss').
string	$marginleftonlyshort	1 = Add a short left margin on picto, 2 = Add a larger left margin on picto, 0 = No margin left. Works for fontawesome picto only.

Returns: string Return img tag

See also: img_object(), img_picto_common()

Definition at line 4383 of file functions.lib.php.

References getDolGlobalString().

◆ img_picto_common()

img_picto_common	(	$titlealt,
		$picto,
		$moreatt = '',
		$pictoisfullpath = 0,
		$notitle = 0 )

Show picto (generic function)

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$picto	Name of image file to show (If no extension provided, we use '.png'). Image must be stored into htdocs/theme/common directory.
string	$moreatt	Add more attribute on img tag
int	$pictoisfullpath	If 1, image path is a full path
int	$notitle	1=Disable tag title. Use it if you add js tooltip, to avoid duplicate tooltip.

Returns: string Return img tag

See also: img_object(), img_picto()

Definition at line 4786 of file functions.lib.php.

References getDolGlobalInt(), and img_picto().

Referenced by tree_showpad().

◆ img_previous()

img_previous	(		$titlealt = 'default',
			$moreatt = '' )

Show previous logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"')

Returns: string Return img tag

Definition at line 5104 of file functions.lib.php.

◆ img_printer()

img_printer	(		$titlealt = "default",
			$other = '' )

Show printer logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Retourne tag img

Definition at line 4975 of file functions.lib.php.

References img_picto().

◆ img_right()

img_right	(	$titlealt = 'default',
		$selected = 0,
		$moreatt = '' )

Show right arrow logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
int	$selected	Selected
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"')

Returns: string Return img tag

Definition at line 5181 of file functions.lib.php.

References img_picto().

◆ img_search()

img_search	(		$titlealt = 'default',
			$other = '' )

Show search logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Retourne tag img

Definition at line 5278 of file functions.lib.php.

References dol_escape_htmltag(), and img_picto().

◆ img_searchclear()

img_searchclear	(		$titlealt = 'default',
			$other = '' )

Show search logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Retourne tag img

Definition at line 5301 of file functions.lib.php.

References dol_escape_htmltag(), and img_picto().

◆ img_split()

img_split	(		$titlealt = 'default',
			$other = 'class="pictosplit"' )

Show split logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$other	Add more attributes on img

Returns: string Retourne tag img

Definition at line 4991 of file functions.lib.php.

References img_picto().

◆ img_up()

img_up	(	$titlealt = 'default',
		$selected = 0,
		$moreclass = '' )

Show top arrow logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
int	$selected	Selected
string	$moreclass	Add more CSS classes

Returns: string Return img tag

Definition at line 5143 of file functions.lib.php.

References img_picto().

Referenced by FormFile\list_of_documents().

◆ img_view()

img_view	(	$titlealt = 'default',
		$float = 0,
		$other = 'class="valignmiddle"' )

Show logo view card.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
integer	$float	If you have to put the style "float: right"
string	$other	Add more attributes on img

Returns: string Return tag img

Definition at line 4936 of file functions.lib.php.

References img_picto().

◆ img_warning()

img_warning	(	$titlealt = 'default',
		$moreatt = '',
		$morecss = 'pictowarning' )

Show warning logo.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"'). If 1, add float: right. Can't be "class" attribute.
string	$morecss	Add more CSS

Returns: string Return img tag

Definition at line 5049 of file functions.lib.php.

References img_picto().

◆ img_weather()

img_weather	(	$titlealt,
		$picto,
		$moreatt = '',
		$pictoisfullpath = 0,
		$morecss = '' )

Show weather picto.

Parameters

string	$titlealt	Text on alt and title of image. Alt only if param notitle is set to 1. If text is "TextA:TextB", use Text A on alt and Text B on title.
string \| int	$picto	Name of image file to show (If no extension provided, we use '.png'). Image must be stored into htdocs/theme/common directory. Or level of meteo image (0-4).
string	$moreatt	Add more attribute on img tag
int	$pictoisfullpath	If 1, image path is a full path
string	$morecss	More CSS

Returns: string Return img tag

See also: img_object(), img_picto()

Definition at line 4758 of file functions.lib.php.

References img_picto().

Referenced by showWeather().

◆ info_admin()

info_admin	(	$text,
		$infoonimgalt = 0,
		$nodiv = 0,
		$admin = '1',
		$morecss = 'hideonsmartphone',
		$textfordropdown = '' )

Show information for admin users or standard users.

Parameters

string	$text	Text info
integer	$infoonimgalt	Info is shown only on alt of star picto, otherwise it is show on output after the star picto
int	$nodiv	No div
string	$admin	'1'=Info for admin users. '0'=Info for standard users (change only the look), 'error', 'warning', 'xxx'=Other
string	$morecss	More CSS ('', 'warning', 'error')
string	$textfordropdown	Show a text to click to dropdown the info box.

Returns: string String with info text

Definition at line 5328 of file functions.lib.php.

References dol_escape_htmltag(), and img_picto().

Referenced by ActionsAdherentCardCommon\assign_values(), ActionsCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), FormFile\form_attach_new_file(), FormCompany\form_prospect_level(), FormCompany\formProspectContactLevel(), FormMail\get_form(), Form\getSelectConditionsPaiements(), Form\getSelectInvoiceSubtype(), main_area(), FormCompany\select_civility(), FormCompany\select_juridicalstatus(), FormCompany\select_state(), FormActions\select_type_actions(), Form\select_type_fees(), FormSocialContrib\select_type_socialcontrib(), Form\select_types_paiements(), FormResource\select_types_resource(), Form\selectAvailabilityDelay(), Form\selectCurrency(), Form\selectExpenseCategories(), FormTicket\selectGroupTickets(), Form\selectInputReason(), FormProjets\selectOpportunityStatus(), FormTicket\selectSeveritiesTickets(), Form\selectShippingMethod(), Form\selectTransportMode(), FormCompany\selectTypeContact(), FormWebsite\selectTypeOfContainer(), FormTicket\selectTypesTickets(), show_actions_messaging(), and FormTicket\showMessageForm().

◆ isAFileWithExecutableContent()

isAFileWithExecutableContent ( $filename )

Return if a file can contains executable content.

Parameters

string $filename File name to test

Returns: boolean True if yes, False if no

Definition at line 12275 of file functions.lib.php.

Referenced by dol_move_uploaded_file(), and Documents\post().

◆ isASecretKey()

isASecretKey ( $keyname )

Return if string has a name dedicated to store a secret.

Parameters

string $keyname Name of key to test

Returns: boolean True if key is used to store a secret

Definition at line 354 of file functions.lib.php.

Referenced by CommonDocGenerator\get_substitutionarray_other(), Setup\getConf(), and make_substitutions().

◆ isHTTPS()

isHTTPS ( )

Return if we are using a HTTPS connexion Check HTTPS (no way to be modified by user but may be empty or wrong if user is using a proxy) Take HTTP_X_FORWARDED_PROTO (defined when using proxy) Then HTTP_X_FORWARDED_SSL.

Returns: boolean True if user is using HTTPS

Definition at line 3968 of file functions.lib.php.

◆ isModEnabled()

isModEnabled ( $module )

Is Dolibarr module enabled.

Parameters

string $module Module name to check

Returns: boolean True if module is enabled

Definition at line 213 of file functions.lib.php.

References getDolGlobalString().

◆ isOnlyOneLocalTax()

isOnlyOneLocalTax ( $local )

Return true if LocalTax (1 or 2) is unique.

Example: If localtax1 is 5 on line with highest common vat rate, return true Example: If localtax1 is 5:8:15 on line with highest common vat rate, return false

Parameters

int $local Local tax to test (1 or 2)

Returns: boolean True if LocalTax have multiple values, False if not

Definition at line 6538 of file functions.lib.php.

References get_localtax_by_third().

Referenced by get_localtax().

◆ isStringVarMatching()

isStringVarMatching	(	$var,
		$regextext,
		$matchrule = 1 )

Check if a variable with name $var start with $text.

Can be used to forge dol_eval() conditions.

Parameters

$var	string Variable
$regextext	string Text that must be a valid regex string
$matchrule	int 1=Test if start with, 0=Test if equal

Returns: boolean|string True or False, text if bad use.

Definition at line 9599 of file functions.lib.php.

◆ isValidEmail()

isValidEmail	(	$address,
		$acceptsupervisorkey = 0,
		$acceptuserkey = 0 )

Return true if email syntax is ok.

Parameters

string	$address	email (Ex: "toto@examle.com". Long form "John Do <johndo@example.com>" will be false)
int	$acceptsupervisorkey	If 1, the special string 'SUPERVISOREMAIL' is also accepted as valid
int	$acceptuserkey	If 1, the special string 'USER_EMAIL' is also accepted as valid

Returns: boolean true if email syntax is OK, false if KO or empty string

See also: isValidMXRecord()

Definition at line 4114 of file functions.lib.php.

Referenced by dol_print_email(), dolObfuscateEmail(), and Notify\getNotificationsArray().

◆ isValidMXRecord()

isValidMXRecord ( $domain )

Return if the domain name has a valid MX record.

WARNING: This need function idn_to_ascii, checkdnsrr and getmxrr

Parameters

string $domain Domain name (Ex: "yahoo.com", "yhaoo.com", "dolibarr.fr")

Returns: int -1 if error (function not available), 0=Not valid, 1=Valid

See also: isValidEmail()

Definition at line 4137 of file functions.lib.php.

Referenced by isValidMailDomain().

◆ isValidPhone()

isValidPhone ( $phone )

Return true if phone number syntax is ok TODO Decide what to do with this.

Parameters

string $phone phone (Ex: "0601010101")

Returns: boolean true if phone syntax is OK, false if KO or empty string

Definition at line 4169 of file functions.lib.php.

◆ isVisibleToUserType()

isVisibleToUserType	(		$type_user,
		&	$menuentry,
		&	$listofmodulesforexternal )

Function to test if an entry is enabled or not.

Parameters

string	$type_user	0=We test for internal user, 1=We test for external user
array	$menuentry	Array for feature entry to test
array	$listofmodulesforexternal	Array with list of modules allowed to external users

Returns: int 0=Hide, 1=Show, 2=Show gray

Definition at line 11349 of file functions.lib.php.

References getDolGlobalString().

Referenced by box_produits\__construct(), box_produits_alerte_stock\__construct(), get_left_menu_projects(), and print_eldy_menu().

◆ jsonOrUnserialize()

jsonOrUnserialize ( $stringtodecode )

Decode an encode string.

The string can be encoded in json format (recommended) or with serialize (avoid this)

Parameters

string $stringtodecode String to decode (json or serialize coded)

Returns: mixed The decoded object.

Definition at line 12544 of file functions.lib.php.

Referenced by BlockedLog\dolDecodeBlockedData(), ExtraFields\fetch_name_optionals_label(), Setup\getListOfExtrafields(), ExportCsv\write_record(), ExportExcel2007\write_record(), and ExportTsv\write_record().

◆ load_fiche_titre()

load_fiche_titre	(	$titre,
		$morehtmlright = '',
		$picto = 'generic',
		$pictoisfullpath = 0,
		$id = '',
		$morecssontable = '',
		$morehtmlcenter = '' )

Load a title with picto.

Parameters

string	$titre	Title to show
string	$morehtmlright	Added message to show on right
string	$picto	Icon to use before title (should be a 32x32 transparent png file)
int	$pictoisfullpath	1=Icon name is a full absolute url of image
string	$id	To force an id on html objects
string	$morecssontable	More css on table
string	$morehtmlcenter	Added message to show on center

Returns: string

See also: print_barre_liste()

Definition at line 5743 of file functions.lib.php.

References dol_strlen().

Referenced by ActionsCardCompany\assign_values(), ActionsCardIndividual\assign_values(), displayPositionCard(), FormFile\form_attach_new_file(), Setup\getCheckIntegrity(), FormFile\list_of_autoecmfiles(), FormFile\list_of_documents(), FormFile\listOfLinks(), print_fiche_titre(), show_contacts(), show_contacts_projects(), show_list_sending_receive(), show_projects(), show_subsidiaries(), FormActions\showactions(), FormFile\showdocuments(), and Form\showLinkedObjectBlock().

◆ make_substitutions()

make_substitutions	(	$text,
		$substitutionarray,
		$outputlangs = null,
		$converttextinhtmlifnecessary = 0 )

Make substitution into a text string, replacing keys with vals from $substitutionarray (oldval=>newval), and texts like __(TranslationKey|langfile)__ and [ConstantKey] are also replaced.

Example of usage: $substitutionarray = getCommonSubstitutionArray($langs, 0, null, $thirdparty); complete_substitutions_array($substitutionarray, $langs, $thirdparty); $mesg = make_substitutions($mesg, $substitutionarray, $langs);

Parameters

string	$text	Source string in which we must do substitution
array	$substitutionarray	Array with key->val to substitute. Example: array('MYKEY' => 'MyVal', ...)
Translate	$outputlangs	Output language
int	$converttextinhtmlifnecessary	0=Convert only value into HTML if text is already in HTML 1=Will also convert initial $text into HTML if we try to insert one value that is HTML

Returns: string Output string after substitutions

See also: complete_substitutions_array(), getCommonSubstitutionArray()

Definition at line 8760 of file functions.lib.php.

References dol_htmlentitiesbr(), dol_is_file(), dol_nl2br(), dol_textishtml(), getDolGlobalString(), and isASecretKey().

◆ natural_search()

natural_search	(	$fields,
		$value,
		$mode = 0,
		$nofirstand = 0 )

Generate natural SQL search string for a criteria (this criteria can be tested on one or several fields)

Parameters

string \| string[]	$fields	String or array of strings, filled with the name of all fields in the SQL query we must check (combined with a OR). Example: array("p.field1","p.field2")
string	$value	The value to look for. If param $mode is 0, can contains several keywords separated with a space or \| like "keyword1 keyword2" = We want record field like keyword1 AND field like keyword2 or like "keyword1\|keyword2" = We want record field like keyword1 OR field like keyword2 If param $mode is 1, can contains an operator <, > or = like "<10" or ">=100.5 < -1000" If param $mode is 2 or -2, can contains a list of int id separated by comma like "1,3,4" If param $mode is 3 or -3, can contains a list of string separated by comma like "a,b,c".
integer	$mode	0=value is list of keyword strings, 1=value is a numeric test (Example ">5.5 <10"), 2=value is a list of ID separated with comma (Example '1,3,4'), -2 is for exclude list, 3=value is list of string separated with comma (Example 'text 1,text 2'), -3 if for exclude list, 4=value is a list of ID separated with comma (Example '2,7') to be used to search into a multiselect string '1,2,3,4'
integer	$nofirstand	1=Do not output the first 'AND'

Returns: string $res The statement to append to the SQL query

See also: dolSqlDateFilter()

Definition at line 10600 of file functions.lib.php.

Referenced by addOtherFilterSQL(), BookKeeping\fetchAll(), BookKeeping\fetchAllBalance(), BookKeeping\fetchAllByAccount(), BlockedLog\getLog(), Task\getTasksArray(), FormProjets\select_projects_list(), show_actions_messaging(), show_contacts(), and pdf_standard\write_file().

◆ newToken()

newToken ( )

Return the value of token currently saved into session with name 'newtoken'.

This token must be send by any POST as it will be used by next page for comparison with value in session.

Since: Dolibarr v10.0.7

Returns: string

Definition at line 12291 of file functions.lib.php.

Referenced by show_actions_messaging().

◆ num2Alpha()

num2Alpha ( $n )

Return a numeric value into an Excel like column number.

So 0 return 'A', 1 returns 'B'..., 26 return 'AA'

Parameters

int | string $n Numeric value

Returns: string Column in Excel format

Definition at line 366 of file functions.lib.php.

Referenced by ImportCsv\import_insert(), ImportXlsx\import_insert(), and show_elem().

◆ picto_from_langcode()

picto_from_langcode	(	$codelang,
		$moreatt = '',
		$notitlealt = 0 )

Return img flag of country for a language code or country code.

Parameters

string	$codelang	Language code ('en_IN', 'fr_CA', ...) or ISO Country code on 2 characters in uppercase ('IN', 'FR')
string	$moreatt	Add more attribute on img tag (For example 'style="float: right"' or 'class="saturatemedium"')
int	$notitlealt	No title alt

Returns: string HTML img string with flag.

Definition at line 9849 of file functions.lib.php.

Referenced by ActionsAdherentCardCommon\assign_values(), ActionsCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), KnowledgeRecord\getTooltipContentArray(), User\getTooltipContentArray(), box_last_knowledgerecord\loadBox(), box_last_modified_knowledgerecord\loadBox(), Form\select_country(), FormAdmin\select_language(), Form\showrefnav(), top_menu_user(), and Form\widgetForTranslation().

◆ picto_required()

picto_required ( )

Return picto saying a field is required.

Returns: string Chaine avec picto obligatoire

Definition at line 7297 of file functions.lib.php.

◆ price()

price	(	$amount,
		$form = 0,
		$outlangs = '',
		$trunc = 1,
		$rounding = -1,
		$forcerounding = -1,
		$currency_code = '' )

Function to format a value into an amount for visual output Function used into PDF and HTML pages.

Parameters

float	$amount	Amount to format
integer	$form	Type of format, HTML or not (not by default)
Translate \| string	$outlangs	Object langs for output. '' use default lang. 'none' use international separators.
int	$trunc	1=Truncate if there is more decimals than MAIN_MAX_DECIMALS_SHOWN (default), 0=Does not truncate. Deprecated because amount are rounded (to unit or total amount accurancy) before beeing inserted into database or after a computation, so this parameter should be useless.
int	$rounding	MINIMUM number of decimal to show: 0=no change, -1=we use min($conf->global->MAIN_MAX_DECIMALS_UNIT,$conf->global->MAIN_MAX_DECIMALS_TOT)
int \| string	$forcerounding	MAXIMUM number of decimal to forcerounding decimal: -1=no change, 'MU' or 'MT' or numeric to round to MU or MT or to a given number of decimal
string	$currency_code	To add currency symbol (''=add nothing, 'auto'=Use default currency, 'XXX'=add currency symbols for XXX currency)

Returns: string String with formated amount

See also: price2num() Revert function of price

Definition at line 6095 of file functions.lib.php.

References dol_strlen(), getDolGlobalInt(), and getDolGlobalString().

◆ price2num()

price2num	(	$amount,
		$rounding = '',
		$option = 0 )

Function that return a number with universal decimal format (decimal separator is '.

') from an amount typed by a user. Function to use on each input amount before any numeric test or database insert. A better name for this function should be roundtext2num().

Parameters

string \| float	$amount	Amount to convert/clean or round
string \| int	$rounding	''=No rounding 'MU'=Round to Max unit price (MAIN_MAX_DECIMALS_UNIT) 'MT'=Round to Max for totals with Tax (MAIN_MAX_DECIMALS_TOT) 'MS'=Round to Max for stock quantity (MAIN_MAX_DECIMALS_STOCK) 'CU'=Round to Max unit price of foreign currency accuracy 'CT'=Round to Max for totals with Tax of foreign currency accuracy Numeric = Nb of digits for rounding (For example 2 for a percentage)
int	$option	Put 1 if you know that content is already universal format number (so no correction on decimal will be done) Put 2 if you know that number is a user input (so we know we have to fix decimal separator).

Returns

string Amount with universal numeric format (Example: '99.99999'). If conversion fails to return a numeric, it returns:

text unchanged or partial if ($rounding = ''): price2num('W9ç', '', 0) => '9ç', price2num('W9ç', '', 1) => 'W9ç', price2num('W9ç', '', 2) => '9ç'
'0' if ($rounding is defined): price2num('W9ç', 'MT', 0) => '9', price2num('W9ç', 'MT', 1) => '0', price2num('W9ç', 'MT', 2) => '9' Note: The best way to guarantee a numeric value is to add a cast (float) before the price2num(). If amount is null or '', it returns '' if $rounding = '', it returns '0' if $rounding is defined.

See also: price() Opposite function of price2num

Definition at line 6223 of file functions.lib.php.

References dol_strlen(), and getDolGlobalString().

Referenced by MouvementStock\_create(), Invoices\_fetch(), Thirdparties\_fetch(), Product\_log_price(), pdf_standard\_pagehead(), pdf_standard\_tableau_cheque(), pdf_azur\_tableau_tot(), pdf_canelle\_tableau_tot(), pdf_cornas\_tableau_tot(), pdf_crabe\_tableau_tot(), pdf_einstein\_tableau_tot(), pdf_muscadet\_tableau_tot(), pdf_vinci\_tableau_tot(), pdf_zenith\_tableau_tot(), Product\add_fournisseur(), Product\add_sousproduit(), BOM\addLine(), BonPrelevement\addline(), Commande\addline(), CommandeFournisseur\addline(), Contrat\addline(), ExpenseReport\addline(), Facture\addline(), FactureFournisseur\addline(), FactureFournisseurRec\addline(), FactureRec\addline(), FichinterRec\addline(), Propal\addline(), SupplierProposal\addline(), Holiday\addLogCP(), Invoices\addPayment(), Localtax\addPayment(), SupplierInvoices\addPayment(), Tva\addPayment(), Invoices\addPaymentDistributed(), Products\addVariant(), Products\addVariantByProductRef(), CommandeFournisseur\approve(), Lettering\bookkeepingLettering(), CommonInvoice\buildSwitzerlandQRString(), CommonInvoice\buildZATCAQRString(), calcul_price_total(), BOM\calculateCosts(), Asset\calculationDepreciation(), ChargeSociales\check(), PaymentVarious\check(), ExpenseReport\computeTotalKm(), Form\constructProductListOption(), Account\create(), CashControl\create(), ChargeSociales\create(), CurrencyRate\create(), DiscountAbsolute\create(), Don\create(), Facture\create(), FactureFournisseur\create(), Loan\create(), LoanSchedule\create(), Paiement\create(), PaiementFourn\create(), PaymentDonation\create(), PaymentExpenseReport\create(), PaymentLoan\create(), PaymentSalary\create(), PaymentSocialContribution\create(), PaymentVarious\create(), PaymentVAT\create(), Product\create(), ProductCustomerPrice\create(), Project\create(), RejetPrelevement\create(), Salary\create(), Delivery\create_line(), SupplierProposal\createPriceFournisseur(), ProductCombination\createProductCombination(), Mo\createProduction(), BookKeeping\createStd(), CommonInvoice\demande_prelevement(), Salary\demande_prelevement(), pdf_cyan\drawTotalTable(), pdf_eagle_proforma\drawTotalTable(), pdf_eratosthene\drawTotalTable(), pdf_sponge\drawTotalTable(), Form\editfieldval(), AccountancyExport\exportConfigurable(), AccountancyExport\exportEbp(), AccountancyExport\exportGestimumV3(), AccountancyExport\exportGestimumV5(), Product\fetch(), Societe\fetch(), Contrat\fetch_lines(), ProductFournisseur\fetch_product_fournisseur_price(), ProductCustomerPrice\fetchAll(), CommonDocGenerator\fill_substitutionarray_with_extrafields(), ProductFournisseur\find_min_price_product_fournisseur(), Productbatch\findAllForProduct(), Form\form_multicurrency_rate(), Dolistore\get_products(), CommonDocGenerator\get_substitutionarray_lines(), CommonDocGenerator\get_substitutionarray_object(), ProjectStats\getAllProjectByStatus(), Fichinter\getAmount(), AccountingJournal\getAssetData(), DiscountAbsolute\getAvailableDiscounts(), getCommonSubstitutionArray(), getMarginInfos(), ExtraFields\getOptionalsFromPost(), AssetDepreciationOptions\getRate(), CommonInvoice\getRemainToPay(), CommonObject\getTotalDiscount(), ImportCsv\import_insert(), ImportXlsx\import_insert(), Invoices\index(), CommandeFournisseurLigne\insert(), ContratLigne\insert(), ExpenseReportLine\insert(), OrderLine\insert(), PropaleLigne\insert(), SupplierInvoiceLine\insert(), SupplierProposalLine\insert(), CommonObject\insertExtraFields(), CommonObject\insertExtraLanguages(), ProductFournisseur\list_product_fournisseur_price(), Product\load_stats_bom(), Product\load_stats_mo(), box_funnel_of_prospection\loadBox(), box_members_subscriptions_by_year\loadBox(), box_produits_alerte_stock\loadBox(), Productlot\loadStatsMo(), FormProduct\loadWarehouses(), loanCalcMonthlyPayment(), ProductFournisseur\logPrice(), ordersupplier_prepare_head(), pdf_pagefoot(), print_projecttasks_array(), CommonObject\printObjectLine(), CommonObject\quote(), RemiseCheque\rejectCheck(), Form\select_produits_fournisseurs_list(), Form\select_produits_list(), BonPrelevement\set_infocredit(), Societe\set_remise_except(), AssetDepreciationOptions\setDeprecationOptionsFromPost(), Commande\setDiscount(), Facture\setDiscount(), ExtraFields\setOptionalsFromPost(), CommonObject\setValuesForExtraLanguages(), InterfaceWorkflowManager\shouldClassify(), showMyBalance(), CommonObject\showOptionals(), Account\solde(), Adherent\subscriptionComplementaryActions(), BankAccounts\transfer(), CUnits\unitConverter(), Account\update(), BookKeeping\update(), ContratLigne\update(), CurrencyRate\update(), Deplacement\update(), Don\update(), ExpeditionLigne\update(), ExpenseReportLine\update(), FactureFournisseurLigneRec\update(), FactureLigne\update(), PaymentSocialContribution\update(), PaymentVAT\update(), Product\update(), ProductCustomerPrice\update(), Project\update(), PropaleLigne\update(), Societe\update(), SupplierInvoiceLine\update(), ProductFournisseur\update_buyprice(), CommonObject\update_price(), CommonObject\updateExtraField(), CommandeFournisseur\updateFromCommandeClient(), BOM\updateLine(), Commande\updateline(), CommandeFournisseur\updateline(), Contrat\updateline(), ExpenseReport\updateline(), Facture\updateline(), FactureFournisseur\updateline(), FactureFournisseurRec\updateline(), FactureRec\updateline(), Propal\updateline(), SupplierProposal\updateline(), Product\updatePrice(), SupplierProposal\updatePriceFournisseur(), Mo\updateProduction(), Holiday\updateSoldeCP(), FactureFournisseur\validate(), doc_generic_project_odt\write_file(), pdf_squille\write_file(), pdf_standard\write_file(), and AccountingJournal\writeIntoBookkeeping().

◆ print_barre_liste()

print_barre_liste	(	$titre,
		$page,
		$file,
		$options = '',
		$sortfield = '',
		$sortorder = '',
		$morehtmlcenter = '',
		$num = -1,
		$totalnboflines = '',
		$picto = 'generic',
		$pictoisfullpath = 0,
		$morehtmlright = '',
		$morecss = '',
		$limit = -1,
		$hideselectlimit = 0,
		$hidenavigation = 0,
		$pagenavastextinput = 0,
		$morehtmlrightbeforearrow = '' )

Print a title with navigation controls for pagination.

Parameters

string	$titre	Title to show (required)
int \| null	$page	Numero of page to show in navigation links (required)
string	$file	Url of page (required)
string	$options	More parameters for links ('' by default, does not include sortfield neither sortorder). Value must be 'urlencoded' before calling function.
string	$sortfield	Field to sort on ('' by default)
string	$sortorder	Order to sort ('' by default)
string	$morehtmlcenter	String in the middle ('' by default). We often find here string $massaction comming from $form->selectMassAction()
int	$num	Number of records found by select with limit+1
int \| string	$totalnboflines	Total number of records/lines for all pages (if known). Use a negative value of number to not show number. Use '' if unknown.
string	$picto	Icon to use before title (should be a 32x32 transparent png file)
int	$pictoisfullpath	1=Icon name is a full absolute url of image
string	$morehtmlright	More html to show (after arrows)
string	$morecss	More css to the table
int	$limit	Max number of lines (-1 = use default, 0 = no limit, > 0 = limit).
int	$hideselectlimit	Force to hide select limit
int	$hidenavigation	Force to hide the arrows and page for navigation
int	$pagenavastextinput	1=Do not suggest list of pages to navigate but suggest the page number into an input field.
string	$morehtmlrightbeforearrow	More html to show (before arrows)

Returns: void

Definition at line 5796 of file functions.lib.php.

References ajax_autoselect(), and print_fleche_navigation().

Referenced by report_header().

◆ print_date_range()

print_date_range	(	$date_start,
		$date_end,
		$format = '',
		$outputlangs = '' )

Format output for start and end date.

Parameters

int	$date_start	Start date
int	$date_end	End date
string	$format	Output format
Translate	$outputlangs	Output language

Returns: void

Definition at line 8998 of file functions.lib.php.

References get_date_range().

Referenced by show_list_sending_receive().

◆ print_fiche_titre()

print_fiche_titre	(	$title,
		$mesg = '',
		$picto = 'generic',
		$pictoisfullpath = 0,
		$id = '' )

Show a title with picto.

Parameters

string	$title	Title to show
string	$mesg	Added message to show on right
string	$picto	Icon to use before title (should be a 32x32 transparent png file)
int	$pictoisfullpath	1=Icon name is a full absolute url of image
int	$id	To force an id on html objects

Returns: void

Deprecated: Use print load_fiche_titre instead

Definition at line 5725 of file functions.lib.php.

References load_fiche_titre().

◆ print_fleche_navigation()

print_fleche_navigation	(	$page,
		$file,
		$options = '',
		$nextpage = 0,
		$betweenarrows = '',
		$afterarrows = '',
		$limit = -1,
		$totalnboflines = 0,
		$hideselectlimit = 0,
		$beforearrows = '',
		$hidenavigation = 0 )

Function to show navigation arrows into lists.

Parameters

int	$page	Number of page
string	$file	Page URL (in most cases provided with $_SERVER["PHP_SELF"])
string	$options	Other url parameters to propagate ("" by default, may include sortfield and sortorder)
integer	$nextpage	Do we show a next page button
string	$betweenarrows	HTML content to show between arrows. MUST contains ' ' tags or ' '.
string	$afterarrows	HTML content to show after arrows. Must NOT contains ' ' tags.
int	$limit	Max nb of record to show (-1 = no combo with limit, 0 = no limit, > 0 = limit)
int	$totalnboflines	Total number of records/lines for all pages (if known)
int	$hideselectlimit	Force to hide select limit
string	$beforearrows	HTML content to show before arrows. Must NOT contains ' ' tags.
int	$hidenavigation	Force to hide the switch mode view and the navigation tool (hide limit section, html in $betweenarrows and $afterarrows but not $beforearrows)

Returns: void

Definition at line 5954 of file functions.lib.php.

References dol_escape_htmltag(), and getDolGlobalString().

Referenced by print_barre_liste().

◆ print_liste_field_titre()

print_liste_field_titre	(	$name,
		$file = "",
		$field = "",
		$begin = "",
		$moreparam = "",
		$moreattrib = "",
		$sortfield = "",
		$sortorder = "",
		$prefix = "",
		$tooltip = "",
		$forcenowrapcolumntitle = 0 )

Show title line of an array.

Parameters

string	$name	Label of field
string	$file	Url used when we click on sort picto
string	$field	Field to use for new sorting
string	$begin	("" by defaut)
string	$moreparam	Add more parameters on sort url links ("" by default)
string	$moreattrib	Options of attribute td ("" by defaut)
string	$sortfield	Current field used to sort
string	$sortorder	Current sort order
string	$prefix	Prefix for css. Use space after prefix to add your own CSS tag, for example 'mycss '.
string	$tooltip	Tooltip
string	$forcenowrapcolumntitle	No need for use 'wrapcolumntitle' css style

Returns: void

Definition at line 5561 of file functions.lib.php.

References getTitleFieldOfList().

Referenced by FormFile\list_of_autoecmfiles(), FormFile\list_of_documents(), FormFile\listOfLinks(), and print_projecttasks_array().

◆ print_titre()

print_titre ( $title )

Show a title.

Parameters

string $title Title to show

Returns: void

Deprecated: Use load_fiche_titre instead

See also: load_fiche_titre()

Definition at line 5707 of file functions.lib.php.

References dol_syslog().

◆ printCommonFooter()

printCommonFooter ( $zone = 'private' )

Print common footer : conf->global->MAIN_HTML_FOOTER js for switch of menu hider js for conf->global->MAIN_GOOGLE_AN_ID js for conf->global->MAIN_SHOW_TUNING_INFO or $_SERVER["MAIN_SHOW_TUNING_INFO"] js for conf->logbuffer.

Parameters

string $zone 'private' (for private pages) or 'public' (for public pages)

Returns: void

Definition at line 10311 of file functions.lib.php.

References getDolGlobalString(), GETPOST(), and name.

Referenced by llxFooterVierge().

◆ readfileLowMemory()

readfileLowMemory	(		$fullpath_original_file_osencoded,
			$method = -1 )

Return a file on output using a low memory.

It can return very large files with no need of memory. WARNING: This close output buffers.

Parameters

string	$fullpath_original_file_osencoded	Full path of file to return.
int	$method	-1 automatic, 0=readfile, 1=fread, 2=stream_copy_to_stream

Returns: void

Definition at line 12470 of file functions.lib.php.

References getDolGlobalString().

Referenced by AccountancyExport\export().

◆ roundUpToNextMultiple()

roundUpToNextMultiple	(		$n,
			$x = 5 )

Round to next multiple.

Parameters

double	$n	Number to round up
integer	$x	Multiple. For example 60 to round up to nearest exact minute for a date with seconds.

Returns: integer Value rounded.

Definition at line 11390 of file functions.lib.php.

◆ sanitizeVal()

sanitizeVal	(	$out = '',
		$check = 'alphanohtml',
		$filter = null,
		$options = null )

Return a sanitized or empty value after checking value against a rule.

Parameters

string \| array	$out	Value to check/clear.
string	$check	Type of check/sanitizing
int	$filter	Filter to apply when $check is set to 'custom'. (See http://php.net/manual/en/filter.filters.php for détails)
mixed	$options	Options to pass to filter_var when $check is set to 'custom'

Returns: string|array Value sanitized (string or array). It may be '' if format check fails.

Return a prefix to use for this Dolibarr instance, for session/cookie names or email id. The prefix is unique for instance and avoid conflict between multi-instances, even when having two instances with same root dir or two instances in same virtual servers. This function must not use dol_hash (that is used for password hash) and need to have all context $conf loaded.

Parameters

string $mode '' (prefix for session name) or 'email' (prefix for email id)

Returns: string A calculated prefix

Definition at line 968 of file functions.lib.php.

References dol_html_entity_decode(), dol_htmlwithnojs(), dol_string_nohtmltag(), and dol_syslog().

Referenced by DolibarrApi\_checkValForAPI(), BankAccounts\addLine(), BankAccounts\addLink(), Products\addPurchasePrice(), Export\build_filterQuery(), checkVal(), Categorie\getListForItem(), GETPOST(), RssParser\parser(), Contracts\postLine(), Invoices\postLine(), Orders\postLine(), Proposals\postLine(), SupplierInvoices\postLine(), Contracts\putLine(), Invoices\putLine(), Orders\putLine(), Proposals\putLine(), SupplierInvoices\putLine(), and BankAccounts\transfer().

◆ setEntity()

setEntity ( $currentobject )

Set entity id to use when to create an object.

Parameters

object $currentobject Current object

Returns: mixed Entity id to use ( eg. entity = '.setEntity($object) )

Definition at line 337 of file functions.lib.php.

◆ setEventMessage()

setEventMessage	(	$mesgs,
		$style = 'mesgs',
		$noduplicate = 0 )

Set event message in dol_events session object.

Will be output by calling dol_htmloutput_events. Note: Calling dol_htmloutput_events is done into pages by standard llxFooter() function. Note: Prefer to use setEventMessages instead.

Parameters

string \| string[]	$mesgs	Message string or array
string	$style	Which style to use ('mesgs' by default, 'warnings', 'errors')
int	$noduplicate	1 means we do not add the message if already present in session stack

Returns: void

See also: dol_htmloutput_events()

Definition at line 9091 of file functions.lib.php.

Referenced by FileUpload\__construct(), Skill\createSkills(), Societe\getParentsForCompany(), DataPolicy\sendMailDataPolicyAdherent(), DataPolicy\sendMailDataPolicyCompany(), DataPolicy\sendMailDataPolicyContact(), setEventMessages(), show_actions_done(), show_actions_messaging(), show_stats_for_company(), and CommandeFournisseur\updateline().

◆ setEventMessages()

setEventMessages	(	$mesg,
		$mesgs,
		$style = 'mesgs',
		$messagekey = '',
		$noduplicate = 0 )

Set event messages in dol_events session object.

Will be output by calling dol_htmloutput_events. Note: Calling dol_htmloutput_events is done into pages by standard llxFooter() function.

Parameters

string	$mesg	Message string
array \| null	$mesgs	Message array
string	$style	Which style to use ('mesgs' by default, 'warnings', 'errors')
string	$messagekey	A key to be used to allow the feature "Never show this message again"
int	$noduplicate	1 means we do not add the message if already present in session stack

Returns: void

See also: dol_htmloutput_events()

Definition at line 9129 of file functions.lib.php.

References dol_print_error(), dol_syslog(), and setEventMessage().

◆ show_actions_messaging()

show_actions_messaging	(		$conf,
			$langs,
			$db,
			$filterobj,
			$objcon = '',
			$noprint = 0,
			$actioncode = '',
			$donetodo = 'done',
			$filters = array(),
			$sortfield = 'a.datep,
		a.id'	,
			$sortorder = 'DESC' )

Show html area with actions in messaging format.

Note: Global parameter $param must be defined.

Parameters

Conf	$conf	Object conf
Translate	$langs	Object langs
DoliDB	$db	Object db
mixed	$filterobj	Filter on object Adherent\|Societe\|Project\|Product\|CommandeFournisseur\|Dolresource\|Ticket\|... to list events linked to an object
Contact	$objcon	Filter on object contact to filter events on a contact
int	$noprint	Return string but does not output it
string	$actioncode	Filter on actioncode
string	$donetodo	Filter on event 'done' or 'todo' or ''=nofilter (all).
array	$filters	Filter on other fields
string	$sortfield	Sort field
string	$sortorder	Sort order

Returns: string|void Return html part or void if noprint is 1

Definition at line 12852 of file functions.lib.php.

References $formactions, Contact(), dol_buildpath(), dol_escape_htmltag(), dol_getdate(), dol_include_once(), dol_mimetype(), dol_now(), dol_print_date(), dol_print_error(), dol_syslog(), dol_trunc(), dolGetElementUrl(), dolGetFirstLineOfText(), getActionCommEcmList(), getDolGlobalInt(), getDolGlobalString(), getTitleFieldOfList(), img_mime(), img_object(), img_picto(), img_warning(), info_admin(), natural_search(), newToken(), and setEventMessage().

◆ showDimensionInBestUnit()

showDimensionInBestUnit	(	$dimension,
		$unit,
		$type,
		$outputlangs,
		$round = -1,
		$forceunitoutput = 'no',
		$use_short_label = 0 )

Output a dimension with best unit.

Parameters

float	$dimension	Dimension
int	$unit	Unit scale of dimension (Example: 0=kg, -3=g, -6=mg, 98=ounce, 99=pound, ...)
string	$type	'weight', 'volume', ...
Translate	$outputlangs	Translate language object
int	$round	-1 = non rounding, x = number of decimal
string	$forceunitoutput	'no' or numeric (-3, -6, ...) compared to $unit (In most case, this value is value defined into $conf->global->MAIN_WEIGHT_DEFAULT_UNIT)
int	$use_short_label	1=Use short label ('g' instead of 'gram'). Short labels are not translated.

Returns: string String to show dimensions

Definition at line 6355 of file functions.lib.php.

References price().

Referenced by pdf_eagle\_tableau_tot(), pdf_espadon\_tableau_tot(), pdf_rouget\_tableau_tot(), pdf_squille\_tableau_tot(), Form\constructProductListOption(), and Form\select_produits_fournisseurs_list().

◆ showDirectDownloadLink()

showDirectDownloadLink ( $object )

Return string with full Url.

The file qualified is the one defined by relative path in $object->last_main_doc

Parameters

Object $object Object

Returns: string Url string

Definition at line 10774 of file functions.lib.php.

◆ showValueWithClipboardCPButton()

showValueWithClipboardCPButton	(	$valuetocopy,
		$showonlyonhover = 1,
		$texttoshow = '' )

Create a button to copy $valuetocopy in the clipboard (for copy and paste feature).

Code that handle the click is inside core/js/lib_foot.js.php.

Parameters

string	$valuetocopy	The value to print
int	$showonlyonhover	Show the copy-paste button only on hover
string	$texttoshow	Replace the value to show with this text. Use 'none' to show no text (only the copy-paste picto)

Returns: string The string to print for the button

Definition at line 12516 of file functions.lib.php.

References dol_escape_htmltag().

Referenced by dol_print_profids().

◆ startSimpleTable()

startSimpleTable	(	$header,
		$link = "",
		$arguments = "",
		$emptyRows = 0,
		$number = -1 )

Start a table with headers and a optinal clickable number (don't forget to use "finishSimpleTable()" after the last table row)

Parameters

string	$header	The first left header of the table (automatic translated)
string	$link	(optional) The link to a internal dolibarr page, when click on the number (without the first "/")
string	$arguments	(optional) Additional arguments for the link (e.g. "search_status=0")
integer	$emptyRows	(optional) The count of empty rows after the first header
integer	$number	(optional) The number that is shown right after the first header, when not set the link is shown on the right side of the header as "FullList"

Returns: void

See also: finishSimpleTable()

Definition at line 12337 of file functions.lib.php.

◆ utf8_check()

utf8_check ( $str )

Check if a string is in UTF8.

Seems similar to utf8_valid() but in pure PHP.

Parameters

string $str String to check

Returns: boolean True if string is UTF8 or ISO compatible with UTF8, False if not (ISO with special non utf8 char or Binary)

See also: utf8_valid()

Definition at line 9435 of file functions.lib.php.

Referenced by CMailFile\check_server_port(), dol_delete_dir_recursive(), dol_dir_list(), dol_print_error(), dol_string_unaccent(), ImportCsv\import_read_record(), Login\index(), Product\is_photo_available(), Ticket\is_photo_available(), Product\liste_photos(), box_external_rss\loadBox(), and show_elem().

◆ utf8_valid()

utf8_valid ( $str )

Check if a string is in UTF8.

Seems similar to utf8_check().

Parameters

string $str String to check

Returns: boolean True if string is valid UTF8 string, false if corrupted

See also: utf8_check()

Definition at line 9473 of file functions.lib.php.

◆ vatrate()

vatrate	(	$rate,
		$addpercent = false,
		$info_bits = 0,
		$usestarfornpr = 0,
		$html = 0 )

Return a string with VAT rate label formated for view output Used into pdf and HTML pages.

Parameters

string	$rate	Rate value to format ('19.6', '19,6', '19.6', '19,6', '19.6 (CODEX)', ...)
boolean	$addpercent	Add a percent % sign in output
int	$info_bits	Miscellaneous information on vat (0=Default, 1=French NPR vat)
int	$usestarfornpr	-1=Never show, 0 or 1=Use '*' for NPR vat rates
int	$html	Used for html output

Returns: string String with formated amounts ('19,6' or '19,6' or '8.5% (NPR)' or '8.5% *' or '19,6 (CODEX)')

Definition at line 6046 of file functions.lib.php.

References price().

◆ verifCond()

verifCond ( $strToEvaluate )

Verify if condition in string is ok or not.

Parameters

string $strToEvaluate String with condition to check

Returns: boolean True or False. Note: It returns also True if $strToEvaluate is ''. False if error

Definition at line 9623 of file functions.lib.php.

References dol_eval().

Referenced by complete_head_from_modules(), ActionsCardProduct\getFieldListCanvas(), ActionsCardService\getFieldListCanvas(), Export\load_arrays(), and Menubase\menuLoad().

◆ yn()

yn	(	$yesno,
		$case = 1,
		$color = 0 )

Return yes or no in current language.

Parameters

string \| int	$yesno	Value to test (1, 'yes', 'true' or 0, 'no', 'false')
integer	$case	1=Yes/No, 0=yes/no, 2=Disabled checkbox, 3=Disabled checkbox + Yes/No
int	$color	0=texte only, 1=Text is formated with a color font style ('ok' or 'error'), 2=Text is formated with 'ok' color.

Returns: string HTML string

Definition at line 7096 of file functions.lib.php.

Referenced by ActionsCardCommon\assign_values(), AdherentType\getKanbanView(), CommandeFournisseur\getKanbanView(), ActionComm\getNomUrl(), getResultColumn(), ModeleNumRefBarCode\getToolTip(), ModeleNumRefMembers\getToolTip(), ModeleProductCode\getToolTip(), ModeleThirdPartyCode\getToolTip(), ActionComm\getTooltipContentArray(), AdherentType\getTooltipContentArray(), User\getTooltipContentArray(), mod_codecompta_aquarium\info(), mod_codecompta_digitaria\info(), Adherent\makeSubstitution(), showSkins(), and top_menu_user().

Functions

Detailed Description

Function Documentation

◆ addSummaryTableLine()

◆ ajax_autoselect()

◆ ascii_check()

◆ buildParamDate()

◆ checkVal()

◆ colorIsLight()

◆ complete_head_from_modules()

◆ complete_substitutions_array()

◆ currentToken()

◆ dol_banner_tab()

◆ dol_bc()

◆ dol_buildpath()

◆ dol_clone()

◆ dol_concatdesc()

◆ dol_escape_all()

◆ dol_escape_htmltag()

◆ dol_escape_js()

◆ dol_escape_json()

◆ dol_escape_php()

◆ dol_escape_xml()

◆ dol_eval()

◆ dol_fiche_end()

◆ dol_fiche_head()

◆ dol_format_address()

◆ dol_get_fiche_end()

◆ dol_get_fiche_head()

◆ dol_getdate()

◆ dol_getIdFromCode()

◆ dol_getmypid()

◆ dol_html_entity_decode()

◆ dol_htmlcleanlastbr()

◆ dol_htmlentities()

◆ dol_htmlentitiesbr()

◆ dol_htmlentitiesbr_decode()

◆ dol_htmloutput_errors()

◆ dol_htmloutput_events()

◆ dol_htmloutput_mesg()

◆ dol_htmlwithnojs()

◆ dol_include_once()

◆ dol_mimetype()

◆ dol_mkdir()

◆ dol_mktime()

◆ dol_nboflines()

◆ dol_nboflines_bis()

◆ dol_nl2br()

◆ dol_now()

◆ dol_osencode()

◆ dol_print_address()

◆ dol_print_date()

◆ dol_print_email()

◆ dol_print_error()

◆ dol_print_error_email()

◆ dol_print_ip()

◆ dol_print_phone()

◆ dol_print_profids()

◆ dol_print_size()

◆ dol_print_socialnetworks()

◆ dol_print_url()

◆ dol_sanitizeEmail()

◆ dol_sanitizeFileName()

◆ dol_sanitizePathName()

◆ dol_sanitizeUrl()

◆ dol_set_focus()

◆ dol_shutdown()

◆ dol_size()

◆ dol_sort_array()

◆ dol_strftime()

◆ dol_string_is_good_iso()

◆ dol_string_neverthesehtmltags()

◆ dol_string_nohtmltag()

◆ dol_string_nospecial()

◆ dol_string_nounprintableascii()

◆ dol_string_onlythesehtmlattributes()

◆ dol_string_onlythesehtmltags()

◆ dol_string_unaccent()

◆ dol_strlen()

◆ dol_strtolower()