Open main menu

Changes

Setup Other

2,247 bytes added, 4 months ago
m
Here is a "todo list" showing wich options are not yet documented (for V11 on 01/12/2019) : [[Setup Other todolist]]
List of Known Hidden Options After Global Options, the list is sorted alphabetically. The basic format of how the list is written is broken down in the example below:
HIDDEN_CONFIG ► ''Description of config'' ► ''(specific version information) or values''
*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 ► Enter (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 public 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 address ). This is to avoid to have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of the serversome emailing servers.**If he chose smtp method, so it appears in a message will explain him the help list of IP he can use if there is restriction on IP by the email SMTP agent. If you also need to add a message to help SPF setup page, 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=
*EXPENSEREPORT_ALLOW_OVERLAPPING_PERIODS ► Can enter several expense reports on same or overlapping date periods. ► (v7.0+)
 
*EXPENSEREPORT_OVERRIDE_VAT ► Setting constant EXPENSEREPORT_OVERRIDE_VAT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)
*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_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+)
 
*OVERRIDE_VAT_FOR_EXPENSE_REPORT ► Setting constant OVERRIDE_VAT_FOR_EXPENSE_REPORT to 1 will allow expense reports to show VAT even if the global VAT setting is off ► (v10.0)
[[#Top|(back to top)]]
 
=Export Module=
*MAIN_INVERT_SENDER_RECIPIENT ► Invert sender and recipient in some PDF.
*MAIN_ODT_AS_PDF ► Activate PDF conversion from ODT document. If value is '<code>jodconverter</code>', '''java ''' and '''jodconverter ''' command line tool must be available. If value is '<code>/pathto/jodconverter.jar</code>' then '''java ''' and the jodconvertar '''jodconverter''' jar must exist. Soffice , '''soffice''' must also be available. The constant <code>MAIN_DOL_SCRIPTS_ROOT</code> Must must also be defined to path where the "scripts" directory is stored (for example <code>/var/www/mydolibarr</code>without scripts).
*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_ADDALSOTARGETDETAILS ► Add particular details like the telephone number on generated PDFs. Can be useful in cases where a printed order/invoice etc is given to a delivery driver/courier etc.
*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+)
*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_MAX_LENGTH_COMBO ► Limit the length of the label displayed when adding lines in proposals/invoices/orders
*PRODUCT_USE_OLD_PATH_FOR_PHOTO ► Ask dolibarr to check also old path (before 3.7) where photos were stored.
*PRODUCT_USE_UNITS ► Enable Add another units from dictionary in product/service cardon products (Use same dictionnary as default unit feature) and propagate this unit on line of documents.
*RESOURCE_ON_PRODUCTS_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+)
[[#Top|(back to top)]]
 
=Projects Module=
*MAIN_PDF_PROPAL_USE_ELECTRONIC_SIGNING ► add optional esign field in pdf propal ► (v8.0+)
*PROPOSAL_AUTO_ADD_AUTHOR_AS_CONTACT ► Add Proposal Author as user contact follow proposal
*PROPALE_PDF_HIDE_PAYMENTTERMMODE ► Do not show the payment mode on proposal ► (v7.0+)
[[#Top|(back to top)]]
 
=Services 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_FORCE_DEFAULT_STATE_ID ► <code>rowid (integer)</code> of a state/province as defined in <code>llx_c_departements</code>. On the creation of a third party/contact, the state/province corresponding to this rowid is preselected in the dropdown list. ► (>= 8.0.1)
*SOCIETE_DISABLE_CUSTOMERS ► Remove all menu and features related to customers
*SOCIETE_DISABLE_STATE ► Do not use field "state/province"
*THIRDPARTY_NOTCUSTOMERPROSPECT_BY_DEFAULT SOCIETE_SORT_ON_TYPEENT Do not set status The combo list of "Customer/Prospect" to type of third party"is sorted onalphabetical order instead of the field " when creating a new third party from menu "New third partyposition"that appears into dictionary instead.
*THIRDPARTY_NOTSUPPLIER_BY_DEFAULT SOCIETE_ASK_FOR_SHIPPING_METHOD Do not set status "Supplier" to "Shipping method can be predefined on" when creating a new third party from menu "New third party".customer card and will be used as default on order creation
*SOCIETE_SORT_ON_TYPEENT THIRDPARTY_CAN_HAVE_CATEGORY_EVEN_IF_NOT_CUSTOMER_PROSPECT_SUPPLIER The combo list of "type of Possible to add Categories to third party" is sorted on a field "position" parties that appears into dictionary instead of alphabetical order. *THIRDPARTY_DEFAULT_CREATE_CONTACT ► With this setting as 1 the option is set for third parties to be created WITH the child contact ► (v5are not customer, prospect or supplier.0+)
*THIRDPARTY_DEFAULT_USEVAT ► When creating a new third party, the field "Use vat" is set to on or off depending on value of this parameter.
*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_NOTSUPPLIER_BY_DEFAULT ► Do not set status "Supplier" 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).
 
*SOCIETE_ASK_FOR_SHIPPING_METHOD ► Shipping method can be predefined on customer card and will be used as default on order creation
*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.
*MAIN_DISABLE_RESTRICTION_ON_THIRDPARTY_FOR_EXTERNAL ► External users are always restricted on the thirdparty of their contact record. With this option, permission "see all thirdparty" may works also for external user. Not implemented yet...
 
*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_SUGGEST_ALSO_ADDRESS_CREATION ► Enabled contact creation on third-party create card
=STRIPE Module=
*STRIPE_FORCE_VERSION ► Force the STRIPE version . For Example: "2019-09-09" (v11+)
[[#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 the system)
*To avoid bad use of the emailing module, it is recommended to set the option MAILING_NO_USING_PHPMAIL to 1 (This option is described previously). Also you can complete the message visible by customers when they try to setup the SMTP credentials of their Dolibarr by using the constant MAILING_SMTP_SETUP_EMAILS_FOR_QUESTIONS (This option is described previously). For example, you can point to a FAQ on your website.
*MAIN_EXTERNAL_SMTP_CLIENT_IP_ADDRESS: (A better name If you set a system limit on number of this recipient, you can set some option should to match the same values so users will be MAIN_EXTERNAL_MAIL_CLIENT_IP_ADDRESSinformed: 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:). Set here the list of IPs where your Dolibarr instances 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 hostedalso available. So when your customer go into the setup area of email:
- If he chose mail method*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 will explain him how to say ''Warning: To avoid abuse, when using default setup its SPF record , you are restricted to 500 emails per day for its email domain all your application (showing the list account may be suspended in case of violation of IP)this rule. This is to avoid You can setup application to use your own SMTP server for sending email so you want have its emails, sent from its Dolibarr instance, fails due to strict antispam rule of some emailing servers.no restriction at all (see menu Home-Setup-Emails)''
- *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_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_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'.
*WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER: Put here a text a a translation key of a text MAIN_MIN_NB_ENABLED_MODULE_FOR_WARNING ► If set to show when N, the user warning saying modules are not activated will use the feature "Deploy" when he want be shown if number of activated module is < N (Having this variable not defined is same than having it set to deploy a website done with Dolibarr CMS1). So This may be usefull if you can, for example, show him a message that this feature is not part of is subscription preinstall an application with some modules already loaded by default and putting a website online may you want to keep the warning to be sure the user will enable other modules he need a complementary subscription, even if some modules are already enabed.
*CRON_DISABLE_KEY_CHANGE: When you provide an instance SYSLOG_DISABLE_LOGHANDLER_SYSLOG ► Set this to a customer, you probably also add an entry in the cron 1 to disable usage 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 syslog (setup of module 'Scheduled Jobs'). Because, a having all customer of a Saas platform will probably have no access to edit instances logging in the cron same system 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]]a good idea).
*SYSLOG_DISABLE_LOGHANDLER_SYSLOG: Set this WEBSITE_REPLACE_INFO_ABOUT_USAGE_WITH_WEBSERVER ► Put here a text or a translation key of a text to 1 show when the user will use the feature "Deploy" when he want to disable usage of syslog (having all customer instances logging in the same system file 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 good idea)complementary subscription.