Changes

Jump to navigation Jump to search
Reformatted Global Options section for easier reading, other sections to follow
Line 24: Line 24:  
== '''Global Options''' ==
 
== '''Global Options''' ==
   −
* MAIN_DISABLE_NOTES_TAB (core) => Show or hide notes tab in the card page
+
* '''MAIN_DISABLE_NOTES_TAB''' ►Show or hide notes tab in the card page ► (core)
   −
* MAIN_DISABLE_CONTACTS_TAB (core) => Show or hide contacts tab in the card page
+
* '''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page ► (core)
   −
* MAIN_LOGOUT_GOTO_URL => (core) url to which the user will be redirected after LOGOUT.
+
* '''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT ► (core)
   −
* 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".
+
* '''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>".
   −
* MAIN_SHOW_TECHNICAL_ID => Show also technical IDs on elements cards or some lists (not supported everywhere).
+
* '''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).
   −
* MAIN_MAXTABS_IN_CARD => Max number of tabs visible. Others are grouped into a combo list.
+
* '''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.
   −
* MAIN_ONLY_LOGIN_ALLOWED => Only the specified login is allowed to log in Dolibarr (maintenance mode).
+
* '''MAIN_ONLY_LOGIN_ALLOWED''' ► Only the specified login is allowed to log in Dolibarr (maintenance mode).
   −
* MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES => Add a timestamp and user automatically when editing the ''public'' note.
+
* '''MAIN_AUTO_TIMESTAMP_IN_PUBLIC_NOTES''' ► Add a timestamp and user automatically when editing the ''public'' note.
   −
* MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES => Add a timestamp and user automatically when editing the ''private'' note.
+
* '''MAIN_AUTO_TIMESTAMP_IN_PRIVATE_NOTES''' ► Add a timestamp and user automatically when editing the ''private'' note.
   −
* 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+)
+
* '''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+)
   −
* 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]]
+
* '''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]]
   −
* 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.
+
* '''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.
   −
* 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).
+
* '''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).
   −
* 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.
+
* '''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.
   −
* 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.
+
* '''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. ► (v3.9+)
   −
* 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".
+
* '''MAIN_LOGTOHTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL. ► (<v3.9)
   −
* 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.
+
* '''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".
   −
* MAIN_OPTIMIZE_SPEED => Use some speed enhancements. See page [[Increase_Performance]] for more information.
+
* '''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.
   −
* 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.
+
* '''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[Increase_Performance]] for more information.
   −
* MAIN_REPEATCONTACTONEACHTAB => If added and set to 1, this adds contacts on all tabs, not only main tab.
+
* '''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>.
   −
* MAIN_DISABLE_JQUERY_JNOTIFY => Disable usage of JNotify to show confirm or error messages
+
* '''MAIN_REPEATCONTACTONEACHTAB''' ► If added and set to '''1''', this adds contacts on all tabs, not only main tab.
   −
* 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.
+
* '''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages
   −
* 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.
+
* '''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.
   −
* MAIN_HELPCENTER_LINKTOUSE  => Define the url link to use as the target page for link "I need help" onto logon page
+
* '''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.
   −
* MAIN_MODULES_FOR_EXTERNAL => Limit available modules for external users. By default value is 'facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda'
+
* '''MAIN_HELPCENTER_LINKTOUSE'''  ► Define the URL link to use as the target page for link "I need help" onto logon page
   −
* MAIN_SHOW_TUNING_INFO => Add tuning information into javascript console. Better when xdebug is enabled.
+
* '''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>'
   −
* MAIN_DOL_SCRIPTS_ROOT => Define directory who contains 'scripts' directory (e.g /var/www/dolibarr)
+
* '''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.
   −
* 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)
+
* '''MAIN_DOL_SCRIPTS_ROOT''' ► Define directory who contains 'scripts' directory (e.g. <code>/var/www/dolibarr</code>)
   −
* MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE => Add signature of the first sale representative into documents (at end of public notes).
+
* '''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)
   −
* 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 (v3.6.0+).
+
* '''MAIN_ADD_SALE_REP_SIGNATURE_IN_NOTE''' ► Add signature of the first sale representative into documents (at end of public notes).
   −
* MAIN_USE_CACHE_MANIFEST => Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards
+
* '''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_FORCELANGDIR => relative path of the directory holding your custom langs folder.
+
* '''MAIN_USE_CACHE_MANIFEST''' ► Add an HTML5 cache manifest to the page - Attention, this functionality is obsolete and removed from web standards
   −
* MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS => allow to define a default VAT rate
+
* '''MAIN_FORCELANGDIR''' ► Relative path of the directory holding your custom <code>langs</code> folder.
   −
* 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'
+
* '''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to define a default VAT rate
   −
* 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+)
+
* '''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>'
   −
* 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+)
+
* '''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+)
   −
* MAIN_WEIGHT_DEFAULT_ROUND => Accuracy of weight (number of decimals)
+
* '''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+)
   −
* MAIN_WEIGHT_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)
+
* '''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)
   −
* MAIN_VOLUME_DEFAULT_ROUND => Accuracy of volume (number of decimals)
+
* '''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)
   −
* MAIN_VOLUME_DEFAULT_UNIT => Default unit for weight (0=kg, -3=g, ...)
+
* '''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)
   −
* MAIN_PUBLIC_NOTE_IN_ADDRESS => show public note in address block (v4.0+)
+
* '''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (0=kg, -3=g, ...)
   −
* 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)
+
* '''MAIN_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)
   −
* MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND => Change way of rounding total TTC lines, rounding first of after
+
* '''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)
   −
* MAIN_VIEW_LINE_NUMBER => Shows a line number against each line in the order/invoice for products/services.  On screen only, not on PDF.
+
* '''MAIN_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.
   −
* MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME => Add name of thirdparty at begin of generated document
+
* '''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number against each line in the order/invoice for products/services.  On screen only, not on PDF.
   −
* 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
+
* '''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.
   −
* MAIN_DISABLEDRAFTSTATUS => Disable the status Draft for some objects (project, donation, ...)
+
* '''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>
   −
* MAIN_USE_OLD_SEARCH_FORM => Display the old search form in left menu.
+
* '''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status Draft for some objects (project, donation, ...)
   −
* 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.
+
* '''MAIN_USE_OLD_SEARCH_FORM''' ► Display the old search form in left menu.
   −
* 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+)
+
* '''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>.
   −
* 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+)
+
* '''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+)
   −
* MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES => Allow to import lines into current document from "linked" compatible documents (v8.0+)
+
* '''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+)
   −
* 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+)
+
* '''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)
   −
* MAIN_SHOWDATABASENAMEINHELPPAGESLINK => Show database name in upper help menu (v8.0+)
+
* '''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+)
 +
 
 +
* '''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu (v8.0+)
    
== '''Look or Theme''' ==
 
== '''Look or Theme''' ==
75

edits

Navigation menu