https://wiki.dolibarr.org/api.php?action=feedcontributions&user=John.botella&feedformat=atomDolibarr ERP CRM Wiki - User contributions [en]2024-03-29T08:52:36ZUser contributionsMediaWiki 1.35.0https://wiki.dolibarr.org/index.php?title=Setup_Other&diff=48090Setup Other2020-08-14T07:19:41Z<p>John.botella: /* Services Module */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
<br />
<br />
'''Introduction'''<br />
<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of some advanced development parameters. In most cases, it is parameters for internal usage, development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All experimental options are NOT supported. They may be removed in a future, modified at any version and break stability of your application.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
<br />
'''Some unsupported and unstable options (experimental or development options)'''<br />
<br />
Some options are not yet documented since they are not stable and not supported yet. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
<br />
<center><br />
<div class="toclimit-1 tocinline"><br />
__TOC__<br />
</div><br />
</center><br />
<br />
<br />
=Global Options=<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). Warning: Using this may allow an external website to steel your login credentials ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports!<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
*MAIN_COUNTRIES_IN_EEC ► Country list in European Area (For VAT purpose) (v10.0+)<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
*MAIN_DEFAULT_PAYMENT_TYPE_ID► With ID of a payment type, will use this as default payment type each time you create a new proposal, order, invoice (customer and supplier) ► (v12.0)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_LANGUAGES_ALLOWED ► is a list of languages without spaces, example : fr_FR,en_US,de_DE,it_IT if defined, only those languages will appear in combos. ► (v11.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>). Value of this variable may be requested by some external script or tools.<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_ALL_TO_UPPER ► Dolibarr puts uppercase for Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data. ► (v11.0)<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_ALTERNATE_TRANSLATION_FOR ► List of fields per object that need an alternate translation. Example: MAIN_USE_ALTERNATE_TRANSLATION_FOR=societe:name,town;contact:firstname,lastname<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VIEW_LINE_NUMBER_IN_LIST ► Shows a line number in lists (v12.0).<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
*MAIN_DISABLE_PDF_THUMBS ► Disable thumbs PDF in case of imagick bug<br />
*MAIN_KEEP_REF_CUSTOMER_ON_CLONING ► Keep the Customer Reference on cloned object (Propal/Invoice)<br />
*MAIN_DONT_KEEP_NOTE_ON_CLONING ► Remove the object notes during cloning ► (v11.0)<br />
*MAIN_DOC_SORT_FIELD ► Set the default sorting field on document page (name by default) ► (v11.0)<br />
*MAIN_DOC_SORT_ORDER ► Set the default sorting order (ASC or DESC) on document page (ASC by default) ► (v11.0)<br />
*MAIN_USE_ZIPTOWN_DICTIONNARY► Use dictionnary ZIP for create card.<br />
*MAIN_USE_TOP_MENU_BOOKMARK_DROPDOWN► Show bookmark in top menu with theme eldy ► (v11.0)<br />
*MAIN_USE_TOP_MENU_SEARCH_DROPDOWN► Show search in top menu with theme eldy ► (v11.0)<br />
*MAIN_PHONE_SEPAR ► Separ phone number other space ►(v12.0)<br />
*GRAPH_USE_FISCAL_YEAR ► Widgets uses fiscal year<br />
<br />
*SHOW_SOCINFO_ON_PRINT ► Permit to add user company information on each printed document (when click on Dolibarr print button) ►(v12.0)<br />
*MAIN_FEATURES_LEVEL ► Level of features to show: -1=stable+deprecated, 0=stable only (default), 1=stable+experimental, 2=stable+experimental+development<br />
*MAIN_SHOW_TECHNICAL_ID ► Show tecnical id for object.<br />
<br />
*MAIN_HTTP_CONTENT_SECURITY_POLICY ► Allows you to fill in the content security rules ►(v6.0)<br />
<br />
*SOCIETE_ON_SEARCH_AND_LIST_GO_ON_CUSTOMER_OR_SUPPLIER_CARD ► Allow to change the link of the third party to customer/supplier card instead of contact card on List.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Accountancy Module=<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX. Having this option on may slow down and even freeze the accounting features if you have a very large number of thirdparties ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Agenda Module=<br />
<br />
*AGENDA_ALL_CALENDARS ► Change the default view of calendar pages to see all the Agenda's (instead or yours only be default)<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Bank Module=<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Contracts=<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Direct Debit Orders=<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
<br />
=Email and SMS=<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
*MAIN_INFO_SOCIETE_MAIL_ALIASES ► add address aliases for the from field on mail. Set his value with "Firstname Name <firstname.lastname@mydomain.tld, Otherfirstname OtherlastName <othermail@mydomain.tld>,..." ► (v5.0.0+)<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► (A better name of this option should be MAIN_EXTERNAL_MAIL_CLIENT_IP_ADDRESS). Set here the list of IPs where your Dolibarr instances are hosted. So when your customer go into the setup area of email:<br />
**If he chose mail method, a message will explain him how to setup its SPF record for its email domain (showing the list of IP). This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
**If he chose smtp method, a message will explain him the list of IP he can use if there is restriction on IP by the SMTP agent. If you also need to add a message to help SPF setup, see option MAIN_EXTERNAL_SMTP_SPF_STRING_TO_ADD.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
*<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Emailing Module=<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Expense Report=<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_OVERRIDE_VAT ► Setting constant EXPENSEREPORT_OVERRIDE_VAT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Export Module=<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
*EXPORTS_SHARE_MODELS ► Share export models between user<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Foundation Module=<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Interventions Module=<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Invoice Module=<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► See PDF option<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► See PDF options<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
*FACTURE_ENABLE_NEGATIVE ► Can validate an invoice when amount is negative<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
*INVOICE_ALLOW_FREE_REF ► Apability to change reference of an invoice. This will be possible as long as the invoice has the status “Draft” and only if your country is not in Europe(V11)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Look or Theme=<br />
<br />
*MAIN_FAVICON_URL ► favicon url<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
<br />
*MAIN_USE_TOP_MENU_SEARCH_DROPDOWN ► (v11.0+) actually only for eldy theme, this conf move search input to top menu and use new design too<br />
<br />
*THEME_AGRESSIVENESS_RATIO ► (v11.0+) this conf can be used to increase/decrease agressiveness of colors. Value 0 is medium, value is between -100 (light grey colors) to +100 (very flashy colors)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=MultiCurrency=<br />
<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Order Module=<br />
<br />
*MAIN_USE_PROPAL_REFCLIENT_FOR_ORDER => Copy customer reference from proposal to order. ► (v7.0+)<br />
<br />
*ORDER_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*ORDER_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*ORDER_ENABLE_NEGATIVE => Can validate an order when amount is negative<br />
<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy also extrafields from thirdparty to order (if name match). ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=PDF Options=<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF. Note: This option is set automatically if country if Germany.<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', '''java''' and '''jodconverter''' command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then '''java''' and the '''jodconverter''' jar must exist, '''soffice''' must also be available. The constant <code>MAIN_DOL_SCRIPTS_ROOT</code> must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code> without scripts).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FORCE_FONT_SIZE ► To force size of font (by default 10). For example "<code>12</code>" ► (v11.0)<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_PDF_USE_LARGE_LOGO ► Use the original logo with its higher resolution into the PDF instead of the small thumb. This may lead to very very large PDF !<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries. Note that VAT number should be already visible in footer of page ► (v8.0.1+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_BOLD_PRODUCT_REF_AND_PERIOD ► Add more visibility (bold) on product ref and period of service in desc. ► (v12.0)<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*PDF_SECURITY_ENCRYPTION ► Encrypt PDF produced by dolibarr ► (v?) . See additional parameters :PDF_SECURITY_ENCRYPTION_RIGHTS (block 'modify' or 'copy') - PDF_SECURITY_ENCRYPTION_USERPASS - PDF_SECURITY_ENCRYPTION_OWNERPASS (random if not specified) - PDF_SECURITY_ENCRYPTION_STRENGTH (0 = RC4 40 bit; 1 = RC4 128 bit; 2 = AES 128 bit; 3 = AES 256 bit) - PDF_SECURITY_ENCRYPTION_PUBKEYS Array of recipients containing public-key certificates ('c') and permissions ('p') - For example: array(array('c' => 'file://../examples/data/cert/tcpdf.crt', 'p' => array('print')))<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_USE_1A ► PDF files produced by dolibarr respect PDF/A standard ► (v?)<br />
<br />
*PDF_USE_ALSO_LANGUAGE_CODE ► The value of this constant must be a language code ('fr_FR', 'en_US', 'sa_SA', ...). If set, the PDF document will contains both language (default and the one defined by the constant).<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Point of Sale (POS)=<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to use for invoice ref definition when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
*TAKEPOS_ENABLE_SUMUP ► Enable the compatibility of TakePOS with the card reader terminal [https://SumUp.fr SumUp]<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Products Module=<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid customs code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*MAIN_SEARCH_PRODUCT_BY_FOURN_REF ► (>= 8.0) Allow to search a product by supplier ref in document's add line form.<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUCT_DISABLE_PROPAGATE_CUSTOMER_PRICES_ON_CHILD_COMPANIES ► Disable propagation of prices per customer from a customer to its child company.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*PRODUIT_CUSTOMER_PRICES_BY_QTY ► If price per quantity ► Experimental<br />
*PRODUIT_CUSTOMER_PRICES_BY_QTY_MULTIPRICES ► If price per quantity and customer ► Experimental<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Add another units on products (Use same dictionnary as default unit feature) and propagate this unit on line of documents.<br />
<br />
*RESOURCE_ON_PRODUCTS_RESOURCE_ON_SERVICES ► Allow to affect ressources on products/services (v10.0+)<br />
*PRODUCT_SHOW_ORIGIN_IN_COMBO ► Show origin of products when adding lines in proposals/invoices/orders (v12.0+)<br />
*PRODUIT_ATTRIBUTES_HIDECHILD ► Add option hide child if variantes<br />
<br />
*PRODUCT_ADD_FORM_ADD_TO ► Add a product to a draft proposal/order/invoice, from the product card.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Projects Module=<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_OPEN_ALWAYS_ON_TAB ► Set to value 'task', or 'preview' to always open the project on the given tab instead of main tab.<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Proposals Module=<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*PROPOSAL_AUTO_ADD_AUTHOR_AS_CONTACT ► Add Proposal Author as user contact follow proposal<br />
<br />
*PROPOSAL_PDF_HIDE_PAYMENTTERM ► Do not show the payment term on proposal ► (v11.0+)<br />
<br />
*PROPOSAL_PDF_HIDE_PAYMENTMODE ► Do not show the payment mode on proposal ► (v11.0+)<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Services Module=<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
*MAIN_FILL_SERVICE_DATES_FROM_LAST_SERVICE_LINE ► (v13.0) On add line form add a button to fill service dates from the last service line<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Shipments=<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Stocks=<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock when using POS whatever is user setup.<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
*STOCK_SUPPORTS_SERVICES ► Stock support services<br />
*USER_DEFAULT_WAREHOUSE ► Can set a default warehouse on user card ► (v11.0)<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
*MAIN_DEFAULT_WAREHOUSE ► Warehouse default (rowid) ► (v12.0)<br />
*MAIN_DEFAULT_WAREHOUSE_USER ► Warehouse default is warehouse definie on user ► (v12.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Suppliers Module=<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=Third Parties Module=<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on alphabetical order instead of the field "position" that appears into dictionary instead.<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
*SOCIETE_ADD_REF_IN_LIST ► Displays the code before the name in the lists ► Value 1 -> Code + name + alias ou Code + name if colone alias 2 -> Code + alias 3 -> Alias<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
*THIRDPARTY_QUICKSEARCH_ON_FIELDS ► Personalized search criterias ► Example: $conf->global->THIRDPARTY_QUICKSEARCH_ON_FIELDS = 's.nom=ThirdPartyName;s.name_alias=AliasNameShort;s.code_client=CustomerCode'<br />
*MEMBER_CAN_CONVERT_CUSTOMERS_TO_MEMBERS ► Enabled member creation on third-party create card<br />
*SOCIETE_DISABLE_PARENTCOMPANY ► Disables attachment to a parent company.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=VAT Report=<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=Website Module=<br />
<br />
*WEBSITE_USE_WEBSITE_ACCOUNTS ► Add a table and a tab to manage some accounts for websites to a third party<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=WYSIWYG Editor=<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=STRIPE Module=<br />
<br />
*STRIPE_FORCE_VERSION ► Force the STRIPE version. For Example: "2019-09-09" (v11+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
=ClickToDial Module=<br />
<br />
*CLICKTODIAL_FORCENEWTARGET ► Open in new page.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
=For SaaS / Cloud hosting integrators=<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*CRON_DISABLE_KEY_CHANGE ► When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].<br />
<br />
*CRON_DISABLE_TUTORIAL_CRON ► Disable the tutorial about how to install the cron script (on a SaaS hosting, this should be the system)<br />
<br />
*To avoid bad use of the emailing module, it is recommended to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*If you set a system limit on number of recipient, you can set some option to match the same values so users will be informed: MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Set this value to a translation key. Then add translation keys into the instance so user will see a message when into the email setup page. For example, you can set a message to say ''Warning: To avoid abuse, when using default setup, you are restricted to 500 emails per day for all your application (account may be suspended in case of violation of this rule. You can setup application to use your own SMTP server for sending email so you want have no restriction at all (see menu Home-Setup-Emails)''<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► (A better name of this option should be MAIN_EXTERNAL_MAIL_CLIENT_IP_ADDRESS). Set here the list of IPs where your Dolibarr instances are hosted. So when your customer go into the setup area of email:<br />
**If he chose mail method, a message will explain him how to setup its SPF record for its email domain (showing the list of IP). This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
**If he chose smtp method, a message will explain him the list of IP he can use if there is restriction on IP by the SMTP agent. If you also need to add a message to help SPF setup, see option MAIN_EXTERNAL_SMTP_SPF_STRING_TO_ADD.<br />
<br />
*MAIN_EXTERNAL_SMTP_SPF_STRING_TO_ADD ► Set here the string to add in the SPF record This string will be shown into a help message when the user in in the setup of email page and has choose a method using an external SMTP server.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE ► If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX and MAIN_FILECHECK_LOCAL_EXT ► If you offer a customized or patched version of Dolibarr, when the user will use the tool to check the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team, so it does not includes your own changes. To have the suggested signature file being your own file, you can set the constant MAIN_FILECHECK_LOCAL_SUFFIX to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-10.0.2-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without being disturbed by false alerts due to your customized files or patches (they will be included in the signature used for check). Also, if you want to zip the customized signature file into "'''/install/filelist-10.0.2-mysaassolution.xml.zip'''", you can set the constant MAIN_FILECHECK_LOCAL_EXT to '.zip'.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► If set to N, the warning saying modules are not activated will be shown if number of activated module is < N (Having this variable not defined is same than having it set to 1). This may be usefull if you preinstall an application with some modules already loaded by default and you want to keep the warning to be sure the user will enable other modules he need, even if some modules are already enabed.<br />
<br />
*SYSLOG_DISABLE_LOGHANDLER_SYSLOG ► Set this to 1 to disable usage of syslog (having all customer instances logging in the same system file is not a good idea).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER ► Put here a text or a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of its subscription and putting a website online may need a complementary subscription.</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=44804Setup Other2019-11-09T10:19:02Z<p>John.botella: /* Products Module */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
=Introduction=<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All hidden options are NOT supported. They may be removed in a future or modified at any version.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
=List of Known Hidden Options=<br />
<br />
After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
==Global Options==<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
*MAIN_COUNTRIES_IN_EEC ► Country list in European Area (For VAT purpose) (v10.0+)<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_LANGUAGES_ALLOWED ► is a list of languages without spaces, example : fr_FR,en_US,de_DE,it_IT if defined, only those languages will appear in combos. ► (v11.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)<br />
<br />
*MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
*MAIN_DISABLE_PDF_THUMBS ► Disable thumbs PDF in case of imagick bug<br />
*MAIN_KEEP_REF_CUSTOMER_ON_CLONING ► Keep the Customer Reference on cloned object (Propal/Invoice)<br />
*MAIN_DONT_KEEP_NOTE_ON_CLONING ► Remove the object notes during cloning ► (v11.0)<br />
*MAIN_DOC_SORT_FIELD ► Set the default sorting field on document page (name by default) ► (v11.0)<br />
*MAIN_DOC_SORT_ORDER ► Set the default sorting order (ASC or DESC) on document page (ASC by default) ► (v11.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Accountancy Module==<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Agenda Module==<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
*AGENDA_ALL_CALENDARS ► Change the default view to calendar for all the Agenda's<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Bank Module==<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==BlockedLog==<br />
<br />
*BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Contracts==<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Direct Debit Orders==<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
==Email and SMS==<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Emailing Module==<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Expense Report==<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Export Module==<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
*EXPORTS_SHARE_MODELS ► Share export models between user<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Foundation Module==<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Interventions Module==<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Invoice Module==<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_CHANGE_THIRDPARTY ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
*FACTURE_USE_PROFORMAT ► Enable PROFORMAT invoices type.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► See PDF option<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► See PDF options<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Look or Theme==<br />
<br />
*MAIN_FAVICON_URL ► favicon url<br />
*MAIN_OPTIMIZEFORTEXTBROWSER ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
*THEME_ELDY_DISABLE_IMAGE ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
*MAIN_MENU_HIDE_UNAUTHORIZED ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
*THEME_TOPMENU_STICKY_POSITION ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_USE_NEW_TITLE_BUTTON ► (v10.0+) Use new list buttons design<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
*MAIN_USE_TOP_MENU_BOOKMARK_DROPDOWN ► (v11.0+) actually only for eldy theme, this conf move bookmark to top menu and use new design too<br />
*MAIN_USE_TOP_MENU_SEARCH_DROPDOWN ► (v11.0+) actually only for eldy theme, this conf move search input to top menu and use new design too<br />
<br />
*THEME_AGRESSIVENESS_RATIO ► (v11.0+) this conf can be used to increase/decrease agressiveness of colors. Value 0 is medium, value is between -100 (light grey colors) to +100 (very flashy colors)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==MultiCurrency==<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Order Module==<br />
<br />
*COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy extrafields from thirdparty to order. ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==PDF Options==<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FORCE_FONT_SIZE ► To force size of font. For example "<code>12</code>" ► (v11)<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*ADD_HTML_FORMATING_INTO_DESC_DOC ► Add more visibility to important informations like reference and serial number in desc. ► (v10.0)<br />
*MAIN_PDF_FORCE_FONT_SIZE ► Force the PDF Font Size (by default 10) ► (v11.0)<br />
*PDF_USE_1A ► PDF files produced by dolibarr respect PDF/A standard ► (v?)<br />
*PDF_SECURITY_ENCRYPTION ► Encrypt PDF produced by dolibarr ► (v?) . See additional parameters :PDF_SECURITY_ENCRYPTION_RIGHTS (block 'modify' or 'copy') - PDF_SECURITY_ENCRYPTION_USERPASS - PDF_SECURITY_ENCRYPTION_OWNERPASS (random if not specified) - PDF_SECURITY_ENCRYPTION_STRENGTH (0 = RC4 40 bit; 1 = RC4 128 bit; 2 = AES 128 bit; 3 = AES 256 bit) - PDF_SECURITY_ENCRYPTION_PUBKEYS Array of recipients containing public-key certificates ('c') and permissions ('p') - For example: array(array('c' => 'file://../examples/data/cert/tcpdf.crt', 'p' => array('print')))<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Point of Sale==<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
<br />
TAKEPOS_ROOT_CATEGORY_ID<br />
[[#Top|(back to top)]]<br />
<br />
==Products Module==<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*MAIN_SEARCH_PRODUCT_BY_FOURN_REF ► (>= 8.0) Allow to search a product by supplier ref in document's add line form.<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Enable units from dictionary in product/service card.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*PRODUCT_CHARGES ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
*RESOURCE_ON_PRODUCTS_RESOURCE_ON_SERVICES ►Allow to affect ressources on products/services (v10.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Projects Module==<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Proposals Module==<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Services Module==<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Shipments==<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Stocks==<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock whatever is user setup<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
*STOCK_SUPPORTS_SERVICES ► Stock support services<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Suppliers Module==<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Third Parties Module==<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*MAIN_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
*THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==VAT Report==<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==WYSIWYG Editor==<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==For SaaS / Cloud hosting integrators==<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*To avoid bad use of the emailing module, it is recommanded to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: Set here the ip of list of ip where your Dolibarr instances are hosted. So when your customer go into the setup area of email, a message will explain him how to setup its SPF record for its email domain. This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE: If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX: If you offer a customized or patched version of Dolibarr, when the user will use the tool to chek the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team. To have the suggested signature file beeing your own file you can set ths constant to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without beeing disturbed by false alerts due to your customized files or patches (they are included in the signature used for check).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of is subscription and putting a website online may need a complementary subscription.<br />
<br />
*CRON_DISABLE_KEY_CHANGE: When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=44536Setup Other2019-10-19T20:02:49Z<p>John.botella: /* Look or Theme */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
=Introduction=<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All hidden options are NOT supported. They may be removed in a future or modified at any version.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
=List of Known Hidden Options=<br />
<br />
After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
==Global Options==<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_LANGUAGES_ALLOWED ► is a list of languages without spaces, example : fr_FR,en_US,de_DE,it_IT if defined, only those languages will appear in combos. ► (v11.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)<br />
<br />
*MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
*MAIN_DISABLE_PDF_THUMBS ► Disable thumbs PDF in case of imagick bug<br />
*MAIN_KEEP_REF_CUSTOMER_ON_CLONING ► Keep the Customer Reference on cloned object (Propal/Invoice)<br />
*MAIN_DONT_KEEP_NOTE_ON_CLONING ► Remove the object notes during cloning ► (v11.0)<br />
*MAIN_DOC_SORT_FIELD ► Set the default sorting field on document page (name by default) ► (v11.0)<br />
*MAIN_DOC_SORT_ORDER ► Set the default sorting order (ASC or DESC) on document page (ASC by default) ► (v11.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Accoutancy Module==<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Agenda Module==<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
*AGENDA_ALL_CALENDARS ► Change the default view to calendar for all the Agenda's<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Bank Module==<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==BlockedLog==<br />
<br />
*BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Contracts==<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Direct Debit Orders==<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
==Email and SMS==<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Emailing Module==<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Expense Report==<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Export Module==<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
*EXPORTS_SHARE_MODELS ► Share export models between user<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Foundation Module==<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Interventions Module==<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Invoice Module==<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_CHANGE_THIRDPARTY ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
*FACTURE_USE_PROFORMAT ► Enable PROFORMAT invoices type.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► See PDF option<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► See PDF options<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Look or Theme==<br />
<br />
*MAIN_FAVICON_URL ► favicon url<br />
*MAIN_OPTIMIZEFORTEXTBROWSER ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
*THEME_ELDY_DISABLE_IMAGE ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
*MAIN_MENU_HIDE_UNAUTHORIZED ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
*THEME_TOPMENU_STICKY_POSITION ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_USE_NEW_TITLE_BUTTON ► (v10.0+) Use new list buttons design<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
*MAIN_USE_TOP_MENU_BOOKMARK_DROPDOWN ► (v11.0+) actually only for eldy theme, this conf move bookmark to top menu and use new design too<br />
*MAIN_USE_TOP_MENU_SEARCH_DROPDOWN ► (v11.0+) actually only for eldy theme, this conf move search input to top menu and use new design too<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==MultiCurrency==<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Order Module==<br />
<br />
*COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy extrafields from thirdparty to order. ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==PDF Options==<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FORCE_FONT_SIZE ► To force size of font. For example "<code>12</code>" ► (v11)<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*ADD_HTML_FORMATING_INTO_DESC_DOC ► Add more visibility to important informations like reference and serial number in desc. ► (v10.0)<br />
*MAIN_PDF_FORCE_FONT_SIZE ► Force the PDF Font Size (by default 10) ► (v11.0)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Point of Sale==<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
<br />
TAKEPOS_ROOT_CATEGORY_ID<br />
[[#Top|(back to top)]]<br />
<br />
==Products Module==<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Enable units from dictionary in product/service card.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*PRODUCT_CHARGES ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Projects Module==<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Proposals Module==<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Services Module==<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Shipments==<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Stocks==<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock whatever is user setup<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Suppliers Module==<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Third Parties Module==<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*MAIN_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
*THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==VAT Report==<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==WYSIWYG Editor==<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==For SaaS / Cloud hosting integrators==<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*To avoid bad use of the emailing module, it is recommanded to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: Set here the ip of list of ip where your Dolibarr instances are hosted. So when your customer go into the setup area of email, a message will explain him how to setup its SPF record for its email domain. This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE: If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX: If you offer a customized or patched version of Dolibarr, when the user will use the tool to chek the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team. To have the suggested signature file beeing your own file you can set ths constant to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without beeing disturbed by false alerts due to your customized files or patches (they are included in the signature used for check).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of is subscription and putting a website online may need a complementary subscription.<br />
<br />
*CRON_DISABLE_KEY_CHANGE: When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=44446Setup Other2019-10-03T18:32:37Z<p>John.botella: /* Global Options */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
=Introduction=<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All hidden options are NOT supported. They may be removed in a future or modified at any version.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
=List of Known Hidden Options=<br />
<br />
After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
==Global Options==<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_LANGUAGES_ALLOWED ► is a list of languages without spaces, example : fr_FR,en_US,de_DE,it_IT if defined, only those languages will appear in combos. ► (v11.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)<br />
<br />
*MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
*MAIN_DISABLE_PDF_THUMBS ► Disable thumbs PDF in case of imagick bug<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Accoutancy Module==<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Agenda Module==<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
*AGENDA_ALL_CALENDARS ► Change the default view to calendar for all the Agenda's<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Bank Module==<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==BlockedLog==<br />
<br />
*BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Contracts==<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Direct Debit Orders==<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
==Email and SMS==<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Emailing Module==<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Expense Report==<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Export Module==<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Foundation Module==<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Interventions Module==<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Invoice Module==<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_CHANGE_THIRDPARTY ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
*FACTURE_USE_PROFORMAT ► Enable PROFORMAT invoices type.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► See PDF option<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► See PDF options<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Look or Theme==<br />
<br />
*MAIN_FAVICON_URL ► favicon url<br />
*MAIN_OPTIMIZEFORTEXTBROWSER ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
*THEME_ELDY_DISABLE_IMAGE ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
*MAIN_MENU_HIDE_UNAUTHORIZED ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
*THEME_TOPMENU_STICKY_POSITION ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_USE_NEW_TITLE_BUTTON ► (v10.0+) Use new list buttons design<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==MultiCurrency==<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Order Module==<br />
<br />
*COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy extrafields from thirdparty to order. ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==PDF Options==<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*ADD_HTML_FORMATING_INTO_DESC_DOC ► Add more visibility to important informations like reference and serial number in desc. ► (v10.0)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Point of Sale==<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
<br />
TAKEPOS_ROOT_CATEGORY_ID<br />
[[#Top|(back to top)]]<br />
<br />
==Products Module==<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Enable units from dictionary in product/service card.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*PRODUCT_CHARGES ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Projects Module==<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Proposals Module==<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Services Module==<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Shipments==<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Stocks==<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock whatever is user setup<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Suppliers Module==<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Third Parties Module==<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*MAIN_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
*THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==VAT Report==<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==WYSIWYG Editor==<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==For SaaS / Cloud hosting integrators==<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*To avoid bad use of the emailing module, it is recommanded to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: Set here the ip of list of ip where your Dolibarr instances are hosted. So when your customer go into the setup area of email, a message will explain him how to setup its SPF record for its email domain. This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE: If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX: If you offer a customized or patched version of Dolibarr, when the user will use the tool to chek the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team. To have the suggested signature file beeing your own file you can set ths constant to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without beeing disturbed by false alerts due to your customized files or patches (they are included in the signature used for check).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of is subscription and putting a website online may need a complementary subscription.<br />
<br />
*CRON_DISABLE_KEY_CHANGE: When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=44422Setup Other2019-10-01T19:21:51Z<p>John.botella: /* Look or Theme */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
=Introduction=<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All hidden options are NOT supported. They may be removed in a future or modified at any version.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
=List of Known Hidden Options=<br />
<br />
After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
==Global Options==<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)<br />
<br />
*MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
*MAIN_DISABLE_PDF_THUMBS ► Disable thumbs PDF in case of imagick bug<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Accoutancy Module==<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Agenda Module==<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
*AGENDA_ALL_CALENDARS ► Change the default view to calendar for all the Agenda's<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Bank Module==<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==BlockedLog==<br />
<br />
*BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Contracts==<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Direct Debit Orders==<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
==Email and SMS==<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Emailing Module==<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Expense Report==<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Export Module==<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Foundation Module==<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Interventions Module==<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Invoice Module==<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_CHANGE_THIRDPARTY ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
*FACTURE_USE_PROFORMAT ► Enable PROFORMAT invoices type.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► See PDF option<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► See PDF options<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Look or Theme==<br />
*MAIN_FAVICON_URL ► favicon url<br />
*MAIN_OPTIMIZEFORTEXTBROWSER ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
*THEME_ELDY_DISABLE_IMAGE ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
*MAIN_MENU_HIDE_UNAUTHORIZED ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
*THEME_TOPMENU_STICKY_POSITION ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_USE_NEW_TITLE_BUTTON ► (v10.0+) Use new list buttons design<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==MultiCurrency==<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Order Module==<br />
<br />
*COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy extrafields from thirdparty to order. ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==PDF Options==<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*ADD_HTML_FORMATING_INTO_DESC_DOC ► Add more visibility to important informations like reference and serial number in desc. ► (v10.0)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Point of Sale==<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
<br />
TAKEPOS_ROOT_CATEGORY_ID<br />
[[#Top|(back to top)]]<br />
<br />
==Products Module==<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Enable units from dictionary in product/service card.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*PRODUCT_CHARGES ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Projects Module==<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Proposals Module==<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Services Module==<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Shipments==<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Stocks==<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock whatever is user setup<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Suppliers Module==<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Third Parties Module==<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*MAIN_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
*THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==VAT Report==<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==WYSIWYG Editor==<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==For SaaS / Cloud hosting integrators==<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*To avoid bad use of the emailing module, it is recommanded to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: Set here the ip of list of ip where your Dolibarr instances are hosted. So when your customer go into the setup area of email, a message will explain him how to setup its SPF record for its email domain. This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE: If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX: If you offer a customized or patched version of Dolibarr, when the user will use the tool to chek the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team. To have the suggested signature file beeing your own file you can set ths constant to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without beeing disturbed by false alerts due to your customized files or patches (they are included in the signature used for check).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of is subscription and putting a website online may need a complementary subscription.<br />
<br />
*CRON_DISABLE_KEY_CHANGE: When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=44414Setup Other2019-09-27T19:41:57Z<p>John.botella: /* Look or Theme */</p>
<hr />
<div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Paramétrage_Divers]]<br />
[[es:Configuración_Varios]]<br />
[[de:Erweiterte_Einstellungen]]<br />
[[zh:其他设置]]<br />
<!-- END interlang links --><br />
<br />
[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen''': Other setup<br />
<br />
'''Menu Path''': Home ► Setup ► Other<br />
<br />
=Introduction=<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
{{warning|32px}} This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, features in development not stable or that may lead to security risk. For standard usage of Dolibarr, such parameters '''SHOULD NOT''' be used. All hidden options are NOT supported. They may be removed in a future or modified at any version.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to 1 (unless otherwise stated) in <code>Home ► Setup ► Other Setup</code><br />
<br />
=List of Known Hidden Options=<br />
<br />
After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
==Global Options==<br />
<br />
*ADD_UNSPLASH_LOGIN_BACKGROUND ► The background image will be refreshed on every login page refresh. Background image is pulled from the popular open source image website Unsplash. If an already saved static background image exists, then this code will override it (but not delete the saved image). ► (v10.0)<br />
<br />
*MAIN_APPLICATION_TITLE ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
*MAIN_AUTOFILL_DATE ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
*MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
*MAIN_DEFAULT_PAYMENT_TERM_ID ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
*MAIN_DEFAULT_LANGUAGE_FILTER ► Useful if you do not want to show en_US language option in combo boxes (other languages can easily be removed in langs directory but not en_US) ► (v10.0)<br />
<br />
*MAIN_DISABLE_NOTES_TAB ►Show or hide notes tab in the card page<br />
<br />
*MAIN_DISABLE_CONTACTS_TAB ► Show or hide contacts tab in the card page<br />
<br />
*MAIN_DISABLE_FULL_SCANLIST ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 2 000 000 records).<br />
<br />
*MAIN_DISABLE_JQUERY_JNOTIFY ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
*MAIN_DISABLE_AJAX_COMBOX ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to 1 ► (v3.6.0+)<br />
<br />
*MAIN_DISABLE_MULTIPLE_FILEUPLOAD ► Disable users to upload multiple files at once.<br />
*MAIN_DISABLE_TRUNC ► Disable all truncings in select list. (v7.0 and more)<br />
<br />
*MAIN_DISABLEDRAFTSTATUS ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
*MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME ► Add name of thirdparty at begin of generated document.<br />
<br />
*MAIN_DOC_USE_TIMING ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
*MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT ► Disable the auto renaming on upload file ► (v10.0)<br />
<br />
*MAIN_DOL_SCRIPTS_ROOT ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
*MAIN_ENABLE_LOG_TO_HTML ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
*MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
*MAIN_FIRST_TO_UPPER ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
*MAIN_FILESYSTEM_ENCODING ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
*MAIN_FORCELANGDIR ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
*MAIN_HTML_TITLE ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
*MAIN_HELPCENTER_LINKTOUSE ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
*MAIN_LANDING_PAGE ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
*MAIN_LOGOUT_GOTO_URL ► URL to which the user will be redirected after LOGOUT<br />
<br />
*MAIN_MAXTABS_IN_CARD ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
*MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
*MAIN_MODULES_FOR_EXTERNAL ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
*MAIN_NO_CONCAT_DESCRIPTION ► Allow to use only input custom description in lines (propale, order, invoice) ► (v10.0)<br />
<br />
*MAIN_ONLY_LOGIN_ALLOWED ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
*MAIN_OPTIMIZE_SPEED ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.<br />
<br />
*MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
*MAIN_PUBLIC_NOTE_IN_ADDRESS ► Show public note in address block ► (v4.0+)<br />
<br />
*MAIN_REMOVE_INSTALL_WARNING ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
*MAIN_REPEATCONTACTONEACHTAB ► If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
*MAIN_REPLACE_TRANS_xx_XX ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
*MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
*MAIN_SECURITY_CSRF_WITH_TOKEN ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is more powerful. ► (v5.0+)<br />
<br />
*MAIN_SERVER_TZ ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
*MAIN_SEARCH_FORM_ON_HOME_AREAS ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
*MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE ► If only one result is found, then setting this value to 1 will take you direct to the item (default method). Setting the value to 0 will show the result in the list as a single result ► (v5.0+)<br />
<br />
*MAIN_SERVICES_ARE_ECOMMERCE_200238EC ► (< 8)<br />
<br />
*MAIN_SHOW_TUNING_INFO ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
*MAIN_SHOW_TECHNICAL_ID ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
*MAIN_SHOWDATABASENAMEINHELPPAGESLINK ► Show database name in upper help menu ► (v8.0+)<br />
<br />
*MAIN_USE_HOURMIN_IN_DATE_RANGE ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
*MAIN_USE_JQUERY_JEDITABLE ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
*MAIN_USE_JQUERY_MULTISELECT ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
*MAIN_USE_OLD_SEARCH_FORM ► Display the old search form in left menu.<br />
<br />
*MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
*MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS ► Allow to define a default VAT rate<br />
<br />
*MAIN_VIEW_LINE_NUMBER ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
*MAIN_VOLUME_DEFAULT_ROUND ► Accuracy of volume (number of decimals)<br />
<br />
*MAIN_VOLUME_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*MAIN_WEIGHT_DEFAULT_ROUND ► Accuracy of weight (number of decimals)<br />
<br />
*MAIN_WEIGHT_DEFAULT_UNIT ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
*USER_HIDE_INACTIVE_IN_COMBOBOX ► Disable display inactive users in combobox.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Accoutancy Module==<br />
<br />
*ACCOUNTANCY_COMBO_FOR_AUX ► Add graphic option for ACCOUNTANCY_COMBO_FOR_AUX ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Agenda Module==<br />
<br />
*AGENDA_MAX_EVENTS_DAY_VIEW ► Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
<br />
*AGENDA_USE_EVENT_TYPE ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
*AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS ► To automatically set end date of event to start date + delta on event creation page.<br />
*AGENDA_DISABLE_LOCATION ► Disable location field in action card ► (>=v5.0)<br />
<br />
*MAIN_ADD_EVENT_ON_ELEMENT_CARD ► Allow to create an event from a document (proposal, order, invoice)<br />
*AGENDA_ALL_CALENDARS ► Change the default view to calendar for all the Agenda's<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Bank Module==<br />
<br />
*BANK_CAN_RECONCILIATE_CASHACCOUNT ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
*BANK_DISABLE_CHECK_DEPOSIT ► Disable check deposit feature<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_ORDER ► Ask bank account during creation of an order<br />
<br />
*BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL ► Ask bank account during creation of a proposal<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==BlockedLog==<br />
<br />
*BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Contracts==<br />
<br />
*CONTRACT_SUPPORT_PRODUCTS ► Products are also suggested into module contract.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Direct Debit Orders==<br />
<br />
*WITHDRAWAL_ALLOW_ANY_INVOICE_STATUS ► If this option is set, all invoices status (even already paid) may appear on the list of invoices qualified for a direct debit payment. This is the list of invoices with a payment request done, and not linked to a direct debit payment. By default, only "unpayed" invoices are used to avoid to pay twice the same invoice.<br />
<br />
==Email and SMS==<br />
<br />
*MAIN_MAILFORM_DISABLE_ENTERKEY ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
*MAIL_PREFIX_FOR_EMAIL_ID ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
*MAIN_MAIL_DEBUG ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_SMS_DEBUG ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
*MAIN_MAIL_ALLOW_SENDMAIL_F ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
*MAIN_MAIL_SENDMAIL_FORCE_BA ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into <code>php.ini</code> file.<br />
<br />
*MAIN_MAIL_NO_FULL_EMAIL ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
*MAIN_FIX_FOR_BUGGED_MTA ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
*MAIN_MAIL_DO_NOT_USE_SIGN ► Do not add user signature at end of suggested pre-defined email<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_INVOICE ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_ORDER ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.<br />
<br />
*MAIL_FORCE_DELIVERY_RECEIPT_PROPAL ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
*MAIN_EMAIL_USECCC ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
*MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
*MAIN_EMAIL_ADD_TRACK_ID ► When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
*MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
*MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
*MAIN_MAIL_USE_MULTI_PART ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
*MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
*MAIN_COPY_FILE_IN_EVENT_AUTO ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
*MAIN_MAIL_ENABLED_USER_DEST_SELECT ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Emailing Module==<br />
<br />
*MAILING_PREFIX_FOR_EMAIL_ID ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
*MAILING_NO_USING_PHPMAIL ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
<br />
*MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS ► Contains the email of contact to show into the message visible to a user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
<br />
*MAILING_LIMIT_WARNING_PHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is on "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
<br />
*MAILING_LIMIT_WARNING_NOPHPMAIL ► Show a warning message (var contains the '''message to show''', or '''translation key''') on emailing send form if setup is something else than "phpmail". Note: The application always try to translation the message considering the message is a translation key, before showing the translation or message if translation was not found.<br />
*EMAILING_USE_ADVANCED_SELECTOR ► Enable the advanced selector for recipients.<br />
<br />
*MAILING_LIMIT_SENDBYWEB ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
*MAILING_LIMIT_SENDBYCLI ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Expense Report==<br />
<br />
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
*EXPENSEREPORT_USE_OLD_NUMBERING_RULE ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to 1 ► (>=v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_IK ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
*MAIN_USE_EXPENSE_RULE ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
<br />
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Export Module==<br />
<br />
*EXPORT_CSV_SEPARATOR_TO_USE ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
*EXPORT_CSV_FORCE_CHARSET ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
*EXPORTTOOL_CATEGORIES ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
*USE_STRICT_CSV_RULES ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Foundation Module==<br />
<br />
*MEMBER_URL_REDIRECT_SUBSCRIPTION ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
*MEMBER_EXT_URL_SUBSCRIPTION_INFO ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Interventions Module==<br />
<br />
*FICHINTER_CLASSIFY_BILLED► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
*FICHINTER_DISABLE_DETAILS► Disable entry of details line on intervention. Can validate with no line.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Invoice Module==<br />
<br />
*MAIN_DEPOSIT_MULTI_TVA ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
*FACTURE_SHOW_SEND_REMINDER ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_EDITED ► Allow to edit invoices even if payment was started. Note: If the module "BlockedLog" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_ALWAYS_BE_REMOVED ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "BlockedLog" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
*INVOICE_CAN_NEVER_BE_REMOVED ► Never allow to delete invoices (except draft invoices).<br />
<br />
*INVOICE_POSITIVE_CREDIT_NOTE ► All amounts on PDF credit notes are positive.<br />
<br />
*FACTURE_CHANGE_THIRDPARTY ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
*FACTURE_USE_PROFORMAT ► Enable PROFORMAT invoices type.<br />
<br />
*FACTURE_DEPOSITS_ARE_JUST_PAYMENTS ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. WARNING: In a lot of european countries, using this option is not allowed.<br />
<br />
*FACTURE_SENDBYEMAIL_FOR_ALL_STATUS ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
*INVOICE_CREDIT_NOTE_STANDALONE ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
*INVOICE_USE_SITUATION ► Enable the "situation invoice" feature<br />
<br />
*INVOICE_USE_SITUATION_CREDIT_NOTE ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
*INVOICE_DISABLE_DEPOSIT ► Disable deposit invoices<br />
<br />
*INVOICE_DISABLE_REPLACEMENT ► Disable replacement invoices<br />
<br />
*INVOICE_DISABLE_CREDIT_NOTE ► Disable credit notes<br />
<br />
*WORKFLOW_BILL_ON_SHIPMENT ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
*INVOICE_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. Use the tag __DIRECTDOWNLOAD_URL_INVOICE__ in email template to insert it. ► (v7.0+)<br />
<br />
*INVOICE_POINTOFTAX_DATE ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
*FACTURE_ENABLE_NEGATIVE_LINES ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
*INVOICE_USE_DEFAULT_DOCUMENT ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
*FACTURE_REUSE_NOTES_ON_CREATE_FROM ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
*MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST ► Display the reference of credit notes in discount list when creating the bill.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Look or Theme==<br />
<br />
*MAIN_OPTIMIZEFORTEXTBROWSER ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
*THEME_ELDY_DISABLE_IMAGE ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
*MAIN_MENU_HIDE_UNAUTHORIZED ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
*THEME_TOPMENU_STICKY_POSITION ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
*MAIN_EASTER_EGG_COMMITSTRIP ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
*MAIN_STATUS_USES_CSS ► (v10.0+) Change status design using new style<br />
<br />
*MAIN_USE_NEW_TITLE_BUTTON ► (v10.0+) Use new list buttons design<br />
*MAIN_APPLICATION_DISABLED_STATEBOARD ► Hide the stateboard of the main page<br />
*MAIN_APPLICATION_DISABLED_WORKBOARD ► Hide the workboard of the main page<br />
*MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD ► (v11.0+) This conf will auto remove global stats box item if there are already in the new dashboard of opened elements and keep displayed stats on the opened item box (not only on mouse over)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==MultiCurrency==<br />
<br />
*MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION ► Enable CurrencyLayer API synchronization<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Order Module==<br />
<br />
*COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
<br />
*COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
*COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
<br />
*WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER => When an order is created, the warehouse can be defined<br />
<br />
*ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
*THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER => Copy extrafields from thirdparty to order. ► (v11.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==PDF Options==<br />
<br />
*MAIN_DISABLE_FORCE_SAVEAS ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
*MAIN_DISABLE_PDF_COMPRESSION ► Disable PDF compression.<br />
<br />
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.<br />
<br />
*MAIN_DISABLE_PDF_AUTOUPDATE ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
*MAIN_USE_BACKGROUND_ON_PDF ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
*MAIN_ADD_PDF_BACKGROUND ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
*MAIN_PDF_FORCE_FONT ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
*MAIN_PDF_FREETEXT_HEIGHT ► Change height of space reserved to output the free text.<br />
<br />
*MAIN_PDF_TITLE_BACKGROUND_COLOR ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
*MAIN_USE_COMPANY_NAME_OF_CONTACT ► Use contact name and information rather than company<br />
<br />
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
*MAIN_ODT_AS_PDF_DEL_SOURCE ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
*MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
*MAIN_GENERATE_INVOICES_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
*MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
*MAIN_DOCUMENTS_LOGO_HEIGHT ► Can force height of the logo on PDF.<br />
<br />
*MAIN_DOCUMENTS_WITH_PICTURE_WIDTH ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
*MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN ► Hide column with VAT information but only column not total.<br />
<br />
*PDF_SHOW_PROJECT ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
*PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
*PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
*MAIN_PDF_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
*PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME ► Include alternative/alias name into name on PDF.<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
*MAIN_TVAINTRA_IN_SOURCE_ADDRESS ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID1_IN_SOURCE_ADDRESS ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID2_IN_SOURCE_ADDRESS ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID3_IN_SOURCE_ADDRESS ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID4_IN_SOURCE_ADDRESS ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID5_IN_SOURCE_ADDRESS ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*MAIN_PROFID6_IN_SOURCE_ADDRESS ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
*ADD_HTML_FORMATING_INTO_DESC_DOC ► Add more visibility to important informations like reference and serial number in desc. ► (v10.0)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Point of Sale==<br />
<br />
*CASHDESK_SHOW_KEYPAD ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
*POS_ADDON ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Products Module==<br />
<br />
*MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
*PRODUCT_ADD_TYPE_IN_DOCUMENTS ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
*PRODUCT_DONOTSEARCH_ANYWHERE ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
*PRODUIT_DESC_IN_LIST ► Show long description of product/service into lists.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► Enable module Propal merge product PDF<br />
<br />
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
*PRODUCT_USE_UNITS ► Enable units from dictionary in product/service card.<br />
<br />
*PRODUCT_DISABLE_SIZE ► Disable size in product card.<br />
<br />
*PRODUCT_DISABLE_LENGTH ► Disable length in product card ► v4.0+<br />
<br />
*PRODUCT_DISABLE_SURFACE ► Disable surface in product card. ► v4.0+<br />
<br />
*PRODUCT_DISABLE_VOLUME ► Disable volume in product card.<br />
<br />
*PRODUCT_DISABLE_CUSTOM_INFO ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
*PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
*MAIN_DIRECT_STATUS_UPDATE ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
*PRODUCT_CHARGES ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
*PRODUCT_MAX_VISIBLE_PHOTO ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
*PRODUCT_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
*MAIN_DISABLE_FREE_LINES ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
*MAIN_SHOW_PRODUCT_ACTIVITY_TRIM ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
*CATEGORY_GRAPHSTATS_ON_PRODUCTS ► Show graph of products with categories and totals in Products Area screen<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Projects Module==<br />
<br />
*PROJECT_DISABLE_UNLINK_FROM_OVERVIEW ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
*PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
*PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
*PROJECT_SHOW_REF_INTO_LISTS ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
*PROJECT_HIDE_UNSELECTABLES ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
*PROJECT_HIDE_TASKS ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
*PROJECT_LIST_SHOW_STARTDATE ► Shows start date of projects in project lists.<br />
<br />
*PROJECT_LINK_ON_OVERWIEW_DISABLED ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
*PROJECT_CREATE_ON_OVERVIEW_DISABLED ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
*PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY ► Can link an object to a project of another thirdparty<br />
<br />
*PROJECT_ALLOW_COMMENT_ON_TASK ► Add comment feature on project task<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Proposals Module==<br />
<br />
*PROPAL_CLONE_ON_CREATE_PAGE ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
*MAIN_PROPAL_CHOOSE_ODT_DOCUMENT ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
*MAIN_GENERATE_PROPOSALS_WITH_PICTURE ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
*PROPAL_DISABLE_SIGNATURE ► Do no show the box for signature.<br />
<br />
*WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
*PRODUIT_PDF_MERGE_PROPAL ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
*PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Services Module==<br />
<br />
*SERVICE_ARE_ECOMMERCE_200238EC ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Shipments==<br />
<br />
*STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
*SHIPMENT_GETS_ALL_ORDER_PRODUCTS ► Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==Stocks==<br />
<br />
*CASHDESK_FORCE_STOCK_ON_BILL ► Option to force decrease of stock whatever is user setup<br />
<br />
*SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED ► Disable stock dispatch when total expected was already received<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Suppliers Module==<br />
<br />
*FOURN_PRODUCT_AVAILABILITY ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
*RELOAD_PAGE_ON_SUPPLIER_CHANGE ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
*SUPPLIER_ORDER_AUTOADD_USER_CONTACT ► Add user approving supplier order as a contact automatically.<br />
<br />
*SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
*SUPPLIER_ORDER_USE_DISPATCH_STATUS ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
*SUPPLIER_ORDER_NO_DIRECT_APPROVE ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
*SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
*SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
*DISPLAY_DISCOUNTED_SUPPLIER_PRICE ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)<br />
<br />
*MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER ► Allow to change the supplier on a draft supplier order ► (v10.0)<br />
<br />
<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==Third Parties Module==<br />
<br />
*COMPANY_AQUARIUM_CLEAN_REGEX ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
*MAIN_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers<br />
<br />
*SOCIETE_DISABLE_PROSPECTS ► Remove all menu and features related to prospects<br />
<br />
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"<br />
<br />
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
*SOCIETE_SORT_ON_TYPEENT ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
*THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX1 ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_DEFAULT_USELOCALTAX2 ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
*THIRDPARTY_INCLUDE_PARENT_IN_LINKTO ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
*THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
*THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
*THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
*THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card<br />
<br />
[[#Top|(back to top)]]<br />
<br />
==VAT Report==<br />
<br />
*MAIN_INCLUDE_ZERO_VAT_IN_REPORTS ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==WYSIWYG Editor==<br />
<br />
*FCKEDITOR_ENABLE_DETAILS_FULL ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
<br />
[[#Top|(back to top)]]<br />
<br />
<br />
==For SaaS / Cloud hosting integrators==<br />
<br />
The following options are useless for a common usage of Dolibarr. But they are usefull if you plan to host / provide Dolibarr instances as Software As A Service (SAAS) to your customers.<br />
<br />
*To avoid bad use of the emailing module, it is recommanded to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.<br />
<br />
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: Set here the ip of list of ip where your Dolibarr instances are hosted. So when your customer go into the setup area of email, a message will explain him how to setup its SPF record for its email domain. This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.<br />
<br />
*MAIN_ALWAYS_CREATE_LOCK_AFTER_LAST_UPGRADE: If set, when you launch upgrades of your customer instances, you are sure that the upgrade process recreate automatically the file install.lock so the administration tools like install.php and repair.php can't be used on your customer instance (until the lock file is deleted).<br />
<br />
*MAIN_FILECHECK_LOCAL_SUFFIX: If you offer a customized or patched version of Dolibarr, when the user will use the tool to chek the integrity of files, the default xml file name used for signature checking will be the official file provided by the Dolibarr team. To have the suggested signature file beeing your own file you can set ths constant to a suffix. For example, set this to "'''-mysaassolution'''". So, when the user will use the file integrity tool, the default file to check for signature will be "'''/install/filelist-mysaassolution.xml'''" instead of "'''/install/filelist-10.0.2.xml'''". All you have to do is generate the signature file '''mysaassolution''' using the tool '''build/generate_filelist_xml.php''' and put this file into the install directory of your customer instance. Doing this, your customer, and yourself, will be able to check if a file was modified without beeing disturbed by false alerts due to your customized files or patches (they are included in the signature used for check).<br />
<br />
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text to show when the user will use the feature "Deploy" when he want to deploy a website done with Dolibarr CMS. So you can, for example, show him a message that this feature is not part of is subscription and putting a website online may need a complementary subscription.<br />
<br />
*CRON_DISABLE_KEY_CHANGE: When you provide an instance to a customer, you probably also add an entry in the cron of this user so Dolibarr batch and scheduler can work correctly. For security purpose, it may have a security key that is inside the command line into the cron entry and this entry must match the value defined into Dolibarr setup (setup of module 'Scheduled Jobs'). Because, a customer of a Saas platform will probably have no access to edit the cron file, it is also import that he has no way to edit the key into the Dolibarr setup, so the key in the cron command line will always match the key in Dolibarr setup, and the Dolibarr batches will executed without security errors. To be sure, the customer does not change the value, you can set this constant to 1 into the table [[Table_llx_const]].</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=41454Setup Other2019-05-19T20:45:01Z<p>John.botella: /* Look or Theme */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this parameters must not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless otherwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
* '''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox. <br />
<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_PHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_NOPHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
* '''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
<br />
* '''MAIN_STATUS_USES_CSS''' ► (v10.0+) Change status design using new style<br />
<br />
* '''MAIN_USE_NEW_TITLE_BUTTON''' ► (v10.0+) Use new list buttons design<br />
<br />
[[#Top|(back to top)]]<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER''' => When an order is created, the warehouse can be defined<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
* '''SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=41453Setup Other2019-05-19T20:44:30Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this parameters must not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless otherwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
* '''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox. <br />
<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_PHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_NOPHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
* '''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER''' => When an order is created, the warehouse can be defined<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
* '''SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=41452Setup Other2019-05-18T14:13:41Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this parameters must not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless otherwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
* '''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox. <br />
<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
* '''MAIN_STATUS_USES_CSS''' ► (v10.0+) Change status design using new style<br />
<br />
* '''MAIN_USE_NEW_TITLE_BUTTON''' ► (v10.0+) Use new list buttons design<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_PHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_NOPHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
* '''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER''' => When an order is created, the warehouse can be defined<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
* '''SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=41451Setup Other2019-05-18T10:31:37Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page contains the list of advanced hidden parameters. In most cases, it is parameters for development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this parameters must not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless otherwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this feature, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. Consequently this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code> (only for ODT files)<br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
* '''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox. <br />
<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
* '''MAIN_STATUS_USES_CSS''' ► (v10.0+) Change status design using new style<br />
<br />
<br />
[[#Top|(back to top)]]<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option asks PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipient when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it appears in the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_PHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>(MAILING_LIMIT_WARNING_NOPHPMAIL)</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard-coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front of payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required in some countries for legal reasons), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the read-only archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► Allow user to select a default invoice documents models according to invoice type. On invoice create page, the model is dynamically changed on invoice type selection. ► (v9.0+)<br />
<br />
* '''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (useful for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not authorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''WAREHOUSE_ASK_WAREHOUSE_DURING_ORDER''' => When an order is created, the warehouse can be defined<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser always asks to save downloaded files on disk (like PDF), try this this option. File may be displayed directly in your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared!<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.<br />
Default (constant not set or Value <code>0</code>): Internal ref followed by supplier ref in brackets."COMPANY-REF-001 (Vendor SKU SUPPLIER-REF-001) - LABEL...".<br />
<br />
Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".<br />
<br />
Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier order to only those with a buying price defined for that supplier. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
<br />
* '''SUPPLIER_PROPOSAL_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier proposal to only those with a buying price defined for that supplier. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It applies a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranteed with this. Also if the image is removed or renamed by the image hosting service, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=40651Setup Other2019-01-10T08:04:46Z<p>John.botella: /* Invoice Module */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless othwerwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page ► (core)<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page ► (core)<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT ► (core)<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. So this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code><br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
[[#Top|(back to top)]]<br />
----<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it will appears into the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_PHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_NOPHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for destinaries<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (it's work with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► This new configurations allow user to select à default invoice documents models according to invoice type. On invoice create page, the model is dynamicaly change on invoice type selection. ► (v9.0+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (usefull for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not autorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared !<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Value <code>1</code> or <code>2</code> change the way product ref is show (<code>1</code> = show supplier ref only and not internal ref, <code>2</code> = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into Point of Sale.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_NOPRICEDEFINED''' ► Can enter a product even if no supplier price defined. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It apply a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''MAIN_THIRDPARTY_CREATION_INDIVIDUAL''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v<5.0)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=40650Setup Other2019-01-10T08:04:32Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless othwerwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page ► (core)<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page ► (core)<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT ► (core)<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. So this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code><br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
[[#Top|(back to top)]]<br />
----<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it will appears into the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_PHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_NOPHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for destinaries<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (it's work with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (usefull for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not autorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared !<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Value <code>1</code> or <code>2</code> change the way product ref is show (<code>1</code> = show supplier ref only and not internal ref, <code>2</code> = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into Point of Sale.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_NOPRICEDEFINED''' ► Can enter a product even if no supplier price defined. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It apply a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''MAIN_THIRDPARTY_CREATION_INDIVIDUAL''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v<5.0)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=40649Setup Other2019-01-10T08:04:11Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help About Screen:''' Other setup<br />
<br />
'''Menu Path:''' Home ► Setup ► Other<br />
<br />
= '''Goal''' =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= '''Reading the List''' =<br />
After Global Options, this list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:<br />
<br />
'''HIDDEN_CONFIG''' ► ''Description of config'' ► ''(specific version information) or values''<br />
<br />
= '''List of Known Hidden Options''' =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' (unless othwerwise stated) in <code>Home ► Setup -> Other Setup</code><br />
<br />
<br />
== '''Global Options''' ==<br />
<br />
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page ► (core)<br />
<br />
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page ► (core)<br />
<br />
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT ► (core)<br />
<br />
* '''MAIN_FILESYSTEM_ENCODING''' ► With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on Linux or OSX system, and ISO-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".<br />
<br />
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.<br />
<br />
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* '''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful. ► (v5.0+)<br />
<br />
* '''MAIN_APPLICATION_TITLE''' ► This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* '''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports! However some users want it, so we provide it.<br />
<br />
* '''MAIN_DISABLE_FULL_SCANLIST''' ► Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* '''MAIN_FIRST_TO_UPPER''' ► Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* '''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* '''MAIN_USE_HOURMIN_IN_DATE_RANGE''' ► On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* '''MAIN_REMOVE_INSTALL_WARNING''' ► Remove all security warnings that appear to administrator users if URL <code>/install</code> is public. You should solve the problem if warning occurs, instead of removing the warning! For this, create a file called <code>install.lock</code> into Dolibarr root directory. This will stop the warning but also make the page <code>/install</code> not possible to use, to protect your installation.<br />
<br />
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* '''MAIN_REPLACE_TRANS_xx_XX''' ► Where <code>xx_XX</code> is language code. If value is <code>string1:newstring1;string2:newstring2</code> then replace <code>string1</code> with <code>newstring1</code> in all translation done for language <code>xx_XX</code>.<br />
<br />
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.<br />
<br />
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages<br />
<br />
* '''MAIN_USE_JQUERY_JEDITABLE''' ► Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. So this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* '''MAIN_USE_JQUERY_MULTISELECT''' ► Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* '''MAIN_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page<br />
<br />
* '''MAIN_MODULES_FOR_EXTERNAL''' ► Limit available modules for external users. By default value is '<code>facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda</code>'<br />
<br />
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)<br />
<br />
* '''MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING''' ► A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* '''MAIN_DISABLE_AJAX_COMBOX''' ► If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting this constant to '''1''' ► (v3.6.0+)<br />
<br />
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.<br />
<br />
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate<br />
<br />
* '''MAIN_HTML_TITLE''' ► Can be used to control how the html page title is formatted. If value contains key '<code>noapp</code>', application name will not be output. If value contains '<code>thirdpartynameonly</code>', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: '<code>noapp;thirdpartynameonly</code>'<br />
<br />
* '''MAIN_LANDING_PAGE''' ► Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param). ► (v3.9+)<br />
<br />
* '''MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN''' ► When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible. ► (v4.0+)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)<br />
<br />
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)<br />
<br />
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)<br />
<br />
* '''MAIN_DEFAULT_PAYMENT_TERM_ID''' ► With ID of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.<br />
<br />
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.<br />
<br />
* '''MAIN_DOC_USE_TIMING''' ► Add a timestamp at end of generated document. Value must be format of timestamp. For example: <code>%Y%m%d%H%M</code><br />
<br />
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.<br />
<br />
* '''MAIN_SERVER_TZ''' ► If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : <code>Europe/Paris</code>, <code>auto</code>.<br />
<br />
* '''MAIN_SEARCH_FORM_ON_HOME_AREAS''' ► Show the search form on home page areas for core modules (Removed after v5 due to global search combo) ► (v6.0+)<br />
<br />
* '''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result ► (v5.0+)<br />
<br />
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)<br />
<br />
* '''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community) ► (v7.0+)<br />
<br />
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)<br />
<br />
* '''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.<br />
<br />
* '''INVOICE_USE_DEFAULT_DOCUMENT''' ► This new configurations allow user to select à default invoice documents models according to invoice type. On invoice create page, the model is dynamicaly change on invoice type selection. ► (v9.0+)<br />
<br />
[[#Top|(back to top)]]<br />
----<br />
<br />
== '''Agenda Module''' ==<br />
* '''AGENDA_MAX_EVENTS_DAY_VIEW''' ► Define the maximum number of visible entries for each day in agenda. Default value is '''3'''. Value '''0''' means no limit.<br />
<br />
* '''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event (deprecated).<br />
<br />
* '''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.<br />
<br />
* '''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Bank Module''' ==<br />
* '''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)<br />
<br />
* '''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order<br />
<br />
* '''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''BlockedLog''' ==<br />
* '''BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY''' ► Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Contracts''' ==<br />
* '''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Email and SMS''' ==<br />
* '''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)<br />
<br />
* '''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)<br />
<br />
* '''MAIN_MAIL_DEBUG''' ► Write content with header of last mail into file <code>dolibarr_mail.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.<br />
<br />
* '''MAIN_MAIL_ALLOW_SENDMAIL_F''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option <code>-f</code>. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option <code>-f</code>. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* '''MAIN_MAIL_SENDMAIL_FORCE_BA''' ► On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''<code>php.ini</code>''' file.<br />
<br />
* '''MAIN_MAIL_NO_FULL_EMAIL''' ► Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* '''MAIN_FIX_FOR_BUGGED_MTA''' ► Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of <code>orange.fr</code> or <code>hotmail.com</code><br />
<br />
* '''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* '''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* '''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* '''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''' ► Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting '''MAIN_EMAIL_USECCC''' (to 1 or to another email, see previous point)<br />
<br />
* '''MAIN_EMAIL_ADD_TRACK_ID''' ► When value is '''1''' (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is '''2''': you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► Restrict sending of 1 email message to <code>x</code> recipients for same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include 1000 recipients in 1 message. Note that '''MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL''', '''MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL''' and '''MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL''' are also available.<br />
<br />
* '''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* '''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+<br />
<br />
* '''MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS''' ► If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* '''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)<br />
<br />
* '''MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS''' ► Enter the public IP address of the server, so it will appears into the help on the email setup page.<br />
<br />
* '''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Emailing Module''' ==<br />
* '''MAILING_PREFIX_FOR_EMAIL_ID''' ► Set the value that will be used to compose the "Email ID" into email headers. If you set this value to '<code>SERVER_NAME</code>', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
<br />
* '''MAILING_NO_USING_PHPMAIL''' ► If set, the module emailing can't be used with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''.<br />
<br />
* '''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS''' ► Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option '''MAILING_NO_USING_PHPMAIL''' is set to on.<br />
<br />
* '''MAILING_LIMIT_WARNING_PHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_PHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''MAILING_LIMIT_WARNING_NOPHPMAIL''' ► Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to <code>MAILING_LIMIT_WARNING_NOPHPMAIL</code> and enter translation key for each language for this key.<br />
<br />
* '''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for destinaries<br />
<br />
* '''MAILING_LIMIT_SENDBYWEB''' ► Restrict number of emails you can send in same sending session with emailing module from GUI. The value "<code>dolibarr_mailing_limit_sendbyweb</code>" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
<br />
* '''MAILING_LIMIT_SENDBYCLI''' ► Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "<code>dolibarr_mailing_limit_sendbycli</code>" if defined into config file is used in priority for this limit.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Expense Report''' ==<br />
* '''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)<br />
<br />
* '''EXPENSEREPORT_USE_OLD_NUMBERING_RULE''' ► The module Expense Report use numbering rules that you can setup (like other modules do). If you need to keep the hard coded numbering rule of expenses report used in v6.0 set this constant to '''1''' ► (>=v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)<br />
<br />
* '''MAIN_USE_EXPENSE_RULE''' ► This feature allows you to set a variety of rules per user/group/all so they can only create reports within their limits. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Export Module''' ==<br />
* '''EXPORT_CSV_SEPARATOR_TO_USE''' ► String value to use as default separator to delimit fields of exported files (by default Dolibarr uses "<code>,</code>"). Example: EXPORT_CSV_SEPARATOR_TO_USE=<code>;</code><br />
<br />
* '''EXPORT_CSV_FORCE_CHARSET''' ► Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= <code>utf-8</code><br />
<br />
* '''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"<br />
<br />
* '''USE_STRICT_CSV_RULES''' ► Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (<code>"</code>).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Foundation Module''' ==<br />
* '''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.<br />
<br />
* '''MEMBER_EXT_URL_SUBSCRIPTION_INFO''' ► Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Interventions Module''' ==<br />
* '''FICHINTER_CLASSIFY_BILLED'''► Allow to classify an intervention card as "Billed". This add also trigger <code>FICHINTER_CLASSIFY_BILLED</code> into list of possible automatic event into agenda.<br />
<br />
* '''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Invoice Module''' ==<br />
* '''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)<br />
<br />
* '''FACTURE_SHOW_SEND_REMINDER''' ► Show link "Send reminder by mail", same feature than "Send by mail" ''(obsolete feature)''.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_EDITED''' ► Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_ALWAYS_BE_REMOVED''' ► Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
<br />
* '''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).<br />
<br />
* '''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.<br />
<br />
* '''FACTURE_CHANGE_THIRDPARTY''' ► Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
<br />
* '''FACTURE_USE_PROFORMAT''' ► Enable PROFORMAT invoices type.<br />
<br />
* '''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
<br />
* '''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (it's work with crabe template)<br />
<br />
* '''INVOICE_CREDIT_NOTE_STANDALONE''' ► Can make a credit note without invoice. ► (v3.9)<br />
<br />
* '''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature<br />
<br />
* '''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)<br />
<br />
* '''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices<br />
<br />
* '''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices<br />
<br />
* '''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes<br />
<br />
* '''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments<br />
<br />
* '''INVOICE_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)<br />
<br />
* '''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)<br />
[[#Top|(back to top)]]<br />
<br />
== '''Look or Theme''' ==<br />
* '''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimize output rendering for usage of a text browser (usefull for blind people)<br />
<br />
* '''THEME_ELDY_DISABLE_IMAGE''' ► Disabled images of top menu for eldy theme. ► (v3.8+)<br />
<br />
* '''MAIN_MENU_HIDE_UNAUTHORIZED''' ► Hide menu if logged in user is not autorized rather than just grey them<br />
<br />
* '''THEME_TOPMENU_STICKY_POSITION''' ► Option to fix top menu with eldy theme ► (v7.0+)<br />
<br />
* '''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''MultiCurrency''' ==<br />
* '''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Order Module''' ==<br />
* '''COMMANDE_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.<br />
<br />
* '''COMMANDE_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
<br />
* '''COMMANDE_CHANGE_THIRDPARTY''' => Can change customer on orders<br />
<br />
* '''ORDER_ALLOW_EXTERNAL_DOWNLOAD''' => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''PDF Options''' ==<br />
* '''MAIN_DISABLE_FORCE_SAVEAS''' ► If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* '''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.<br />
<br />
* '''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF.<br />
<br />
* '''MAIN_DISABLE_PDF_AUTOUPDATE''' ► Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* '''MAIN_USE_BACKGROUND_ON_PDF''' ► Define this constant with short name of an image (example "<code>myimage.jpg</code>") that must be saved into directory "<code>documents/mycompany/logos</code>". This will add this background image into your generated PDF files. Warning: This option make TCPDF library being crazy sometime and content on image disappeared !<br />
<br />
* '''MAIN_ADD_PDF_BACKGROUND''' ► Define this constant with short name of a PDF file (example "<code>mypdf.pdf</code>") that must be saved into directory "<code>documents/mycompany</code>". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* '''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".<br />
<br />
* '''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.<br />
<br />
* '''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code><br />
<br />
* '''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company<br />
<br />
* '''MAIN_ODT_AS_PDF''' ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', java and jodconverter command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then java and the jodconvertar jar must exist. Soffice must also be available. <code>MAIN_DOL_SCRIPTS_ROOT</code> Must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>).<br />
<br />
* '''MAIN_ODT_AS_PDF_DEL_SOURCE''' ► For ODT generation. If set, then initial behaviour is conserved but ODT file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* '''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* '''MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier proposals ► (v5.0.3+)<br />
<br />
* '''MAIN_DOCUMENTS_LOGO_HEIGHT''' ► Can force height of the logo on PDF.<br />
<br />
* '''MAIN_DOCUMENTS_WITH_PICTURE_WIDTH''' ► Can change size of picture when hidden option <code>MAIN_GENERATE_PROPOSALS_WITH_PICTURE</code> is used. By default value is <code>20</code>.<br />
<br />
* '''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.<br />
<br />
* '''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* '''PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN''' ► Hide bank number ("code banque/guichet/compte" for France, "sort code/account number" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* '''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Value <code>1</code> or <code>2</code> change the way product ref is show (<code>1</code> = show supplier ref only and not internal ref, <code>2</code> = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* '''MAIN_PDF_ADDALSOTARGETDETAILS''' ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* '''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)<br />
<br />
* '''MAIN_TVAINTRA_IN_SOURCE_ADDRESS''' ► Show VAT N° in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
<br />
* '''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Point of Sale''' ==<br />
* '''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into Point of Sale.<br />
<br />
* '''POS_ADDON''' ► Set this value to an existing numbering module rule (for example '<code>mod_facture_terre</code>', '<code>mod_facture_mars</code>', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value <code>POS_ADDON</code> to '<code>mod_facture_terre</code>' will use the numbering module '<code>terre</code>' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use '''POS_NUMBERING_TERRE_FORCE_PREFIX''' and '''POS_NUMBERING_MARS_FORCE_PREFIX''' variable to change the prefix used).<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Products Module''' ==<br />
* '''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
<br />
* '''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
<br />
* '''PRODUCT_DONOTSEARCH_ANYWHERE''' ► When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
<br />
* '''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF<br />
<br />
* '''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
<br />
* '''PRODUCT_USE_UNITS''' ► Enable units from dictionary in product/service card.<br />
<br />
* '''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.<br />
<br />
* '''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► v4.0+<br />
<br />
* '''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.<br />
<br />
* '''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.<br />
<br />
* '''PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL''' ► When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
<br />
* '''MAIN_DIRECT_STATUS_UPDATE''' ► Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. ► v4.0+<br />
<br />
* '''PRODUCT_CHARGES''' ► Adds an extra field for adhoc charges at the product buying price stage. The cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product. ► (<= v7.0)<br />
<br />
* '''PRODUCT_MAX_VISIBLE_PHOTO''' ► Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '<code>5</code>' will show the first five product photos found on the product card.<br />
<br />
* '''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
<br />
* '''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)<br />
<br />
* '''MAIN_SHOW_PRODUCT_ACTIVITY_TRIM''' ► Show Product and Services turnover before for all four quarters tax over recent years recent years on the product area ► (v5.0+)<br />
<br />
* '''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen<br />
[[#Top|(back to top)]]<br />
<br />
== '''Projects Module''' ==<br />
* '''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= 8.0.1)<br />
<br />
* '''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
<br />
* '''PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS''' ► Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
<br />
* '''PROJECT_SHOW_REF_INTO_LISTS''' ► Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
<br />
* '''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)<br />
<br />
* '''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.<br />
<br />
* '''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.<br />
<br />
* '''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (4.0)<br />
<br />
* '''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (4.0)<br />
<br />
* '''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty<br />
<br />
* '''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Proposals Module''' ==<br />
* '''PROPAL_CLONE_ON_CREATE_PAGE''' ► On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
<br />
* '''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
<br />
* '''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
<br />
* '''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.<br />
<br />
* '''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
<br />
* '''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
<br />
* '''PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD''' ► When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. ► (v7.0+)<br />
<br />
* '''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Services Module''' ==<br />
* '''SERVICE_ARE_ECOMMERCE_200238EC''' ► If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Shipments''' ==<br />
* '''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)<br />
<br />
* '''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Stocks''' ==<br />
* '''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► (< 8)<br />
<br />
* '''CASHDESK_FORCE_STOCK_ON_BILL''' => Option to force decrease of stock whatever is user setup. ► (>= 8.0.1)<br />
<br />
* '''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Suppliers Module''' ==<br />
* '''FOURN_PRODUCT_AVAILABILITY''' ► On the Suppliers price page of the products, activate the supplier product availability. ''This is duplicate feature with delivery_delay introduced with 3.8.''<br />
<br />
* '''RELOAD_PAGE_ON_SUPPLIER_CHANGE''' ► On creation of a supplier order/invoice, reload form with supplier-specific details when supplier is selected from drop-down list.<br />
<br />
* '''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.<br />
<br />
* '''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).<br />
<br />
* '''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)<br />
<br />
* '''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
<br />
* '''SUPPLIER_ORDER_WITH_NOPRICEDEFINED''' ► Can enter a product even if no supplier price defined. ► (v6.0+)<br />
<br />
* '''SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT''' ► Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. ► (v6.0+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''Third Parties Module''' ==<br />
* '''COMPANY_AQUARIUM_CLEAN_REGEX''' ► Add a REGEX rule on the third parties names. It apply a regex replacement pattern on generated code if COMPANY_AQUARIUM_CLEAN_REGEX is set. Value must be a regex with parenthesis. The part into parenthesis is kept, the rest removed. For example if COMPANY_AQUARIUM_CLEAN_REGEX = '<code>^..(..)..(.*)</code>' the first char and second char are removed and the char 5 and 6 too ► (>= 8.0.1)<br />
<br />
* '''MAIN_FORCE_DEFAULT_STATE_ID''' ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)<br />
<br />
* '''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers<br />
<br />
* '''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects<br />
<br />
* '''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"<br />
<br />
* '''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''THIRDPARTY_NOTSUPPLIER_BY_DEFAULT''' ► Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
<br />
* '''SOCIETE_SORT_ON_TYPEENT''' ► The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
<br />
* '''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v5.0+)<br />
<br />
* '''MAIN_THIRDPARTY_CREATION_INDIVIDUAL''' ► With this setting as '''1''' the option is set for third parties to be created WITH the child contact ► (v<5.0)<br />
<br />
* '''THIRDPARTY_DEFAULT_USEVAT''' ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX1''' ► When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_DEFAULT_USELOCALTAX2''' ► When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
<br />
* '''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.<br />
<br />
* '''THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO''' ► Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
<br />
* '''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation<br />
<br />
* '''THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD''' ► When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
<br />
* '''MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL''' ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
* '''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''VAT Report''' ==<br />
* '''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)<br />
[[#Top|(back to top)]]<br />
<br />
<br />
== '''WYSIWYG Editor''' ==<br />
* '''FCKEDITOR_ENABLE_DETAILS_FULL''' ► Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
[[#Top|(back to top)]]</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=39823Setup Other2018-09-25T07:19:41Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help about screen:''' Other setup<br />
<br />
'''Menu path:''' Home -> Setup -> Other<br />
<br />
= Goal =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= List of Known Hidden Options =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable/override a parameter you have to define the constant name and set it to '''1''' in '''Home -> Setup -> Other Setup''': <br />
<br />
== Global Options ==<br />
<br />
* MAIN_LOGOUT_GOTO_URL => (core) url to which the user will be redirected after LOGOUT.<br />
<br />
* MAIN_FILESYSTEM_ENCODING => With some PHP versions, PHP is not able to detect the page code for filesystem of the server OS. To solve this, Dolibarr assumes your OS filesystem is UTF-8 if on linux or osx system, and iso-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable MAIN_FILESYSTEM_ENCODING to "utf-8".<br />
<br />
* MAIN_SHOW_TECHNICAL_ID => Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* MAIN_MAXTABS_IN_CARD => Max number of tabs visible. Others are grouped into a combo list.<br />
<br />
* MAIN_ONLY_LOGIN_ALLOWED => Only the specified login is allowed to log in Dolibarr (maintenance mode).<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES => Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES => Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* MAIN_SECURITY_CSRF_WITH_TOKEN (>= 5.0) => Activate a second anti CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful.<br />
<br />
* MAIN_APPLICATION_TITLE => This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fail by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* MAIN_AUTOFILL_DATE => If this constant is defined (to something other than 0), the date of invoice, proposal, order or payment are auto-filled with the current date. It is highly recommended to NOT ENABLE this feature. This can create a lot of input errors with data not validated by users. This leads to incorrect values saved in the database causing confusion when you have to do your accountancy reports ! However some users want it, so we provide it.<br />
<br />
* MAIN_DISABLE_FULL_SCANLIST => Disables the complete scan of tables to allow the pagination to show total number of pages. May be useful to activate on systems with a very high quantity of data (tables with more than 500 000 records).<br />
<br />
* MAIN_FIRST_TO_UPPER => Dolibarr add uppercase to Third Parties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* MAIN_ENABLE_LOG_TO_HTML (MAIN_LOGTOHTML before 3.9) => If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* MAIN_USE_HOURMIN_IN_DATE_RANGE => On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* MAIN_REMOVE_INSTALL_WARNING => Remove all security warnings that appear to administrator users if URL /install is public. You should solve the problem if warning occurs, instead of removing the warning! For this, put a file called install.lock into Dolibarr root directory. This will stop the warning but also make the page /install not possible to use, to protect your installation.<br />
<br />
* MAIN_OPTIMIZE_SPEED => Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* MAIN_REPLACE_TRANS_xx_XX => Where xx_XX is language code. If value is string1:newstring1;string2:newstring2 then replace string1 with newstring1 in all translation done for language xx_XX.<br />
<br />
* MAIN_REPEATCONTACTONEACHTAB => If added and set to 1, this adds contacts on all tabs, not only main tab.<br />
<br />
* MAIN_DISABLE_JQUERY_JNOTIFY => Disable usage of JNotify to show confirm or error messages<br />
<br />
* MAIN_USE_JQUERY_JEDITABLE => Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because, it bypasses some business actions (updates on other data that should be done consistently) and ignores business controls on data you saved. So this feature breaks consistency of data and possibly the stability of the software.<br />
<br />
* MAIN_USE_JQUERY_MULTISELECT => Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* MAIN_HELPCENTER_LINKTOUSE => Define the url link to use as the target page for link "I need help" onto logon page<br />
<br />
* MAIN_MODULES_FOR_EXTERNAL => Limit available modules for external users. By default value is 'facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda'<br />
<br />
* MAIN_SHOW_TUNING_INFO => Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* MAIN_DOL_SCRIPTS_ROOT => Define directory who contains 'scripts' directory (e.g /var/www/dolibarr)<br />
<br />
* MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING => A warning saying setup of modules is not complete is shown if the number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE => Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* MAIN_DISABLE_AJAX_COMBOX => If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting constant MAIN_DISABLE_AJAX_COMBOX to 1 into Home-Setup-Other (with Dolibarr v3.6.0+).<br />
<br />
* MAIN_USE_CACHE_MANIFEST => Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* MAIN_FORCELANGDIR => relative path of the directory holding your custom langs folder.<br />
<br />
* MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS => allow to define a default VAT rate<br />
<br />
* MAIN_HTML_TITLE => can be used to control how the html page title is formatted. If value contains key 'noapp', application name will not be output. If value contains 'thirdpartynameonly', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: 'noapp;thirdpartynameonly'<br />
<br />
* MAIN_LANDING_PAGE => (>= 3.9). Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param).<br />
<br />
* MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN => (>= 4.0) When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible.<br />
<br />
* MAIN_WEIGHT_DEFAULT_ROUND => Accuracy of weight (number of decimals)<br />
<br />
* MAIN_WEIGHT_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_VOLUME_DEFAULT_ROUND => Accuracy of volume (number of decimals)<br />
<br />
* MAIN_VOLUME_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_PUBLIC_NOTE_IN_ADDRESS >=4.0 => show public note in address block<br />
<br />
* MAIN_DEFAULT_PAYMENT_TERM_ID => With id of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND => Change way of rounding total TTC lines, rounding first of after<br />
<br />
* MAIN_VIEW_LINE_NUMBER => Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME => Add name of thirdparty at begin of generated document<br />
<br />
* MAIN_DOC_USE_TIMING => Add a timestamp at end of generated document. Value must be format of timestamp. For example: %Y%m%d%H%M<br />
<br />
* MAIN_DISABLEDRAFTSTATUS => Disable the status Draft for some objects (project, donation, ...)<br />
<br />
* MAIN_USE_OLD_SEARCH_FORM => Display the old search form in left menu.<br />
<br />
* MAIN_SERVER_TZ => If you can't set the timezone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : Europe/Paris, auto.<br />
<br />
* MAIN_SEARCH_FORM_ON_HOME_AREAS => Show the search form on home page areas for core modules (Removed after v5 due to global search combo) (v6.0+)<br />
<br />
* MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE => If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result (v5.0+)<br />
<br />
* MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES (dolibarr 8.0) => Allow to import lines into current document from "linked" compatible documents<br />
<br />
* MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC (dolibarr 7.0) => Allow using product VAT if customer is individual and out of E.E.C. (European Economic Community)<br />
<br />
== Look or Theme ==<br />
* MAIN_OPTIMIZEFORTEXTBROWSER => Optimize output rendering for usage of a text browser (usefull for blind people)<br />
* THEME_ELDY_DISABLE_IMAGE => Disabled images of top menu for eldy theme.<br />
* MAIN_MENU_HIDE_UNAUTHORIZED => Hide menu if logged in user is not autorized rather than just grey them<br />
* THEME_TOPMENU_STICKY_POSITION => Option to fix top menu with eldy theme (hidden conf)(v7.0+)<br />
<br />
== Email and SMS ==<br />
<br />
* MAIN_MAILFORM_DISABLE_ENTERKEY (>= 8.0.1) => Activate javascript code to disable the enter key in the MAIL form.<br />
<br />
* MAIL_PREFIX_FOR_EMAIL_ID (>= 8.0.1) => Prefix for the mails ID. Default value is $_SERVER["SERVER_NAME"]<br />
<br />
* MAIN_MAIL_DEBUG => Write content with header of last mail into file dolibarr_mail.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_SMS_DEBUG => Write content of SMS sent into file dolibarr_sms.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_MAIL_ALLOW_SENDMAIL_F => On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option -f. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option -f. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* MAIN_MAIL_SENDMAIL_FORCE_BA => On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''php.ini''' file.<br />
<br />
* MAIN_MAIL_NO_FULL_EMAIL => Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* MAIN_FIX_FOR_BUGGED_MTA => Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of orange.fr or hotmail.com<br />
<br />
* MAIN_MAIL_DO_NOT_USE_SIGN => Do not add user signature at end of suggested pre-defined email<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_INVOICE => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_ORDER => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_PROPAL => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* MAIN_EMAIL_USECCC => 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO => Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
* MAIN_EMAIL_ADD_TRACK_ID => When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL => Restrict sending of 1 email message to x recipients for same email message (x for To: + CC: + BCC:). If not defined, value is 10. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
* MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML => Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* MAIN_MAIL_USE_MULTI_PART => Forge email content using an alternate text part (for 5.0.2+). By default with 6.0+<br />
<br />
* MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS => If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* MAIN_COPY_FILE_IN_EVENT_AUTO => Add attachement document on event auto generated by sending email from dolibarr. (v6.0+)<br />
<br />
* MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS => Enter the public ip address of the server, so it will appears into the help on the email setup page.<br />
<br />
* MAIN_MAIL_ENABLED_USER_DEST_SELECT => Show also internal users into list of recipients of email in email sending form (v8.0+)<br />
<br />
== Third Parties module ==<br />
<br />
* COMPANY_AQUARIUM_CLEAN_REGEX (>= 8.0.1) => Add a REGEX rule on the third parties names.<br />
* MAIN_FORCE_DEFAULT_STATE_ID (>= 8.0.1) => Enables to force the selection of a country / province / county from a country specifying IDs<br />
* SOCIETE_DISABLE_CUSTOMERS => Remove all menu and features related to customers<br />
* SOCIETE_DISABLE_PROSPECTS => Remove all menu and features related to prospects<br />
* SOCIETE_DISABLE_STATE => Do not use field "state/province"<br />
* THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT => Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
* THIRDPARTY_NOTSUPPLIER_BY_DEFAULT => Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
* SOCIETE_SORT_ON_TYPEENT = The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
* THIRDPARTY_DEFAULT_CREATE_CONTACT (Dolibarr 5.0+) => Default Third party create are individual<br />
* MAIN_THIRDPARTY_CREATION_INDIVIDUAL (Dolibarr <5.0) => Default Third party create are individual<br />
* THIRDPARTY_DEFAULT_USEVAT => When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX1 => When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX2 => When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_INCLUDE_PARENT_IN_LINKTO => Search also for elements on parent third party when using the "link to" object feature.<br />
* THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO => Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
* SOCIETE_ASK_FOR_SHIPPING_METHOD => Shipping method can be predefined on customer card and will be used as default on order creation<br />
* THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD => When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
* MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL => External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
== Proposals module ==<br />
* PROPAL_CLONE_ON_CREATE_PAGE => On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
* MAIN_PROPAL_CHOOSE_ODT_DOCUMENT => On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
* PROPAL_DISABLE_SIGNATURE => Do no show the box for signature.<br />
* WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES => Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
* PRODUIT_PDF_MERGE_PROPAL => When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
* PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== Order module ==<br />
* COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
* COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
* COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
* ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Invoice module ==<br />
* MAIN_DEPOSIT_MULTI_TVA => In deposits invoice, creates one line per VAT rate from the origin document (6.0)<br />
* FACTURE_SHOW_SEND_REMINDER => Show link "Send reminder by mail", same feature than "Send by mail" (obsolete feature).<br />
* INVOICE_CAN_ALWAYS_BE_EDITED => Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_ALWAYS_BE_REMOVED => Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_NEVER_BE_REMOVED => Never allow to delete invoices (except draft invoices).<br />
* INVOICE_POSITIVE_CREDIT_NOTE => All amounts on PDF credit notes are positive.<br />
* FACTURE_CHANGE_THIRDPARTY => Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
* FACTURE_USE_PROFORMAT => Enable PROFORMAT invoices type.<br />
* FACTURE_DEPOSITS_ARE_JUST_PAYMENTS => Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
* FACTURE_SENDBYEMAIL_FOR_ALL_STATUS => Can send invoice by email to customer even if invoice has status "draft".<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT => Disable VAT on genrated documents. like for an association. (it's work with crabe template)<br />
* INVOICE_CREDIT_NOTE_STANDALONE (dolibarr 3.9) => Can make a credit note without invoice.<br />
* INVOICE_USE_SITUATION = Enable the "situation invoice" feature<br />
* INVOICE_USE_SITUATION_CREDIT_NOTE (dolibarr 8.0) = Enable the "situation credit note" feature (need INVOICE_USE_SITUATION)<br />
* INVOICE_DISABLE_DEPOSIT = Disable deposit invoices<br />
* INVOICE_DISABLE_REPLACEMENT = Disable replacement invoices<br />
* INVOICE_DISABLE_CREDIT_NOTE = Disable credit notes<br />
* WORKFLOW_BILL_ON_SHIPMENT = Change label of button with suitable label when you need to create invoice on shipments<br />
* INVOICE_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Expense Report ==<br />
* EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS => Can enter several expense reports on same or overlapping date periods. (v7.0+)<br />
<br />
== Export module ==<br />
* EXPORT_CSV_SEPARATOR_TO_USE => String value to use as default separator to delimit fields of exported files (by default Dolibarr uses ","). Example: EXPORT_CSV_SEPARATOR_TO_USE=;<br />
* EXPORT_CSV_FORCE_CHARSET => Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= utf-8<br />
* EXPORTTOOL_CATEGORIES => Can export categories (several lines) into one column with the "product export profile"<br />
* USE_STRICT_CSV_RULES => Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (").<br />
<br />
== Agenda module ==<br />
* AGENDA_MAX_EVENTS_DAY_VIEW => Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
* AGENDA_USE_EVENT_TYPE => Add a mandatory field "Type" when creating an event (deprecated).<br />
* AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS => To automatically set end date of event to start date + delta on event creation page.<br />
* MAIN_ADD_EVENT_ON_ELEMENT_CARD => Allow to create an event from a document (proposal, order, invoice)<br />
<br />
== Products module ==<br />
* MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE => Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
* PRODUCT_ADD_TYPE_IN_DOCUMENTS => Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
* PRODUCT_DONOTSEARCH_ANYWHERE => When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
* PRODUIT_DESC_IN_LIST => Show long description of product/service into lists.<br />
* PRODUIT_PDF_MERGE_PROPAL => Enable module Propal merge product PDF<br />
* PRODUCT_USE_OLD_PATH_FOR_PHOTO => Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
* PRODUCT_USE_UNITS => Enable units from dictionary in product/service card.<br />
* PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL => When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
* MAIN_DIRECT_STATUS_UPDATE => Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. v4.0+<br />
<br />
* PRODUCT_CHARGES => Adds an extra field for adhoc charges at the product buying price stage. The Cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product.<br />
<br />
* PRODUCT_MAX_VISIBLE_PHOTO => Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '5' will show the first five product photos found on the product card.<br />
* PRODUCT_MAX_LENGTH_COMBO => limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
* MAIN_DISABLE_FREE_LINES (>= 8.0) => Disallow using free lines to add line in documents<br />
<br />
== Services module ==<br />
* SERVICE_ARE_ECOMMERCE_200238EC => If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
== Stocks ==<br />
* MAIN_SERVICES_ARE_ECOMMERCE_200238EC (< 8) => <br />
<br />
* CASHDESK_FORCE_STOCK_ON_BILL (>= 8.0.1) => Option to force decrease of stock whatever is user setup.<br />
<br />
* SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED => Disable stock dispatch when total expected was already received.<br />
<br />
== Shipments ==<br />
* STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS (>= 8.0.1) => If set, you can add a shipment line, with no stock source defined.<br />
<br />
* SHIPMENT_GETS_ALL_ORDER_PRODUCTS => Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
== Point of Sale ==<br />
* CASHDESK_SHOW_KEYPAD => Show a mouse key pad into Point Of Sale.<br />
* POS_ADDON = Set this value to an existing numbering module rule (for example 'mod_facture_terre', 'mod_facture_mars', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value POS_ADDON to 'mod_facture_terre' will use the numbering module 'terre' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
== Contracts ==<br />
* CONTRACT_SUPPORT_PRODUCTS => Products are also suggested into module contract.<br />
<br />
== Projects module ==<br />
* PROJECT_DISABLE_UNLINK_FROM_OVERVIEW (>= 8.0.1) => Enable removing the button from a link in the project overview.<br />
* PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS => Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
* PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS => Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
* PROJECT_SHOW_REF_INTO_LISTS => Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
* PROJECT_HIDE_UNSELECTABLES => Hide into select list, all project that we can't select (closed or draft)<br />
* PROJECT_HIDE_TASKS => Hide tasks. For user using project only as an analytics key and not using tasks.<br />
* PROJECT_LIST_SHOW_STARTDATE => Shows start date of projects in project lists.<br />
* PROJECT_LINK_ON_OVERWIEW_DISABLED (4.0) => Hide the "link to" form on the overview page<br />
* PROJECT_CREATE_ON_OVERVIEW_DISABLED (4.0) => Hide the "create ..." button on the overview page<br />
* PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY => Can link an object to a project of another thirdparty<br />
* PROJECT_ALLOW_COMMENT_ON_TASK => Add comment feature on project task<br />
<br />
== Foundation module ==<br />
* MEMBER_URL_REDIRECT_SUBSCRIPTION => Link called and shown when a member account is autocreated in member module by a guest user.<br />
* MEMBER_EXT_URL_SUBSCRIPTION_INFO => Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
<br />
== Interventions module ==<br />
* FICHINTER_CLASSIFY_BILLED => Allow to classify an intervention card as "Billed". This add also trigger FICHINTER_CLASSIFY_BILLED into list of possible automatic event into agenda.<br />
* FICHINTER_DISABLE_DETAILS => Disable entry of details line on intervention. Can validate with no line.<br />
<br />
== Suppliers module ==<br />
* FOURN_PRODUCT_AVAILABILITY => On the Suppliers price page of the products, activate the supplier product availability. This is duplicate feature with delivery_delay introduced with 3.8.<br />
* SUPPLIER_ORDER_AUTOADD_USER_CONTACT => Add user approving supplier order as a contact automatically.<br />
* SUPPLIER_ORDER_USE_DISPATCH_STATUS => Add a status on each dispatch order line when receiving products from suppliers (v4.0+)<br />
* SUPPLIER_ORDER_NO_DIRECT_APPROVE => No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
* SUPPLIER_ORDER_WITH_NOPRICEDEFINED => Can enter a product even if no supplier price defined. (v6.0+)<br />
* SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT => Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. (v6.0+)<br />
<br />
== Bank module ==<br />
* BANK_CAN_RECONCILIATE_CASHACCOUNT (3.8) => Can reconciliate cash accounts<br />
* BANK_DISABLE_CHECK_DEPOSIT => Disable check deposit feature<br />
* BANK_ASK_PAYMENT_BANK_DURING_ORDER => Ask bank account during creation of an order<br />
* BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL => Ask bank account during creation of a proposal<br />
<br />
== Emailing module ==<br />
* MAILING_PREFIX_FOR_EMAIL_ID => Set the value that will be used to compose the "Email Id" into email headers. If you set this value to 'SERVER_NAME', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
* MAILING_NO_USING_PHPMAIL => If set, the module emailing can't be use with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
* MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS => Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
* MAILING_LIMIT_WARNING_PHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_PHPMAIL' and enter translation key for each language for this key.<br />
* MAILING_LIMIT_WARNING_NOPHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_NOPHPMAIL' and enter translation key for each language for this key.<br />
* EMAILING_USE_ADVANCED_SELECTOR => Enable the advanced selector for destinaries<br />
<br />
* MAILING_LIMIT_SENDBYWEB => Restrict number of emails you can send in same sending session with emailing module from GUI. The value "dolibarr_mailing_limit_sendbyweb" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
* MAILING_LIMIT_SENDBYCLI => Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "dolibarr_mailing_limit_sendbycli" if defined into config file is used in priority for this limit.<br />
<br />
== PDF options ==<br />
* MAIN_DISABLE_FORCE_SAVEAS => If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* MAIN_DISABLE_PDF_COMPRESSION => Disable PDF compression.<br />
<br />
* MAIN_INVERT_SENDER_RECIPIENT => Invert sender and recipient in some PDF.<br />
<br />
* MAIN_DISABLE_PDF_AUTOUPDATE => Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* MAIN_USE_BACKGROUND_ON_PDF => Define this constant with short name of an image (example "myimage.jpg") that must be saved into directory "documents/mycompany/logos". This will add this background image into your generated PDF files. Warning: This option make TCPDF library beeing crazy sometime and content on image disappeared !<br />
<br />
* MAIN_ADD_PDF_BACKGROUND => Define this constant with short name of a PDF file (example "mypdf.pdf") that must be saved into directory "documents/mycompany". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* MAIN_PDF_FORCE_FONT => To ignore font defined into language file and force usage of a particular font. For example "DejaVuSans".<br />
<br />
* MAIN_PDF_FREETEXT_HEIGHT => Change height of space reserved to output the free text.<br />
<br />
* MAIN_PDF_TITLE_BACKGROUND_COLOR => Can define a background color onto title line. Example: '220,220,200'<br />
<br />
* MAIN_USE_COMPANY_NAME_OF_CONTACT => Use contact name and information rather than company<br />
<br />
* MAIN_ODT_AS_PDF => Activate PDF conversion from ODT document. If value is 'jodconverter', java and jodconverter command line tool must be available. If value is '/pathto/jodconverter.jar', then java and the jodconvertar jar must exists. soffice must also be available. MAIN_DOL_SCRIPTS_ROOT Must also be defined to path where the "scripts" directory is stored (for example /var/www/mydolibarr).<br />
<br />
* MAIN_ODT_AS_PDF_DEL_SOURCE => For ODT generation. If set, then initial behaviour is conserved but odt file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* MAIN_GENERATE_INVOICES_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for supplier proposals (v5.0.3+)<br />
<br />
* MAIN_DOCUMENTS_WITH_PICTURE_WIDTH => Can change size of picture when hidden option MAIN_GENERATE_PROPOSALS_WITH_PICTURE is used. By default value is 20.<br />
<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN => Hide column with VAT information but only column not total.<br />
<br />
* PDF_SHOW_PROJECT => Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN => Hide bank number ("code banque/guichet/compte" for france, "sort number/account" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES => Value 1 or 2 change the way product ref is show (1 = show supplier ref only and not internal ref, 2 = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* MAIN_PDF_ADDALSOTARGETDETAILS => Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME => Include alternative/alias name into name on PDF.<br />
<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== WYSIWYG Editor ==<br />
<br />
* FCKEDITOR_ENABLE_DETAILS_FULL => Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
<br />
<br />
== BlockedLog ==<br />
<br />
* BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY => Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
== MultiCurreny ==<br />
<br />
* MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION => Enable CurrencyLayer API synchronization</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=39683Setup Other2018-09-10T14:05:22Z<p>John.botella: /* Global Options */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help about screen:''' Other setup<br />
<br />
'''Menu path:''' Home -> Setup -> Other<br />
<br />
= Goal =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= List of Known Hidden Options =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable them you have to define a constant to '''1''' in '''Home -> Setup -> Other Setup''': <br />
<br />
== Global Options ==<br />
* MAIN_FILESYSTEM_ENCODING => With some PHP version, PHP is not able to detect what is page code for filesystem of the server OS. To solve this, Dolibarr suppose your OS filesystem is UTF-8 if on linux or osx system, and iso-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable MAIN_FILESYSTEM_ENCODING to "utf-8".<br />
<br />
* MAIN_SHOW_TECHNICAL_ID => Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* MAIN_MAXTABS_IN_CARD => Max number of tabs visible. Others are grouped into a combo list.<br />
<br />
* MAIN_ONLY_LOGIN_ALLOWED => Only the specified login is allowed to log in Dolibarr (maintenance mode)<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES => Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES => Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* MAIN_SECURITY_CSRF_WITH_TOKEN (>= 5.0) => Activate a second anti CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful.<br />
<br />
* MAIN_APPLICATION_TITLE => This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fails by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* MAIN_AUTOFILL_DATE => If this constant is defined (to something else than 0), the date of invoice, proposal, order or payment are filled with current date. It is highly recommended to NOT ENABLE this feature. This create a lot of input errors with no data not validated by users. This lead in bad values saved in database giving headaches when you have to do your accountancy reports ! However some users want it, so we provide it.<br />
<br />
* MAIN_DISABLE_FULL_SCANLIST => Constant to define to disable complete scan of tables to know the total amount of element to allow the pagination to show total number of pages. To activate on systems with a very important number of data (Tables with more than 500 000 records).<br />
<br />
* MAIN_FIRST_TO_UPPER => Dolibarr add uppercase to thirdparties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* MAIN_ENABLE_LOG_TO_HTML (MAIN_LOGTOHTML before 3.9) => If this constants is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* MAIN_USE_HOURMIN_IN_DATE_RANGE => On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* MAIN_REMOVE_INSTALL_WARNING => Remove all security warning that appears to administrator users if URL /install is public. You should solve the problem if warning occurs instead of removing this warning. For this, put a file called install.lock into Dolibarr root directory. This will remove warning but also make the page /install not possible to use to protect your installation.<br />
<br />
* MAIN_OPTIMIZE_SPEED => Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* MAIN_REPLACE_TRANS_xx_XX => Where xx_XX is language code. If value is string1:newstring1;string2:newstring2 then replace string1 with newstring1 in all translation done for language xx_XX.<br />
<br />
* MAIN_REPEATCONTACTONEACHTAB => If added and set to 1, this add contacts on all tabs, not only main tab.<br />
<br />
* MAIN_DISABLE_JQUERY_JNOTIFY => Disable usage of JNotify to show confirm or error messages<br />
<br />
* MAIN_USE_JQUERY_JEDITABLE => Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because, it overpass some business actions (updates on other data that should be done consistently) and ignore business controls on data you saved. So this feature breaks consistency of data and stability of software.<br />
<br />
* MAIN_USE_JQUERY_MULTISELECT => Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* MAIN_HELPCENTER_LINKTOUSE => Define the url link to use as the target page for link "I need help" onto logon page<br />
<br />
* MAIN_MODULES_FOR_EXTERNAL => Limit available modules for external users. By default value is 'facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda'<br />
<br />
* MAIN_SHOW_TUNING_INFO => Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* MAIN_DOL_SCRIPTS_ROOT => Define directory who contains 'scripts' directory (e.g /var/www/dolibarr)<br />
<br />
* MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING => A warning saying setup of modules is not complete is shown if number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE => Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* MAIN_DISABLE_AJAX_COMBOX => If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting constant MAIN_DISABLE_AJAX_COMBOX to 1 into Home-Setup-Other (with Dolibarr v3.6.0+).<br />
<br />
* MAIN_USE_CACHE_MANIFEST => Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* MAIN_FORCELANGDIR => relative path of the directory holding your custom langs folder.<br />
<br />
* MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS => allow to define a default VAT rate<br />
<br />
* MAIN_HTML_TITLE => can be used to control how html title is formatted. If value contains key 'noapp', application name will not be output. If value contains 'thirdpartynameonly', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: 'noapp;thirdpartynameonly'<br />
<br />
* MAIN_LANDING_PAGE => (>= 3.9). Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param).<br />
<br />
* MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN => (>= 4.0) When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible.<br />
<br />
* MAIN_WEIGHT_DEFAULT_ROUND => Accuracy of weight (number of decimals)<br />
<br />
* MAIN_WEIGHT_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_VOLUME_DEFAULT_ROUND => Accuracy of volume (number of decimals)<br />
<br />
* MAIN_VOLUME_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_PUBLIC_NOTE_IN_ADDRESS >=4.0 => show public note in address block<br />
<br />
* MAIN_DEFAULT_PAYMENT_TERM_ID => With id of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND => Change way of rounding total TTC lines, rounding first of after<br />
<br />
* MAIN_VIEW_LINE_NUMBER => Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME => Add name of thirdparty at begin of generated document<br />
<br />
* MAIN_DOC_USE_TIMING => Add a timestamp at end of generated document. Value must be format of timestamp. For example: %Y%m%d%H%M<br />
<br />
* MAIN_DISABLEDRAFTSTATUS => Disable the status Draft for some object (project, donation, ...)<br />
<br />
* MAIN_USE_OLD_SEARCH_FORM => Display the old search form in left menu<br />
<br />
* MAIN_SERVER_TZ => If you can't set timezone of your PHP, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : Europe/Paris, auto.<br />
<br />
* MAIN_SEARCH_FORM_ON_HOME_AREAS => Show the search form on home page areas for core modules (Removed after v5 due to global search combo) (v6.0+)<br />
<br />
* MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE => If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result (v5.0+)<br />
<br />
* MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES (dolibarr 8.0) => Allow to import lines into current document from "linked" compatible documents<br />
<br />
== Look or Theme ==<br />
* MAIN_OPTIMIZEFORTEXTBROWSER => Optimize output rendering for usage of a text browser (usefull for blind people)<br />
* THEME_ELDY_DISABLE_IMAGE => Disabled images of top menu for eldy theme.<br />
* MAIN_MENU_HIDE_UNAUTHORIZED => Hide menu if logged in user is not autorized rather than just grey them<br />
* THEME_TOPMENU_STICKY_POSITION => Option to fix top menu with eldy theme (hidden conf)(v7.0+)<br />
<br />
== Email and SMS ==<br />
* MAIN_MAIL_DEBUG => Write content with header of last mail into file dolibarr_mail.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_SMS_DEBUG => Write content of SMS sent into file dolibarr_sms.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_MAIL_ALLOW_SENDMAIL_F => On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option -f. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option -f. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* MAIN_MAIL_SENDMAIL_FORCE_BA => On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''php.ini''' file.<br />
<br />
* MAIN_MAIL_NO_FULL_EMAIL => Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* MAIN_FIX_FOR_BUGGED_MTA => Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of orange.fr or hotmail.com<br />
<br />
* MAIN_MAIL_DO_NOT_USE_SIGN => Do not add user signature at end of suggested pre-defined email<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_INVOICE => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_ORDER => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_PROPAL => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* MAIN_EMAIL_USECCC => 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO => Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
* MAIN_EMAIL_ADD_TRACK_ID => When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL => Restrict sending of 1 email message to x recipients for same email message (x for To: + CC: + BCC:). If not defined, value is 10. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
* MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML => Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* MAIN_MAIL_USE_MULTI_PART => Forge email content using an alternate text part (for 5.0.2+). By default with 6.0+<br />
<br />
* MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS => If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* MAIN_COPY_FILE_IN_EVENT_AUTO => Add attachement document on event auto generated by sending email from dolibarr. (v6.0+)<br />
<br />
* MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS => Enter the public ip address of the server, so it will appears into the help on the email setup page.<br />
<br />
* MAIN_MAIL_ENABLED_USER_DEST_SELECT => Show also internal users into list of recipients of email in email sending form (v8.0+)<br />
<br />
== Third Parties module ==<br />
* SOCIETE_DISABLE_CUSTOMERS => Remove all menu and features related to customers<br />
* SOCIETE_DISABLE_PROSPECTS => Remove all menu and features related to prospects<br />
* SOCIETE_DISABLE_STATE => Do not use field "state/province"<br />
* THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT => Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
* THIRDPARTY_NOTSUPPLIER_BY_DEFAULT => Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
* SOCIETE_SORT_ON_TYPEENT = The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
* THIRDPARTY_DEFAULT_CREATE_CONTACT (Dolibarr 5.0+) => Default Third party create are individual<br />
* MAIN_THIRDPARTY_CREATION_INDIVIDUAL (Dolibarr <5.0) => Default Third party create are individual<br />
* THIRDPARTY_DEFAULT_USEVAT => When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX1 => When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX2 => When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_INCLUDE_PARENT_IN_LINKTO => Search also for elements on parent third party when using the "link to" object feature.<br />
* THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO => Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
* SOCIETE_ASK_FOR_SHIPPING_METHOD => Shipping method can be predefined on customer card and will be used as default on order creation<br />
* THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD => When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
* MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL => External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
== Proposals module ==<br />
* PROPAL_CLONE_ON_CREATE_PAGE => On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
* MAIN_PROPAL_CHOOSE_ODT_DOCUMENT => On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
* PROPAL_DISABLE_SIGNATURE => Do no show the box for signature.<br />
* WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES => Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
* PRODUIT_PDF_MERGE_PROPAL => When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
* PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== Order module ==<br />
* COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
* COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
* COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
* ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Invoice module ==<br />
* MAIN_DEPOSIT_MULTI_TVA => In deposits invoice, creates one line per VAT rate from the origin document (6.0)<br />
* FACTURE_SHOW_SEND_REMINDER => Show link "Send reminder by mail", same feature than "Send by mail" (obsolete feature).<br />
* INVOICE_CAN_ALWAYS_BE_EDITED => Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_ALWAYS_BE_REMOVED => Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_NEVER_BE_REMOVED => Never allow to delete invoices (except draft invoices).<br />
* INVOICE_POSITIVE_CREDIT_NOTE => All amounts on PDF credit notes are positive.<br />
* FACTURE_CHANGE_THIRDPARTY => Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
* FACTURE_USE_PROFORMAT => Enable PROFORMAT invoices type.<br />
* FACTURE_DEPOSITS_ARE_JUST_PAYMENTS => Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
* FACTURE_SENDBYEMAIL_FOR_ALL_STATUS => Can send invoice by email to customer even if invoice has status "draft".<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT => Disable VAT on genrated documents. like for an association. (it's work with crabe template)<br />
* INVOICE_CREDIT_NOTE_STANDALONE (dolibarr 3.9) => Can make a credit note without invoice.<br />
* INVOICE_USE_SITUATION = Enable the "situation invoice" feature<br />
* INVOICE_USE_SITUATION_CREDIT_NOTE (dolibarr 8.0) = Enable the "situation credit note" feature (need INVOICE_USE_SITUATION)<br />
* INVOICE_DISABLE_DEPOSIT = Disable deposit invoices<br />
* INVOICE_DISABLE_REPLACEMENT = Disable replacement invoices<br />
* INVOICE_DISABLE_CREDIT_NOTE = Disable credit notes<br />
* WORKFLOW_BILL_ON_SHIPMENT = Change label of button with suitable label when you need to create invoice on shipments<br />
* INVOICE_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Expense Report ==<br />
* EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS => Can enter several expense reports on same or overlapping date periods. (v7.0+)<br />
<br />
== Export module ==<br />
* EXPORT_CSV_SEPARATOR_TO_USE => String value to use as default separator to delimit fields of exported files (by default Dolibarr uses ","). Example: EXPORT_CSV_SEPARATOR_TO_USE=;<br />
* EXPORT_CSV_FORCE_CHARSET => Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= utf-8<br />
* EXPORTTOOL_CATEGORIES => Can export categories (several lines) into one column with the "product export profile"<br />
* USE_STRICT_CSV_RULES => Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (").<br />
<br />
== Agenda module ==<br />
* AGENDA_MAX_EVENTS_DAY_VIEW => Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
* AGENDA_USE_EVENT_TYPE => Add a mandatory field "Type" when creating an event (deprecated).<br />
* AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS => To automatically set end date of event to start date + delta on event creation page.<br />
* MAIN_ADD_EVENT_ON_ELEMENT_CARD => Allow to create an event from a document (proposal, order, invoice)<br />
<br />
== Products module ==<br />
* MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE => Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
* PRODUCT_ADD_TYPE_IN_DOCUMENTS => Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
* PRODUCT_DONOTSEARCH_ANYWHERE => When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
* PRODUIT_DESC_IN_LIST => Show long description of product/service into lists.<br />
* PRODUIT_PDF_MERGE_PROPAL => Enable module Propal merge product PDF<br />
* PRODUCT_USE_OLD_PATH_FOR_PHOTO => Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
* PRODUCT_USE_UNITS => Enable units from dictionary in product/service card.<br />
* PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL => When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
* MAIN_DIRECT_STATUS_UPDATE => Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. v4.0+<br />
<br />
* PRODUCT_CHARGES => Adds an extra field for adhoc charges at the product buying price stage. The Cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product.<br />
<br />
* PRODUCT_MAX_VISIBLE_PHOTO => Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '5' will show the first five product photos found on the product card.<br />
* PRODUCT_MAX_LENGTH_COMBO => limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
* MAIN_DISABLE_FREE_LINES (>= 8.0) => Disallow using free lines to add line in documents<br />
<br />
== Services module ==<br />
* SERVICE_ARE_ECOMMERCE_200238EC => If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
== Stocks ==<br />
* SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED => Disable stock dispatch when total expected was already received.<br />
<br />
== Shipments ==<br />
* SHIPMENT_GETS_ALL_ORDER_PRODUCTS => Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
== Point of Sale ==<br />
* CASHDESK_SHOW_KEYPAD => Show a mouse key pad into Point Of Sale.<br />
* POS_ADDON = Set this value to an existing numbering module rule (for example 'mod_facture_terre', 'mod_facture_mars', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value POS_ADDON to 'mod_facture_terre' will use the numbering module 'terre' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
== Contracts ==<br />
* CONTRACT_SUPPORT_PRODUCTS => Products are also suggested into module contract.<br />
<br />
== Projects module ==<br />
* PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS => Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
* PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS => Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
* PROJECT_SHOW_REF_INTO_LISTS => Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
* PROJECT_HIDE_UNSELECTABLES => Hide into select list, all project that we can't select (closed or draft)<br />
* PROJECT_HIDE_TASKS => Hide tasks. For user using project only as an analytics key and not using tasks.<br />
* PROJECT_LIST_SHOW_STARTDATE => Shows start date of projects in project lists.<br />
* PROJECT_LINK_ON_OVERWIEW_DISABLED (4.0) => Hide the "link to" form on the overview page<br />
* PROJECT_CREATE_ON_OVERVIEW_DISABLED (4.0) => Hide the "create ..." button on the overview page<br />
* PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY => Can link an object to a project of another thirdparty<br />
* PROJECT_ALLOW_COMMENT_ON_TASK => Add comment feature on project task<br />
<br />
== Foundation module ==<br />
* MEMBER_URL_REDIRECT_SUBSCRIPTION => Link called and shown when a member account is autocreated in member module by a guest user.<br />
* MEMBER_EXT_URL_SUBSCRIPTION_INFO => Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
<br />
== Interventions module ==<br />
* FICHINTER_CLASSIFY_BILLED => Allow to classify an intervention card as "Billed". This add also trigger FICHINTER_CLASSIFY_BILLED into list of possible automatic event into agenda.<br />
* FICHINTER_DISABLE_DETAILS => Disable entry of details line on intervention. Can validate with no line.<br />
<br />
== Suppliers module ==<br />
* FOURN_PRODUCT_AVAILABILITY => On the Suppliers price page of the products, activate the supplier product availability. This is duplicate feature with delivery_delay introduced with 3.8.<br />
* SUPPLIER_ORDER_AUTOADD_USER_CONTACT => Add user approving supplier order as a contact automatically.<br />
* SUPPLIER_ORDER_USE_DISPATCH_STATUS => Add a status on each dispatch order line when receiving products from suppliers (v4.0+)<br />
* SUPPLIER_ORDER_NO_DIRECT_APPROVE => No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
* SUPPLIER_ORDER_WITH_NOPRICEDEFINED => Can enter a product even if no supplier price defined. (v6.0+)<br />
* SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT => Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. (v6.0+)<br />
<br />
== Bank module ==<br />
* BANK_CAN_RECONCILIATE_CASHACCOUNT (3.8) => Can reconciliate cash accounts<br />
* BANK_DISABLE_CHECK_DEPOSIT => Disable check deposit feature<br />
* BANK_ASK_PAYMENT_BANK_DURING_ORDER => Ask bank account during creation of an order<br />
* BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL => Ask bank account during creation of a proposal<br />
<br />
== Emailing module ==<br />
* MAILING_PREFIX_FOR_EMAIL_ID => Set the value that will be used to compose the "Email Id" into email headers. If you set this value to 'SERVER_NAME', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
* MAILING_NO_USING_PHPMAIL => If set, the module emailing can't be use with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
* MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS => Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
* MAILING_LIMIT_WARNING_PHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_PHPMAIL' and enter translation key for each language for this key.<br />
* MAILING_LIMIT_WARNING_NOPHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_NOPHPMAIL' and enter translation key for each language for this key.<br />
* EMAILING_USE_ADVANCED_SELECTOR => Enable the advanced selector for destinaries<br />
<br />
* MAILING_LIMIT_SENDBYWEB => Restrict number of emails you can send in same sending session with emailing module from GUI. The value "dolibarr_mailing_limit_sendbyweb" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
* MAILING_LIMIT_SENDBYCLI => Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "dolibarr_mailing_limit_sendbycli" if defined into config file is used in priority for this limit.<br />
<br />
== PDF options ==<br />
* MAIN_DISABLE_FORCE_SAVEAS => If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* MAIN_DISABLE_PDF_COMPRESSION => Disable PDF compression.<br />
<br />
* MAIN_INVERT_SENDER_RECIPIENT => Invert sender and recipient in some PDF.<br />
<br />
* MAIN_DISABLE_PDF_AUTOUPDATE => Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* MAIN_USE_BACKGROUND_ON_PDF => Define this constant with short name of an image (example "myimage.jpg") that must be saved into directory "documents/mycompany/logos". This will add this background image into your generated PDF files. Warning: This option make TCPDF library beeing crazy sometime and content on image disappeared !<br />
<br />
* MAIN_ADD_PDF_BACKGROUND => Define this constant with short name of a PDF file (example "mypdf.pdf") that must be saved into directory "documents/mycompany". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* MAIN_PDF_FORCE_FONT => To ignore font defined into language file and force usage of a particular font. For example "DejaVuSans".<br />
<br />
* MAIN_PDF_FREETEXT_HEIGHT => Change height of space reserved to output the free text.<br />
<br />
* MAIN_PDF_TITLE_BACKGROUND_COLOR => Can define a background color onto title line. Example: '220,220,200'<br />
<br />
* MAIN_USE_COMPANY_NAME_OF_CONTACT => Use contact name and information rather than company<br />
<br />
* MAIN_ODT_AS_PDF => Activate PDF conversion from ODT document. If value is 'jodconverter', java and jodconverter command line tool must be available. If value is '/pathto/jodconverter.jar', then java and the jodconvertar jar must exists. soffice must also be available. MAIN_DOL_SCRIPTS_ROOT Must also be defined to path where the "scripts" directory is stored (for example /var/www/mydolibarr).<br />
<br />
* MAIN_ODT_AS_PDF_DEL_SOURCE => For ODT generation. If set, then initial behaviour is conserved but odt file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* MAIN_GENERATE_INVOICES_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for supplier proposals (v5.0.3+)<br />
<br />
* MAIN_DOCUMENTS_WITH_PICTURE_WIDTH => Can change size of picture when hidden option MAIN_GENERATE_PROPOSALS_WITH_PICTURE is used. By default value is 20.<br />
<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN => Hide column with VAT information but only column not total.<br />
<br />
* PDF_SHOW_PROJECT => Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN => Hide bank number ("code banque/guichet/compte" for france, "sort number/account" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES => Value 1 or 2 change the way product ref is show (1 = show supplier ref only and not internal ref, 2 = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* MAIN_PDF_ADDALSOTARGETDETAILS => Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME => Include alternative/alias name into name on PDF.<br />
<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== WYSIWYG Editor ==<br />
<br />
* FCKEDITOR_ENABLE_DETAILS_FULL => Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
<br />
<br />
== BlockedLog ==<br />
<br />
* BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY => Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
== MultiCurreny ==<br />
<br />
* MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION => Enable CurrencyLayer API synchronization</div>John.botellahttps://wiki.dolibarr.org/index.php?title=Setup_Other&diff=39682Setup Other2018-09-10T14:02:16Z<p>John.botella: /* Invoice module */</p>
<hr />
<div>[[Category:Admin]]<br />
{{TemplateDocUser}}<br />
<br />
'''Help about screen:''' Other setup<br />
<br />
'''Menu path:''' Home -> Setup -> Other<br />
<br />
= Goal =<br />
This page is built to add/edit new parameters without a dedicated page to edit them. In most cases, it is parameters for your own development, external modules, or hidden features which can allow some tweaking to your own Dolibarr instance.<br />
<br />
For standard usage of Dolibarr, this screen must be kept empty and not be used.<br />
<br />
= List of Known Hidden Options =<br />
Some options are not visible in the interface (often because they are deprecated or are beta features). In most cases you do not need these functions and their use may make the application unstable.<br />
<br />
To enable them you have to define a constant to '''1''' in '''Home -> Setup -> Other Setup''': <br />
<br />
== Global Options ==<br />
* MAIN_FILESYSTEM_ENCODING => With some PHP version, PHP is not able to detect what is page code for filesystem of the server OS. To solve this, Dolibarr suppose your OS filesystem is UTF-8 if on linux or osx system, and iso-8859-1 if on Windows. If not, for example on a Windows server with a NTFS UTF-8 pagecode, you can set the variable MAIN_FILESYSTEM_ENCODING to "utf-8".<br />
<br />
* MAIN_SHOW_TECHNICAL_ID => Show also technical IDs on elements cards or some lists (not supported everywhere).<br />
<br />
* MAIN_MAXTABS_IN_CARD => Max number of tabs visible. Others are grouped into a combo list.<br />
<br />
* MAIN_ONLY_LOGIN_ALLOWED => Only the specified login is allowed to log in Dolibarr (maintenance mode)<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES => Add a timestamp and user automatically when editing the ''public'' note.<br />
<br />
* MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES => Add a timestamp and user automatically when editing the ''private'' note.<br />
<br />
* MAIN_SECURITY_CSRF_WITH_TOKEN (>= 5.0) => Activate a second anti CSRF protection on POST (a POST from another web site can't be done). Note there is already a default protection using test on referrer. This second protection uses TOKEN on forms and is less powerful.<br />
<br />
* MAIN_APPLICATION_TITLE => This will change the title of software (that appears on the login page by default). Warning, changing this may make Dolibarr version detection fails by smartphone applications like [[Application Android - DoliDroid]]<br />
<br />
* MAIN_AUTOFILL_DATE => If this constant is defined (to something else than 0), the date of invoice, proposal, order or payment are filled with current date. It is highly recommended to NOT ENABLE this feature. This create a lot of input errors with no data not validated by users. This lead in bad values saved in database giving headaches when you have to do your accountancy reports ! However some users want it, so we provide it.<br />
<br />
* MAIN_DISABLE_FULL_SCANLIST => Constant to define to disable complete scan of tables to know the total amount of element to allow the pagination to show total number of pages. To activate on systems with a very important number of data (Tables with more than 500 000 records).<br />
<br />
* MAIN_FIRST_TO_UPPER => Dolibarr add uppercase to thirdparties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.<br />
<br />
* MAIN_ENABLE_LOG_TO_HTML (MAIN_LOGTOHTML before 3.9) => If this constants is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.<br />
<br />
* MAIN_USE_HOURMIN_IN_DATE_RANGE => On all entities lines (invoice, order, contract...), it is possible to add hour and minutes with date on fields "date start" and "date end".<br />
<br />
* MAIN_REMOVE_INSTALL_WARNING => Remove all security warning that appears to administrator users if URL /install is public. You should solve the problem if warning occurs instead of removing this warning. For this, put a file called install.lock into Dolibarr root directory. This will remove warning but also make the page /install not possible to use to protect your installation.<br />
<br />
* MAIN_OPTIMIZE_SPEED => Use some speed enhancements. See page [[Increase_Performance]] for more information.<br />
<br />
* MAIN_REPLACE_TRANS_xx_XX => Where xx_XX is language code. If value is string1:newstring1;string2:newstring2 then replace string1 with newstring1 in all translation done for language xx_XX.<br />
<br />
* MAIN_REPEATCONTACTONEACHTAB => If added and set to 1, this add contacts on all tabs, not only main tab.<br />
<br />
* MAIN_DISABLE_JQUERY_JNOTIFY => Disable usage of JNotify to show confirm or error messages<br />
<br />
* MAIN_USE_JQUERY_JEDITABLE => Allow to update from screen, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because, it overpass some business actions (updates on other data that should be done consistently) and ignore business controls on data you saved. So this feature breaks consistency of data and stability of software.<br />
<br />
* MAIN_USE_JQUERY_MULTISELECT => Allow to use Ajax when a choice that require multiselect is used (for the moment only external modules uses select box with multiselect values). Set the value to the jQuery plugin name to use (multiselect, multiple-select, select2…). Setting it to any other value will result in unwanted side-effects and/or bugs.<br />
<br />
* MAIN_HELPCENTER_LINKTOUSE => Define the url link to use as the target page for link "I need help" onto logon page<br />
<br />
* MAIN_MODULES_FOR_EXTERNAL => Limit available modules for external users. By default value is 'facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda'<br />
<br />
* MAIN_SHOW_TUNING_INFO => Add tuning information into javascript console. Better when xdebug is enabled.<br />
<br />
* MAIN_DOL_SCRIPTS_ROOT => Define directory who contains 'scripts' directory (e.g /var/www/dolibarr)<br />
<br />
* MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING => A warning saying setup of modules is not complete is shown if number of enabled modules is lower or equal than this value (1 if not defined)<br />
<br />
* MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE => Add signature of the first sale representative into documents (at end of public notes).<br />
<br />
* MAIN_DISABLE_AJAX_COMBOX => If you have a large number of third parties or products, you can disable the autocomplete feature on the third parties list by setting constant MAIN_DISABLE_AJAX_COMBOX to 1 into Home-Setup-Other (with Dolibarr v3.6.0+).<br />
<br />
* MAIN_USE_CACHE_MANIFEST => Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards<br />
<br />
* MAIN_FORCELANGDIR => relative path of the directory holding your custom langs folder.<br />
<br />
* MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS => allow to define a default VAT rate<br />
<br />
* MAIN_HTML_TITLE => can be used to control how html title is formatted. If value contains key 'noapp', application name will not be output. If value contains 'thirdpartynameonly', on tab for thirdparties, only name of thirdparties are output. Value can be list of tags: 'noapp;thirdpartynameonly'<br />
<br />
* MAIN_LANDING_PAGE => (>= 3.9). Can choose the first page to show after login (the landing page). This option works as a global option (llx_const) and per user option (llx_user_param).<br />
<br />
* MAIN_PROPAGATE_CONTACTS_FROM_ORIGIN => (>= 4.0) When creating an order, contract, invoice from another object, specific contacts of objects are set as specific contact of the new object when possible.<br />
<br />
* MAIN_WEIGHT_DEFAULT_ROUND => Accuracy of weight (number of decimals)<br />
<br />
* MAIN_WEIGHT_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_VOLUME_DEFAULT_ROUND => Accuracy of volume (number of decimals)<br />
<br />
* MAIN_VOLUME_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)<br />
<br />
* MAIN_PUBLIC_NOTE_IN_ADDRESS >=4.0 => show public note in address block<br />
<br />
* MAIN_DEFAULT_PAYMENT_TERM_ID => With id of a payment term, will use this as default payment term each time you create a new proposal, order, invoice (customer and supplier)<br />
<br />
* MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND => Change way of rounding total TTC lines, rounding first of after<br />
<br />
* MAIN_VIEW_LINE_NUMBER => Shows a line number against each line in the order/invoice for products/services. On screen only, not on PDF.<br />
<br />
* MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME => Add name of thirdparty at begin of generated document<br />
<br />
* MAIN_DOC_USE_TIMING => Add a timestamp at end of generated document. Value must be format of timestamp. For example: %Y%m%d%H%M<br />
<br />
* MAIN_DISABLEDRAFTSTATUS => Disable the status Draft for some object (project, donation, ...)<br />
<br />
* MAIN_USE_OLD_SEARCH_FORM => Display the old search form in left menu<br />
<br />
* MAIN_SERVER_TZ => If you can't set timezone of your PHP, set this constant. Better is to set it to UTC. In future, this constant will be forced to 'UTC' so PHP server timezone will not have effect anymore. Examples : Europe/Paris, auto.<br />
<br />
* MAIN_SEARCH_FORM_ON_HOME_AREAS => Show the search form on home page areas for core modules (Removed after v5 due to global search combo) (v6.0+)<br />
<br />
* MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE => If only one result is found, then setting this value to '''1''' will take you direct to the item (default method). Setting the value to '''0''' will show the result in the list as a single result (v5.0+)<br />
<br />
== Look or Theme ==<br />
* MAIN_OPTIMIZEFORTEXTBROWSER => Optimize output rendering for usage of a text browser (usefull for blind people)<br />
* THEME_ELDY_DISABLE_IMAGE => Disabled images of top menu for eldy theme.<br />
* MAIN_MENU_HIDE_UNAUTHORIZED => Hide menu if logged in user is not autorized rather than just grey them<br />
* THEME_TOPMENU_STICKY_POSITION => Option to fix top menu with eldy theme (hidden conf)(v7.0+)<br />
<br />
== Email and SMS ==<br />
* MAIN_MAIL_DEBUG => Write content with header of last mail into file dolibarr_mail.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_SMS_DEBUG => Write content of SMS sent into file dolibarr_sms.log into directory dolibarr_main_data_root.<br />
<br />
* MAIN_MAIL_ALLOW_SENDMAIL_F => On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option -f. This option is here to ask Dolibarr to call the function '''mail''' of PHP by adding value for the option -f. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the '''-f''' option to be mandatory or for sendmail setup that does not use by default the Return-path of header email to define the sender (with this option, the return-path will be provided also on command line and not lost by sendmail).<br />
<br />
* MAIN_MAIL_SENDMAIL_FORCE_BA => On Linux or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the '''-ba''' parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the '''mail.force_extra_parameters=-ba''' into '''php.ini''' file.<br />
<br />
* MAIN_MAIL_NO_FULL_EMAIL => Recipient email and sender are cleaned to be on form "<email>" instead of "Name <email>". This might solve problem of compatibility with very old mailers.<br />
<br />
* MAIN_FIX_FOR_BUGGED_MTA => Some MTA agent are bugged and add some CR chars each time they saw a LF. Because Dolibarr emails are forged to be already cleaned, if MTA agent do that, you will send an email with two CR chars. This may result in having recipient not able to read your email. To fix this, add this constant to 1. Dolibarr will then create an email that is not RFC compliant but because the MTA agent is bugged, the email will be modified and become correct during sending, solving the problem of bad email received. Add this constant if your recipient experience problems when opening email for example users using webmail of orange.fr or hotmail.com<br />
<br />
* MAIN_MAIL_DO_NOT_USE_SIGN => Do not add user signature at end of suggested pre-defined email<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_INVOICE => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.<br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_ORDER => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module. <br />
<br />
* MAIL_FORCE_DELIVERY_RECEIPT_PROPAL => Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.<br />
<br />
* MAIN_EMAIL_USECCC => 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.<br />
<br />
* MAIN_MAIL_AUTOCOPY_PROPOSAL_TO, MAIN_MAIL_AUTOCOPY_ORDER_TO, MAIN_MAIL_AUTOCOPY_INVOICE_TO => Email to use as a BCC recipients when sending email for proposal, order or invoice. You can make this value visible by setting MAIN_EMAIL_USECCC (to 1 or to another email, see previous point)<br />
<br />
* MAIN_EMAIL_ADD_TRACK_ID => When value is 1 (this is also default value if option is not set): The record "Message-id" added into smtp header includes a tracking id to define where the email was sent from. When value is 2: you send an email from third party card, the sender email is completed with the email source tracking string "+thiXXX" on email (your email will be sent with the "From" that is myname+thi123@mycompany.com). So when user receiving email will make "Answer", email will be sent to myname@mycompany.com but with the tracking id included (into header or into target email), allowing you to know to which third party or object, the email exchange is related to.<br />
<br />
* MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL => Restrict sending of 1 email message to x recipients for same email message (x for To: + CC: + BCC:). If not defined, value is 10. Required to fight against spamming that include 1000 recipients in 1 message. Note that MAIL_MAX_NB_OF_RECIPIENTS_TO_IN_SAME_EMAIL, MAIL_MAX_NB_OF_RECIPIENTS_CC_IN_SAME_EMAIL and MAIL_MAX_NB_OF_RECIPIENTS_BCC_IN_SAME_EMAIL are also available.<br />
<br />
* MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML => Force to send all email (event with text only content) as HTML formatted email.<br />
<br />
* MAIN_MAIL_USE_MULTI_PART => Forge email content using an alternate text part (for 5.0.2+). By default with 6.0+<br />
<br />
* MAIN_MAIL_ADD_INLINE_IMAGES_IF_IN_MEDIAS => If images were stored into the medias directory from CKEditor, then images into emails are replaced with "inline content". This may increase seriously risk of being detected as SPAM.<br />
<br />
* MAIN_COPY_FILE_IN_EVENT_AUTO => Add attachement document on event auto generated by sending email from dolibarr. (v6.0+)<br />
<br />
* MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS => Enter the public ip address of the server, so it will appears into the help on the email setup page.<br />
<br />
* MAIN_MAIL_ENABLED_USER_DEST_SELECT => Show also internal users into list of recipients of email in email sending form (v8.0+)<br />
<br />
== Third Parties module ==<br />
* SOCIETE_DISABLE_CUSTOMERS => Remove all menu and features related to customers<br />
* SOCIETE_DISABLE_PROSPECTS => Remove all menu and features related to prospects<br />
* SOCIETE_DISABLE_STATE => Do not use field "state/province"<br />
* THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT => Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".<br />
* THIRDPARTY_NOTSUPPLIER_BY_DEFAULT => Do not set status "Supplier" to "on" when creating a new third party from menu "New third party".<br />
* SOCIETE_SORT_ON_TYPEENT = The combo list of "type of third party" is sorted on a field "position" that appears into dictionary instead of alphabetical order.<br />
* THIRDPARTY_DEFAULT_CREATE_CONTACT (Dolibarr 5.0+) => Default Third party create are individual<br />
* MAIN_THIRDPARTY_CREATION_INDIVIDUAL (Dolibarr <5.0) => Default Third party create are individual<br />
* THIRDPARTY_DEFAULT_USEVAT => When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX1 => When creating a new third party, the field "Use second tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_DEFAULT_USELOCALTAX2 => When creating a new third party, the field "Use third tax" is set to on or off depending on value of this parameter.<br />
* THIRDPARTY_INCLUDE_PARENT_IN_LINKTO => Search also for elements on parent third party when using the "link to" object feature.<br />
* THIRDPARTY_INCLUDE_PROJECT_THIRDPARY_IN_LINKTO => Search also for elements on third party that own the project of the current element when using the "link to" object feature (if project is owned by a different thirdparty than current one).<br />
* SOCIETE_ASK_FOR_SHIPPING_METHOD => Shipping method can be predefined on customer card and will be used as default on order creation<br />
* THIRDPARTY_LOGO_ALLOW_EXTERNAL_DOWNLOAD => When a logo is uploaded, a share key is automatically set so the file can be downloaded using the share key.<br />
* MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL => External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...<br />
<br />
== Proposals module ==<br />
* PROPAL_CLONE_ON_CREATE_PAGE => On the create proposal page, ask if we want to create the proposal by cloning an already existing one. You should use instead the "Clone" button available on existing proposals.<br />
* MAIN_PROPAL_CHOOSE_ODT_DOCUMENT => On setup page, you'll be able to select which ODT document to use when close or cancel proposals.<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Add a picture of the product (the first one found if there are several) into the generated PDF of proposals. Note that using this will reduce the available width for the product description.<br />
* PROPAL_DISABLE_SIGNATURE => Do no show the box for signature.<br />
* WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES => Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.<br />
* PRODUIT_PDF_MERGE_PROPAL => When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF<br />
* PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== Order module ==<br />
* COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.<br />
* COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".<br />
* COMMANDE_CHANGE_THIRDPARTY => Can change customer on orders<br />
* ORDER_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Invoice module ==<br />
* MAIN_DEPOSIT_MULTI_TVA => In deposits invoice, creates one line per VAT rate from the origin document (6.0)<br />
* FACTURE_SHOW_SEND_REMINDER => Show link "Send reminder by mail", same feature than "Send by mail" (obsolete feature).<br />
* INVOICE_CAN_ALWAYS_BE_EDITED => Allow to edit invoices even if payment was started. Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_ALWAYS_BE_REMOVED => Allow to always delete invoices (even if invoice is not last one). Note: If the module "'''BlockedLog'''" is active (required by some countries for legal reason), this will not change content of archived logs tracked by this module. By definition there is no way to change or remove archived records. It will just update data in your application and a new record to track your change into the non reversible archive log.<br />
* INVOICE_CAN_NEVER_BE_REMOVED => Never allow to delete invoices (except draft invoices).<br />
* INVOICE_POSITIVE_CREDIT_NOTE => All amounts on PDF credit notes are positive.<br />
* FACTURE_CHANGE_THIRDPARTY => Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.<br />
* FACTURE_USE_PROFORMAT => Enable PROFORMAT invoices type.<br />
* FACTURE_DEPOSITS_ARE_JUST_PAYMENTS => Treats deposit invoices as a special case. Deposit invoices don't get counted on turnover. They are then applied as a payment, like a discount, on the final invoice. By default, when you include the deposit into draft of final invoice, the amount of final invoice is reduced. With this option, final amount is not reduced but a payment is registered. <br />
* FACTURE_SENDBYEMAIL_FOR_ALL_STATUS => Can send invoice by email to customer even if invoice has status "draft".<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT => Disable VAT on genrated documents. like for an association. (it's work with crabe template)<br />
* INVOICE_CREDIT_NOTE_STANDALONE (dolibarr 3.9) => Can make a credit note without invoice.<br />
* INVOICE_USE_SITUATION = Enable the "situation invoice" feature<br />
* INVOICE_USE_SITUATION_CREDIT_NOTE (dolibarr 8.0) = Enable the "situation credit note" feature (need INVOICE_USE_SITUATION)<br />
* INVOICE_DISABLE_DEPOSIT = Disable deposit invoices<br />
* INVOICE_DISABLE_REPLACEMENT = Disable replacement invoices<br />
* INVOICE_DISABLE_CREDIT_NOTE = Disable credit notes<br />
* WORKFLOW_BILL_ON_SHIPMENT = Change label of button with suitable label when you need to create invoice on shipments<br />
* INVOICE_ALLOW_EXTERNAL_DOWNLOAD => When a PDF is generated, a share key is automatically set so the file can be downloaded using the share key. (v7.0+)<br />
<br />
== Expense Report ==<br />
* EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS => Can enter several expense reports on same or overlapping date periods. (v7.0+)<br />
<br />
== Export module ==<br />
* EXPORT_CSV_SEPARATOR_TO_USE => String value to use as default separator to delimit fields of exported files (by default Dolibarr uses ","). Example: EXPORT_CSV_SEPARATOR_TO_USE=;<br />
* EXPORT_CSV_FORCE_CHARSET => Choose the charset used in the output file built by the CSV exporter. By default it is ISO-8859-1. Example: EXPORT_CSV_FORCE_CHARSET= utf-8<br />
* EXPORTTOOL_CATEGORIES => Can export categories (several lines) into one column with the "product export profile"<br />
* USE_STRICT_CSV_RULES => Use strict/real CSV format for export. Do not clean/replace CR+LF with '\n' but quote them using the escaping CSV char (").<br />
<br />
== Agenda module ==<br />
* AGENDA_MAX_EVENTS_DAY_VIEW => Define the maximum number of visible entries for each day in agenda. Default value is 3. Value 0 means no limit.<br />
* AGENDA_USE_EVENT_TYPE => Add a mandatory field "Type" when creating an event (deprecated).<br />
* AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS => To automatically set end date of event to start date + delta on event creation page.<br />
* MAIN_ADD_EVENT_ON_ELEMENT_CARD => Allow to create an event from a document (proposal, order, invoice)<br />
<br />
== Products module ==<br />
* MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE => Avoid Custom code and country of origin to be set as product description when added to Propal/Order/Invoice<br />
* PRODUCT_ADD_TYPE_IN_DOCUMENTS => Add text "Product" or "Service" at beginning of details lines on built PDF documents.<br />
* PRODUCT_DONOTSEARCH_ANYWHERE => When Ajax search is enabled, search is done on criteria anywhere in label of product. By adding this option, search is done only on start of label. This is really faster when you have a huge number of products.<br />
* PRODUIT_DESC_IN_LIST => Show long description of product/service into lists.<br />
* PRODUIT_PDF_MERGE_PROPAL => Enable module Propal merge product PDF<br />
* PRODUCT_USE_OLD_PATH_FOR_PHOTO => Ask dolibarr to check also old path (before 3.7) where photos were stored.<br />
* PRODUCT_USE_UNITS => Enable units from dictionary in product/service card.<br />
* PRODUIT_MULTIPRICES_USE_VAT_PER_LEVEL => When option to use price per level/segment is on, this allows to also set a dedicated vat for each price level.<br />
* MAIN_DIRECT_STATUS_UPDATE => Allows you to change the status of the product (''for sale/not for sale for purchase/not for purchase'') directly on the product page via a ''on/off'' switch button. This can be convenient for those who need to quickly disable certain statuses of products without having to go through the editing product page individually. Also can be very useful if used as a filter on the product and product search list. This option doesn't generate a MODIFY trigger, so be careful with external modules. v4.0+<br />
<br />
* PRODUCT_CHARGES => Adds an extra field for adhoc charges at the product buying price stage. The Cost price is then calculated with supplier price + charges if defined. Useful for extra costs for a product or certain delivery charges to the product.<br />
<br />
* PRODUCT_MAX_VISIBLE_PHOTO => Show a maximum number of product photos (as thumbnails) on the product main card. Example, setting this constant to '5' will show the first five product photos found on the product card.<br />
* PRODUCT_MAX_LENGTH_COMBO => limit the length of the label displayed when adding lines in proposals/invoices/orders<br />
* MAIN_DISABLE_FREE_LINES (>= 8.0) => Disallow using free lines to add line in documents<br />
<br />
== Services module ==<br />
* SERVICE_ARE_ECOMMERCE_200238EC => If this option is enabled, services are processed like eServices according to directive of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.<br />
<br />
== Stocks ==<br />
* SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED => Disable stock dispatch when total expected was already received.<br />
<br />
== Shipments ==<br />
* SHIPMENT_GETS_ALL_ORDER_PRODUCTS => Add all order lines in shipment, including the one with 0 in quantity<br />
<br />
== Point of Sale ==<br />
* CASHDESK_SHOW_KEYPAD => Show a mouse key pad into Point Of Sale.<br />
* POS_ADDON = Set this value to an existing numbering module rule (for example 'mod_facture_terre', 'mod_facture_mars', ...) to force the numbering module to us to define the invoice ref when invoice is created by the POS. For example setting value POS_ADDON to 'mod_facture_terre' will use the numbering module 'terre' for invoice generated from POS, whatever is the numbering rule defined into invoice module setup (you can also use POS_NUMBERING_TERRE_FORCE_PREFIX and POS_NUMBERING_MARS_FORCE_PREFIX variable to change the prefix used).<br />
<br />
== Contracts ==<br />
* CONTRACT_SUPPORT_PRODUCTS => Products are also suggested into module contract.<br />
<br />
== Projects module ==<br />
* PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS => Enable linking a project to any supplier even when using the third party link feature. Note: Set to 1 by default from 3.7.<br />
* PROJECT_TIME_ON_ALL_TASKS_MY_PROJECTS => Can add time spent on tasks, even if i am not assigned to task (however, task must be a project i am a contact).<br />
* PROJECT_SHOW_REF_INTO_LISTS => Add column with project ref into list (with 3.7 list of supplier invoices only, will be expanded to other lists)<br />
* PROJECT_HIDE_UNSELECTABLES => Hide into select list, all project that we can't select (closed or draft)<br />
* PROJECT_HIDE_TASKS => Hide tasks. For user using project only as an analytics key and not using tasks.<br />
* PROJECT_LIST_SHOW_STARTDATE => Shows start date of projects in project lists.<br />
* PROJECT_LINK_ON_OVERWIEW_DISABLED (4.0) => Hide the "link to" form on the overview page<br />
* PROJECT_CREATE_ON_OVERVIEW_DISABLED (4.0) => Hide the "create ..." button on the overview page<br />
* PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY => Can link an object to a project of another thirdparty<br />
* PROJECT_ALLOW_COMMENT_ON_TASK => Add comment feature on project task<br />
<br />
== Foundation module ==<br />
* MEMBER_URL_REDIRECT_SUBSCRIPTION => Link called and shown when a member account is autocreated in member module by a guest user.<br />
* MEMBER_EXT_URL_SUBSCRIPTION_INFO => Link of external page pointed by the "Show here" link added in front off payment cell, into the page to make online subscription.<br />
<br />
== Interventions module ==<br />
* FICHINTER_CLASSIFY_BILLED => Allow to classify an intervention card as "Billed". This add also trigger FICHINTER_CLASSIFY_BILLED into list of possible automatic event into agenda.<br />
* FICHINTER_DISABLE_DETAILS => Disable entry of details line on intervention. Can validate with no line.<br />
<br />
== Suppliers module ==<br />
* FOURN_PRODUCT_AVAILABILITY => On the Suppliers price page of the products, activate the supplier product availability. This is duplicate feature with delivery_delay introduced with 3.8.<br />
* SUPPLIER_ORDER_AUTOADD_USER_CONTACT => Add user approving supplier order as a contact automatically.<br />
* SUPPLIER_ORDER_USE_DISPATCH_STATUS => Add a status on each dispatch order line when receiving products from suppliers (v4.0+)<br />
* SUPPLIER_ORDER_NO_DIRECT_APPROVE => No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.<br />
* SUPPLIER_ORDER_WITH_NOPRICEDEFINED => Can enter a product even if no supplier price defined. (v6.0+)<br />
* SUPPLIER_ORDER_EDIT_BUYINGPRICE_DURING_RECEIPT => Can modify the buying price used for PMP calculation when making a stock reception on a supplier order. (v6.0+)<br />
<br />
== Bank module ==<br />
* BANK_CAN_RECONCILIATE_CASHACCOUNT (3.8) => Can reconciliate cash accounts<br />
* BANK_DISABLE_CHECK_DEPOSIT => Disable check deposit feature<br />
* BANK_ASK_PAYMENT_BANK_DURING_ORDER => Ask bank account during creation of an order<br />
* BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL => Ask bank account during creation of a proposal<br />
<br />
== Emailing module ==<br />
* MAILING_PREFIX_FOR_EMAIL_ID => Set the value that will be used to compose the "Email Id" into email headers. If you set this value to 'SERVER_NAME', the virtual host of web server will be used. By default, this is not defined, so a hash key, unique to each instance, is used.<br />
* MAILING_NO_USING_PHPMAIL => If set, the module emailing can't be use with mail setup of "phpmail". Using a thirdparty SMTP server is required. You can complete warning message by adding an email to contact for setup help with constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS.<br />
* MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS => Contains an email to show in a message visible to user when he try to use emailing module without SMTP server and if option MAILING_NO_USING_PHPMAIL is set to on.<br />
* MAILING_LIMIT_WARNING_PHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is on "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_PHPMAIL' and enter translation key for each language for this key.<br />
* MAILING_LIMIT_WARNING_NOPHPMAIL => Show a warning message (var contains the message to show or translation key) on emailing send form if setup is something else than "phpmail". For example, you can set this parameter to 'MAILING_LIMIT_WARNING_NOPHPMAIL' and enter translation key for each language for this key.<br />
* EMAILING_USE_ADVANCED_SELECTOR => Enable the advanced selector for destinaries<br />
<br />
* MAILING_LIMIT_SENDBYWEB => Restrict number of emails you can send in same sending session with emailing module from GUI. The value "dolibarr_mailing_limit_sendbyweb" if defined into config file is used in priority for this limit. A negative value means, sending by web is forbidden.<br />
* MAILING_LIMIT_SENDBYCLI => Restrict number of emails you can send in same sending session with emailing module from CLI script. The value "dolibarr_mailing_limit_sendbycli" if defined into config file is used in priority for this limit.<br />
<br />
== PDF options ==<br />
* MAIN_DISABLE_FORCE_SAVEAS => If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.<br />
<br />
* MAIN_DISABLE_PDF_COMPRESSION => Disable PDF compression.<br />
<br />
* MAIN_INVERT_SENDER_RECIPIENT => Invert sender and recipient in some PDF.<br />
<br />
* MAIN_DISABLE_PDF_AUTOUPDATE => Disable automatic generation of PDF each time we add/update/delete a product line (we can still build document by clicking on "Generate"). This option may increase interface speed on servers with low CPU.<br />
<br />
* MAIN_USE_BACKGROUND_ON_PDF => Define this constant with short name of an image (example "myimage.jpg") that must be saved into directory "documents/mycompany/logos". This will add this background image into your generated PDF files. Warning: This option make TCPDF library beeing crazy sometime and content on image disappeared !<br />
<br />
* MAIN_ADD_PDF_BACKGROUND => Define this constant with short name of a PDF file (example "mypdf.pdf") that must be saved into directory "documents/mycompany". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead [[Module Concat PDF]].<br />
<br />
* MAIN_PDF_FORCE_FONT => To ignore font defined into language file and force usage of a particular font. For example "DejaVuSans".<br />
<br />
* MAIN_PDF_FREETEXT_HEIGHT => Change height of space reserved to output the free text.<br />
<br />
* MAIN_PDF_TITLE_BACKGROUND_COLOR => Can define a background color onto title line. Example: '220,220,200'<br />
<br />
* MAIN_USE_COMPANY_NAME_OF_CONTACT => Use contact name and information rather than company<br />
<br />
* MAIN_ODT_AS_PDF => Activate PDF conversion from ODT document. If value is 'jodconverter', java and jodconverter command line tool must be available. If value is '/pathto/jodconverter.jar', then java and the jodconvertar jar must exists. soffice must also be available. MAIN_DOL_SCRIPTS_ROOT Must also be defined to path where the "scripts" directory is stored (for example /var/www/mydolibarr).<br />
<br />
* MAIN_ODT_AS_PDF_DEL_SOURCE => For ODT generation. If set, then initial behaviour is conserved but odt file is removed when option to convert it as PDF (see previous) is on. Disabled by default<br />
<br />
* MAIN_GENERATE_PROPOSALS_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer proposals.<br />
<br />
* MAIN_GENERATE_INVOICES_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for customer invoices.<br />
<br />
* MAIN_GENERATE_SUPPLIER_PROPOSAL_WITH_PICTURE => Include the first image of the product into the line of the generated PDF for supplier proposals (v5.0.3+)<br />
<br />
* MAIN_DOCUMENTS_WITH_PICTURE_WIDTH => Can change size of picture when hidden option MAIN_GENERATE_PROPOSALS_WITH_PICTURE is used. By default value is 20.<br />
<br />
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN => Hide column with VAT information but only column not total.<br />
<br />
* PDF_SHOW_PROJECT => Show project onto PDF (supported on supplier order only for the moment)<br />
<br />
* PDF_BANK_HIDE_NUMBER_SHOW_ONLY_BICIBAN => Hide bank number ("code banque/guichet/compte" for france, "sort number/account" for GB, ...) and keep only BIC/IBAN on PDF.<br />
<br />
* PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES => Value 1 or 2 change the way product ref is show (1 = show supplier ref only and not internal ref, 2 = show supplier then internal). Without, internal ref then supplier is shown.<br />
<br />
* MAIN_PDF_ADDALSOTARGETDETAILS => Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.<br />
<br />
* PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME => Include alternative/alias name into name on PDF.<br />
<br />
* MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING => add optional esign field in pdf propal<br />
<br />
== WYSIWYG Editor ==<br />
<br />
* FCKEDITOR_ENABLE_DETAILS_FULL => Can cut and paste external images (hosted on external server) into description of proposal, orders or invoices. WARNING: PDF generation is not guaranted with this. Also if the image is removed or renamed by the image hoster, your proposal, order or invoice will be broken.<br />
<br />
<br />
== BlockedLog ==<br />
<br />
* BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY => Make disable of module "blockedlog" not possible for countries code defined into value. Example: 'FR,...'<br />
<br />
== MultiCurreny ==<br />
<br />
* MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION => Enable CurrencyLayer API synchronization</div>John.botella