From Dolibarr Wiki

Help about screen: Other setup

Menu path: Home -> Setup -> Other

Contents 1 Goal 2 List of known hidden options 2.1 Global options 2.2 EMail and SMS 2.3 Module Tiers 2.4 Commercial proposal module 2.5 Invoice module 2.6 Order module 2.7 Export module 2.8 Agenda module 2.9 Product module 2.10 Service module 2.11 Foundation module 2.12 Intervention module 2.13 Suppliers module 2.14 PDF Options

Goal

This page is build to add/edit new parameters without a dedicated page build to edit them. In most cases, it is parameters for your own development, external modules, or hidden features.

For a standard usage of Dolibarr, this screen must be kept empty and not be used.

List of known hidden options

Some options are not visible in the interface (often because they are deprecated or beta features). In most cases you do not need these functions and their use may make the application unstable.

To enable them you have to define a constant to 1 in Home - Setup - Other:

Global options

• MAIN_APPLICATION_TITLE => This will change the title of software (that appears on the login page by default).

• MAIN_AUTOFILL_DATE => If this constant is defined (to something else than 0), the date of invoice, proposal, order or payment are filled with current date. It is highly recommended to NOT ENABLE this feature. This create a lot of input errors with no data not validated by users. This lead in bad values saved in database giving headaches when you have to do your accountancy reports ! However some users want it, so we provide it.

• MAIN_DISABLE_FULL_SCANLIST => Constant to define to disable complete scan of tables to know the total amount of element to allow the pagination to show total number of pages. To activate on systems with a very important number of data (Tables with more than 500 000 records).

• MAIN_FIRST_TO_UPPER => Dolibarr add upper case to thirdparties, contacts or members names if not done. Warning, with some languages (whose words with uppercase are not same words, or pagecode does not always have an uppercase, like cyrillic languages), this feature may alter your data.

• MAIN_LOGTOHTML => If this constants is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.

• 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_REMOVE_INSTALL_WARNING => Remove all security warning that appears to administrator users if URL /install is public. You shoud solve the problem if warning occurs instead of removing this warning. For this, put a file called install.lock into Dolibarr root directory. This will remove warning but also make the page /install not possible to use to protect your installation.

• MAIN_OPTIMIZE_SPEED => Use some speed enhancements. See page Increase_Performance for more information.

• MAIN_OVERWRITE_TRANS_xx_YY => You can use this to change value of a translation key for language xx_YY (ie: en_US) without editing language files. For example: "TranslationKey1:New value1,TranslationKey2:New value 2". Note that using this option slow down seriously your instance. If you can, it is better to edit directly the language files into htdocs/lang/xx_YY.

• MAIN_REPEATCONTACTONEACHTAB => If added and set to 1, this add contacts on all tabs, not only main tab.

• MAIN_USE_ADVANCED_PERMS => Active advanced permissions functionality. You will get more details permission but you loose the homogeneity of permission rules.

• MAIN_DISABLE_JQUERY_JNOTIFY => Disable usage of JNotify to show confirm or error messages

• MAIN_USE_JQUERY_JEDITABLE => Allow to update from screnn, directly into database, some properties of elements (invoices, proposals, ...) using Ajax. This make response time faster, but avoid using this features, because, it overpass some business actions (updates onother data that should be done consitently) and ignore business controls on data you saved. So this feature breaks consitency of data and stability of 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).

• MAIN_HELPCENTER_LINKTOUSE => Define a target link "I need help" onto logon page

• MAIN_MODULES_FOR_EXTERNAL => Limit available modules for external users. By defaut value is 'facture,commande,contact,propal,projet,contrat,societe,ficheinter,expedition,agenda'

• MAIN_PRODUCT_DISABLE_CUSTOMCOUNTRYCODE => Avoid Custom code and country of orign to be set as product description when added to Propal/ORder/Invoice

• MAIN_SHOW_TUNING_INFO => Add tuning information into javascript console. Better when xdebug is enabled.

EMail and SMS

• MAIN_MAIL_DEBUG => Write content with header of last mail into file dolibarr_mail.log into directory dolibarr_main_data_root.

• MAIN_SMS_DEBUG => Write content of SMS sent into file dolibarr_sms.log into directory dolibarr_main_data_root.

• MAIN_MAIL_ALLOW_SENDMAIL_F => On Linux or BSD system, PHP email function use the command sendmail local to server. In some cases, the sender email must be provided on command line of sendmail with option -f. This option is here to ask Dolibarr to call the function mail of PHP by adding value for the option -f. Note that in most cases, even with sendmail, sender email is correctly managed as it is added in the email technical header. This option is here only for rare setup of sendmail that ask the -f option to be mandatory.

• MAIN_MAIL_SENDMAIL_FORCE_BA => On Lunix or BSD system, PHP email function use the command sendmail local to server. In some case, we want to recipient to be provided to sendmail into the email content instead of its command line parameter. For this we must add the -ba parameter to sendmail. This option ask PHP to provide this parameter when sending a mail. Note that another solution is to edit the mail.force_extra_parameters=-ba into php.ini file.

• 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 be be modified and become correct during sending, solving any problem. Add this constant if your recipient experience problems when opening email for example users using webmail of orange.fr or hotmail.com

• MAIN_MAIL_DO_NOT_USE_SIGN => Do not add user signature at end of suggested predefined email

Module Tiers

• 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"
• MAIN_THIRPARTY_CREATION_INDIVIDUAL => Default Thirparty create are individual

Commercial proposal module

• 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.
• MAIN_PROPAL_CHOOSE_ODT_DOCUMENT => On setup page, you'll be able to select which ODT document to use when close or cancel proposals.

Invoice module

• FACTURE_SHOW_SEND_REMINDER => Show link "Send reminder by mail", same feature than "Send by mail" (obsolete feature).
• INVOICE_CAN_ALWAYS_BE_REMOVED => Allow to always delete invoices (even if invoice is not last one).
• 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_CHANGE_THIRDPARTY => Allow to change the third party in the draft invoices. If a discount was set from the original thirdparty, then discount remain, making data not coherent.
• FACTURE_USE_PROFORMAT => Enable PROFORMAT invoices type.
• FACTURE_DEPOSITS_ARE_JUST_PAYMENTS
• MAIN_USE_LOCALTAX_TYPE_7 => Enable local tax type 7 into dictionnary of vat types (disabled by default because implementation still need works).
• MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT => Disable VAT on genrated documents. like for an association. (it's work with crabe template)

Order module

• COMMANDE_REQUIRE_SOURCE => Make the input field "Source of order" mandatory.
• COMMANDE_VALID_AFTER_CLOSE_PROPAL => When an order is created on a proposal close, the order is directly defined with status "Validated".

Export module

• EXPORT_CSV_SEPARATOR_TO_USE => String value to use as separator to delimit fields int exported files (by default Dolibarr use ","). Example: EXPORT_CSV_SEPARATOR_TO_USE=;
• EXPORT_CSV_FORCE_CHARSET => Choose the charset of file built by CSV export. By default: UTF-8. Example: EXPORT_CSV_FORCE_CHARSET=ISO-8859-1

Agenda module

• 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).

Product module

• PRODUCT_ADD_TYPE_IN_DOCUMENTS => Add text "Product" or "Service" at beginning of details lines on built PDF documents.
• PRODUCT_SHOW_WHEN_CREATE => Old option no more supported (create problems) to be able to add lines of product during first step of element creation.
• 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.
• PRODUIT_DESC_IN_LIST => Show long description of product/service into lists.

Service module

• SERVICE_ARE_ECOMMERCE_200238EC => If this option is enabled, services are processed like eServices according to directove of EU Council Directive 2002/38/EC (http://ec.europa.eu/taxation_customs/taxation/vat/traders/e-commerce/article_1610_en.htm). Default VAT rate are based on buying country instead of selling country for BtoC sells.

Foundation module

• MEMBER_URL_REDIRECT_SUBSCRIPTION => Link called and shown when a member account is autocreated in member module by a guest user.

Intervention module

• FICHEINTER_CLASSIFY_BILLED => Allow to classify a intervention card as "Billed"

Suppliers module

• FOURN_PRODUCT_AVAILABILITY => On the Suppliers price page of the products, active the supplier product availability.

PDF Options

• MAIN_DISABLE_FORCE_SAVEAS => If your browser ask always to save downloaded files on disk (like PDF), try to add this option. File might appears directly into your browser.

• MAIN_DISABLE_PDF_COMPRESSION => Disable PDF compression.

• MAIN_INVERT_SENDER_RECIPIENT => Invert sender and recipient in some PDF.

• 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 server with low CPU.

• MAIN_USE_BACKGROUND_ON_PDF => Define this constant with short name of an image (example "myimage.jpg") that must be saved into directory "documents/mycompany/logos". This will add this background image into your generated PDF files.

• MAIN_ADD_PDF_BACKGROUND => Define this constant with short name of a PDF file (example "mypdf.pdf") that must be saved into directory "documents/mycompany". This will add PDF as a background of some of your generated PDF files (proposals,invoices,orders). If you need to concat PDF, see instead Module Concat PDF.

• MAIN_PDF_ADDALSOSOURCEDETAILS => Shows all contact information in PDF files of your own company (< 3.2)

• MAIN_PDF_FORCE_FONT => To ignore font defined into language file and force usage of a particular font. For example "DejaVuSans".

• MAIN_PDF_MARGIN_LEFT, MAIN_PDF_MARGIN_RIGHT, MAIN_PDF_MARGIN_TOP, MAIN_PDF_MARGIN_BOTTOM => To force the margins (mm) of PDF documents (10 is default).

• MAIN_PDF_FREETEXT_HEIGHT => Change height of space reserved to output the free text.

• MAIN_PDF_TITLE_BACKGROUND_COLOR => Can define a background color onot title line. Example: '220,220,200'

• MAIN_USE_COMPANY_NAME_OF_CONTACT => Use contact name and information rather than company