Difference between revisions of "First setup"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Visual
Tag: 2017 source edit
 
(92 intermediate revisions by 12 users not shown)
Line 1: Line 1:
−
[[Category:Admin]]
+
<!-- BEGIN interlang links -->
 +
<!-- Do NOT edit this section
 +
    Links below are automatically managed by PolyglotBot
 +
    You can edit links on the English source page : Configuração_inicial -->
 +
[[fr:Premiers_paramétrages]]
 +
[[de:Grundeinstellungen]]
 +
[[es:Primeras_configuraciones]]
 +
[[zh:设置]]
 +
[[ja:JA_First_setup]]
 +
<!-- END interlang links -->
 +
 
 +
[[Category:Admin_en]]
 
{{TemplateDocUser}}
 
{{TemplateDocUser}}
  
−
After Dolibarr installation, you must setup Dolibarr parameters to match your needs.
+
After completing the initial installation, you must configure parameters in Dolibarr to match your needs.
 +
 
 +
=Company/Organization=
 +
The first mandatory step is to define your company/organization information. For this, from home page, choose menu  "'''Home->Setup->Company/Organization'''" and add the information for your company/organization.
  
−
= Company/Foundation =
+
*'''Name:''' Name of your company/organization
−
The first mandatory step is to define your company/foundation. For this, from home page, choose menu  "'''Setup -> Company/Foundation'''" and edit informations for company or foundation you want to manage.
+
*[[File:Logo size.jpg|thumb]]'''Logo:''' Add here a logo of your company (.png, .jpg or .gif). It can accept any size but it is recommended to use a logo with 130 pixels height and up to 800 pixels width. Here is a little scheme on what will be the result on the PDF. The recommended format is png.
 +
*'''Logo (squared):''' Add here your squared logo (.png or .jpg) that will be used in the top right corner of the application
 +
*'''Fiscal Year:''' Define your starting month of yiscal Year
 +
*'''Country:''' Define your country: other options depend on this selection.
  
−
* '''Name:''' Name of your company or foundation
+
*'''Prof ID X:''' The fields Prof ID are used to store the professional IDs of a company. Each country requires its own professional ID. For example, for a company in France you may find a SIRET, SIREN, NAF, RCS and EORI number, and for a company in Argentia, you will find CUIT/CUIL, Ingresos Brutos, CIF Intra. Dolibarr is able to manage 6 Professional ID. The label of each of them is defined with the translation key ProfIdXCC (where X is 1 to 6 and XX the country code of the company, for example XX=FR). To add a new Professional ID, you can add a new translation from menu Home - Setup - Translation for the key ProfIdXCC. If you set the value of translation to "-", it means that the professional ID is hidden when using the application in the language of translation on every company that has the country code XX.
−
* '''Logo:''' Add here a logo of your company (.png, .jpg or .gif). There is no recommended size but the image but the recommended format is png with NO transparent layer (Dolibarr use FPDF that does not support this format).
 
−
* '''Pays:''' Don't forget to define your country because some other options depends on it.
 
−
* '''VAT:''' Also tell if you have to manage VAT or not.
 
  
−
= Modules =
+
*'''Sales Tax (VAT) Management:''' Define how you manage Sales Tax (or not).
−
Activation of modules is the second mandatory step. Modules you will enable depends on usage you want to do of Dolibarr. In most cases, you want use all modules, so you have to enable one by one each module you plan to use. For example, to manage a company, you might enable module: Third party, Invoices and Products, but probably a lot of more modules.
+
*'''Second type of tax:''' Define if you would like to use second type of taxe (or not).
 +
*'''Third type of tax:''' Define if you would like to use third type of taxe (or not).
  
−
List of standard modules is defined on page [[:Category:List of Modules|List of Modules]].
+
=Modules=
 +
[[File:List of modules en.png|alt=List of modules|thumb|List of modules]]
 +
The activation of modules is the second mandatory step. Which modules you will activate depends on what you want to do with Dolibarr. In most cases, you may want to use all modules. You have to activate each module one by one. For example, to manage a company, you might activate at least modules Third party, Invoices, and Products, but probably many more.
  
−
If you are not sure of the meaning of a module, you can enable it one by one and see what new menu appears in Dolibarr (also after enabling a module, check that you grant to yourself permissions on new features that was enabled). You can enable or disable a module when you want.
+
To activate a module, go to page "'''Home->Setup->Modules'''" and click the button 'on/off' in the "Status" column to enable it.
 +
*The module is '''on''' if the 'on/off' button is like [[File:On off button on.png|alt='on/off' button in on position|'on/off' button in on position]]
 +
*The module is '''off''' if the 'on/off' button is like [[File:On off button off.png|alt='on/off' button in off position|'on/off' button in off position]]
  
−
Once module has been activated, some of them need a particular setup (click on icon that appears on the right of line if a module need its own setup). See [[:Category:List of Modules|documentation of module]] for more informations.
+
The list of standard modules is defined on page [[:Category:List of Modules|List of Modules]].
  
−
= Menus =
+
If you are unsure of the function of a module, you may activate it and see what new menu item appears in Dolibarr (the horizontal bar), also after activating a module, check that you grant to yourself permissions on new features that were enabled. You can activate or deactivate a module when you want.
−
Choose here which menu manager you want to use for internal and external users. The menu manager change labels, orders and organisation of left and top menus.
 
  
−
= Display =
+
Once a module has been activated, it may need further configuration (click on the setup icon that appears on the right of module line if a module needs its own setup). See [[:Category:List of Modules|documentation of module]] for more information.
−
On this page, you can define force language of application and the look and feel of screens. In a first use, you can keep everything with default values.
 
  
−
= Other (Boxes, Alerts, Security, Limits and accuracy, Emails, Dictionnary...) =
 
−
Other entries in Setup menu are advanced options. You can forget them if you want.
 
  
−
= Users =
+
Related videos:
−
The last step is to create users and assign permissions. Almost all the modules, even activated earlier, are not accessible if you do not give permissions. To do this, you can go to the Home menu -> Users & Groups to define users and their rights. Attention you should consider to check and reset the user rights when you enable a new modules. The list of rights available depending on the enabled modules enabled (see above), it is recommended to configure permissions after activating the modules you want to use. For certain actions, if you do not have the rights to do an action, Dolibarr will not show you action. You might miss some useful or important features. To give rights to a user or yourself if you are an administrator, go to Home -> Users & Groups, select the desired user, then click on its '''Permission''' tab.
 
  
−
= Some hidden options =
+
Modules:
−
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.
+
(vocal in french but subtitles are available and review in this language)
  
−
To enable them you have to define a constant to 1 in '''Home - Configuration - Miscellaneous''':
+
<youtube width="200" height="120">qfYP-iKWd7U</youtube>
  
−
== Global options ==
+
Module settings:
 +
(vocal in french but subtitles are available and review in this language)
  
−
* MAIN_APPLICATION_TITLE => This will change the title of software (that appears on the login page by default).
+
<youtube width="200" height="120">toT0jfmMCoU</youtube>
  
−
* 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).
+
=Display=
 +
[[File:Display settings EN.png|alt=Display settings|thumb|Display settings]]
 +
On this page, you can set the default language of application and the look and feel of screens. In a first use, you can keep everything with default values.
  
−
* MAIN_LOGTOHTML => If this constants is defined, it is possible to have logs inside pages by adding the parameter &logtohtml=1 into URL.
+
==Language==
 +
In the language settings, you can set the Default Language. By default it is set to "Auto Detect" so the language will be set automatically to the one of the user (so the language of the web browser).
  
−
{{ToTranslate}}
+
''Note:'' Activating multilanguage option will allow you to be able to set the preferred language of customers, to print their Invoice/Proposal/Order in their own language. Product translations will also be available.
−
* MAIN_AUTOFILL_DATE => Si cette constante est définie (à autre chose que 0), la date de facture, propal, commande ou paiement est préremplie avec la date du jour. Il est fortement recommandé de NE PAS ACTIVER cette option, ceci générant une saisie sans validation de la part des utilisateurs sur les dates, ce qui se traduit par des données incorrectes enregistrées et un beau casse tête lorsqu'il faut faire sa compta ! Toutefois l'option reste disponible, à la demande de certains utilisateurs.
 
  
−
* MAIN_AUTOFILL_TOWNFROMZIP => Permet le remplissage automatique de la ville depuis le code postal. Javascript/Ajax ne doit pas etre désactivé pour que cette option fonctionne.
+
==Skin and colors==
 +
In Dolibarr you have two different pre-defined skins :
 +
* eldy [[File:Eldy Theme thumb.png]]
 +
* md [[File:Md theme thumb.png]]
 +
More skins can be downloaded on the dolistore [https://www.dolistore.com/4-skins]
  
−
* MAIN_MAIL_ALLOW_SENDMAIL_F => Sur les systèmes Linux ou BSD, la fonction d'envoi de mail de PHP utilise la commande sendmail local au serveur. Dans certains cas, l'email émetteur doit être passé en ligne de commande par l'option -f à sendmail. Cette option permet donc de demander à Dolibarr d'utiliser la fonction '''mail''' de php en intégrant l'option -f. Notons que dans la plupart des cas, même avec sendmail, l'email émetteur est bien géré car intégré avec les autres paramètres dans l'entête technique du mail. Cette option permet juste de passer outre certaines configurations qui rendent obligatoire l'option -f.
+
You can also personalize the skin color, and look in this setup.
  
−
* MAIN_MAIL_NO_FULL_EMAIL => L'email destinataire et émetteur sont nettoyés pour être de la forme "<email>" au lieu de "Nom <email>". Ceci peut résoudre des problèmes de compatiblité sur de très vieux agent mails.
+
''Tip: To test the dark mode on a specific page without going on this page to switch the dark mode option, you can add the parameter &THEME_DARKMODEENABLED=2 to force the dark mode or &THEME_DARKMODEENABLED=0 to force the dark mode off.
 +
''
  
−
* MAIN_USE_HOURMIN_IN_DATE_RANGE => Sur toutes les lignes de détail d'entité (facture, commande, contrat...), il est possible de définir l'heure en plus du jour sur les champs date de début et de fin de services.
+
==Miscellaneous==
 +
On this section, you have all the default values of features like, javascript functions, length of lists, first day of the week, etc.
 +
<br />
 +
You can also put a "Message of day" that will be displayed for all the users. In this message, you can use the [[Variable substitution system]]
  
−
* MAIN_SHOW_LOGO => Affiche logo société en haut du menu gauche.
+
==Login page==
 +
On this section, you can customize the login page with a message and a background image. In this message, you can use the [[Variable substitution system]]
 +
<br />
 +
It is also possible to hide/show the "'''Need help or support'''" link on login page
  
−
* MAIN_REMOVE_INSTALL_WARNING => Supprime le warning de sécurité apparent aux administrateurs si l'URL /install est accessible. Il est préférable de ne pas utiliser ce paramètre mais de plutôt placer un fichier nommé install.lock dans la racine de Dolibarr, ce qui a pour effet non seulement de supprimer le warning mais aussi d'empêcher tout utilisation de l'outil d'installation et mise à jour (qui ne requiert pas d'habilitation) tant que ce fichier est présent.
+
=Menus=
 +
[[File:Menu Setup.png|alt=Menu Setup|thumb|Menu Setup]]
 +
Choose here which menu manager you want to use for internal and external users and for computer or smartphone. The menu manager changes the labels, orders and organization of the left and top menus.
 +
See page [[Menus system]] for more information.
  
−
* MAIN_DISABLE_FORCE_SAVEAS => Si votre navigateur propose systématiquement d'enregistrer les fichiers sur disques (comme les PDF), essayer d'ajouter cette option. Les fichiers pourront alors s'afficher dans le lecteur du navigateur.
+
==Menu handlers==
 +
The software comes with two different menu handler :
 +
* Eldy : It is the default menu, the menu entries are centralized and hard coded. You can add entries on this menu but not change the default menu entries.
 +
* Auguria : It is a database  menu manager. This menu can be fully customized to your needs.
 +
In the Menu handlers tab, you can choose the menu for internal and external users and for computer or smartphone.
  
−
* MAIN_DISABLE_PDF_COMPRESSION => Désactive la compression sur les PDF générés.
+
==Menu Editor==
 +
In this tab, you can customize each menu entry of '''auguria''' menu or the additional entries of '''eldy '''menu and create new entries
  
−
* MAIN_GENERATE_DOCUMENTS_WITHOUT_VAT => N'affiche aucune information sur la tva dans les modèles générés.
+
==Miscellaneous==
 +
In this tab, you can choose the behavior of the unauthorized menu entry. By default, the unauthorized menu entry are in gray, but can be hidden.
  
−
* MAIN_OPTIMIZE_SPEED => Use some speed enhancements, like using the minifying and compressed version of javascript. Apache server must be configured to have the line
+
=Other (Widgets, Alerts, Security, Limits and accuracy, Emails, SMS, Dictionary setup...)=
−
AddType text/javascript .jgz
+
Other entries in Setup menu are advanced options. You can ignore them if you want.
−
AddEncoding gzip .jgz
 
  
−
* MAIN_USE_BACKGROUND_ON_PDF => Définir cette constante avec le nom court d'une image (exemple "monimage.jpg") qui est placé dans le répertoire "documents/societe/logos", ajoute un fond de page dans les documents PDF constitué de cette image.
+
*[[Setup Translation]]
 +
*[[Setup Default values/filters/sorting]]
 +
*[[Setup Widgets]]
 +
*[[Setup Alerts]]
 +
*[[Setup Security]]
 +
*[[Setup Limits and accuracy]]
 +
*[[Setup PDF]]
 +
*[[Setup EMails]]
 +
*[[Setup SMS]]
 +
*[[Setup Dictionnary|Setup Dictionary]]
 +
*[[Setup Other]]
  
−
== Commercial proposal module ==
+
=Users=
−
* PROPALE_ADD_DELIVERY_ADDRESS => Activate old feature to input delivery addresses on proposals. You should not use this feature and use instead the tab "proposal contacts" to associate delivery addresses to a proposal.
+
The last step is to create users and assign permissions. Almost all the modules even activated earlier, are not accessible if you do not give permissions. To do this, you can go to the menu '''Home -> Users & Groups''' to define users and their rights. Attention, you should consider to check and reset the user rights when you enable a new module. The list of rights available depends on the activated modules (see above). It is recommended to configure permissions after activating the modules you want to use. For certain actions, if you do not have the rights to do an action, Dolibarr will not show you the action. You might miss some useful or important features. '''To give rights to a user or yourself, if you are an administrator, go to Home -> Users & Groups, select the desired user, then click on its 'Permission' tab.'''
−
* 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.
 
  
−
== Invoice module ==
+
You can avoid these configuration steps for each newly created user, by configuring the default rights (understand rights allocated automatically each time a new user created) by configuring the default permissions on the menu [[Setup Security]].
−
{{ToTranslate}}
 
−
* FACTURE_VENTILATION => Active une veille fonctionnalité de ventilation comptable. Fonction instable.
 
−
* FACTURE_SHOW_SEND_REMINDER => Affiche le lien "Envoyer rappel par mail", fonction avec même finalité que le lien "Envoyer par mail" (vieille fonction obsolète).
 
−
* FACTURE_USE_PROFORMAT => Ajoute le type proformat dans les types de facture. Attention, ce type de facture n'a aucune valeur comptable.
 
  
−
== Order module ==
+
=Related videos=
−
{{ToTranslate}}
+
Basic setup :
−
* COMMANDE_ADD_DELIVERY_ADDRESS => Activate old feature to input delivery addresses on orders or shippings. You should not use this feature and use instead the tab "proposal contacts" to associate delivery addresses to a an order or a shipping.
+
(vocal in french but subtitles are available and review in this language)
−
* 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".
 
−
* COMMANDE_ADD_DELIVERY_COST_LINE => Add a line with weight if weight is known for product and trigger FraisPort activated.
 
  
−
== Contract module ==
+
<youtube width="200" height="120">S5Rm9ixHNRA</youtube>
−
* CONTRAT_NOEDITWHENVALIDATED => Make impossible to edit a contract once it was validated.
 
  
−
== Export module ==
+
Configuration options :
−
* 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=;
+
(vocal in french but subtitles are available and review in this language)
−
* 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 ==
+
<youtube width="200" height="120">o5VOYomd_Ns</youtube>
−
* 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.
 
  
−
== Product module ==
+
Visual setup : Darkmode :
−
* PRODUCT_ADD_TYPE_IN_DOCUMENTS => Add text "Product" or "Service" at beginning of details lines on built PDF documents.
+
(vocal in french but subtitles are available and review in this language)
−
* PRODUCT_SHOW_WHEN_CREATE => Old option no more supported (create problems) to be able to add lines of product during first step of entities creation.
 
  
−
== Foundation module ==
+
<youtube width="200" height="120">cdhWVmTg54U</youtube>
−
* MEMBER_URL_REDIRECT_SUBSCRIPTION => Link called and shown when a member account is autocreated in member module by a guest user.
 

Latest revision as of 17:01, 11 October 2024

Return to user
documentation index
File Doc user.png

After completing the initial installation, you must configure parameters in Dolibarr to match your needs.

Company/Organization

The first mandatory step is to define your company/organization information. For this, from home page, choose menu "Home->Setup->Company/Organization" and add the information for your company/organization.

  • Name: Name of your company/organization
  • Logo size.jpg
    Logo: Add here a logo of your company (.png, .jpg or .gif). It can accept any size but it is recommended to use a logo with 130 pixels height and up to 800 pixels width. Here is a little scheme on what will be the result on the PDF. The recommended format is png.
  • Logo (squared): Add here your squared logo (.png or .jpg) that will be used in the top right corner of the application
  • Fiscal Year: Define your starting month of yiscal Year
  • Country: Define your country: other options depend on this selection.
  • Prof ID X: The fields Prof ID are used to store the professional IDs of a company. Each country requires its own professional ID. For example, for a company in France you may find a SIRET, SIREN, NAF, RCS and EORI number, and for a company in Argentia, you will find CUIT/CUIL, Ingresos Brutos, CIF Intra. Dolibarr is able to manage 6 Professional ID. The label of each of them is defined with the translation key ProfIdXCC (where X is 1 to 6 and XX the country code of the company, for example XX=FR). To add a new Professional ID, you can add a new translation from menu Home - Setup - Translation for the key ProfIdXCC. If you set the value of translation to "-", it means that the professional ID is hidden when using the application in the language of translation on every company that has the country code XX.
  • Sales Tax (VAT) Management: Define how you manage Sales Tax (or not).
  • Second type of tax: Define if you would like to use second type of taxe (or not).
  • Third type of tax: Define if you would like to use third type of taxe (or not).

Modules

List of modules
List of modules

The activation of modules is the second mandatory step. Which modules you will activate depends on what you want to do with Dolibarr. In most cases, you may want to use all modules. You have to activate each module one by one. For example, to manage a company, you might activate at least modules Third party, Invoices, and Products, but probably many more.

To activate a module, go to page "Home->Setup->Modules" and click the button 'on/off' in the "Status" column to enable it.

  • The module is on if the 'on/off' button is like 'on/off' button in on position
  • The module is off if the 'on/off' button is like 'on/off' button in off position

The list of standard modules is defined on page List of Modules.

If you are unsure of the function of a module, you may activate it and see what new menu item appears in Dolibarr (the horizontal bar), also after activating a module, check that you grant to yourself permissions on new features that were enabled. You can activate or deactivate a module when you want.

Once a module has been activated, it may need further configuration (click on the setup icon that appears on the right of module line if a module needs its own setup). See documentation of module for more information.


Related videos:

Modules: (vocal in french but subtitles are available and review in this language)

Module settings: (vocal in french but subtitles are available and review in this language)

Display

Display settings
Display settings

On this page, you can set the default language of application and the look and feel of screens. In a first use, you can keep everything with default values.

Language

In the language settings, you can set the Default Language. By default it is set to "Auto Detect" so the language will be set automatically to the one of the user (so the language of the web browser).

Note: Activating multilanguage option will allow you to be able to set the preferred language of customers, to print their Invoice/Proposal/Order in their own language. Product translations will also be available.

Skin and colors

In Dolibarr you have two different pre-defined skins :

  • eldy Eldy Theme thumb.png
  • md Md theme thumb.png

More skins can be downloaded on the dolistore [1]

You can also personalize the skin color, and look in this setup.

Tip: To test the dark mode on a specific page without going on this page to switch the dark mode option, you can add the parameter &THEME_DARKMODEENABLED=2 to force the dark mode or &THEME_DARKMODEENABLED=0 to force the dark mode off.

Miscellaneous

On this section, you have all the default values of features like, javascript functions, length of lists, first day of the week, etc.
You can also put a "Message of day" that will be displayed for all the users. In this message, you can use the Variable substitution system

Login page

On this section, you can customize the login page with a message and a background image. In this message, you can use the Variable substitution system
It is also possible to hide/show the "Need help or support" link on login page

Menus

Menu Setup
Menu Setup

Choose here which menu manager you want to use for internal and external users and for computer or smartphone. The menu manager changes the labels, orders and organization of the left and top menus. See page Menus system for more information.

Menu handlers

The software comes with two different menu handler :

  • Eldy : It is the default menu, the menu entries are centralized and hard coded. You can add entries on this menu but not change the default menu entries.
  • Auguria : It is a database menu manager. This menu can be fully customized to your needs.

In the Menu handlers tab, you can choose the menu for internal and external users and for computer or smartphone.

Menu Editor

In this tab, you can customize each menu entry of auguria menu or the additional entries of eldy menu and create new entries

Miscellaneous

In this tab, you can choose the behavior of the unauthorized menu entry. By default, the unauthorized menu entry are in gray, but can be hidden.

Other (Widgets, Alerts, Security, Limits and accuracy, Emails, SMS, Dictionary setup...)

Other entries in Setup menu are advanced options. You can ignore them if you want.

Users

The last step is to create users and assign permissions. Almost all the modules even activated earlier, are not accessible if you do not give permissions. To do this, you can go to the menu Home -> Users & Groups to define users and their rights. Attention, you should consider to check and reset the user rights when you enable a new module. The list of rights available depends on the activated modules (see above). It is recommended to configure permissions after activating the modules you want to use. For certain actions, if you do not have the rights to do an action, Dolibarr will not show you the action. You might miss some useful or important features. To give rights to a user or yourself, if you are an administrator, go to Home -> Users & Groups, select the desired user, then click on its 'Permission' tab.

You can avoid these configuration steps for each newly created user, by configuring the default rights (understand rights allocated automatically each time a new user created) by configuring the default permissions on the menu Setup Security.

Related videos

Basic setup : (vocal in french but subtitles are available and review in this language)

Configuration options : (vocal in french but subtitles are available and review in this language)

Visual setup : Darkmode : (vocal in french but subtitles are available and review in this language)

Retrieved from "https://wiki.dolibarr.org/index.php?title=First_setup&oldid=61651"