Dolibarr ERP CRM Wiki - User contributions [en]

User:Jtraulle/DiscourseMigration

2026-10-04T12:13:52Z

Jtraulle: /* Restaure Discourse backup from command line */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<syntaxhighlight lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</syntaxhighlight>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<syntaxhighlight lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</syntaxhighlight>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<syntaxhighlight lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</syntaxhighlight>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restore Discourse backup from command line====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

Note : to restore a save from a multisite install that is not the main (first) database, prepend the command by <code>RAILS_DB=dolibarrde</code> where <code>dolibarrde</code> is the name of the database :

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'RAILS_DB=dolibarrde bundle exec ruby script/discourse restore dolibarr-germany-forum-2020-08-16-163120-v20200814081437.sql.gz'
</syntaxhighlight>

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>/var/discourse/containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher rebuild data
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher enter data
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

Draft:Discourse Implementation and Exploitation

2026-10-04T11:58:17Z

Jtraulle:

=== Apache2 config ===

Forums are available on entry URL: https://www.dolibarr.org/forum, https://www.dolibarr.fr/forum, https://www.dolibarr.de/forum
but behind, it is discourse.

Enable '''proxy '''and '''proxy_http '''modules.

Add

<syntaxhighlight lang="apache">
# To allow the rewrite on rss that is not a redirect from browser
SSLProxyEngine on
SSLProxyVerify none
SSLProxyCheckPeerCN off
SSLProxyCheckPeerExpire off

# Redirection pour compatibilite avec ancien forum kunena
RewriteRule ^/forum/user/(\d+)-(.*) /forum/u/$2/summary [L,R=permanent]
RewriteRule ^/forumold/.*/(\d+)-(.*)$ /forum/t/$2 [L,R=permanent]

# Redirection pour transfert apache - discourse
<Location "/forum">
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}
ProxyPreserveHost On
ProxyPass "http://127.0.0.1:8800/forum" connectiontimeout=60 timeout=60
ProxyPassReverse "http://127.0.0.1:8800/forum"
</Location>

</syntaxhighlight>

The apache proxy redirect HTTP including /forum/ in URL to the port the docker nginx server run.

The Logs of the proxy are available into /home/dolibarr/logs/dolibarr_ssl_access_log file and are used by fail2ban rules.

== Firewall ==
Les regles du firewall sont définies et activé par le script /home/dolibarr/tools/firewallvmprod1

TODO Utiliser ufw

=== Backup ===

Backup of discourse instance is done into directories /mnt/sdb1/backup/discourses

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See
* https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install
* https://meta.discourse.org/t/postgresql-15-update/349515#p-1698209-data-container-install-3
* https://meta.discourse.org/t/postgresql-18-update-for-self-hosters/406194

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
# twice is not a typo but on purpose
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Draft:Discourse Implementation and Exploitation

2025-11-10T12:07:32Z

Jtraulle:

=== Apache2 config ===

Forums are available on entry URL: https://www.dolibarr.org/forum, https://www.dolibarr.fr/forum, https://www.dolibarr.de/forum
but behind, it is discourse.

Enable '''proxy '''and '''proxy_http '''modules.

Add

<syntaxhighlight lang="apache">
# To allow the rewrite on rss that is not a redirect from browser
SSLProxyEngine on
SSLProxyVerify none
SSLProxyCheckPeerCN off
SSLProxyCheckPeerExpire off

# Redirection pour compatibilite avec ancien forum kunena
RewriteRule ^/forum/user/(\d+)-(.*) /forum/u/$2/summary [L,R=permanent]
RewriteRule ^/forumold/.*/(\d+)-(.*)$ /forum/t/$2 [L,R=permanent]

# Redirection pour transfert apache - discourse
<Location "/forum">
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}
ProxyPreserveHost On
ProxyPass "http://127.0.0.1:8800/forum" connectiontimeout=60 timeout=60
ProxyPassReverse "http://127.0.0.1:8800/forum"
</Location>

</syntaxhighlight>

The apache proxy redirect HTTP including /forum/ in URL to the port the docker nginx server run.

The Logs of the proxy are available into /home/dolibarr/logs/dolibarr_ssl_access_log file and are used by fail2ban rules.

== Firewall ==
Les regles du firewall sont définies et activé par le script /home/dolibarr/tools/firewallvmprod1

TODO Utiliser ufw

=== Backup ===

Backup of discourse instance is done into directories /mnt/sdb1/backup/discourses

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See
* https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install
* https://meta.discourse.org/t/postgresql-15-update/349515#p-1698209-data-container-install-3

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
# twice is not a typo but on purpose
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Draft:Discourse Implementation and Exploitation

2025-01-24T12:47:10Z

Jtraulle: /* Upgrade the data container */

=== Apache2 config ===

Forums are available on entry URL: https://www.dolibarr.org/forum, https://www.dolibarr.fr/forum, https://www.dolibarr.de/forum
but behind, it is discourse.

Enable '''proxy '''and '''proxy_http '''modules.

Add

<syntaxhighlight lang="apache">
# To allow the rewrite on rss that is not a redirect from browser
SSLProxyEngine on
SSLProxyVerify none
SSLProxyCheckPeerCN off
SSLProxyCheckPeerExpire off

# Redirection pour compatibilite avec ancien forum kunena
RewriteRule ^/forum/user/(\d+)-(.*) /forum/u/$2/summary [L,R=permanent]
RewriteRule ^/forumold/.*/(\d+)-(.*)$ /forum/t/$2 [L,R=permanent]

# Redirection pour transfert apache - discourse
<Location "/forum">
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}
ProxyPreserveHost On
ProxyPass "http://127.0.0.1:8800/forum" connectiontimeout=60 timeout=60
ProxyPassReverse "http://127.0.0.1:8800/forum"
</Location>

</syntaxhighlight>

The apache proxy redirect HTTP including /forum/ in URL to the port the docker nginx server run.

The Logs of the proxy are available into /home/dolibarr/logs/dolibarr_ssl_access_log file and are used by fail2ban rules.

== Firewall ==
Les regles du firewall sont définies et activé par le script /home/dolibarr/tools/firewallvmprod1

TODO Utiliser ufw

=== Backup ===

Backup of discourse instance is done into directories /mnt/sdb1/backup/discourses

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
# twice is not a typo but on purpose
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Installation manuelle sous Windows

2025-01-03T17:22:15Z

Jtraulle: /* Interpréter les fichiers *.php */ Correction coquille

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour d'autres versions de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>8.2.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x64-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x86-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>, <code>;extension=imap</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php_module "c:/php/php8apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php8_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt71.dll</code>, <code>icuin71.dll</code>, <code>icuio71.dll</code>, <code>icuuc71.dll</code>, <code>libcrypto-3-x64.dll</code>, <code>libssl-3-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Installation manuelle sous Windows

2025-01-03T09:16:36Z

Jtraulle: Modification du nom des fichiers d'extensions suite à mise à jour vers PHP 8.2 de la page.

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour d'autres versions de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>8.2.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x64-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x86-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>, <code>;extension=imap</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php8_module "c:/php/php8apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php8_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt71.dll</code>, <code>icuin71.dll</code>, <code>icuio71.dll</code>, <code>icuuc71.dll</code>, <code>libcrypto-3-x64.dll</code>, <code>libssl-3-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Installation manuelle sous Windows

2025-01-03T09:12:52Z

Jtraulle: Recommandation de l'utilisation de PHP 8.x

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour d'autres versions de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>8.2.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x64-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-8.2-Win32-vs16-x86-latest.zip dernière version de PHP 8.2.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>, <code>;extension=imap</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php8_module "c:/php/php8apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php8_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Installation manuelle sous Windows

2023-07-10T11:32:36Z

Jtraulle:

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour d'autres versions de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>7.4.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x64-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x86-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

List of modules id

2023-03-27T13:37:02Z

Jtraulle:

{{TemplateDocDevEn}}
{{TemplateDocDevEs}}
{{TemplateDocDevFr}}

{{Flag en}}
This page list all reserved modules numbers / ID. If you build or want to build your own modules (like this [[:Category:Complementary_modules|complementary module]]), you should take an ID range here. Please pick range into existing holes first.

{{Flag fr}}
Cette page recense tous les numéros / ID réservés de modules. Si vous avez réalisé ou voulez réaliser vos propres modules (comme les [[:Category:Modules complémentaires|modules complémentaires suivant]]), vous devriez prendre une plage d'ID ici. Merci de prendre dans les trous existant en priorité !

{{Flag sp}}
Esta página contiene un listado de todos los id reservados para los módulos. Si ha creado o quiere realizar sus propios módulos, (como estos [[:Category:Módulos_complementarios|módulos complementarios]]), deberá reservarse un rango de ID aquí.

=ID 0 - 99999=
{{Flag en}}
Reserved for Dolibarr's internal modules.

{{Flag fr}}
Réservé aux modules internes de Dolibarr.

{{Flag sp}}
Reservado a los módulos internos de Dolibarr.

=ID 100000 - 499999=
{{Flag en}}
'''Reserved area for editors in need for an ID range. You can edit this page to add your own range (take a range of 50 numbers only the first time, ask us for more)'''

{{Flag fr}}Zone réservée aux éditeurs qui ont besoin d'une plage d'ID spécifiques. Vous pouvez modifier cette page pour réserver votre plage (limitée à 50 valeurs la première fois, demandez nous pour plus)

{{Flag sp}}
Área reservada para los partners que necesiten un rango de ID. Puede modificar esta página para reservar su rango (limitado a 50 valores por editor)

[[File:Warning.png]] If you reserve more than 50, we may automatically change your reservation range without information and you may experience conflicts with other modules in a future, so please follow the rules !

*ID 100000 - 100999: OpenThink (http://www.openthink.be)
*ID 101000 - 101999: NLTechno (https://www.nltechno.com)
*ID 102000 - 102999: Tiaris (http://www.tiaris.fr)
*ID 103000 - 103999: Open-concept.pro (http://www.open-concept.pro)
*ID 104000 - 104999: ATM Consulting (http://www.atm-consulting.fr)
*ID 105000 - 105999: GPC.solutions
*ID 106000 - 106999: PHPASSO
*ID 107000 - 107999: TecLib (http://www.teclib.com) / Auguria (http://www.auguria.net)
*ID 108000 - 108999: ETHICWEB
*ID 109000 - 109999: Aplose ([http://www.aplose.fr https://www.aplose.fr])
*ID 110000 - 110999: Librethic (https://librethic.io)
*ID 111000 - 111999: Asset IT (www.assetit.ch)
*ID 112000 - 112999: Aarboard AG (www.aarboard.ch)
*ID 113000 - 113999: Asilib - Alexandre Spangaro
*ID 114000 - 114999: Iceleaf OÜ
*ID 115000 - 115999: 2A2C Conseil - Cyril ZEKSER
*ID 116000 - 116999: Wolftec GmbH
*ID 117000 - 117999: Oscim (http://www.oscim.fr)
*ID 118000 - 118999: Oarces Web (dev.oarces.com)
*ID 119000 - 119999: Manuel Berrocal - Absolacom
*ID 120000 - 120999: Régis Houssin (http://www.inodbox.com)
*ID 121000 - 121999: Oscss - Shop
*ID 122000 - 122999: MrSof - la Nation du Web
*ID 123000 - 123999: Bruno Généré (webiseasy.org)
*ID 124000 - 124999: backbone internet service (www.backbone.co.at)
*ID 125000 - 125999: ProgSI (www.progsi.ma)
*ID 126000 - 126999: Catalanet
*ID 127000 - 127999: Virgilio Filho pt-BR Brasil (@dolibarr.br)
*ID 128000 - 128999: Nicolas Frappé France (www.sospc.info)
*ID 129000 - 129999: Adeo-Informatique
*ID 130000 - 130999: Technicks ICT (http://www.technicks.eu)
*ID 131000 - 131999: Joan Louis (itaca.fr)
*ID 132000 - 132999: Jean-Marie Arsac (https://azimut.fr)
*ID 133000 - 133999: Oriel Systems Ltd, UK. (www.orielsystems.com)
*ID 134000 - 134999: ALSOFT PVT. LTD. (https://www.alsoft.org)
*ID 135000 - 135999: Net-Logic (https://netlogic.fr)
*ID 140000 - 140999: Altairis (http://altairis.fr)
*ID 141000 - 141050: Projet2Team (https://www.projet2team.fr)
*ID 141051 - 141099: Elistair (http://elistair.com)
*ID 141100 - 141149: Blue Networks Technologies (https://www.blnt.fr)
*ID 141150 - 141199: Florian DUFOURG - France
*ID 142000 - 142049: ITANéA (https://www.itanea.fr)
*ID 142050 - 142099: ERP Consulting NZ ([https://www.erpconsulting.co.nz www.erpconsulting.co.nz])
*ID 142100 - 142149: Bloxera GmbH (https://www.bloxera.com)
*ID 142150 - 142199: Evangelos Souglakos - Greece
*ID 142200 - 142249: Luc CALARESU - France
*ID 142250 - 142299: OmnIT Services - Belgique (https://www.omnitservices.biz)
*ID 150000 - 150999: Jeffinfo
*ID 151000 - 151999: Konverseo (https://konverseo.com)
*ID 160000 - 160999: Charles-François BENKE (http://www.patas-monkey.com)
*ID 161000 - 161999: Abbes Bahfir (http://dolipar.org)
*ID 162000 - 162999: Jacques Rébiscoul
*ID 163000 - 163999: Open-DSI (https://www.open-dsi.fr)
*ID 164000 - 164999: Pixelada S. Coop. And. (https://pixelada.org)
*ID 165000 - 165049: DovConnect
*ID 165050 - 165099: Mind Operated Systems (https://www.mosystems.biz)
*ID 165100 - 165150: SD-Formation (https://sdformation.fr)
*ID 165151 - 165199: NUM'X (https://www.numx-sets.eu)
*ID 165200 - 165249: Benjam Préjent (https://www.benjam-prejent.fr)
*ID 165250 - 165299: Dhi Loka Private Limited, India (https://www.dhiloka.com)
*ID 170000 - 170999: TRIDENT CONSULTING LTD (www.tridentdxb.com)
*ID 171000 - 171999: LVSInformatique (www.lvsinformatique.com)
*ID 172000 - 172299: Ray Soft-Systems (https://www.ray-soft-systems.com)
*ID 172300 - 172349: Günter Lukas Consulting (https://gl.co.at)
*ID 172350 - 172399: MB Informatique (https://www.mb-informatique.fr)
*ID 172400 - 172449: Professional Structures Limited (https://pstructures.com)
*ID 172450 - 172699: IT-BS (https://www.it-bs.fr)
*ID 172700 - 172749: Indelog (https://www.indelog.fr)
*ID 172750 - 172799: NS-INFO90 (https://www.ns-info90.fr)
*ID 180000 - 180999: Triangle Ingénierie
*ID 181000 - 181999: TI Sin Problemas (https://www.tisinproblemas.com)
*ID 182000 - 182049: Chipserv Pawel Wlizlo (https://www.testware.it)
*ID 183000 - 183999: BB2A Anthony Berton (https://www.bb2a.fr)
*ID 190000 - 190999: Diciannove (http://19.coop)
*ID 191000 - 191999: Elonet (https://elonet.fr)
*ID 199000 - 199999: RFMS
*ID 200000 - 200999: Noxiome
*ID 201000 - 201999: Sasa Ostrouska (saxa)
*ID 202000 - 202999: Z-Application
*ID 203000 - 203099: Elidee - elidee.com
*ID 203100 - 203999: Garcia MICHEL (soamichel.fr)
*ID 204000 - 204999: Ari Elbaz elarifr - accedinfo.com
*ID 205000 - 205999: Kreiz IT
*ID 206000 - 206999: GBINFO (www.gbinfo.fr)
*ID 207000 - 207099: MacroProg (https://www.macroprog.com)
*ID 207100 - 207149: Reactiva Software
*ID 207150 - 207199: Ndejje University Water Research and Development Centre ([https://github.com/NDUWRDC/LIMS/])
*ID 207200 - 207299: Massaoud Bouzenad ([https://www.dzprod.net dzprod.net])
*ID 207300 - 207349: Ksar
*ID 207350 - 207399: Easylinux (www.easylinux.fr)
*ID 222000 - 222999: dolibit (https://www.dolibit.de)
*ID 230000 - 230049: Unareil (https://www.unareil.eu)
*ID 230050 - 230099: Lyra Network (https://www.lyra.com/)
*ID 230100 - 230149: Gheorghe Iftimi - CTW - RO
*ID 230150 - 230199: MEMA Machinery & Tools (https://www.mema.be)
*ID 230200 - 230249: Teleassist
*ID 230250 - 230299: Nh Developer
*ID 230300 - 230499: Chickenforce/code-chicken, IT Services Hahn (https://github.com/code-chicken [http://itservices-hahn.de/ https://itservices-hahn.de])
*ID 230500 - 230549: Hidup Consulting (https://consulting.hidup.io)
*ID 230550 - 230599 : CMR Conseil (https://www.weblockup.fr)
*ID 230600 - 230649 : aFreeMind Studio
*ID 230650 - 230699 : Unideal (https://www.uni-deal.com)
*ID 262700 - 262799: Scopen (https://www.scopen.fr)
*ID 274250 - 274299: Nerv Project (www.nerv-project.eu)
*ID 274300 - 274349: Knowhere Consulting S.L. (https://www.knowhere-consulting.eu)
*ID 274350 - 274399: Milen karaganski (https://blacktiehost.com)
*ID 274400 - 274449: Vincent MAURY ([https://www.timgroup.fr www.timgroup.fr])
*ID 274450 - 274499: Daraelmin
*ID 274500 - 274550: Emilie LAFORET (http://www.ermvallon.com)
*ID 280000 - 280050: Bingroup (https://www.beinng.com)
*ID 290000 - 290099: BNS - Project doliBRA ([https://www.beinng.com https://www.bns.net.br]) - Brasil
*ID 300000 - 300049: RapidProgress (https://www.rapidprogress.eu) - Bulgaria
*ID 300050 : 300099: M@ Solution (https://www.ma-solution.fr/)
*ID 300100 : 300149: LAVA RUN (https://www.lavarun.re)
*ID 300200 : 300249 : Computences (https://www.computences.com/)
*ID 300250 : 300299 : LEVEL IT (https://levelit.com.ar)
*ID 300300 : 300349 : Progiseize (https://progiseize.fr)
*ID 300350 - 300399: MB Informatique (https://www.mb-informatique.fr)
*ID 300400 - 300449: Anouar Touati
*ID 300450 - 300499: Martin Danger
*ID 300500 - 301499: Whale Blows
*ID 301500 - 301549: Tom Trust - International
*ID 302500 - 302549: Diamubi (https://diamubi.com)
*ID 302550 - 302599: Datolab (https://www.datolab.com)
*ID 302600 - 302649: DuMaCo (https://www.dumaco.de)
*ID 302650 - 302699: Resilio SA
*ID 302700 - 302749: Aroga
*ID 302750 - 302799: Productivix (https://www.productivix.com)
*ID 302800 - 302849: Slibzz
*ID 302850 - 302899: idea design (https://ideadesign.dz)
*ID 302900 - 302949: AL MISBAH INFORMATIQUE (https://www.almisbah.ma)
*ID 302950 - 302999: Atis Solutions - France
*ID 303000 - 303499: Obixav - Nigeria
*ID 303500 - 303550: buschler plus GmbH, Germany (https://buschler.plus)
*ID 303551 - 303599: Prestalidaire - France (https://prestalidaire.com)
*ID 314000 - 314049: Ruemmler IT Solutions (https://www.ruemmler.net)
*ID 320000 - 320999: Novus Studios (www.novusstudios.it)
*ID 321000 - 321999: AtooNet (http://www.atoo-net.com)
*ID 332000 - 332099: Gecka (https://gecka.nc)
*ID 332100 - 332149: Agence Milkshake (http://agencemilkshake.com)
*ID 332150 - 332199: Daniel Prowald IT – Service (https://prowald-it.de)
*ID 332200 - 332249: UNITICE (https://unitice.com)
*ID 332250 - 332299: Sidonie Moulart
*ID 332300 - 332349: LTDJ (Antonin MARCHAL - Le Temple du Jeu)
*ID 330000 - 330049: XTEC Industries (www.xtec-ind.com)
*ID 330050 - 330099: 10100 S.R.L. - (www.10100.to)
*ID 330100 - 330149: AES Dana SRL (https://aes-dana.be)
*ID 330150 - 330199: Freshcore (https://www.freshcore.fr)
*ID 330200 - 399999: (take ranges of 50 only please, ask us for more)
*ID 333300 - 333349: Sense Africa (http://sense.africa)
*ID 400000 - 400999: 2byte.es (http://www.2byte.es)
*ID 401000 - 401999: B&D Informática
*ID 402000 - 402999: Marcos García de La Fuente (marcosgdf)
*ID 403000 - 403999: Sergibyte
*ID 404000 - 404999: Aikhan
*ID 405000 - 405999: AIME (http://www.aime.mx)
*ID 406000 - 406999: Som Núvol (https://somnuvol.coop)
*ID 409000 - 409999: LliureTIC (https://www.lliuretic.cat)
*ID 410000 - 410999: DoliGov
*ID 420000 - 420099: BBS Concept
*ID 420100 - 420199: LeMousticProduction (www.lemousticproduction.info) -< module DoliRH
*ID 420200 - 421199: VatCheck (www.abnc.be)
*ID 422200 - 422999: Artaban (http://artaban.fr)
*ID 423000 - 423050: cyberesprit
*ID 423051 - 423099: R.Bossard
*ID 423100 - 423199: Joliciel (www.joliciel.fr)
*ID 424000 - 424049: A3sys - Mon-Dolibarr (http://www.mon-dolibarr.fr) by Philazerty
*ID 424050 - 424099: Pragma-tech (www.pragma-tech.fr)
*ID 424100 - 424149: Ohoo Solutions (http://www.ohoosolutions.com)
*ID 424150 - 424199: DAGARCAM Informática (https://www.dagarcam.com/)
*ID 424200 - 424999: Lab51 (https://github.com/lab51org)
*ID 425000 - 425999: Sébastien SERRE Thivinfo (www.thivinfo.com)
*ID 426000 - 426099: Arkesis-Solution
*ID 426100 - 426149: GetLandy (www.getlandy.com)
*ID 426150 - 426649: OOB Software
*ID 426650 - 426849: Soft-Task Serviços e Sistemas (www.soft-task.com.br)
*ID 426850 - 427000: Bruno Caldas (https://github.com/BCaldas)
*ID 427001 - 427999: Kevin GUERRIER (alias xcl.saian)
*ID 428000 - 428099: af83
*ID 428100 - 428199: Arnaud Serrut - Adalon
*ID 428200 - 428249: imschweiler consulting (http://www.imschweiler-consulting.de'''<nowiki/>''')
*ID 428250 - 428299: AL1FO
*ID 428300 - 428349: Federico García-Patiño Barbolani (<federico.garcia.patino@gmail.com>)
*ID 428350 - 428399: INTM Groupe - France (www.intm.com)
*ID 428400 - 428449: Nick Fragoulis - Greece
*ID 428450 - 428499: Letusgeek - France
*id 428500 - 428549 hkwhitten - USA
*ID 428550 - 428999 SmartOne
*ID 429000 - 429999: induslab
*ID 430000 - 430099: Mixity sprl (www.mixity.be)
*ID 430100 - 430199: sgiraud
*ID 430200 - 430299: Merlion TI (www.merlion-si.com.br)
*ID 430300 - 431299: Libre Expert (www.libre-expert.com)
*ID 431300 - 431399: ptibogxiv (www.ptibogxiv.net)
*ID 431400 - 431499: Befox (www.befox.fr)
*ID 431500 - 431599: rue Béjo (www.ruebejo.fr)
*ID 431600 - 431699: Avizzeo (www.avizzeo.com)
*ID 431700 - 432199: Multisistemas (www.multisistemas.com.sv)
*ID 432200 - 432399: Burbuja - Chile (www.burbuja.cl)
*ID 432400 - 433399: INOVEA CONSEIL (https://www.inovea-conseil.com)
*ID 433400 - 434399: Rachid HRICH - Maroc (HricH ServiceS.)
*ID 434400 - 435399: Lance Bleakley - LanceIT (www.lanceit.net)
*ID 436000 - 436099: SOWEBIO (www.soweb.io)
*ID 436100 - 436199: CAP-REL (www.cap-rel.fr)
*ID 436200 - 436300: TDE-INFORMATIQUE (www.tde-informatique.fr)
*ID 436301 - 436349: Evarisk ([https://www.evarisk.com/id-module-dolibarr/ www.evarisk.com])
*ID 436350 - 436399: Eoxia ([https://www.eoxia.com/dolibarr/modules/ www.eoxia.com])
*ID 436400 - 437399: Mohamed AHERDANE - Morocco - IT Consultant ( www.wave.ma )
*ID 437400 - 437449: Martin Neubauer - Germany
*ID 437450 - 437599: Club1click (www.club1click.es)
*ID 437600 - 437629: Coulon Vincent (https://github.com/HoverEpic)
*ID 437630 - 437649: Aytechnet (https://www.aytechnet.fr/) - François Pons
*ID 437650 - 437699: LibreMaster (https://libremaster.com) - Christophe T.
*ID 437700 - 437749: STELLAR Broadband (https://www.stellarbb.com) - U.S.A. - Philip Laycock
*ID 437750 - 437799: DIGITA.LU Ajous Solutions
*ID 437800 - 437850: iProspective (https://iprospective.fr) - Mathieu Moulin
*ID 437851 - 437900: Theobald Groupe.
*ID 437901 - 437950: Neuronnexion (http://neuronnexion.coop)
*ID 437951 - 438399: '''Free (take ranges of 50 only please at once, ask us for more)'''
*ID 438400 - 439399: Tetras Libre - France - Développement logiciels libres (www.tetras-libre.fr)
*ID 439400 - 440399: Dolibarr-pro - France - Développement Dolibarr (www.dolibarr-pro.com)
*ID 440400 - 441399: Quidlab Co., Ltd - Thailand - ( www.quidlab.com )
*ID 441400 - 442399: Ide@log - France - (https://www.idealog-info.net) - Laurent Leblanc
*ID 442400 - 443399: Valerio Bianchi (www.valeriobianchi.com)
*ID 443400 - 444399: delassalle - France - (www.delassalle.fr) - Joseph Delassalle
*ID 444400 - 445399: Webartis - Maroc - (www.webartis.net) - François Dry
*ID 445400 - 445499: SCOP Au-delà des nuages - France
*ID 446000 - 446999: iouston (http://www.iouston.com) - France - Julien Marchand
*ID 447000 - 447999: rSanjoSEO - Rafael San José Tovar (www.rsanjoseo.com) - Spain
*ID 448000 - 448999: Code 42 (www.code42.fr)
*ID 449000 - 449999: TakePOS (www.takepos.com)
*ID 450000 - 450999: Pierre ARDOIN
*ID 451000 - 451999: Éditeur depordi.fr
*ID 452000 - 452999: Dylan NAKONG
*ID 453000 - 453999: Menahd Ouchenir - France - menahd-ouchenir.com
*ID 454000 - 454999: Withheld - Canada
*ID 455000 - 455999: Gaëtan MAISON - Info Libre @ Dom - France (https://www.infolibreadom.com)
*ID 456000 - 456999: Laurent LEBLEU - B.L.C. - Blue Line Company - Lille - France (www.bluelinecompany.fr/dolibarr)
*ID 457000 - 457999: Sébastien BOUCHER
*ID 458000 - 458999: Lester HERNÁNDEZ - Argentina - (freelancerlrhd@gmail.com)
*ID 459000 - 459999: Infopen - France
*ID 460000 - 460050: torvista - Spain
*ID 461000 - 461999: MEGALOGI - Maroc (www.erpcloud.ma)
*ID 462000 - 462999: Making Digital (www.making-digital.fr) - France
*ID 463000 - 463999: linx s.r.l.s.
*ID 464000 - 464999: NimbleCubed Inc. (www.nimblecubed.com)
*ID 465000 - 465999: Artefacts - CourantAlternatif
*ID 466000 - 466999: CDM Consultores - (www.cdm.guru)
*ID 467000 - 467999: M71 Service GmbH - (www.m71-service.de)
*ID 468000 - 468049: Clément Segonzac - France (clement.segonzac@gmail.com)
*ID 468050 - 468099: Flavien Belli - France (https://github.com/Marshlyin || belliflaviencontactpro@gmail.com)
*ID 468100 - 468119: Chl (https://code.bugness.org/Dolibarr)
*ID 468120 - 468170: Commotron GmbH (https://www.commotron.com/)
*ID 468171 - 468174 '''Free (take ranges of 50 only please at once, ask us for more)'''
*ID 468175 - 468199: Gaëlle Rauffet - France (kiwiscan.net)
*ID 468200 - 468250: Paulo Oliveira - Brasil (paulorcdo@gmail.com)
*ID 468251 - 468270: CD-Systems - France (https://www.cd-systems.fr)
*ID 468300 - 468349: Uvensys - Germany (https://uvensys.de)
*ID 468350 - 468399 : Laudeco - Belgium (http://github.com/laudeco)
*ID 468400 - 468449 : Alexis LAURIER - France (https://www.alexislaurier.fr)
*ID 468450 - 468499 : Mehdi Belkhayat - Maroc (https://opensi.ma)
*ID 468500 - 468599 : InvIT GmbH - Germany (https://invit.sh)
*ID 468600 - 468649 : Ricardo Sequeira - Portugal (https://ricardo-sequeira.com)
*ID 468650 - 468699 : J-IT - Belgique (https://www.j-it.be)
*ID 468700 - 468749 : Fidesio - France (https://www.fidesio.com/)
*ID 468750 - 468799 : Sgestion - Spain (http://www.sgestion.net/)
*ID 468800 - 468849 : Denis JULIEN - Brasil (matrinxa@free.fr)
*ID 468850 - 468900: Mmariko - Module GED - Effios
*ID 468901 - 468950: Maazou Amadou Abdoul aziz - Maroc (yaronfada@gmail.com)
*ID 468951 - 469000: Alexis LAURIER - France (https://www.alexislaurier.fr)
*ID 469001 - 469050: John Livingston (https://github.com/JohnXLivingston/)
*ID 469051 - 469100: Macrorom ICT-services (https://macrorom.nl/)
*ID 469101 - 469150: HABOT IT - France (https://habot.it)
*ID 469151 - 469160: CaribbeanConsult.Com CCC - France Guadeloupe (https://dolibarr.ccc.gp)
*ID 469161 - 469171: GMBG - Portugal
*ID 469949 - 469999: Goldoweb (http://goldoweb.com)
*ID 470000 - 470999: Reindeer Digital (https://rdeer.cz)
*ID 471000 - 471099: CAP-REL (www.cap-rel.fr)
*ID 471100 - 471199: M. Morillon
*ID 481000 - 482000: Alhaidab-ITIS (https://alhaidab.dolibarr.sd)
*ID 482001 - 483000: Basix IT (https://www.basix.de)
*ID 483001 - 483050: SASCO SpA (https://www.sasco.cl)
*ID 483051 - 483100: WIP Engineering (https://www.wip-gmbh.com)
*ID 483101 - 483150: J.Kaiser
*ID 483151 - 483201: CodLines (https://www.codlines.com)
*ID 485000 - 485049: Gest Info Service Plus (contact@gest-plus.fr)
*ID 490000 - 490050: VOLD (https://vold.lu)
*ID 491000 - 491050: NORD ERP CRM (https://www.nord-erp-crm.fr/)
*ID 491051 - 491100: KJR-online (https://kjr-online.fr/)

DO NOT ADD RECORD HERE, PLEASE FILL HOLES FIRST !!!!
...

=ID > 500000=

This range can't be reserved. It is a common range. If you don't plan to distribute your module, you can use an ID in this range with no need to reserve it.

{{Flag en}}
If you don't already have reserved ids and need some, please don't use hazardous number and use a number higher than 500000, but it is better to ask a wiki account, and reserve your own range by editing the 100000 - 499999 range (50 ids at once, 1000 ids maximum per partner).

{{Flag fr}}
Si vous n'avez pas de numéros réservés et en avez besoin, n'utilisez pas de chiffres au hasard et utilisez une valeur supérieure à 500000, toutefois, il est préférable d'obtenir un compte wiki, et réserver vous-même votre plage en ajoutant votre entrée dans la zone 100000 - 499999 (par lot de 50 d'abord, pas plus de 1000 numéros par partenaire).

{{Flag sp}}
Si no dispone de número reservado y necesita, no use cifras redondeadas y usa un valor superior a 500000. Si tiene una cuenta wiki, puede reservarse usted mismo sus id añadiendo su entrada en la zona 100000 - 499999 (no más de 1000 id por partner).

Système de Hooks

2022-09-15T13:58:20Z

Jtraulle: /* Liste des Hooks disponibles dans Dolibarr */

{{TemplateDocDevFr}}

=Introduction=
Les Hooks sont une fonctionnalité, pour les développeurs, leur permettant d'ajouter du code personnalisé aux pages standards de Dolibarr sans avoir à modifier les fichiers du coeur de Dolibarr. Contrairement au [[Système de Triggers]] (autre manière d'interagir avec le code de Dolibarr) qui sont liés aux événements de Dolibarr, les Hooks peuvent s'exécuter n'importe ou et à n'importe quel moment dès lors qu'ils ont été prévu dans le core de Dolibarr. Ce sont des points d'insertion dans le programme.

*Les Hooks sont actifs ou pas selon un contexte (souvent un contexte par module : par exemple "productcard" pour les produits, "invoicecard" pour les factures...). Pour trouver les Hooks existants faites une recherche pour "'''initHooks('''"
*Les Hooks sont des fonctions qui s'insèrent dans ou remplacent le code standard. Pour rechercher le code qu'il est possible de surcharger faites une recherche pour "'''executeHooks('''".

=Ajouter un hook pour permettre l'insertion de code=
Pour implémenter un hook dans votre propre module (afin que votre module puisse être "hooké" par d'autres), vous devrez procéder à 2 étapes.

Ces étapes doivent êtres reproduites pour chaque script php de votre module où vous voulez implémenter des hooks.

1- Initialiser l'object HookManager (placez ce bout de code au début de votre script php, juste après ou avant les includes):

<source lang="php">
// Initialize technical object to manage hooks of thirdparties. Note that conf->hooks_modules contains array array
include_once(DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php');
$hookmanager=new HookManager($db);
$hookmanager->initHooks(array('context'));
</source>

$hookmanager->initHooks() accepte 1 paramètre (un array de contextes) et active la prise en charge des hooks pour ce script:

- '<nowiki/>'''context'''' est la chaine qui contient le contexte d'exécution. C'est un simple indicateur qui peut être utilisé par les fonctions de hook pour détecter dans quel cas elles sont appelées (plusieurs pages/modules peuvent appeler le même hook à différent endroit, et une fonction de hook peut ne vouloir s'exécuter que pour un contexte donné et pas les autres).

Note: Vous pouvez positionner plusieurs contextes en même temps (par exemple si vous avez besoin d'avoir un context commun à plusieurs pages mais que vous voulez aussi un context propre à une page donnée).

2- Placer ensuite l'appel des hooks la où permettre l'ajout de code:

<source lang="php">
$parameters=array();
$reshook=$hookmanager->executeHooks('hookname',$parameters,$object,$action); // See description below
// Note that $action and $object may have been modified by hook
if (empty($reshook))
{
... // standard code that can be disabled/replaced by hook if return code > 0.
}
</source>

'''$hookmanager->executeHooks()''' accepte 4 paramètres et ajoute un hook (qui est un point d'entrée dans votre script pour des fonctions externes à votre script et module):

- '<nowiki/>'''hookname'''' est le nom de la méthode qui sera appelée. Par exemple: 'formObjectOptions'

- '''$parameters''' est un tableau personnalisé pour transmettre plus de données personnalisées au hook (la fonction dans le hook peut traiter ces données). Placez ici ce que vous voulez, ce peut être un fichier, un tableau de chaînes de caractères, n'importe quoi... Par exemple :
<source lang="php">
$parameters=array('file'=>'my/path/to/a/file', 'customnames'=>array('henry','david','john'));
</source>

- '''$object''' est l'objet que vous voulez passer à la fonction du hook, certainement les données du module courant (ex: l'objet facture si on est dans un module de facture, etc..). Ce peut être ce que vous voulez, mais souvenez vous qu'il sera le principal composant utilisé par les fonctions du hook.

- '''$action''' est une chaîne indiquant l'action courante (peut être null ou quelque chose qui ressemble à 'create' ou 'edit').

Note: Vous devrez refaire cette étape plusieurs fois si vous voulez ajouter plusieurs hooks à différent endroits de votre script.

Maintenant votre module devrait pouvoir être hooké, vous pouvez suivre la procédure ci-dessous dans '''Implémenter un hook''' pour implémenter une fonction hook qui en prendra avantage (permet aussi de tester que cela fonctionne).

=Implémenter un Hook=
Pour utiliser un Hook (donc ajouter ou surcharger une partie de code), vous devez d'abord avoir défini un descripteur de module (voir [[Développement_module#Créer_un_descripteur_de_Module_(obligatoire)]] pour cela). Ensuite vous devez suivre les étapes suivantes :

1. Ajouter votre module au contexte où le hook doit s'exécuter.
Ce qui veut dire que lorsqu'on se trouve dans le contexte donné, votre code sera appelé.
Pour cela, éditer le descripteur de votre module ('''/htdocs/''yourmodulename''/core/modules/mod''YourModuleName''.class.php''') et renseignez la variable '''$this->module_parts''' comme sur l'exemple :
<source lang="php">
$this->module_parts = array(
'hooks' => array('hookcontext1','hookcontext2') // Set here all hooks context you want to support
);
</source>

Note: il est possible de trouver le contexte d'un module en rajoutant
<source lang="php">
print('Module context: '.$object->context);
</source>
(rajoutez ce bout de code dans le fichier php où réside l'appel des hooks, et supprimez le, une fois la valeur du context relevée).

[[File:warning.png]] Attention: N'oubliez pas de désactiver puis de réactiver votre module dans l'interface d'administration des modules afin que la modification soit prise en compte car la sauvegarde des couples "modules-hooks" qui doit être gérée est faite en base, laquelle n'est mise à jour qu'au moment de l'activation du module.

2. Pour remplacer une fonction existante par la votre (surcharge)

Créez '''/htdocs/''yourmodulename''/class/actions_''yourmodulename''.class.php''' dans votre module avec un code qui contient la méthode appelée par le hook (le nom de cette méthode se voit au moment de l'appel executeHooks). Voici un exemple:

<source lang="php">
class ActionsYourModuleName
{
/**
* Overloading the doActions function : replacing the parent's function with the one below
*
* @param array() $parameters Hook metadatas (context, etc...)
* @param CommonObject &$object The object to process (an invoice if you are in invoice module, a propale in propale's module, etc...)
* @param string &$action Current action (if set). Generally create or edit or null
* @param HookManager $hookmanager Hook manager propagated to allow calling another hook
* @return int < 0 on error, 0 on success, 1 to replace standard code
*/
function doActions($parameters, &$object, &$action, $hookmanager)
{
$error = 0; // Error counter
$myvalue = 'test'; // A result value

print_r($parameters);
echo "action: " . $action;
print_r($object);

if (in_array('somecontext', explode(':', $parameters['context'])))
{
// do something only for the context 'somecontext'
}

if (! $error)
{
$this->results = array('myreturn' => $myvalue);
$this->resprints = 'A text to show';
return 0; // or return 1 to replace standard code
}
else
{
$this->errors[] = 'Error message';
return -1;
}
}
}
</source>

La méthode sera alors automatiquement appelée au moment de l'appel du code qui contient le executeHooks fournissant à votre code les éléments $parameters, $object et $action.

'''Avec''':

*'''$parameters''' est un tableau (array) de meta-data regroupant les données du hook (son contexte accessible par $parameters['context'] mais d'autres information peuvent etre disponible selon le cas)
*'''$object''' est l'objet sur lequel vous désirez travailler (par exemple : product pour le contexte productcard)
*'''$action''' désigne l'action à exécuter (par exemple "create", "edit" or "view").
*'''$hookmanager''' n'est propagé que pour permettre à votre hook d'appeler d'autres hooks.

'''Retours''':

*Le code retour d'un hook doit être 0 ou 1 en cas de succès, négatif en cas d'erreur. En général, il sera 0. Il peut être 1, ce qui dans certains cas signifie que ce que fait votre hook remplace complètement ce que devait faire Dolibarr juste après l'appel du hook. Si le code est négatif, il est possible de fournir un message d'erreur à l'utilisateur en positionnant $this->errors[]='Message erreur'
*Si la méthode positionne la propriété $this->results avec un tableau, alors le tableau $hookmanager->resArray sera automatiquement enrichi avec le contenu de ce tableau, lequel pourra être réutilisé plus tard.
*Si la méthode positionne la propriété $this->resprints avec une chaîne, alors cette chaîne sera affiché par le gestionnaire de hook (executeHook), tout de suite à la sortie de votre méthode.
*Votre hook peut de plus modifier les valeurs de $object et $action.

=Liste des Hooks disponibles dans Dolibarr=
Trouver les hooks disponibles dans Dolibarr ?
Faites une recherche sur "'''executeHooks('''" dans le code source et vous trouverez facilement toutes les fonctions déjà implémentées.

En voici une liste (non complète) : [[:Category:Hooks]]
...

Note: veuillez noter que cette liste s'enrichit à chaque version, donc si vous voulez vraiment savoir si un hook ou contexte spécifique existe, veuillez chercher directement dans le code source avec la méthode indiquée ci-dessus.

=Liste des Contexts disponibles dans Dolibarr=
Pour trouver les contextes disponibles dans Dolibarr, la procédure est similaire aux hooks.
Faites une recherche sur "'''initHooks('''" dans le code source et vous trouverez facilement tous les contextes déjà implémentées.

{| class="wikitable sortable"
|-
!Context
!File / Fichier
|-
|accountancycustomerlist
|htdocs\accountancy\customer\list.php
|-
|accountancyindex
|htdocs\accountancy\index.php
|-
|accountancysupplierlist
|htdocs\accountancy\supplier\list.php
|-
|actioncard
|htdocs\comm\action\card.php
|-
|actiondao
|htdocs\comm\action\class\actioncomm.class.php
|-
|admin
|htdocs\accountancy\admin\accountmodel.php<br />
htdocs\accountancy\admin\categories_list.php<br />
htdocs\accountancy\admin\journals_list.php<br />
htdocs\admin\dict.php<br />
htdocs\admin\website_options.php
|-
|admincompany
|htdocs\admin\company.php
|-
|admindefaultvalues
|htdocs\admin\defaultvalues.php
|-
|adminldap
|htdocs\admin\ldap.php
|-
|adminmodules
|htdocs\admin\modules.php
|-
|admintranslation
|htdocs\admin\translation.php
|-
|agenda
|htdocs\comm\action\index.php
htdocs\comm\action\pertype.php
htdocs\comm\action\peruser.php
|-
|agendaexport
|htdocs\public\agenda\agendaexport.php
|-
|agendalist
|htdocs\comm\action\list.php
|-
|agendaresource
|htdocs\resource\agenda.php
|-
|agendathirdparty
|htdocs\societe\agenda.php
htdocs\product\agenda.php
|-
|assetcard
|htdocs\asset\card.php
|-
|assetdocument
|htdocs\asset\document.php
|-
|assetlist
|htdocs\asset\list.php
|-
|assetnote
|htdocs\asset\note.php
|-
|assettypecard
|htdocs\asset\type.php
|-
|bankaccountlist
|htdocs\compta\bank\list.php
|-
|bankcard
|htdocs\compta\bank\card.php
|-
|banktransactionlist
|htdocs\compta\bank\bankentries_list.php
|-
|banktreso
|htdocs\compta\bank\treso.php
|-
|bomagenda
|htdocs\bom\bom_agenda.php
|-
|bomcard
|htdocs\bom\bom_card.php
|-
|bomdao
|htdocs\bom\class\bom.class.php
|-
|bomdocument
|htdocs\bom\bom_document.php
|-
|bomlinedao
|htdocs\bom\class\bom.class.php
|-
|bomlist
|htdocs\bom\bom_list.php
|-
|bomnote
|htdocs\bom\bom_note.php
|-
|cashcontrol
|htdocs\compta\cashcontrol\cashcontrol_list.php
|-
|cashcontrolcard
|htdocs\compta\cashcontrol\cashcontrol_card.php
|-
|cashdeskloginpage
|htdocs\cashdesk\index.php
|-
|cashdeskTplTicket
|htdocs\cashdesk\validation_ticket.php
|-
|cashfencedao
|htdocs\compta\cashcontrol\class\cashcontrol.class.php
|-
|categorycard
|htdocs\categories\card.php<br />
htdocs\categories\edit.php<br />
htdocs\categories\viewcat.php
|-
|commandefournisseurdispatchdao
|htdocs\fourn\class\fournisseur.commande.dispatch.class.php
|-
|commonobject
|htdocs\core\class\html.form.class.php
|-
|comptafileslist
|htdocs\compta\compta-files.php
|-
|consumptioncontact
|htdocs\contact\consumption.php
|-
|consumptionthirdparty
|htdocs\societe\consumption.php
|-
|contactagenda
|htdocs\contact\agenda.php
|-
|contactcard
|htdocs\contact\card.php
|-
|contactdao
|htdocs\contact\class\contact.class.php
|-
|contactlist
|htdocs\contact\list.php
|-
|contactthirdparty
|htdocs\societe\societecontact.php
|-
|contacttpl
|htdocs\core\tpl\contacts.tpl.php
htdocs\projet\tasks\contact.php
|-
|contractcard
|htdocs\contrat\card.php htdocs\contrat\contact.php<br />
htdocs\contrat\document.php<br />
htdocs\contrat\info.php htdocs\contrat\note.php
|-
|contractlist
|htdocs\contrat\list.php
|-
|contractservicelist
|htdocs\contrat\services_list.php
|-
|cron
|htdocs\cron\class\cronjob.class.php
|-
|cronjoblist
|htdocs\cron\list.php
|-
|defineholidaylist
|htdocs\holiday\define_holiday.php
|-
|deliverycard
|htdocs\livraison\card.php
|-
|doncard
|htdocs\don\card.php
|-
|element_resource
|htdocs\resource\element_resource.php
|-
|emailcollectoractiondao
|htdocs\emailcollector\class\emailcollectoraction.class.php
|-
|emailcollectorcard
|htdocs\admin\emailcollector_card.php
|-
|emailcollectordao
|htdocs\emailcollector\class\emailcollector.class.php
|-
|emailcollectorfilterdao
|htdocs\emailcollector\class\emailcollectorfilter.class.php
|-
|emailcollectorlist
|htdocs\admin\emailcollector_list.php
|-
|emailingdao
|htdocs\comm\mailing\class\mailing.class.php
|-
|emailsenderprofilelist
|htdocs\admin\mails_senderprofile_list.php
|-
|emailtemplates
|htdocs\admin\mails_templates.php
|-
|expeditioncard
|htdocs\expedition\card.php
|-
|expensereportcard
|htdocs\expensereport\card.php
|-
|expensereportlist
|htdocs\expensereport\list.php
|-
|externalbalance
|htdocs\compta\localtax\clients.php<br />
htdocs\compta\localtax\index.php<br />
htdocs\compta\resultat\clientfourn.php<br />
htdocs\compta\resultat\index.php<br />
htdocs\compta\tva\clients.php<br />
htdocs\compta\tva\index.php<br />
htdocs\compta\tva\quadri_detail.php
|-
|fichinterdao
|htdocs\fichinter\class\fichinter.class.php
|-
|fileslib
|htdocs\core\lib\files.lib.php
|-
|formfile
|htdocs\core\class\html.formfile.class.php
|-
|formmail
|htdocs\core\class\html.formmail.class.php
|-
|globaladmin
|htdocs\admin\company.php<br />
htdocs\admin\defaultvalues.php<br />
htdocs\admin\ldap.php<br />
htdocs\admin\modules.php<br />
htdocs\admin\translation.php
|-
|globalcard
|htdocs\adherents\card.php<br />
htdocs\categories\viewcat.php<br />
htdocs\comm\action\card.php<br />
htdocs\asset\type.php<br />
htdocs\bom\bom_agenda.php<br />
htdocs\bom\bom_card.php<br />
htdocs\bom\bom_document.php<br />
htdocs\bom\bom_note.php<br />
htdocs\adherents\type.php<br />
htdocs\adherents\type_ldap.php<br />
htdocs\comm\propal\card.php<br />
htdocs\commande\card.php<br />
htdocs\compta\bank\card.php<br />
htdocs\compta\bank\treso.php<br />
htdocs\compta\bank\various_payment\card.php<br />
htdocs\compta\cashcontrol\cashcontrol_card.php<br />
htdocs\compta\deplacement\card.php<br />
htdocs\compta\facture\card.php<br />
htdocs\compta\facture\fiche-rec.php<br />
htdocs\compta\facture\invoicetemplate_list.php<br />
htdocs\compta\localtax\card.php<br />
htdocs\compta\paiement.php<br />
htdocs\compta\recap-compta.php<br />
htdocs\compta\salaries\card.php<br />
htdocs\compta\tva\card.php<br />
htdocs\contact\agenda.php<br />
htdocs\contact\card.php<br />
htdocs\contrat\card.php<br />
htdocs\contrat\contact.php<br />
htdocs\contrat\document.php<br />
htdocs\contrat\info.php<br />
htdocs\contrat\note.php<br />
htdocs\comm\card.php<br />
htdocs\comm\mailing\card.php<br />
htdocs\don\card.php<br />
htdocs\expedition\card.php<br />
htdocs\expensereport\card.php<br />
htdocs\fichinter\card.php<br />
htdocs\fourn\card.php<br />
htdocs\fourn\commande\card.php<br />
htdocs\fourn\facture\card.php<br />
htdocs\fourn\recap-fourn.php<br />
htdocs\livraison\card.php<br />
htdocs\loan\card.php<br />
htdocs\margin\tabs\thirdpartyMargins.php<br />
htdocs\modulebuilder\template\myobject_agenda.php<br />
htdocs\modulebuilder\template\myobject_card.php<br />
htdocs\modulebuilder\template\myobject_document.php<br />
htdocs\modulebuilder\template\myobject_note.php<br />
htdocs\product\card.php<br />
htdocs\product\fournisseurs.php<br />
htdocs\product\price.php<br />
htdocs\product\stock\card.php<br />
htdocs\product\stock\product.php<br />
htdocs\product\stock\productlot_card.php<br />
htdocs\projet\card.php<br />
htdocs\projet\comment.php<br />
htdocs\projet\contact.php<br />
htdocs\projet\tasks\comment.php<br />
htdocs\projet\tasks\task.php<br />
htdocs\projet\tasks\time.php<br />
htdocs\projet\tasks.php<br />
htdocs\reception\card.php<br />
htdocs\resource\card.php<br />
htdocs\societe\card.php<br />
htdocs\societe\contact.php<br />
htdocs\societe\document.php<br />
htdocs\societe\note.php<br />
htdocs\societe\notify\card.php<br />
htdocs\societe\paymentmodes.php<br />
htdocs\societe\price.php<br />
htdocs\societe\societecontact.php<br />
htdocs\stripe\payment.php<br />
htdocs\supplier_proposal\card.php<br />
htdocs\ticket\card.php<br />
htdocs\user\agenda_extsites.php<br />
htdocs\user\card.php<br />
htdocs\user\clicktodial.php<br />
htdocs\user\document.php<br />
htdocs\user\group\card.php<br />
htdocs\user\group\perms.php<br />
htdocs\user\ldap.php<br />
htdocs\user\note.php<br />
htdocs\user\param_ihm.php<br />
htdocs\user\perms.php
|-
|globallist
|htdocs\compta\compta-files.php
|-
|groupcard
|htdocs\user\group\card.php
|-
|groupdao
|htdocs\user\class\usergroup.class.php
|-
|groupperms
|htdocs\user\group\perms.php
|-
|holidaylist
|htdocs\holiday\list.php
|-
|homesetup
|htdocs\admin\index.php
|-
|idprofurl
|htdocs\societe\class\societe.class.php
|-
|index
|htdocs\index.php
|-
|interventioncard
|htdocs\fichinter\card.php
|-
|interventionlist
|htdocs\fichinter\list.php
|-
|intervnetiondao
|htdocs\fichinter\class\fichinter.class.php
|-
|inventorycard
|htdocs\product\inventory\card.php
|-
|inventorylist
|htdocs\product\inventory\list.php
|-
|invoicecard
|htdocs\compta\facture\card.php
|-
|invoicedao
|htdocs\compta\facture\class\facture.class.php
|-
|invoiceindex
|htdocs\compta\index.php
|-
|invoicelist
|htdocs\compta\facture\list.php
|-
|invoicereccard
|htdocs\compta\facture\fiche-rec.php
htdocs\compta\facture\invoicetemplate_list.php
|-
|invoicesuppliercard
|htdocs\fourn\facture\card.php
|-
|leavemovementlist
|htdocs\holiday\view_log.php
|-
|leftblock
|htdocs\main.inc.php
|-
|loancard
|htdocs\loan\card.php
|-
|localtaxvatcard
|htdocs\compta\localtax\card.php
|-
|login
|htdocs\main.inc.php
|-
|logout
|htdocs\user\logout.php
|-
|mail
|htdocs\core\class\CMailFile.class.php
|-
|mailingcard
|htdocs\comm\mailing\card.php
|-
|mailinglist
|htdocs\comm\mailing\list.php
|-
|main
|htdocs\core\lib\security.lib.php
htdocs\main.inc.php
|-
|mainloginpage
|htdocs\core\lib\security2.lib.php
|-
|membercard
|htdocs\adherents\card.php
|-
|memberlist
|htdocs\adherents\list.php
|-
|membertypecard
|htdocs\adherents\type.php
|
|-
|membertypeldapcard
|htdocs\adherents\type_ldap.php
|-
|movementlist
|htdocs\core\modules\stock\doc\pdf_stdmovement.modules.php
htdocs\product\stock\movement_card.php
htdocs\product\stock\movement_list.php
|-
|myobjectagenda
|htdocs\modulebuilder\template\myobject_agenda.php
|-
|myobjectcard
|htdocs\modulebuilder\template\myobject_card.php
|-
|myobjectdao
|htdocs\comm\mailing\class\mailing.class.php<br />
htdocs\modulebuilder\template\class\myobject.class.php<br />
htdocs\compta\bank\class\paymentvarious.class.php<br />
htdocs\compta\cashcontrol\class\cashcontrol.class.php<br />
htdocs\compta\salaries\class\paymentsalary.class.php<br />
htdocs\emailcollector\class\emailcollector.class.php
|-
|myobjectdocument
|htdocs\modulebuilder\template\myobject_document.php
|-
|myobjectlist
|htdocs\modulebuilder\template\myobject_list.php
|-
|myobjectnote
|htdocs\modulebuilder\template\myobject_note.php
|-
|notification
|htdocs\core\class\notify.class.php
|-
|odtgeneration
|htdocs\core\modules\user\doc\doc_generic_user_odt.modules.php<br />
htdocs\core\modules\usergroup\doc\doc_generic_usergroup_odt.modules.php<br />
htdocs\core\modules\supplier_proposal\doc\doc_generic_supplier_proposal_odt.modules.php<br />
htdocs\core\modules\societe\doc\doc_generic_odt.modules.php<br />
htdocs\core\modules\stock\doc\doc_generic_stock_odt.modules.php<br />
htdocs\core\modules\facture\doc\doc_generic_invoice_odt.modules.php<br />
htdocs\core\modules\product\doc\doc_generic_product_odt.modules.php<br />
htdocs\core\modules\project\doc\doc_generic_project_odt.modules.php<br />
htdocs\core\modules\propale\doc\doc_generic_proposal_odt.modules.php<br />
htdocs\core\modules\reception\doc\doc_generic_reception_odt.modules.php<br />
htdocs\core\modules\commande\doc\doc_generic_order_odt.modules.php<br />
htdocs\core\modules\contract\doc\doc_generic_contract_odt.modules.php<br />
htdocs\core\modules\expedition\doc\doc_generic_shipment_odt.modules.php
|-
|ordercard
|htdocs\commande\card.php
|-
|orderdao
|htdocs\commande\class\commande.class.php
|-
|orderlist
|htdocs\commande\list.php<br />
htdocs\don\list.php
|-
|ordershipmentcard
|htdocs\expedition\shipment.php
|-
|orderstoinvoice
|htdocs\commande\orderstoinvoice.php
|-
|orderstoinvoicesupplier
|htdocs\fourn\commande\orderstoinvoice.php
|-
|ordersuppliercard
|htdocs\fourn\commande\card.php
|-
|ordersupplierdispatch
|htdocs\fourn\commande\dispatch.php
|-
|paiementcard
|htdocs\stripe\payment.php<br />
htdocs\compta\paiement.php
|-
|passwordforgottenpage
|htdocs\user\passwordforgotten.php
|-
|paymentlist
|htdocs\compta\paiement\list.php
|-
|paymentsupplierlist
|htdocs\fourn\facture\paiement.php
|-
|pdfgeneration
|htdocs\core\modules\action\rapport.pdf.php<br />
htdocs\core\modules\bank\doc\pdf_ban.modules.php<br />
htdocs\core\modules\bank\doc\pdf_sepamandate.modules.php<br />
htdocs\core\modules\cheque\doc\pdf_blochet.class.php<br />
htdocs\core\modules\commande\doc\pdf_einstein.modules.php<br />
htdocs\core\modules\commande\doc\pdf_eratosthene.modules.php<br />
htdocs\core\modules\contract\doc\pdf_strato.modules.php<br />
htdocs\core\modules\expedition\doc\pdf_espadon.modules.php<br />
htdocs\core\modules\expedition\doc\pdf_merou.modules.php<br />
htdocs\core\modules\expedition\doc\pdf_rouget.modules.php<br />
htdocs\core\modules\expensereport\doc\pdf_standard.modules.php<br />
htdocs\core\modules\facture\doc\pdf_crabe.modules.php<br />
htdocs\core\modules\facture\doc\pdf_sponge.modules.php<br />
htdocs\core\modules\fichinter\doc\pdf_soleil.modules.php<br />
htdocs\core\modules\livraison\doc\pdf_typhon.modules.php<br />
htdocs\core\modules\product\doc\pdf_standard.modules.php<br />
htdocs\core\modules\project\doc\pdf_baleine.modules.php<br />
htdocs\core\modules\project\doc\pdf_beluga.modules.php<br />
htdocs\core\modules\project\doc\pdf_timespent.modules.php<br />
htdocs\core\modules\propale\doc\pdf_azur.modules.php<br />
htdocs\core\modules\propale\doc\pdf_cyan.modules.php<br />
htdocs\core\modules\rapport\pdf_paiement.class.php<br />
htdocs\core\modules\reception\doc\pdf_squille.modules.php<br />
htdocs\core\modules\stock\doc\pdf_standard.modules.php<br />
htdocs\core\modules\stock\doc\pdf_stdmovement.modules.php<br />
htdocs\core\modules\supplier_invoice\pdf\pdf_canelle.modules.php<br />
htdocs\core\modules\supplier_order\pdf\pdf_cornas.modules.php<br />
htdocs\core\modules\supplier_order\pdf\pdf_muscadet.modules.php<br />
htdocs\core\modules\supplier_payment\doc\pdf_standard.modules.php<br />
htdocs\core\modules\supplier_proposal\doc\pdf_aurore.modules.php
|-
|pricesuppliercard
|htdocs\product\fournisseurs.php
|-
|product_lotlist
|htdocs\product\stock\productlot_list.php
|-
|productcard
|htdocs\product\card.php
|-
|productdao
|htdocs\product\class\product.class.php
|-
|productdocuments
|htdocs\product\document.php
|-
|productindex
|htdocs\product\index.php
|-
|productlotcard
|htdocs\product\stock\productlot_card.php
|-
|productlotdocuments
|htdocs\product\stock\productlot_document.php
|-
|productpricecard
|htdocs\product\price.php
|-
|productservicelist
|htdocs\product\list.php
|-
|productstatscontract
|htdocs\product\stats\contrat.php
|-
|productstatsinvoice
|htdocs\product\stats\facture.php
|-
|productstatsorder
|htdocs\product\stats\commande.php
|-
|productstatspropal
|htdocs\product\stats\propal.php
htdocs\product\stats\supplier_proposal.php
|-
|productstatssupplyinvoice
|htdocs\product\stats\facture_fournisseur.php
|-
|productstatssupplyorder
|htdocs\product\stats\commande_fournisseur.php
|-
|projectcard
|htdocs\projet\card.php
htdocs\projet\comment.php
|-
|projectcontactcard
|htdocs\projet\contact.php
|-
|projectdao
|htdocs\projet\class\project.class.php
|-
|projectlist
|htdocs\projet\list.php
|-
|projectOverview
|htdocs\projet\element.php
|-
|projecttaskcard
|htdocs\projet\tasks\task.php
|-
|projecttaskcommentcard
|htdocs\projet\tasks\comment.php
|-
|projecttaskscard
|htdocs\projet\tasks.php
|-
|projecttasktime
|htdocs\projet\tasks\time.php
|-
|projectthirdparty
|htdocs\societe\project.php
|-
|projectticket
|htdocs\ticket\list.php
|-
|propalcard
|htdocs\comm\propal\card.php
|-
|propallist
|htdocs\comm\propal\list.php
|
|-
|purchasesjournal
|htdocs\accountancy\journal\purchasesjournal.php
|-
|recapcomptacard
|htdocs\compta\recap-compta.php
|-
|receptioncard
|htdocs\reception\card.php
|-
|receptiondao
|htdocs\reception\card.php
htdocs\reception\class\reception.class.php
|-
|receptionlist
|htdocs\reception\list.php
|-
|resource
|htdocs\resource\card.php
|-
|resource_card
|htdocs\resource\card.php
|-
|resourcelist
|htdocs\resource\list.php
|-
|salarycard
|htdocs\compta\salaries\card.php
|-
|salarypayment
|htdocs\compta\salaries\class\paymentsalary.class.php
|-
|searchform
|htdocs\core\ajax\selectsearchbox.php<br />
htdocs\core\search_page.php<br />
htdocs\main.inc.php
|-
|sellsjournal
|htdocs\accountancy\journal\sellsjournal.php
|-
|shipmentlist
|htdocs\expedition\list.php
|-
|stockproductcard
|htdocs\product\stock\product.php
|-
|stockreplenishlist
|htdocs\product\stock\replenish.php
|-
|subscription
|htdocs\adherents\subscription.php
|-
|subscriptionlist
|htdocs\adherents\subscription\list.php
|-
|supplier_proposalcard
|htdocs\supplier_proposal\card.php
|-
|supplier_proposallist
|htdocs\supplier_proposal\list.php
|-
|supplierbalencelist
|htdocs\compta\recap-compta.php
htdocs\fourn\recap-fourn.php
|-
|suppliercard
|htdocs\fourn\card.php
|-
|supplierinvoicelist
|htdocs\fourn\facture\list.php
|-
|supplierorderlist
|htdocs\fourn\commande\list.php
|-
|supplierpricelist
|htdocs\fourn\product\list.php
|-
|surveylist
|htdocs\opensurvey\list.php
|-
|takeposfrontend
|htdocs\takepos\takepos.php
|-
|tasklist
|htdocs\projet\tasks\list.php
|-
|tasktimelist
|htdocs\projet\tasks\time.php
|-
|taxvatcard
|htdocs\compta\tva\card.php
|-
|thirdpartybancard
|htdocs\societe\paymentmodes.php
|-
|thirdpartycard
|htdocs\core\tpl\advtarget.tpl.php
htdocs\societe\card.php
|-
|thirdpartycomm
|htdocs\comm\card.php
|-
|thirdpartycontact
|htdocs\societe\contact.php
|-
|thirdpartycustomerprice
|htdocs\societe\price.php
|-
|thirdpartydao
|htdocs\societe\class\societe.class.php
|-
|thirdpartydocument
|htdocs\societe\document.php
|-
|thirdpartylist
|htdocs\societe\list.php
|-
|thirdpartymargins
|htdocs\margin\tabs\thirdpartyMargins.php
|-
|thirdpartynote
|htdocs\societe\note.php
|-
|thirdpartynotification
|htdocs\societe\notify\card.php
|-
|thirdpartyticket
|htdocs\ticket\list.php
|-
|ticketcard
|htdocs\ticket\card.php
|-
|ticketlist
|htdocs\ticket\list.php
|-
|timesheetperdaycard
|htdocs\projet\activity\perday.php
|-
|timesheetperweekcard
|htdocs\projet\activity\perweek.php
|-
|toprightmenu
|htdocs\main.inc.php
|-
|tripsandexpensescard
|htdocs\compta\deplacement\card.php
|-
|upgrade
|htdocs\install\upgrade2.php
|-
|useragenda
|htdocs\user\agenda_extsites.php
|-
|usercard
|htdocs\user\agenda_extsites.php<br />
htdocs\user\card.php<br />
htdocs\user\clicktodial.php<br />
htdocs\user\document.php<br />
htdocs\user\ldap.php<br />
htdocs\user\note.php<br />
htdocs\user\param_ihm.php<br />
htdocs\user\perms.php
|-
|userdao
|htdocs\user\class\user.class.php
|-
|userdoc
|htdocs\user\document.php
|-
|userhome
|htdocs\user\home.php
|-
|userihm
|htdocs\user\param_ihm.php
|-
|userldap
|htdocs\user\ldap.php
|-
|userlist
|htdocs\user\list.php
|-
|usernote
|htdocs\user\note.php
|-
|userperms
|htdocs\user\perms.php
|-
|variouscard
|htdocs\compta\bank\various_payment\card.php
|-
|variouspayment
|htdocs\compta\bank\class\paymentvarious.class.php
|-
|warehousecard
|htdocs\product\stock\card.php
|-
|website
|htdocs\admin\website.php
|-
|websiteaccountcard
|htdocs\website\websiteaccount_card.php
|-
|websitethirdpartylist
|htdocs\societe\website.php
|}

Note: veuillez noter que cette liste s'enrichie à chaque version, donc si vous voulez vraiment savoir si un hook ou contexte spécifique existe, veuillez chercher directement dans le code source avec la méthode indiquée ci-dessus.

=Voir aussi=

*[[Triggers]]
*[[Interfaces Dolibarr toward foreign systems]]
*[[Interfaces from foreign systems toward Dolibarr]]

Versions

2022-08-19T11:01:41Z

Jtraulle:

[[en:Releases]]
[[de:Versionen]]


{{DISPLAYTITLE:Liste des versions, journal des modifications et compatibilités}}
[[Category:RoadMap]]

{{TemplateDocUser}}

=Historique des Versions / Releases de Dolibarr=

Pour de l'information sur le processus ou calendrier des nouvelles versions, voir la page [[:Category:RoadMap]].

=ChangeLog=
La liste cumulée des modifications est disponible dans le fichier ChangeLog (en anglais):

https://github.com/Dolibarr/dolibarr/blob/develop/ChangeLog

=Liste des versions et compatibilités=
{| class="wikitable sortable"
!Release/Version!!Date<small><sup>1</sup></small>!![[PHP]] min.!![[PHP]] max.!! class="unsortable" |[[Database]]
!Modules<sup><small>2</small></sup>!! class="unsortable" |Note
|-
|15.0.3
|2022-07-27
|PHP 5.6
|PHP 7.4
|
|
|
|-
|15.0.2
|2022-05-17
|PHP 5.6
|PHP 7.4
|
|
|
|-
|15.0.1
|2022-03-21
|PHP 5.6
|PHP 7.4
|
|
|
|-
|'''[[Roadmap and Release 15.0.0|15.0.0]]'''
|'''2022-02-18'''
|PHP 5.6
|PHP 7.4
|
|'''76 / 7 / 6'''
|
|-
|14.0.5
|2022-01-04
|PHP 5.6
|PHP 7.4
|
|
|
|-
|14.0.4
|2021-11-20
|PHP 5.6
|PHP 7.4
|
|
|
|-
|14.0.3
|2021-10-19
|PHP 5.6
|PHP 7.4
|
|
|
|-
|14.0.2
|2021-09-13
|PHP 5.6
|PHP 7.4
|
|
|
|-
|14.0.1
|2021-08-19
|PHP 5.6
|PHP 7.4
|
|
|
|-
|'''[[Roadmap and Release 14.0.0|14.0.0]]'''
|'''2021-07-16'''
|PHP 5.6
|PHP 7.4
|
*MySQL min. 5.1
*PostgreSQL min. 9.1.0
|'''75 / 6 / 8'''
|NOUVEAU : Module Recrutement

Déprécié : Module SimplePOS
|-
|13.0.5
|2021-10-16
|PHP 5.6
|PHP 7.4
|
|
|
|-
|13.0.4
|2021-07-12
|PHP 5.6
|PHP 7.4
|
|
|
|-
|13.0.3
|2021-06-19
|PHP 5.6
|PHP 7.4
|
|
|
|-
|13.0.2
|2021-03-16
|PHP 5.6
|PHP 7.4
|
|
|
|-
|13.0.1
|2021-02-20
|PHP 5.6
|PHP 7.4
|
|
|
|-
|'''[[Roadmap and Release 13.0.0|13.0.0]]'''
|'''2021-01-25'''
|PHP 5.6
|PHP 7.4
|
|'''75 / 4 / 7'''
|
|-
|12.0.5
|2021-02-16
|PHP 5.6
|PHP 7.4
|
|
|
|-
|12.0.4
|2020-12-13
|PHP 5.6
|PHP 7.4
|
|
|
|-
|12.0.3
|2020-09-23
|PHP 5.6
|PHP 7.4
|
|
|
|-
|12.0.2
|2020-08-08
|PHP 5.6
|PHP 7.4
|
|
|
|-
|12.0.1
|2020-07-07
|PHP 5.6
|PHP 7.4
|
|
|
|-
|'''[[Roadmap and Release 12.0.0|12.0.0]]'''
|'''2020-06-22'''
|'''PHP 5.6'''
|PHP 7.4
|
|'''72 / 5 / 7'''
|Module MO en stable
|-
|11.0.5
|2020-06-26
|PHP 5.5
|PHP 7.4
|
|
|
|-
|11.0.4
|2020-05-06
|PHP 5.5
|PHP 7.4
|
|
|
|-
|11.0.3
|2020-03-19
|PHP 5.5
|PHP 7.4
|
|
|
|-
|11.0.2
|2020-03-04
|PHP 5.5
|PHP 7.4
|
|
|
|-
|11.0.1
|2020-02-13
|PHP 5.5
|PHP 7.4
|
|
|
|-
|'''[[Roadmap and Release 11.0.0|11.0.0]]'''
|'''2020-01-30'''
|PHP 5.5
|'''PHP 7.4'''
|
|'''71 / 5 / 7'''
|[[Module BOM]] en stable
|-
|10.0.7
|2020-04-02
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.6
|2020-01-05
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.5
|2019-12-24
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.4
|2019-11-27
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.3
|2019-10-23
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.2
|2019-09-11
|PHP 5.5
|PHP 7.3
|
|
|
|-
|10.0.1
|2019-08-04
|PHP 5.5
|PHP 7.3
|
|
|
|-
|[[Roadmap and Release 10.0.0|'''10.0.0''']]
|'''2019-06-30'''
|'''PHP 5.5'''
|PHP 7.3
|
|'''70 / 5 / 6'''
|[[Module Ticket FR|Module Ticket]] en stable
|-
|9.0.4
|2019-06-30
|PHP 5.4
|PHP 7.3
|
|
|
|-
|9.0.3
|2019-05-09
|PHP 5.4
|PHP 7.3
|
|
|
|-
|9.0.2
|2019-04-07
|PHP 5.4
|PHP 7.3
|
|
|
|-
|9.0.1
|2019-03-05
|PHP 5.4
|PHP 7.3
|
|
|
|-
|[[Roadmap and Release 9.0.0|'''9.0.0''']]
|'''2019-02-01'''
|PHP 5.4
|'''PHP 7.3'''
|
|'''66 / 5 / 7'''
|
|-
|8.0.6
|2019-06-29
|PHP 5.4
|PHP 7.2
|
|
|
|-
|8.0.5
|2019-05-11
|PHP 5.4
|PHP 7.2
|
|
|
|-
|8.0.4
|2018-12-23
|PHP 5.4
|PHP 7.2
|
|
|
|-
|8.0.3
|2018-11-05
|PHP 5.4
|PHP 7.2
|
|
|
|-
|8.0.2
|2018-09-19
|PHP 5.4
|PHP 7.2
|
|
|
|-
|8.0.1
|2018-09-02
|PHP 5.4
|PHP 7.2
|
|
|
|-
|[[Roadmap and Release 8.0.0|'''8.0.0''']]
|'''2018-08-14'''
|'''PHP 5.4'''
|PHP 7.2
|
|
|
|-
|7.0.5
|2019-01-05
|PHP 5.3
|PHP 7.2
|
|
|
|-
|7.0.4
|2018-10-12
|PHP 5.3
|PHP 7.2
|
|
|
|-
|7.0.3
|2018-06-23
|PHP 5.3
|PHP 7.2
|
|
|
|-
|7.0.2
|2018-05-12
|PHP 5.3
|PHP 7.2
|
|
|
|-
|7.0.1
|2018-03-23
|PHP 5.3
|PHP 7.2
|
|
|
|-
|[[Roadmap and Release 7.0.0|'''7.0.0''']]
|'''2018-02-18'''
|PHP 5.3
|'''PHP 7.2'''
|
|
|
|-
|6.0.8
|2018-10-12
|PHP 5.3
|PHP 7.1
|
|
|
|-
|6.0.7
|2018-05-06
|PHP 5.3
|PHP 7.1
|
|
|
|-
|6.0.6
|2018-03-22
|PHP 5.3
|PHP 7.1
|
|
|
|-
|6.0.5
|2018-01-26
|PHP 5.3
|PHP 7.1
|
|
|
|-
|6.0.4
|2017-12-05
|PHP 5.3
|PHP 7.1
|
|-
|6.0.3
|2017-10-29
|PHP 5.3
|PHP 7.1
|
|
|
|-
|6.0.2
|2017-10-07
|PHP 5.3
|PHP 7.1
|
|-
|6.0.1
|2017-09-20
|PHP 5.3
|PHP 7.1
|
|
|
|-
|[[Roadmap and Release 6.0.0|'''6.0.0''']]
|'''2017-09-04'''
|'''PHP 5.3'''
|'''PHP 7.1'''
|
|'''61 / 4 / 7'''
|
|-
|5.0.7
|2017-10-29
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.6
|2017-09-04
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.5
|2017-08-26
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.4
|2017-06-26
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.3
|2017-06-01
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.2
|2017-05-06
|PHP 5.3
|PHP 7.0
|
|
|
|-
|5.0.1
|2017-04-03
|PHP 5.3
|PHP 7.0
|
|
|
|-
|[[Roadmap and Release 5.0.0|'''5.0.0''']]
|'''2017-03-12'''
|'''PHP 5.3'''
|'''PHP 7.0'''
|
|'''60'''
|
|-
|4.0.6
|2017-05-29
|
|
|
|
|
|-
|4.0.5
|2017-04-02
|
|
|
|
|
|-
|4.0.4
|2017-01-24
|
|
|
|
|
|-
|4.0.3
|2016-12-26
|
|
|
|
|
|-
|4.0.2
|2016-10-31
|
|
|
|
|
|-
|4.0.1
|2016-10-02
|
|
|
|
|
|-
|[[Roadmap and Release 4.0.0|'''4.0.0''']]
|'''2016-06 / 2016-09'''
|
|'''PHP 7.0'''
|
|
|
|-
|3.9.1
|2016-04-23
|
|
|
|
|
|-
|[[Roadmap and Release 3.9.0|3.9.0]]
|2016-03-13
|
|
|MySQL 5.0.3
|
|
|-
|3.8.1
|2015-10-11
|
|
|
|
|
|-
|[[Roadmap and Release 3.8.0|3.8.0]]
|2015-09-13
|
|
|
|
|
|-
|[[Roadmap and Release 3.7.0|3.7.0]]
|2015-04-20
|
|
|
|
|
|-
|[[Roadmap and Release 3.6.0|3.6.0]]
|2014-06
|
|
|
|
|
|-
|3.5.2
|2014-04-13
|
|
|
|
|
|-
|3.5.1
|2014-03-09
|
|
|
|
|
|-
|[[Roadmap and Release 3.5.0|3.5.0]]
|2014-02-03
|
|
|
|
|
|-
|[[Roadmap and Release 3.4.2|3.4.2]]
|2014-01
|
|
|
|
|
|-
|[[Roadmap and Release 3.4.0|3.4.0]]
|2013-07
|
|
|
|
|
|-
|[[Roadmap and Release 3.3.0 ("gpl v3+" version)|3.3.0]]
|2013-01
|
|
|
|
|GPL v3+
|-
|[[Roadmap and Release 3.2.0|3.2.0]]
|2012-06
|PHP 5.0
|
|
|
|
|-
|[[Roadmap and Release 3.1.0 ("War against clicks" version)|3.1.0]]
|2011-10-13
|
|
|
|
|
|-
|[[Roadmap and Release 3.0.0|'''3.0.0''']]
|'''2011-04-23'''
|
|
|'''MySQL 5.5'''
|
|
|-
|[[Roadmap and Release 2.9.0|2.9.0]]
|2010-09-02
|
|
|
|
|
|-
|[[Roadmap and Release 2.8.1|2.8.1]]
|2010 ?
|
|
|
|
|
|-
|[[Roadmap and Release 2.8.0|2.8.0]]
|2010-03-16
|
|
|
|
|
|-
|[[Roadmap and Release 2.7.1|2.7.1]]
|2009-12-30
|
|
|
|
|
|-
|[[Roadmap and Release 2.7.0 ("Exploitation and security" version)|2.7.0]]
|2009-12-04
|
|
|
|
|
|-
|[[Roadmap and Release 2.6.1|2.6.1]]
|2009-06-13
|
|
|
|
|
|-
|[[Roadmap and Release 2.6.0 ("Stabilization" version)|2.6.0]]
|2009-04-24
|
|
|
|
|
|-
|[[Roadmap and Release 2.5.0 ("International" version)|2.5.0]]
|2008-12-31
|
|
|
|
|UTF8-Support
|-
|[[Roadmap and Release 2.4.1|2.4.1]]
|2008-10-31
|
|
|
|
|
|-
|[[Roadmap and Release 2.4.0 ("Popularity" version)|2.4.0]]
|2008-08-22
|
|
|
|
|
|-
|[[Roadmap and Release 2.2.0 ("Purged version")|2.2.0]]
|2007-12-26
|
|
|
|
|
|-
|[[Roadmap and Release 2.1.0|2.1.0]]
|jamais
|
|PHP 5
|
|
|
|-
|[[Roadmap and Release 2.0.0|2.0.0]]
|2005-02-01
|
|
|
|
|Version Communautaire
|-
|[[Roadmap and Release 1.0.0 ("Initial" version)|1.0.0]]
|2003-09-01
|
|
|
|
|Version Initiale
|}

''<sup>1</sup> Date de sortie reprise de sourceforge ou du fichier changelog''

''<sup>2</sup> Nombre de Modules (stable / expérimental / en développement)''

Draft:Discourse Implementation and Exploitation

2022-07-04T20:01:41Z

Jtraulle:

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<syntaxhighlight lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</syntaxhighlight>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

User:Jtraulle/DiscourseMigration

2022-07-04T20:00:17Z

Jtraulle:

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<syntaxhighlight lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</syntaxhighlight>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<syntaxhighlight lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</syntaxhighlight>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<syntaxhighlight lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</syntaxhighlight>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

Note : to restore a save from a multisite install that is not the main (first) database, prepend the command by <code>RAILS_DB=dolibarrde</code> where <code>dolibarrde</code> is the name of the database :

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'RAILS_DB=dolibarrde bundle exec ruby script/discourse restore dolibarr-germany-forum-2020-08-16-163120-v20200814081437.sql.gz'
</syntaxhighlight>

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher rebuild data
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher enter data
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

Installation manuelle sous Windows

2022-04-07T11:25:47Z

Jtraulle: /* Liens de téléchargement directs : */

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>7.4.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x64-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x86-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Installation manuelle sous Windows

2022-04-07T11:25:21Z

Jtraulle: Ajout liens directs PHP 7.4 Thread Safe

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>7.4.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x64-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x86-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 32 bits]<br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Dolibarr con Synology

2021-08-22T11:47:47Z

Jtraulle:

[[en:Dolibarr_avec_Synology]]
[[fr:Dolibarr_avec_Synology]]

[[Category:Admin_es]]
[[Category:Cloud]]
{{TemplateDocUsuario}}

Este tutorial explica cómo instalar Dolibarr en un servidor Synology.

== La manera fácil ==
Si desea una manera fácil de instalar Dolibarr en Synology, puede probar este paquete: https://www.dolistore.com/fr/outils-systemes/742-Paquet-Dolibarr-pour-Synology.html

== La manera manual ==
{{ToComplete}}

Installation manuelle sous Windows

2020-12-31T11:09:14Z

Jtraulle: /* Télécharger PHP */

[[en:Manual_installation_on_Windows]]


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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download
*Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>7.4.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
**Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
*Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

<br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

* À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

User:Jtraulle/DiscourseMigration

2020-10-20T11:33:56Z

Jtraulle: /* PostgreSQL tips and tricks */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

Note : to restore a save from a multisite install that is not the main (first) database, prepend the command by <code>RAILS_DB=dolibarrde</code> where <code>dolibarrde</code> is the name of the database :

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'RAILS_DB=dolibarrde bundle exec ruby script/discourse restore dolibarr-germany-forum-2020-08-16-163120-v20200814081437.sql.gz'
</syntaxhighlight>

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher rebuild data
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
cd /var/discourse
./launcher enter data
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User:Jtraulle/DiscourseMigration

2020-10-20T11:26:30Z

Jtraulle: typo

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

Note : to restore a save from a multisite install that is not the main (first) database, prepend the command by <code>RAILS_DB=dolibarrde</code> where <code>dolibarrde</code> is the name of the database :

<syntaxhighlight lang="bash">
/var/discourse/launcher enter web_only
su discourse -c 'RAILS_DB=dolibarrde bundle exec ruby script/discourse restore dolibarr-germany-forum-2020-08-16-163120-v20200814081437.sql.gz'
</syntaxhighlight>

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User talk:Eldy

2020-10-18T08:39:44Z

Jtraulle: Removed redirect to User talk:Laurent Destailleur (eldy)

== Discourse migration ==

Hello, I tried the subfolder thing : https://wiki.dolibarr.org/index.php/User_talk:Jtraulle/DiscourseMigration#Domain_requirement

== FEC is not an XML format ==

Hi Eldy

I think FEC is not an XML format.
Therefore I have changed your edit of 25 July 2020: <br>
https://wiki.dolibarr.org/index.php?title=Template:AccountingExpertExportExamples&diff=next&oldid=47998&diffmode=source

Please review my changes: <br>
https://wiki.dolibarr.org/index.php/Module_Comptabilit%C3%A9_en_Partie_Double#Export_FEC

[[User:Oliver|Oliver]] ([[User talk:Oliver|talk]]) 03:21, 15 August 2020 (CEST)

=> True. FEC is a txt format.

== Révocation modification User:Jtraulle/DiscourseMigration/Implementation ==

J'ai révoqué ta modification concernant la section permettant de reconstruire le container data du Discourse.

Contrairement à ce que l'on pourrait penser, il ne s'agit pas d'une coquille mais la commande est bien à exécuter deux fois comme indiqué dans la page mise en référence (il me semble que la première exécution permet la migration des des données d'une version majeure de PostgreSQL à l'autre et la seconde permet d'effectivement effectuer la mise à jour du container ou l'inverse mais il est bien nécessaire de l'exécuter deux fois ;) )

[[User:Jtraulle|Jtraulle]] ([[User talk:Jtraulle|talk]]) 10:39, 18 October 2020 (CEST)

User talk:Eldy

2020-10-18T08:36:21Z

Jtraulle: /* Révocation modification User:Jtraulle/DiscourseMigration/Implementation */ new section

#REDIRECT [[User talk:Laurent Destailleur (eldy)]]

== Discourse migration ==

Hello, I tried the subfolder thing : https://wiki.dolibarr.org/index.php/User_talk:Jtraulle/DiscourseMigration#Domain_requirement

== Révocation modification User:Jtraulle/DiscourseMigration/Implementation ==

J'ai révoqué ta modification concernant la section permettant de reconstruire le container data du Discourse.

Contrairement à ce que l'on pourrait penser, il ne s'agit pas d'une coquille mais la commande est bien à exécuter deux fois comme indiqué dans la page mise en référence (il me semble que la première exécution permet la migration des des données d'une version majeure de PostgreSQL à l'autre et la seconde permet d'effectivement effectuer la mise à jour du container ou l'inverse mais il est bien nécessaire de l'exécuter deux fois ;) )

Draft:Discourse Implementation and Exploitation

2020-10-18T08:31:17Z

Jtraulle: Reverted edits by Eldy (talk) to last revision by Jtraulle

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<source lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</source>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:50:14Z

Jtraulle:

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''Quelle est la différence entre certification et attestation ?'''

<blockquote>La certification est une procédure par laquelle une tierce partie, l’organisme certificateur, donne une assurance écrite qu’un système d’organisation, un processus, une personne, un produit ou un service est conforme à des exigences spécifiées dans une norme ou un référentiel. Elle est encadrée par le Code de la Consommation.

Elle ne doit pas être confondue avec l’attestation individuelle fournie par l’éditeur lui-même, qui est une déclaration par laquelle l’éditeur témoigne et s’engage à ce que le système d’encaissement qu’il fournit respecte les conditions d’inaltérabilité, de sécurisation, de conservation et d’archivage des données de transaction. Dans le cadre de la loi des finances pour 2016, la certification de produit par un organisme accrédité est obligatoire pour les assujettis à la TVA éditant leur propre système d’encaissement <ref>BOI-TVA-DECLA-30-10-30-20180704, point 375</ref>.

— ''LNE (Laboratoire National de métrologie et d'essais)'', Référentiel de certification des systèmes d’encaissement</blockquote>

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

= Notes et références =
<references/>

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:49:50Z

Jtraulle: /* Questions / Réponses (FAQ) */

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''Quelle est la différence entre certification et attestation ?'''

<blockquote>La certification est une procédure par laquelle une tierce partie, l’organisme certificateur, donne une assurance écrite qu’un système d’organisation, un processus, une personne, un produit ou un service est conforme à des exigences spécifiées dans une norme ou un référentiel. Elle est encadrée par le Code de la Consommation.

Elle ne doit pas être confondue avec l’attestation individuelle fournie par l’éditeur lui-même, qui est une déclaration par laquelle l’éditeur témoigne et s’engage à ce que le système d’encaissement qu’il fournit respecte les conditions d’inaltérabilité, de sécurisation, de conservation et d’archivage des données de transaction. Dans le cadre de la loi des finances pour 2016, la certification de produit par un organisme accrédité est obligatoire pour les assujettis à la TVA éditant leur propre système d’encaissement <ref>BOI-TVA-DECLA-30-10-30-20180704, point 375</ref>.

— ''LNE (Laboratoire National de métrologie et d'essais)'', Référentiel de certification des systèmes d’encaissement</blockquote>

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

== Notes et références ==
<references/>

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:48:02Z

Jtraulle: /* Questions / Réponses (FAQ) */

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''Quelle est la différence entre certification et attestation ?'''

<blockquote><poem>La certification est une procédure par laquelle une tierce partie, l’organisme certificateur, donne une assurance écrite qu’un système d’organisation, un processus, une personne, un produit ou un service est conforme à des exigences spécifiées dans une norme ou un référentiel. Elle est encadrée par le Code de la Consommation.

Elle ne doit pas être confondue avec l’attestation individuelle fournie par l’éditeur lui-même, qui est une déclaration par laquelle l’éditeur témoigne et s’engage à ce que le système d’encaissement qu’il fournit respecte les conditions d’inaltérabilité, de sécurisation, de conservation et d’archivage des données de transaction. Dans le cadre de la loi des finances pour 2016, la certification de produit par un organisme accrédité est obligatoire pour les assujettis à la TVA éditant leur propre système d’encaissement <ref>BOI-TVA-DECLA-30-10-30-20180704, point 375</ref>.</poem>

— LNE (Laboratoire National de métrologie et d'essais)|source='Référentiel de certification des systèmes d’encaissement</blockquote>

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

== Notes et références ==
{{Références}}

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:44:24Z

Jtraulle: /* Questions / Réponses (FAQ) */

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''Quelle est la différence entre certification et attestation ?'''

{{Quotation|text=<poem>La certification est une procédure par laquelle une tierce partie, l’organisme certificateur, donne une assurance écrite qu’un système d’organisation, un processus, une personne, un produit ou un service est conforme à des exigences spécifiées dans une norme ou un référentiel. Elle est encadrée par le Code de la Consommation.

Elle ne doit pas être confondue avec l’attestation individuelle fournie par l’éditeur lui-même, qui est une déclaration par laquelle l’éditeur témoigne et s’engage à ce que le système d’encaissement qu’il fournit respecte les conditions d’inaltérabilité, de sécurisation, de conservation et d’archivage des données de transaction. Dans le cadre de la loi des finances pour 2016, la certification de produit par un organisme accrédité est obligatoire pour les assujettis à la TVA éditant leur propre système d’encaissement <ref>BOI-TVA-DECLA-30-10-30-20180704, point 375</ref>.</poem>|sign=LNE (Laboratoire National de métrologie et d'essais)|source='Référentiel de certification des systèmes d’encaissement}}

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

== Notes et références ==
{{Références}}

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:35:29Z

Jtraulle:

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-09-01T06:33:07Z

Jtraulle:

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude ã la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur le point de logiciel comptable''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements (pour ceux qui n'ont pas le temps, aller directement au chapitre Conclusion ou aux FAQ):

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation '''OU''' par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation d'un Tiers).

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard (En fait, il l'est même depuis la v7 si vous n'utilisez pas de module POS).
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

Report board meeting 20200707 teleconf

2020-08-20T11:10:44Z

Jtraulle: Typo

{{TemplateAssoEn}}
{{TemplateAssoFr}}

=Title/Date/Location=

*Title: Foundation board meeting
*Date: 07/07/2020
*Location: Framatalk

=Presents=
Valid members of the board (subscription up to date), present:

*Philippe Grand
*Laurent Destailleur
*Maxime Kohlhaas
*Jean Heimburger
*Nicolas Zabouri
*Alexandre Spangaro
*Juanjo Menent

=Agenda=

==Topic==

*Dolistore : Search by Dolibarr versions and other tasks like a feature to explain why a module was disabled on DoliStore (6 tasks) Test can be done on https://dev.dolistore.com

Migration was planned the 30th of june 2020.
Migration not done due to technical issues. New date to deploy this development in production is 31st of july 2020

*Task done by Laurent during past month (access not public):

https://admin.dolibarr.org/projet/tasks/time.php?projectid=1&withproject=1&search_month=6&search_year=2020&search_user=2

*Dolibarr Promotional Video

6 first video delivered (They are online on the youtube channel of Dolibarr) and 3 in french, 3 in spanish and 2 in german
Go for 6 more in english, 3 more in french and spanish.
Waiting for feedbacks on videos 2 and 3 for DE language, J. Heimburger will ask about it
Next videos to be done are on customer orders, contracts, customer invoices, stock, supplier orders, supplier invoices
Summary of situation: https://docs.google.com/spreadsheets/d/1hgF9TGbgk0hqLwLwq26f9ZS9dZq0hY-rDcucQv1kyPU/edit#gid=0
Story board are on https://wiki.dolibarr.org/index.php/Draft:Video_Presentation_(Dolibarr_features)

*Ask about hacking platform to test Dolibarr security and reward with a bounty

Cost proposal is 1500 € / year to subscribe to the platform yeswehack
L. Destailleur will explore other platform

*Building a module to organize events

Specifications of module to build are available here: https://wiki.dolibarr.org/index.php/Draft:Conferences_and_Presentations_Dolibarr

*Negotiate with Stripe about % commission

Philippe will call stripe to discuss '''=> TODO'''

*German forum may be migrated to discourse, and dolibarr.de can be done with new Dolibarr CMS

Waiting for Jean Heimburger and german contact
Migration of forum to discourse is planned by Jean Traullé (no date) '''=> TODO'''

*Preferred partners page on the website

L. Destailleur will create basic pages for each preferred partners on the website, by copying the wiki pages. Partners will send a specific text if they want. Update will be done manually in the foundation's Dolibarr.
A list of preferred partners will be added to the website
Communication will be done later

*To check Providers and Prefered Partners (Eleonet, Diciannove Soc Coop, PC NET)

Will be checked by passing on them for the new website page

*Proofreading of english website -

Wait 4runners proposal and maquettes

*MOOC

https://courses.dolibarr.org/
Quotation request send to https://admin.dolibarr.org/comm/action/card.php?id=9651
Laurent will develop and experiment a tools for use transifex to translate new course
'''=> Still TODO'''

*Advertising on facebook and Google

We will discuss in may to re-open campaign
To be done in september

*Idea of a Dolibarr Tour

Foundation will take 50 %, and 50% by company organisation with a limit of 800 euros HT for the foundation per event/date.
Date: Lyon 17 Juin (canceled due to covid19) - Report in october 2020
'''=> 01/10/2020, communication will be done shortly'''
Date: Nancy ??? ~ September - October 2020 Report in january 2021
Date: Valence ???
Date: Nantes, maybe with a Winter DEV CAMP - November 2020
'''=> Dolibarr Days instead of Dolibarr Tour ?'''

*BFM advertising

Very expensive...
This is an example: https://www.cnews.fr/videos/vie-numerique/2020-03-24/axonaut-revolutionne-la-gestion-des-petites-entreprises-939512

==Done Task==

*VAT fundation are now paid by month according french tax departement requirement

*New Dolibarr.org web site managed and powered by Dolibarr CMS (v12)

==Todo and Running Task==

*Add a label "Dolibarr Accounting Partner" => Need to define what is it

*Approve the moral report and approve the fiscal report and new office team :

https://admin.dolibarr.org/public/opensurvey/studs.php?sondage=256l4dysk4lc2nhx

*How to organize community delegation for communcation

*Devcamp

5-6-7 june 2020 in Valence (France) => Delayed
2021 in Bordeaux (France)
November 2020 in Nantes (West Coast - France)

==Tasks to subcontract==

*Develop a module to organize a congress => from module "event" (replacing object event with project) ?:Specification to write

*Develop a module to follow preferred partner: Specification to write

*Community management - Subscription to https://www.relations-publiques.pro/ ? Someone know the same in english ?

*A template platform.sh for Dolibarr ERP CRM like for Drupal (https://github.com/platformsh-templates/drupal8)

Installation - Mise à jour

2020-08-17T16:49:55Z

Jtraulle: /* Installer Dolibarr - Procédure d'installation */

[[en:Installation_-_Upgrade]]
[[es:Instalación_-_Actualización]]
[[zh:安装_-_升级]]


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

Les procédures suivantes décrivent comment installer ou mettre à jour Dolibarr.

=Installer Dolibarr - Procédure d'installation=
Ce chapitre décrit les différentes méthodes possibles (des plus simples, aux manuelles) pour une première installation. Voir plus loin pour la mises à jour.

==Sur votre poste/serveur dédié==
===[[File:Logo_windows.png]] En manuel ou avec DoliWamp ===
- '''Prérequis''': Windows

- '''Niveau''': Débutant

Si vous maîtrisez l'installation d'un serveur Web Apache, de PHP et MySQL, la section [[Installation - Mise à jour#Avec Dolibarr (package standard .zip ou sources Git)|Avec Dolibarr (package standard .zip ou sources Git)]] est plus appropriée.

Si vous avez du temps et que vous souhaitez apprendre à installer un serveur Web Apache, PHP et MariaDB, consultez la page [[Installation manuelle sous Windows]] pour des instructions pas à pas.

Pour les moins expérimentés qui sont sous Windows, il existe une distribution Dolibarr nommée '''DoliWamp''' qui permet de faire une installation Dolibarr sous Windows avec tous ses prérequis (Apache, Mysql, PHP) sans connaissance informatiques. Voici comment l'installer:

*Récupérez la version de Dolibarr pour Windows.

Pour cela, voir le site {{TemplateURLToDownloadDoliWamp}}

*Lancer le .exe téléchargé et suivez les instructions.

===[[File:Apple logo black.svg|35x35px]] Avec MAMP (pour macOS / MAC OS X)===
- '''Prérequis''' : Mac OS X / macOS 10.10 ou supérieur

- '''Niveau''' : Intermédiaire

Référez vous à la page [[Installation sur MacOSX]].

===[[File:Logo_ubuntu.png]] Avec DoliDeb (package Debian / Ubuntu .deb)===
- '''Prerequis''': Linux Debian, Ubuntu, ...

- '''Niveau''' : Débutant

Cette procédure fonctionne uniquement pour les utilisateurs Linux Debian, Ubuntu et dérivés et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliDeb. DoliDeb est un package de Dolibarr spécialisé pour la distribution Debian ou Ubuntu. Ce package vous permet d'installer Dolibarr sous Ubuntu ou Debian (ou dérivé) avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.

*La procédure pour installer DoliDeb est décrite sur la page [[Dolibarr pour Ubuntu ou Debian]].

===[[File:Logo_rpm.png|40px]] Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)===
- '''Prerequis''' : Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse (peut également fonctioner pour toute distribution Linux à rpm)

- '''Niveau''' : Débutant

Cette procédure fonctionne uniquement pour les utilisateurs Linux d'une distribution gérant les packages rpm et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre suivant '''Avec Dolibarr (package standard zip)''' sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliRpm. DoliRpm est un package de Dolibarr spécialisé pour la distribution Fedora, Redhat, Mandriva, Mageia ou OpenSuse. Ce package vous permet d'installer Dolibarr sous ces OS avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.

*La procédure pour installer DoliRpm est décrite sur la page [[Dolibarr pour Redhat ou Fedora (package rpm)]] ou [[Dolibarr pour Mandriva ou Mageia (package rpm)]] ou [[Dolibarr pour OpenSuse (package rpm)]].

===[[File:Gnu.png]] Avec Dolibarr (package standard .zip ou sources Git)===
====Prérequis====
Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels, et le login/mot de passe d'accès (à une nouvelle base ou au serveur) est connu.

- '''Niveau''' : Un peu de connaissances informatiques en administration Web.

Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, ...) mais elle est valable avec d'autres systèmes moyennant une adaptation des chemins à ceux de votre OS.

Elle est applicable pour toute version de Dolibarr >= 2.0.0

Pour des instructions spécifiques à une installation sous Windows, vous pouvez consulter la page [[Installation manuelle sous Windows]].

*Vérifiez que vous avez bien Apache, PHP {{PHPMinVersion}} et un serveur de base de données (MySQL {{MySqlMinVersion}} ou PostgreSQL) d'installés (consulter pour cela la liste des packages installés sur votre machine grâce au gestionnaire de mise à jour de package de votre distribution).

*Vérifiez que l'utilisateur root ou admin principal pour le serveur de base de donnée est connu et fonctionne correctement. Si cet utilisateur root ou admin est inconnu car pas encore défini, lisez le chapitre qui suit. Sinon vous pouvez passez au point suivant:

====MySql ou MariaDB====
Pour les utilisateurs Linux utilisant MySql ou MariaDB, si vous venez juste d'installer la base de donnée, le login administrateur est '''root'''. Vous devez exécuter la commande suivante pour initialiser le mot de passe:
<source lang="bash">
mysql
</source>
Une fois dans l'interface Mysql, taper la commande de modification du mot de passe de root:
<source lang="sql">
grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
</source>
Puis entrée et pour quitter \q

Pour vérifier que l'accès avec ce couple user/mot de passe fonctionne, lancer la commande
<source lang="bash">
mysql -u root -p
</source>
Et taper votre mot de passe ''newrootpass'' suivi de \q pour quitter la sessions si la connexion a réussie.

====Postgresql====
Pour les utilisateurs Linux utilisant Postgresql, si vous venez juste d'installer la base de donnée PostgreSQL, vous devez d'abord créer un utilisateur administrateur et son mot de passe. Pour cela, ajouter la ligne suivante dans le fichier '''/etc/postgresql/x.x/main/pg_hba.conf''' (remplacer x.x avec votre version de postgres)
<source lang="ini">
local all dolibarrowner md5
</source>
De plus, mettez en commentaire la ligne
<source lang="ini">
#local all all ident
</source>
qui impose que le compte système utilisé pour accéder à la base (ce sera le compte sous lequel tourne l'application web), ait le même nom que le compte dans la base (ce n'est jamais le cas).

Ensuite, lancer la commande sous un shell root
<source lang="bash">
sudo -s -u postgres
createuser dolibarrowner
psql -d template1 -c "alter user dolibarrowner with password 'dolibarrownerpass'"
exit
psql
create database databasename;
grant all privileges on database databasename to dolibarrowner;
ALTER DATABASE databasename OWNER TO dolibarrowner;
\q
sudo /etc/init.d/postgresql restart
</source>
Vous pouvez tester la connexion pour l'utilisateur crée avec la commande
<source lang="bash">
psql -h localhost -d postgres -U dolibarrowner -W
</source>
Et entrez le mot de passe ''dolibarrownerpass'' et \q pour quitter la session si la connexion est ok.
====Copie des fichiers====

*Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine défini pour votre serveur web)

#Pour Debian et les familles Ubuntu, il s'agit en général de: /var/www
#Pour Mandriva, Mageia, RedHat, Fedora: /var/www/html
#Pour Suse: /srv/www/htdocs

<source lang="bash">
$ cd /var/www
</source>

*Récupérez l'application

=====Avec l'archive=====
Si vous partez du fichier dolibarr.zip, récupérez le fichier et décompressez l'archive de l'application

<source lang="bash">
$ wget http://www.dolibarr.org/files/dolibarr.zip
$ unzip dolibarr.zip
</source>

Renommez le répertoire dolibarr-x.y.z en dolibarr afin d'avoir un nom de répertoire indépendant de la version (où x.y.z correspond à la version source)
<source lang="bash">
$ mv dolibarr-x.y.z dolibarr
</source>

=====Avec les sources Git=====
Si vous partez des sources Git, récupérer les sources par

<source lang="bash">
$ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr
</source>

'''X.Y''' est la version à installer(Par exemple 9.0, 11.0, ...). Il est possible de remplacer '''X.Y''' par '''develop''' pour récupérer la version en cours de développement.

====Gestion des droits====
Modifiez les permissions et propriétaires du répertoire 'dolibarr' pour être sur que tous les fichiers soient en lecture pour l'utilisateur sur lequel tourne le serveur (on supposera qu'il s'agit de l'utilisateur 'www-data' pour debian ou ubuntu, 'apache' pour Redhat, Mandriva, Mageia, Fedora)
<source lang="bash">
$ chmod -R 755 /var/www/dolibarr
$ chown -R www-data.www-data /var/www/dolibarr
ou
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache.apache /var/www/html/dolibarr
</source>

====Fichier de configuration====
En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et attribuez-lui comme propriétaire du fichier, l'utilisateur du serveur web (exemple www-data sur debian, nobody sur une vieille RedHat, apache sur une autre version ...). Ceci est requis car le serveur web a besoin d'écrire dans ce fichier lors de l'installation.
<source lang="bash">
$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php
</source>
====SELinux sur Fedora====
Sur Fedora, comme SELinux est activé en général, il est aussi conseillé de lancer les commandes pour rendre le répertoire 'dolibarr' accepté par l'environnement SELinux (an absence de commande, vous devriez recevoir des nombreuses alertes d'anomalies) :
<source lang="bash">
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'
</source>

====Répertoire de documents====
Toujours en root, créez le répertoire qui servira aux documents générés ou stockés par Dolibarr (factures pdf, images, ...), et attribuez lui comme propriétaire, l'utilisateur du serveur web (exemple www-data sur Debian, nobody sur une vieille RedHat, apache sur une Mandriva, Mageia ou une RedHat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire. Il faut choisir un répertoire en dehors de la racine du site web. Par exemple "/var/lib/dolibarr/documents"
<source lang="bash">
$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents
</source>

====Installation====

*Pointez votre navigateur sur la page principale

<source lang="ini">
http://127.0.0.1/dolibarr/htdocs/
</source>

*Suivez les instructions de l'installation

*Pour des raisons de sécurité nous vous conseillons, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire dédiés aux documents, que seul root doit avoir le droit d'effacer. Ceci va verrouiller la procédure d'installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer pour les mises à jour).

<source lang="bash">
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
</source>

==Sur un hébergement mutualisé (à accès restreint)==
Certains hébergeurs proposaient une installation "en un clic" (OVH par exemple) : ils ont pour la plus part abandonné car trop questionnés pour des questions d'utilisation/administration : ils vous renverront maintenant vers ce wiki ou vers le forum dolibarr.

Procédure générique:

- '''Prerequis''':
Un serveur web Apache, PHP et une base de donnée (MySQL ou PostgreSQL) tourne correctement et le compte login/mot de passe (de la nouvelle base de donnée ou d'administration du serveur) est connu (sinon les demander à l'hébergeur).

- '''Niveau''': Utilisateurs avec quelques notions d'administration Web and base de donnée. Maitrise d'un outil de transfert de fichier (FTP, SFTP, ...) pour uploader les fichiers sur le serveur.

*Vérifiez que vous avez un serveur Web Apache, PHP et une base de donnée (MySQL ou PostGreSQL) qui fonctionne correctement.

[[File:warning.png]] Attention, la page de code du serveur PHP et de la base de donnée doivent être identique.

*Vérifiez que vous avez un compte root ou administrateur avec login/mot de passe connu et que ces comptes fonctionnent. Si inconnu, demandez les à votre hébergeur.

*Récupérer l'archive de la dernière version stable de Dolibarr et décompressez la localement..

*Uploadez tout le contenu du répertoire dans le répertoire racine de votre site web, par exemple par FTP en mode binaire. NB : seul le contenu de htdocs est nécessaire au fonctionnement de dolibarr)

*Créez un répertoire nommé "documents", dans cette racine, qui servira à sauver tous les documents générés et stockés par Dolibarr (factures PDF, images uploadées, ...). Le serveur web doit avoir les permissions d'écrire dedans. Vous pouvez attribuer ces permission avec un client FTP.

*Maintenant appeler la page principale index.php de dolibarr avec votre navigateur.

*Suivez les instructions pas à pas du processus d'installation.

*Pour des raisons de sécurité, il est recommandé, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire de Dolibarr. Ceci verrouillera l'appel au processus d'installation (il vous faudra supprimer ce fichier pour permettre les mise à jour). Si ceci n'est pas fait, Dolibarr vous affichera un warning lorsque vous êtes loggués comme administrateur.

==Sur un hébergeur SaaS ou Cloud==
Dolibarr est aussi disponible en version "pré-installée" chez de nombreux hébergeurs payants, fournissant des instances hébergées "prêtes à l'emploi".

Voir la page [[Solutions de Cloud]].

Dolibarr peut aussi être installé manuellement sur toute plateforme Cloud (gratuite ou payante) qui supporte le PHP et Mysql.

Voir la page [[Installation - Mise à jour]]

=Configuration=

==Premiers paramétrages==
Voir la page [[Premiers_paramétrages|Configuration/Paramétrage]].

==Configurer une connexion LDAP==
Si vous désirez utiliser LDAP: Voir [[Installer et configurer OpenLDAP]].

=Importer des données externes=
Pour cette opération, consulter la page [[Imports_de_masse]].

=Procédure de mise à jour=
Ce chapitre décrit le processus pour mettre à niveau une installation existante de Dolibarr d'une ancienne version vers une autre. Le processus est le même quel que soit la version depuis laquelle vous venez et la version vers laquelle vous allez, mais sera différent selon la distribution ou système d'exploitation utilisé pour votre première installation. Il est recommandé d'utiliser le même type de distribution pour la mise à jour que celle utilisée pour la première installation.

==Sauvegarde avant mise à jour==

Avant de faire une mise à jour, il est recommendé de faire un sauvegarde de la base de donnée mais aussi des documents, de cette façon même en cas de catastrophe vous ne perdrez pas vos précieuses données
https://wiki.dolibarr.org/index.php/Sauvegardes

==[[File:Logo_windows.png]] Avec DoliWamp (package Windows .exe)==

Si vous aviez installé la version de Dolibarr spécifique nommé DoliWamp (qui embarque le serveur Web, PHP et Mysql), la procédure à suivre est celle-ci (Dans tout autre cas, utilisez une des procédures des chapitres suivant):

*Télécharger la nouvelle version de DoliWamp.

*Lancer le .exe et laissez vous guider dans toutes les étapes de migration en cliquant suivant,suivant,... à chaque fois sans rien changer aux valeurs proposées par défaut.

*Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

==[[File:Logo_ubuntu.png]] Avec DoliDeb (package Debian / Ubuntu .deb)==
Si vous aviez installé Dolibarr via un packagage Debian-Ubuntu, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .deb.
Par exemple en suivant la procédure [[Dolibarr pour Ubuntu ou Debian]].

*Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

==[[File:Logo_rpm.png|40px]] Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)==
Si vous aviez installé Dolibarr via un packagage rpm, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .rpm.

*Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par exemple si vous avez installé Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

==[[File:Gnu.png]] Avec Dolibarr (package standard .zip)==

Cette procédure décrit la mise à jour de Dolibarr depuis une ancienne version vers une plus récente par la méthode manuelle, avec la distribution standard.

===Cas d'un hébergement où vous disposez d'un accès SSH===

*Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)

<source lang="bash">
$ cd /var/www
</source>

*Récupérez l'archive de la nouvelle version

<source lang="bash">
$ wget https://www.dolibarr.org/files/dolibarr.zip
</source>

*Décompressez l'archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

*Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers le répertoire où vous avez votre ancienne version de Dolibarr. Ceci a pour effet de remplacer les anciens fichiers par les nouveaux tout en conservant les fichiers qui vous sont spécifiques (comme le fichier conf.php ou encore vos modules complémentaires non officiels installés).
*Si vous déplacez ou renommez également le dossier de votre ancienne version de Dolibarr, pensez à modifier les chemins dans le fichier '''conf/conf.php''' (sinon vous risquez un fatal error: Cannot redeclare versiontostring)

<source lang="bash">
$ cp -r dolibarr-x.y.z/* dolibarr
</source>

*Vous pouvez alors supprimer le répertoire des fichiers sources

<source lang="bash">
$ rm -fr dolibarr-x.y.z
</source>

*Lancer Dolibarr dans votre navigateur habituel. Ceci fera apparaître l'assistant de migration: L'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs versions, garder le choix proposé de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installée (par si vous avez installé Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

ou

Lancer les 3 étapes de migration en ligne de commande:
<source lang="bash">
$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > output3.html
</source>
Note: z doit être "0" car seules les versions majeures ont un script de migration à exécuter.

Le code retour sera 0 en cas de succès, 1 en cas d'erreur (voir alors le fichier sortie output.html ou output2.html)

Note: Si vous avez un message signalant que le processus de mise à jour est verrouillé par un fichier install.lock, supprimer ce fichier (il est stocké dans le répertoire racine ou "documents" de Dolibarr) puis rafraîchissez la page.

*Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de verrouiller le répertoire d'installation en créant un fichier install.lock dans le répertoire de donnée de Dolibarr. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois connecté

<source lang="bash">
$ echo > documents/install.lock
$ chmod 444 documents/install.lock
</source>

===Cas d'un hébergement sans accès SSH (mutualisé)===
Cette procédure a été vérifiée pour les mises à jours mineures de v10.0, soit v10.0.n vers v10.0.m (m > n). Dolibarr est installé sur un hébergement mutualisé que l'on peut paramétrer par une interface dédiée et à laquelle on accède par ftp/sftp.

La mise à jour pourra prendre de 2 à 4 heures en fonction de votre bande passante internet. Dolibarr sera inaccessible à tous les utilisateurs entre les étapes 3 et 6.

Chaque étape doit être réalisée dans l'ordre. L'interruption du processus est possible entre chaque étape.

====Étape 1 - Téléchargement de la nouvelle version====
Téléchargez l’archive de la nouvelle version sur votre disque local.

Décompressez l’archive de la nouvelle version sur le disque local.

====Étape 2 - Sauvegarde de votre installation actuelle====
Se reporter à la page [[Sauvegardes]].

=====À partir de votre interface d'administration Dolibarr, sauvegardez :=====

*le répertoire <code>/documents</code>,
*la base de donnée.

Les fichiers de sauvegarde créés sont enregistrés dans votre répertoire /documents.

=====Récupération de la sauvegarde distante (obligatoire, le fichier conf.php sera réutilisé plus tard)=====
Copier les répertoires distants suivants sur votre disque local :

*<code>/documents</code>,
*<code>/htdocs/conf</code> (pour sauver <code>conf.php</code>).

====Étape 3 - Mettre le site hors ligne====
Rendez l'accès à Dolibarr impossible à vos utilisateurs. Dans la plupart des cas, votre hébergement permet de rendre votre site hors ligne. Il ne sera plus accessible via un navigateur. Vous aurez toujours accès aux répertoires via votre logiciel ftp.

====Étape 4 - Supprimez l'ancienne version sur le serveur====
Avec votre logiciel ftp, '''supprimez''' les fichiers et répertoires suivants :

*les fichiers à la racine de votre répertoire distant,
*install.lock dans le répertoire <code>/documents</code> (s'il existe),
*les répertoires :
**<code>/build</code>,
**<code>/dev</code>,
**<code>/doc</code>,
**<code>/htdocs</code>,
**<code>/scripts</code>.

Il ne doit plus rester que le répertoire <code>/documents</code> dans votre espace distant.

====Étape 5 - Envoyer les nouveaux fichiers sur le serveur distant====
Avec votre logiciel ftp, '''envoyer''' :

*tous les fichiers et répertoires de l'archive décompressée de la nouvelle version,
*<code>config.php</code> de votre sauvegarde dans <code>/htdocs/config</code>

====Étape 6 - Lancer la mise à jour====
Remettre votre site en ligne.

Avec votre navigateur, connectez-vous à votre instance Dolibarr avec l'URL que vous utilisez habituellement (généralement : ''<nowiki>https://monsite.re/htdocs/index.php</nowiki>''). Dolibarr détecte la présence de fichiers d'une nouvelle version. Il lance le processus de mise à jour.

À l'issue de ce processus, vous arrivez sur votre page de connexion habituelle. Vous noterez que le numéro de votre nouvelle version sera indiqué au-dessus du formulaire de connexion.

====Étape 7 - Opération de sécurité finale====
'''Envoyer''' <code>install.lock</code> depuis votre sauvegarde dans le répertoire <code>/documents</code>.

Manual installation on Windows

2020-08-17T11:07:36Z

Jtraulle:

[[fr:Installation_manuelle_sous_Windows]]


[[Category:Admin_en]]
{{TemplateDocUser}}

This page describes the installation of various components needed to run Dolibarr on a Windows environment.

The installation has been done on Windows 10 but should be functional for earlier versions of Windows - some screenshots just won't fit.

If you are a beginner, please note that the section [[Installation - Upgrade#With DoliWamp .28Windows .exe package.29|Installation - Update With DoliWamp (Windows .exe package)]] also discusses automated installation with DoliWamp.

The interest to install by yourself the different "Server" components needed for Dolibarr to work properly is the possibility to choose newer versions than those proposed by the DoliWamp installer.

It is also an excellent way to understand how it works and to deepen your knowledge about deployment and maintenance of a Dolibarr instance.

This documentation page has been written with the goal to be understandable to the largest number of people (whatever the computer level). Some precisions could appear as trivial for some people but will certainly be useful for others. If you are a (great) beginner, don't try to go fast and take the time to read the different sections of the page carefully (allow a big half-day for implementation).

<br />
In the following page, it has been tried as much as possible to explain the different actions you are going to perform (the aim being to understand and not to copy/paste or mechanically apply instructions). In order to easily distinguish the explanations from the actions to be performed, please note that all the actions to be performed are preceded by a bullet (•).

==Dolibarr Architecture==

Dolibarr is a Web software of type "''Client/Server''.

So it requires a '''Web Server'' with scripting language '' PHP'' and a '' Relational Database Management System'' to work. [[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Dolibarr Client/Server Architecture|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />

===Functioning===
On the "'''Client'''" side, you use a '''Internet browser''' (Firefox, Chrome, Opera, Internet Explorer, etc.) to access the Dolibarr interface by typing the address of the '''Web Server'''.

As soon as you type address to which '''Web Server''' answers (for example http://localhost/dolibarr), it will try to display main page of sub directory '''Dolibarr''' (according to Web Server configuration, main page of a directory - also called index page - can be for example <code>index.html</code>, <code>index.htm</code> or <code>index.php</code>).

Generally, by default, the '''Web Server''' will be configured to recognize only <code>index.html</code> files as index files but we will see together how to add <code>index.php</code> files.

The files <code>.php</code> being script files written in the PHP language, they will not be directly understandable by the '''browser''' of the "'''Client'''" which is only able to display HTML.

So we will have to tell the '''Web Server''' that when it encounters a file with the extension <code>.php</code>, it will have to use its module <code>mod_php</code> to interpret (or convert if you prefer) the PHP code into HTML code before sending it back to the "'''Client'''" (i.e. the browser).

Finally, we also need to install a '''Relational Database Management System''', here MariaDB to store Dolibarr data (it's Dolibarr PHP scripts that will interact with the <abbr title="Relational Database Management System">RDBMS</abbr> to write or read data from it).

==Installing and configuring MariaDB==
First we will install the MariaDB database server.

===Download MariaDB===

*Go to [https://downloads.mariadb.org/ the MariaDB download site] and click on the green button '''Download xx.x.x.xx Stable now!''' (normally the second green button on the page).
*In the right column, to filter the available files :
**Check the box '''Windows''' in the '''Operating System,''' section.
**in the '''Package Type''' section, tick '''MSI Package'''.
**In the '''CPU''' section, check '''32-bit''' or '''64-bit''' depending on your operating system (if you do not know, refer to the Appendix [[#How_do_I_know_if_my_computer_is_running_32-bit_or_64-bit_version_of_Windows.3F|How do I know if my computer runs the 32-bit or 64-bit version of Windows ?]]).
*Click on the link to download the only file now displayed in the list.

===Install MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Welcome to the installation wizard, click '''Next'''.
File:MariaDB Install 2.png|Check the box '''I accept the terms in the License Agreement''' to accept the terms of the license agreement then click '''Next'''.
File:MariaDB Install 3.png|This page allows you to customize the components to be installed. By default, all components are selected to be installed. Click on '''Next'''.
File:MariaDB Install 4.png|In this step, the installer asks you to choose a password for the database administrator. Choose a strong password that you will remember then enter it in the fields '''New root password''' and '''Confirm'''. Also check the box '''Use UTF8 as default server's character set''' then click '''Next'''.
File:MariaDB Install 5.png|In this step, the installer proposes to customize the port on which the database server will be available and allows to create a Windows Service allowing the automatic start of the server when the computer is started. Leave all the default choices and click '''Next'''. If port 3306 is already in use, read the appendix [[Manual_installation_on_Windows#What are "Listening Ports" and how do I know if a program already occupies a specific port? |What are "Listening Ports" and how do I know if a program already occupies a specific port?]] for more information.
File:MariaDB Install 6.png|his page allows you - if you wish - to send anonymous information about your use to the MariaDB designers (choose, then click '''Next''').
File:MariaDB Install 7.png|Click '''Install''' to start the installation.
File:MariaDB Install 8.png|The wizard installs the database server files, creates the associated Windows service and starts it.
File:MariaDB Install 9.png|The installation is complete and the MariaDB database server is running. Click '''Finish''' to exit the installation wizard.
</gallery>At this level, '''MariaDB''' is now installed and started. As a Windows "'''Service'''" has been created, the '''<abbr title="Relational Database Management System">RDBMS</abbr>''' will be automatically started at each (re)startup of the computer.

==Installing and Configuring PHP==
<br />

===Download PHP===

*Please visit https://windows.php.net/download
*In the list of proposed downloads, take the latest '''Thread Safe''' version of PHP corresponding to your architecture ('''x64''' if your system is 64 bits or '''x86''' if your system is 32 bits).
** This is normally the second proposed download ('''<u>Warning !</u> Be careful to download the ''Thread Safe'' version and NOT ''<u>No</u> Thread Safe'''''').
*Once you have found the right version, download the file by clicking on the link '''<u>Zip</u>'''.

<br />

===Extract the archive to install PHP===
*Once downloaded, right click on the archive and select '''Extract all...'''.
*Indicate <code>C:\php</code> as the destination path and click '''Extract'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configure PHP===
Now that PHP is uncompressed in the right place, we'll configure some settings.

PHP is delivered with '''extensions''' and Dolibarr needs that some of these extensions are enabled (they are not enabled by default).
<br />

====Enable Display of Filename Extensions====
*In the Windows '''File Explorer''', click on the '''View''' tab and check the '''File Name Extensions''' checkbox in the '''Show/Hide''' group.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Enable Display of '''File Name Extensions'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Create PHP configuration file from template====
To customize your PHP installation, you will have to modify the php configuration file (the file <code>php.ini</code>).

*Go to the folder where you unpacked PHP (<code>C:\php</code>) using the <nowiki/> '''File Explorer''' Windows > '''Local Disk (C: )''' > '''php''' (if you had checked the '''Show extracted folders when done''' box when extracting the archive, the Windows '''File Explorer''' should already be open in the right place).

In this folder containing the PHP files, you will find two configuration files "template" <code>php.ini-development</code> and <code>php.ini-production</code>.

*Make a copy (right click, '''Copy''') of the file <code>php.ini-production</code> and paste it in the same directory (right click, '''Paste''').

*Rename the copied file (<code>php - Copy.ini-production</code>) to <code>php.ini</code> (right click, '''Rename''' on the file).

When validating the new filename, Windows will warn you following the modification of the file extension (you must answer '''Yes''' to this question to validate the renaming of the file).
[[File:Avertissement renommage.png|none|frame|Windows warning when changing file extension.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activate PHP extensions needed for Dolibarr====
Double-click on the file <code>php.ini</code> to open it in '''Notepad''' Windows and thus be able to modify it.

Scroll through the file to find the section starting with <code>Dynamic Extensions</code> framed by <code>;</code> (about halfway through the file) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>In this section, you will need to remove the <code>;</code> in front of some of the extensions to load them (change for example <code>;extension=gd2</code> to <code>extension=gd2</code>).

Remove the <code>;</code> in front of the lines <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
<br />

====Modify some other PHP parameters====
<u>Tip :</u> To easily find a parameter in the file <code>php.ini</code>, you can use the '''Search''' function of the '''Notepad''' Windows (menu '''Edit''' > '''Search''' or <kbd>Ctrl</kbd> + <kbd>F</kbd>). Enter your search then click on '''Next'''. Depending on your position in the file, feel free to reverse the direction of the search by selecting the option '''Top''' instead of '''Bottom''' in the frame '''Direction''' then click again on next to search in the opposite direction of the file.
[[File:Recherche Bloc-notes Windows.png|none|frame|The '''Search''' dialog box allows you to search a text in the file.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />

=====Set the time zone=====
Below the section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Under the sub-section <code>[Date]</code>, replace the line <code>;date.timezone =</code> with <code>date.timezone = Europe/Paris</code> (don't forget to remove the <code>;</code> at the beginning of the line).

=====Increase the size of files that can be uploaded=====
By default, files that can be uploaded on server through button '''Browse...''' of Dolibarr forms (PDF bank statements, supplier invoices, etc.) are limited to a size of 2M.

If you want, you can increase this limit by modifying these lines :

*replace line <code>upload_max_filesize = 2M</code> by <code>upload_max_filesize = 16M</code> for example ;
*if you choose a value greater than 8M for <code>upload_max_filesize</code>, you will also need to replace <code>post_max_size = 8M</code> by <code>post_max_size = 16M</code>.

Save the file ('''File''' > '''Save''' or <kbd>Ctrl</kbd> + <kbd>S</kbd>) and close it.

We have now configured PHP.
<br />

==Installing and configuring Apache2==

===Download Apache2===

*Go to https://www.apachelounge.com/download/
*Download the file corresponding to the architecture of your operating system by clicking on the link (Win64 for 64 bits or Win32 for 32 bits).
<br />

===Extract the archive to install Apache2===
Unlike installing PHP, we will proceed slightly differently for decompressing the Apache2 archive.

Instead of extracting the entire archive, we will only extract the folder <code>Apache24</code>.

*To do this, start by double-clicking on the archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> to open it in the Windows '''File Explorer'''.
*Open the Windows File Explorer again and go to the Local Disk (C:).
*Drag the folder '''Apache24''' from the archive to the '''Local Disk (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Decompress Apache2 by dragging the '''Apache24''' folder to the '''Local Disk (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

This is followed by a copy of files (longer this time than for PHP) corresponding to the decompression of the archive in the '''Local Disk (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copy files from the '''Apache2''' archive to the '''Local Disk (C:)''']]

===Configure Apache2===
Now that '''Apache2''' is uncompressed, we will need to change some parameters in its configuration file.

*With the Windows '''File Explorer''', go to the '''Local Disk (C:)''' and then to the '''Apache24''' directory. Finally, go to the '''conf''' directory.
*Double-click on the file '''<code>httpd.conf</code>''' to open the file with the '''Notepad''' Windows and thus modify the configuration file of '''Apache2'''.

====Type the hostname of the Web Server====

*Search for the line <code>#ServerName www.example.com:80</code> and replace it with <code>ServerName localhost:80</code>.

====Treat the files <code>index.php</code> as index files====

* Look for the block
<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>and replace it by<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>
So when we access a directory, '''Apache2''' will first look for a <code>index.php</code> file before looking for a <code>index.html</code> file.

====Interpreting <code>*.php</code> files====
You remember, at the beginning, in the introductory section about Dolibarr architecture, I told you that browsers (Firefox, Chrome, Internet Explorer, etc.) that we use can understand and display only Web pages written in HTML language. So we must tell '''Apache2''' to interpret (convert) files <code>*.php</code> into HTML code understandable by browsers.

*At the very end of the file <code>httpd.conf</code>, skip a line and paste the following block of code to tell '''Apache2''' to interpret the files <code>*.php</code> :
<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*This will tell '''Apache2''' to use the <code>php7_module</code> provided with PHP that we installed earlier to interpret the <code>*.php</code> files.

*Save the file <code>httpd.conf</code> ('''File''' > '''Save''' or <kbd>Ctrl</kbd> + <kbd>S</kbd>) and close it.

===Copy the files needed for the PHP extensions <code>intl</code> and <code>curl</code> into the <code>bin/</code> directory of Apache2===
PHP's <code>intl</code> extension is responsible for the internationalization (translation management) functions of the software that uses it.
The PHP extension <code>curl</code> allows to make requests (contact) to external servers.

Dolibarr requires extensions <code>intl</code> and <code>curl</code> and these extensions need some libraries (function files) to work.

These libraries are provided with PHP, but since we use <code>php7_module</code> with '''Apache2''', we need to copy these files from PHP directory to <code>bin/</code> directory of '''Apache2''' so that extensions <code>intl</code> and <code>curl</code> can work properly.

*With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then to the '''php''' directory (<code>C:\php</code>).
*Select the files <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> and <code>libssh2.dll</code> by clicking on the first file, then while holding the Ctrl key on your keyboard, select the other files by clicking on them.
*Copy the files (right click, then '''Copy''' or Ctrl + C).
*With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then in the directory '''Apache24''' and then in the sub directory '''bin''' (<code>C:\Apache24\bin</code>).
*Paste the files (right click, then '''Copy''' or Ctrl + V).
<br />

===Create and start the Windows "Service" to automatically launch Apache2===
In the first part of this documentation, when we installed the <abbr title="Relational Database Management System">RDBMS</abbr> MariaDB, remember, there was a page in the installation wizard that proposed to create a Windows "Service" and customize its name.

"Services" are very handy and allow you to automatically start a software when you (re)start your computer. Contrary to the startup folder, "Services" are executed even before opening a Windows user "Session".

We will therefore create a Windows "Service" to automatically start '''Apache2''' when the computer is (re)started.

* Next to the Windows button that opens the start menu, in the search box "'''Type here to search'''", click then type <code>cmd</code>. In the list of proposed options, choose '''Run as administrator''' then validate the '''User Account Control''' window.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Execute '''Command Prompt''' Windows as administrator|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>

[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Creating the Windows "Service" with the Windows '''Command Prompt''' running as administrator.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
The "Service" we just created hasn't started yet, so we need to start it for the first time (it will then be started automatically each time the computer is (re)started).

*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>

[[File:Démarrer le Service Apache2.4.png|none|frame|Starting the Windows "Service" '''Apache2.4''' with the Windows '''Command Prompt''' running as an Administrator]]

If the service doesn't start correctly, it's because your configuration file <code>httpd.conf</code> is invalid.

To determine the cause of your error if any, you can enter the following command in the Windows '''Command Prompt''' :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
This command tests the validity of your <code>httpd.conf</code> file and should return the line where the error is encountered.

In addition to common syntax errors due to carelessness, one of the most common errors is the absence of the file <code>C:\php\php7apache2_4.dll</code>. This file is indeed missing if you have downloaded the wrong version of PHP ('''<u>No</u>''' '''Thread Safe''') instead of the '''Thread Safe''' version. In this case, download the good archive ('''Thread Safe''') and perform the [[#Extract_the_archive_to_install_PHP]] part again.

Another problem that can be encountered is the impossibility to start '''Apache2''' because the port '''80''' is already used by another program. See the appendix [[#What_are_.22Listening_Ports.22_and_how_do_I_know_if_a_program_already_occupies_a_specific_port.3F|What are "Listening Ports" and how to know if a program already occupies a specific port?]] for instructions on how to proceed.

Once you have corrected any errors, try again to start the '''Apache2.4''' Service with the command mentioned above.

You can now close the Windows '''Command Prompt'''.

Apache2.4 is now installed as a Windows "Service" and started. The Apache2 "Web Server" will therefore be started automatically each time the computer is (re)started.

==Check that everything's working==
Before continuing (the installation of '''Dolibarr'''), let's take a moment to verify that our current installation works properly.

===Check if the <abbr title="Relational Database Management System">RDBMS</abbr> MariaDB works properly===

*Beside the Windows button to open the start menu, in the search box "'''Type here to search'''", click and then type <code>mysql client</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Run the software '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]].
The '''MySQL Client (MariaDB 10.4 (x64)''' software is launched.

This is a command prompt specific to your '''<abbr title="Relational Database Management System">RDBMS</abbr>''' '''MariaDB''' allowing you to execute database commands (in SQL language).

*Enter the password of the database administrator that you chose during the installation of '''MariaDB''' previously (in the fourth screen of the installer) then press Enter to validate the password.
*Enter the SQL statement <code>SHOW DATABASES;</code> to list the current databases then press Enter to validate the command.

'''MariaDB''' should answer you with the list of databases automatically created during installation: <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> and <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|List of databases managed by the '''RDBMS''' '''MariaDB''' installed on our computer.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

This concludes our test of MariaDB's functionality.

We were indeed able to successfully connect to the <abbr title="Relational Database Management System">RDBMS</abbr> with the administrator password we had previously chosen and the execution of an SQL statement ( <code>SHOW DATABASES;</code> ) worked correctly.

You can now close the software '''MySQL Client (MariaDB 10.4 (x64)'''.

===Check if Apache2 works properly===

*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and enter the address <code>http://localhost</code> in the address bar then validate with '''Enter'''.

If you have correctly installed '''Apache2''', the "Web Server" should answer you a nice <code>It works!</code>.
[[File:It works! Apache2.png|none|frame|The Web Server default page '''Apache2''.|link=Special:FilePath/It_works!_Apache2.png]]

This concludes our '''Apache2''' test.

We were indeed able to get a response from the Web Server '''Apache2''' (in this case <code>It works!</code>) which proves that it was correctly installed and started.

You can now close your Web Browser.
<br />

===Check if PHP works properly===
Concerning the PHP part, we have two things to check.

#The files <code>index.php</code> are correctly recognized when accessing a directory.
#The files <code>*.php</code> are correctly interpreted by PHP and return HTML.

*With the Windows '''File Explorer''', go to the '''Local Disk (C:)''' then in the directory '''Apache24'''. Finally, go to the '''htdocs''' directory (<code>C:\Apache24\htdocs</code>).

You will find in this folder a file <code>index.html</code>. This is the famous file which contains <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> is the HTML answer which was sent back to us '''Apache2''' when we accessed the server by typing the address <code>http://localhost</code>.

*In the folder '''htdocs''' (<code>C:\Apache24\htdocs</code>), create a new folder <code> test</code> (right click, '''New''' > '''Folder''').
*Double-click on the new folder <code>test</code> to enter it.
*Create a new file <code>index.php</code> (right click, '''New''' > '''Text Document''').
*Open the document with the Windows '''Notepad''' (right click, '''Open with''' > '''Notepad'''; if '''Notepad''' is not proposed, click on '''Choose another software''', then on '''More software''' and select '''Notepad''' in the list before validating with '''OK''').
*Enter the following '''PHP''' code in the file :<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>
*Save the file <code>index.php</code> ('''File''' > '''Save''' or <kbd>Ctrl</kbd> + <kbd>S</kbd>) and close it.

When PHP processes a file, it looks for the opening and closing tags ('''<code>?php</code>''' and '''<code>?</code>''') that delimit the code it must interpret. <code>?php</code> thus allows to indicate that we are going to write '''PHP''' code.

The function <code>[https://www.php.net/manual/en/function.phpinfo.php phpinfo]</code> displays a lot of information about the configuration of '''PHP''', which will allow us to check that '''PHP''' works and that we have activated the right extensions.

*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and this time enter the address <code>http://localhost/test</code> in the address bar then validate with '''Enter'''.

'''Apache2''' should return a page generated by '''PHP''' containing all the configuration information. If you scroll this page, you '''<u>should</u>''' see sections related to the extensions we loaded previously (including <code>curl</code>, <code>gd2</code>, <code>intl</code> and <code>mysqli</code>). If one of these sections is not displayed, it means that the extension is not loaded (so you forgot to remove a semicolon in front of an extension name when editing the <code>C:\php\php.ini</code> or you forgot to copy one of the files mentioned in [[Manual_installation_on_Windows#Copy the files needed for the PHP extensions intl and curl to the bin/ directory of Apache2|Copy the files needed for the PHP extensions <code>intl</code> and <code>curl</code> to the <code>bin/</code> directory of Apache2]]. Check and correct if necessary your omissions and then restart the Service '''Apache2.4''' so that your changes are taken into account (see appendix [[Manual_installation_on_Windows#How to manage Windows "Services" ?|How to manage Windows "Services" ?]] to know how to restart an existing Service).

[[File:Phpinfo().png|border|none|thumb|750x750px|''Apache2'' returns the page with the configuration information generated by ''PHP''.]
<This concludes our test of ''PHP''.

We were indeed able to verify that '''PHP''' works correctly because it returns the information related to its current configuration.

Moreover, the files '''PHP''' <code>index.php</code> are well interpreted as index files because our file was well executed by typing <code>http://localhost/test</code> (we did not need to type <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*With the Windows '''File Explorer''', go to the '''Local Disk (C:)''' then to the '''Apache24''' directory. Finally, go to the '''htdocs''' directory (<code>C:\Apache24\htdocs</code>).
*Delete the folder <code> test</code> that we previously created.

You can now close the Windows File Explorer and your Web Browser.
<br />

==Dolibarr installation==
It's party time (get out the balloons and cotillions), the moment you've been waiting for so long has finally arrived! We will finally be able to install Dolibarr.

===Download Dolibarr===
*Please visit the SourceForge mirrors at https://sourceforge.net/projects/dolibarr/files/.
*Click on the folder '''Dolibarr ERP-CRM''', then on the last version number and click on the file with extension '''.zip''' to download it.

===Create folder <code>documents</code> of Dolibarr===
Dolibarr needs a folder <code>documents</code> in which it stores generated documents (Sales proposals, Orders, Invoices, Intervention sheets, Delivery notes) but also documents uploaded by user (Account statements, Supplier invoices, etc.).

For security reasons, it is preferable to create the folder <code>documents</code> outside the Web Server (for us '''Apache2''').

*With the Windows'''File Explorer''', go to the '''Local Disk (C:)'''.
*Create a new folder <code>dolibarr</code> then double click on it and create again a folder <code>documents</code>. So we get the directory <code>C:\dolibarr\documents</code>

===Extract Dolibarr archive===
To extract Dolibarr archive, we will proceed in a similar way as '''Apache2''' using drag and drop technique.

*With Windows File Explorer, go in '''Local disk (C:)''' then in directory '''Apache24'''. Finally, go to the '''htdocs''' directory (<code>C:\Apache24\htdocs</code>).
*Create the folder <code>dolibarr</code> then double click on it.
*Double-click then on the Dolibarr archive you just downloaded to open it in a new window of the Windows '''File explorer'''.
*Browse in the archive to folder <code>dolibarr-xx-x-x</code> then to folder <code>htdocs</code>.
*Select all the files in the folder <code>htdocs</code> by using the '''Select all''' button of the '''Select''' group of the '''Home''' tab of the '''Windows File Explorer''' (or by using the keyboard shortcut Ctrl + A).
*Drag the selected files to the folder <code>dolibarr</code> created previously (in the other window).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extract htdocs directory of Dolibarr archive in the <code>dolibarr</code> directory of Apache2 Web Server.]]

Because of the large number of files provided with Dolibarr and depending on the speed of your hard drive or SSD, decompression can take several minutes.

[[File:Décompression archive Dolibarr.png|none|frame|Decompression of Dolibarr archive to directory <code>dolibarr</code> of Apache2 Web Server.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

===Install Dolibarr===

*Start your favorite Web browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and enter the address <code>http://localhost/dolibarr</code> in the address bar then validate by '''Enter''' to start Dolibarr installation.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|This page allows you to change language (default language selected by default is automatically deduced from your browser language). Click on '''Next step ->'''.
File:Installation Dolibarr - Vérification des prérequis.png|This page checks prerequisites to install Dolibarr (including different PHP extensions needed). If you followed correctly information of this page, all checks should be validated. Click on '''Start''' button to continue installation.
File:Installation Dolibarr - Serveur Web.png|This page of installation allows you to define paths. Default values are correct except for '''Directory to contain generated documents (PDF, etc.)'''. Modify this value to indicate the directory we created previously (for reminder <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|On this same page, we will now fill information allowing installer to create Dolibarr database. Refer to section "Configure database" under the gallery for more information.
File:Installation Dolibarr - Création du fichier de configuration.png|Installer create configuration file containing all information you filled so far and save it on disk in <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. It also creates the user '''dolibarr''' in MariaDB and the database '''dolibarr'''. Click on '''Next step ->'''.
File:Installation Dolibarr - Création des tables.png|The installer now create all tables in the '''dolibarr''' database (this step can take several seconds, it's normal; be patient).
File:Installation Dolibarr - Validation de la création des tables.png|This page confirms the good installation of tables, functions and reference data in the '''dolibarr''' database. You can also choose to indicate that you just successfully installed Dolibarr to Dolibarr Association (thank you!). Click on '''Next step ->'''.
File:Installation Dolibarr - Création de l'administrateur.png|This last step allows you to create the Dolibarr user that will be used to identify you to access Dolibarr. Choose, again, a password different from previous ones (you should never reuse a password anyway) as well as your login. Click on '''Next step ->'''.
File:Installation Dolibarr - Fin de l'installation.png|It's finished ! Congratulations, you can click on '''Access Dolibarr (configuration space)''' to finish installation. Installer also recommends you to create a file <code>install.lock</code> (we will see how to proceed below).
</gallery>

====Configure the database====
To make the explanations simpler, I have numbered the different fields you need to modify.
<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>
0 - Check the box '''Create the database'''.

1 - Fill '''<code>dolibarr</code>''' as identifier (this user will be created in MariaDB by Dolibarr installer and will have '''<u>only</u>''' the authorization to access the newly created '''<code>dolibarr</code>''' database).

2 - Fill in a different password (that you have never used, and will be specific to the MariaDB user '''<code>dolibarr</code>''')

3 - Check '''Create owner or assign him rights to the database''' (this asks Dolibarr installer to create new MariaDB user named '''<code>dolibarr</code>''' that we filled if above with specified password).

4 - Enter '''<code>root</code>''' (this is the MariaDB user id of the database administrator with all rights).

5 - Enter the MariaDB password of the database administrator that you chose when you installed MariaDB (screen 4 of the installation).

<br />

====Terminate Dolibarr configuration====
<gallery widths="500" heights="340">
File:S'identifier.png|The Dolibarr login page.
File:Configuration Dolibarr post-installation.png|The Dolibarr '''Configuration''' page.
</gallery>
Now that Dolibarr is successfully installed, we must finish initial setup (it is about filling your company information and activating one or more modules to use).

*Fill your username and password and click '''Login'''.

You are automatically redirected to page '''Configuration''' of Dolibarr because initial setup is not finished.

*In left menu, under '''Configuration''', click on '''Company/Organization''' and fill information about your company then click on '''Save''' at the bottom of page.
*Always in the left menu, then click on '''Modules/Applications''' and activate the desired modules by clicking on the icon representing a switch at the end of the line.
<gallery widths="550" heights="340">
File:Informations société.png|The '''Company/Organisation''' page allows you to fill in the information of your company or organisation.
File:Activation module.png|The '''Modules/Applications''' page allows you to activate and deactivate the modules you want to use according to your needs.
</gallery>
We have now finished initial configuration of Dolibarr. Bravo !

*Click on '''My dashboard''' to display Dolibarr startup page.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|The page '''My dashboard''' of Dolibarr. It currently presents warnings because we didn't create a file <code>install.lock</code> and that Dolibarr configuration file (<code>conf.php</code>) is writable by Web Server.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

======Create file <code>install.lock</code>======
The file <code>install.lock</code> is important, since it prevents that anyone can restart Dolibarr installation by accessing <code>http://localhost/dolibarr/install</code>.

If you only use Dolibarr on your computer and that this one is not accessible from network (local or Internet), it is not necessarily necessary to create the file but it is a good habit to take because you may have to "open" your Dolibarr installation later.

*With Windows File Explorer, go in '''Local disk (C:)''' then in directory '''dolibarr'''. Finally, go to the directory '''documents''' (<code>C:\dolibarr\documents</code>).
*Create a file <code>install.lock</code> (right click then '''New''' > '''Text document''').
*In your Internet browser, click again on link '''My dashboard''' in left column of Dolibarr and see that first warning about missing file <code>install.lock</code> has disappeared.

======Restricting Web Server write access to the file <code>conf.php</code>======

* With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then to the directory '''Apache24'''. Go to the '''htdocs''' directory then to '''dolibarr''' and finally to '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Right click on the file <code>conf.php</code> and select the option '''Properties'''.
*In the dialog box '''Properties of: conf.php''', check the box '''Read only''' for the option '' 'Attributes'' then click '''OK'''.
*In your Internet Browser, click again on link '''My dashboard''' in left column of Dolibarr and see that second warning related to write accessibility to Web Server of file <code>conf.php</code> has disappeared.
*[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Enable attribute '''Read only''' for main configuration file <code>conf.php</code>of Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]].
<br />

==Appendix==

===What are "Listening Ports" and how do I know if a program already occupies a specific port? ===

====What's a "listening port"====
When you install a "'''Server'''" program, you must choose a port on which the program will be available and which will be used by the "'''Client'''" program to communicate with the "'''Server'''". The port is therefore the communication channel between the "'''Client'''" and the "'''Server'''" (remember the architecture diagram at the top of the page).

The default port used by the '''MariaDB''' Database Server is '''3306'''.

The default port used by the Web Server '''Apache2''' to communicate with the "Client" (your Internet Browser) is the port '''80'''.

If other programs already use either port '''3306''' or port '''80''', you will need to choose another port on which the Database Server '''MariaDB''' or the Web Server '''Apache2''' will be available.

====How do I know if a program is already occupying a specific port?====
If you try to install the Database Server '''MariaDB''' or the Windows "Service" of the Web Server '''Apache2''' on a port which is already occupied by another program, you will encounter an error.

To check which program is listening on which port, you can use the Windows '''Resource Monitor'''.

* Next to the Windows button to open the start menu, in the '''Type here to search''' box, click and type <code>resource monitor</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Resource Monitor''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Run the '''Resource Monitor''' software application of Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*In the '''Resource Monitor''', click on the '''Network''' tab.
*In the '''Listening Ports''' section, sort the column '''Port''' to be able to search more easily.
*In the '''Port''' column, search for the port you are interested in (for example '''80''' for the standard port of the Web Server '''Apache2''' or '''3306''' for the Database Server '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|A program "listen" already on port '''80''', it is '''httpd.exe''' (i.e. '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]

If you can't find a line for the port number you are looking for, then that's fine (this means that no program is listening on that port and therefore it is available).

If, on the other hand, you find a match, then a program is already listening on this port and you will have to choose another listening port when you install your server.

====Choose another port than the default 3306 for MariaDB====
On the fifth page of the '''MariaDB''' installer, enter another port in the box '''TCP port:''' (eg '''3308''' - but make sure the port you choose is not already in use using the technique specified above).

After you change port for '''MariaDB''', when you install Dolibarr, when you enter port in section '''Dolibarr database''', don't forget to enter the replacement port you chose instead of standard port '''3306'''.

====Choose another port than the default 80 for Apache2====
When customizing the '''Apache2''' configuration file, replace the line <code>ServerName localhost:80</code> by <code>ServerName localhost:<my_port></code> to specify another port (for example <code>ServerName localhost: 8080</code> to use port '''8080''' - but make sure the port you choose is not already in use by using the technique specified above). You will also need to replace the <code>80</code> of the <code>Listen 80</code> : line with the port number you choose.

After changing the listening port, you will need to specify the port in the addresses you type in your browser: for example <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. instead of <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

===How to manage Windows "Services"?===
We have seen in this documentation the creation of Windows "Services" allowing to start automatically the Database Management System '''MariaDB''' and the Web Server '''Apache2''' at the (re)startup of the computer.

Windows is delivered with a software allowing to manage graphically the "Services". It is thus possible to consult their status (started, stopped) and to act on them (start, stop, restart).

* Next to the Windows button allowing to open the start menu, in the search box "'''Type here to search'''", click then type <code>services</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Run the '''Services''' application of Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Find the Service for which you want to check the status or perform an action (start, stop, restart) in the list of Services that appears. For example, search for '''MariaDB''' or '''Apache2'''.

In the column '''Status''', you can check the current status of the Service (on the screenshot below, we see that the service '''Apache2.4''' is '''Running''', ie it is started).

*Right click on the Service to manage to display the context menu and then select the action to perform (Start, Stop or Restart).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Restart the '''Apache2.4''' service|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />

===How do I know if my computer is running 32-bit or 64-bit version of Windows?===

====Windows 10 and Windows 8.1====

#Select the button '''Start''',<span class="win-icon win-icon-WindowsLogo"></span> then '''Settings''' ><span class="win-icon win-icon-Settings"></span> '''System''' > <span class="win-icon win-icon-System"></span>'''About'''.
#<span class="win-icon win-icon-Error"></span> On the right, under '''Device Specifications''', see '''System Type'''.

====Windows 7====

#Select the button '''Start'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, right click on '''Computer''', then choose '''Properties'''.
#Under '''System''', see the type of system.

===Reminder of the different installation directories used===
{| class="wikitable"
|+
!Component/Software
!Installation path
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (program)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (datas)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Warning!</u>''' The files present in the directory <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> are the physical files of the database. Saving these files will only allow you to reuse them with the same version of the database. A more robust way to perform a database backup is to perform an export using for example the tool '''<code>mysqldump</code>'''.
</div>

===How to save my manual installation===

In Dolibarr, three things are important to save :

*The database (MariaDB), which contains all your entries (business proposal lines, invoices, etc.).
*the folder <code>documents</code> which contains PDF documents generated by Dolibarr (commercial proposals, invoices, etc.) as well as uploaded ones.
*the configuration file <code>conf/config.php</code> that contains connection parameters to your database and other configuration information.

====Backup the database====

There are several ways to back up the database.

=====Directly from Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Backup of the database from Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Once connected to Dolibarr,

*Select the menu '''Backup''' in the '''Administrative Tools''',
*In '''Compression''', select - for simplicity - '''None''' (Windows does not include a standard utility to decompress Gzip files but you can activate it if you have for example 7-Zip, PeaZip, WinZip or WinRar).
*Click on '''Generate Backup'''.
<br />
[[File:Télécharger la sauvegarde de base de données.png|Download database backup|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]
Once the backup has been generated, you can download it by clicking on the link of the file in the right section '''Existing database backup files'''.

=====Manually using the HeidiSQL graphics tool=====
During the installation of the Database Management System '''MariaDB''', the graphical tool HeidiSQL was also installed.

*Next to the Windows button to open the start menu, in the search box '''Type here to search''', click and type <code>heidisql</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''HeidiSQL''').
[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Run the '''HeidiSQL''' software|link=Special:FilePath/Démarrer_HeidiSQL.png]]

We will now define the connection to our Database Management System '''MariaDB''' using the connection information we have.

<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Click on '''Add'''.
File:Paramétrages session HeidiSQL.png|For '''User:''' put '''root''' ; for '''Password''', Enter the database administrator's password that you chose when you installed MariaDB (screen 4 of the installation wizard). In '''Data base''', click on the arrow to the right of the field and select '''dolibarr'''.
File:Renommer session HeidiSQL.png|Right-click on the item '''Unamed*''' then, in the pop-up menu, select '''Rename'''.
File:Renommer session HeidiSQL 2.png|Enter a more meaningful name for the session name. For example '''Dolibarr'''. Then, click '''Save'''. Then click '''Open'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporting the database with HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Right click on the database '''<code>dolibarr</code>''' and select '''Export database to SQL...'''
<br />

[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Set up the database export in '''HeidiSQL''' software|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

* Check the box '''Remove/DROP''' in the section '''Table(s):''' then, in '''File name:''' choose the path where you want to export the backup and the name of the file. If you followed all installation documentation, a good practice is to place export at the same place as when you realize it with Dolibarr interface (method of above paragraph): <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> will be replaced automatically by database name ('''<code>dolibarr</code>''') and <code>%date</code> by date and hour of export.
*Click on '''Export''' to launch the export.
<br />

=====Manually using the Windows Command Prompt=====

* Next to the Windows button to open the start menu, in the search box "'''Type here to search'''", click and type <code>mariadb</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Start the '''Command Prompt (MariaDB 10.4 (x64))''']]

Command prompt is launched; go to directory '''Dolibarr''' database backups (in our folder <code>documents</code>) :
<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>
Enter the following command to save the database where <code>dolibarr-2020-05-20-14-30.sql</code> will match the name of the exported file (you can of course put whatever you want) :
<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>
You will be prompted to enter the database administrator's password that you chose when you installed MariaDB (screen 4 of the installation wizard).

====Save the folder <code>documents</code> and the configuration file <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

=====Directly from Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

=====Manually using Windows File Explorer=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

====Restore a backup====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

=====Manually using the HeidiSQL graphics tool=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

=====Manually using the Windows Command Prompt=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ The writing of this section is not yet complete. Please come back later.
</div>

User:Jtraulle/DiscourseMigration

2020-08-16T22:07:19Z

Jtraulle: /* Restaure Discourse backup from command line */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
./launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

Note : to restore a save from a multisite install that is not the main (first) database, prepend the command by <code>RAILS_DB=dolibarrde</code> where <code>dolibarrde</code> is the name of the database :

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'RAILS_DB=dolibarrde bundle exec ruby script/discourse restore dolibarr-germany-forum-2020-08-16-163120-v20200814081437.sql.gz'
</syntaxhighlight>

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User:Jtraulle/DiscourseMigration

2020-08-16T20:20:41Z

Jtraulle: /* Execute migration script */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
./launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User:Jtraulle/DiscourseMigration

2020-08-16T20:12:02Z

Jtraulle: /* Execute migration script */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
./launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; cp /scripts/kunena3_dolibarr_de.rb /var/www/discourse/script/import_scripts/kunena3_dolibarr_de.rb; bundle exec ruby script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User:Jtraulle/DiscourseMigration

2020-08-16T19:52:19Z

Jtraulle: /* Execute migration script */

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
./launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4"
# Run import script
su discourse -c 'export IMPORT=1; bundle exec ruby script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

User:Jtraulle/DiscourseMigration

2020-08-16T19:51:55Z

Jtraulle: /* Execute migration script */ Après 20 minutes d'énervement ...

{{DISPLAYTITLE:Discourse Migration}}

This page gathers info about Discourse migration.

For the implementation, see [[User:Jtraulle/DiscourseMigration/Implementation]]

==Context (forum migration project genesis)==

Topic has been first discussed on the french speaking Dolibarr forum here : https://www.dolibarr.fr/forum/11-suggestionsnouvelles-fonctionnalites/64778-forum-quelle-solution-choisir

Topic has also been discussed on [[Report board meeting 20190730 teleconf]]

==Proposed skeleton==

Each newly created thread '''<u>MUST</u>''' be placed into a category.

Categories in '''bold''' are main categories.

Categories preceded of a bullet point are sub categories belonging to a main category.
<br />
{| class="wikitable mw-collapsible"
!Categories proposal
|-
|'''Annonces & actualités (verrouillé)'''

''Vous trouverez dans cette catégorie des annonces et actualités en lien avec le projet Dolibarr : nouvelles versions, évènements, mise à jour des outils communautaire du projet, etc.''
|-
|'''Installer mon Dolibarr'''
''Obtenir de l’aide sur l’installation de Dolibarr quelque soit votre système (GNU/Linux, macOS, Windows, système NAS), votre méthode d’installation (depuis les sources, DoliWamp, DoliDeb, DoliRpm) et votre environnement (serveur local, mutualisé, dédié, cloud).''
|-
|'''Utiliser mon Dolibarr'''
''Obtenir de l’aide sur l’utilisation des modules fournis avec Dolibarr, suggérer des nouvelles fonctionnalités ou signaler des anomalies.''<br />

*Modules GRC/GRF (Tiers, Contrats/Abonnements, Interventions, Commandes, Expéditions, Tickets)
*Modules GRH (Utilisateurs, Adhérents, Congés, Notes de frais)
*Modules PM (Produits, Services)
*Modules financiers (Facturation, Banque/Caisse, Dons, Comptabilité, Comptabilité avancée)
*Autres modules natifs (Projets/Travail collaboratif, GED, Outils multi-modules, etc.)
*Modules externes du DoliStore
*Retours d'expérience
|-
|'''Maintenir mon Dolibarr'''
''Obtenir de l’aide sur la mise à jour de Dolibarr vers une version plus récente, la migration d’une instance Dolibarr vers un nouveau serveur, les opérations de sauvegarde et de restauration (fichiers et base de données) et plus généralement, tout ce qui touche à la configuration et à la maintenance système de la machine hébergeant votre instance Dolibarr (cron, permissions, etc.).''
|-
|'''Développer pour Dolibarr'''
''Obtenir de l’aide concernant le développement de modules spécifiques ou thèmes pour Dolibarr mais également sur la façon d’utiliser les modules API REST et SOAP pour interconnecter Dolibarr avec une application externe.''
|-
|'''Discuter entre Dolibarriens'''
''Cet espace de discussion vous permet d’échanger avec les autres utilisateurs de Dolibarr sur des sujets sans lien avec Dolibarr.''
|}

Each newly created thread can also have '''''tags''''' regardless of its category.
{| class="wikitable"
|+Transversal tags proposal
!Tags type
!Tags proposal
|-
| rowspan="3" |Type of
thread
|Question
|-
|Suggestion
|-
|Anomalie
|-
| rowspan="8" |Code branch
or Version
|v10.x
|-
|v9.x
|-
|v8.x
|-
|v7.x
|-
|v6.x
|-
|v5.x
|-
|v4.x
|-
|v3.x
|}

An user will also have the ability to mark an answer of the thread as the '''solution'''.

This explains why there is no '''Résolu''' tag in the proposal.
<br />
<br />

===Proposed mapping between current and new skeleton===

Categories are in bold and sub-categories in italic.
{| class="wikitable mw-collapsible"
|+
!Current categories or sub-categories
!New proposed categories and sub-categories
|-
|'''Annonces et fonctionnement du forum'''
|'''Annonces & actualités (verrouillé)'''
|-
|'''Installation'''
| rowspan="6" |'''Installer mon Dolibarr'''
|-
|''Installation sous Mac''
|-
|''Installation sous Gnu/Linux''
|-
|''Installation sous Windows''
|-
|''Installation Qnap Synology Divers''
|-
|''Installation Hebergeurs''
|-
|'''Mise à Jour'''
|'''Maintenir mon Dolibarr'''
|-
|'''Howto / Aide'''
| rowspan="10" |'''Utiliser mon Dolibarr'''
|-
|'''Bugs sur la version CVS ou demo'''
|-
|'''Bugs sur la version stable courante'''
|-
|'''Bugs avec PostgreSQL'''
|-
|'''Bugs sur la version ARCHIVE'''
|-
|''Bugs Dolibarr V6''
|-
|''Bugs Dolibarr V7''
|-
|''Bugs Dolibarr V3''
|-
|''Bugs Dolibarr V4''
|-
|''Bugs Dolibarr V5''
|-
|'''Retours d'expériences utilisateurs/intégrateurs'''
|''Retours d'expérience''
|-
|'''Suggestions/Nouvelles fonctionnalités'''
| rowspan="7" |'''Utiliser mon Dolibarr'''
|-
|'''Spécifiques à un Pays'''
|-
|''France''
|-
|''Belgique''
|-
|''Canada''
|-
|''Suisse''
|-
|''Autre''
|-
|'''Le module que j'ai téléchargé et deployé n'apparait pas'''
|''Modules externes du DoliStore''
|-
|'''Création d'un nouveau module'''
| rowspan="4" |'''Développer pour Dolibarr'''
|-
|''Hooks/Triggers/Classes Objets''
|-
|''API''
|-
|''Git & Github''
|-
|'''Adhérents/Association'''
|''Modules GRC/GRF''
|-
|'''E-Commerce'''
|''Modules externes du DoliStore''
|-
|'''Agenda'''
|''Autres modules natifs''
|-
|'''WebMails'''
| rowspan="4" |''Modules externes du DoliStore''
|-
|'''Autres modules'''
|-
|''Modules InfraS''
|-
|''Modules ATM''
|-
|''Module gestion de projets''
| rowspan="3" |''Autres modules natifs''
|-
|''Extrafields''
|-
|''Modeles ODT''
|-
|''Modules Patas Monkeys''
|''Modules externes du DoliStore''
|-
|'''Gestion des Ressources Humaines (GRH)'''
| rowspan="6" |''Modules GRH''
|-
|''Module utilisateurs''
|-
|''Demandes de congés''
|-
|''Notes de frais''
|-
|''GRH''
|-
|''Protection des Données''
|-
|'''Gestion de la relation client (GRC)'''
| rowspan="13" |''Modules GRC/GRF''
|-
|''Module Tiers''
|-
|''Modules Contrats/Abonnements''
|-
|''Module Interventions''
|-
|''Propositions commerciales''
|-
|''Expéditions''
|-
|''Contrats/Abonnements''
|-
|''Gestionnaire de tickets(Expérimental)''
|-
|''Commandes clients''
|-
|'''Gestion de la relation fournisseur (GRF)'''
|-
|''Fournisseurs''
|-
|''Propositions commerciales fournisseurs''
|-
|''Incoterm''
|-
|'''Modules financiers (Compta/trésorerie)'''
| rowspan="9" |''Modules financiers''
|-
|''Comptabilité /Comptabilité (avancée)''
|-
|''Prélèvements''
|-
|''Banques et caisses''
|-
|''Dons''
|-
|''Règlement salaires''
|-
|''Module Marges''
|-
|''Factures et avoirs clients/ factures fournisseurs''
|-
|''Gestion des emprunts''
|-
|'''Gestion des Produits/Services (PM)'''
| rowspan="6" |''Modules PM''
|-
|''Variantes de produits''
|-
|''Numéros de Lot/Série''
|-
|''Stock''
|-
|''Gestion des services''
|-
|''Gestion des produits''
|-
|'''Gestion électronique de documents (GED)'''
|''Autres modules natifs''
|-
|'''Modules Themes'''
| rowspan="3" |'''Utiliser mon Dolibarr'''
|-
|''Theme amarok''
|-
|''Theme Eldy''
|-
|'''Outils multi-modules'''
| rowspan="5" |''Autres modules natifs''
|-
|''Libellés/Catégories''
|-
|''Éditeur WYSIWYG''
|-
|''Mass Emailing''
|-
|''Flux RSS''
|-
|''Exports / Imports de données''
|'''Utiliser mon Dolibarr'''
|-
|''Module Multidevise''
| rowspan="2" |''Autres modules natifs''
|-
|''Codes-barres''
|-
|'''Sites web et autres applications frontales'''
|'''Utiliser mon Dolibarr'''
|-
|''Touch Screen POS''
|''Modules financiers''
|-
|''Module Sondage ou Vote''
|''Autres modules natifs''
|-
|''Module Caisse''
|''Modules financiers''
|-
|'''Système'''
| rowspan="2" |'''Maintenir mon Dolibarr'''
|-
|''Travaux planifiés''
|-
|'''Interfaces avec des systèmes externes'''
|'''Développer pour Dolibarr'''
|-
|''Paypal''
|''Modules financiers''
|-
|''Impressions Directe''
| rowspan="4" |''Autres modules natifs''
|-
|'''Projets/Travail collaboratif'''
|-
|''Module Ressources''
|-
|''Projets/Opportunités/Affaires''
|}

===Preview of new mapping after migration===
<br /><gallery widths="400" heights="800">
File:Categories-discourse.png|Preview of new mapping after migration
</gallery><gallery widths="500" heights="300">
File:Liste-cat.png|Posts distribution across main categories
File:Liste-sub-cat.png|Posts distribution across sub-category "Utiliser mon Dolibarr"
</gallery>

==Demo instance==

Demo instance with migrated data is available here : https://test-dolibarr-discourse.traulle.net/ (private ; see https://www.dolibarr.fr/forum/administration-forum/64852-instance-de-test-discourse#113680 for access - restricted to forum moderators and admins)

==Migration path==

Migrating from Kunena to Discourse can be handled using [https://github.com/discourse/discourse/blob/master/script/import_scripts/kunena3.rb the Discourse official import script].

A step by step guide is also available [https://meta.discourse.org/t/importing-from-kunena-3/43776?u=jtraulle on the Discourse forum].

Old Kunena releases (3.x) can be downloaded from the [https://joomlacode.org/gf/project/kunena/frs/?action=index&br_pkgrlssort_by=package_name&br_pkgrlssort_order=asc JoomlaCode forge].

The original Discourse's Kunena migration script has been customized to be more aligned with the specific migration needs of the french Dolibarr forum.

It can be retrieved here : https://gist.github.com/jtraulle/a8ed0244a2a77498f29ac32fd2bc0f65

Main differences with original script :

===Import Users===

*Retrieve old "anonymous" Kunena users that does not have a Joomla! account
*Retrieve profile info
*Retrieve avatars

===Import Categories===

*Import categories hierarchy ignoring main groups (Discourse only has two levels hierarchy)
*Categories are imported preserving the original order
*Categories with no posts (and no subcategories) are ignored/skipped

------

The latest version of the custom migration script takes care of re-categorizing topics into the [[#Proposed_skeleton]]

===Import Posts===

*Multiple enhancements on posts text content
**Escape some commonly used chars (>, -, +, *) to not be wrongly parsed as Markdown
**Block quote
***add a line break after [quote] BBCode tag if there is none
***Replacing old posts reference in quote blocks by new ones
***Removing remaining posts references in quote blocks for posts that does not exists anymore
**Unordered lists
***Break line after [ul] only for lines that starts by [ul] and followed by [li] tag on the same line
**Strike support
***Replace [strike][/strike] BBCode tag by <s></s> HTML equivalent for markdown parser
**Emojis
***Convert some emojis shortcuts to preserve custom emojis previously used

*Thank you
**Kunena post's "thank you" are imported as Discourse post's likes (added)

===Import Attachments===

Attachments to import into the new Discourse instance should be present to the local filesystem before running the task (plan about 400M disk space).

To download attachments from previous forum, start by export the URLs from the Kunena database.

<source lang="SQL">
SELECT CONCAT('https://www.dolibarr.fr/', folder, '/', filename) AS url FROM gvrsi_kunena_attachments ORDER BY id;
</source>

Put all the URLs into a text file (for example <code>uploads.txt</code>).

Next, use <code>wget</code> to download all attachment preserving the directory structure (yuuup, file names of multiple distinct attachments can be the same ...)

<source lang="bash">
wget --no-host-directories --force-directories --input-file=uploads.txt
</source>

===Permalinks===

Permalinks offer the ability to preserve old forum links (from Kunena) and emit a HTTP 301 (Permanent Redirect) when hitting such old links for categories, topics, posts and profile links.

====Categories permalinks====

Kunena stores aliases for categories in the '''kunena_categories''' '''alias''' database field.

====Topics permalinks====

For topics URLs, this a bit more tricky since they are not stored in database (it uses standard Joomla! SEO friendly URLs generated using JRouter) and should therfore be generated on the fly in the import script.

Research showed that a "safe" alias can be generated using following Joomla! function :
* <code>stringUrlSafe()</code> function in <code>libraries/vendor/joomla/filter/src/OutputFilter.php</code>
* using <code>transliterate()</code> function in <code>libraries/src/Language/Language.php</code>
* using <code>utf8_latin_to_ascii()</code> function in <code>libraries/src/Language/Transliterate.php</code>

====Direct messages permalinks====

Permalinks to specific messages like for example https://www.dolibarr.fr/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 are even more tricky than topics permalinks because everything that is after a # in considered and anchor and, as such could be treated only on the client side (therefore using Javascript).

The permalink treatment logic for direct messages is the following :

# User go to https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org?start=225#113400 (the old permalink)
# Normalization permalink rule <code>/(.*)\?.*/\1</code> is triggered and therefore remove part of the URL starting by ? ; the new URL to be processed become https://test-dolibarr-discourse.traulle.net/forum/12-howto--aide/62681-wiki-dolibarr-org#113400
# Permalink for topic is triggered and redirect the URL to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878#113400 (keeping the original anchor with the old postid)
# Javascript detect that the current URL have a # part
# Using Javascript, we redirect to the permalink https://test-dolibarr-discourse.traulle.net/forum/old-post/113400 that redirects to https://test-dolibarr-discourse.traulle.net/forum/t/wiki-dolibarr-org/27878/227

=====Javascript part=====

This code is to paste in the <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Common → </head></code> section.

<source lang="HTML">
<script type="text/javascript">
var urlSplit = document.URL.split("#");
if (urlSplit[1]) {
location.href = "/forum/old-post/" + urlSplit[1];
}
</script>
</source>

===Ads===

Current forum display an Ad banner (ads are currently managed in house using Joomla!

Discourse offers an ''' Official Advertising / Ad Plugin''' that can be used as a replacement. See https://meta.discourse.org/t/official-advertising-ad-plugin-for-discourse/33734

==Tentative design==

===Custom logos===

Go to <code>Admin → Customize → Settings → Branding</code>

*Based on Dolibarr main color '''#3D5F93'''
*[https://fr.cooltext.com/download-font-blippo Blippo] font<br />

<br />
====Main forum logo====
[[File:Logo forum discourse (proposal).png|none|thumb|300x300px|Logo forum discourse (proposal)]]
<br />

====Logo to use in email notifications and mobile view====
[[File:Logo forum discourse (for email and mobile view).png|none|thumb|300x300px|Logo forum discourse(for email and mobile view)]]
<br />

===Custom color palette===

Go to <code>Admin → Customize → Colors</code>
<br />

*tertiary : '''#004488'''
*quaternary : '''#3D5F93'''
*danger : '''#B43314'''

<br />
[[File:Color-palette-proposal.png|none|thumb|492x492px|Color palette proposal]]

===Custom layout===

Discourse allow to easily include a custom header and footer ; as well as custom styles.

This is a tentative custom Layout

<gallery widths="800" perrow="2" heights="500">
File:Discourse-tentative-design-blue.png|Tentative design desktop (proposal)
File:Discourse-tentative-design-mobile-view.png|Tentative design mobile view (proposal)
</gallery>

<br />

====Custom Header to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Header</code> and paste :
<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="HTML">
<div id="header" class="clearfix">
<div id="inner-header">
<a id="logo" href="/">
<img src="https://www.dolibarr.fr/templates/dolibarr/images/bg2.png" alt="ERP et CRM Open Source pour gérer votre entreprise ou association - Portail France" width="200" height="59">
</a>
<div id="headermodule">
<div class="bannergroup bannertop">
<div class="banneritem">
<a href="/component/banners/click/22" target="_blank" title="Partenaire ATOO.NET">
<img src="https://www.dolibarr.fr/images/banners/Couteau_suisse_UltimatePdf.jpg" alt="ATOONET" width="468" height="60">
</a>
<div class="clr"></div>
</div>
</div>
</div>
</div>
<div id="nav">
<div id="decalmenu" class="backshadow">
<ul class="nav menu" id="mainmenu">
<li class="item-166"><a href="https://www.dolibarr.fr/">Accueil</a></li>
<li class="item-57"><a href="https://www.dolibarr.fr/screenshots">Screenshots</a></li>
<li class="item-49"><a href="https://www.dolibarr.fr/demo-en-ligne">Démo en ligne</a></li>
<li class="item-36"><a href="https://www.dolibarr.fr/telechargements">Téléchargements</a></li>
<li class="item-64"><a href="https://www.dolibarr.fr/documentation">Documentation</a></li>
<li class="item-79"><a href="https://www.dolibarr.fr/boutique">Boutique</a></li>
<li class="item-59"><a href="https://www.dolibarr.fr/association">Association</a></li>
<li class="item-207 active"><a href="https://www.dolibarr.fr/forum">Forum</a></li>
</ul>

<form id="mod-finder-searchform" action="https://www.dolibarr.fr/component/finder/search" method="get" class="form-search">
<div class="finder">
<input type="text" placeholder="Recherche..." name="q" id="mod-finder-searchword" class="search-query input-medium" size="15" value="" autocomplete="off">
<input type="hidden" name="Itemid" value="198">
</div>
</form>
</div>
<div class="backshadow arrowafterul"></div>
<div class="backshadow"></div>
</div>
</div>
</syntaxhighlight>
|}
<br />
====Custom Footer to add====
Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → Footer</code> and paste :

<syntaxhighlight lang="HTML">
<div id="footer">
<span itemprop="name">Dolibarr ERP & CRM</span> © 2003-2017 - Gestion d'entreprise ou d'association
</div>
</syntaxhighlight><br />
====Custom CSS to add====

Go to <code>Admin → Customize → Themes → Light → Edit CSS/HTML → Desktop → CSS</code> and paste :<br />
{| class="mw-collapsible mw-collapsed"
!
|-
|<syntaxhighlight lang="CSS">
#header {
background-color: rgb(61,95,147);
background-image: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/header-overlay.png),url(https://www.dolibarr.fr/templates/dolibarr/images/overlays/headers/header-6_dolibarr.png);
background-repeat:repeat-x, no-repeat;
background-position-x: 600px;
}

#inner-header {
max-width: 1110px;
height: 105px;
margin: auto;
}

#main-outlet {
box-shadow: 0 5px 10px gray;
}

#headermodule {
float: right;
margin: 10px 0;
}

.banneritem {
margin-right: 8px;
}

#main {
background: url(https://www.dolibarr.fr/templates/dolibarr/images/header-overlay.png) 50% -90px repeat-x !important;
background-color: rgba(0, 0, 0, 0);
background-color: #FFFFFF !important;
}

.d-header {
background-color: inherit;
box-shadow: inherit;
}

.d-header .wrap {
box-shadow: 0 2px 4px -1px rgba(0,0,0,0.25);
}

.d-header .wrap .contents, #main-outlet {
background-color: #FFFFFF;
}

#logo {
float: left;
margin: 5px 0;
display: block;
max-width: 100%;
margin-left: 4px;
margin-top: 32px;
}

/* menu */
#nav {
background-color: rgb(56,90,127) !important;
background: linear-gradient(rgba(56,90,127,.5), rgba(56,90,127,1)),url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay2.png) 50% 0 repeat-x !important; /* Standard syntax */

}
#nav ul {
padding:0;
margin:0;

}
#nav ul li {
display: inline-block;
margin: 0 0 0 0;
padding: 8px 4px 4px 12px;
}
#nav #decalmenu {
max-width: 1126px;
margin: auto;
padding: 0;
}
#nav ul li a {
display: inline-block;
color: #FFF;
font-weight: bold;
text-decoration: none;
font-size: 13px;
padding: 6px 5px 4px 5px;
height: 26px;
}

.backshadow {background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/nav-overlay3.png) 0% 0 repeat-x;}

#nav arrowafterul { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; }
#nav ul li { background: url(https://www.dolibarr.fr/templates/dolibarr/images/shadows/light/menus/menutab-r.png) 0 0 no-repeat; min-height: 36px; }
#nav ul li.active, #nav ul li.active { opacity: 0.8; }

#nav ul li:hover, #nav ul li:hover .item, #nav ul li.active:hover {
background-image: -webkit-gradient( linear, left top, left bottom, color-stop(0, rgba(255,255,255,.3)), color-stop(1, rgba(0,0,0,.3)) );

}

#mainmenu {
display: inline-block;
}

#rokajaxsearch, form#mod-finder-searchform {
display: inline-block;
margin-right: 10px;
margin-left: 68px;
margin-bottom: 10px;
}
.roksearch_search_str {
width: 150px;
}

input.search-query {
padding-right: 14px;
padding-right: 4px \9;
padding-left: 14px;
padding-left: 4px \9;
margin-bottom: 0;
-webkit-border-radius: 15px;
-moz-border-radius: 15px;
border-radius: 15px;
}
.finder .search-query {
width: 132px;
}
.form-search .input-append .search-query,
.form-search .input-prepend .search-query {
-webkit-border-radius: 0;
-moz-border-radius: 0;
border-radius: 0;
}
.form-search .input-append .search-query {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search .input-append .btn {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .search-query {
-webkit-border-radius: 0 14px 14px 0;
-moz-border-radius: 0 14px 14px 0;
border-radius: 0 14px 14px 0;
}
.form-search .input-prepend .btn {
-webkit-border-radius: 14px 0 0 14px;
-moz-border-radius: 14px 0 0 14px;
border-radius: 14px 0 0 14px;
}
.form-search input,
.form-search textarea,
.form-search select,
.form-search .help-inline,
.form-search .uneditable-input,
.form-search .input-prepend,
.form-search .input-append,
.form-inline input,
.form-inline textarea,
.form-inline select,
.form-inline .help-inline,
.form-inline .uneditable-input,
.form-inline .input-prepend,
.form-inline .input-append,
.form-horizontal input,
.form-horizontal textarea,
.form-horizontal select,
.form-horizontal .help-inline,
.form-horizontal .uneditable-input,
.form-horizontal .input-prepend,
.form-horizontal .input-append {
display: inline-block;
*display: inline;
*zoom: 1;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .hide,
.form-inline .hide,
.form-horizontal .hide {
display: none;
}
.form-search label,
.form-inline label,
.form-search .btn-group,
.form-inline .btn-group {
display: inline-block;
}
.form-search .input-append,
.form-inline .input-append,
.form-search .input-prepend,
.form-inline .input-prepend {
margin-bottom: 0;
}
.form-search .radio,
.form-search .checkbox,
.form-inline .radio,
.form-inline .checkbox {
padding-left: 0;
margin-bottom: 0;
vertical-align: middle;
}
.form-search .radio input[type="radio"],
.form-search .checkbox input[type="checkbox"],
.form-inline .radio input[type="radio"],
.form-inline .checkbox input[type="checkbox"] {
float: left;
margin-right: 3px;
margin-left: 0;
}

#footer {
margin: auto;
background: #e3e3e3;
border-top: 1px solid #ccc;
padding: 5px;
color: #888;
text-align: center;
}
</syntaxhighlight>
|}
<br />

==Requirements==

===Hardware requirements===
''To the extent possible, a VPS machine ''that will be dedicated to running the Discourse forum software '''only''''' is the way to go.''

*modern single core CPU, dual core recommended
*1 GB RAM minimum (with swap)
*64 bit Linux compatible with Docker (I recommand 18.04 LTS Ubuntu Server to be aligned with the wiki.dolibarr.org OS).
*10 GB disk space minimum (SSD is a plus for the speed but not a requirement)

Refer to [https://github.com/discourse/discourse/blob/master/docs/INSTALL.md#hardware-requirements Hardware requirement (github.com)]

===Domain requirements===
Discourse '''<u>requires</u>''' a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code> and cannot be installed in a subdirectory.

=> We must found a solution and valid it works.
Future is to have doc/wiki on https://www.dolibarr.org/wiki, an forum of https://www.dolibarr.org/forum. Forum is 2/3 of traffic received on dolibarr.org and it is important to have a lot of content trusted by Google to have dolibarr.org valorized highly on Google search engine answers.

There is a solution here using a CDN frontend like Fastly: https://meta.discourse.org/t/discourse-in-a-subfolder-multiple-servers-sharing-a-domain/30514
It is based on Fastly, be Dolibarr is using Cloudflare as CDN that may offers same features.

Another solution without CDN, using your own proxy, is suggested here https://meta.discourse.org/t/subfolder-support-with-docker/30507 but previous one seems easier.

=> '''Yes, it is doable using nginx or Apache2 as a reverse proxy.''' In fact, I am using nginx as a reverse proxy on the demo instance.

=> With Cloudflare I found this : https://blog.cloudflare.com/subdomains-vs-subdirectories-improved-seo-part-2/

===Email requirements===
Discourse '''<u>requires</u>''' connection to a valid mail server :

*using SMTP protocol
*accessible on a FQDN (Fully Qualified Domain Name) : for example <code>forum.dolibarr.fr</code>
*with authentication (username and password)

<br />
{| class="wikitable"
|+Comparison of two possible configurations
!In house mail server like [http://www.postfix.org/ Postfix]
!External email service like [https://www.mailgun.com/ Mailgun]
|-
|
*'''''Cheapest'''''
*'''''Tricky to set/configure'''''
*'''''Monitoring email reputation is required'''''
|
*'''''Affordable'''''
*'''''Simple and easy (no configuration)'''''
*'''''Email reputation is managed by the provider'''''
|-
|
*Install [http://www.postfix.org/ Postfix] mailserver

*Configure / allow / unblock port 587 for outgoing email sending by postfix in the firewall (IP table, etc.)
*Configure Postfix to require authentication : see https://blog.rom1v.com/2010/01/ajouter-lauthentification-smtp-sur-un-serveur-mail/

------
Alternative : https://forum.normandie-libre.fr/t/installation-dun-forum-discourse-avec-apache-docker-et-mailboy/25
|
*[https://www.mailgun.com/ Mailgun] pricing, [https://www.mailgun.com/pricing first 10 000 emails every month free (+5$ by 10 000 email)]
*[https://fr.mailjet.com/ Mailjet] pricing, [https://fr.mailjet.com/pricing/ first 6 000 monthly emails free (no more than 200 email per day ; 30 000 per month for 7,16€])
*[https://aws.amazon.com/fr/ses/ AWS SES (Amazon Web Services Simple Email Service)] pricing, [https://aws.amazon.com/fr/ses/pricing/ 0.10$ per 1 000 emails].
*[https://sendgrid.net/ SendGrid] pricing, Free for 100 emails per day or 14$ per month for 40 0000 emails.

|}

==Tips and tricks==

===Discourse tips and tricks===
Add an Unreplied tab to the navbar : [https://meta.discourse.org/t/reply-reminder-remind-users-to-reply-to-new-users-topics-with-zero-replies/42644/2]

====Execute migration script====

<syntaxhighlight lang="bash">
./launcher enter web_only
# Install required dependencies to import data (gems)
su discourse -c "export IMPORT=1; bundle config unset deployment; bundle config set path 'vendor/bundle'; bundle config set without 'test development'; bundle install --jobs 4 --no-deployment"
# Run import script
su discourse -c 'export IMPORT=1; bundle exec ruby script/import_scripts/kunena3_dolibarr_de.rb'
</syntaxhighlight>

Note :

====Restaure Discourse backup from command line====

<syntaxhighlight lang="bash">
./launcher enter app
su discourse -c 'bundle exec ruby script/discourse restore forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar'
</syntaxhighlight>

You must of course replace <code>forum-dolibarr-france-2019-08-07-080937-v20190731090219.tar</code> by the backup filename to restore.

===Docker tips and tricks===
The main and recommended way to Install Discourse is using Docker containers system (it contains everything required to run Discourse : Ruby, Sidekiq, Redis, PostgreSQL with the appropriate version and does not mess with the host data).

The [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#install-docker--git quick start guide] is great for installation.

Data that should be preserved when the containers die (PostgreSQL database data files, users uploads, etc.), are persisted on the host.

The default mount point for all persisted data related to Discourse is through

<code>/var/discourse/shared/data</code> and <code>/var/discourse/shared/web-only</code>

===PostgreSQL tips and tricks===

====Allow PostgreSQL to be accessed from an external application====

''Useful to be able to access the database from a graphical client (like pgAdmin 4, TablePlus or Postico for example).''

1. Expose the 5432 TCP port from the container to the host by adding this line to the '''<code>expose:</code>''' section of <code>containers/app.yml</code> :
<syntaxhighlight lang="yaml">
- "5432:5432"
</syntaxhighlight>
2. Rebuild the container to take into account modifications to '''<code>app.yml</code>''' :
<syntaxhighlight lang="bash">
./launcher rebuild app
</syntaxhighlight>
3. Enter into the container, login as the default postgresql user, add a new user and grant it all perms to the database
<syntaxhighlight lang="bash">
./launcher enter app
sudo -u postgres psql discourse
</syntaxhighlight>
<syntaxhighlight lang="sql">
CREATE USER my_username WITH PASSWORD 'my_password';
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO my_username;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO my_username;
GRANT ALL PRIVILEGES ON DATABASE discourse to my_username;
\q
</syntaxhighlight>

Refer to [https://tableplus.io/blog/2018/04/postgresql-how-to-grant-access-to-users.html PostgreSQL - How to grant access to users?] for more info.

====Dumping database====

=====Using <code>pg_dump</code> to dump the database=====

Below syntax assume that a custom pgsql account has been created prior to running the command and that port 5432 of PostgreSQL is correctly forwarded from the container to the host (following [[#Allow PostgreSQL to be accessed from an external application]] section instructions).

The below command is executed from the host.

<syntaxhighlight lang="bash">
pg_dump -h 127.0.0.1 -d discourse -U my_username -W > discourse-backup-20190801.sql
</syntaxhighlight>

=====Using discourse internal backup tool=====

It is also possible to use Discourse internal backup tool to grab a backup (database + users uploads) of the Discourse instance.

Just go to <code>Admin → Backup</code>

Draft:Discourse Implementation and Exploitation

2020-06-14T10:48:42Z

Jtraulle: /* Upgrade the web container */

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<source lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</source>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

From : https://meta.discourse.org/t/faster-rebuilds/40341/13

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Draft:Discourse Implementation and Exploitation

2020-06-13T13:57:41Z

Jtraulle: /* Replicated minimal VM for tests */

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<source lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</source>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Tests for dolibarr.de migration ==

* Retrieve test VM backup
* Update packages (apt)
* Upgrade db to postgres12 (data container)
* rebuild web_only container tu upgrade to same discourse version as prod

== Upgrade the web container ==

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Draft:Discourse Implementation and Exploitation

2020-06-13T13:51:58Z

Jtraulle: /* Upgrade the web container */

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<source lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</source>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Upgrade the web container ==

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Upgrade the data container ==

See https://meta.discourse.org/t/postgresql-12-update/151236#data-container-install

<syntaxhighlight lang="bash">
cd /var/discourse
sudo ./launcher stop web_only
sudo ./launcher stop data
sudo ./launcher rebuild data
sudo ./launcher rebuild data
sudo ./launcher rebuild web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Draft:Discourse Implementation and Exploitation

2020-06-13T13:45:49Z

Jtraulle: /* Clickable addresses */

== Domains names ==

* dolibarr-test-fr.traulle.net
* dolibarr-test-org.traulle.net

These DN has been choosen to test the distinct vhosts but are not actually binded to public DNS.

You <u>MUST</u> edit your <code>/etc/hosts</code> local file (or similar) to point these addresses to IP '''37.59.159.184'''

For Windows based machines, you can use https://hostsfileeditor.com/ for that purpose.

== Clickable addresses ==

* http://dolibarr-test-fr.traulle.net
* http://dolibarr-test-fr.traulle.net/forum
* http://dolibarr-test-org.traulle.net
* http://dolibarr-test-org.traulle.net/forum
* http://dolibarr-test-de.traulle.net
* http://dolibarr-test-de.traulle.net/forum

== Replicated minimal VM for tests ==

For the implementation to go smooth, the <code>vmprod1</code> environment has been replicated on a dedicated test VM.

* Linux distro : Ubuntu 16.4.7
* Webserver : Apache2
* RDBMS : Mariadb
* PHP : 5.6

=== PHP version ===

PHP version is installed from <code>ppa:ondrej/php</code>.

=== Apache2 config ===

Apache2 virtual hosts config <code>dolibarr.fr.conf</code> and <code>dolibarr.org.conf</code> has been copied from <code>vmprod1</code> (Servername apache directive has just been modified to match names specified in [[#Addresses]]).

Enabling '''proxy '''and '''proxy_http '''modules.

Adding

<source lang="apache">
<Location "/forum">
ProxyPass "http://dolibarr-test-fr.traulle.net:8800/forum"
</Location>
</source>

=== Files ===

Files from <code>/home/dolibarr/dolibarr.fr</code> and <code>/home/dolibarr/dolibarr.org</code> has been copied to the same location on the test VM (however <code>/home/dolibarr/dolibarr.org/httpdocs/files/stable</code> has not been replicated on the test VM due to the weight/size of all packages).

=== MySQL/MariaDB Databases ===

Database names and users has been preserved (same users, same database names and same credentials has been created on test VM).

Databases for French and International websites has been dumped and restored on test VM.

=== Docker ===

Installed following the Docker docs : https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-engine---community-1

== Upgrade the web container ==

<syntaxhighlight lang="bash">
cd /var/discourse
sudo git pull
sudo ./launcher bootstrap web_only
sudo ./launcher destroy web_only
sudo ./launcher start web_only
</syntaxhighlight>

== Useful resources ==

* [https://meta.discourse.org/t/how-to-move-from-standalone-container-to-separate-web-and-data-containers/29413 How to move from standalone container to separate web and data containers]
* [https://meta.discourse.org/t/multisite-configuration-with-docker/14084 Multisite configuration with Docker]
* [https://meta.discourse.org/t/subfolder-support-with-docker/30507 Subfolder support with Docker]
* [https://meta.discourse.org/t/change-the-domain-name-or-rename-my-discourse/16098 Change the domain name or rename my Discourse?]
* [https://meta.discourse.org/t/rebake-all-posts-matching-a-pattern/48713 Rebake all posts matching a pattern]
* [https://meta.discourse.org/t/how-do-i-manually-update-discourse-and-docker-image-to-latest/23325/2 How do I manually update Discourse and Docker image to latest?]

Module Comptabilité en Partie Double

2020-06-08T06:33:06Z

Jtraulle:

[[en:Module_Double_Entry_Accounting]]


[[Category:Compta]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Comptabilité Avancée|
num=50400|
devdoc=[[Module Comptabilité en Partie Double (développeur)]]|
userdoc=Cette page|}}

=Introduction=
Ce module offre des fonctions comptables plus évolués que le module comptabilité et permet de générer des écritures comptables.

=Installation=
{{NoInstallModuleFr}}

=Configuration=
{{ActivationModuleFr}}

=Cycle de vie / Règles de gestion=

Il est possible que les lignes à lier en comptabilité soit impossible à afficher et signale une erreur.

Pour corriger le problème procéder comme suit;

*Dans votre répertoire "Document", renommer votre fichier install.lock en 1install.lock
*Entre l'URL "votre_nom_de_domaine.fr/install/repair.php?force_utf8_on_tables=confirmed" dans la barre d'adresse
*Attendre la fin de la procédure
*Renommer votre fichier install.lock

L'utilisation du module de comptabilité se fait en plusieurs étapes:

Les actions suivantes sont habituellement exécutées une seule fois, ou une fois par an ...

Etape 1: Créer un modèle de plan de compte depuis le menu Compta/Tréso-Comptabilité-Configuration-Modèle de plan de compte

Etape 2: Créer ou vérifier le contenu de votre plan de compte depuis le menu Compta/Tréso-Comptabilité-Configuration-Plan comptable

Les prochaines étapes doivent être faites pour vous faire gagner du temps à l'avenir en vous proposant le bon compte comptable par défaut lors de la journalisation (écrire des enregistrements dans les journaux et Grand Livre)

Etape 3: Vérifier que la liaison par défaut entre les lignes de transactions diverses et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes par défaut.

Etape 4: Vérifiez que la liaison entre le paiement de la TVA et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque taux de TVA sur la page Compta/Tréso-Comptabilité-Configuration-Compte TVA.

Etape 5: Vérifier que la liaison entre les dépenses spéciales (cotisations sociales ou fiscales) et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes charges.

Etape 6: Vérifiez que la liaison entre le type de notes de frais et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque type de ligne de note de frais sur la page Compta/Tréso-Comptabilité-Configuration-Comptes notes de frais.

Etape 7: Vérifier que la liaison entre les paiements de prêts et les comptes comptables est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Dépenses spéciales-Emprunts ou Compta/Tréso-Comptabilité-Configuration-Comptes par défaut.

Etape 8: Vérifier que la liaison entre les comptes bancaires et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, rendez-vous sur la fiche de chaque compte financier. Vous pouvez commencer à partir de la page Accueil-Banques/Caisses.

Etape 9: Vérifier que la liaison entre les produits/services et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes produits.

Les actions suivantes sont habituellement exécutées chaque mois, semaine, ou jour pour les très grandes entreprises ...

Etape 1: Vérifier que la liaison entre les lignes de factures client existantes et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Liaison factures client.

Etape 2: Vérifier que la liaison entre les lignes de factures fournisseurs existantes et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Liaison factures fournisseur.

Etape 3: Vérifiez que la liaison entre le type de notes de frais et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque type de ligne de note de frais sur la page Compta/Tréso-Comptabilité-Liaison notes de frais.

Etape 4: Ecrire les transactions dans le Grand Livre. Pour cela, aller sur chaque Journal, et cliquer sur le bouton "Enregistrer les opérations dans le Grand Livre".

Etape 5: Ajouter ou modifier les opérations existantes et générer des rapports et des exportations.

=Plan comptable=

=Exports=

Voici un exemple des formats d'export disponibles. L'export se fait depuis le grand livre:

{{AccountingExpertExportExamples}}

Module Double Entry Accounting

2020-06-08T06:31:41Z

Jtraulle:

What Dolibarr can't do

2020-06-04T12:07:11Z

Jtraulle:

[[de:Was Dolibarr nicht kann]]
[[fr:Ce_que_ne_fait_pas_Dolibarr]]
[[es:Lo_que_no_hace_Dolibarr]]


[[Category:FAQ_EN]]
{{TemplateDocUser}}

Those features are not (yet) available even in the latest Dolibarr version.

* Dolibarr does not contain a Payroll module.
* Tasks on the project module can't have dependencies between each other.
* Dolibarr does not include any Webmail (But all emails sent from your ERP can appears in your "Sent" directory of your mailbox and email received can be used to create data in your ERP).
* Double party accountancy is available since 6.0 but reports are not yet complete.
* To manage several companies or foundations, using one installation, you need to add/buy the [[Module MultiCompany]] on {{LinkToPluginDownloadDoliStore}}. Note that without purchasing this extra module you can still make as many installations of companies as you need, but you won't be able to share elements between them (like customers).
* Dolibarr can't do coffee (not yet).

If you're looking for available features, please see the page [[What Dolibarr Does]].

Module Dolimport

2020-05-27T14:20:17Z

Jtraulle:

[[fr:Module_Dolimport fr]]


[[Category:Complementary modules]]
[[Category:Imports]]
[[Category:Bank]]

{{TemplateDocDevEn}}
{{TemplateDocUser}}

=Informations=
{{TemplateModuleInfo
|modulename=DOLIMPORT API & DOLIMPORT CSV
|editor=Florian DUFOURG
|web=[http://dolitest.vps100069.mylogin.co/custom/bankimportapi/bankimportapiindex.php?id_bank=1&idmenu=6 demo]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=dolimport_api}}
|status=stable
|prerequisites=
|minversion=9.0.0
|note=
}}

=Features=
Import your bank statements from a csv file or connect directly the information from your QONTO bank account. Then many options are available :

#Create and paye a customer invoice
#Create and paye a vendor invoice
#Create and pay a VAT
#Create and pay a salary
#Create and pay a social and fiscal taxes
#Pay an existing customer invoice
#Pay an existing vendor invoice
#Pay a loan
#Pay an expense report
#Link a payment to a transaction

If you use QONTO API, you can download the attached files of QONTO directly from Dolibarr. Also the VAT and all other usefull information will be used to generate the Dolibarr elements.

If the reconciliation option of the bank account is activated in Dolibarr, Dolimport API will also automaticaly reconciliate the statement.

=Install=
{{InstallModuleDoliStoreEn|keyword=dolimport_api}}

=Setup=
{{ActivationModuleEn}}

===Module Configuration===
====Module setup page====
Configure the module from the module setup page, you can define :

*The default project you want to link the element (this value can be change later in the form)
*The default VAT value (this value can be change later in the form or directly define in the CSV file or in QONTO)
*An option to show only open project in dolimport API form or all projects
*An option to add a unique number for vendor reference (avoid double reference)
*The period of time you want to show in the list of transaction

=Connect to QONTO API=
If you want to use the module with a csv file, you have nothing more to do.
To connect Qonto to Dolibarr, go to the bank account card in Dolibarr.

Dolimport API automatically add 3 fields : ID API, KEY API and BANK API.

===Extrafield BANK API setup===
Select QONTO as BANK API value (for now it is the only option).

===Extrafield ID API & KEY API setup===
Go to your QONTO account : [https://app.qonto.eu/ | QONTO]
<br />
[[File:QONTO_API_configuration_1.png|alt=|border|left|202x202px]]
On the left menu of the QONTO web page, select "paramètres."

<br clear="all">
[[File:QONTO_API_configuration_2.png|alt=|border|left|271x271px]]
On the left menu select "intégration API".

<br clear="all">

Now you can go back to Dolibarr and fill the ID and KEY API with the info found on the QONTO website.

=Menu=
You can see this module in the left menu of the "bank" top menu.
If you choose the QONTO API option, only one link will appear in the menu, this is the list of transactions.

If you are not using QONTO API (so you are using CSV import), 2 links will appears in the menu, one to import transaction from a csv file and an other to see and process the transactions.

=Import a file (only if you use CSV files)=
Go to the page : "load a csv file".
<div class="divforimgcentpercent">
[[File:DOLIMPORT API Import csv page 2.png]]
</div>The left section of this page allows to prepare the import of the CSV file. All the parameters are saved for the next import.

#Select the date format as it is on the csv file
#Select how the amount (credit and debit) are shown in the csv file
#Select how the payment is defined in the csv file, if the payment mode is define so we need the translation between the Dolibarr payment mode and your bank statement csv file. The files below "translation" allow to explain how the payment mode are named in the csv file.

The right section of this page show the csv statement already importes. You can delete the statement doing click on the trash bin icon.

===Setting of the lines===
Once your csv file is uploaded, select the category of each column (date of operation, date of value, amount, label, secondary label).

The fields operation date, label and amount are required, the other fields are optionnals.

Uncheck the lines that you do not want to import (for example if there is a title line).
<div class="divforimgcentpercent">
[[File:DOLIMPORT API Import csv page 3.png]]
</div>

Before to import give a name to the bank statement, it will help to reconcile.

<br />
Sometime PHP limits the quantity of datas you can import, if a message shows that there is too much columns and rows, you should delete columns in the csv file or divide the csv file in many files.

=Generate Dolibarr elements from the list of transaction=
If you already successfully load a csv file or if your QONTO bank account is connected to Dolibarr, you can see the list of the transaction doing click on the name of the bank account in the menu.
<br />

===Generate the elements (invoices, taxes, salaries,loan...)===
To generate a Dolibarr element (invoice, expense report, payment, loan...) you have to make a click on an icon on the right of the click.

<div class="divforimgcentpercent">
[[File:DOLIMPORT List of transactions 2.png]]

</div>Select the icon depending of the type of element you want to generate.
[[File:DOLIMPORT_generation_of_vendor_invoice.png|1200x1200px]]
<br />

Installation manuelle sous Windows

2020-05-20T13:22:48Z

Jtraulle:

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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download
*Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
**Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
*Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

<br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

* À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

Installation manuelle sous Windows

2020-05-20T12:40:24Z

Jtraulle: /* Manuellement en utilisant l'Invite de commandes Windows */

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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download
*Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
**Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
*Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

<br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

* À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]

L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

=====Directement depuis Dolibarr=====

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

====Restaurer une sauvegarde====

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

=====Manuellement en utilisant l'Invite de commandes Windows=====

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png

2020-05-20T12:31:31Z

Jtraulle:

Démarrer Command Prompt (MariaDB 10.4 (x64))

Installation manuelle sous Windows

2020-05-20T12:26:22Z

Jtraulle: /* Manuellement en utilisant l'outil graphique HeidiSQL */

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

Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour les versions antérieures de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.

L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.

Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).

Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]

==Architecture de Dolibarr==

Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.

==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download
*Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
**Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
*Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

<br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]

====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]

<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.

Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)''']]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>.

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée.

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.

Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]

Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]

Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="PHP">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code> de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]

Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL]]

* Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL''']]

* Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
* Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

=====Directement depuis Dolibarr=====

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

====Restaurer une sauvegarde====

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

=====Manuellement en utilisant l'Invite de commandes Windows=====

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

File:Paramétres d'export de base de données HeidiSQL.png

2020-05-20T12:20:36Z

Jtraulle:

Paramétres d'export de base de données HeidiSQL

File:Exporter la base de données HeidiSQL.png

2020-05-20T12:18:42Z

Jtraulle:

Exporter la base de données HeidiSQL