Dolibarr ERP CRM Wiki - User contributions [en]

Setup Other

2025-07-08T09:50:07Z

Isamuse: /* Agenda Module */

[[fr:Paramétrage_Divers]]
[[es:Configuración_Varios]]
[[de:Erweiterte_Einstellungen]]
[[zh:其他设置]]


[[Category:Admin]]
{{TemplateDocUser}}

'''Help About Screen''': Other setup

'''Menu Path''': Home ► Setup ► Other

'''Introduction'''

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 or may not work as expected.

{{warning|32px}} This page contains the list of some advanced development parameters. In most cases, they are 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.

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>

The options here may not be documented since they are not stable and are unsupported (remember they are experimental or development options). The basic format of how the list is written is broken down in the example below:

UNSTABLE_OR_DEV_OPTION ► ''Description of config and goal'' ► ''(specific version information) or values''
<center>
__TOC__
</center>
=Global Options=

*'''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 this external website to steel your login credentials (the value to be put is the URL of the service, exemple : https://source.unsplash.com/random) ► (v10.0)
*'''MAIN_HIDE_POWERED_BY''' ► Hide the "Powered by Dolibarr" picto on public pages
*'''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]] breaking some features when using Dolibarr from this application.

*'''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than <code>0</code>), 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!

*'''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_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). Deprecated. Replaced with the default setup feature instead (see French page of wiki for some exemple : [[Paramétrage Valeurs par défaut]])
*'''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). Deprecated. Replaced with the default setup feature instead (see French page of wiki for some exemple : [[Paramétrage Valeurs par défaut]])

*'''MAIN_DEFAULT_LANGUAGE_FILTER''' ► Useful if you do not want to show <code>en_US</code> language option in combo boxes (other languages can easily be removed in <code>langs</code> directory but not <code>en_US</code>) ► (v10.0)

*'''MAIN_LANGUAGES_ALLOWED''' ► Is a list of languages without spaces, example : <code>fr_FR,en_US,de_DE,it_IT</code> If defined, only those languages will appear in combos. ► (v11.0)

*'''MAIN_DISABLE_NOTES_TAB''' ► Show or hide notes tab in the card page

*'''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page

*'''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).

*'''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages

*'''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 <code>1</code> ► (v3.6.0+)
*'''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.
*'''MAIN_DISABLE_TRUNC''' ► Disable all truncings in select list. ► (v7.0+)

*'''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status "Draft" for some objects (project, donation, ...) so the object is directly created with status "Validated"

*'''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.

*'''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)

*'''MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT''' ► Disable the auto renaming on upload file ► (v10.0)

*'''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.

*'''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter <code>&logtohtml=1</code> into URL.

*'''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)

*'''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_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)

*'''MAIN_ALL_TOWN_TO_UPPER''' ► Dolibarr puts uppercase for town names if not done. ► (v13.0)

*'''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 <code>UTF-8</code> if on Linux or OSX system, and <code>ISO-8859-1</code> if on Windows. If not, for example on a Windows server with a NTFS <code>UTF-8</code> pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".

*'''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 '<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_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page

*'''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT

*'''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.

*'''MAIN_MAXLIST_OVERLOAD''' ► Maximum number of line in space's domain.

*'''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 (<code>1</code> if not defined)

*'''MAIN_NO_CONCAT_DESCRIPTION''' ► Allow to use only input custom description in lines (proposal, order, invoice) ► (v10.0) < v20.0. [ OSBOLETE since 20.0 | SEE Product module admin configuration to set the description behavior of products and services ]. This value is overwritten by PRODUCT_AUTOFILL_DESC, controled by the option in the product module admin configuration, and is no longer used. Kept in code to allow compatibility if custom modules are using it. Removed completely from v22.

*'''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.

*'''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_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)

*'''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_REPEATCONTACTONEACHTAB''' ► If added and set to <code>1</code>, 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_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.

*'''MAIN_SERVER_TZ''' ► If you can't set the time zone of your PHP installation, set this constant. Better is to set it to UTC. In future, this constant will be forced to '<code>UTC</code>' so PHP server time zone will not have effect any more. Examples: <code>Europe/Paris</code>, <code>auto</code>.

*'''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_SEARCHFORM_SUPPLIER_INVOICE_DISABLED''' ► Disable the supplier invoice on the search form

*'''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to <code>1</code> will take you direct to the item (default method). Setting the value to <code>0</code> will show the result in the list as a single result ► (v5.0+)

*'''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► If seller and buyer are in Europe and buyer is not a company, use the VAT of buying country. It can have value '1' or '2'. If value 2, the VATs available to select only the ones of buying country. If '1', the VATs available to select mix the ones of selling country and the ones of buying country. ► (v18.0+)

*'''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into JavaScript console. Better when xdebug is enabled.

*'''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).

*'''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)

*'''MAIN_USE_ALTERNATE_TRANSLATION_FOR''' ► List of fields per object that need an alternate translation. Example: <code>MAIN_USE_ALTERNATE_TRANSLATION_FOR=societe:name,town;contact:firstname,lastname</code>

*'''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_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.

*'''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_OLD_SEARCH_FORM''' ► Display the old search form in left menu.

*'''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to force the VAT rate to a given value (instead of higher VAT rate of country) if the VAT rate of product was not defined.

*'''MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES''' ► If we can't guess if a thirdparty is a company or individual (not VAT ID fill, no Prof ID fill, no type of thirdparty fill), then we suppose it is a company (B2B business) if 1, we suppose it is an individual (B2C business) if 0.

*'''MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL''' ► For intra CEE sales, we use by default, on proposal, order or invoice creation, a 0 VAT for customers that are companies (see MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES to change behaviour to know if a thirdparty is a company or an individual). But if the option MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL is set, we will use the 0 VAT only if a VAT ID is defined for the customer.

*'''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► For to use the default VAT of product for individual customers that are out E.E.C. (European Economic Community) ► (v7.0+). ''There is no reason to use this.''

*'''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number for each line of products/services at documents like proposal / order / invoice. Only on screen, not on PDF.

*'''MAIN_VIEW_LINE_NUMBER_IN_LIST''' ► Shows a line number in lists ► (v12.0)

*'''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)

*'''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (<code>0=kg</code>, <code>-3=g</code>, ...)

*'''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)

*'''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (<code>0=kg</code>, <code>-3=g</code>, ...)

*'''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox.

*'''MAIN_DISABLE_PDF_THUMBS''' ► Disable thumbs PDF in case of imagick bug

*'''MAIN_KEEP_REF_CUSTOMER_ON_CLONING''' ► Keep the Customer Reference on cloned object (Propal/Invoice)

*'''MAIN_DONT_KEEP_NOTE_ON_CLONING''' ► Remove the object notes during cloning ► (v11.0)

*'''MAIN_DOC_SORT_FIELD''' ► Set the default sorting field on document page (name by default) ► (v11.0)

*'''MAIN_DOC_SORT_ORDER''' ► Set the default sorting order (ASC or DESC) on document page (ASC by default) ► (v11.0)

*'''MAIN_USE_ZIPTOWN_DICTIONNARY''' ► Use dictionary ZIP for create card.

*'''MAIN_USE_TOP_MENU_SEARCH_DROPDOWN''' ► Show search in top menu with theme eldy ► (v11.0)

*'''MAIN_PHONE_SEPAR''' ► Separ phone number other space ► (v12.0)

*'''GRAPH_USE_FISCAL_YEAR''' ► Widgets uses fiscal year

*'''SHOW_SOCINFO_ON_PRINT''' ► Permit to add user company information on each printed document (when click on Dolibarr print button) ► (v12.0)

*'''MAIN_FEATURES_LEVEL''' ► Level of features to show: <code>-1=stable+deprecated</code>, <code>0=stable only (default)</code>, <code>1=stable+experimental</code>, <code>2=stable+experimental+development</code>

*'''MAIN_SHOW_TECHNICAL_ID''' ► Show technical id for object.

*'''MAIN_HTTP_CONTENT_SECURITY_POLICY''' ► Allows you to fill in the content security rules ► (v6.0)

*'''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.

*'''MAIN_MODULE_SETUP_ON_LIST_BY_DEFAULT''' ► If set to "common" the setup module becomes list by defaut

*'''MAIN_PAGESIZE_CHOICES''' ► Configure select field to choose number of lines displayed on listing (<code>10:10,15:15,20:20,30:30,40:40,50:50,100:100,250:250,500:500,1000:1000,5000:5000</code>).

*'''MAIN_USE_TOP_MENU_QUICKADD_DROPDOWN''' ► Add a dropdown menu with shortcuts to create new objects ► (v13.0)

*'''MAIN_EMAILCOLLECTOR_MAIL_WITHOUT_HEADER''' ► Remove the header stored by email collector ► (v13.0)

*'''MAIN_USE_VAT_OF_PRODUCT_FOR_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID'''

*'''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimise interface for a text only browser. This variable is set to 1 automatically if your browser is lynx or links

*'''MAIN_NB_OF_YEAR_IN_WIDGET_GRAPH''' ► Set the number of years visible on some graph of some widgets (2 is default value)

*'''MAIN_CREATEFROM_KEEP_LINE_ORIGIN_INFORMATION'''

*'''API_DISABLE_LOGIN_API''' ►(v14.0)

*'''MAIN_LOGIN_BADCHARUNAUTHORIZED''' ► Add possibility to define bad character unauthorized into login name REGEX expression (Default value is @<>"\') ► (v16.0)
*'''MAIN_SHOW_ALL_FILES_ON_DOCUMENT_TOOLTIP''' ► Add all files visible from the object to be visible from the list of object.
*'''MAIN_LIST_ALLOW_PUBLIC_NOTES''' ► Display public notes on list
*'''MAIN_LIST_ALLOW_PRIVATE_NOTES''' ► Display private notes on list

*'''MAIN_CHECKBOX_LEFT_COLUMN''' ► Display private check boxes on the left ► (v17.0)
*'''MAIN_STATS_GRAPHS_SHOW_N_YEARS''' ► Nb of years to shows in widget and graph ► (v14.0)
*'''MAIN_HOOK_DEBUG''' ► if >=2 the hook in the logs are more verbose ► (v18.0)

*'''MAIN_ENABLE_AJAX_TOOLTIP''' ► if 1 the tooltips are updated with AJAX request ► (v18.0)
*'''MAIN_NO_INPUT_PRICE_WITH_TAX''' ► if 1 the TTC input field is removed from propal/invoices/... ► (v17.0)

*'''MAIN_DISABLE_SELECT2_FOCUS_PROTECTION''' ► if 1 disable the focus protection ► (v17.0)
*'''MAIN_USE_ADVANCED_PERMS ►''' Add advanced user permission

*'''MAIN_FREE_PRODUCT_CHECKED_BY_DEFAULT ►''' Check "product" or "service" by default on order/invoices/propal cards (set value "product" or "service")
*'''MAIN_LINK_BY_REF ►''' Allow to link documents by choosing the type and ref from the object linked option

'''Official supported option'''

The following options are not hidden option. They are available by default from the interface.

*'''MAIN_ONLY_LOGIN_ALLOWED ►''' Activate maintenance mode and set user that is allowed to login. Value must be user login. Available into menu Home - Admin tools - User session, it is filled with admin user when clicking on button "Block other session".

[[#Top|(back to top)]]

=Security Options=

*'''MAIN_SECURITY_ANTI_SSRF_SERVER_IP''' ► Can set a complete list of IPs of server.

*'''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (so a POST from another web site can't be done). Note there is also a default protection using test on referrer that is not reliable. This second protection uses TOKEN on forms and is more powerful. Value can be: 0=CSRF protection disabled; 1=CSRF protection is on POST URLs only (default from version Dolibarr 15.0+); 2=CSRF protection is required on POST + some GET URL that contains some white listed parameters like the parameter "action" used to request database change (default from version Dolibarr 16+), 3=CSRF protection is enabled on any POST and GET URLs (a valid CSRF token is expected whatever are the parameters, warning: can be enabled on Dolibarr but some external modules developped by thirdparty may not be ready yet with this option)

*'''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_ALLOW_SVG_FILES_AS_IMAGES''' ► Allow to use SVG file as image files. Warning: This may introduce security vulnerability (javascript can be embedded into SVG file).

*'''MAIN_RESTRICTHTML_ONLY_VALID_HTML''' ► Refused parameter if value is not a valid HTML content. The content is also sanitized with Tidy.

*'''MAIN_RESTRICTHTML_ONLY_VALID_HTML_TIDY''' ► Refused parameter if value is not a HTML content validated by Tidy PHP library. The content is also sanitized with Tidy.

*'''MAIN_RESTRICTHTML_REMOVE_ALSO_BAD_ATTRIBUTES''' ► Sanitize also non standard attributes on HTML content.
*'''MAIN_SECURITY_SALT''' ► A salt string to base the hashing on. 8 strings length recommended.

*'''MAIN_SECURITY_MAX_IMG_IN_HTML_CONTENT''' ► Maximum number of Images on the HTML content
*'''MAIN_SECURITY_ALLOW_UNSECURED_LABELS_WITH_HTML''' ► Allow HTML tags into products label

*'''MAIN_SECURITY_FORCERP''' = "strict-origin-when-cross-origin" (default) so browser doesn't send any referrer when going into another web site domain / "same-origin" / "strict-origin"

[[#Top|(back to top)]]

=Adherent Module=

*'''MEMBER_NEWFORM_FORCEMORPHY''' ► Force nature of member set to "phy" for physical or to "mor" for moral ► (v12.0)
*'''MEMBER_ALLOW_CHANGE_OF_TYPE''' ► Member can edit their type on public subscription page ► (v13.0)
*'''ADHERENT_DEFAULT_CREATE_THIRDPARTY''' ► Thirdparty is created when creating a new member ► (v13.0)
*'''MEMBER_SUBSCRIPTION_SUGGEST_END_OF_MONTH''' ► If set to 1, the member subscription end date will be suggested for the end of the month ► (v18.0)
*'''MEMBER_SUBSCRIPTION_SUGGEST_END_OF_YEAR''' ► If set to 1, the member subscription end date will be suggested for the end of the year ► (v18.0)
*'''MAIN_NB_OF_YEAR_IN_MEMBERSHIP_WIDGET_GRAPH''' ► If set, it limits the number of years visible on graph and widgets of membership (empty is default value to show all) ► (v18.0)

[[#Top|(back to top)]]

=Accountancy Module=

*'''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)
*'''ACCOUNTING_DEFAULT_NOT_NOTIFIED_VALIDATION_DATE''' ► Avoid validating the lines with the accountancy export.(1= box unchecked by default / 0 = box checked by default) ► (v14.0)
*'''ACCOUNTING_DEFAULT_NOT_NOTIFIED_EXPORT_DATE''' ► Avoid flagging the lines as exported with the accountancy export.(1= box unchecked by default / 0 = box checked by default) ► (v14.0)
*'''ACCOUNTANCY_USE_PRODUCT_ACCOUNT_ON_THIRDPARTY ►''' Add 2 fields on thirdparty card which allow you to set an account for all sells products and an other for all buying products for this customer ► (v14.0)

[[#Top|(back to top)]]

=Agenda Module=

*'''AGENDA_ALL_CALENDARS''' ► Change the default view of calendar pages to see all the Agenda's (instead or yours only be default)

*'''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.

*'''AGENDA_DISABLE_LOCATION''' ► Disable location field in action card ► (>=v5.0)

*'''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.

*'''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event ('''''deprecated''''').

*'''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)

*'''AGENDA_SUPPORT_PRIORITY_IN_EVENTS''' ► Allow to have priorities in events ► (>=v13.0)

*'''AGENDA_ADDACTIONFORPHONE''' ► Allow you to create a event from phone number ► (=<v12.0) - Need to be fix for (=>v12.0) https://github.com/Dolibarr/dolibarr/issues/22720

*'''AGENDA_ADDACTIONFOREMAIL''' ► Allow you to create a event from Email ► (=<v12.0) - Need to be fix for (=>v12.0) https://github.com/Dolibarr/dolibarr/issues/22720
*'''MAIN_ACTIONCOM_CAN_ADD_ANY_CONTACT''' ► Allow you to add any contact on events if set at 1a https://github.com/Dolibarr/dolibarr/releases/tag/18.0.0

[[#Top|(back to top)]]
=Bank Module=

*'''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)

*'''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature

*'''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order

*'''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal

*'''BANK_USE_OLD_VARIOUS_PAYMENT''' ► To allow to enter miscellaneous payments (not covered by other modules) using old method. '''''Deprecated'''''. Entering various payment is preferred ► (<=v12.0).
*'''MAIN_IBAN_IS_NEVER_MANDATORY''' ► IBAN and BIC informations not mandatory. (V15)

[[#Top|(back to top)]]

 

=BOM and MO Module=

*'''ALLOW_USE_KITS_INTO_BOM_AND_MO'''
*'''BOM_SUB_BOM''' ►Allow to add a BOM in another BOM►(v16.0)

[[#Top|(back to top)]]

 

=Bookmarks Module=

*'''BOOKMARKS_SHOW_IN_MENU''' ► Numbers of bookmark entries to be displayed (10 by default)

[[#Top|(back to top)]]

 

=Inalterable Log Module=

*'''BLOCKEDLOG_ADD_ACTIONS_SUPPORTED''' ► Can complete list of triggered action that are logged
*'''BLOCKEDLOG_USE_REMOTE_AUTHORITY''' ► URL of the remote authority for the blockchain

[[#Top|(back to top)]]

 

=Category-Tags Module=

*'''CATEGORY_SHOW_COUNTS''' ► Shows nb of object by tags in tag tree

[[#Top|(back to top)]]

 

=Contracts=

*'''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.
*'''CONTRACT_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+)
*'''CONTRACT_HIDE_PLANNED_DATE_ON_PDF''' ► allows you to not display dates on pdf files.
*'''CONTRACT_HIDE_REAL_DATE_ON_PDF''' ► allows you to not display dates on pdf files.
*'''CONTRACT_HIDE_PRICE_ON_PDF''' ► allows you to not display price on pdf files.
*'''CONTRACT_HIDE_QTY_ON_PDF''' ► allows you to not quantity dates on pdf files.

[[#Top|(back to top)]]

=Cron module=

*'''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]].

*'''CRON_DISABLE_TUTORIAL_CRON''' ► Disable the tutorial about how to install the cron script (on a SaaS hosting, this should be done by the web hosting provider)

*'''CRON_WARNING_DELAY_HOURS''' ► Set this value to the frequency set for the cron script (so a warning will be shown to user to warn it about max frequency of its scheduled jobs)

[[#Top|(back to top)]]

 

=Direct Debit Orders=

*'''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.

[[#Top|(back to top)]]

=Donation Module=

*'''DONATION_USE_THIRDPARTIES''' ► If this option is set, a thirdparty field appear on donation forms.

[[#Top|(back to top)]]
=Email=

*'''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachment document on event auto generated by sending email from dolibarr. ► (v6.0+)

*'''MAIN_EMAIL_USE_LAYOUT'''► Enable the use of predefined layout when writing an email.

*'''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate JavaScript code to disable the enter key in the MAIL form. ► (>= 8.0.1)

*'''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>.

*'''MAIN_MAIL_DEBUG_ERR_WITH_DATE''' ► Use a different filename (by adding a prefix of date) for each email sent with error when MAIN_MAIL_DEBUG.

*'''MAIN_MAIL_DEBUG_LOG_WITH_DATE''' ► Use a different filename (by adding a prefix of date) to log each email sent (whatever is result) when MAIN_MAIL_DEBUG.

*'''MAIN_MAIL_FORCE_FROM''' ► (v19+) Can force the value into the From field of the SMTP header. Note that email sender is always saved into the "Reply-To".

*'''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 setup or version of sendmail that ask the -f option to be mandatory or for sendmail setup that does not use by default the From of the header email to define the sender (with this option, the from can be forced on command line to avoid to have the from lost by sendmail).

*'''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.

*'''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.

*'''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>

*'''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email

*'''MAIN_MAIL_FORCE_NOT_SENDING_TO''' ► If en email is defined into this variable, emails will never be sent to this email.

*'''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.

*'''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.

*'''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.
*'''MAIL_FORCE_DELIVERY_RECEIPT_SUPPLIER_PROPOSAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Supplier Proposal'' module.

*'''MAIN_EMAIL_SUPPORT_ACK ►''' Restore email acknowledgment checkbox on sending emails. This feature is commonly abandoned by mailers. Active from Dolibarr V17 - see [https://github.com/Dolibarr/dolibarr/blob/33744f74da1a5c20f8aa9950018ab4e549e00205/ChangeLog#L53 changelog]
*'''MAIN_EMAIL_USECCC''' ► 1 = Shows field BCC into email forms, If value is an email = Shows the BCC pre filled with the email value.

*'''MAIN_MAIL_AUTOCOPY_PROPOSAL_TO''', '''MAIN_MAIL_AUTOCOPY_ORDER_TO''', '''MAIN_MAIL_AUTOCOPY_INVOICE_TO''', '''MAIN_MAIL_AUTOCOPY_SHIPMENT_TO''', '''MAIN_MAIL_AUTOCOPY_..._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)

*'''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.

*'''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.

*'''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.

*'''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+
*'''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+)

*'''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.

*'''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. You can also set the URLs where to get the IP addresses, for exemple: "https://ipv4.urltoshowip.com/_service_showmyip.php,https://ipv6.urltoshowup.com/_service_showmyip.php. So when your customer go into the setup area of email:
**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.
**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'''.

*'''MAIN_IMAP_USE_PHPIMAP''' ► Use embedded PHP-imap library (not using the native php imap) instead of native php imap extension ► (v17.0+, available as official option in setup of emailcollector by default from v19)

*'''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)

*'''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)

[[#Top|(back to top)]]

=SMS=

*'''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.

[[#Top|(back to top)]]

=Emailing Module=

*'''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.

*'''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 <code>'''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''</code>.

*'''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.

*'''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.

*'''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.
*'''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.

*'''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.

*'''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.

[[#Top|(back to top)]]

 

=Expense Report=

*'''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)

*'''EXPENSEREPORT_OVERRIDE_VAT''' ► Setting this constant to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)

*'''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+)

*'''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometres against a mileage index for different types of vehicles. ► (v7.0+)

*'''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+)

[[#Top|(back to top)]]

 

=Export Module=

*'''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>

*'''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>

*'''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"

*'''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>).
*'''EXPORTS_SHARE_MODELS''' ► Share export models between users.

[[#Top|(back to top)]]

=Foundation Module=

*'''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.

*'''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.

[[#Top|(back to top)]]

 
=Holiday Module=

*'''HOLIDAY_HIDE_BALANCE''' ► Hide the user's vacation balance on the vacation request page

[https://wiki.dolibarr.org/Setup_Other#Top (back to top)]
=Interventions Module=

*'''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.

*'''FICHINTER_DISABLE_DETAILS'''► Disable entry of detail lines on intervention. Can validate with no line. Only one line will be shown per intervention on list.
**If set to <code>2</code> details are disabled only on intervention list ► (v21.0+)

[[#Top|(back to top)]]

=Invoice Module=

*'''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)

*'''INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED''' ► If a credit note was partially refunded (a refund was sent to the customer), with common situation, we wait to have the remain refunded too. With this option, it is possible to convert the remain of invoice into a discount to reuse it into another invoice.

*'''SUPPLIER_INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED''' ► See INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED, but for supplier credit notes.

*'''INVOICE_CAN_BE_EDITED_EVEN_IF_PAYMENT_DONE''' ► 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.

*'''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.

*'''INVOICE_CAN_NEVER_BE_EDITED''' ► Never allow to edit invoices (except draft invoices with ref like (PROV%)). See also INVOICE_CAN_NEVER_BE_REMOVED.

*'''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices with ref like (PROV%)). See also INVOICE_CAN_NEVER_BE_EDITED

*'''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.

*'''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► An old way to create initial payment. This treats deposit invoices as a special case and not as legal deposit invoice. 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.

*'''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".

*'''INVOICE_CREDIT_NOTE_STANDALONE''' ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)

*'''INVOICE_USE_SITUATION''' ► 1=Enable the "situation invoice" feature. Warning, this feature is bugged and may not be compatible with the final version of the feature once the bug will be solved. Also, using the double-entry accountancy module is not possible when this option is on (due to the same design problem). 2=Enable the "situation invoice" feature with a rewrite. This mode should be better to become a future stable feature.

*'''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)
*'''INVOICE_USE_RETAINED_WARRANTY''' ► Enable the retained warranty on invoice ► (v14.0)

*'''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices

*'''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices

*'''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes

*<bdi>'''INVOICE_ADD_EXTRAFIELD_IN_NOTE''' ► Add extrafields in note for canelle template ► (v17.0+)</bdi>

*'''INVOICE_DEFAULT_NOTE_PUBLIC''' <bdi>► Default text in public note</bdi>

Note: To decode a QR image of a ZATCA code: https://www.onlinebarcodereader.com/. You can also use the mobile application https://play.google.com/store/apps/details?id=com.posbankbh.einvoiceqrreader&gl=FR

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► See PDF option

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► See PDF options

*'''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments

*'''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+)

*'''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)
*'''FACTURE_ENABLE_NEGATIVE''' ► Can validate an invoice when amount is negative

*'''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)

*'''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+)

*'''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.
*'''FACTUREFOURN_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object when creating the supplier bill ► (V13.0)
*'''MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST''' ► Display the reference of credit notes in discount list when creating the bill.
*'''INVOICE_ALLOW_FREE_REF''' ► Capability 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)

*'''INVOICE_DISALLOW_REOPEN'''

*'''INVOICE_MAX_FUTURE_DELAY''' ► Numbers of seconds allowed for billing in the future ► (V14.0)
*'''INVOICE_AUTO_NEXT_MONTH_ON_LINES''' ► Increase start date and end date by one month, if an invoice line is a clone of a time based service AND if this services started on the first day of month and ended on the last day of month ► (V13.0.1)
*'''INVOICE_KEEP_DISCOUNT_LINES_AS_IN_ORIGIN''' ► Does not change a line with a negative price into an absolute discount when creating an invoice ► (V16 ?)
*'''INVOICEREC_SET_AUTOFILL_DATE_START''' and '''INVOICEREC_SET_AUTOFILL_DATE_END ►''' Set start and end date to yes for lines of template invoice when created from a draft invoice ► (V16)
*'''INVOICE_REC_DATE_TO_YES''' '''►''' Set start and end date to yes by default in add line form for template invoice ► (V16)
*'''INVOICE_SUBTYPE_ENABLED''' ► Extends Dolibarr standard invoice with more invoice types used in some countries. A combo box in the new invoice creation card allows the selection of "subtypes" with values from dictionary "Invoice Subtypes" ► (v19.0+)
*'''LIST_OF_QUALIFIED_INVOICES_LIMIT_DEFINED''' '''►''' Perf options to limit list of invoices for "credit note" source (on form "create a credit note"), usable for big quantities of invoices for one customer like you can have with TakePos ► (V22+)

[[#Top|(back to top)]]

=Leave=

*'''MAIN_NON_WORKING_DAYS_INCLUDE_SATURDAY''' ► Set this value to 0 if you want to have the Saturday as a working day
*'''MAIN_NON_WORKING_DAYS_INCLUDE_SUNDAY''' ► Set this value to 0 if you want to have the Sunday as a working day

=Look or Theme=

*'''MAIN_FAVICON_URL''' ► favicon url

*'''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)

*'''MAIN_STATUS_USES_CSS''' ► Change status design using new style ► (v10.0+)

*'''MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD''' ► 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) ► (v11.0+)

*'''MAIN_USE_TOP_MENU_SEARCH_DROPDOWN''' ► Actually only for eldy theme, this conf move search input to top menu and use new design too ► (v11.0+)

*'''THEME_AGRESSIVENESS_RATIO''' ► This conf can be used to increase/decrease aggressiveness of colors. Value 0 is medium, value is between -100 (light grey colors) to +100 (very flashy colors) ► (v11.0+)

*'''THEME_SHOW_BORDER_ON_INPUT'''
*'''MAIN_DISABLE_GLOBAL_WORKBOARD''' ► Hide the work board of the main page ► (v13.0+)
*'''MAIN_DISABLE_GLOBAL_BOXSTATS''' ► Hide the Statistic Box of the main page
*'''ALLOW_THEME_JS ►''' Allow JS file in theme folder (same name as theme folder)

 

=Manifest (Progressive Web App)=

*'''MAIN_MANIFEST_APPLI_THEME_COLOR ►''' Theme color for manifest
*'''MAIN_MANIFEST_APPLI_BG_COLOR ►''' Background color for manifest
*'''MAIN_MANIFEST_APPLI_LOGO_URL ►''' Logo for manifest
*'''MAIN_MANIFEST_APPLI_LOGO_URL_SIZE ►''' Logo url size for app (150, 192, 512px) missing 3 configurations

[[#Top|(back to top)]]

=Order Module=

*'''MAIN_MASSACTION_CREATEBILLS_REDIRECT_IF_ONE''' ► If set 1, redirects to the one bill created from massaction create bills from order list ► (v20.0)

*'''MAIN_MASSACTION_CREATEBILLS_REDIRECT_IF_MANY''' ► If set to 1, redirects to the invoice list after plural invoices where generated from tho massaction create bills from order list ► (v20.0)

*'''MAIN_ORDERLIST_CREATEBILLS_ONEBYTHIRD''' ► Allow defining value for option "one by thirdparty" in massaction create bills from orders list page (no by default, yes if set to 'yes' or 1) ► (v20.0)

*'''MAIN_USE_PROPAL_REFCLIENT_FOR_ORDER''' => Copy customer reference from proposal to order. ► (v7.0+)

*'''ORDER_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.

*'''ORDER_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".

*'''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+)

*'''ORDER_ENABLE_NEGATIVE''' => Can validate an order when amount is negative

*'''THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER''' => Copy also extrafields from thirdparty to order (if name match). ► (v11.0+)
*'''ORDER_DEFAULT_NOTE_PUBLIC''' ► Default text in public note
*'''MAIN_REMOVE_DROPDOWN_CREATE_BUTTONS_ON_ORDER''' => Remove the create dropdown button on order card (introduce on v19) to come back with old buttons. '''►''' (v20.0+)

[[#Top|(back to top)]]

 

=PDF Options=

*'''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]].

*'''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. Values : 0= Default (file is auto downloaded), 1= For to output the file into the browser tab, 2= For to output the file into a browser tab open with target_blank

*'''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.

*'''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.

*'''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>.

*'''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default

*'''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.
*'''MAIN_GENERATE_ORDERS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer orders.

*'''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.

*'''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+)
*'''MAIN_GENERATE_SUPPLIER_ORDER_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier orders

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.

*'''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF. Note: This option is set automatically if country if Germany.

*'''MAIN_ODT_AS_PDF''' ► Activate ODT to PDF conversion. Value can be "libreoffice" or "unoconv". Do not use value '''<nowiki/>'jodconverter'<nowiki/>''' any more, as it is declared deprecated and partly not functional, use value '''<nowiki/>'libreoffice'''' instead, it requires only '''soffice''' (OpenOffice or LibreOffice) installed on server (use '''apt install soffice libreoffice-common libreoffice-writer''').

If you got this error: javaldx failed! Warning: failed to read path from javaldx with no return to prompt when running soffice --headless -env:UserInstallation=file:"/tmp" --convert-to pdf --outdir xxx ./yyy.odt, check that directory defined into env:UserInstallation parameters exists and is writeable.

You may also have a look at this page if your server is on Windows: [[Générer automatiquement des documents PDF à partir de fichier ODT avec Doliwamp]]

*'''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

*'''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".

*'''MAIN_PDF_FORCE_FONT_SIZE''' ► To force size of font (by default 10). For example "<code>12</code>" ► (v11.0)

*'''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.

*'''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code>

*'''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 !

*'''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.

*'''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company

*'''MAIN_PDF_ADDALSOTARGETDETAILS''' ► If 1, add details of recipient on generated PDFs (email, fax, url and phone). Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.

*'''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+)

*'''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)

*'''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''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.

*'''PDF_BOLD_PRODUCT_REF_AND_PERIOD''' ► Add more visibility (bold) on product ref and period of service in desc. ► (v12.0)

*'''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.

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...".

Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".

Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".

*'''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.

*'''PDF_SECURITY_ENCRYPTION''' ► Encrypt PDF produced by dolibarr. 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'))). WARNING: if an 'encrypted PDF' provides a protection against manual change done by mistake, it does NOT provide any protection against modification of your PDF in a security point of view: A protected PDF can still be modified by any advanced PDF editors. Don't forget this: If a software can read the PDF, this software can also rebuild it differently !

*'''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)

*'''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).
*'''DOC_SHOW_FIRST_SALES_REP''' ► Show the sales representant on header (at least on propal azur and rubis template)
*'''MAIN_PDF_DASH_BETWEEN_LINES'''
*
*'''SHOW_SUBPRODUCT_REF_IN_PDF'''
*'''PDF_HIDE_PRODUCT_LABEL_IN_SUPPLIER_LINES''' ► hide product label in supplier order lines (V15+)
*'''SHIPPING_PDF_DISPLAY_AMOUNT_HT''' ► Show HT unit price and HT total price for lines of PDF shipment

*'''MAIN_DOCUMENTS_HIDE_DESCRIPTION_FOR_FACTURE''' ► To Hide product description in Customer Invoice
*'''MAIN_DOCUMENTS_HIDE_DESCRIPTION_FOR_COMMANDE''' ► To Hide product description in Sales Order
*'''MAIN_DOCUMENTS_HIDE_DESCRIPTION_FOR_ORDER_SUPPLIER''' ► To Hide product description in Purchase Order
*'''MAIN_DOCUMENTS_HIDE_DESCRIPTION_FOR_INVOICE_SUPPLIER''' ► To Hide product description in Vendor Invoice

*'''PDF_PROPAL_SHOW_PRICE_INCL_TAX''' ► Display price with tax on Proposal(cyan template), Order(eratosthene template), Bill(sponge template) (V17+)

*'''PDF_USE_GETALIASNBPAGE_FOR_TOTAL''' ► Display the page number alias
*'''MAIN_PDF_NO_SENDER_FRAME''' ► Do not display the "sender" mention
*'''MAIN_PDF_HIDE_SENDER_NAME''' ► Do not display the sender name
*'''MAIN_PDF_NO_RECIPENT_FRAME''' ► Do not display BillTo

[[#Top|(back to top)]]

=Point of Sale (POS)=

*'''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.

*'''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).

*'''TAKEPOS_ENABLE_SUMUP''' ► Enable the compatibility of TakePOS with the card reader terminal [https://SumUp.fr SumUp]
*'''TAKEPOS_CAN_FORCE_BANK_ACCOUNT_DURING_PAYMENT''' ► Possibility to force the bank account during the payment in TakePOS ► (v13.0)
*'''TAKEPOS_CONTROL_CASH_OPENING''' ► Control the cash opening
*'''TAKEPOS_NUMPAD_FORCE_PAYMENT_ICONS_LABELS'''

[[#Top|(back to top)]]

=Products Module=

*'''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen

*'''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid customs code and country of origin to be set as product description when added to Propal/Order/Invoice

*'''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.

*'''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.

*'''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+)

*'''MAIN_SEARCH_PRODUCT_BY_FOURN_REF''' ► Allow to search a product by supplier ref in document's add line form. ► (>= 8.0)

*'''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)

*'''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+)

*'''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.

*'''PRODUCT_DISABLE_PROPAGATE_CUSTOMER_PRICES_ON_CHILD_COMPANIES''' ► Disable propagation of prices per customer from a customer to its child company.

*'''PRODUCT_DISABLE_PUBLIC_URL''' ► Disable public url in product card ► (v14.0+)
*'''PRODUCT_DISABLE_STOCK_LEVELS''' ► Disable properties of stock limits and desired optimal value on product ► (v14.0+)
*'''PRODUCT_DISABLE_NATURE''' ► Disable nature in product card ► (v14.0+)
*'''PRODUCT_DISABLE_WEIGHT''' ► Disable weight in product card ► (v14.0+)
*'''PRODUCT_DISABLE_PRICES''' ► Disable prices in product card ► (v14.0+)
*'''PRODUCT_DISABLE_ACCOUNTING''' ► Disable accounting in product card ► (v14.0+)
*'''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.

*'''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► (v4.0+)

*'''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► (v4.0+)

*'''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.

*'''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.

*'''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.

*'''PRODUIT_CUSTOMER_PRICES_BY_QTY''' ► If price per quantity ► ''Experimental''
*'''PRODUIT_CUSTOMER_PRICES_BY_QTY_MULTIPRICES''' ► If price per quantity and customer ► ''Experimental''

*'''PRODUCT_LOT_ENABLE_QUALITY_CONTROL''' ► Enable feature (Display fields for life time and quality control duration) for quality control on product and lot

*'''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders

*'''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.

*'''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF

*'''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.

*'''PRODUCT_USE_UNITS''' ► Add other units on products (Use same dictionary as default unit feature) and propagate this unit on line of documents.
*'''MAIN_EDIT_LINE_ALLOW_ALL_UNIT_TYPE ►''' Allow the selection of other unit types when editing the document line

*'''RESOURCE_ON_PRODUCTS''' ► Allow to affect resources on products/services ► (v10.0+)
*'''RESOURCE_ON_SERVICES''' ► Allow to affect resources on products/services ► (v10.0+)
*'''PRODUCT_SHOW_ORIGIN_IN_COMBO''' ► Show origin of products when adding lines in proposals/invoices/orders ► (v12.0+)
*'''PRODUIT_ATTRIBUTES_HIDECHILD''' ► Add option hide child if variantes

*'''PRODUCT_ADD_FORM_ADD_TO''' ► Add a product to a draft proposal/order/invoice, from the product card.
*'''PRODUCT_DISABLE_SELLBY''' ► Hide the Sell by date ► (v13.0+)
*'''PRODUCT_DISABLE_EATBY''' ► Hide the Eat by date ► (v13.0+)

*'''PRODUCT_DENY_CHANGE_PRODUCT_TYPE''' ► Forbid to change the product type

*'''PRODUCT_SORT_BY_CATEGORY''' ► Sort the product by categories instead of by ID
*'''PRODUCT_ADD_NET_MEASURE''' ► Support Net Measure in product's card.php (For real weight, volume or piece; needed for some business ie fruits, vegetables....). Note brut value is already available natively, use this option only if you need 2 weights, 2 volumes, ...for each product) ► (v11.0.1+)
*'''PRODUCT_PRICE_BASE_TYPE''' ► value 'TTC' / 'HT' specify the default value of the price (with or without taxes) ► (v16.0.0+)

*'''PRODUCT_LOAD_EXTRAFIELD_INTO_OBJECTLINES''' ► Load product extrafiled on object lines

*'''PRODUCT_USE_SUB_COST_PRICES_IF_COST_PRICE_EMPTY''' : Calculate the parent product production price by child prices.
*'''PRODUCT_SEARCH_AUTO_SELECT_IF_ONLY_ONE''' : Set to 0 to disable or 1 to enable (by default) the auto select product behavior in combobox when there is only one result.(v21.0+)

[[#Top|(back to top)]]

 

=Projects Module=

*'''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Option related to the combo list Project on elements. It is a list of thirdparty IDs. If set, you can link an object to a project owned by one of this thirdparty in the list.

*'''PROJECT_ALLOW_COMMENT_ON_PROJECT''' ► Add comment feature on a project

*'''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task
*'''PROJECT_ALWAYS_DISCARD_CLOSED_PROJECTS_IN_SELECT''' ► Discards closed projects in every select field. A closed project can't be associated to an object ► (v20.0+)

*'''PROJECT_CAN_ALWAYS_LINK_TO_ALL_SUPPLIERS''' ► Option related to the combo list Project on elements. Can link an element (purhcase invoice, purchase order, reception, ...) to any project even if object has a different supplier than the one of the project to link to. See also PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY that is different because it allows to define some given thirdparty ID to allow.

*'''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview pagec

*'''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= v8.0.1)

*'''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)

*'''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.

*'''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.

*'''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (v4.0)

*'''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)

*'''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).

*'''PROJECT_OPEN_ALWAYS_ON_TAB''' ► Set to value 'task', or 'preview' to always open the project on the given tab instead of main tab.

*'''PROJECT_ELEMENTS_FOR_MINUS_MARGIN'''

*'''TIMESPENT_ALWAYS_UPDATE_THM''' ► when it's on always check current time of user to update it in task time line ► (v17.0)
*'''PROJECT_ENABLE_SUB_PROJECT''' ► Add support for parent projects ► (v19.0)

[[#Top|(back to top)]]

=Proposals Module=

*'''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.

*'''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.

*'''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)

*'''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.

*'''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.

*'''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF

*'''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+)

*'''PROPOSAL_AUTO_ADD_AUTHOR_AS_CONTACT''' ► Add Proposal Author as user contact follow proposal

*'''PROPOSAL_PDF_HIDE_PAYMENTTERM''' ► Do not show the payment term on proposal ► (v11.0+)

*'''PROPOSAL_PDF_HIDE_PAYMENTMODE''' ► Do not show the payment mode on proposal ► (v11.0+)

*'''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.
*'''PROPAL_REOPEN_UNSIGNED_ONLY''' ► Do not allow reopening of signed (or billed) proposals. (V15)
*'''PROPOSAL_ARE_NOT_BILLABLE''' ► Disable billing button on proposals (V15)
*'''PROPAL_DEFAULT_NOTE_PUBLIC''' ► Default text in public note

[[#Top|(back to top)]]

 

=Services Module=

*'''SERVICE_ARE_ECOMMERCE_200238EC''' ► If seller and buyer are in Europe and buyer is not a company, use the VAT of buying country. For french speaking people, see also the page [[Loi_européenne_TVA_Vente_à_Distance_VAD_et_e-commerce_BtoC]].

*'''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

[[#Top|(back to top)]]

=Shipments=

*'''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)

*'''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity
*'''SHIPPING_PDF_HIDE_ORDERED''' ►Hide column quantity ordered on shipment pdf (>=15.0)
*'''STOCK_SUPPORTS_SERVICES''' ►Allow to manage services into warehouse and allow to ship services
*'''SHIPMENT_SUPPORTS_SERVICES''' ►Allow to ship services without stock (>=19.0)
*'''SHIPPING_DISPLAY_STOCK_ENTRY_DATE''' ►Display date entry stock exped and sort in date order (>=19.0)

[[#Top|(back to top)]]

=Stocks=

*'''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received

*'''STOCK_EXCLUDE_VIRTUAL_PRODUCTS''' ► If product is a virtual product, we do not manage stock for it.
*'''STOCK_ALLOW_DELETE_OF_MOVEMENT''' ► Enable massaction option to delete in movements list (be carefull !!).

*'''ENTREPOT_EXTRA_STATUS''' ► Instead of the 2 status (Closed, Open), a Warehouse has 3 status: Closed, Open (for all movements), Open (for internal movement only). Internal movement only means you can't use the warehouse to make shipment or receptions.

*'''SUPPLIER_ORDER_STATUS_FOR_VIRTUAL_STOCK''' ► For the calculation of virtual stocks, by default supplier orders with the status 3 (ordered) and 4 (partially received) are used. You can enter the list of statuses to be taken into account separated by commas for this calculation (example: 0,1,2,3)

*'''STOCK_MOVEMENT_LIST_HIDE_UNIT_PRICE''' ► to hide unit price on some pages (V15+)

*'''DISABLE_QTY_OVERWRITE''' ► Disable quantity overwrites on inventories ► (v19.0)
*'''MAIN_WAREHOUSE_LIST_DISPLAY_MODE''' ► Change warehouse select list display mode ► (v21.0) (see github pull request [https://github.com/Dolibarr/dolibarr/pull/31013 #31013] for more info)
**0 : Default behavior, display parents of warehouse
**1 : Display only current warehouse label only
**2 : Display last parent warehouse label

[[#Top|(back to top)]]

=Suppliers Module=

*'''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.''

*'''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.

*'''SUPPLIER_INVOICE_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier invoice to only those with a buying price defined for that supplier. ► (v6.0+)

*'''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.

*'''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).

*'''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)

*'''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.

*'''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+)

*'''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+)

*'''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+)

*'''DISPLAY_DISCOUNTED_SUPPLIER_PRICE''' ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)

*'''MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER''' ► Allow to change the supplier on a draft supplier order ► (v10.0)

*'''SUPPLIER_PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD'''

*'''SUPPLIER_ORDER_CAN_UPDATE_BUYINGPRICE_DURING_RECEIPT''' ► Allow to change price on receipt ► (v19.0)

*'''SUPPLIER_HIDE_SUPPLIER_OBJECTLINES''' ► Hide the supplier information on objectlines (invoices, etc..) ► (v19.0)

[[#Top|(back to top)]]

=Third Parties Module=

*'''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)

*'''MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES''' ► See in Global options section.

*'''MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL''' ► See in Global options section.

*'''SOCIETE_EMAIL_MANDATORY''' ► E-mail is a mandatory field when creating a thirdparty

*'''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers

*'''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects
*'''SOCIETE_DISABLE_PROSPECTSCUSTOMERS ►''' Remove the status "Customer/Prospect" when thirdparties creation or modification

*'''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"

*'''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.

*'''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation
*'''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

*'''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.

*'''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.

*'''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.

*'''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".

*'''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.

*'''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).

*'''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.

*'''THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION''' ► Enabled contact creation on third-party create card
*'''THIRDPARTY_QUICKSEARCH_ON_FIELDS''' ► Personalized search criteria ► Example: $conf->global->THIRDPARTY_QUICKSEARCH_ON_FIELDS = 's.nom=ThirdPartyName;s.name_alias=AliasNameShort;s.code_client=CustomerCode'
*'''MEMBER_CAN_CONVERT_CUSTOMERS_TO_MEMBERS''' ► Enabled member creation on third-party create card
*'''SOCIETE_DISABLE_PARENTCOMPANY''' ► Disables attachment to a parent company.
*'''THIRDPARTY_CUSTOMERPROSPECT_BY_DEFAULT''' ► Set the third party to customer by default
*'''THIRDPARTY_SUPPLIER_BY_DEFAULT''' ► Set the third party to supplier by default
*'''THIRDPARTY_CUSTOMERTYPE_BY_DEFAULT''' ► Set the third party type by default (3 = customer & prospect / 2 = prospect / 1 = customer )
*'''CONTACT_DISABLE_PERSONALINFO''' ► Disable Personal data on contact page
*'''SOCIETE_DISABLE_WORKFORCE''' ► Disable work force selector on society page
*'''SOCIETE_SHOW_VAT_IN_LIST''' ► display VAT number in combo list of thirdparties ► (V15+)
*'''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► When set, a contact is created at the creation of an individual third party ► (v14.0)

*'''MAIN_SUPPORT_SHARED_CONTACT_BETWEEN_THIRDPARTIES''' ► Able to share contact between several third parties

[[#Top|(back to top)]]

=Ticket Module=

*'''TICKET_SHOW_MESSAGES_ON_CARD''' ►Display all ticket related messages on the main ticket card. ► (>= 10.0)
*'''TICKET_AUTO_ASSIGN_CONTRACT_CREATE''' ►Automatically create a contract linked to the ticket ► (>= 10.0)
*'''TICKET_AUTO_CREATE_FICHINTER_CREATE''' ►Automatically create an intervention linked to the ticket ► (>= 10.0)
*'''TICKET_AUTO_ASSIGN_USER_CREATE''' '''►''' (>= 21.0) 0=No auto assignement, 1=Auto assign current user if no user was set, 2=Auto assign current user even if another user was set.
*'''TICKET_CHECK_NOTIFY_THIRDPARTY_AT_CREATION''' ►Automatically check "notify thirdparty at creation" ( >=16)
*'''TICKETS_MESSAGE_FORCE_MAIL''' ► Pre check email sending on ticket message (>=15)
*'''TICKET_SEND_PRIVATE_EMAIL ►''' Allow a private message to be sent by mail (>=17)
*'''TICKET_LIMIT_VIEW_ASSIGNED_ONLY''' '''►''' Only display tickets assigned to the user
*'''TICKET_ADD_AUTHOR_AS_CONTACT''' '''►''' If set to 1: Automatically adds the author as internal contact. If set to 2: Automatically adds the author as external contact if external user. (>=20)
*'''TICKET_ASSIGN_CONTACT_TO_MESSAGE''' '''►''' If known, the external contact is assigned to the message. (>=19)
*'''TICKET_ALLOW_CLASSIFICATION_MODIFICATION_EVEN_IF_CLOSED''' '''►'''Allow modify ticket classification even if closed. (>=19)
*'''WORKFLOW_TICKET_CLOSE_INTERVENTION''' ►On ticket close, automatically close an intervention linked to the ticket
*'''TICKET_INCLUDE_SUSPENDED_STATUS''' ► Use ticket suspended status (>=19)

=VAT Report=

*'''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)

[[#Top|(back to top)]]

=Website Module=

*'''WEBSITE_USE_WEBSITE_ACCOUNTS''' ► Add a table and a tab to manage some accounts for websites to a third party
*'''WEBSITE_ALLOW_OVERWRITE_GIT_SOURCE''' ► Add a button to export a website over the GIT sources
*'''WEBSITE_ADD_CSS_TO_BODY''' ► Add a CSS class to the body tag of websites

[[#Top|(back to top)]]

 

=WYSIWYG Editor=

*'''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.
*'''FCKEDITOR_ALLOW_ANY_CONTENT''' ► Allow to enter any content. However, this will totally disable content filtering which is one of the most important CKEditor features. You can use this to keep all your tags and attributes in the html content.
*'''FCKEDITOR_ENABLE_SCAYT_AUTOSTARTUP ►''' Allow to activate the SpellCheckAsYouType (SCAYT) plugins of CKEditor i.e an automatic spell checking. The value to activate this option is 1.

[[#Top|(back to top)]]

=STRIPE Module=

*'''STRIPE_FORCE_VERSION''' ► Force the STRIPE version. For Example: "2019-09-09" (v11+)
*'''STRIPE_REUSE_EXISTING_INTENT_IF_FOUND''' ► With this, you will have idempotency key but the payment intention will be reuse and not Generate again (13+)

[[#Top|(back to top)]]

=ClickToDial Module=

*'''CLICKTODIAL_FORCENEWTARGET''' ► Open in new page.

[[#Top|(back to top)]]

 

=For SaaS / Cloud hosting integrators=

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.

*'''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]].

*'''CRON_DISABLE_TUTORIAL_CRON''' ► Disable the tutorial about how to install the cron script (on a SaaS hosting, this should be done by the web hosting provider)

*'''CRON_WARNING_DELAY_HOURS''' ► Set this value to the frequency set for the cron script (so a warning will be shown to user to warn it about max frequency of its scheduled jobs)

*'''MAILING_NO_USING_PHPMAIL''' ► To avoid bad use of the emailing module, it is recommended to set this option 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.

*'''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► If you have set a system limit on number of recipients on your system, you can set also this option to match the same value, so users will be informed: So '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' restricts sending of 1 email message to <code>x</code> recipients for the same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include a ton of 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. Note that this is not a hard limit; it is just the quantity that will be displayed on warnings on screen. For a real limit, this must be implemented into the system.

*'''MAILING_LIMIT_SENDBYDAY''' ► This is a limit of number of emails, an instance can send. Note that this is not a hard limit; it is just the quantity that will be displayed on warnings on screen. For a real limit, this must be implemented into the system.

*'''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)''

*'''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 and remove the upgrade.unlock so the administration tools like install.php, upgrade.php and repair.php can't be used on your customer instance (until the install.lock file is deleted or the upgrade.unlock file is created).

*'''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:
**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.
**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'''.

*'''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.

*'''MAIN_FIRST_PING_OK_ID''' ► Set this value to "disabled" to remove completely any ping after a complete setup.

*'''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'.

*'''MAIN_HIDE_WARNING_TO_ENCOURAGE_SMTP_SETUP''' ► Set to 1 by default (so warning is hidden). You can set it to 0 to show a warning to encourage admin to set its own SMTP service.

*'''MAIN_MAIL_SENDMODE_password''' ► To force the mode to send the email on the "password forgotten" page. So you can decide to use php mail or SMTP method for this specific use case.

*'''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.

*'''MAIN_NO_UPGRADE_REDIRECT_ON_LEVEL_3_CHANGE''' ► The page to make the migration is not shown automatically when you deploy files of version X.Y.Z+delta over an installation with a database version X.Y.Z. The upgrade page will be shown automatically only if there is a change on value of X or Y in version.

*'''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).

*'''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.

[[#Top|(back to top)]]

Extrafield Champ Calculé

2025-07-01T13:07:35Z

Isamuse: /* Afficher le stock réel d'un produit */

==PAGE EN COURS D ECRITURE==

=Principe=

Vous pouvez entrer ici une formule utilisant les propriétés objet ou tout code PHP pour obtenir des valeurs dynamiques. Vous pouvez utiliser toute formule compatible PHP, incluant l'opérateur conditionnel "?", et les objets globaux : $db, $conf, $langs, $mysoc, $user, $objectoffield ($object avant la V17).

[[File:Warning.png]] depuis la V17 il ne faut plus utiliser $object/$obj mais $objectoffield

ATTENTION : Seulement quelques propriétés de l'objet $objectoffield pourraient être disponibles. Si vous avez besoin de propriétés non chargées, créez vous même une instance de l'objet dans votre formule, comme dans le deuxième exemple.
Utiliser un champs calculé signifie que vous ne pouvez pas entrer vous même toute valeur à partir de l'interface. Aussi, s'il y a une erreur de syntaxe, la formule pourrait ne rien retourner.

Exemple de formule:
<syntaxhighlight lang="PHP">
$objectoffield->id < 10 ? round($objectoffield->id / 2, 2) : ($objectoffield->id + 2 * $user->id) * (int) substr($mysoc->zip, 1, 2)
</syntaxhighlight>

Exemple pour recharger l'objet:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetch($objectoffield->id)) ? $reloadedobj->array_options['options_extrafieldkey'] * $reloadedobj->capital / 5 : '-1'
</syntaxhighlight>
Un autre exemple de formule pour forcer le rechargement d'un objet et de son objet parent:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Task($db)) && ($reloadedobj->fetch($objectoffield->id) > 0) && ($secondloadedobj = new Project($db)) && ($secondloadedobj->fetch($reloadedobj->fk_project) > 0)) ? $secondloadedobj->ref : 'Objet parent projet non trouvé'
</syntaxhighlight>

=Type de champ extrafield utilisable=

Numerique Entier
Decimale

Date
Date/heure

Prix

=propriétés d objet utilisable=

{| class="wikitable"
|+ style="width:800px;" |MODULE PRODUIT OBJECT PRODUIT/SERVICE
|-
! style="width:200px;" |NOM DE LA PROPRIETE
! style="width:200px;" |TYPE DE LA PROPRIETE
! style="width:400px;" |CALCULABLE ?
|-
|PRIX
|Decimale
|OUI
|}

=Mise En Application=
$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple addition

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple Multiplication

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple subtraction

==Afficher l'adresse d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->address: ' '
</syntaxhighlight>
==Afficher le champ complémentaire d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->array_options['options_xxxxxxxxx'] : '-1'
</syntaxhighlight>

==Afficher la balance d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? $ret['opened']: 666
</syntaxhighlight>
==Afficher le nombre de facture ouvertes d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? sizeof($ret['refsopened']): 666
</syntaxhighlight>

==Afficher le champ personnalisé d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product))) ? $reloadedobj->array_options['options_xxxxxxxxx'] : 'Not found'
</syntaxhighlight>

==Afficher le stock réel d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product))) ? $reloadedobj-> stock_reel : 'Not found'
</syntaxhighlight>

Extrafield Champ Calculé

2025-07-01T13:05:51Z

Isamuse: /* Afficher le champ personnalisé d'un produit */

==PAGE EN COURS D ECRITURE==

=Principe=

Vous pouvez entrer ici une formule utilisant les propriétés objet ou tout code PHP pour obtenir des valeurs dynamiques. Vous pouvez utiliser toute formule compatible PHP, incluant l'opérateur conditionnel "?", et les objets globaux : $db, $conf, $langs, $mysoc, $user, $objectoffield ($object avant la V17).

[[File:Warning.png]] depuis la V17 il ne faut plus utiliser $object/$obj mais $objectoffield

ATTENTION : Seulement quelques propriétés de l'objet $objectoffield pourraient être disponibles. Si vous avez besoin de propriétés non chargées, créez vous même une instance de l'objet dans votre formule, comme dans le deuxième exemple.
Utiliser un champs calculé signifie que vous ne pouvez pas entrer vous même toute valeur à partir de l'interface. Aussi, s'il y a une erreur de syntaxe, la formule pourrait ne rien retourner.

Exemple de formule:
<syntaxhighlight lang="PHP">
$objectoffield->id < 10 ? round($objectoffield->id / 2, 2) : ($objectoffield->id + 2 * $user->id) * (int) substr($mysoc->zip, 1, 2)
</syntaxhighlight>

Exemple pour recharger l'objet:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetch($objectoffield->id)) ? $reloadedobj->array_options['options_extrafieldkey'] * $reloadedobj->capital / 5 : '-1'
</syntaxhighlight>
Un autre exemple de formule pour forcer le rechargement d'un objet et de son objet parent:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Task($db)) && ($reloadedobj->fetch($objectoffield->id) > 0) && ($secondloadedobj = new Project($db)) && ($secondloadedobj->fetch($reloadedobj->fk_project) > 0)) ? $secondloadedobj->ref : 'Objet parent projet non trouvé'
</syntaxhighlight>

=Type de champ extrafield utilisable=

Numerique Entier
Decimale

Date
Date/heure

Prix

=propriétés d objet utilisable=

{| class="wikitable"
|+ style="width:800px;" |MODULE PRODUIT OBJECT PRODUIT/SERVICE
|-
! style="width:200px;" |NOM DE LA PROPRIETE
! style="width:200px;" |TYPE DE LA PROPRIETE
! style="width:400px;" |CALCULABLE ?
|-
|PRIX
|Decimale
|OUI
|}

=Mise En Application=
$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple addition

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple Multiplication

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple subtraction

==Afficher l'adresse d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->address: ' '
</syntaxhighlight>
==Afficher le champ complémentaire d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->array_options['options_xxxxxxxxx'] : '-1'
</syntaxhighlight>

==Afficher la balance d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? $ret['opened']: 666
</syntaxhighlight>
==Afficher le nombre de facture ouvertes d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? sizeof($ret['refsopened']): 666
</syntaxhighlight>

==Afficher le champ personnalisé d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product))) ? $reloadedobj->array_options['options_xxxxxxxxx'] : 'Not found'
</syntaxhighlight>

==Afficher le stock réel d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product)> 0)) ? $reloadedobj-> stock_reel : 'Not found'
</syntaxhighlight>

Extrafield Champ Calculé

2025-07-01T12:32:15Z

Isamuse: /* Afficher le champ personnalisé d'un produit */

==PAGE EN COURS D ECRITURE==

=Principe=

Vous pouvez entrer ici une formule utilisant les propriétés objet ou tout code PHP pour obtenir des valeurs dynamiques. Vous pouvez utiliser toute formule compatible PHP, incluant l'opérateur conditionnel "?", et les objets globaux : $db, $conf, $langs, $mysoc, $user, $objectoffield ($object avant la V17).

[[File:Warning.png]] depuis la V17 il ne faut plus utiliser $object/$obj mais $objectoffield

ATTENTION : Seulement quelques propriétés de l'objet $objectoffield pourraient être disponibles. Si vous avez besoin de propriétés non chargées, créez vous même une instance de l'objet dans votre formule, comme dans le deuxième exemple.
Utiliser un champs calculé signifie que vous ne pouvez pas entrer vous même toute valeur à partir de l'interface. Aussi, s'il y a une erreur de syntaxe, la formule pourrait ne rien retourner.

Exemple de formule:
<syntaxhighlight lang="PHP">
$objectoffield->id < 10 ? round($objectoffield->id / 2, 2) : ($objectoffield->id + 2 * $user->id) * (int) substr($mysoc->zip, 1, 2)
</syntaxhighlight>

Exemple pour recharger l'objet:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetch($objectoffield->id)) ? $reloadedobj->array_options['options_extrafieldkey'] * $reloadedobj->capital / 5 : '-1'
</syntaxhighlight>
Un autre exemple de formule pour forcer le rechargement d'un objet et de son objet parent:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Task($db)) && ($reloadedobj->fetch($objectoffield->id) > 0) && ($secondloadedobj = new Project($db)) && ($secondloadedobj->fetch($reloadedobj->fk_project) > 0)) ? $secondloadedobj->ref : 'Objet parent projet non trouvé'
</syntaxhighlight>

=Type de champ extrafield utilisable=

Numerique Entier
Decimale

Date
Date/heure

Prix

=propriétés d objet utilisable=

{| class="wikitable"
|+ style="width:800px;" |MODULE PRODUIT OBJECT PRODUIT/SERVICE
|-
! style="width:200px;" |NOM DE LA PROPRIETE
! style="width:200px;" |TYPE DE LA PROPRIETE
! style="width:400px;" |CALCULABLE ?
|-
|PRIX
|Decimale
|OUI
|}

=Mise En Application=
$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple addition

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple Multiplication

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple subtraction

==Afficher l'adresse d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->address: ' '
</syntaxhighlight>
==Afficher le champ complémentaire d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->array_options['options_xxxxxxxxx'] : '-1'
</syntaxhighlight>

==Afficher la balance d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? $ret['opened']: 666
</syntaxhighlight>
==Afficher le nombre de facture ouvertes d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? sizeof($ret['refsopened']): 666
</syntaxhighlight>

==Afficher le champ personnalisé d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product)> 0)) ? $reloadedobj->array_options['options_xxxxxxxxx'] : 'Not found'
</syntaxhighlight>

==Afficher le stock réel d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product)> 0)) ? $reloadedobj-> stock_reel : 'Not found'
</syntaxhighlight>

Extrafield Champ Calculé

2025-07-01T12:31:46Z

Isamuse: /* Afficher le stock réel d'un produit */

==PAGE EN COURS D ECRITURE==

=Principe=

Vous pouvez entrer ici une formule utilisant les propriétés objet ou tout code PHP pour obtenir des valeurs dynamiques. Vous pouvez utiliser toute formule compatible PHP, incluant l'opérateur conditionnel "?", et les objets globaux : $db, $conf, $langs, $mysoc, $user, $objectoffield ($object avant la V17).

[[File:Warning.png]] depuis la V17 il ne faut plus utiliser $object/$obj mais $objectoffield

ATTENTION : Seulement quelques propriétés de l'objet $objectoffield pourraient être disponibles. Si vous avez besoin de propriétés non chargées, créez vous même une instance de l'objet dans votre formule, comme dans le deuxième exemple.
Utiliser un champs calculé signifie que vous ne pouvez pas entrer vous même toute valeur à partir de l'interface. Aussi, s'il y a une erreur de syntaxe, la formule pourrait ne rien retourner.

Exemple de formule:
<syntaxhighlight lang="PHP">
$objectoffield->id < 10 ? round($objectoffield->id / 2, 2) : ($objectoffield->id + 2 * $user->id) * (int) substr($mysoc->zip, 1, 2)
</syntaxhighlight>

Exemple pour recharger l'objet:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetch($objectoffield->id)) ? $reloadedobj->array_options['options_extrafieldkey'] * $reloadedobj->capital / 5 : '-1'
</syntaxhighlight>
Un autre exemple de formule pour forcer le rechargement d'un objet et de son objet parent:
<syntaxhighlight lang="PHP">
(($reloadedobj = new Task($db)) && ($reloadedobj->fetch($objectoffield->id) > 0) && ($secondloadedobj = new Project($db)) && ($secondloadedobj->fetch($reloadedobj->fk_project) > 0)) ? $secondloadedobj->ref : 'Objet parent projet non trouvé'
</syntaxhighlight>

=Type de champ extrafield utilisable=

Numerique Entier
Decimale

Date
Date/heure

Prix

=propriétés d objet utilisable=

{| class="wikitable"
|+ style="width:800px;" |MODULE PRODUIT OBJECT PRODUIT/SERVICE
|-
! style="width:200px;" |NOM DE LA PROPRIETE
! style="width:200px;" |TYPE DE LA PROPRIETE
! style="width:400px;" |CALCULABLE ?
|-
|PRIX
|Decimale
|OUI
|}

=Mise En Application=
$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple addition

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple Multiplication

$objectoffield->array_options['options_xxxxxxxx1']+$objectoffield->array_options['options_xxxxxxxx2'] Simple subtraction

==Afficher l'adresse d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->address: ' '
</syntaxhighlight>
==Afficher le champ complémentaire d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->socid) > 0)) ? $reloadedobj->array_options['options_xxxxxxxxx'] : '-1'
</syntaxhighlight>

==Afficher la balance d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? $ret['opened']: 666
</syntaxhighlight>
==Afficher le nombre de facture ouvertes d'un tiers==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Societe($db)) && ($reloadedobj->fetchNoCompute($objectoffield->rowid)) && ( $ret=$reloadedobj->getOutStandingBills())
) ? sizeof($ret['refsopened']): 666
</syntaxhighlight>

==Afficher le champ personnalisé d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product))) ? $reloadedobj->array_options['options_xxxxxxxxx'] : 'Not found'
</syntaxhighlight>

==Afficher le stock réel d'un produit==
<syntaxhighlight lang="PHP">
(($reloadedobj = new Product($db)) && ($reloadedobj->fetch($objectoffield->fk_product)> 0)) ? $reloadedobj-> stock_reel : 'Not found'
</syntaxhighlight>

Extrafield Champ Calculé

2025-06-24T17:50:07Z

Isamuse: /* Mise En Application */

Système de substitution de variables

2025-01-23T10:46:21Z

Isamuse: /* Variables de substitution disponibles */ précisions pour les emailings

[[en:Variable_substitution_system]]
[[zh:变量替换系统]]


{{TemplateDocUtil}}
{{TemplateDocDev}}

Les variables de substitutions sont des mots clés qui peuvent être utilisés à de nombreux endroits dans Dolibarr pour être remplacés ultérieurement.
On s'en sert par exemple dans les modèles d'emails ou de texte de configuration pour qu'un texte soit personnalisé au moment de son affichage ou de son envoi pour les emails.

=Variables de substitution disponibles=

*

{| class="wikitable sortable"
|+
!Variable
!Valeur Affichée
!Note
!Dolibarr Mini
|-
|__USER_SIGNATURE__
|Ma super signature
|Signature de l'utilisateur
|
|-
|__USER_ID__
|1
|ID de l'utilisateur
|
|-
|__USER_LOGIN__
|doli9
|Login de l'utilisateur
|
|-
|__USER_LASTNAME__
|Admin
|Nom de l'utilisateur
|
|-
|__USER_FIRSTNAME__
|Super
|Prénom de l'utilisateur
|
|-
|__USER_FULLNAME__
|SuperAdmin
|Nom complet de l'utilisateur
|
|-
|__USER_SUPERVISOR_ID__
|1
|ID du superviseur
|
|-
|__USER_REMOTE_IP__
|xxx.xxx.xxx.xxx
|IP de l'utilisateur
|
|-
|__MYCOMPANY_NAME__
|Ma petite entreprise
|Nom de l'entreprise
|
|-
|__MYCOMPANY_EMAIL__
|contact@monentreprise.fr
|Adresse email de contact de mon entreprise
|
|-
|__MYCOMPANY_PROFID1__
|12345678
|Id. prof. 1 (TIN)
|
|-
|__MYCOMPANY_PROFID2__
|12345678
|Id. prof. 2 (PAN)
|
|-
|__MYCOMPANY_PROFID3__
|12345678
|Id. prof. 3 (SRVC TAX)
|
|-
|__MYCOMPANY_PROFID4__
|12345678
|Id. prof. 4
|
|-
|__MYCOMPANY_PROFID5__
|12345678
|Id. prof. 5
|
|-
|__MYCOMPANY_PROFID6__
|FR12345678
|Numéro de TVA
|
|-
|__MYCOMPANY_CAPITAL__
|10000
|Capital de mon entreprise
|
|-
|__MYCOMPANY_FULLADDRESS__
|12 rue laurent 75001 Paris France
|Adresse complète de mon entreprise
|
|-
|__MYCOMPANY_ADDRESS__
|12 rue laurent
|Rue et numéro de rue de mon entreprise
|
|-
|__MYCOMPANY_ZIP__
|75001
|Code postale de mon entreprise
|
|-
|__MYCOMPANY_TOWN__
|Paris
|Ville de mon entreprise
|
|-
|__MYCOMPANY_COUNTRY__
|France
|Pays de mon entreprise
|
|-
|__MYCOMPANY_COUNTRY_ID__
|1
|Identifiant du pays de mon entreprise
|
|-
|__MYCOMPANY_CURRENCY_CODE__
|EUR
|Devise principale de mon entreprise
|
|-
|__ID__
|1
|ID de l'object
|
|-
|__REF__
|1234
|Référence de l'objet
|
|-
|__REF_CLIENT__
|1234
|Référence client de l'objet
|
|-
|__REF_SUPPLIER__
|1234
|Référence fournisseur de l'objet
|
|-
|__EXTRAFIELD_XXX__
|?????
|Attribut supplémentaire de l'object (XXX doit être remplacé par le code de l'attribut)
|
|-
|__THIRDPARTY_ID__
|1
|ID du tiers
|
|-
|__THIRDPARTY_NAME__
|MonClient
|Nom du tiers
|
|-
|__THIRDPARTY_NAME_ALIAS__
|MonC
|Alias du tiers
|
|-
|__THIRDPARTY_EMAIL__
|contact@monclient.com
|Adresse email du tiers
|
|-
|__CONTACT_NAME_CUSTOMER__
|civilité prénom nom
|Genre prénom et nom du contact de type 'contact suivi proposition' d'une proposition commerciale
|
|-
|__PROJECT_ID__
|1
|ID du projet de l'objet
|
|-
|__PROJECT_REF__
|1234
|Référence du projet de l'objet
|
|-
|__PROJECT_NAME__
|MonProjet
|Nom du projet de l'objet
|
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATE__
|01/01/2020
|Date la plus tardive prévue pour le démarrage du contrat
|
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATETIME__
|1/1/2020 13h
|Date et heure la plus tardive prévue pour le démarrage du contrat
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATE__
|01/01/2020
|Date la plus proche pour l'expiration du contrat
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATETIME__
|1/1/2020 13h
|Date et heure la plus proche pour l'expiration du contrat
|
|-
|__ONLINE_PAYMENT_URL__
|<nowiki>https://mondoli.com/payment</nowiki>
|Adresse du paiement en ligne (si applicable)
|
|-
|__ONLINE_PAYMENT_TEXT_AND_URL__
|Cliquez pour payer
|Texte et adresse du paiement en ligne (si applicable)
|
|-
|__SECUREKEYPAYMENT__
|
|Clé de sécurité pour le paiement (si la clé n'est pas unique par enregistrement)
|
|-
|__SECUREKEYPAYMENT_MEMBER__
|
|Clé de sécurité pour le paiement de l'abonnement d'un membre (une clé par membre)
|
|-
|__SECUREKEYPAYMENT_ORDER__
|
|Clé de sécurité pour le paiement d'une commande
|
|-
|__SECUREKEYPAYMENT_INVOICE__
|
|Clé de sécurité pour le paiement d'une facture
|
|-
|__SECUREKEYPAYMENT_CONTRACTLINE__
|
|Clé de sécurité pour le paiement d'un contrat
|
|-
|__DIRECTDOWNLOAD_URL_PROPOSAL__
|<nowiki>https://mondoli.com/devis.pdf</nowiki>
|URL de téléchargement direct d'un devis
|
|-
|__DIRECTDOWNLOAD_URL_ORDER__
|<nowiki>http://mondoli.com/commande.pdf</nowiki>
|URL de téléchargement direct d'une commande
|
|-
|__DIRECTDOWNLOAD_URL_INVOICE__
|<nowiki>http://mondoli.com/facture.pdf</nowiki>
|URL de téléchargement direct d'une facture. Pour cela, il faut que le paramètre INVOICE_ALLOW_EXTERNAL_DOWNLOAD soit configuré pour permettre de générer le lien.
|
|-
|__SHIPPINGTRACKNUM__
|XXXXX
|Numéro de suivi du colis
|
|-
|__SHIPPINGTRACKNUMURL__
|<nowiki>http://trackingcompagny.com/XXXXX</nowiki>
|URL de suivi du colis
|
|-
|__DATE_YMD__
|01/01/2020
|Date d'aujourd'hui
|
|-
|__DATE_DUE_YMD__
|01/01/2020
|Date d'échéance
|
|-
|__AMOUNT__ ->
|1243,34
|Montant total
|
|-
|__AMOUNT_EXCL_TAX__ -> __AMOUNT_EXCL_TAX__
|1234,45
|Montant total hors taxe
|
|-
|__AMOUNT_VAT__ -> __AMOUNT_VAT__
|123,4
|Montant TVA
|
|-
|__AMOUNT_FORMATED__
|1243,34 €
|Montant total formaté
|
|-
|__AMOUNT_EXCL_TAX_FORMATED__
|1234,45 €
|Montant total hors taxe formaté
|
|-
|__AMOUNT_VAT_FORMATED__ -> __AMOUNT_VAT_FORMATED__
|123,4 €
|Montant TVA formaté
|
|-
|__DAY__
|12
|Jours actuel (chiffre)
|
|-
|__DAY_TEXT__
|Mardi
|Jours actuel (texte)
|
|-
|__DAY_TEXT_SHORT__
|Ma
|Jours actuel en texte abrégé
|
|-
|__DAY_TEXT_MIN__
|M
|Jours actuel en texte en une lettre
|
|-
|__MONTH__
|3
|Mois actuel (chiffre)
|
|-
|__MONTH_TEXT__
|Mars
|Mois actuel (texte)
|
|-
|__MONTH_TEXT_SHORT__
|Ma.
|Mois actuel en texte abrégé
|
|-
|__MONTH_TEXT_MIN__
|M
|Mois actuel en texte en une lettre
|
|-
|__YEAR__
|2020
|Année actuelle
|
|-
|__PREVIOUS_DAY__
|11
|Hier (chiffre)
|
|-
|__PREVIOUS_MONTH__
|2
|Mois précédent (chiffre)
|
|-
|__PREVIOUS_YEAR__
|2019
|Année précédente
|
|-
|__NEXT_DAY__
|13
|Demain (chiffre)
|
|-
|__NEXT_MONTH__
|4
|Mois prochain
|
|-
|__NEXT_YEAR__
|2021
|Année prochaine
|
|-
|__DOL_MAIN_URL_ROOT__
|<nowiki>http://mondolibarr.fr/htdocs</nowiki>
|Adresse de mon dolibarr
|
|-
|__(Clédetraduction)__
|Clé traduite
|N'importe qu'elle clé de traduction
|
|-
|__[constante]__
|Valeure de la constante
|N'importe qu'elle constante
|
|-
|__DATE_DELIVERY__
|21/09/1974
|Date de livraison de la Propal
|V14
|-
|__CONTACT_NAME_XXX__
|Mr T
|Civilité/titre prénom et nom du contact
XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_LASTNAME_XXX__
|Nom patronymique du contact
|Nom du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_FIRSTNAME_XXX__
|Prénom du contact
|Prénom du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_TITLE_XXX__
|Titre de civilité du contact
|Titre/civilité du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__UNSUBSCRIBE__
|
|Lien de désinscription dans les emailings. Insère le terme "Désinscription" dans l'emailing avec un lien pour enregistrer une désinscription. Le texte peut être modifié via les traductions des clés
- MailUnsubcribe = la mention de désinscription insérée dans l'email

- YourMailUnsubcribeOK = la mention qui s'affiche sur la page web de confirmation de la désinscription
|
|-
|__CHECK_READ__
|
|Dans les emailings, insère une fonction permettant le comptage des emails lus (en anglais "blank image with a callback URL to Dolibarr (/public/emailing/mailing-read.php?tag=)"
|
|}

=Variables de substitution Personnalisées de modules externes=

Un module peut ajouter ses propres variables de substitutions.
Pour cela, le module doit embarquer un fichier avec le nom '''monmodule/core/substitutions/functions_monmodule.lib.php''' et en définissant le

<code>$this->module_parts['substitutions'] = 1 </code>

dans le descripteur de module.

Module EMailing

2025-01-23T10:23:41Z

Isamuse: /* Setup */

[[fr:Module_Mailing]]
[[es:Módulo_Mailing]]


{{TemplateDocUser}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Mailing|
num=22|
devdoc=[[Module EMailing (developer)]]|
userdoc=This page}}

=Introduction=
This module permits to send mass emailing to your customers, suppliers, prospects, contacts, members, or users.

=Installation=
{{NoInstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Check also that Dolibarr setup to send mails is ok: [[Setup EMails]]

Check also the setup options available in [[Setup Other|Setup Other, for the emailing module]]. Amongst others, you can set the number of emails to be sent from your web interface with MAILING_LIMIT_SENDBYWEB.

[[File:Warning.png]] Note: If a constant MAILING_NO_USING_PHPMAIL is set to 1 in Home - Setup - Other, it is only possible to send emailing when the send mode in setup is not on "PHP Mail" but on another mode (like "SMTPs").

=Usage=
Mass E-Mailing features are available from menus (if [[Module EMailing]] has been activated).
Menu link can be found in menu "''Tools''" with default menu manager "''Eldy''".

==Life cycle / Business rules==
The full process is this one:

- You create an emailing with a title, a topic and an email sender (For this, click on menu "Tools - EMailings - New emailing", input the content of the email with substitue variables and click on "Create emailing" button. The other solution is to go on an existing emailing and click "Clone").

- Then you choose the targets, among predefined dynamic lists from your Dolibarr data or from external files (For this, go on tab "Recipients" and click on button "Add" of the predefined lists you want).

- You can modify this list, by removing targets for example, orcadding targets from dufferent sources.

- The user responsible to validate emailing checks content and recipients. He can do a test to its own e-mail address to see the result inside its email software.
If results looks good, he set the status of e-mailing to ''validated'' (For this, click on button "Validate").

- The mass e-mail sending is done then from:

*the web application screen. In such a case, there is a limit in number of emails sent in one step, 50 by defaut in most cases. If you have more than 50 recipients, you can submit the emailing from screen a second time and the application will automatically send emails to the 50 next recipients. Repeat until all recipients are addressed.
*or from the command line with script [[Script mailing-send.php]].

Only an emailing with the status '''Validated''' can be sent by the script. See page [[Script mailing-send.php]] for more information on how to launch it from command line.

- The global status for e-mailing and send result for each recipient will be updated and visible.

Module EMailing

2025-01-23T10:20:49Z

Isamuse: /* Setup */ un ajout sur la configuration possible via "other setup"

[[fr:Module_Mailing]]
[[es:Módulo_Mailing]]


{{TemplateDocUser}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Mailing|
num=22|
devdoc=[[Module EMailing (developer)]]|
userdoc=This page}}

=Introduction=
This module permits to send mass emailing to your customers, suppliers, prospects, contacts, members, or users.

=Installation=
{{NoInstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Check also that Dolibarr setup to send mails is ok: [[Setup EMails]]

Check also the setup options available in [[Setup Other|Setup Other, for the emailing module]]. Amongst others, you can set the number of emails to be send for your web interface with MAILING_LIMIT_SENDBYWEB.

[[File:Warning.png]] Note: If a constant MAILING_NO_USING_PHPMAIL is set to 1 in Home - Setup - Other, it is only possible to send emailing when the send mode in setup is not on "PHP Mail" but on another mode (like "SMTPs").

=Usage=
Mass E-Mailing features are available from menus (if [[Module EMailing]] has been activated).
Menu link can be found in menu "''Tools''" with default menu manager "''Eldy''".

==Life cycle / Business rules==
The full process is this one:

- You create an emailing with a title, a topic and an email sender (For this, click on menu "Tools - EMailings - New emailing", input the content of the email with substitue variables and click on "Create emailing" button. The other solution is to go on an existing emailing and click "Clone").

- Then you choose the targets, among predefined dynamic lists from your Dolibarr data or from external files (For this, go on tab "Recipients" and click on button "Add" of the predefined lists you want).

- You can modify this list, by removing targets for example, orcadding targets from dufferent sources.

- The user responsible to validate emailing checks content and recipients. He can do a test to its own e-mail address to see the result inside its email software.
If results looks good, he set the status of e-mailing to ''validated'' (For this, click on button "Validate").

- The mass e-mail sending is done then from:

*the web application screen. In such a case, there is a limit in number of emails sent in one step, 50 by defaut in most cases. If you have more than 50 recipients, you can submit the emailing from screen a second time and the application will automatically send emails to the 50 next recipients. Repeat until all recipients are addressed.
*or from the command line with script [[Script mailing-send.php]].

Only an emailing with the status '''Validated''' can be sent by the script. See page [[Script mailing-send.php]] for more information on how to launch it from command line.

- The global status for e-mailing and send result for each recipient will be updated and visible.

Variable substitution system

2025-01-22T14:58:14Z

Isamuse: /* For Emails */ Précisions sur les variables __UNSUBSCRIBE__ et __CHECK_READ__ spécifiques aux emailings

[[fr:Système_de_substitution_de_variables]]
[[zh:变量替换系统]]


{{TemplateDocUser}}
{{TemplateDocDevEn}}

Substitution variables are keywords that can be used in many places in Dolibarr to be replaced later.
It is used for example in the templates of emails or configuration text for a text to be personalized when it is displayed or sent for emails.

These variables will be replaced only if the corresponding data exist on the object (for exemple for a third party mail, the online payement URL doesn't exist and will not be replaced)

=Substitution variables available=

==Dolibarr User==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__USER_SIGNATURE__
|My beautiful signature
|User signature
|
|-
|__USER_SIGNATURE__
|My beautiful signature
|User signature
|
|-
|__USER_ID__
|1
|User ID
|
|-
|__USER_LOGIN__
|doli9
|User Login
|
|-
|__USER_LASTNAME__
|Admin
|User last name
|
|-
|__USER_FIRSTNAME__
|Super
|User first name
|
|-
|__USER_FULLNAME__
|SuperAdmin
|User full name
|
|-
|__USER_SUPERVISOR_ID__
|1
|User supervisor ID
|
|-
|__USER_REMOTE_IP__
|xxx.xxx.xxx.xxx
|User remote IP
|}

*

==My Company==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__MYCOMPANY_NAME__
|My little company
|Name of the company
|
|-
|__MYCOMPANY_EMAIL__
|contact@mycompany.com
|My company contact email
|
|-
|__MYCOMPANY_PHONE__
|0123456789
|My company phone number
|
|-
|__MYCOMPANY_FAX__
|0123456789
|My company fax number
|
|-
|__MYCOMPANY_PROFID1__
|12345678
|Prof Id 1 (TIN)
|
|-
|__MYCOMPANY_PROFID2__
|12345678
|Prof Id 2 (PAN)
|
|-
|__MYCOMPANY_PROFID3__
|12345678
|Prof Id 3 (SRVC TAX)
|
|-
|__MYCOMPANY_PROFID4__
|12345678
|Prof Id 4
|
|-
|__MYCOMPANY_PROFID5__
|12345678
|Prof Id 5
|
|-
|__MYCOMPANY_PROFID6__
|12345678
|VAT ID
|
|-
|__MYCOMPANY_CAPITAL__
|10000
|Capital of the company
|
|-
|__MYCOMPANY_FULLADDRESS__
|21 Jump street 75500 MyTown India
|Full address of the company
|
|-
|__MYCOMPANY_ADDRESS__
|21 Jump street
|address of the company
|
|-
|__MYCOMPANY_ZIP__
|75500
|ZIP code of the company address
|
|-
|__MYCOMPANY_TOWN__
|MyTown
|Town of the company address
|
|-
|__MYCOMPANY_COUNTRY__
|India
|Country of the company address
|
|-
|__MYCOMPANY_COUNTRY_ID__
|1
|Country ID of the company address
|
|-
|__MYCOMPANY_COUNTRY_CODE__
|1
|Country Code of the company address
|
|-
|__MYCOMPANY_CURRENCY_CODE__
|EUR
|Main currency
|
|}

*

==Object==
===Generic===

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__ID__
|1
|ID of the object
|
|-
|__REF__
|1234
|Reference of the object
|
|-
|__REF_CLIENT__
|1234
|Customer reference of the object
|
|-
|__REF_SUPPLIER__
|1234
|Supplier reference of the object
|
|-
|__NOTE_PUBLIC__
|My Public note
|Object Public Note
|V 13
|-
|__NOTE_PRIVATE__
|My Private note
|Object Private Note
|V 13
|-
|__DATE_DELIVERY__
|01/02/2021
|Delivery date
|V 13
|}

*

===Objects with amounts===

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__DATE_YMD__
|1/1/2020
|Object date
|
|-
|__DATE_DUE_YMD__
|1/1/2020
|Due date
|
|-
|__AMOUNT__
|1243.34
|Amount
|
|-
|__AMOUNT_TEXT__
|One thousand five hundred ...
|Amount in words
|V13
|-
|__AMOUNT_TEXTCURRENCY__
|One thousand five hundred ...
|Amount in words with currency
|V13
|-
|__AMOUNT_EXCL_TAX__
|1234.45
|Amount without taxes
|
|-
|__AMOUNT_VAT__
|123.4
|VAT amount
|
|-
|__AMOUNT_VAT_TEXT__
|One thousand five hundred ...
|VAT Amount in words
|V13
|-
|__AMOUNT_VAT_TEXTCURRENCY__
|One thousand five hundred ...
|VAT Amount in words with currency
|V13
|-
|__AMOUNT_TAX2__
|123.4
|TAX2 amount
|
|-
|__AMOUNT_TAX3__
|123.4
|TAX3 amount
|
|-
|__AMOUNT_FORMATED__
|1243.34 €
|Amount formated
|
|-
|__AMOUNT_EXCL_TAX_FORMATED__
|1234.45 €
|Amount without taxes formated
|
|-
|__AMOUNT_VAT_FORMATED__
|123.4 €
|VAT amount formated
|
|-
|__AMOUNT_TAX2_FORMATED__
|123.4 €
|TAX2 amount formated
|V13
|-
|__AMOUNT_TAX3_FORMATED__
|123.4 €
|TAX3 amount formated
|V13
|-
|__AMOUNT_MULTICURRENCY__
|1234.45 $
|Amount in Multicurrency
|V13
|-
|__AMOUNT_MULTICURRENCY_TEXT__
|One thousan five hundred ...
|Amount in Multicurrency in words
|V13
|-
|__AMOUNT_MULTICURRENCY_TEXTCURRENCY__
|One thousan five hundred ...
|Amount in Multicurrency in words with currency
|V13
|}

*

==Member==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__MEMBER_ID__
|123
|Member ID
|V 13
|-
|__MEMBER_CIVILITY__
|
|
|V 13
|-
|__MEMBER_FIRSTNAME__
|
|
|V 13
|-
|__MEMBER_LASTNAME__
|
|
|V 13
|-
|__MEMBER_FULLNAME__
|
|
|V 13
|-
|__MEMBER_COMPANY__
|
|
|V 13
|-
|__MEMBER_ADDRESS__
|
|
|V 13
|-
|__MEMBER_ZIP__
|
|
|V 13
|-
|__MEMBER_TOWN__
|
|
|V 13
|-
|__MEMBER_COUNTRY__
|
|
|V 13
|-
|__MEMBER_EMAIL__
|
|
|V 13
|-
|__MEMBER_BIRTH__
|
|
|V 13
|-
|__MEMBER_PHOTO__
|
|
|V 13
|-
|__MEMBER_LOGIN__
|
|
|V 13
|-
|__MEMBER_PASSWORD__
|
|
|V 13
|-
|__MEMBER_PHONE__
|
|
|V 13
|-
|__MEMBER_PHONEPRO__
|
|
|V 13
|-
|__MEMBER_PHONEMOBILE__
|
|
|V 13
|-
|__MEMBER_TYPE__
|Member
|Type of member
|V 13
|-
|__MEMBER_FIRST_SUBSCRIPTION_DATE__
|
|
|V 13
|-
|__MEMBER_FIRST_SUBSCRIPTION_DATE_START__
|
|
|V 13
|-
|__MEMBER_FIRST_SUBSCRIPTION_DATE_END__
|
|
|V 13
|-
|__MEMBER_LAST_SUBSCRIPTION_DATE__
|
|
|V 13
|-
|__MEMBER_LAST_SUBSCRIPTION_DATE_START__
|
|
|V 13
|-
|__MEMBER_LAST_SUBSCRIPTION_DATE_END__
|
|
|V 13
|}

*

==Thirdparty==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__THIRDPARTY_ID__
|1
|Third party ID of the object
|
|-
|__THIRDPARTY_NAME__
|MyCustomer
|Third party name of the object
|
|-
|__THIRDPARTY_NAME_ALIAS__
|MyC
|Third party name alias of the object
|
|-
|__THIRDPARTY_CODE_CLIENT__
|
|
|V13
|-
|__THIRDPARTY_CODE_FOURNISSEUR__
|
|
|V13
|-
|__THIRDPARTY_EMAIL__
|contact@mycustomer.com
|Third party email of the object
|
|-
|__THIRDPARTY_PHONE__
|
|
|V13
|-
|__THIRDPARTY_FAX__
|
|
|V13
|-
|__THIRDPARTY_ADDRESS__
|
|
|V13
|-
|__THIRDPARTY_ZIP__
|
|
|V13
|-
|__THIRDPARTY_TOWN__
|
|
|V13
|-
|__THIRDPARTY_COUNTRY_ID__
|
|
|V13
|-
|__THIRDPARTY_COUNTRY_CODE__
|
|
|V13
|-
|__THIRDPARTY_IDPROF1__
|
|
|V13
|-
|__THIRDPARTY_IDPROF2__
|
|
|V13
|-
|__THIRDPARTY_IDPROF3__
|
|
|V13
|-
|__THIRDPARTY_IDPROF4__
|
|
|V13
|-
|__THIRDPARTY_IDPROF5__
|
|
|V13
|-
|__THIRDPARTY_IDPROF6__
|
|
|V13
|-
|__THIRDPARTY_TVAINTRA__
|
|
|V13
|-
|__THIRDPARTY_NOTE_PUBLIC__
|
|
|V13
|-
|__THIRDPARTY_NOTE_PRIVATE__
|
|
|V13
|}

*

==Candidate==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__CANDIDATE_FULLNAME__
|
|
|V13
|-
|__CANDIDATE_FIRSTNAME__
|
|
|V13
|-
|__CANDIDATE_LASTNAME__
|
|
|V13
|}

*

==Project==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__PROJECT_ID__
|1
|Project ID of the object
|
|-
|__PROJECT_REF__
|1
|Project reference of the object
|
|-
|__PROJECT_NAME__
|1
|Project name of the object
|
|}

*

==Shipment==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__SHIPPINGTRACKNUM__
|XXXXX
|Shipping tacking number
|
|-
|__SHIPPINGTRACKNUMURL__
|http://trackingcompagny.com/XXXXX
|Shipping tracking url
|
|}

*

==Reception==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__RECEPTIONTRACKNUM__
|XXXXX
|Shipping tacking number
|V13
|-
|__RECEPTIONTRACKNUMURL__
|http://trackingcompagny.com/XXXXX
|Shipping tracking url
|V13
|}

*

==Contract==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATE__
|1/1/2020
|Highest date planned for a service start
|
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATETIME__
|1/1/2020 1PM
|Highest date and hour planned for service start
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATE__
|1/1/2020
|Lowest date for planned expiration of service
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATETIME__
|1/1/2020 1PM
|Lowest date and hour for planned expiration of service
|
|}

*

==Extrafield==
===Generic Rule===

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__EXTRAFIELD_XXX__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code)
|
|}

*

===Date Extrafield===

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__EXTRAFIELD_XXX__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code)
|
|-
|__EXTRAFIELD_XXX_LOCALE__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code) in locale
|
|-
|__EXTRAFIELD_XXX_RFC__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code) in RFC
|
|}

*

===Datetime Extrafield===

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__EXTRAFIELD_XXX__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code)
|
|-
|__EXTRAFIELD_XXX_LOCALE__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code) in locale
|
|-
|__EXTRAFIELD_XXX_DAY_LOCALE__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code) only the day in locale
|
|-
|__EXTRAFIELD_XXX_RFC__
|
|Object Extrafield (XXX need to be replace by the Extrafield Attribute code) in RFC
|
|}

*

==Online Payment==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__ONLINE_PAYMENT_URL__
|http://mydoli.com/payment
|Address of the Online payement if applicable
|
|-
|__ONLINE_PAYMENT_TEXT_AND_URL__
|Click to pay
|Text and Url to pay online if applicable
|
|-
|}

*

==Online Proposal Signature==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__ONLINE_SIGN_URL__
|[https://mydoli.com/public/onlinesign http://mydoli.com/public/onlinesign]
|Address of the Online Signature for proposal
|15
|-
|}

*

==Online Intervention Signature==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__ONLINE_SIGN_FICHINTER_URL__
|[https://mydoli.com/public/onlinesign http://mydoli.com/public/onlinesign]
|Address of the Online Signature for intervention
|
|-
|}

*

==Document download==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__DIRECTDOWNLOAD_URL_PROPOSAL__
|http://mydoli.com/proposal.pdf
|Direct download url of a proposal
|
|-
|__DIRECTDOWNLOAD_URL_ORDER__
|http://mydoli.com/order.pdf
|Direct download url of an order
|
|-
|__DIRECTDOWNLOAD_URL_INVOICE__
|http://mydoli.com/invoice.pdf
|Direct download url of an invoice. This needs that the setup INVOICE_ALLOW_EXTERNAL_DOWNLOAD is set to allow to generate the link.
|
|-
|__DIRECTDOWNLOAD_URL_FICHINTER__
|http://mydoli.com/fichinter.pdf
|Direct download url of an intervention. This needs that the setup FICHINTER_ALLOW_EXTERNAL_DOWNLOAD is set to allow to generate the link.
|
|-
|__URL_PROPOSAL__
|http://mydoli.com/comm/propal/card.php?id=xxx
|
|
|-
|__URL_ORDER__
|http://mydoli.com/commande/card.php?id=xxxx
|
|
|-
|__URL_INVOICE__
|http://mydoli.com/compta/facture/card.php?id=xxx
|
|
|-
|__URL_FICHINTER__
|
|
|
|}

*

==Event==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__EVENT_LABEL__
|
|
|V13
|-
|__EVENT_DATE__
|
|
|V13
|-
|__EVENT_TIME__
|
|
|V13
|}

*

==Dates==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__DAY__
|12
|actual day
|
|-
|__DAY_TEXT__
|Monday
|Actual day in text
|
|-
|__DAY_TEXT_SHORT__
|Mo
|Actual day in short text
|
|-
|__DAY_TEXT_MIN__
|M
|Actual day in minimum text
|
|-
|__MONTH__
|3
|Actual month
|
|-
|__MONTH_TEXT__
|March
|Actual month in text
|
|-
|__MONTH_TEXT_SHORT__
|March
|Actual month in short text
|
|-
|__MONTH_TEXT_MIN__
|M
|Actual month in minimum text
|
|-
|__YEAR__
|2020
|Actual year
|
|-
|__PREVIOUS_DAY__
|11
|Previous day
|
|-
|__PREVIOUS_MONTH__
|2
|Previous month
|
|-
|__PREVIOUS_YEAR__
|2019
|Previous Year
|
|-
|__NEXT_DAY__
|13
|Next day
|
|-
|__NEXT_MONTH__
|4
|Next month
|
|-
|__NEXT_YEAR__
|2021
|next year
|
|}

*

==Multicompany==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__ENTITY_ID__
|
|
|V13
|}

*

==System==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__DOL_MAIN_URL_ROOT__
|http://mondolibarr/htdocs
|Root URL of Dolibarr
|
|-
|__(AnyTranslationKey)__
|Translation
|Any translation Key
|
|-
|<nowiki>__(AnyTranslationKey|langfile)__</nowiki>
|Translation
|Any translation Key (load also language file before)
|V13
|-
|__[AnyConstantKey]__
|1
|Value of a constant key
|
|}

*

==For Emails==

*

{| class="wikitable sortable" style="width: 85%;"
|+
!Variable
!Displayed Value
!Note
!Dolibarr Mini
|-
|__CONTACT_NAME_XXX__
|Mister T
|XXX is the contact type defined on Setup->Dictionaries->Contact/Address types (exemple : __CONTACT_NAME_BILLING__ for the billing contact). The output will be LastName + First Name
|V14
|-
|__CONTACT_LASTNAME_XXX__
|T
|XXX is the contact type defined on Setup->Dictionaries->Contact/Address types (exemple : __CONTACT_NAME_BILLING__ for the billing contact).
|V14
|-
|__CONTACT_FIRSTNAME_XXX__
|Mister
|XXX is the contact type defined on Setup->Dictionaries->Contact/Address types (exemple : __CONTACT_NAME_BILLING__ for the billing contact).
|V14
|-
|__CONTACT_TITLE_XXX__
|Mr
|XXX is the contact type defined on Setup->Dictionaries->Contact/Address types (exemple : __CONTACT_NAME_BILLING__ for the billing contact).
|V14
|-
|__CHECK_READ__
|
|In emailings, insert a blank image with a callback URL to Dolibarr (/public/emailing/mailing-read.php?tag=)
|
|-
|__UNSUBSCRIBE__
|
|In emailings, insert a link to allow a recipient to unsubscribe from emailings. If the recipient (third party or contact) unsubscribes, his status will change to "Refuse bulk emailings"
To setup the wording of:

- the mention in your email for unsubscribing: Translation (key : MailUnsubcribe)

- the landing page after unsubscribing: Translation (key: YourMailUnsubcribeOK)
|
|}

*

=Substitution variables provide by external module=
Custom substitution variables can be added by external modules.
For this, the external module must embed a file called '''mymodule/core/substitutions/functions_mymodules.lib.php''' and set the

<code>$this->module_parts['substitutions'] = 1 </code>

into the module descriptor.

=How it work=
The array to define all substitution variables is defined in code by calling the method
<code>$substitutionarray = getCommonSubstitutionArray().</code>
This method receive the $object in parameter, so it can define the content of the substitution array using properties of this object. No database access and no IO are allowed to set the substitution array.

Then the array will be used by calling the make_substitutions() this way:
<code>$textcompleted = make_substitutions($textwithsubtitutionkeys, $substitutionarray)</code>

However, sometimes to value to use is not available into the $object, neither into the environment, and it needs a database access to get the value.
In such a case, the substitution is not done by the getCommonSubstitutionArray(). The getCommonSubstitutionArray() will just add an entry into the array of substitution with the information to explain how to get the value like for this entry:
<code>$substitutionarray['__PROJECT_NAME__@lazyload'] = '/projet/class/project.class.php:Project:fetchAndSetSubstitution:'.$object->id</code>
The substitution will be done by the make_substitutions() and only it is required by calling the method defined (here fetchAndSetSubstitution with the param $object->id of the object Project defined into file /projet/class/project.class.php).
Thus, the heavy database access is done only if required.

Paramétrage Valeurs par défaut

2024-03-15T13:44:09Z

Isamuse: /* Valeurs par défaut (sur les formulaires de création) */ quelques exemples pour les fiches de création de tiers

[[Category:Admin fr]]
{{TemplateDocUtil}}

'''Aide de l'écran:''' Valeurs par défaut

'''Menu d'accès:''' Accueil -> Configuration -> Valeurs par défaut (avec le gestionnaire de menu 'eldy')

Ces champs de paramétrage vous permettent de définir :

*des Valeurs par défaut
*des filtres de recherche par défaut
*des ordre de tri par défaut
*des champs par défaut ayant le focus

=Valeurs par défaut (sur les formulaires de création)=

Quelques exemples
{| class="wikitable"
|Fiche
|URL relative
|Champ
|
{|
|Valeur
|}
|Effet
|-
|Tiers
|societe/card.php
|commercial
|__USER_ID__
|Affecte comme commercial le créateur du tiers
|-
|Tiers
|societe/card.php
|forme_juridique_code
|nombre entier correspondant à l'id de la table llx_c_forme_juridique, qui peut être personnalisée via les dictionnaires (Formes juridiques des Tiers/Type d'entité légale)
|Pré-rempli le type d'entité légale (forme juridique). Par exemple par défaut, 11 "Artisan Commerçant (EI)"
|-
|Tiers
|societe/card.php
|typent_id
|nombre entier correspondant à l'id de la table llx_c_typent, qui peut être personnalisée via les dictionnaires (Type de tiers - secteur)
|Pré-rempli le type de tiers. Par exemple par défaut, 1 donnera "Start-up"
|}

=Filtres de recherche par défaut=
Pour connaître les champs et les valeurs de filtrage, il faut examiner le code source de la page de Dolibarr dont on veut filtrer les listes.

'''Filtres par catégories (tags)'''

Exemple : filtrer la liste de ses factures clients selon leur tag/catégorie

url : compta/facture/list.php

champ : search_categ_cus

valeur : sous forme de chiffre ; correspond au rowid de la table llx_categorie. On peut aussi la retrouver en examinant le code source de la page Dolibarr affichée.

'''Filtres par périodes'''

Exemple : filtrer la liste de ses factures fournisseurs '''après''' le 1er janvier 2023

Il faut entrer trois valeurs de filtrage : celle du jour, celle du mois et celle de l'année

Pour le jour

url : fourn/facture/list.php

champ : search_date_startday

valeur : 1

Pour le mois

champ : search_date_startmonth

valeur : 1

Pour l'année

champ : search_date_startyear

valeur : 2023

Même principe pour filtrer '''avant''' une certaine date

Il faut alors utiliser les champs search_date_endday / search_date_endmonth / search_date_endyear

=Ordre de tri par défaut=
Vous pouvez définir/forcer ici la valeur par défaut que vous voulez obtenir lorsque vous créez un nouvel enregistrement, et/ou les filtres par défaut ou ordre de tri des listes. Créez une entrée avec les valeurs suivantes :

*Url
*Champ
*Ordre de tri : desc ou asc pour respectivement descendant et ascendant

Les données de configuration s'obtiennent en analysant l'adresse de la page qui contient la liste, une fois le *TRI OPÉRÉ*.
Par exemple :

htdocs/'''projet/list.php'''?sortfield='''p.dateo'''&sortorder='''desc'''&begin=&contextpage=projectlist&search_status=99

Dans le menu de configuration renseigner :

*pour l'url : projet/list.php
*pour le champ "sortfield" : p.dateo
*pour l'ordre de tri "sortorder" : desc

=Champs par défaut ayant le focus=
''A écrire''

Système de substitution de variables

2023-05-26T15:13:41Z

Isamuse: /* Variables de substitution disponibles */ Ajout de __CONTACT_LASTNAME_XXX__ __CONTACT_FIRSTNAME_XXX__ __CONTACT_TITLE_XXX__

[[en:Variable_substitution_system]]


{{TemplateDocUtil}}
{{TemplateDocDev}}

Les variables de substitutions sont des mots clés qui peuvent être utilisés à de nombreux endroits dans Dolibarr pour être remplacés ultérieurement.
On s'en sert par exemple dans les modèles d'emails ou de texte de configuration pour qu'un texte soit personnalisé au moment de son affichage ou de son envoi pour les emails.

=Variables de substitution disponibles=

*

{| class="wikitable sortable"
|+
!Variable
!Valeur Affichée
!Note
!Dolibarr Mini
|-
|__USER_SIGNATURE__
|Ma super signature
|Signature de l'utilisateur
|
|-
|__USER_ID__
|1
|ID de l'utilisateur
|
|-
|__USER_LOGIN__
|doli9
|Login de l'utilisateur
|
|-
|__USER_LASTNAME__
|Admin
|Nom de l'utilisateur
|
|-
|__USER_FIRSTNAME__
|Super
|Prénom de l'utilisateur
|
|-
|__USER_FULLNAME__
|SuperAdmin
|Nom complet de l'utilisateur
|
|-
|__USER_SUPERVISOR_ID__
|1
|ID du superviseur
|
|-
|__USER_REMOTE_IP__
|xxx.xxx.xxx.xxx
|IP de l'utilisateur
|
|-
|__MYCOMPANY_NAME__
|Ma petite entreprise
|Nom de l'entreprise
|
|-
|__MYCOMPANY_EMAIL__
|contact@monentreprise.fr
|Adresse email de contact de mon entreprise
|
|-
|__MYCOMPANY_PROFID1__
|12345678
|Id. prof. 1 (TIN)
|
|-
|__MYCOMPANY_PROFID2__
|12345678
|Id. prof. 2 (PAN)
|
|-
|__MYCOMPANY_PROFID3__
|12345678
|Id. prof. 3 (SRVC TAX)
|
|-
|__MYCOMPANY_PROFID4__
|12345678
|Id. prof. 4
|
|-
|__MYCOMPANY_PROFID5__
|12345678
|Id. prof. 5
|
|-
|__MYCOMPANY_PROFID6__
|FR12345678
|Numéro de TVA
|
|-
|__MYCOMPANY_CAPITAL__
|10000
|Capital de mon entreprise
|
|-
|__MYCOMPANY_FULLADDRESS__
|12 rue laurent 75001 Paris France
|Adresse complète de mon entreprise
|
|-
|__MYCOMPANY_ADDRESS__
|12 rue laurent
|Rue et numéro de rue de mon entreprise
|
|-
|__MYCOMPANY_ZIP__
|75001
|Code postale de mon entreprise
|
|-
|__MYCOMPANY_TOWN__
|Paris
|Ville de mon entreprise
|
|-
|__MYCOMPANY_COUNTRY__
|France
|Pays de mon entreprise
|
|-
|__MYCOMPANY_COUNTRY_ID__
|1
|Identifiant du pays de mon entreprise
|
|-
|__MYCOMPANY_CURRENCY_CODE__
|EUR
|Devise principale de mon entreprise
|
|-
|__ID__
|1
|ID de l'object
|
|-
|__REF__
|1234
|Référence de l'objet
|
|-
|__REF_CLIENT__
|1234
|Référence client de l'objet
|
|-
|__REF_SUPPLIER__
|1234
|Référence fournisseur de l'objet
|
|-
|__EXTRAFIELD_XXX__
|?????
|Attribut supplémentaire de l'object (XXX doit être remplacé par le code de l'attribut)
|
|-
|__THIRDPARTY_ID__
|1
|ID du tiers
|
|-
|__THIRDPARTY_NAME__
|MonClient
|Nom du tiers
|
|-
|__THIRDPARTY_NAME_ALIAS__
|MonC
|Alias du tiers
|
|-
|__THIRDPARTY_EMAIL__
|contact@monclient.com
|Adresse email du tiers
|
|-
|__CONTACT_NAME_CUSTOMER__
|civilité prénom nom
|Genre prénom et nom du contact de type 'contact suivi proposition' d'une proposition commerciale
|
|-
|__PROJECT_ID__
|1
|ID du projet de l'objet
|
|-
|__PROJECT_REF__
|1234
|Référence du projet de l'objet
|
|-
|__PROJECT_NAME__
|MonProjet
|Nom du projet de l'objet
|
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATE__
|01/01/2020
|Date la plus tardive prévue pour le démarrage du contrat
|
|-
|__CONTRACT_HIGHEST_PLANNED_START_DATETIME__
|1/1/2020 13h
|Date et heure la plus tardive prévue pour le démarrage du contrat
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATE__
|01/01/2020
|Date la plus proche pour l'expiration du contrat
|
|-
|__CONTRACT_LOWEST_EXPIRATION_DATETIME__
|1/1/2020 13h
|Date et heure la plus proche pour l'expiration du contrat
|
|-
|__ONLINE_PAYMENT_URL__
|<nowiki>https://mondoli.com/payment</nowiki>
|Adresse du paiement en ligne (si applicable)
|
|-
|__ONLINE_PAYMENT_TEXT_AND_URL__
|Cliquez pour payer
|Texte et adresse du paiement en ligne (si applicable)
|
|-
|__SECUREKEYPAYMENT__
|
|Clé de sécurité pour le paiement (si la clé n'est pas unique par enregistrement)
|
|-
|__SECUREKEYPAYMENT_MEMBER__
|
|Clé de sécurité pour le paiement de l'abonnement d'un membre (une clé par membre)
|
|-
|__SECUREKEYPAYMENT_ORDER__
|
|Clé de sécurité pour le paiement d'une commande
|
|-
|__SECUREKEYPAYMENT_INVOICE__
|
|Clé de sécurité pour le paiement d'une facture
|
|-
|__SECUREKEYPAYMENT_CONTRACTLINE__
|
|Clé de sécurité pour le paiement d'un contrat
|
|-
|__DIRECTDOWNLOAD_URL_PROPOSAL__
|<nowiki>https://mondoli.com/devis.pdf</nowiki>
|URL de téléchargement direct d'un devis
|
|-
|__DIRECTDOWNLOAD_URL_ORDER__
|<nowiki>http://mondoli.com/commande.pdf</nowiki>
|URL de téléchargement direct d'une commande
|
|-
|__DIRECTDOWNLOAD_URL_INVOICE__
|<nowiki>http://mondoli.com/facture.pdf</nowiki>
|URL de téléchargement direct d'une facture. Pour cela, il faut que le paramètre INVOICE_ALLOW_EXTERNAL_DOWNLOAD soit configuré pour permettre de générer le lien.
|
|-
|__SHIPPINGTRACKNUM__
|XXXXX
|Numéro de suivi du colis
|
|-
|__SHIPPINGTRACKNUMURL__
|<nowiki>http://trackingcompagny.com/XXXXX</nowiki>
|URL de suivi du colis
|
|-
|__DATE_YMD__
|01/01/2020
|Date d'aujourd'hui
|
|-
|__DATE_DUE_YMD__
|01/01/2020
|Date d'échéance
|
|-
|__AMOUNT__ ->
|1243,34
|Montant total
|
|-
|__AMOUNT_EXCL_TAX__ -> __AMOUNT_EXCL_TAX__
|1234,45
|Montant total hors taxe
|
|-
|__AMOUNT_VAT__ -> __AMOUNT_VAT__
|123,4
|Montant TVA
|
|-
|__AMOUNT_FORMATED__
|1243,34 €
|Montant total formaté
|
|-
|__AMOUNT_EXCL_TAX_FORMATED__
|1234,45 €
|Montant total hors taxe formaté
|
|-
|__AMOUNT_VAT_FORMATED__ -> __AMOUNT_VAT_FORMATED__
|123,4 €
|Montant TVA formaté
|
|-
|__DAY__
|12
|Jours actuel (chiffre)
|
|-
|__DAY_TEXT__
|Mardi
|Jours actuel (texte)
|
|-
|__DAY_TEXT_SHORT__
|Ma
|Jours actuel en texte abrégé
|
|-
|__DAY_TEXT_MIN__
|M
|Jours actuel en texte en une lettre
|
|-
|__MONTH__
|3
|Mois actuel (chiffre)
|
|-
|__MONTH_TEXT__
|Mars
|Mois actuel (texte)
|
|-
|__MONTH_TEXT_SHORT__
|Ma.
|Mois actuel en texte abrégé
|
|-
|__MONTH_TEXT_MIN__
|M
|Mois actuel en texte en une lettre
|
|-
|__YEAR__
|2020
|Année actuelle
|
|-
|__PREVIOUS_DAY__
|11
|Hier (chiffre)
|
|-
|__PREVIOUS_MONTH__
|2
|Mois précédent (chiffre)
|
|-
|__PREVIOUS_YEAR__
|2019
|Année précédente
|
|-
|__NEXT_DAY__
|13
|Demain (chiffre)
|
|-
|__NEXT_MONTH__
|4
|Mois prochain
|
|-
|__NEXT_YEAR__
|2021
|Année prochaine
|
|-
|__DOL_MAIN_URL_ROOT__
|<nowiki>http://mondolibarr.fr/htdocs</nowiki>
|Adresse de mon dolibarr
|
|-
|__(Clédetraduction)__
|Clé traduite
|N'importe qu'elle clé de traduction
|
|-
|__[constante]__
|Valeure de la constante
|N'importe qu'elle constante
|
|-
|__DATE_DELIVERY__
|21/09/1974
|Date de livraison de la Propal
|V14
|-
|__CONTACT_NAME_XXX__
|Mr T
|Civilité/titre prénom et nom du contact
XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_LASTNAME_XXX__
|Nom patronymique du contact
|Nom du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_FIRSTNAME_XXX__
|Prénom du contact
|Prénom du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__CONTACT_TITLE_XXX__
|Titre de civilité du contact
|Titre/civilité du contact

XXX est le type de contact défini dans Accueil>configuration>dictionnaires>Types de contacts/adresses (par exemple : __CONTACT_NAME_BILLING__ pour le contact client désigné comme responsable de la facturation sur une facture)
|
|-
|__UNSUBSCRIBE__
|
|Lien de désinscription
|
|}

=Variables de substitution Personnalisées=
Un module peut ajouter ses propres variables de substitutions.
Pour cela, le module doit embarquer un fichier avec le nom '''monmodule/core/substitutions/functions_monmodule.lib.php'''

Paramétrage Valeurs par défaut

2023-05-05T13:54:30Z

Isamuse: /* Valeurs par défaut (sur les formulaires de création) */ Quelques instructions pour les filtres par défaut

[[Category:Admin fr]]
{{TemplateDocUtil}}

'''Aide de l'écran:''' Valeurs par défaut

'''Menu d'accès:''' Accueil -> Configuration -> Valeurs par défaut (avec le gestionnaire de menu 'eldy')

Ces champs de paramétrage vous permettent de définir :

*des Valeurs par défaut
*des filtres de recherche par défaut
*des ordre de tri par défaut
*des champs par défaut ayant le focus

=Valeurs par défaut (sur les formulaires de création)=
''A écrire''

=Filtres de recherche par défaut=
Pour connaître les champs et les valeurs de filtrage, il faut examiner le code source de la page de Dolibarr dont on veut filtrer les listes.

'''Filtres par catégories (tags)'''

Exemple : filtrer la liste de ses factures clients selon leur tag/catégorie

url : compta/facture/list.php

champ : search_categ_cus

valeur : sous forme de chiffre ; correspond au rowid de la table llx_categorie. On peut aussi la retrouver en examinant le code source de la page Dolibarr affichée.

'''Filtres par périodes'''

Exemple : filtrer la liste de ses factures fournisseurs '''après''' le 1er janvier 2023

Il faut entrer trois valeurs de filtrage : celle du jour, celle du mois et celle de l'année

Pour le jour

url : fourn/facture/list.php

champ : search_date_startday

valeur : 1

Pour le mois

champ : search_date_startmonth

valeur : 1

Pour l'année

champ : search_date_startyear

valeur : 2023

Même principe pour filtrer '''avant''' une certaine date

Il faut alors utiliser les champs search_date_endday / search_date_endmonth / search_date_endyear

=Ordre de tri par défaut=
Vous pouvez définir/forcer ici la valeur par défaut que vous voulez obtenir lorsque vous créez un nouvel enregistrement, et/ou les filtres par défaut ou ordre de tri des listes. Créez une entrée avec les valeurs suivantes :

*Url
*Champ
*Ordre de tri : desc ou asc pour respectivement descendant et ascendant

Les données de configuration s'obtiennent en analysant l'adresse de la page qui contient la liste, une fois le *TRI OPÉRÉ*.
Par exemple :

htdocs/'''projet/list.php'''?sortfield='''p.dateo'''&sortorder='''desc'''&begin=&contextpage=projectlist&search_status=99

Dans le menu de configuration renseigner :

*pour l'url : projet/list.php
*pour le champ "sortfield" : p.dateo
*pour l'ordre de tri "sortorder" : desc

=Champs par défaut ayant le focus=
''A écrire''

Setup Other

2023-02-12T16:25:29Z

Isamuse: Ajout des deux options FCKEDITOR_ENABLE_SCAYT_AUTOSTARTUPFCKEDITOR_ENABLE_SCAYT_LANG

[[fr:Paramétrage_Divers]]
[[es:Configuración_Varios]]
[[de:Erweiterte_Einstellungen]]
[[zh:其他设置]]


[[Category:Admin]]
{{TemplateDocUser}}

'''Help About Screen''': Other setup

'''Menu Path''': Home ► Setup ► Other

'''Introduction'''

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.

{{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.

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>

The options here may not be documented since they are not stable and unsupported (remember they are experimental or development options). The basic format of how the list is written is broken down in the example below:

UNSTABLE_OR_DEV_OPTION ► ''Description of config and goal'' ► ''(specific version information) or values''
<center>
__TOC__
</center>
=Global Options=

*'''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 this external website to steel your login credentials ► (v10.0)
*'''FCKEDITOR_ENABLE_SCAYT_AUTOSTARTUP ►''' Allow to activate the SpellCheckAsYouType (SCAYT) plugins of CKEditorthe i.e an automatic spell checking. The value to activate this option is 1.
*'''FCKEDITOR_ENABLE_SCAYT_LANG ►''' to define the languages concerned by the automatic spell checking. The value is a list of languages without spaces (fr_FR,en_US,de_DE,it_IT)

*'''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]] breaking some features when using Dolibarr from this application.

*'''MAIN_AUTOFILL_DATE''' ► If this constant is defined (to something other than <code>0</code>), 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!

*'''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_COUNTRIES_IN_EEC''' ► Country list in European Area (For VAT purpose) ► (v10.0-v13.0). From v14, do not use this anymore (remove the constant if you set it and instead set if the country is in Europe or not from the DB for V14 - V15 and from dictionary of countries in V16 and more).

*'''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_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)

*'''MAIN_DEFAULT_LANGUAGE_FILTER''' ► Useful if you do not want to show <code>en_US</code> language option in combo boxes (other languages can easily be removed in <code>langs</code> directory but not <code>en_US</code>) ► (v10.0)

*'''MAIN_LANGUAGES_ALLOWED''' ► Is a list of languages without spaces, example : <code>fr_FR,en_US,de_DE,it_IT</code> If defined, only those languages will appear in combos. ► (v11.0)

*'''MAIN_DISABLE_NOTES_TAB''' ► Show or hide notes tab in the card page

*'''MAIN_DISABLE_CONTACTS_TAB''' ► Show or hide contacts tab in the card page

*'''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).

*'''MAIN_DISABLE_JQUERY_JNOTIFY''' ► Disable usage of <code>JNotify</code> to show confirm or error messages

*'''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 <code>1</code> ► (v3.6.0+)
*'''MAIN_DISABLE_MULTIPLE_FILEUPLOAD''' ► Disable users to upload multiple files at once.
*'''MAIN_DISABLE_TRUNC''' ► Disable all truncings in select list. ► (v7.0+)

*'''MAIN_DISABLEDRAFTSTATUS''' ► Disable the status "Draft" for some objects (project, donation, ...) so the object is directly created with status "Validated"

*'''MAIN_DOC_USE_OBJECT_THIRDPARTY_NAME''' ► Add name of thirdparty at begin of generated document.

*'''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)

*'''MAIN_DOC_UPLOAD_NOT_RENAME_BY_DEFAULT''' ► Disable the auto renaming on upload file ► (v10.0)

*'''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.

*'''MAIN_ENABLE_LOG_TO_HTML''' ► If this constant is defined, it is possible to have logs inside pages by adding the parameter <code>&logtohtml=1</code> into URL.

*'''MAIN_ENABLE_IMPORT_LINKED_OBJECT_LINES''' ► Allow to import lines into current document from "linked" compatible documents ► (v8.0+)

*'''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_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)

*'''MAIN_ALL_TOWN_TO_UPPER''' ► Dolibarr puts uppercase for town names if not done. ► (v13.0)

*'''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 <code>UTF-8</code> if on Linux or OSX system, and <code>ISO-8859-1</code> if on Windows. If not, for example on a Windows server with a NTFS <code>UTF-8</code> pagecode, you can set the variable <code>MAIN_FILESYSTEM_ENCODING</code> to "<code>utf-8</code>".

*'''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 '<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_HELPCENTER_LINKTOUSE''' ► Define the URL link to use as the target page for link "I need help" onto logon page

*'''MAIN_LOGOUT_GOTO_URL''' ► URL to which the user will be redirected after LOGOUT

*'''MAIN_MAXTABS_IN_CARD''' ► Maximum number of tabs visible. Others are grouped into a combo list.

*'''MAIN_MAXLIST_OVERLOAD''' ► Maximum number of line in space's domain.

*'''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 (<code>1</code> if not defined)

*'''MAIN_NO_CONCAT_DESCRIPTION''' ► Allow to use only input custom description in lines (proposal, order, invoice) ► (v10.0)

*'''MAIN_OPTIMIZE_SPEED''' ► Use some speed enhancements. See page [[FAQ Increase Performance]] for more information.

*'''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_PUBLIC_NOTE_IN_ADDRESS''' ► Show public note in address block ► (v4.0+)

*'''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_REPEATCONTACTONEACHTAB''' ► If added and set to <code>1</code>, 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_ROUNDOFTOTAL_NOT_TOTALOFROUND''' ► Change way of rounding total TTC lines, rounding first of after.

*'''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 '<code>UTC</code>' so PHP server timezone will not have effect anymore. Examples: <code>Europe/Paris</code>, <code>auto</code>.

*'''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_SEARCHFORM_SUPPLIER_INVOICE_DISABLED''' ► Disable the supplier invoice on the search form

*'''MAIN_SEARCH_DIRECT_OPEN_IF_ONLY_ONE''' ► If only one result is found, then setting this value to <code>1</code> will take you direct to the item (default method). Setting the value to <code>0</code> will show the result in the list as a single result ► (v5.0+)

*'''MAIN_SERVICES_ARE_ECOMMERCE_200238EC''' ► If seller and buyer are in Europe and buyer is not a company, use the VAT of buying country.

*'''MAIN_SHOW_TUNING_INFO''' ► Add tuning information into javascript console. Better when xdebug is enabled.

*'''MAIN_SHOW_TECHNICAL_ID''' ► Show also technical IDs on elements cards or some lists (not supported everywhere).

*'''MAIN_SHOWDATABASENAMEINHELPPAGESLINK''' ► Show database name in upper help menu ► (v8.0+)

*'''MAIN_USE_ALTERNATE_TRANSLATION_FOR''' ► List of fields per object that need an alternate translation. Example: <code>MAIN_USE_ALTERNATE_TRANSLATION_FOR=societe:name,town;contact:firstname,lastname</code>

*'''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_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.

*'''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_OLD_SEARCH_FORM''' ► Display the old search form in left menu.

*'''MAIN_VAT_DEFAULT_IF_AUTODETECT_FAILS''' ► Allow to force the VAT rate to a given value (instead of higher VAT rate of country) if the VAT rate of product was not defined.

*'''MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES''' ► If we can't guess if a thirdparty is a company or individual (not VAT ID fill, no Prof ID fill, no type of thirdparty fill), then we suppose it is a company (B2B business) instead of an individual (B2C business).

*'''MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL''' ► For intra CEE sales, we use by default, on proposal, order or invoice creation, a 0 VAT for customers that are companies (see MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES to change behaviour to know if a thirdparty is a company or an individual). But if the option MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL is set, we will use the 0 VAT only if a VAT ID is defined for the customer.

*'''MAIN_USE_VAT_OF_PRODUCT_FOR_INDIVIDUAL_CUSTOMER_OUT_OF_EEC''' ► For to use the default VAT of product for individual customers that are out E.E.C. (European Economic Community) ► (v7.0+). ''There is no reason to use this.''

*'''MAIN_VIEW_LINE_NUMBER''' ► Shows a line number for each line of products/services at documents like proposal / order / invoice. Only on screen, not on PDF.

*'''MAIN_VIEW_LINE_NUMBER_IN_LIST''' ► Shows a line number in lists ► (v12.0)

*'''MAIN_VOLUME_DEFAULT_ROUND''' ► Accuracy of volume (number of decimals)

*'''MAIN_VOLUME_DEFAULT_UNIT''' ► Default unit for weight (<code>0=kg</code>, <code>-3=g</code>, ...)

*'''MAIN_WEIGHT_DEFAULT_ROUND''' ► Accuracy of weight (number of decimals)

*'''MAIN_WEIGHT_DEFAULT_UNIT''' ► Default unit for weight (<code>0=kg</code>, <code>-3=g</code>, ...)

*'''USER_HIDE_INACTIVE_IN_COMBOBOX''' ► Disable display inactive users in combobox.

*'''MAIN_DISABLE_PDF_THUMBS''' ► Disable thumbs PDF in case of imagick bug

*'''MAIN_KEEP_REF_CUSTOMER_ON_CLONING''' ► Keep the Customer Reference on cloned object (Propal/Invoice)

*'''MAIN_DONT_KEEP_NOTE_ON_CLONING''' ► Remove the object notes during cloning ► (v11.0)

*'''MAIN_DOC_SORT_FIELD''' ► Set the default sorting field on document page (name by default) ► (v11.0)

*'''MAIN_DOC_SORT_ORDER''' ► Set the default sorting order (ASC or DESC) on document page (ASC by default) ► (v11.0)

*'''MAIN_USE_ZIPTOWN_DICTIONNARY''' ► Use dictionary ZIP for create card.

*'''MAIN_USE_TOP_MENU_SEARCH_DROPDOWN''' ► Show search in top menu with theme eldy ► (v11.0)

*'''MAIN_PHONE_SEPAR''' ► Separ phone number other space ► (v12.0)

*'''GRAPH_USE_FISCAL_YEAR''' ► Widgets uses fiscal year

*'''SHOW_SOCINFO_ON_PRINT''' ► Permit to add user company information on each printed document (when click on Dolibarr print button) ► (v12.0)

*'''MAIN_FEATURES_LEVEL''' ► Level of features to show: <code>-1=stable+deprecated</code>, <code>0=stable only (default)</code>, <code>1=stable+experimental</code>, <code>2=stable+experimental+development</code>

*'''MAIN_SHOW_TECHNICAL_ID''' ► Show technical id for object.

*'''MAIN_HTTP_CONTENT_SECURITY_POLICY''' ► Allows you to fill in the content security rules ► (v6.0)

*'''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.

*'''MAIN_MODULE_SETUP_ON_LIST_BY_DEFAULT''' ► If set to "common" the setup module becomes list by defaut

*'''MAIN_PAGESIZE_CHOICES''' ► Configure select field to choose number of lines displayed on listing (<code>10:10,15:15,20:20,30:30,40:40,50:50,100:100,250:250,500:500,1000:1000,5000:5000</code>).

*'''MAIN_USE_TOP_MENU_QUICKADD_DROPDOWN''' ► Add a dropdown menu with shortcuts to create new objects ► (v13.0)

*'''MAIN_EMAILCOLLECTOR_MAIL_WITHOUT_HEADER''' ► Remove the header stored by email collector ► (v13.0)

*'''MAIN_USE_VAT_OF_PRODUCT_FOR_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID'''

*'''MAIN_OPTIMIZEFORTEXTBROWSER''' ► Optimise interface for a text only browser. This variable is set to 1 automatically if your browser is lynx or links

*'''MAIN_NB_OF_YEAR_IN_WIDGET_GRAPH''' ► Set the number of years visible on some graph of some widgets (2 is default value)

*'''MAIN_CREATEFROM_KEEP_LINE_ORIGIN_INFORMATION'''

*'''API_DISABLE_LOGIN_API''' ►(v14.0)

*'''MAIN_LOGIN_BADCHARUNAUTHORIZED''' ► Add possibility to define bad character unauthorized into login name REGEX expression (Default value is @<>"\') ► (v16.0)
*'''MAIN_SHOW_ALL_FILES_ON_DOCUMENT_TOOLTIP''' ► Add all files visible from the object to be visible from the list of object.
*'''MAIN_LIST_ALLOW_PUBLIC_NOTES''' ► Display public notes on list
*'''MAIN_LIST_ALLOW_PRIVATE_NOTES''' ► Display private notes on list

*'''MAIN_CHECKBOX_LEFT_COLUMN''' ► Display private check boxes on the left ► (v17.0)
*'''MAIN_STATS_GRAPHS_SHOW_N_YEARS''' ► Nb of years to shows in widget and graph ► (v14.0)
*'''MAIN_DEBUG_SHOW_EACH_QUALIFIED_HOOK_CALL''' ► if >=2 the hook in the logs are more verbose ► (v17.0)

[[#Top|(back to top)]]

=Security Options=

*'''MAIN_SECURITY_ANTI_SSRF_SERVER_IP''' ► Can set a complete list of IPs of server.

*'''MAIN_SECURITY_CSRF_WITH_TOKEN''' ► Activate a second anti-CSRF protection on POST (so 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+)

*'''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_ALLOW_SVG_FILES_AS_IMAGES''' ► Allow to use SVG file as image files. Warning: This may introduce security vulnerability (javascript can be embedded into SVG file).

*'''MAIN_RESTRICTHTML_ONLY_VALID_HTML''' ► Refused parameter if value is not a valid HTML content.

*'''MAIN_RESTRICTHTML_REMOVE_ALSO_BAD_ATTRIBUTES''' ► Sanitize also non standard attributes on HTML content.
*'''MAIN_SECURITY_SALT''' ► A salt string to base the hashing on. 8 strings length recommended.

[[#Top|(back to top)]]

=Adherent Module=

*'''MEMBER_NEWFORM_FORCEMORPHY''' ► Force nature of member set to "phy" for physical or to "mor" for moral ► (v12.0)
*'''MEMBER_ALLOW_CHANGE_OF_TYPE''' ► Member can edit their type on public subscription page ► (v13.0)
*'''ADHERENT_DEFAULT_CREATE_THIRDPARTY''' ► Thirdparty is created when creating a new member ► (v13.0)

[[#Top|(back to top)]]

=Accountancy Module=

*'''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)
*'''ACCOUNTING_DEFAULT_NOT_NOTIFIED_VALIDATION_DATE''' ► Avoid validating the lines with the accountancy export.(1= box unchecked by default / 0 = box checked by default) ► (v14.0)
*'''ACCOUNTING_DEFAULT_NOT_NOTIFIED_EXPORT_DATE''' ► Avoid flaging the lines as exported with the accountancy export.(1= box unchecked by default / 0 = box checked by default) ► (v14.0)

[[#Top|(back to top)]]

=Agenda Module=

*'''AGENDA_ALL_CALENDARS''' ► Change the default view of calendar pages to see all the Agenda's (instead or yours only be default)

*'''AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS''' ► To automatically set end date of event to start date + delta on event creation page.

*'''AGENDA_DISABLE_LOCATION''' ► Disable location field in action card ► (>=v5.0)

*'''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.

*'''AGENDA_USE_EVENT_TYPE''' ► Add a mandatory field "Type" when creating an event ('''''deprecated''''').

*'''MAIN_ADD_EVENT_ON_ELEMENT_CARD''' ► Allow to create an event from a document (proposal, order, invoice)

*'''AGENDA_SUPPORT_PRIORITY_IN_EVENTS''' ► Allow to have priorities in events ► (>=v13.0)

*'''AGENDA_ADDACTIONFORPHONE''' ► Allow you to create a event from phone number ► (=<v12.0) - Need to be fix for (=>v12.0) https://github.com/Dolibarr/dolibarr/issues/22720

*'''AGENDA_ADDACTIONFOREMAIL''' ► Allow you to create a event from Email ► (=<v12.0) - Need to be fix for (=>v12.0) https://github.com/Dolibarr/dolibarr/issues/22720

[[#Top|(back to top)]]
=Bank Module=

*'''BANK_CAN_RECONCILIATE_CASHACCOUNT''' ► Can reconciliate cash accounts ► (v3.8)

*'''BANK_DISABLE_CHECK_DEPOSIT''' ► Disable check deposit feature

*'''BANK_ASK_PAYMENT_BANK_DURING_ORDER''' ► Ask bank account during creation of an order

*'''BANK_ASK_PAYMENT_BANK_DURING_PROPOSAL''' ► Ask bank account during creation of a proposal

*'''BANK_USE_OLD_VARIOUS_PAYMENT''' ► To allow to enter miscellaneous payments (not covered by other modules) using old method. '''''Deprecated'''''. Entering various payment is preferred ► (<=v12.0).
*'''MAIN_IBAN_IS_NEVER_MANDATORY''' ► IBAN and BIC informations not mandatory. (V15)

[[#Top|(back to top)]]

 

=BOM and MO Module=

*'''ALLOW_USE_KITS_INTO_BOM_AND_MO'''
*'''BOM_SUB_BOM''' ►Allow to add a BOM in another BOM►(v16.0)

[[#Top|(back to top)]]

 

=Bookmarks Module=

*'''BOOKMARKS_SHOW_IN_MENU''' ► Numbers of bookmark entries to be displayed (10 by default)

[[#Top|(back to top)]]

 

=Inalterable Log Module=

*'''BLOCKEDLOG_ADD_ACTIONS_SUPPORTED''' ► Can complete list of triggered action that are logged

[[#Top|(back to top)]]

 

=Category-Tags Module=

*'''CATEGORY_SHOW_COUNTS''' ► Shows nb of object by tags in tag tree

[[#Top|(back to top)]]

 

=Contracts=

*'''CONTRACT_SUPPORT_PRODUCTS''' ► Products are also suggested into module contract.
*
*'''CONTRACT_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+)
*'''CONTRACT_HIDE_PLANNED_DATE_ON_PDF''' ► allows you to not display dates on pdf files.
*'''CONTRACT_HIDE_REAL_DATE_ON_PDF''' ► allows you to not display dates on pdf files.

[[#Top|(back to top)]]

=Cron module=

*'''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]].

*'''CRON_DISABLE_TUTORIAL_CRON''' ► Disable the tutorial about how to install the cron script (on a SaaS hosting, this should be done by the web hosting provider)

*'''CRON_WARNING_DELAY_HOURS''' ► Set this value to the frequency set for the cron script (so a warning will be shown to user to warn it about max frequency of its scheduled jobs)

[[#Top|(back to top)]]

 

=Direct Debit Orders=

*'''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.

[[#Top|(back to top)]]

=Donation Module=

*'''DONATION_USE_THIRDPARTIES''' ► If this option is set, a thirdparty field appear on donation forms.

[[#Top|(back to top)]]
=Email and SMS=

*'''MAIN_MAILFORM_DISABLE_ENTERKEY''' ► Activate javascript code to disable the enter key in the MAIL form. ► (>= 8.0.1)

*'''MAIL_PREFIX_FOR_EMAIL_ID''' ► Prefix for the mails ID. Default value is <code>$_SERVER["SERVER_NAME"]</code> ► (>= 8.0.1)

*'''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>.

*'''MAIN_SMS_DEBUG''' ► Write content of SMS sent into file <code>dolibarr_sms.log</code> into directory <code>dolibarr_main_data_root</code>.

*'''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).

*'''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.

*'''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.

*'''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>

*'''MAIN_MAIL_DO_NOT_USE_SIGN''' ► Do not add user signature at end of suggested pre-defined email

*'''MAIL_FORCE_DELIVERY_RECEIPT_INVOICE''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Invoice'' module.

*'''MAIL_FORCE_DELIVERY_RECEIPT_ORDER''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Order'' module.

*'''MAIL_FORCE_DELIVERY_RECEIPT_PROPAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Customer Proposal'' module.
*'''MAIL_FORCE_DELIVERY_RECEIPT_SUPPLIER_PROPOSAL''' ► Set default as "Yes" on requesting delivery receipt when sending email through the ''Supplier Proposal'' module.

*'''MAIN_EMAIL_USECCC''' ► 1 = Show field BCC into email forms, If email = Show BCC prefilled with email.

*'''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)

*'''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.

*'''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.

*'''MAIN_MAIL_FORCE_CONTENT_TYPE_TO_HTML''' ► Force to send all email (event with text only content) as HTML formatted email.

*'''MAIN_MAIL_USE_MULTI_PART''' ► Forge email content using an alternate text part ► (for 5.0.2+). By default with 6.0+
*'''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+)

*'''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.

*'''MAIN_COPY_FILE_IN_EVENT_AUTO''' ► Add attachement document on event auto generated by sending email from dolibarr. ► (v6.0+)

*'''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:
**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.
**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'''.

*'''MAIN_MAIL_ENABLED_USER_DEST_SELECT''' ► Show also internal users into list of recipients of email in email sending form ► (v8.0+)
*

[[#Top|(back to top)]]

 

=Emailing Module=

*'''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.

*'''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 <code>'''MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS'''</code>.

*'''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.

*'''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.

*'''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.
*'''EMAILING_USE_ADVANCED_SELECTOR''' ► Enable the advanced selector for recipients.

*'''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.

*'''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.

[[#Top|(back to top)]]

 

=Expense Report=

*'''EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS''' ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)

*'''EXPENSEREPORT_OVERRIDE_VAT''' ► Setting this constant to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)

*'''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+)

*'''MAIN_USE_EXPENSE_IK''' ► This feature allows you to set index kilometers against a mileage index for different types of vehicles. ► (v7.0+)

*'''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+)

[[#Top|(back to top)]]

 

=Export Module=

*'''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>

*'''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>

*'''EXPORTTOOL_CATEGORIES''' ► Can export categories (several lines) into one column with the "product export profile"

*'''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>).
*'''EXPORTS_SHARE_MODELS''' ► Share export models between users.

[[#Top|(back to top)]]

=Foundation Module=

*'''MEMBER_URL_REDIRECT_SUBSCRIPTION''' ► Link called and shown when a member account is autocreated in member module by a guest user.

*'''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.

[[#Top|(back to top)]]

=Interventions Module=

*'''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.

*'''FICHINTER_DISABLE_DETAILS'''► Disable entry of details line on intervention. Can validate with no line.

[[#Top|(back to top)]]

=Invoice Module=

*'''MAIN_DEPOSIT_MULTI_TVA''' ► In deposits invoice, creates one line per VAT rate from the origin document ► (6.0)

*'''INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED'''* ► If a credit note was partially refunded (a refund was sent to the customer), with common situation, we wait to have the remain refunded too. With this option, it is possible to convert the remain of invoice into a discount to reuse it into another invoice.

*'''SUUPLIER_INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED''' ► See INVOICE_ALLOW_REUSE_OF_CREDIT_WHEN_PARTIALLY_REFUNDED, but for supplier credit notes.

*'''INVOICE_CAN_ALWAYS_BE_EDITED''' changed in version 15 or 16 to '''INVOICE_CAN_BE_EDITED_EVEN_IF_PAYMENT_DONE''' ► 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.

*'''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.

*'''INVOICE_CAN_NEVER_BE_REMOVED''' ► Never allow to delete invoices (except draft invoices).

*'''INVOICE_POSITIVE_CREDIT_NOTE''' ► All amounts on PDF credit notes are positive.

*'''FACTURE_DEPOSITS_ARE_JUST_PAYMENTS''' ► An old way to create initial payment. This treats deposit invoices as a special case and not as legal deposit invoice. 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.

*'''FACTURE_SENDBYEMAIL_FOR_ALL_STATUS''' ► Can send invoice by email to customer even if invoice has status "draft".

*'''INVOICE_CREDIT_NOTE_STANDALONE''' ► Start implementation to allow a credit note even without invoice (dangerous) ► (v3.9)

*'''INVOICE_USE_SITUATION''' ► Enable the "situation invoice" feature. Warning, this feature is bugged and may not be compatible with the final version of the feature once the bug will be solved. Also, using the double-entry accountancy module is not possible when this option is on (due to the same design problem).

*'''INVOICE_USE_SITUATION_CREDIT_NOTE''' ► Enable the "situation credit note" feature (need <code>INVOICE_USE_SITUATION</code>) ► (v8.0)
*'''INVOICE_USE_RETAINED_WARRANTY''' ► Enable the retained warranty on invoice ► (v14.0)

*'''INVOICE_DISABLE_DEPOSIT''' ► Disable deposit invoices

*'''INVOICE_DISABLE_REPLACEMENT''' ► Disable replacement invoices

*'''INVOICE_DISABLE_CREDIT_NOTE''' ► Disable credit notes

*'''INVOICE_ADD_ZATCA_QR_CODE''' ► Add a QR code with format ZATCA (for Saudi Arabia) on PDF of invoices.

Note: To decode a QR image of a ZATCA code: https://www.onlinebarcodereader.com/. You can also use the mobile application https://play.google.com/store/apps/details?id=com.posbankbh.einvoiceqrreader&gl=FR

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► See PDF option

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► See PDF options

*'''WORKFLOW_BILL_ON_SHIPMENT''' ► Change label of button with suitable label when you need to create invoice on shipments

*'''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+)

*'''INVOICE_POINTOFTAX_DATE''' ► Add Point of Tax Date on invoices for country-specific legality reasons ► (v4.0+)
*'''FACTURE_ENABLE_NEGATIVE''' ► Can validate an invoice when amount is negative

*'''FACTURE_ENABLE_NEGATIVE_LINES''' ► Allows to add negative lines to an invoice ► (v8.0.2+)

*'''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+)

*'''FACTURE_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object (Proposal,...) when creating the bill.
*'''FACTUREFOURN_REUSE_NOTES_ON_CREATE_FROM''' ► Reuse the Public Note and Private note of the previous object when creating the supplier bill ► (V13.0)
*'''MAIN_SHOW_FACNUMBER_IN_DISCOUNT_LIST''' ► Display the reference of credit notes in discount list when creating the bill.
*'''INVOICE_ALLOW_FREE_REF''' ► Capability 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)

*'''INVOICE_DISALLOW_REOPEN'''

*'''INVOICE_MAX_FUTURE_DELAY''' ► Numbers of seconds allowed for billing in the future ► (V14.0)
*'''INVOICE_AUTO_NEXT_MONTH_ON_LINES''' ► Increase start date and end date by one month, if an invoice line is a clone of a time based service AND if this services started on the first day of month and ended on the last day of month ► (V13.0.1)
*'''INVOICE_KEEP_DISCOUNT_LINES_AS_IN_ORIGIN''' ► Does not change a line with a negative price into an absolute discount when creating an invoice ► (V16 ?)

[[#Top|(back to top)]]

=Leave=

*'''MAIN_NON_WORKING_DAYS_INCLUDE_SATURDAY''' ► Set this value to 0 if you want to have the saturday as a working day
*'''MAIN_NON_WORKING_DAYS_INCLUDE_SUNDAY''' ► Set this value to 0 if you want to have the sunday as a working day

=Look or Theme=

*'''MAIN_FAVICON_URL''' ► favicon url

*'''MAIN_EASTER_EGG_COMMITSTRIP''' ► Show a comic image from the CommitStrip website. Images are refreshed daily. ► (v6.0+)

*'''MAIN_STATUS_USES_CSS''' ► Change status design using new style ► (v10.0+)

*'''MAIN_INCLUDE_GLOBAL_STATS_IN_OPENED_DASHBOARD''' ► 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) ► (v11.0+)

*'''MAIN_USE_TOP_MENU_SEARCH_DROPDOWN''' ► Actually only for eldy theme, this conf move search input to top menu and use new design too ► (v11.0+)

*'''THEME_AGRESSIVENESS_RATIO''' ► 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) ► (v11.0+)

*'''THEME_SHOW_BORDER_ON_INPUT'''
*'''MAIN_DISABLE_GLOBAL_WORKBOARD''' ► Hide the workboard of the main page ► (v13.0+)
*'''MAIN_DISABLE_GLOBAL_BOXSTATS''' ► Hide the Statistic Box of the main page

[[#Top|(back to top)]]

=MultiCurrency=

*'''MAIN_MULTICURRENCY_ALLOW_SYNCHRONIZATION''' ► Enable CurrencyLayer API synchronization

[[#Top|(back to top)]]

=Order Module=

*'''MAIN_USE_PROPAL_REFCLIENT_FOR_ORDER''' => Copy customer reference from proposal to order. ► (v7.0+)

*'''ORDER_REQUIRE_SOURCE''' => Make the input field "Source of order" mandatory.

*'''ORDER_VALID_AFTER_CLOSE_PROPAL''' => When an order is created on a proposal close, the order is directly defined with status "Validated".

*'''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+)

*'''ORDER_ENABLE_NEGATIVE''' => Can validate an order when amount is negative

*'''THIRDPARTY_PROPAGATE_EXTRAFIELDS_TO_ORDER''' => Copy also extrafields from thirdparty to order (if name match). ► (v11.0+)

[[#Top|(back to top)]]

 

=PDF Options=

*'''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]].

*'''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.

*'''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.

*'''MAIN_DISABLE_PDF_COMPRESSION''' ► Disable PDF compression.

*'''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>.

*'''MAIN_GENERATE_DOCUMENTS_SHOW_FOOT_DETAILS''' ► Adding the company address at the bottom of the page. Disabled by default

*'''MAIN_GENERATE_PROPOSALS_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer proposals.

*'''MAIN_GENERATE_INVOICES_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for customer invoices.

*'''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+)
*'''MAIN_GENERATE_SUPPLIER_ORDER_WITH_PICTURE''' ► Include the first image of the product into the line of the generated PDF for supplier orders

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT''' ► Disable VAT on generated documents. like for an association. (Works with crabe template)

*'''MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT_COLUMN''' ► Hide column with VAT information but only column not total.

*'''MAIN_INVERT_SENDER_RECIPIENT''' ► Invert sender and recipient in some PDF. Note: This option is set automatically if country if Germany.

*'''MAIN_ODT_AS_PDF''' ► Activate ODT to PDF conversion. Value can be "libreoffice" or "unoconv". Do not use value '''<nowiki/>'jodconverter'<nowiki/>''' any more, as it is declared deprecated and partly not functional, use value '''<nowiki/>'libreoffice'''' instead, it requires only '''soffice''' (OpenOffice or LibreOffice) installed on server (use '''apt install soffice libreoffice-common libreoffice-writer''').

If you got this error: javaldx failed! Warning: failed to read path from javaldx with no return to prompt when running soffice --headless -env:UserInstallation=file:"/tmp" --convert-to pdf --outdir xxx ./yyy.odt, check that directory defined into env:UserInstallation parameters exists and is writeable.

You may also have a look at this page if your server is on Windows: [[Générer automatiquement des documents PDF à partir de fichier ODT avec Doliwamp]]

*'''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

*'''MAIN_PDF_FORCE_FONT''' ► To ignore font defined into language file and force usage of a particular font. For example "<code>DejaVuSans</code>".

*'''MAIN_PDF_FORCE_FONT_SIZE''' ► To force size of font (by default 10). For example "<code>12</code>" ► (v11.0)

*'''MAIN_PDF_FREETEXT_HEIGHT''' ► Change height of space reserved to output the free text.

*'''MAIN_PDF_TITLE_BACKGROUND_COLOR''' ► Can define a background color onto title line. Example: <code>220,220,200</code>

*'''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 !

*'''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.

*'''MAIN_USE_COMPANY_NAME_OF_CONTACT''' ► Use contact name and information rather than company

*'''MAIN_PDF_ADDALSOTARGETDETAILS''' ► If 1, add details of reipient on generated PDFs (email, fax, url and phone). Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.

*'''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+)

*'''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► Add optional esign field in pdf propal ► (v8.0+)

*'''MAIN_PROFID1_IN_SOURCE_ADDRESS''' ► Show Professional ID 1 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID2_IN_SOURCE_ADDRESS''' ► Show Professional ID 2 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID3_IN_SOURCE_ADDRESS''' ► Show Professional ID 3 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID4_IN_SOURCE_ADDRESS''' ► Show Professional ID 4 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID5_IN_SOURCE_ADDRESS''' ► Show Professional ID 5 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''MAIN_PROFID6_IN_SOURCE_ADDRESS''' ► Show Professional ID 6 in source address of PDF to comply with legalities in certain countries ► (v8.0.1+)

*'''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.

*'''PDF_BOLD_PRODUCT_REF_AND_PERIOD''' ► Add more visibility (bold) on product ref and period of service in desc. ► (v12.0)

*'''PDF_HIDE_PRODUCT_REF_IN_SUPPLIER_LINES''' ► Modify the use/position of Supplier Ref/Internal Ref with the item Label (name) on PDF documents.

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...".

Value <code>1</code>: Supplier ref only eg."SUPPLIER-REF-001 - LABEL...".

Value <code>2</code>: Supplier ref followed by internal ref in brackets. eg."SUPPLIER-REF-001 (InternalRef COMPANY-REF-001) - LABEL...".

*'''PDF_INCLUDE_ALIAS_IN_THIRDPARTY_NAME''' ► Include alternative/alias name into name on PDF.

*'''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')))

*'''PDF_SHOW_PROJECT''' ► Show project onto PDF (supported on supplier order only for the moment)

*'''PDF_USE_1A''' ► PDF files produced by dolibarr respect PDF/A standard ► (v?)

*'''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).
*'''DOC_SHOW_FIRST_SALES_REP''' ► Show the sales representant on header (at least on propal azur and rubis template)
*'''MAIN_PDF_DASH_BETWEEN_LINES'''
*
*'''SHOW_SUBPRODUCT_REF_IN_PDF'''
*'''PDF_HIDE_PRODUCT_LABEL_IN_SUPPLIER_LINES''' ► hide product label in supplier order lines (V15+)
*'''SHIPPING_PDF_DISPLAY_AMOUNT_HT''' ► Show HT unit price and HT total price for lines of PDF shipment

[[#Top|(back to top)]]

=Point of Sale (POS)=

*'''CASHDESK_SHOW_KEYPAD''' ► Show a mouse key pad into the 'Simple Point of Sale' module.

*'''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).

*'''TAKEPOS_ENABLE_SUMUP''' ► Enable the compatibility of TakePOS with the card reader terminal [https://SumUp.fr SumUp]
*'''TAKEPOS_CAN_FORCE_BANK_ACCOUNT_DURING_PAYMENT''' ► Possibility to force the bank account during the payment in TakePOS ► (v13.0)
*'''TAKEPOS_CONTROL_CASH_OPENING''' ► Control the cash openning
*'''TAKEPOS_NUMPAD_FORCE_PAYMENT_ICONS_LABELS'''

[[#Top|(back to top)]]

=Products Module=

*'''CATEGORY_GRAPHSTATS_ON_PRODUCTS''' ► Show graph of products with categories and totals in Products Area screen

*'''MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE''' ► Avoid customs code and country of origin to be set as product description when added to Propal/Order/Invoice

*'''PRODUCT_ADD_TYPE_IN_DOCUMENTS''' ► Add text "Product" or "Service" at beginning of details lines on built PDF documents.

*'''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.

*'''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+)

*'''MAIN_SEARCH_PRODUCT_BY_FOURN_REF''' ► Allow to search a product by supplier ref in document's add line form. ► (>= 8.0)

*'''MAIN_DISABLE_FREE_LINES''' ► Disallow using free lines to add line in documents ► (>= 8.0)

*'''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+)

*'''PRODUIT_DESC_IN_LIST''' ► Show long description of product/service into lists.

*'''PRODUCT_DISABLE_PROPAGATE_CUSTOMER_PRICES_ON_CHILD_COMPANIES''' ► Disable propagation of prices per customer from a customer to its child company.

*'''PRODUCT_DISABLE_PUBLIC_URL''' ► Disable public url in product card ► (v14.0+)
*'''PRODUCT_DISABLE_STOCK_LEVELS''' ► Disable properties of stock limits and desired optimal value on product ► (v14.0+)
*'''PRODUCT_DISABLE_NATURE''' ► Disable nature in product card ► (v14.0+)
*'''PRODUCT_DISABLE_WEIGHT''' ► Disable weight in product card ► (v14.0+)
*'''PRODUCT_DISABLE_PRICES''' ► Disable prices in product card ► (v14.0+)
*'''PRODUCT_DISABLE_ACCOUNTING''' ► Disable accounting in product card ► (v14.0+)
*'''PRODUCT_DISABLE_SIZE''' ► Disable size in product card.

*'''PRODUCT_DISABLE_LENGTH''' ► Disable length in product card ► (v4.0+)

*'''PRODUCT_DISABLE_SURFACE''' ► Disable surface in product card. ► (v4.0+)

*'''PRODUCT_DISABLE_VOLUME''' ► Disable volume in product card.

*'''PRODUCT_DISABLE_CUSTOM_INFO''' ► Disable custom info (custom code and country origin) in product/service card.

*'''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.

*'''PRODUIT_CUSTOMER_PRICES_BY_QTY''' ► If price per quantity ► ''Experimental''
*'''PRODUIT_CUSTOMER_PRICES_BY_QTY_MULTIPRICES''' ► If price per quantity and customer ► ''Experimental''

*'''PRODUCT_LOT_ENABLE_QUALITY_CONTROL''' ► Enable feature for control quality on Lot

*'''PRODUCT_MAX_LENGTH_COMBO''' ► Limit the length of the label displayed when adding lines in proposals/invoices/orders

*'''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.

*'''PRODUIT_PDF_MERGE_PROPAL''' ► Enable module Propal merge product PDF

*'''PRODUCT_USE_OLD_PATH_FOR_PHOTO''' ► Ask dolibarr to check also old path (before 3.7) where photos were stored.

*'''PRODUCT_USE_UNITS''' ► Add another units on products (Use same dictionnary as default unit feature) and propagate this unit on line of documents.

*'''RESOURCE_ON_PRODUCTS''' ► Allow to affect ressources on products/services ► (v10.0+)
*'''RESOURCE_ON_SERVICES''' ► Allow to affect ressources on products/services ► (v10.0+)
*'''PRODUCT_SHOW_ORIGIN_IN_COMBO''' ► Show origin of products when adding lines in proposals/invoices/orders ► (v12.0+)
*'''PRODUIT_ATTRIBUTES_HIDECHILD''' ► Add option hide child if variantes

*'''PRODUCT_ADD_FORM_ADD_TO''' ► Add a product to a draft proposal/order/invoice, from the product card.
*'''PRODUCT_DISABLE_SELLBY''' ► Hide the Sell by date ► (v13.0+)
*'''PRODUCT_DISABLE_EATBY''' ► Hide the Eat by date ► (v13.0+)

*'''PRODUCT_DENY_CHANGE_PRODUCT_TYPE''' ► Forbid to change the product type

*'''PRODUCT_SORT_BY_CATEGORY''' ► Sort the product by categories instead of by ID
*'''PRODUCT_ADD_NET_MEASURE''' ► Support Net Measure in product's card.php (For real weight, volume or piece; needed for some business ie fruits, vegetables....). Note brut value is already available natively, use this option only if you need 2 weights, 2 volumes, ...for each product) ► (v11.0.1+)
*'''PRODUCT_PRICE_BASE_TYPE''' ► value 'TTC' / 'HT' specify the default value of the price (with or without taxes) ► (v16.0.0+)

*'''PRODUCT_LOAD_EXTRAFIELD_INTO_OBJECTLINES''' ► Load product extrafiled on object lines

[[#Top|(back to top)]]

 

=Projects Module=

*'''PROJECT_ALLOW_TO_LINK_FROM_OTHER_COMPANY''' ► Can link an object to a project of another thirdparty
*'''PROJECT_ALLOW_COMMENT_ON_PROJECT''' ► Add comment feature on a project

*'''PROJECT_ALLOW_COMMENT_ON_TASK''' ► Add comment feature on project task

*'''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.

*'''PROJECT_CREATE_ON_OVERVIEW_DISABLED''' ► Hide the "create ..." button on the overview page ► (v4.0)

*'''PROJECT_DISABLE_UNLINK_FROM_OVERVIEW''' ► Enable removing the button from a link in the project overview. ► (>= v8.0.1)

*'''PROJECT_HIDE_UNSELECTABLES''' ► Hide into select list, all project that we can't select (closed or draft)

*'''PROJECT_HIDE_TASKS''' ► Hide tasks. For user using project only as an analytics key and not using tasks.

*'''PROJECT_LIST_SHOW_STARTDATE''' ► Shows start date of projects in project lists.

*'''PROJECT_LINK_ON_OVERWIEW_DISABLED''' ► Hide the "link to" form on the overview page ► (v4.0)

*'''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)

*'''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).

*'''PROJECT_OPEN_ALWAYS_ON_TAB''' ► Set to value 'task', or 'preview' to always open the project on the given tab instead of main tab.
*
*
*'''PROJECT_ELEMENTS_FOR_MINUS_MARGIN'''

[[#Top|(back to top)]]

=Proposals Module=

*'''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.

*'''MAIN_PROPAL_CHOOSE_ODT_DOCUMENT''' ► On setup page, you'll be able to select which ODT document to use when close or cancel proposals.

*'''MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING''' ► add optional esign field in pdf propal ► (v8.0+)

*'''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.

*'''PROPAL_DISABLE_SIGNATURE''' ► Do no show the box for signature.

*'''PRODUIT_PDF_MERGE_PROPAL''' ► When generating the proposal PDF, all PDFs linked to products linked to proposal are also included into final PDF

*'''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+)

*'''PROPOSAL_AUTO_ADD_AUTHOR_AS_CONTACT''' ► Add Proposal Author as user contact follow proposal

*'''PROPOSAL_PDF_HIDE_PAYMENTTERM''' ► Do not show the payment term on proposal ► (v11.0+)

*'''PROPOSAL_PDF_HIDE_PAYMENTMODE''' ► Do not show the payment mode on proposal ► (v11.0+)

*'''WORKFLOW_PROPAL_CAN_CLASSIFY_BILLED_WITHOUT_INVOICES''' ► Button "Classified Billed" is visible on proposal even if there is no invoice linked to proposal.
*'''PROPAL_REOPEN_UNSIGNED_ONLY''' ► Do not allow reopening of signed (or billed) proposals. (V15)
*'''PROPOSAL_ARE_NOT_BILLABLE''' ► Disable billing button on proposals (V15)

[[#Top|(back to top)]]

 

=Services Module=

*'''SERVICE_ARE_ECOMMERCE_200238EC''' ► If seller and buyer are in Europe and buyer is not a company, use the VAT of buying country. For french speaking people, see also the page [[Loi_européenne_TVA_Vente_à_Distance_VAD_et_e-commerce_BtoC]].

*'''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

[[#Top|(back to top)]]

=Shipments=

*'''STOCK_WAREHOUSE_NOT_REQUIRED_FOR_SHIPMENTS''' ► If set, you can add a shipment line, with no stock source defined. ► (>= 8.0.1)

*'''SHIPMENT_GETS_ALL_ORDER_PRODUCTS''' ► Add all order lines in shipment, including the one with 0 in quantity
*'''SHIPPING_PDF_HIDE_ORDERED''' ►Hide column quantity ordered on shippment pdf (>=15.0)

[[#Top|(back to top)]]

=Stocks=

*'''SUPPLIER_ORDER_DISABLE_STOCK_DISPATCH_WHEN_TOTAL_REACHED''' ► Disable stock dispatch when total expected was already received

*'''STOCK_EXCLUDE_VIRTUAL_PRODUCTS''' ► If product is a virtual product, we do not manage stock for it.

*'''ENTREPOT_EXTRA_STATUS''' ► Instead of the 2 status (Closed, Open), a Warehouse has 3 status: Closed, Open (for all movements), Open (for internal movement only). Internal movement only means you can't use the warehouse to make shipment or receptions.
*'''SUPPLIER_ORDER_STATUS_FOR_VIRTUAL_STOCK''' ► For the calculation of virtual stocks, by default supplier orders with the status 3 (ordered) and 4 (partially received) are used. You can enter the list of statuses to be taken into account separated by commas for this calculation (example: 0,1,2,3)
*'''STOCK_MOVEMENT_LIST_HIDE_UNIT_PRICE''' ► to hide unit price on some pages (V15+)

[[#Top|(back to top)]]

=Suppliers Module=

*'''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.''

*'''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.

*'''SUPPLIER_INVOICE_WITH_PREDEFINED_PRICES_ONLY''' ► Restrict selection of products in supplier invoice to only those with a buying price defined for that supplier. ► (v6.0+)

*'''SUPPLIER_ORDER_AUTOADD_USER_CONTACT''' ► Add user approving supplier order as a contact automatically.

*'''SUPPLIER_ORDER_DEFAULT_PAYMENT_MODE_ID''' ► Set the default payment method for suppliers (<code>rowid</code> in table <code>llx_c_paiement</code>).

*'''SUPPLIER_ORDER_USE_DISPATCH_STATUS''' ► Add a status on each dispatch order line when receiving products from suppliers ► (v4.0+)

*'''SUPPLIER_ORDER_NO_DIRECT_APPROVE''' ► No button "Validate and Approve". Always do step "Validate" and "Approve" in 2 steps.

*'''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+)

*'''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+)

*'''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+)

*'''DISPLAY_DISCOUNTED_SUPPLIER_PRICE''' ► Allow to display discounted supplier price when searching product in supplier documents ► (v10.0)

*'''MAIN_CAN_EDIT_SUPPLIER_ON_SUPPLIER_ORDER''' ► Allow to change the supplier on a draft supplier order ► (v10.0)
*
*'''SUPPLIER_PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD'''

[[#Top|(back to top)]]

=Third Parties Module=

*'''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)

*'''MAIN_UNKNOWN_CUSTOMERS_ARE_COMPANIES''' ► See in Global options section.

*'''MAIN_USE_VAT_COMPANIES_IN_EEC_WITH_INVALID_VAT_ID_ARE_INDIVIDUAL''' ► See in Global options section.

*'''SOCIETE_EMAIL_MANDATORY''' ► E-mail is a mandatory field when creating a thirdparty

*'''SOCIETE_DISABLE_CUSTOMERS''' ► Remove all menu and features related to customers

*'''SOCIETE_DISABLE_PROSPECTS''' ► Remove all menu and features related to prospects

*'''SOCIETE_DISABLE_STATE''' ► Do not use field "state/province"

*'''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.

*'''SOCIETE_ASK_FOR_SHIPPING_METHOD''' ► Shipping method can be predefined on customer card and will be used as default on order creation
*'''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

*'''THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER''' ► Possible to add Categories to third parties that are not customer, prospect or supplier.

*'''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.

*'''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.

*'''THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT''' ► Do not set status "Customer/Prospect" to "on" when creating a new third party from menu "New third party".

*'''THIRDPARTY_INCLUDE_PARENT_IN_LINKTO''' ► Search also for elements on parent third party when using the "link to" object feature.

*'''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).

*'''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.

*'''THIRDPARTY_SUGGEST_ALSO_ADDRESS_CREATION''' ► Enabled contact creation on third-party create card
*'''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'
*'''MEMBER_CAN_CONVERT_CUSTOMERS_TO_MEMBERS''' ► Enabled member creation on third-party create card
*'''SOCIETE_DISABLE_PARENTCOMPANY''' ► Disables attachment to a parent company.
*'''THIRDPARTY_CUSTOMERPROSPECT_BY_DEFAULT''' ► Set the third party to customer by default
*'''THIRDPARTY_SUPPLIER_BY_DEFAULT''' ► Set the third party to supplier by default
*'''THIRDPARTY_CUSTOMERTYPE_BY_DEFAULT''' ► Set the third party type by default (3 = customer & prospect / 2 = prospect / 1 = customer )
*'''CONTACT_DISABLE_PERSONALINFO''' ► Disable Personal data on contact page
*'''SOCIETE_DISABLE_WORKFORCE''' ► Disable work force selector on society page
*'''SOCIETE_SHOW_VAT_IN_LIST''' ► display VAT number in combo list of thirdparties ► (V15+)
*'''THIRDPARTY_DEFAULT_CREATE_CONTACT''' ► When set, a contact is created at the creation of an invidual third party ► (v14.0)

[[#Top|(back to top)]]

=Ticket Module=

*'''TICKET_SHOW_MESSAGES_ON_CARD''' ►Display all ticket related messages on the main ticket card. ► (>= 10.0)
*'''TICKET_AUTO_ASSIGN_CONTRACT_CREATE''' ►Automatically create a contract linked to the ticket ► (>= 10.0)
*'''TICKET_AUTO_CREATE_FICHINTER_CREATE''' ►Automatically create an intervention linked to the ticket ► (>= 10.0)
*'''WORKFLOW_TICKET_CLOSE_INTERVENTION''' ►On ticlet close, automatically close an intervention linked to the ticket
*'''TICKET_CHECK_NOTIFY_THIRDPARTY_AT_CREATION''' ►Automatically check "notify thirdparty at creation" ( >=16)
*'''TICKETS_MESSAGE_FORCE_MAIL''' ► Precheck email sending on ticket message (>=15)

 

=VAT Report=

*'''MAIN_INCLUDE_ZERO_VAT_IN_REPORTS''' ► Include lines with VAT to 0% (for "auto-liquidation" in EEC) ► (v8.0.3+)

[[#Top|(back to top)]]

=Website Module=

*'''WEBSITE_USE_WEBSITE_ACCOUNTS''' ► Add a table and a tab to manage some accounts for websites to a third party
*
*
*'''WEBSITE_ADD_CSS_TO_BODY'''

[[#Top|(back to top)]]

 

=WYSIWYG Editor=

*'''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.
*'''FCKEDITOR_ALLOW_ANY_CONTENT''' ► Allow to enter any content. However, this will totally disable content filtering which is one of the most important CKEditor features. You can use this to keep all your tags and attributes in the html content.

[[#Top|(back to top)]]

=STRIPE Module=

*'''STRIPE_FORCE_VERSION''' ► Force the STRIPE version. For Example: "2019-09-09" (v11+)

[[#Top|(back to top)]]

=ClickToDial Module=

*'''CLICKTODIAL_FORCENEWTARGET''' ► Open in new page.

[[#Top|(back to top)]]

 

=For SaaS / Cloud hosting integrators=

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.

*'''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]].

*'''CRON_DISABLE_TUTORIAL_CRON''' ► Disable the tutorial about how to install the cron script (on a SaaS hosting, this should be done by the web hosting provider)

*'''CRON_WARNING_DELAY_HOURS''' ► Set this value to the frequency set for the cron script (so a warning will be shown to user to warn it about max frequency of its scheduled jobs)

*'''MAILING_NO_USING_PHPMAIL''' ► To avoid bad use of the emailing module, it is recommended to set this option 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.

*'''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' ► If you set a limit on number of recipient on your system, you can set some option to match the same values so users will be informed: So '''MAIL_MAX_NB_OF_RECIPIENTS_IN_SAME_EMAIL''' restricts sending of 1 email message to <code>x</code> recipients for the same email message (x for To: + CC: + BCC:). If not defined, value is <code>10</code>. Required to fight against spamming that include a ton of 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. Note that this is not a hard limit; it is just the quantity that will be displayed on warnings on screen. For a real limit, this must be implemented into the system.

*'''MAILING_LIMIT_SENDBYDAY''' ► This is a limit of number of emails, an instance can send. Note that this is not a hard limit; it is just the quantity that will be displayed on warnings on screen. For a real limit, this must be implemented into the system.

*'''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)''

*'''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).

*'''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:
**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.
**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'''.

*'''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.

*'''MAIN_FIRST_PING_OK_ID''' ► Set this value to "disabled" to remove completely any ping after a complete setup.

*'''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'.

*'''MAIN_HIDE_WARNING_TO_ENCOURAGE_SMTP_SETUP''' ► Set to 1 by default (so warning is hidden). You can set it to 0 to show a warning to encourage admin to set its own SMTP service.

*'''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.

*'''MAIN_NO_UPGRADE_REDIRECT_ON_LEVEL_3_CHANGE''' ► The page to make the migration is not shown automatically when deploy files of version X.Y.Z+delta are installed on database version X.Y.Z. The upgrade page will be shown automatically only if there is a change on value of X or Y in version.

*'''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).

*'''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.

[[#Top|(back to top)]]

Mode multilangue

2022-04-29T10:20:55Z

Isamuse: /* Mentions complémentaires */

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation/configuration=

===Activation du mode multi-langue===

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

===Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)===

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
===Langue de communication par défaut des tiers et des contacts===

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›.

A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

Pour les contacts, vous pouvez créer des catégories pour indiquer la langue de communication sans modification du core. Avec ce fix https://github.com/Dolibarr/dolibarr/pull/20688 vous pourrez gérer la langue par défaut dans la fiche du contact de la même manière que c'est géré en natif pour le tiers.

===Gérer son catalogue de produits et services===

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées. Il faut utiliser les derniers modèles pdf : espadon, eratosthene, sponge, cyan, cornas et storm.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

===Modèle d'Emails===

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

===Entrées des dictionnaires spécifiques à votre instance Dolibarr===

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

 

===Documents commerciaux===

====Langue====
Les documents de Dolibarr seront générés dans la langue par défaut du tiers.

Il est possible de générer des documents pdf bilingues, dans la langue par défaut et dans une langue à choisir. Dans '''Accueil -> Configuration -> Divers''', ajouter PDF_USE_ALSO_LANGUAGE_CODE et lui donner la valeur de la seconde langue, par exemple "en_GB".

====Mentions complémentaires====
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Par exemple, si l'on veut faire apparaître la mention complémentaire "Indemnité forfaitaire pour frais de recouvrement : 40 €" sur les factures en français et en anglais :

#on crée le nom de la variable de substitution, "IndemRecouvr"
#dans la configuration de la facture, on complète la zone mention complémentaire ainsi __(IndemRecouvr)__
#dans Accueil - Configuration - Traduction, on ajoute la clé "IndemRecouvr" et sa traduction/valeur dans les langues choisies, par exemple : "Indemnité forfaitaire pour frais de recouvrement : 40 €" pour le français et "Flat-rate compensation for collection costs: 40€" pour l'anglais.

Mode multilangue

2022-04-22T14:40:29Z

Isamuse: langue des documents Dolibarr

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation/configuration=

===Activation du mode multi-langue===

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

===Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)===

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
===Langue de communication par défaut des tiers et des contacts===

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›.

A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

Pour les contacts, vous pouvez créer des catégories pour indiquer la langue de communication sans modification du core. Avec ce fix https://github.com/Dolibarr/dolibarr/pull/20688 vous pourrez gérer la langue par défaut dans la fiche du contact de la même manière que c'est géré en natif pour le tiers.

===Gérer son catalogue de produits et services===

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées. Il faut utiliser les derniers modèles pdf : espadon, eratosthene, sponge, cyan, cornas et storm.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

===Modèle d'Emails===

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

===Entrées des dictionnaires spécifiques à votre instance Dolibarr===

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

 

=== Documents commerciaux ===

==== Langue ====
Les documents de Dolibarr seront générés dans la langue par défaut du tiers.

Il est possible de générer des documents pdf bilingues, dans la langue par défaut et dans une langue à choisir. Dans '''Accueil -> Configuration -> Divers''', ajouter PDF_USE_ALSO_LANGUAGE_CODE et lui donner la valeur de la seconde langue, par exemple "en_GB".

====Mentions complémentaires====
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Par exemple, si l'on veut faire apparaître la mention complémentaire "Indemnité forfaitaire pour frais de recouvrement : 40 €" sur les factures en français et en anglais :

#on crée le nom de la variable de substitution, "IndemRecouvr"
#dans la configuration de la facture, on complète la zone mention complémentaire ainsi __(IndemRecouvr)__
#dans Accueil - Configuration - Traduction, on ajoute la clé "IndemRecouvr" et sa traduction/valeur dans les langues choisies, "Indemnité forfaitaire pour frais de recouvrement : 40 €" pour le français et "Flat-rate compensation for collection costs: 40€" pour l'anglais.

Mode multilangue

2022-04-22T13:24:07Z

Isamuse: Modeles pdf à utiliser

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation=

==Activation du mode multi-langue==

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

==Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)==

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
==Langue de communication par défaut des tiers et des contacts==

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›.

A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

Pour les contacts, vous pouvez créer des catégories pour indiquer la langue de communication sans modification du core. Avec ce fix https://github.com/Dolibarr/dolibarr/pull/20688 vous pourrez gérer la langue par défaut dans la fiche du contact de la même manière que c'est géré en natif pour le tiers.

==Gérer son catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées. Il faut utiliser les derniers modèles pdf : espadon, eratosthene, sponge, cyan, cornas et storm.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Modèle d'Emails==

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

==Mentions complémentaires dans les documents commerciaux==
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Par exemple, si l'on veut faire apparaître la mention complémentaire "Indemnité forfaitaire pour frais de recouvrement : 40 €" sur les factures en français et en anglais :

#on crée le nom de la variable de substitution, "IndemRecouvr"
#dans la configuration de la facture, on complète la zone mention complémentaire ainsi __(IndemRecouvr)__
#dans Accueil - Configuration - Traduction, on ajoute la clé "IndemRecouvr" et sa traduction/valeur dans les langues choisies, "Indemnité forfaitaire pour frais de recouvrement : 40 €" pour le français et "Flat-rate compensation for collection costs: 40€" pour l'anglais.

Mode multilangue

2022-04-22T12:57:02Z

Isamuse: /* Langue de communication par défaut des contacts */

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation=

==Activation du mode multi-langue==

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

==Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)==

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
==Langue de communication par défaut des tiers et des contacts==

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›.

A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

Pour les contacts, vous pouvez créer des catégories pour indiquer la langue de communication sans modification du core. Avec ce fix https://github.com/Dolibarr/dolibarr/pull/20688 vous pourrez gérer la langue par défaut dans la fiche du contact de la même manière que c'est géré en natif pour le tiers.

==Gérer son catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Modèle d'Emails==

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

==Mentions complémentaires dans les documents commerciaux==
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Par exemple, si l'on veut faire apparaître la mention complémentaire "Indemnité forfaitaire pour frais de recouvrement : 40 €" sur les factures en français et en anglais :

#on crée le nom de la variable de substitution, "IndemRecouvr"
#dans la configuration de la facture, on complète la zone mention complémentaire ainsi __(IndemRecouvr)__
#dans Accueil - Configuration - Traduction, on ajoute la clé "IndemRecouvr" et sa traduction/valeur dans les langues choisies, "Indemnité forfaitaire pour frais de recouvrement : 40 €" pour le français et "Flat-rate compensation for collection costs: 40€" pour l'anglais.

Mode multilangue

2022-04-22T10:39:28Z

Isamuse: Détail de la mise en place de mentions complémentaires des documents

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation=

==Activation du mode multi-langue==

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

==Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)==

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
==Langue de communication par défaut des tiers==

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›. A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

==Gérér son catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Modèle d'Emails==

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

==Mentions complémentaires dans les documents commerciaux==
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Par exemple, si l'on veut faire apparaître la mention complémentaire "Indemnité forfaitaire pour frais de recouvrement : 40 €" sur les factures en français et en anglais :

# on crée le nom de la variable de substitution, "IndemRecouvr"
# dans la configuration de la facture, on complète la zone mention complémentaire ainsi __(IndemRecouvr)__
# dans Accueil - Configuration - Traduction, on ajoute la clé "IndemRecouvr" et sa traduction/valeur dans les langues choisies, "Indemnité forfaitaire pour frais de recouvrement : 40 €" pour le français et "Flat-rate compensation for collection costs: 40€" pour l'anglais.

Mode multilangue

2021-11-16T20:42:42Z

Isamuse: Ponctuation

Le mode multi-langue permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si son activation s'effectue dans la page de configuration consacrée à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr.

=Activation=

==Activation du mode multi-langue==

Menu '''"Accueil -> Configuration -> Affichage"'''

Puis bouton « Activer l’interface multi-langage »

==Limiter les listes de langues disponibles sur son interface (à partir de la v10 de Dolibarr ?)==

Dans '''Accueil -> Configuration -> Divers''', ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »(plusieurs langues séparées par une virgule, sans espace).

Pour connaître les valeurs applicables, on peut se rendre par exemple dans '''Accueil -> Configuration -> Traduction'''. Cette option étant une option expérimentale, il n'est pas recommandé de l'utiliser.

Si vous voulez avoir une liste des langues fréquentes que vous utilisez, mieux vaut dans le dictionnaire des langues, définir la langue comme étant une lange "Favorite". Elle apparaitra alors en premier dans les listes déroulantes de langues.

=Utilisation=
==Langue de communication par défaut des tiers==

Dans la fiche du tiers, sélectionner la langue qui sera utilisée pour la trame de pdf à utiliser à partir du champ ‹ langue par défaut ›. A la génération d'un pdf, cette langue par défaut sera utilisée. Le pdf peut être généré à tout moment dans une autre langue en sélectionnant la langue appropriée sur la fiche de votre document commercial.

==Gérér son catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Modèle d'Emails==

Une fois l’option multi-langue activée, il est possible d’affecter une langue à ses modèles de courriers électroniques. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

Les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Toutefois, si vous ajoutez vos propres entrées dans le dictionnaire, il faudra intégrer les traductions de ces entrées créées dans les dictionnaires et spécifiques via le menu '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple les entrées ajoutées pour le dictionnaire des:

*Titres de civilités
*Conditions de règlement
*Délais de paiement
*Délais de livraison
*…

==Mentions complémentaires dans les documents commerciaux==
Pour mettre une mention complémentaire dans un document, il vous faut ajouter une variable de substitution de texte de traduction.
Par exemple __(MonTexte)__

Ensuite, dans le menu Accueil - Configuration - Traduction, ajouter la traduction pour chaque langue à la clé de traduction MonTexte.

Dans l'attente de la mise à jour de cette rubrique, vous pouvez consulter le sujet consacré à ce point sur le forum : https://www.dolibarr.fr/forum/t/mention-multi-langues-chaines-de-traductions-et-facture/31239/3

Mode multilangue

2021-02-23T14:10:51Z

Isamuse:

Mode multilangue

2021-02-23T13:52:24Z

Isamuse: Mise en page

Le mode multi-langues permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si sa configuration se trouve dans le menu consacré à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr (cf. interface utilisateur).

==Activation du mode multilangue==

Accueil - config - Affichage

Puis « Activer l’interface multi-langage »

==Pour limiter les langues affichées aux langues utilisées (à valider à partir de la v10)==

Dans Accueil / Configuration / Divers, ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »

Pour connaître les codes applicables, on peut se rendre par exemple dans Accueil - config - traduction

==Sélectionner automatiquement la langue de communication par défaut avec un tiers ?==

Dans la fiche du tiers, sélectionner la langue choisie pour la trâme de pdf à utiliser dans le champ ‹ langue par défaut ›

==Catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Emails==

Il faut créer ses emails en spécifiant la langue de chacun d’eux. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

En principe les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Il faudra intégrer les traductions des entrées créées dans les dictionnaires et spécifiques à l’instance Dolibarr via Accueil / Configuration / Traduction

Cela concerne

* Titres de civilités
* Conditions de règlement
* Délais de paiement

* Délais de livraison
* Etc…

== Mentions complémentaires dans les documents commerciaux ==
'''Au jour de la rédaction de cette fiche, la mention complémentaire sur les documents commerciaux''' mais n’est pas substituée. Il existerait un fix.

Voir le sujet consacré à ce point sur le forum : <nowiki>https://www.dolibarr.fr/forum/t/mention-multi-langues-chaines-de-traductions-et-facture/31239/3</nowiki>

Premiers paramétrages

2021-02-23T13:49:52Z

Isamuse: renvoi à la page dédiée sur le mode multi-langue

[[en:First_setup]]
[[de:Grundeinstellungen]]
[[es:Primeras_configuraciones]]
[[zh:设置]]


[[Category:Admin fr]]
{{TemplateDocUtil}}

Après l'installation proprement dite de Dolibarr, vous devez le paramétrer pour l'adapter à vos besoins avant de l'utiliser réellement.

=Société/Institution=

Pour commencer, à partir de la page d'accueil, rendez-vous dans le menu "'''Configuration -> Société/Institution'''" et éditez les informations de votre institution.

*'''Nom:''' Nom de la société ou association
*[[File:Logo size.jpg|thumb]]'''Logo:''' Ajouter ici votre logo (.png, .jpg or .gif). Le logiciel accpete toutes les tailles mais il est recommandé d'utiliser un logo de 130 pixels de hauteurs et jusqu'à 800 pixels de largeur. Voici un petit schéma de ce que cela peut donner sur les documents PDF. Il vaut mieux un format png SANS fond transparent (Dolibarr utilise FPDF qui ne gère pas ce genre de fichier). Dans le doute, utilisez un logo au format jpg sur fond blanc.
*'''Pays:''' N'oubliez pas de définir votre pays car des options en dépendent
*'''TVA:''' Définissez si vous êtes soumis ou non à la TVA.

=Modules=

L'activation des modules est très importante. Elle dépend de l'utilisation que vous prévoyez de faire de Dolibarr. Il est très peu probable que vous ayez besoin de la totalité des modules.
Il vous faut donc activer les modules dont vous aurez très probablement besoin. Par exemple: Sociétés, Factures éventuellement Comptabilité.

Pour activer les modules qui vous intéressent, rendez-vous dans le menu "'''Configuration -> Modules'''" et cliquez sur le lien "Activer".

La liste des modules standards est définie sur la page [[:Category:Liste des Modules|Liste des Modules]].

Si vous n'êtes pas sûr de vous, activez les modules les uns après les autres et voyez les fonctionnalités qu'ils ajoutent dans Dolibarr (vérifiez avant les droits, voir ci-dessous). Il est bien sûr possible de désactiver des modules après coup.

Une fois activés, certains modules nécessitent une configuration supplémentaire (cliquer sur l'icône qui apparait tout à droite sur la même ligne). Voir la [[:Category:Liste des Modules|documentation du module]] pour plus d'information.

=Menus=
Choisissez dans cette rubrique quel gestionnaire de menu utiliser pour les utilisateurs internes et externes. Le gestionnaire de menu influe sur les libellés, ordres et organisation des menus haut et gauches. Voir la page [[Système de menus]] pour plus d'information.

=Affichage=

Cette partie vous permet de choisir la langue et la présentation des pages. Dans un premier temps vous devriez conserver les options par défaut.

L'option multilangue permet de gérer différente traduction pour la traduction des produit par exemple, ainsi que de choisir la langue par défaut des clients afin d'éditer les documents PDF dans la langues par défaut du tiers. Une synthèse des paramétrages à effectuer à la suite de l'activation de l'option multilangue est disponible sur la page dédiée de ce wiki<syntaxhighlight lang="html5">
<a href="https://wiki.dolibarr.org/index.php?title=Mode_multilangue&oldid=49814">
</syntaxhighlight>.

copie écran

[[File:Configuration_-Affichage_2018.jpg]]

=Autres (Boites, Alertes, Sécurité, Limites et précisions, EMails, Dico...)=
Les autres entrées du menu Configuration sont des options avancées. Il n'est pas obligatoire de les parcourir.

*[[Paramétrage Traduction]]
*[[Paramétrage Valeurs par défaut]]
*[[Paramétrage Boites]]
*[[Paramétrage Alertes]]
*[[Paramétrage Sécurité]]
*[[Paramétrage Limites et précisions]]
*[[Paramétrage PDF]]
*[[Paramétrage EMails]]
*[[Paramétrage SMS]]
*[[Paramétrage Dictionnaires]]
*[[Paramétrage Divers]]

=Utilisateurs=
La dernière étape consiste à créer les utilisateurs et à attribuer les permissions.
Presque tous les modules, même activés précédemment, ne sont pas accessibles si on n'en donne pas la permission.
Pour cela, vous pouvez vous rendre dans le menu '''Accueil -> Utilisateurs & Groupes''' pour définir les utilisateurs et leurs droits. Attention, il faudra penser à vérifier et redéfinir les droits utilisateurs quand vous activerez à nouveau de nouveaux modules.
La liste des droits disponibles dépendant des modules activés (voir plus haut) et des permissions par défaut, il est recommandé de configurer cette partie après avoir activé les modules désirés.
Pour certaines actions, si vous n'avez pas les droits pour faire une action, Dolibarr ne vous la proposera pas. Vous risquez de rater des choses utiles et/ou importantes.
Pour donner les droits à un utilisateur ou vous-même si vous êtes administrateur, aller dans '''Accueil -> Utilisateurs & Groupes''', choisissez la fiche de l'utilisateur désiré, puis cliquer sur l'onglet '''Permission'''.

Il est possible d'éviter ces étapes de configuration à faire pour chaque nouvel utilisateur en configurant les droits par défaut (comprendre droits attribués automatiquement à chaque nouvel utilisateur créé), en configurant les permissions par défaut sur la page [[Paramétrage_Sécurité]].

Mode multilangue

2021-02-23T13:44:37Z

Isamuse:

Le mode multi-langues permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si sa configuration se trouve dans le menu consacré à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr (cf. interface utilisateur).

==Activation du mode multilangue==

Menu "'''Accueil -> Configuration -> Affichage'''"

Puis bouton « Activer l’interface multi-langage »

==Pour limiter les langues affichées aux langues utilisées (à valider à partir de la v10)==

Menu "'''Accueil -> Configuration -> Divers'''" / : ajouter la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »

Pour connaître les valeurs applicables, on peut se rendre par exemple à la page '''Accueil -> Configuration -> Traduction'''

==Sélectionner la langue de communication par défaut avec un tiers==

Dans la fiche du tiers, sélectionner la langue par défaut pour les communications avec le tiers et les contacts rattachés au tiers.

==Catalogue de produits et services==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- cliquer sur l’onglet « Traduction »

- choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

==Emails==

Il faut créer ses emails en spécifiant la langue de chacun d’eux. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie.

==Entrées des dictionnaires spécifiques à votre instance Dolibarr==

En principe les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Si vous avez créé vos propres entrées dans les dictionnaires, il faudra intégrer vos traductions la page via '''Accueil -> Configuration -> Traduction'''

Cela concerne par exemple

- Titres de civilités

- Conditions de règlement

- Délais de paiement

- Délais de livraison

- etc…
==Mentions complémentaires dans les documents commerciaux==

'''Au jour de la rédaction de cette fiche, la mention complémentaire sur les documents commerciaux''' n’est, semble-t-il, pas substituée. Il existe un post sur le forum Dolibarr consacré à ce point auquel vous pouvez vous référer dans l'attente de la mise à jour de cette page : <nowiki>https://www.dolibarr.fr/forum/t/mention-multi-langues-chaines-de-traductions-et-facture/31239/3</nowiki>

Mode multilangue

2021-02-23T13:36:32Z

Isamuse: Création de la page

Le mode multi-langues permet des communications avec les tiers Dolibarr dans la langue choisie.
Même si sa configuration se trouve dans le menu consacré à l’affichage, ce mode ne gère pas l’affichage de l’interface pour les utilisateurs de Dolibarr (cf. interface utilisateur).

== Activation du mode multilangue ==

Accueil - config - Affichage

Puis « Activer l’interface multi-langage »

== Pour limiter les langues affichées aux langues utilisées (à valider à partir de la v10) ==

Dans Accueil / Configuration / Divers, ajoutez la constante MAIN_LANGUAGES_ALLOWED avec les valeurs des langues choisies, par exemple pour le français et l’anglais du Royaume-Uni « fr_FR,en_GB »

Pour connaître les codes applicables, on peut se rendre par exemple dans Accueil - config - traduction

== Sélectionner automatiquement la langue de communication par défaut avec un tiers ? ==

Dans la fiche du tiers, sélectionner la langue choisie pour la trâme de pdf à utiliser dans le champ ‹ langue par défaut ›

== Catalogue de produits et services ==

Sur chaque fiche produit/service, une fois l’option multi-langue activée, apparaît un onglet « traduction » qui permet de gérer les textes des produits/services dans les langues activées.

Pour ajouter une traduction :

- Cliquer sur l’onglet « Traduction »

- Choisir la langue concernée, compléter le libellé du produit/service puis sa description avant de valider

== Emails ==

Il faut créer ses emails en spécifiant la langue de chacun d’eux. Pour les « civilités » des destinataires des emails, les variables de substitution (par exemple __CONTACT_NAME_XXX__) utiliseront la traduction appropriée pour la langue choisie

== Entrées des dictionnaires spécifiques à votre instance Dolibarr ==

En principe les entrées des dictionnaires qui sont pré-configurées dans Dolibarr sont déjà traduites.

Il faudra intégrer les traductions des entrées créées dans les dictionnaires et spécifiques à l’instance Dolibarr via Accueil / Configuration / Traduction

Cela concerne

- Titres de civilités

- Conditions de règlement

- Délais de paiement

- Délais de livraison

- Etc…

== Mentions complémentaires dans les documents commerciaux ==

'''Au jour de la rédaction de cette fiche, la mention complémentaire sur les documents commerciaux''' mais n’est pas substituée. Il existerait un fix.

Voir le sujet consacré à ce point sur le forum : <nowiki>https://www.dolibarr.fr/forum/t/mention-multi-langues-chaines-de-traductions-et-facture/31239/3</nowiki>