Dolibarr ERP CRM Wiki - User contributions [en]

翻译文档

2019-07-23T12:26:24Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="translation, documentation, translator, localize, localization, i18n, internationalization, language" />
{{Template用户手册}}
{{TemplateMainPageZh}}

= [[File:Language.png]] 翻译 Dolibarr =

Dolibarr语言文件已经用几种语言翻译了。
英语是默认的语言会首先完成翻译。其他语言依赖于自愿者的贡献。本教程帮助您完成一个未译的或错译的语言。
Dolibarr可以用三种不同的方式翻译：

# 手动使用Transifex （官方和推荐的方法）
# 手动编辑语言文件
# 全自动：自动翻译机

== 使用Transifex在线服务进行手动翻译（推荐）==

Transifex 是一个为翻译项目提供在线平台的Web应用程序。它包括团队和讨论工具、翻译记忆、词汇表、校对和许多其他特征。
它非常容易使用，所有翻译都可以通过Web界面上传或下载，或者使用来自终端的TX客户端。
Transifex 是一个开源项目，“社区版”可以免费下载和安装，但我们将使用在线托管服务。

===使用Web界面（译者）===
如果你想用自己的语言帮助翻译Dolibarr，请检查项目的页面。 https://www.transifex.com/dolibarr-association/dolibarr/

然后，您可以注册一个帐户，并请求加入项目团队，以您的语言为目标。管理员会接受你的要求，所以请耐心等待。

一旦被接受，你就可以马上开始翻译了。

欲了解更多信息，请检查Transifex“入门”介绍规范 http://docs.transifex.com/introduction/translators/ 和网络编辑器向导于 http://docs.transifex.com/tutorials/txeditor/

===='''备注关于 en_US'''====
Web界面不能用来翻译源代码的en_US语言。

任何更改都必须在Dolibarr源代码中完成，并在GitHub存储库上使用Pull请求提交。

=== 使用TX 命令行客户端 (for Dolibarr [[:Category:Yoda]] team) ===
这描述了如何从命令行中使用Transifex。然而，这是保留给Dolibarr管理员用户，以同步Transifex与Dolibarr主源码。

[http://docs.transifex.com/developer/client/ 官方文档]

====TX 客户端设置====
安装 TX 客户端
使用 Debian/Ubuntu/Mint:
<source lang="bash">
apt-get install python-pip
pip install transifex-client
</source>
然后你必须初始化你的TX环境。这是通过进入Dolibarr项目根目录运行'tx init ''来完成的。
<source lang="bash">
cd git/dolibarr
tx init
</source>
接受改写配置文件。保持Transifex实例的默认值，然后输入您的Transifex登录和密码。

在此之后，一个.transifexrc已经创建到您的主页目录，并且一个通用配置文件被创建于项目根目录中的'''.tx/config'''。
所以目录的内容会是这样的：
所以目录的内容会是这样的：
<code><pre>
.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx
</pre></code>

当前配置文件可以从 https://github.com/Dolibarr/dolibarr/tree/develop/.tx 下载，放入.tx目录，重写由'tx init ''创建的目录。

此项目配置文件用于将项目的详细信息和文件存储到资源映射。

这是配置文件包含内容的示例：

<source lang="ini">
[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES
</source>

下面是配置文件中使用的部件和选项的说明：

<nowiki>[main] section</nowiki>

在本节中，我们有项目范围的选项，例如：所有项目的默认transifex主机。如果需要的话，这些资源可以被每个资源重写。

<nowiki>[dolibarr.resource]</nowiki>

source_lang: this is the source language of the resource.<br/>
source_file: this points to the source file directly.<br/>
file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory''<br/>
trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. ''not mandatory''<br/>
host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. ''not mandatory''<br/>

====TX 客户端使用====
'''tx''' 命令有用的信息。

'''tx status'''

显示翻译状态

'''tx push'''

用于推送更改，从你的计算机到Transifex服务器

TX推送命令的其他选项是：

<code><pre>
-h - 显示命令行帮助
-l <lang> - 指定要推送哪些翻译（默认为所有）
-r <resource> - 指定要向其推送翻译的资源（默认为所有）
-f - 在不修改修改时间的情况下推送源文件
--skip - 错误时不要停止。当同时推多个文件时很有用。
-s - 将源文件推送到服务器
-t - 将翻译文件推送到服务器
--no-interactive - 强制推送时不需要用户输入。</pre></code>

'''tx pull'''

用于从Transifex服务器将更改拉到您的计算机上<br/>
TX拉动命令的其他选项是：
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.</pre></code>

'''例'''

要取得翻译文档,使用:

<source lang="bash">
tx -d pull -l it_IT # Get italian language only
tx -d pull -a # Get all languages
</source>

要上传源文件,键入:

<source lang="bash">
tx -d push -t -l it_IT [-r dolibarr.file] # To push only a specific translation file
tx -d push -s # To push source file
</source>

=== transifex流程的其他问题 ===
这是一个简短的Q&A，你也可以问一下transifex翻译过程：

1) 是在一个固定的时间间隔上的同步?

不，它是在有足够的翻译提交的地方完成的。在创建最终发布包之前，它也在beta分支上完成。

2) 是否所有的翻译同步到Git，或者仅仅是经过审查的翻译。在同步完成之前我需要复习吗？ ?

当同步完成时，transifex文件将文件覆盖到Git中，但前提是至少为文件修改了记录。
在同步完成之前，您不必进行复查。最重要的是，要知道哪些线是手工评审的，哪些是最初用机器人翻译的。

3) Dolibarr发布的版本将有翻译吗？transifex 翻译也与维护版本同步?

同步总是在开发和/或beta上完成。
因此，transifex更改出现在所有版本中，其分支是在transifex更改之后创建的（在创建新分支之前总是进行同步）。

一旦创建了一个分支，那么新的过渡到transifex将只适用于下一个分支。这是因为transifex无法管理分支/版本（还没有）。

== 手动翻译（不推荐） ==

要将DoiBARR翻译成另一种语言，请转到Langs目录，并创建一个用代码语言命名的文件夹/目录来翻译（遵循现有格式，例如en_US, en_GB, es_ES, de_DE, 等）。然后将文件从现有的语言目录（例如en_US/main.lang, en_GB/bills.lang）复制到刚刚创建的新语言目录中。

这些文件在每行中具有键/值对的格式，如下所示：

<source lang="ini">
Code1 = translate phrase 1
Code2 = translate phrase 2
...
Coden = translate phrase n
</source>

将短语（键值对的值部分）翻译你的语言，“=”的左边的代码（键部分）应该保持不变。

可以逐个翻译这些文件，而不必一次就把它们全部翻译出来。

如果文件没有被翻译成新的语言，Dolibarr将使用英语。

要在PHP代码中有一个本地化的（翻译的）字符串，你所要做的就是加载语言文件并使用该方法得到翻译值，如下所示：

<source lang="php">

$langs->load("myfile"); // or use $langs->load("myfile@mymodule") if myfile.lang is inside directory htdocs/mymodule/langs/xx_XX

print $langs->trans("CodeX")
</source>

条目类型;

<source lang="ini">
CodeX = phrase X
</source>

必须存在或添加到myfile.lang文件。

== 使用autotranslator.php工具自动翻译 ==

* Translator OS: All
* Tool: '''autotranslator.php''' provided with Dolibarr in directory '''dev/translation'''.
This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add missing key or correct errors, try to use method using Transifex (see later).

To make or update all files of a language code, just run the script:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
For example :
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
to translate into Portuguese (pt_PT) using English (en_US) files.

All non existing files will be created, all existing files will be updated.
The tool use [http://translate.google.com Google translation] service to find the translation value of a string, so a working Internet connection is required from station running the script. Also a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars).
Your PHP must also have permissions to write into '''htdocs/langs''' directory and must have curl functions available.

= [[File:Language.png]] 将你的翻译分发到核心资源中 =

Once you start translating, it's a smart decision to share it, so it can be included into the official code of Dolibarr.
If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.

If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.

If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.
If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.

Note:

The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.

If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.

= [[File:Language.png]] 翻译Wiki文档 =
维基是用3种语言写成的：英语、法语和西班牙语。

如果你想增强这些语言中的一种语言，你所要做的就是在Wiki上创建一个帐户。

然后，您可以编辑现有的页面来纠正错误的翻译或翻译等待翻译的页面。 [[:Category:Page_waiting_for_translation]].

简体中文官方文档

2019-07-23T12:26:24Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="简体中文,documentation, help, information, development, user, guide, tutorial" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''易于使用的企业开源软件。自由管理你的中小型公司，自由职业者或基金会活动'''
</center>

本WIKI指南是献给用户、开发者，翻译人员三类读者的。 ('''用户''', '''开发者''' 和 '''翻译人员''' 指南文档) 以及 Dolibarr ERP/CRM的种类资源。
可从 Dolibarr 官方网站下载到 (官网： https://www.dolibarr.org).

简体中文翻译可到Dolibarr爱好者交流Q群技术交流：206239089

{{Info}}{{InfoZh}}

= [[File:art.png|link=]] Dolibarr简介 =
* [[Dolibarr是什么？|这是啥 ?]] - [[谁使用Dolibarr|谁在使用Dolibarr?]]
* [https://www.dolibarr.org/onlinedemo 在线demo演示]
* [https://www.dolibarr.org/downloads/ 下载地址]
* [[Dolibarr Project|项目组织架构以及资源]]
* [[Dolibarr foundation|Dolibarr 基金会]]

= [[File:File_Doc_user.png|link=]] 用户手册 =
* [[用户手册|用户手册]]
* [[User FAQ|用户常见问题及解答]]
* [[截图|截图]]
* [[Dolibarr help and support|帮助和支持]] (社区，论坛，商业等支持...)
* [[Security informations|安全信息]]

= [[File:File_Doc_dev.png|link=]] 开发指南 =
* [[开发文档|开发文档]]
* [[Zh Developer FAQ|开发常见问题及解答]]
* [[Zh Dolibarr Project|项目组织架构以及资源]]

= [[File:File_Doc_trans.png|link=]] 翻译人员帮助文档 =
* [[翻译文档|翻译人员帮助文档]]

= [[File:File_Doc_tester.png|link=]] 测试人员指南 =
* [[Zh Tester documentation|测试人员指南]]

用户手册

2019-07-23T12:26:24Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

{{TemplateMainPageZh}}

<seo metak="用户, 文档, 指南, doc, 向导, 用法, 帮助" />

本页是与用户文档相关的文档的主要索引。有关开发人员文档，请参见[[开发文档|此处]]。

= Dolibarr与模块 =

== 功能 ==
* [[Dolibarr是什么？|Dolibarr能做什么]]
* [[Dolibarr不能做什么？|Dolibarr不能做什么？]]

== 安装/设置/升级 ==
* [[前提|前提]]
* [[安装 - 升级]]
* [[设置|设置]]

== 用法（按模块） ==

用Dolibarr，就是使用它的'''[[模块]]、菜单和功能'''。

* [[用法总说明]] (第一步).

一旦了解了一般用法，您就可以查看有关所有标准业务模块的文档。选择您感兴趣的模块来查看这样的文档：

* 标准模块列表定义于在页面： [[:Category:标准模块列表|标准模块列表]]
===产品模块的使用===

====产品模块的安装====
* 选择'''主页-设置-模块'''
* 将'''本地模块-产品管理'''的开关按钮打开。
* 此时会在顶部菜单栏出现'''产品菜单'''

====添加产品====
* 在顶部菜单栏选择'''产品'''
* 在左侧菜单栏选择'''新建'''
* 填写表单内容，完成后点击下方的确认。

====为产品填加图像====
* 点击左侧菜单栏'''产品-列表'''。
* 单击要填加图像的产品的'''编号'''列。进入产品查看页面。
* 选择顶部'''链接的文件'''选顶卡。
* 点击'''选择文件'''按钮来选择要填加的图像。
* 选择'''发送文件'''来上传文件。
* 如果是首张图像文件，会自动设置为产品的图像，由产品的编号链接直接调用，鼠标放置会显示图像。

其他模块的列表定义于页面： [[:Category:Complementary modules|Complementary modules]]

补充模块也称为自定义模块。

如果需要安装自定义模块检查 [[Custom_module_install|How to install a custom module]].

== 使用方法（按功能）==
=== 如何使用千位分隔符 ===

[[千位分隔符]]
== 管理 ==
* [[批量导入|批量导入]] / [[导出|导出]]
* [[备份]] / [[恢复]]

= 其他文件来源 =
* [http://doc.ubuntu-fr.org/dolibarr#dolibarr Ubuntu doc] (French)

= 词汇表=
见 [[词汇表]]

= FAQ =
所有常见问题可通过索引页获得 [[:Category:FAQ EN|FAQ EN]]
[[Category:Proofreading done]]

= 傻瓜使用手册 =
[[傻瓜使用手册]]

--[[User:R.ivnun|Roger-QQ12464313]] 06:21, 26 June 2018 (UTC)

开发文档

2019-07-23T12:26:23Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="developer, development, documentation, guide, doc, tutorial, usage, help, api, coding, standard, rules" />
此页是与开发文档相关的文档的主要索引。对于用户文档：[[用户手册|用户手册]].
{{Template用户手册}}
{{TemplateMainPageZh}}

= 开发组织和工具 =
本章包含在开始Dolibarr的任何开发之前必须阅读的全局信息。
# [[Dolibarr Project|Organization of project]]
# [[To known before to start|To be known before starting to develop]]
# [[Environment and development tools]]
# [[Dependencies and external libraries]]
# [[FAQ_Get,update_project_sources|Get or update sources of a development version]]

= 代码规则和最佳实践 =
# [[安装前提条件|安装前提条件]]
# [[语言和开发规则|语言和开发规则 (PHP, SQL, HTML)]]
# [[:Category:Table SQL|数据表列表]]
# 文件结构和可用类: [http://doxygen.dolibarr.org/ doxygen generated documentation]

= 模块清单 =
标准的业务模块的技术文档可在每个模块的开发文档页中找到。选择你感兴趣的合适页面：

* [[:Category:List of Modules (developer)‎|List of standard modules]]
* [[:Category:Complementary modules|List of complementary modules]]

= 开发一个新的GUI模块 =
本节描述了如何开发一个新的模块来改变Dolibarr用户界面。这可以是屏幕、主题、数据、它自己的CSS样式表、源代码或所有这一切。

脚本开发不包括在本节中（这将在下一章中描述）。

要开发自己的模块，请检查 [[模块开发]] 。

= 开发批处理或命令行脚本 =
本章描述了如何开发命令行脚本来执行Dolibarr（Read，Update DATA…）中的任务。

在本章中不包括对图形用户界面（GUI）的修改。请参阅上一章。

要开发一个脚本，像一个CRON脚本或命令行导入工具从外部源导入数据，您可以查看 [[脚本开发]] 。

= Dolibarr的技术部件 =
== 树形结构 ==
当前版本文件的路径层次结构可从 [http://doxygen.dolibarr.org/ doxygen generated documentation] (类似于生成的“JavaDoc”文档).

新文档中添加新文件的路径定义在开发新模块的文档中。 (见 [[模块开发]]).

=== 主要文件的解释 ===
* /main.inc.php 定义Dolibarr GUI 环境（脚本不需要引用）
* /master.inc.php 定义Dolibarr所有进程的环境，不管是页面还是脚本。文件记取conf文件，初始化 $lang, [[$db]]和空的$user
* /filefunc.inc.php 引用 conf.php 文件和其他通用库文件，比如： functions.lib.php
* /core/lib/function.inc.php 函数库，包括了引用数据库的函数。
* /core/class/html.formother.class.php 其他HTML部件的预先配置文件

== 配置参数的存储 ==
Dolibarr设置参数有3个位置。
* Dolibarr技术设置参数（身份验证模式、数据库登录和文件存储区域）在设置文件中定义:“conf/conf.php”。见 [[Configuration file]]。
* 全局功能参数存储在 [[Table llx_const]]。见 [[Constants]] 。
* 用户功能参数存储在 [[Table llx_user_param]]. 见 [[Constants]] 。

== 业务对象 ==
见 [[业务对象]]

== 菜单 ==
见 [[菜单]].

== 选项卡 ==
见 [[选项卡]].

== 主题 ==
见 [[主题]].

== 信息框 ==
见 [[信息框]].

== 身份认证 ==
见 [[认证]].

== 权限 ==
见 [[用户权限]].

== 翻译 ==
见 [[翻译]].

== 错误信息 ==
见 [[Error reporting|Error reporting]].

== 画布 ==
'''画布'''是替换屏幕显示的开发功能。

以新模板替换老模板来'创建'、'编辑'或'显示'记录（产品，合伙人，联系人，…）。

例如，您可以替换掉系统自带的“新建合伙人”的窗体，或者“修改合伙人”的窗体，或者替换掉"查看合伙人"的模板。

见 [[画布]].

== 触发器 ==
触发器是在Dolibarr“业务事件”（创建发票、删除用户、更新第三方等）中执行个性化代码的开发功能，仅用于业务事件。其他情景的个性化代码，请查看“钩子”章节。

见 [[Interfaces Dolibarr toward foreign systems|this page]].

== 钩子 ==
见 [[钩子系统]].

== 变量代换 ==
见 [[Variable substitution system]].

== Web服务 ==
Dolibarr可以设置提供一些服务。

见 [[Module Web Services]].

== 文件存储 ==
见 [[Generated documents]].

== 编号模块 ==
对于在系统中创建的每个实体，Dolibarr自动分配引用。

为了适应任何使用的参考，Dolibarr使用模块来定义引用生成规则。

系统提供了几个标准模块。有些是通用的，用于定义数字掩码（字符有几位数，有或没有前缀，是否包括日期，等等），它们可以满足大多数需要。

然而，仍然存在所提供的模块不满足需要的情况。在这种情况下，有必要开发自定义编号模块。

见 [[自动编号模块|自动编号模块]].

== 模板 ==

关于模板生成文档的更多文档见 [[创建PDF模板]] 或 [[Create an ODT document template]].

== 附加字段 ==
见 [[附加字段]].

== 其他内部功能 ==
您的代码可以使用许多内部库。

您可以在functions.lib.php、functions2.lib.php或admin.lib.php中找到大量的函数。也可以使用在htdocs/core/lib/*.lib文件中找到的任何函数。

'''根据Dolibarr版本号指定需求'''

例如，为了创建一个Dolibarr版本>3.5的环境，可以使用admin.lib.php中发现的versioncompare和versiondolibarrarray:

<source lang="php">
if (versioncompare(versiondolibarrarray(), array(3,5,0)) > 0)
{
...
}
</source>

= 批量导出/导入 =
# [[批量导入]]
# [[Module Exports En|Mass exports]]

= 与其他应用程序的接口和链接 =
# [[Interfaces Dolibarr toward foreign systems]] or toward Dolibarr (Dolibarr Triggers)
# [[Interfaces from foreign systems toward Dolibarr]]
# [[Module Web Services|Web Services]]

= FAQ =
All FAQs are available through the FAQ index page [[:Category:FAQ EN|FAQ EN]]

--[[User:R.ivnun|Roger-QQ12464313]] 09:00, 19 July 2018 (UTC)

中文翻译文档

2019-07-23T12:26:23Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="translation, documentation, translator, localize, localization, i18n, internationalization, language" />

= [[File:Language.png]] Dolibarr简体中文汉化教程 =

参考：duuge。com/archives/Dolibarr.html DolibarrQQ群原创：206239089 （简体中文翻译交流）<br>
Dolibarr 语言文件已经被翻译成多国语言文件.

默认语言为 English 英语并且一直为完成状态。其他语言尚有待您的大力贡献。

本教程可以指引您完成一个语种的翻译或者修正已翻译的语言错误以及未审阅的翻译。

Dolibarr 有以下三种不同的翻译方式方法:

# 使用 Transifex 网站手工翻译大法 (官方推荐此法).
# 手工编辑修改语言文件法
# 自动化翻译: 自动翻译法

== 通过Transifex专业翻译网站在线翻译 (推荐) ==

Transifex 是一个给翻译项目提供在线翻译平台的在线应用。该平台包括翻译团队和讨论工具，翻译记忆，术语表，校对等N多功能。
此平台相当容用并且全部翻译人员能够从WEB网页或使用该平台专用的TX命令行客户端上传及下载翻译成果
Transifex 是一个开源项目并且其社区版本允许免费下载并安装使用，但我们Dolibarr官方使用的是transifex网站的在线服务。

===通过网页在线汉化 (翻译人员)===
如果您想帮助Dolibarr翻译完善您的语言，请点击 https://www.transifex.com/dolibarr-association/dolibarr/

您事先需要注册一个账号并申请加入Dolibarr项目翻译团队中来。管理员会给你发封邮件告知你已经被管理团队加入翻译人员之中了。

一旦您认可，您即可开始翻译啦。

更多信息, 请翻阅 Transifex 官方的"Getting Started" 翻译向导介绍 http://docs.transifex.com/introduction/translators/ 以及编辑人员之旅 http://docs.transifex.com/tutorials/txeditor/

====注意 en_US====
web接口不可翻译en_US源语言因为这是默认语言不允许动呀。
任何变更一定会体现在Dolibarr源代码中的请放心我们会将您的提交pull到Dolibarr在github的源码库中的。

=== 使用 TX 官方客户端命令行工具 (这是给Dolibarr [[:Category:Yoda]] 团队看的你别看哟——其实我就看完了，嘿嘿嘿费玉清) ===
此处进行描述如何使用Transifex官方客户端命令行工具。然而，这里保留Dolibarr管理员们用于同步Dolibarr的Transifex主源码。

[http://docs.transifex.com/developer/client/ Official documentation]

====TX 客户端配置====
首先当然是安装 TX 客户端程序软件了.
基于 Debian/Ubuntu/Mint请使用以下安装命令进行安装:
当然首先要安装python-pip
<source lang="bash">
apt-get install python-pip
</source>
然后再安装transifex-client
<source lang="bash">
pip install transifex-client
</source>
byiz注：本人用上述方法安装失败，使用下面：
<source lang="bash">
easy_install transifex-client
</source>
easy_install transifex-client.安装成功，
然后对 TX 运行环境初始化. 即切换到dolibarr根目录下之后运行 '''tx init''' 命令.
必须要先tx init初始化才行哦，见duuge笔记记录全文这里不再累述。
<source lang="bash">
cd git/dolibarr
tx init
</source>
同意盖掉config配置文件。全部保持默认值即可。因为咱也不懂想改也不知道改哪里就保持默认了一路按回车吧。最后回车不下去了原来是需要输入transifex的账号和密码呢。

做完上边动作，会在当前用户的HOME目录下生成隐藏文件 .transifexrc ，这是这条命令用root权限 '''.tx/config''' 生成的.
目录类似如下这样子吧（我本人的不是，我是直接mkdir一个新目录dolibarr-tx目录用来专门放翻译语言避免搞混了源文呀）:
<code><pre>
.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx
</pre></code>

当然这个 config 配置文件可从 https://github.com/Dolibarr/dolibarr/tree/develop/.tx 下载得到的啦别担心, 下载回来并放到 .tx 目录中去, 盖掉因为使用命令 '''tx init''' 而生成的那个配置文件哦。

此项目配置文件用于说明项目的详情和文件与源码的映射对应。

下边有一个简洁的 config 配置文件所包含有哪些元素不包生仔哦:

<source lang="ini">
[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ, sw: sw_SW, sr@latin: sr_RS

[dolibarr.accountancy]
file_filter = htdocs/langs/<lang>/accountancy.lang
source_file = htdocs/langs/en_US/accountancy.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.agenda]
file_filter = htdocs/langs/<lang>/agenda.lang
source_file = htdocs/langs/en_US/agenda.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.banks]
file_filter = htdocs/langs/<lang>/banks.lang
source_file = htdocs/langs/en_US/banks.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.bills]
file_filter = htdocs/langs/<lang>/bills.lang
source_file = htdocs/langs/en_US/bills.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.bookmarks]
file_filter = htdocs/langs/<lang>/bookmarks.lang
source_file = htdocs/langs/en_US/bookmarks.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.boxes]
file_filter = htdocs/langs/<lang>/boxes.lang
source_file = htdocs/langs/en_US/boxes.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.cashdesk]
file_filter = htdocs/langs/<lang>/cashdesk.lang
source_file = htdocs/langs/en_US/cashdesk.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.categories]
file_filter = htdocs/langs/<lang>/categories.lang
source_file = htdocs/langs/en_US/categories.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.commercial]
file_filter = htdocs/langs/<lang>/commercial.lang
source_file = htdocs/langs/en_US/commercial.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.companies]
file_filter = htdocs/langs/<lang>/companies.lang
source_file = htdocs/langs/en_US/companies.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.compta]
file_filter = htdocs/langs/<lang>/compta.lang
source_file = htdocs/langs/en_US/compta.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.contracts]
file_filter = htdocs/langs/<lang>/contracts.lang
source_file = htdocs/langs/en_US/contracts.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.cron]
file_filter = htdocs/langs/<lang>/cron.lang
source_file = htdocs/langs/en_US/cron.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.deliveries]
file_filter = htdocs/langs/<lang>/deliveries.lang
source_file = htdocs/langs/en_US/deliveries.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.dict]
file_filter = htdocs/langs/<lang>/dict.lang
source_file = htdocs/langs/en_US/dict.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.donations]
file_filter = htdocs/langs/<lang>/donations.lang
source_file = htdocs/langs/en_US/donations.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.ecm]
file_filter = htdocs/langs/<lang>/ecm.lang
source_file = htdocs/langs/en_US/ecm.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.errors]
file_filter = htdocs/langs/<lang>/errors.lang
source_file = htdocs/langs/en_US/errors.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.exports]
file_filter = htdocs/langs/<lang>/exports.lang
source_file = htdocs/langs/en_US/exports.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.externalsite]
file_filter = htdocs/langs/<lang>/externalsite.lang
source_file = htdocs/langs/en_US/externalsite.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.ftp]
file_filter = htdocs/langs/<lang>/ftp.lang
source_file = htdocs/langs/en_US/ftp.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.help]
file_filter = htdocs/langs/<lang>/help.lang
source_file = htdocs/langs/en_US/help.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.holiday]
file_filter = htdocs/langs/<lang>/holiday.lang
source_file = htdocs/langs/en_US/holiday.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.hrm]
file_filter = htdocs/langs/<lang>/hrm.lang
source_file = htdocs/langs/en_US/hrm.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.incoterm]
file_filter = htdocs/langs/<lang>/incoterm.lang
source_file = htdocs/langs/en_US/incoterm.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.install]
file_filter = htdocs/langs/<lang>/install.lang
source_file = htdocs/langs/en_US/install.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.interventions]
file_filter = htdocs/langs/<lang>/interventions.lang
source_file = htdocs/langs/en_US/interventions.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.languages-not-res]
file_filter = htdocs/langs/<lang>/languages.lang
source_file = htdocs/langs/en_US/languages.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.ldap]
file_filter = htdocs/langs/<lang>/ldap.lang
source_file = htdocs/langs/en_US/ldap.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.link]
file_filter = htdocs/langs/<lang>/link.lang
source_file = htdocs/langs/en_US/link.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.loan]
file_filter = htdocs/langs/<lang>/loan.lang
source_file = htdocs/langs/en_US/loan.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.mailmanspip]
file_filter = htdocs/langs/<lang>/mailmanspip.lang
source_file = htdocs/langs/en_US/mailmanspip.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.mails]
file_filter = htdocs/langs/<lang>/mails.lang
source_file = htdocs/langs/en_US/mails.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.main]
file_filter = htdocs/langs/<lang>/main.lang
source_file = htdocs/langs/en_US/main.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.margins]
file_filter = htdocs/langs/<lang>/margins.lang
source_file = htdocs/langs/en_US/margins.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.members]
file_filter = htdocs/langs/<lang>/members.lang
source_file = htdocs/langs/en_US/members.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.oauth]
file_filter = htdocs/langs/<lang>/oauth.lang
source_file = htdocs/langs/en_US/oauth.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.opensurvey]
file_filter = htdocs/langs/<lang>/opensurvey.lang
source_file = htdocs/langs/en_US/opensurvey.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.orders]
file_filter = htdocs/langs/<lang>/orders.lang
source_file = htdocs/langs/en_US/orders.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.other]
file_filter = htdocs/langs/<lang>/other.lang
source_file = htdocs/langs/en_US/other.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.paybox]
file_filter = htdocs/langs/<lang>/paybox.lang
source_file = htdocs/langs/en_US/paybox.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.paypal]
file_filter = htdocs/langs/<lang>/paypal.lang
source_file = htdocs/langs/en_US/paypal.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.printing]
file_filter = htdocs/langs/<lang>/printing.lang
source_file = htdocs/langs/en_US/printing.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.productbatch]
file_filter = htdocs/langs/<lang>/productbatch.lang
source_file = htdocs/langs/en_US/productbatch.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.products]
file_filter = htdocs/langs/<lang>/products.lang
source_file = htdocs/langs/en_US/products.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.projects]
file_filter = htdocs/langs/<lang>/projects.lang
source_file = htdocs/langs/en_US/projects.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.propal]
file_filter = htdocs/langs/<lang>/propal.lang
source_file = htdocs/langs/en_US/propal.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.receiptprinter]
file_filter = htdocs/langs/<lang>/receiptprinter.lang
source_file = htdocs/langs/en_US/receiptprinter.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.resource]
file_filter = htdocs/langs/<lang>/resource.lang
source_file = htdocs/langs/en_US/resource.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.salaries]
file_filter = htdocs/langs/<lang>/salaries.lang
source_file = htdocs/langs/en_US/salaries.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.sendings]
file_filter = htdocs/langs/<lang>/sendings.lang
source_file = htdocs/langs/en_US/sendings.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.sms]
file_filter = htdocs/langs/<lang>/sms.lang
source_file = htdocs/langs/en_US/sms.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.stocks]
file_filter = htdocs/langs/<lang>/stocks.lang
source_file = htdocs/langs/en_US/stocks.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.suppliers]
file_filter = htdocs/langs/<lang>/suppliers.lang
source_file = htdocs/langs/en_US/suppliers.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.supplier_proposal]
file_filter = htdocs/langs/<lang>/supplier_proposal.lang
source_file = htdocs/langs/en_US/supplier_proposal.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.trips]
file_filter = htdocs/langs/<lang>/trips.lang
source_file = htdocs/langs/en_US/trips.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.users]
file_filter = htdocs/langs/<lang>/users.lang
source_file = htdocs/langs/en_US/users.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.withdrawals]
file_filter = htdocs/langs/<lang>/withdrawals.lang
source_file = htdocs/langs/en_US/withdrawals.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.website]
file_filter = htdocs/langs/<lang>/website.lang
source_file = htdocs/langs/en_US/website.lang
source_lang = en_US
type = MOZILLAPROPERTIES

[dolibarr.workflow]
file_filter = htdocs/langs/<lang>/workflow.lang
source_file = htdocs/langs/en_US/workflow.lang
source_lang = en_US
type = MOZILLAPROPERTIES
</source>

这里有专门解释config配置文件的章节哦：

<nowiki>[main] section</nowiki>

本章节中我们有项目范围的选项，默认transifex为全部的项目的服务器。你也可以自建服务器然后需要修改这里相对应的选项。、

<nowiki>[dolibarr.resource]</nowiki>

source_lang: 这是资源的源语言.<br/>
source_file: 这直接指向源文件.<br/>
file_filter: 在这里，我们保持用于识别特定项目下的翻译文件的表达式。 ''not mandatory''<br/>
trans.<lang>: 这是用于翻译的文件，不遵循一个共同的命名模式和文件的表达不能被用来跟踪他们。 ''not mandatory''<br/>
host: 万一项目不使用默认的Transifex服务器那么就在 [main] 这里标记设定, it can override it using this option. ''not mandatory''<br/>

====TX 使用方法简要说明====
一些有用的TX命令的 '''tx''' 帮助信息.

'''tx status'''

显示翻译状态

'''tx push'''

使用push命令将你本地计算机中的翻译文件push上传到Transifex服务器<br>
更多的tx push命令的帮助信息如下:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to push (defaults to all)
-r <resource> - Specify the resource for which you want to push the translations (defaults to all)
-f - Push source files without checking modification times
--skip - Don't stop on errors. Useful when pushing many files concurrently.
-s - Push the source file to the server
-t - Push the translation files to the server
--no-interactive - Don't require user input when forcing a push</pre></code>

'''tx pull'''

使用pull命令将Transifex服务器的翻译文件pull下载到你本地计算机中<br/>
更多的tx pull命令的帮助信息如下:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.</pre></code>

'''示例'''

从transefix拉取翻译文件回来, 可用如下命令:

<source lang="bash">
tx -d pull -l zh_CN # 仅拉取简体中文语言
tx -d pull -a # 拉取全部语言
</source>

推送本地翻译源文件到transefix去, 输入以下命令即可:

<source lang="bash">
tx -d push -t -l zh_CN [-r dolibarr.file] # 仅推送指定的zh_CN简体中文语言的翻译源文件到trasefix去
tx -d push -s # To push source file
</source>

=== 有关 transifex 的其他问题 ===
下面是三个 transifex 翻译相关的疑问及官方解答:

1) 这是定期同步到Dolibarr中去的吗？定期多久呢 ?

不。这不是定期的。因此也不存在定期多久的问题。当翻译的提交足够多的时候。这些翻译结果也作为 beta branch 分支或者最终稳定版本中使用。

2) Are all the translations synced to git, or only the reviewed translations. Do I need to review before sync is done ?

When a Sync is done, transifex files overwrites files into git, but only if there is at least on record modified for the file.
You don't have to make review before sync is done. Making review is above all to know which lines were manually reviewed and which one were initially translated using a robot.

3) In which Dolibarr releases will translations be available ? Are transifex translations also synced to maintenance releases ?

Sync is always done on develop and/or beta.
So transifex changes appear in all version whose branch is created after the transifex change (a sync is always done before creating a new branch). Once a branch is created, then new changes into transifex will be available only for next branch. Reason of this is that transifex is not able to manage branch/versions (not yet).

== Manual Translation (not recommended) ==

To translate Dolibarr into another language, go to the langs directory and create a folder/directory named with the code language to translate (follow the existing format, for example en_US, en_GB, es_ES, de_DE, etc...). Then copy the files from an existing language directory (for example en_US/main.lang, en_GB/bills.lang), into the new language directory that you have just created.

These files have the format of key/value pairs in each line like the followings:

<source lang="ini">
Code1 = translate phrase 1
Code2 = translate phrase 2
...
Coden = translate phrase n
</source>

Translate the phrases (the value portion of the key/value pairs) on right side of the "=" as seen above, the code (the key portion) on left side of "=" should remain unchanged. It is possible to translate the files one by one, without bringing them all at once. If a file has not been translated into the new language, Dolibarr uses English.

To have a localised (translated) string into the PHP code, all you have to do is load the language file and use the method to get the translated value, like this:

<source lang="php">
$langs->load("myfile"); // or use $langs->load("myfile@mymodule") if myfile.lang is inside directory htdocs/mymodule/langs/xx_XX

print $langs->trans("CodeX")
</source>

An entry type;

<source lang="ini">
CodeX = phrase X
</source>

must be present or added to the myfile.lang file.

== Automatic Translation with autotranslator.php tool ==

* Translator OS: All
* Tool: '''autotranslator.php''' provided with Dolibarr in directory '''dev/translation'''.
This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add missing key or correct errors, try to use method using Transifex (see later).

To make or update all files of a language code, just run the script:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
For example :
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
to translate into Portuguese (pt_PT) using English (en_US) files.

All non existing files will be created, all existing files will be updated.
The tool use [http://translate.google.com Google translation] service to find the translation value of a string, so a working Internet connection is required from station running the script. Also a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars).
Your PHP must also have permissions to write into '''htdocs/langs''' directory and must have curl functions available.

= [[File:Language.png]] Distribute or include your translation into core source =

== Including your translation in the official Dolibarr sources ==

Once you start translating, it's a smart decision to share it, so it can be included into the official code of Dolibarr.
If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.

If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.

If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.
If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.

=== Adding new variables ===

The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.

If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.

== As an extension ==
When you create a new language, if it is not already integrated into Dolibarr, it can still be broadcast to all other users. You can make a distribution package using the '''build/makepack-dolibarrlang.pl''' script or making a zip archive manually and posting it on dolistore.com or sending it to the developers' mailing list '''dolibarr-dev''' ({{TemplateURLMLDev}}).

New language files are immediately available in an installation as soon as the archive is unzipped in the correct directory.

= [[File:Language.png]] Translate documentation on wiki =
The wiki is written in 3 languages: English, French and Spanish.
If you want to enhance documentation on one of these languages, all you have to do is to create an account on this wiki.
Then, you can edit existing pages to correct a bad translation or translate pages waiting for translation [[:Category:Page_waiting_for_translation]].

Αρχική

2019-07-23T12:26:23Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="τεκμηρίωση, βοήθεια, πληροφορίες, ανάπτυξη, χρήστης, οδηγός, tutorial" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''Το εύχρηστο λογισμικό ανοιχτού κώδικα για επιχειρήσεις. Διαχειριστείτε δωρεάν και εύκολα επιχειρήσεις μικρού ή μεσαίου μεγέθους, ελ. επαγγελματίες ή ιδρύματα'''
</center>

Αυτό το wiki περιέχει όλη την τεκμηρίωση για ('''χρήστες''', '''προγραμματιστές''' και '''μεταφραστές''') και τους πόρους για το Dolibarr ERP / CRM.
Οι λήψεις είναι διαθέσιμες στη διαδικτυακή πύλη του έργου Dolibarr (μεταβείτε στο https://www.dolibarr.org ή στο https://www.dolibarr.gr).

{{Info}}{{InfoGr}}

= [[File:art.png|link=]] Το έργο =
* [[What Dolibarr Do|Τι είναι το Dolibarr ;]] - [[FAQ Who use Dolibarr|Ποιοι χρησιμοποιούν το Dolibarr ;]]
* [https://www.dolibarr.gr/online-demo.html Online demo]
* [https://www.dolibarr.gr/downloads.html Λήψεις]
* [[Dolibarr Project|Πόροι και οργάνωση του έργου]]
* [[Dolibarr foundation|Το ίδρυμα Dolibarr]]

= [[File:File_Doc_user.png|link=]] Τεκμηρίωση χρηστών =
* [[User documentation|Τεκμηρίωση χρήστη]]
* [[FAQ χρήστη|FAQ χρήστη]]
* [[Screenshots|Εικόνες]]
* [[Κέντρο υποστήριξης και βοήθειας|Κέντρο υποστήριξης και βοήθειας]] (φόρουμ της κοινότητας, εμπορική υποστήριξη...)
* [[Security informations|Πληροφορίες ασφαλείας]]

= [[File:File_Doc_dev.png|link=]] Τεκμηρίωση για προγραμματιστές =
* [[Developer documentation|Τεκμηρίωση προγραμματιστή]]
* [[Developer FAQ|FAQ προγραμματιστή]]
* [[Dolibarr Project|Πόροι και οργάνωση του έργου]]

= [[File:File_Doc_trans.png|link=]] Τεκμηρίωση για μεταφραστές =
* [[Translator documentation|Τεκμηρίωση μεταφραστή]]

= [[File:File_Doc_tester.png|link=]] Τεκμηρίωση για δοκιμαστές =
* [[Tester documentation|Τεκμηρίωση δοκιμαστή]]

Zh Main Page

2019-07-23T12:26:23Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="简体中文,documentation, help, information, development, user, guide, tutorial" />

<center>


[[File:Dolibarr logo.png|180px|link=]]

简体中文官方文档

'''别笑！用开源的Dolibarr软件系统来管理您的公司真的是轻轻松松，洒洒水啦！不信就往下翻翻看，本WIKI带你如何用Dolibarr管理公司指南入门。'''
</center>

本WIKI指南是献给用户、开发者，翻译人员三类读者的。 ('''用户''', '''开发者''' 和 '''翻译人员''' 指南文档) 以及 Dolibarr ERP/CRM的种类资源。
可从 Dolibarr 官方网站下载到 (官网： https://www.dolibarr.org).

{{Info}}{{InfoZh}}

= [[File:art.png|link=]] Dolibarr简介 =
* [[Dolibarr是什么？|这是啥 ?]] - [[Zh FAQ Who use Dolibarr|谁用啊?]]
* [http://www.dolibarr.org/onlinedemo 在线demo演示]
* [http://www.dolibarr.org/downloads/ 下载地址]
* [[Dolibarr Project|项目组织架构以及资源]]
* [[Dolibarr foundation|Dolibarr 基金会]]

= [[File:File_Doc_user.png|link=]] 用户手册 =
* [[User documentation|用户手册]]
* [[User FAQ|用户常见问题及解答]]
* [[Screenshots|截图]]
* [[Dolibarr help and support|帮助和支持]] (社区，论坛，商业等支持...)
* [[Security informations|安全信息]]

= [[File:File_Doc_dev.png|link=]] 开发指南 =
* [[Developer documentation|开发文档]]
* [[Developer FAQ|开发常见问题及解答]]
* [[Dolibarr Project|项目组织架构以及资源]]

= [[File:File_Doc_trans.png|link=]] 翻译人员帮助文档 =
* [[Translator documentation|翻译人员帮助文档]]

= [[File:File_Doc_tester.png|link=]] 测试人员指南 =
* [[Tester documentation|测试人员指南]]

User documentation

2019-07-23T12:26:23Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="user, documentation, guide, doc, tutorial, usage, help" />
This page is the main index of documents relating to user documentation. For developer documentation, [[Developer documentation|see here]].

= Dolibarr and modules =

== Features ==
* [[What Dolibarr Do|What Dolibarr can do]]
* [[What Dolibarr can't do|What Dolibarr can't do]]

== Installation/Setup/Upgrade ==
* [[Prerequisite|Prerequisites]]
* [[Installation - Upgrade]]
* [[First setup|Setup]]

== Usage (by modules) ==
Knowing how to use Dolibarr is knowing its modules, menus, and features.
First, once the installation step is complete (see previous chapters), let's have a look at general information on usage:
* [[General information on usage]] (First steps).

Once general usage is understood, you can have a look at the documentation about all standard business modules. Choose the module you are interested in to see such documentation:

* Standard modules are modules available by default in all common installation. List of standard modules is defined on the page [[:Category:List of Modules|List of Modules]]
* External modules are modules you can get on other sources than official sources. They are provided by third parties. Most of them can be found in the marketplace https://www.dolistore.com. List of external modules is defined on the page [[:Category:Complementary modules|Complementary modules]].

== Administration ==
* [[Mass_imports|Mass imports]] / [[ExportsEn|Exports]]
* [[Backups]] / [[Restores]]

= Other sources of documentation =
* [http://doc.ubuntu-fr.org/dolibarr#dolibarr Ubuntu doc] (French)

= Glossary =
See page [[Glossary]]

= FAQ =
All FAQ are available through the index page [[:Category:FAQ EN|FAQ EN]]
[[Category:Proofreading done]]

Translator documentation

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="translation, documentation, translator, localize, localization, i18n, internationalization, language" />

= [[File:Language.png]] Translate Dolibarr Application into your language =

Dolibarr language files are already translated in several languages.
English is the default and always complete. Other languages depend on contributions. This tutorial can help you complete a translation for a language not yet available or somehow incorrect.
Dolibarr can be translated by three different means:

# Manually using Transifex (Official and recommended method).
# Manually editing language files
# Completely automatic: autotranslator

== Manual Translation using Transifex online service (recommended) ==

Transifex is a web application that provides an online platform for translation projects. It includes teams and discussion tools, translation memory, glossary, proofreading and a lot of other features.
It is quite easy to use and all translations can be uploaded and downloaded through the web interface or using their TX client from a terminal.
Transifex is an open source project and the "community edition" can be freely downloaded and installed, but we will use the online hosted service.

===Using the web interface (for translators)===
If you want to help to translate Dolibarr in your own language, check the project's page at https://www.transifex.com/dolibarr-association/dolibarr/

You can then register an account and request joining the project team for the language(s) you're targeting. A manager will have to accept your request, so please be patient.

Once accepted, you can start translating right away.

For more information, please check Transifex "Getting Started" introduction at http://docs.transifex.com/introduction/translators/ and the web editor tutorial at http://docs.transifex.com/tutorials/txeditor/

===='''Note about en_US'''====
The web interface can not be used to translate the en_US language which is source.

Any change for en_US language must be done in Dolibarr source code and submitted using a Pull Request on our GitHub repository.

=== Using TX command line client (for Dolibarr [[:Category:Yoda]] team) ===
This describes how to use Transifex from the command line. However, this is reserved to Dolibarr admin users to synchronize Transifex with Dolibarr main sources.

More information can also be found on the [http://docs.transifex.com/developer/client/ Transifex Official documentation]

====TX Client configuration====
First install TX Client.
With Debian/Ubuntu/Mint:
<source lang="bash">
apt-get install python-pip
pip install transifex-client
</source>
Then you have to initialize your TX environment. This is done by running '''tx init''' into dolibarr project root directory.
<source lang="bash">
cd git/dolibarr
tx init
</source>
Accept to overwrite config file. Keep default value for Transifex instance, then enter your Transifex login and password.

After this, a .transifexrc has been created into your HOME dir and a generic config file has been created as '''.tx/config''' in project's root.
So your directory's contents will look like that:
<code><pre>
.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx
</pre></code>

The current config file can be downloaded from https://github.com/Dolibarr/dolibarr/tree/develop/.tx , put it into .tx directory, overwriting the one created by '''tx init'''

This project configuration file is used to store the project’s details and the file-to-resource mappings.

That is a sample of what the config file contains:

<source lang="ini">
[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES
</source>

Here is an explanation of the sections and options used in the config file:

<nowiki>[main] section</nowiki>

In this section, we have project-wide options, such as the default transifex host for all projects. These can be overridden by each resource, in case it is needed.

<nowiki>[dolibarr.resource]</nowiki>

source_lang: this is the source language of the resource.<br/>
source_file: this points to the source file directly.<br/>
file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory''<br/>
trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. ''not mandatory''<br/>
host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. ''not mandatory''<br/>

====TX Client use====
Some useful information on '''tx''' commands.

'''tx status'''

Show status of translations

'''tx push'''

Used to push changes from your computer to Transifex server<br>
Additional options for the tx push command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to push (defaults to all)
-r <resource> - Specify the resource for which you want to push the translations (defaults to all)
-f - Push source files without checking modification times
--skip - Don't stop on errors. Useful when pushing many files concurrently.
-s - Push the source file to the server
-t - Push the translation files to the server
--no-interactive - Don't require user input when forcing a push</pre></code>

'''tx pull'''

Used to pull changes from Transifex server to your computer<br/>
Additional options for the tx pull command are:
<code><pre>
-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from the server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.</pre></code>

'''Examples'''

To pull translation files, you can use:

<source lang="bash">
tx -d pull -l it_IT # Get italian language only
tx -d pull -a # Get all languages
</source>

To push source files, just type:

<source lang="bash">
tx -d push -t -l it_IT [-r dolibarr.file] # To push only a specific translation file
tx -d push -s # To push source file
</source>

=== Other questions on transifex process ===
This is short questions and answers you may also ask about transifex translation process:

1) Is the sync on a regular time interval?

No. It is done where there is enough translation submitted. It is also done on a beta branch just before creating the final release package.

2) Are all the translations synced to git or only the reviewed translations? Do I need to review before sync is done?

When a Sync is done, transifex files overwrites files into git, but only if there is at least on record modified for the file.
You don't have to make a review before sync is done. Making review is above all to know which lines were manually reviewed and which one was initially translated using a robot.

3) In which Dolibarr releases will translations be available? Are transifex translations also synced to maintenance releases?

Sync is always done on develop and/or beta.
So transifex changes appear in all version whose branch is created after the transifex change (a sync is always done before creating a new branch). Once a branch is created, the new changes into transifex will be available only for the next branch. The reason for this is that transifex is not able to manage branch/versions (not yet).

== Manual Translation (not recommended) ==

To translate Dolibarr into another language, go to the langs directory and create a folder/directory named with the code language to translate (follow the existing format, for example en_US, en_GB, es_ES, de_DE, etc...). Then copy the files from an existing language directory (for example en_US/main.lang, en_GB/bills.lang), into the new language directory that you have just created.

These files have the format of key/value pairs in each line like the followings:

<source lang="ini">
Code1 = translate phrase 1
Code2 = translate phrase 2
...
Coden = translate phrase n
</source>

Translate the phrases (the value portion of the key/value pairs) on the right side of the "=" as seen above, the code (the key portion) on the left side of "=" should remain unchanged. It is possible to translate the files one by one, without bringing them all at once. If a file has not been translated into the new language, Dolibarr uses English.

To have a localised (translated) string into the PHP code, all you have to do is load the language file and use the method to get the translated value, like this:

<source lang="php">
$langs->load("myfile"); // or use $langs->load("myfile@mymodule") if myfile.lang is inside directory htdocs/mymodule/langs/xx_XX

print $langs->trans("CodeX")
</source>

An entry type;

<source lang="ini">
CodeX = phrase X
</source>

must be present or added to the myfile.lang file.

== Automatic Translation with autotranslator.php tool ==

* Translator OS: All
* Tool: '''autotranslator.php''' provided with Dolibarr in directory '''dev/translation'''.
This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add a missing key or correct errors, try to use method using Transifex (see later).

To make or update all files of a language code, just run the script:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
For example :
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
to translate into Portuguese (pt_PT) using English (en_US) files.

All nonexisting files will be created, all existing files will be updated.
The tool use [http://translate.google.com Google translation] service to find the translation value of a string, so a working Internet connection is required from station running the script. Also, a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars).
Your PHP must also have permissions to write into '''htdocs/langs''' directory and must have curl functions available.

= [[File:Language.png]] Distribute or include your translation into core source =

Once you start translating, it's a smart decision to share it, so it can be included in the official code of Dolibarr.
If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.

If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.

If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.
If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.

Note:

The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.

If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.

= [[File:Language.png]] Translate documentation on wiki =
The wiki is written in 3 languages: English, French, and Spanish.
If you want to enhance documentation on one of these languages, all you have to do is to create an account on this wiki.
Then, you can edit existing pages to correct a bad translation or translate pages waiting for translation [[:Category:Page_waiting_for_translation]].

Statistics

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="statistics, stats, stat, reporting, report, history" />
{{Flag en}} The vocation of this page is to aggregate some statistics about Dolibarr project.

{{Flag fr}} Le but de cette page est de centraliser l'historique de nombreuses statistiques sur le projet Dolibarr.

{{Flag sp}} El propósito de esta página es centralizar las numerosas estadísticas del proyecto Dolibarr.

= References/Referencias =
It is difficult to say how many users use Dolibarr as we don't have this information: As any Opensource software, Dolibarr can be downloaded from any external source we don't have statistics for.
But we can provide information from the main download server (that is sourceforge.net). Real values (included all other distribution sources around world, like downloads.cnet.com, launchpad, hand to hand usb key, and any other software annuary, bittorrent or any ftp mirrors) may be 2 or 10 times more important.

{| border="0" rules="all" cellpadding="2" cellspacing="0" style="margin: 0 0 10px 1px; border: 1px solid #dddddd; border-right-width: 1px; border-bottom-width: 1px; background-color: #fcfcfd; -moz-border-radius: 5px;"
|style="background-color: #eeeeee;"|Source/Date||style="background-color: #eeeeee;"|2008-12||style="background-color: #eeeeee;"|2010-02||style="background-color: #eeeeee;"|2011-03||style="background-color: #eeeeee;"|2012-02||style="background-color: #eeeeee;"|2013-12
|-
||Sourceforge server (nb of downloads/week)||500||1050||1350||2130||2180
|-
||Estimate value from all download sources (nb of downloads/week)||x2||x2||x2||x2||x2
|}

Note: Detailed statistics can be download from sourceforge API:
* For standard distribution: https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/stats/json?start_date=2013-01-01&end_date=2013-12-31
* For windows installer: https://sourceforge.net/projects/dolibarr/files/Dolibarr%20installer%20for%20Windows%20(DoliWamp)/stats/json?start_date=2013-01-01&end_date=2013-12-31
* For rpm installer: https://sourceforge.net/projects/dolibarr/files/Dolibarr%20installer%20for%20Fedora-Redhat-Mandriva-Opensuse%20(DoliRpm)/stats/json?start_date=2013-01-01&end_date=2013-12-31
* For debian installer: https://sourceforge.net/projects/dolibarr/files/Dolibarr%20installer%20for%20Debian-Ubuntu%20(DoliDeb)/stats/json?start_date=2013-01-01&end_date=2013-12-31

= Google insights =
See page http://www.google.com/trends/explore#q=dolibarr&date=1%2F2011%2012m%2C%201%2F2012%2012m%2C%201%2F2013%2012m&cmpt=date

{| border="0" rules="all" cellpadding="2" cellspacing="0" style="margin: 0 0 10px 1px; border: 1px solid #dddddd; border-right-width: 1px; border-bottom-width: 1px; background-color: #fcfcfd; -moz-border-radius: 5px;"
|Date||2009||2010||2011||2012||2013
|-
||Result of Google insight ||42||55||59||71||81
|}

= Translation/Traductions/Traducciones =

See page: https://www.transifex.com/projects/p/dolibarr/

To help to improve this statistics, please read page [[Translator documentation]].

= Coding =
See page https://www.ohloh.net/p/dolibarr/analyses/latest

= Social Networks =
{| border="0" rules="all" cellpadding="2" cellspacing="0" style="margin: 0 0 10px 1px; border: 1px solid #dddddd; border-right-width: 1px; border-bottom-width: 1px; background-color: #fcfcfd; -moz-border-radius: 5px;"
|Date||End 2012||End 2013
|-
||Facebook followers||600||10074
|-
||Google+ page plusone||210||376
|-
||Google+ page followers||0||63
|-
||Twitter followers||110||325
|-
||Linked In group members||163||229
|-
||Youtube channel||60||71
|}

= DoliStore =
Source: Dolistore admin backoffice -> Stats -> Catalog statistics

{| border="0" rules="all" cellpadding="2" cellspacing="0" style="margin: 0 0 10px 1px; border: 1px solid #dddddd; border-right-width: 1px; border-bottom-width: 1px; background-color: #fcfcfd; -moz-border-radius: 5px;"
|style="background-color: #eeeeee;"|Date||style="background-color: #eeeeee;"|End 2012||style="background-color: #eeeeee;"|End 2013
|-
||Number of products available||98||187
|-
|}

= Web site statistics / Statistics des sites / Estadísticas Web sites =
{| border="0" rules="all" cellpadding="2" cellspacing="0" style="margin: 0 0 10px 1px; border: 1px solid #dddddd; border-right-width: 1px; border-bottom-width: 1px; background-color: #fcfcfd; -moz-border-radius: 5px;"
|style="background-color: #eeeeee;"|Date||style="background-color: #eeeeee;"|2008-12||style="background-color: #eeeeee;"|2010-02||style="background-color: #eeeeee;"|2011-03||style="background-color: #eeeeee;"|2012-01
|-
||Web site http://www.dolibarr.org ||9000 visits/month* ||16467 visits/month*||24240 visits/month*||31800 visits/month*
|-
||Demo http://demo.dolibarr.org ||3100 visits/month ||3563 visits/month||6209 visits/month||7838 visits/month
|-
||Wiki http://wiki.dolibarr.org ||3000 visits/month<br>300 pages||8858 visits/month<br>674 pages||12050 visits/month<br>765 pages||20331 visits/month<br>830 pages
|-
||Forum http://www.dolibarr.org/forum ||1280 users**||3084 users**||3408 users**||3903 users**
|}
Note: * Source [http://awstats.sourceforge.net AWStats]

Note: ** This is for english forum only. You must also add values for localized dedicated forums (french, spanish, ...) not included here.

Solutions Cloud pour Dolibarr ERP CRM

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Admin]]
[[Category:Cloud]]
<seo metak="Cloud, SaaS, Dolibarr, hébergement, logiciels, ligne, fournisseur, sftp, rsync" />
__NOTOC__
'''Dolibarr ERP & CRM''' (PGI & GRC en français) est conçu pour fonctionner aussi bien comme programme autonome sur votre machine, que comme application hébergée sur le web dans une infrastructure Cloud, accessible de partout (bureau, tablettes, smartphones). En utilisant un hébergement tiers, vous pouvez aussi éviter d'avoir à vous occupez des taches techniques (pas d'installation, mise à jour, supervision ou sauvegardes à faire pour vous).

Cette page recense les principaux services permettant de disposer de Dolibarr en '''SaaS ou Cloud'''. Si vous recherchez plutôt un partenaire intégrateur ou développeur, voyez sur la page [[List of Dolibarr partners and providers]].

<center>
[[File:Cloud solutions.png|350px]]
</center>

= Pour les solutions Cloud "Préconfigurées" =

== Recommandé (Dolibarr Preferred Partners) ==
Critères de tri: 1) "Souscription automatisé temps réel" (oui en premier), 2) "Age de l'offre" (plus anciens en premier)

{{CloudService
|name=DoliCloud
|logo=Dolicloud_logo.png‎
|intro=
* Utiliser votre ERP & CRM depuis n'importe où.
* Hébergement non captif sans engagement de durée (vous gardez un accès complet permanent à vos bases/fichiers, accès SSH, SFTP et base MySql/MariaDb direct inclut)
* Sauvegarde journalière
* Prise en charge de la mise à jour vers les nouvelles versions
* Assistance en Français et Anglais (y compris aide à la migration)
* Résiliation possible à tout moment en ligne
* Possibilité d'obtenir une attestation Loi Finance (sur demande) pour les clients Français.

'''Essayer immédiatement, pendant 15 jours, l'offre Dolibarr en Cloud, incluant mises à jour gratuites et support sur [https://myaccount.dolicloud.com/register.php?origin=wikicloudfr&utm_source=wikicloudfr&utm_campaign=none&utm_medium=web DoliCloud]'''
<br>
|web=[https://www.dolicloud.com?utm_source=wikicloudfr&utm_campaign=none&utm_medium=web https://www.dolicloud.com]
|registration=Via le [https://myaccount.dolicloud.com/register.php?origin=wikicloudfr&utm_source=wikicloudfr&utm_campaign=none&utm_medium=web formulaire du site DoliCloud], création immédiate gratuite, instance prête en 1 minute.
|note=Certifié [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=NovaFirstCloud par Teclib
|logo=NovaFirstcloud.png‎
|intro=
* Tout l'ERP CRM Dolibarr
* Support technique et migration inclus
* Sauvegarde journalière
* Sans engagement
* Possibilité d'obtenir une attestation Loi Finance (sur demande) pour les clients Français.

'''Instance prête en 30 secondes depuis [https://myaccount.novafirstcloud.com/register.php?origin=wikicloudfr&utm_source=wikicloudfr&utm_campaign=none&utm_medium=web NovaFirstCloud]'''. Possibilité de tarification sur mesure.
<br>
Teclib est une entreprise spécialisé dans l'OpenSource possédant de nombreuses agences en France et Espagne<br>
|web=[https://www.novafirstcloud.com?utm_source=wikicloudfr&utm_campaign=none&utm_medium=web https://www.novafirstcloud.com]
|registration=[https://myaccount.novafirstcloud.com/register.php?origin=wikicloudfr&utm_source=wikicloudfr&utm_campaign=none&utm_medium=web From this form], prête en 30 secondes
|note=
}}

{{CloudService
|name=ATM Consulting
|logo=LogoATM.jpg
|intro=
Gérez votre entreprise en toute sérénité sans vous soucier de l'informatique. Optez pour le logiciel Dolibarr ERP-CRM en mode hébergé et bénéficiez du savoir faire technique de l'équipe ATM Consulting et de tous les avantages de la solution SaaS (Software as a Service) :
* Accès à Dolibarr depuis n'importe où, via une connexion internet.
* Solution Cloud sans engagement de durée.
* Pas d'installation technique à faire.
* Sauvegarde quotidienne des données.
* Accès à l'assistance fonctionnelle et technique.

'''Contactez-nous et profitez de notre offre en essayant le logiciel pendant 30 jours gratuitement.'''
<br>
|web=http://www.atm-consulting.fr/
|registration=Besoin de prendre contact auparavant via: http://www.atm-consulting.fr/contact-dolibarr/
|note=Certifié [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=iNodbox
|logo=Inodbox_transparent_540x130.png
|web=https://www.inodbox.com
|intro=

Centralisez vos informations de manière simple et sécurisée pour une gestion efficace de votre activité.

'''Plus de 10 ans d'expérience sur Dolibarr !'''
* Utiliser votre ERP & CRM depuis n'importe où en toute sécurité.
* Accès par VPN offert.
* Accès par une application externe à Mysql ou Postgresql possible.
* Accès à un partage réseau (SAMBA) offert.
* Nos hébergements Dolibarr ne sont accessible qu'en mode sécurisé. (SFTP, SSL, https).
* Possibilité de connecter votre E-Commerce.
* Sauvegarde horaire et journalière.
* Le support de premier niveau est gratuit.

'''Votre gestion commerciale clé en main en moins de 5 minutes !'''
<br>
|registration=Contactez nous: info@inodbox.com
|note=Certifié [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=Tiaris
|logo=Logotiaris.jpg
|intro=Solution Dolibarr hébergée spécialement adaptée aux e-commerçants basée sur le module e-commerce
* pour sites Prestashop; Opencart Oscommerce (site non inclus)
* optimisé avec des modules complémentaires CRM, Logistique, traitements de masse
* installé et maintenu par Tiaris
* essais gratuit un mois
<br>
- Solution for e-merchands with the e-commerce System for Dolibarr.
* for sites your Prestashop; Opencart Oscommerce (sites not included in offer)
* modules for optimisation : CRM, Logistiks, mass-treatments
* installed and configured by us
* 30 days free for testing
|web=http://www.tiaris.eu
|registration=Veuillez nous contacter - Please contact us
|note=Certifié [[File:Dolibarr preferred partner int.png|100px]]
}}

== Alternatives (non garanties par l'association) ==
Critères de tri: 1) "Souscription automatisé temps réel" (oui en premier), 2) "Age de l'offre" (plus anciens en premier)

{{CloudService
|name=Webuzo
|logo=
|web=https://www.webuzo.com
|registration=Depuis le site web
|note=
}}

{{CloudService
|name=BitNami
|logo=
|web=https://bitnami.com/stack/dolibarr
|registration=Depuis le site web
|note=
}}

{{CloudService
|name=Mon-Dolibarr
|logo=
|intro=Intégration Dolibarr, accompagnement et assistance (En français).
|web=https://www.mon-dolibarr.fr
|registration=Depuis le site web
|note=
}}

{{CloudService
|name=Ma Gestion Cloud
|logo=
|intro=Gestion Cloud
|web=https://www.ma-gestion-cloud.fr/
|registration=Depuis le site web
|note=
}}

= Pour les solutions Cloud "Faites le vous-même" =
Voici une documentation pour expliquer comment installer Dolibarr sur la plupart des Solutions Cloud connues...

* [[Cloud with Redhat OpenShift Flex]]
* [[Cloud with Amazon EC2]]
* [[Cloud with Windows Azure]]
* [[Cloud with Google Cloud]]
* [[Cloud with Zend PHPCloud]] (service fermé)

Soluciones en la Nube

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Admin]]
[[Category:Cloud]]
<seo metak="Cloud, nube, Dolibarr, web, aplicación, sftp, rsync" />
__NOTOC__
'''Dolibarr ERP & CRM''' es conocido por funcionar tanto como programa en su máquina como por aplicación web o aplicación albergada en una infrastuctura Cloud (en la Nube)

<center>
[[File:Cloud solutions.png|350px]]
</center>

= Para soluciones en la Nube "Listas para usar" =
== Dolibarr Preferred Partner ==
{{CloudService
|name=DoliCloud
|logo=Dolicloud_logo.png‎
|web=[https://www.dolicloud.com?utm_source=wikicloudes&utm_campaign=none&utm_medium=web https://www.dolicloud.com]
|registration=A través del [https://myaccount.dolicloud.com/register.php?origin=wikicloudes&utm_source=wikicloudes&utm_campaign=none&utm_medium=web formulario de DoliCloud], listo en 1 minuto
|note=Certified [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=NovaFirstCloud - Teclib
|logo=NovaFirstcloud.png‎
|web=[https://www.novafirstcloud.com?utm_source=wikicloudes&utm_campaign=none&utm_medium=web https://www.novafirstcloud.com]
|registration=A través del [https://myaccount.novafirstcloud.com/register.php?origin=wikicloudes&utm_source=wikicloudes&utm_campaign=none&utm_medium=web formulario de NovaFirstCloud], listo en 1 minuto
|note=Certified [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=ATM Consulting
|logo=
|web=http://www.atm-consulting.fr/nos-offres/dolibarr-en-mode-saas/
|registration=Necesita ponerse en contacto con la empresa: http://www.atm-consulting.fr/contact/
|note=Certified [[File:Dolibarr preferred partner int.png|100px]]
}}

{{CloudService
|name=Inodbox
|logo=
|web=http://www.inodbox.com
|registration=Necesita ponerse en contacto por email con la empresa
|note=Certified [[File:Dolibarr preferred partner int.png|100px]]
}}

== Otra infrastuctura ==
{{CloudService
|name=OVH One Click
|logo=
|web=http://www.ovh.com
|registration=From OVH control panel
|note=
}}

{{CloudService
|name=Webuzo
|logo=
|web=http://www.webuzo.com
|registration=From web site
|note=
}}

{{CloudService
|name=DivaCloud
|logo=
|web=http://www.diva-cloud.com/
|registration=From web site
|note=
}}

{{CloudService
|name=BitNami
|logo=
|web=http://www.bitnami.com/
|registration=From web site
|note=
}}

= Para soluciones en la Nube "Hágalo usted mismo" =
Le presentamos una documentación para explicarle como instalar Dolibarr en la mayor parte de las soluciones en la Nube conocidas...

* [[Cloud with Redhat OpenShift Flex]]
* [[Cloud with Amazon EC2]]
* [[Cloud with Windows Azure]]
* [[Cloud with Google Cloud]]
* [[Cloud with Zend PHPCloud]] (servicio gratuito en fase beta, usar solo para pruebas)

Página Principal

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="documentation, help, information, development, user, guide, tutorial" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''The easy to use OpenSource software for business. Be free to manage your small and medium company, freelance or foundation activity'''
</center>

Este wiki contém toda a documentação (documentação de '''utilizadores''', '''desenvolvedores''' e '''tradutores''') e recursos sobre o Dolibarr ERP/CRM.
As transferências estão disponíveis no portal da Web do projeto Dolibarr (visite http://www.dolibarr.org).

{{Info}}{{InfoPT}}

= [[File:art.png|link=]] O projeto =
* [[What Dolibarr Do|O que é o Dolibarr?]] - [[FAQ Who use Dolibarr|Quem utiliza o Dolibarr?]]
* [http://www.dolibarr.org/onlinedemo Demonstração On-line]
* [http://www.dolibarr.org/downloads/ Transferências]
* [[Dolibarr Project|Resources and project organization]]
* [[Dolibarr foundation|A fundação Dolibarr]]

= [[File:File_Doc_user.png|link=]] Documentação dos Utilizadores =
* [[User documentation]]
* [[User FAQ]]
* [[Screenshots]]
* [[Dolibarr help and support|Help and support center]] (community forum, commercial support...)
* [[Security informations]]

= [[File:File_Doc_dev.png|link=]] Documentaçãos dos Desenvolvedores =
* [[Developer documentation]]
* [[Developer FAQ]]
* [[Dolibarr Project|Resources and project organization]]

= [[File:File_Doc_trans.png|link=]] Documentação dos Tradutores =
* [[Translator documentation]]

= [[File:File_Doc_tester.png|link=]] Documentação dos Utilizadores de Teste =
* [[Tester documentation]]

Portada

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="documentación, ayuda, información, desarrollo, guía del usuario, tutorial" />
<center>


[[File:Dolibarr_logo.png|180px|link=]]

'''El software de código abierto de uso sencillo para para sus negocios. Siéntase libre en la gestión de su PYME, actividad independiente o su asociación.'''
</center>

Este wiki contiene toda la documentación (tanto para '''usuarios''' como para '''desarrolladores''' y '''traductores''') y recursos del proyecto Dolibarr. Las descargas se pueden realizar desde el portal web (https://www.dolibarr.org, o por la variante hispanoparlante https://www.dolibarr.es)

{{Info}}{{InfoEs}}

= [[File:art.png|link=]] El proyecto =
* [[Lo que hace Dolibarr|¿Qué es Dolibarr?]] - [[Quien usa Dolibarr|¿Quién usa Dolibarr?]]
* [https://www.dolibarr.org/onlinedemo Demo]
* [https://www.dolibarr.org/downloads/ Descargas]
* [[Proyecto_Dolibarr|Recursos y organización del proyecto]] (quién hace qué, qué hacer cuando...)
* [[Asociación Dolibarr|La asociación Dolibarr]]

= [[File:File_Doc_user.png|link=]] Documentación Usuarios =
* [[Documentación usuarios|Documentación Usuarios]]
* [[FAQ_Usuarios|FAQ Usuarios]]
* [[Capturas de pantalla]]
* [[Asistencia Dolibarr]] (Forum comunitario, soporte o servicios comerciales...)
* [[Información de seguridad]]

= [[File:File_Doc_dev.png|link=]] Documentación Desarrolladores =
* [[Documentación Desarrolladores]]
* [[FAQ Desarrolladores]]
* [[Proyecto_Dolibarr|Recursos y organización del proyecto]]

= [[File:File_Doc_trans.png|link=]] Documentación Traductores =
* [[Documentación traductores]]

= [[File:File_Doc_tester.png|link=]] Documentación Testeadores =
* [[Copias de seguridad|Guardar los datos antes de actualizar]]
* [[Utilice sus datos para probar la última versión]]

Module Woocommerce EN

2019-07-23T12:26:22Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:Woocommerce]]
[[Category:E-commerce]]
<div style="text-align:center; float:right; font-size:80%; background: #eef; border: 1px solid #ccf; margin-bottom: 0px; margin-left: 2px; margin-right: 2px; padding: 1px; height: 92px">
[[Documentation Développeur|Retour index<br>Documentation développeur]]<br>
[[File:File_Doc_dev.png|link=Documentation Développeur]]</div>

<div style="text-align:center; float:right; font-size:80%; background: #eef; border: 1px solid #ccf; margin-bottom: 0px; margin-left: 2px; margin-right: 2px; padding: 1px; height: 92px; min-width: 100px;">
[[User documentation|Return to user<br>documentation index]]<br>
[[File:File_Doc_user.png|link=User documentation]]
</div>

<seo metak="Woocommerce, Dolibarr, synchro, synch, interface"/>
= Overview =
{| border="0" width="100%" cellpadding="0" cellspacing="0" class="dolbox"
|-
|valign="top" style="max-width: 200px" | Module Name ||WooSync
|-
|| Editor / Editeur ||[https://www.open-dsi.fr Open-DSI]
|-
|| Download or buy page / Page achat ou téléchargement||
* [https://www.dolistore.com/fr/modules/851-Woosync.html dolistore]<br>
* [https://www.open-dsi.fr/produit/souscription-annuelle-woosync/ boutique open-dsi]
|-
|| Status / Statut / Estado ||Stable
|-
|| Prerequisites / Prérequis||
* Dolibarr min version 4.x
* Woocomerce min version 3.x
|-
|| Last update date / Date mise à jour fiche / Fecha última actualización || {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY}}
|-
| valign="top"| Note / Nota || WooSync is a fork of [https://www.dolistore.com/fr/modules/729-ECommerceNG---Module-Synchro-Magento.html EcommerceNG] developed by TecLib
|}

= Feature/Plugin =
WooSync synchronizes data between WooCommerce and Dolibarr : thirdparties and contacts, products, orders... automatically from Dolibarr to WooCommerce and manually from WooCommerce to Dolibarr.

= Development =
The development of this module is not included into the standard GIT repository of Dolibarr; but inside a dedicated repository, managed by Open-DSI.
* GIT Repository: https://github.com/OPEN-DSI/ecommerceng

= Installation =
WooSync module has to be installed in your Dolibarr directory <code>htdocs/custom</code> to work properly. To connect to Woocommerce app, Dolibarr uses by default Woocommerce's WebServices (REST API v2).

== Dolibarr module ==
* Download the archive file of module (.zip file)
* Unzip the folder into the <code>htdocs/custom</code> directory of your Dolibarr.
* Module is then visible into list of available modules (<span style="font-variant: small-caps;">Home > Setup > Modules/applications</span>) and can be activated.

== Setup on Woocomerce side ==
* The option <span style="font-variant: small-caps;">Enable guest checkout</span> had better be disabled;<br>
* The <span style="font-variant: small-caps;">New User Default Role</span> has to be set on "Client";<br>
* WooSync has been tested without any other application than WP Oauth server and WP Mail SMTP by WPForms.<br>

== Setup on Dolibarr side ==
From <span style="font-variant: small-caps;">Home > Setup > Other</span>, hidden rules can be enabled :
* <code>ECOMMERCENG_DISABLE_LOG_IN_NOTE</code> at <code>1</code> to disable the log in the private note of orders from WooCommerce in Dolibarr;<br>
* <code>ECOMMERCENG_SHOW_DEBUG_TOOLS</code> at <code>1</code> to show init/purge/debug tools into site page;<br>
* <code>ECOMMERCENG_DISABLED_ERROR_FOR_SOCIETE_ID_0</code> at <code>1</code> to disable the error at the creation of an order when societe id = 0 (administrator, anonymous, ...);<br>
* <code>ECOMMERCENG_SHOW_DEBUG_TOOLS</code> at <code>1</code> to display debug options;<br>
* <code>ECOMMERCE_WOOCOMMERCE_DEFAULT_TVA</code> at <code>1</code> to set default TVA rate to use;<br>
* <code>ECOMMERCENG_ENABLED_SYNCHRONIZE_IMAGES_PRODUCT_BUTTON</code> at <code>1</code> to display the button to force picture synchronization on <span style="font-variant: small-caps;">lnked files</span> tab of product card;<br>
* <code>ECOMMERCENG_WOOCOMMERCE_DISABLED_SYNCHRO_IMAGE</code> at <code>1</code> to prevent picture synchronization;<br>
* <code>ECOMMERCENG_SHIPPING_NOT_DISPLAY_IF_NULL</code> at <code>1</code> not to display free shipping fees on Dolibar orders.

=Items Synchronization between Dolibarr and WooCommerce=
The <span style="color:#9B5C8F;">'''WooCommerce ⇒ Dolibarr'''</span> synchronization is made by a '''manual operation''' : It requires the user to click on "Woocommerce to Dolibarr sync" button.

The <span style="color:#3C70A0;">'''Dolibarr ⇒ WooCommerce'''</span> synchronization is made '''in real time'''. No manual operation is required.

{| class="wikitable"
!Items||Synchronization||Action||Comment
|-
|rowspan="2"|'''Categories'''
(thirdparties & products/services)
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|None
|style="color:#3C70A0;"|''In a future version, categories created in Dolibarr will be synchronized in WooCommerce''
|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|They are synchronized as sub-categories of the parent category declared in Dolibarr (WooCommerce module settings)
|style="color:#9B5C8F;"|Table <code>llx_ecommerce_category</code> is updated to save the link between Dolibarr category id and remote WooCommerce id.
'''Warning >''' Due to the fact that there is no option to search the last modified categories, their synchronization might be slown down by the high number of categories.
|-
|rowspan="2"|'''Thirdparties & contacts'''
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|None
|style="color:#3C70A0;"|
|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|Thirdparties are created in Dolibarr as customers in the category declared in the module setting page. Shipping and billing addresses are created as contacts. WooSync checks email adresses before creating a new thirdparty.
|style="color:#9B5C8F;"|'''Synchronized data''' :
* Company Name (if filled in, thirdparty name. If not, thirdparty is created as a contact)
* Lastname
* firstname
* Adress
* ZIP
* Town
|-
|rowspan="2"|'''Products / Services'''
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|Products are synchronized in real time if they are linked to the ecommerce category declared in the module setup.
Pictures are synchronized in real time. Several rules can be enabled (See above : "Setup on Dolibarr side").
|style="color:#3C70A0;"|'''Synchronized data''' :
* Product (event <code>PRODUCT_MODIFY</code>)
** Réf. ⇒ UGS;
** Label ⇒ Name;
** Status (published (for sale) or pending);
** Description ⇒ empty;
** Description boutique ⇒ Description;
** Description courte boutique ⇒ Short description;
** Price ⇒ Régular price;
** Weigth (Kg)
** Stock quantity;
** In stock
* Product Variant
We recommand to create variant in WooCommerce.

|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|They are set up in Dolibarr and linked to the category declared in the module setup.
If the module Suppliers is enabled and Stock synchronization direction is set on <span style="font-variant: small-caps;">Ecommerce to Dolibarr</span>, products will be initialised/updated in the warehouse defined in the WooSync module setup in Dolibarr.

Variants have to be created in WooCommerce. They will be synchronized as product/services in Dolibarr.

|style="color:#9B5C8F;"|'''Synchronized data''' :
* Product type ⇒ Product or Service if set as "virtual"
* UGS ⇒ Ref.
'''Note >''' It requires the activation of 'Elephant' code generator in Dolibarr module Products/services
* Name ⇒ Label
* Description ⇒ empty
* Statut pour le site "boutique_wordpress" ⇒ Status
* Description ⇒ Description boutique
* Short description ⇒ Description courte boutique
* Tag/category ⇒ Category
* Weigth (Kg) ⇒ Weight
* Price ⇒ Price
* En vente ⇒ Purchasable
* Product finished type ⇒ Fixed at Manufactured
* Min price ⇒ Price
* Url ⇒ Permalink
* Stock quantity ⇒ Stock quantity

<br>
'''Product Variation :'''
* Product type ⇒ Service if set as "virtual"
* UGS ⇒ Ref.
* Name ⇒ Label
* Description ⇒ empty
* Weigth (Kg) ⇒
* Price ⇒
* Purchasable ⇒ to sell
* Product finished type ⇒ Fixed at Manufactured
* Price ⇒ Price
* Permalink ⇒ URL
* Stock quantity ⇒ Stock quantity
Other fields are retrieved from the parents products.
<br>
Table <code>llx_ecommerce_product</code> is updated to remember the link between dolibarr product id and remote Woocommerce id<br>
|-
|rowspan="2"|'''Orders'''
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|Orders created in Dolibarr are '''NOT''' synchronized.
Only modified status in Dolibarr will be updated on orders synchronized from WooCommerce (a link has to be present)
|style="color:#3C70A0;"|Status synchronization (events <code>ORDER_MODIFY</code>, <code>ORDER_CLOSE</code> and <code>ORDER_CLASSIFY_BILLED</code>) :
* Cancelled ⇒ cancelled;
* Validated ⇒ pending;
* Accepted & shipment on process ⇒ processing;
* Closed ⇒ completed.
|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|They are also created in Dolibarr
|style="color:#9B5C8F;"|'''Note >''' The orders created by another person than Customer user (Administrator, Anonymous, ...) are not created/modified
'''Synchronized data''' :
* Ref client ⇒ Id order in Woocommerce
* Purchase order date ⇒ Created date in Woocommerce
* Delivery date ⇒ Completed date in Woocommerce
* Status
** Pending ⇒ Validated,
** On-hold & processing ⇒ Accepted,
** Cancelled & Failed ⇒ Cancelled,
** Completed & Refunded ⇒ Closed;
* Payment status
** Pending & processing & on-hold & cancelled & Failed ⇒ Not paid
**Completed & Refunded ⇒ Paid
* Private note ⇒ Customer's notes in Woocommerce
* Product ⇒ Description (Name in Woocommerce);
* Product type ⇒ Fixed at Simple
* Price ⇒
* Quantity ⇒
* VAT rate (Calculated with total and total tax closed to VAT rate in Dolibarr) ⇒
* Shipping line of the product (Displayed by default or ECOMMERCENG_SHIPPING_NOT_DISPLAY_IF_NULL)
* Description ⇒ Shipping - ' & Shipping method title in Woocommerce if present
* Price ⇒ Total shipping in Woocommerce
* VAT rate (Calculated with shipping total and shipping tax closed to VAT rate in Dolibarr)||
* Order address ⇒ Billing Contact/addresses in Thirdparties
* Invoice address ⇒ Billing Contact/addresses in Thirdparties
* Shipping address ⇒ Shipping Contact/addresses in Thirdparties
Table <code>llx_ecommerce_order</code> is updated to remember the link of dolibarr order id and remote Woocommerce id
|-
|rowspan="2"|'''Shipment'''
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|Shipments are created from orders in Dolibarr.
|style="color:#3C70A0;"|Orders status are updated and synchronized in real time in WooCommerce (see above).
|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|None
|style="color:#9B5C8F;"|None
|-
|rowspan="2"|'''Invoices'''
|style="color:#3C70A0;"|'''Dolibarr ⇒ WooCommerce'''
|style="color:#3C70A0;"|Invoices are created from shipments in Dolibarr.
|
|-
|style="color:#9B5C8F;"|'''WooCommerce ⇒ Dolibarr'''
|style="color:#9B5C8F;"|None
|style="color:#9B5C8F;"|None
|-
|}

Module Ultimatepdf EN

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:Ultimatepdf]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" />
= Informations =
{{TemplateModuleInfo
|modulename=UltimatePDF
|editor=Atoo.Net
|web=https://www.atoo-net.com
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimatepdf}}
|status=stable
|prerequisites=
|minversion=9.0.0 (for ultimatepdf 9) -10.0.0 (for ultimatepdf 10)
|note=Download the all document (in french) about Ultimatepdf : [[https://wiki.dolibarr.org/upload/1/19/Dolibarr_the_Book_10.0_FR-275-305.pdf]]
}}

= Features =
It's the real Swiss knife with '''more than 100 blades!''' which allows to customize your pdf documents, to grant them to the graphic charter of your company. You can choose the color of the font, borders, and backgrounds and choose to have continuous or dashed outline lines. Adds many features to documents:
Also adds many features to documents :

* Concatenation of pdf documents on all types of documents (GTC, technical sheets ...),
* bill of exchange (LCR) for invoices
* Numbering column lines,
* Independent references column,
* Independent image column,
* Signature block and stamp « Agreed and signed »,
* Currency symbols displayed after or before the amounts.
...

= Prerequisites =
Dolibarr 9.0.x, 10.0.x

= Installation =

{{InstallModuleEn}}
'''! For those who already have an installed version, remember to disable it before replacing with the new version.'''
Verify you have this path : htdocs/custom/ultimatepdf

= Setup =
{{ActivationModuleEn}}
You will now enable the "ultimate" models in all modules where they are present :
* ultimate_propal1 and ultimate_propal2 within Commercial proposal management models,('''!since version 9.0, there is only one type of document: ultimate_propal, because all the columns can be activated or deactivated on the fly.''')
* ultimate_order1, ultimate_order2, ultimate_proforma1, ultimate_proforma2 within Customer order management models, ('''!since version 9.0, there is only one type of document: ultimate_order, because all the columns can be activated or deactivated on the fly.'''),
* ultimate_invoice1 and ultimate_invoice2 within Invoice and credit note management for customers models, ('''!since version 9.0, there is only one type of document: ultimate_invoice, because all the columns can be activated or deactivated on the fly.'''),
* ultimate_inter within Intervention management models,
* ultimate_shipment within Shipments and delivery order management models,
* ultimate_receipt within Shipments and delivery order management models,
* ultimate_supplierinvoice within Invoice and credit note management for suppliers models,
* ultimate_project within Project management models.

The module is now operational. ('''! You can go and test Ultimatepdf at this address : [[http://doliweb.com]]''')

'''! You can go to the wiki help related to the feature by clicking on the "?" placed at the top right'''
(If you have not hidden the online help in Administration> Display)

== Setup models ==

'''Own page configuration module:'''

[[File:Ultimatepdf_help-en-01.png|800px]]

* Example of realized model : [[https://wiki.dolibarr.org/upload/5/56/PR1604-0022_%285%29.pdf]]

In the configuration page dedicated to the module, two main tabs:
* Models tab
Here you can create and edit your models, for that purpose :
# Fill the text field to enter a name for your model.
# Give a description of your model for easy retrieval (My blue template with VAT and References)
# Use the color picker to a background color.
# Use the color picker to a border color.
# Use the color picker to a text color.
# Display or not the background color of the address blocks independently of each other.
# Choose the look of your lines (Dotted or solid line).
# Hide or not the column and the amount of VAT.
# Reverse the direction of the address blocks sender/recipient.
# Ability to use another logo that your company (for thematic subsidiaries).
# Possibility to use another font that one configured in the language file, e.g. "DejaVuSans".
# Show a background image on your models

[[File:Ultimatepdf_help-en-02.png|800px]]

#Possibility to use a different logo than that of your company (for thematic subsidiaries).

[[File:Ultimatepdf_help-3.png|800px]]

# Set the margins of your documents.
# Whether to show or not the references column.

[[File:Ultimatepdf_help-4.png|800px]]

# Change height of space reserved to output the free text (footer).
# Change font size of free text
# View the signature of the sale representative in charge in the public note block.

[[File:Ultimatepdf_help-5.png|800px]]

Now do not forget to select your template by clicking on the icon in the upper right menu.

[[File:Ultimatepdf_help-en-03.png|800px]]

Select the model from the dropdown list

[[File:Ultimatepdf_help-en-04.png|800px]]

Online Training:[[http://www.youtube.com/watch?v=bw3a08poCmU]]

== Options tab ==

[[File:Ultimatepdf_help-en-05.png|800px]]

Here you can manage the following features :

'''Rules to forge address boxes''':

- Show phone, fax and email if a contact address is used

- Hide VAT intra within addresses blocks

'''Rules to forge columns''':

- Display the reference column.

- Hide the column and the amount of VAT.

- Hide the long description in the description column.

- Hide references in the description column.

- Hide all data in the columns following the description ( VAT, Public price, Qty, Discount, Total).

- Hide amount without tax

- Hide quantities.

- Hide VAT amounts.

'''miscellaneous Settings'''
- ''The settings can now be done independently within proposals, orders, shipments and invoices''

- Add a dotted line between lines of products/services.

- Display folding mark at third of page

- Display thumbnails photos of products in your Proposals

- Display thumbnails photos of products in your Orders

- Display thumbnails photos of products in your Invoices

- Do not repeat the header if there are multiple pages

- Display another logo that the company logo.

- Hide RIB part of the bank account.

- Change the height of the placeholder for free text block

- Displaying a background image on your documents.

- Show block: "Good for Agreement"

- View the signature of the representative in charge in the public block note.

- Display Thirdparty barcode within Proposals, Orders and Invoices.

- Display ThirdpartyQRcode within Proposals, Orders, Expeditions and Invoices.

- Display or mask LS and LR columns on expeditions.

- Add and merge one or more pdf to your proposals, Invoices or Orders.

- Add and configure a specific line using dictionaries and extrafields

== Commercial proposals tab ==

[[File:Ultimatepdf_help-en-06.png|800px]]

- Settings can now be made independently in the commercial proposals

== Orders tab ==

[[File:Ultimatepdf_help-en-07.png|800px]]

- Settings can now be made independently in the commercial orders

== Invoices tab ==

[[File:Ultimatepdf_help-en-08.png|800px]]

- Settings can now be made independently in the invoices

== Shipments tab ==

[[File:Ultimatepdf_help-en-09.png|800px]]

- Settings can now be made independently in the Shipments

== Delivery Receipts tab ==

[[File:Ultimatepdf_help-en-10.png|800px]]

- Settings can now be made independently in the Delivery Receipts

== Supplier orders tab ==

[[File:Ultimatepdf_help-en-11.png|800px]]

- Settings can now be made independently in the supplier orders

== Supplier invoices tab ==

[[File:Ultimatepdf_help-en-12.png|800px]]

- Settings can now be made independently in the Supplier invoices

== Price Request tab ==

[[File:Ultimatepdf_help-en-13.png|800px]]

- Settings can now be made independently in the Price Request

== Contracts tab ==

[[File:Ultimatepdf_help-en-14.png|800px]]

Settings can now be made independently in the Contracts

= Usage =
Easy to use, with a few clicks all of your documents are at your own colors and each of your employees may have its personalized documents.

= Compatibility and Synergies =

UltimatePdf supports:

- Milestone/Jalon module
- Purchase/Sell Units management module (Displays results within a units column for all models)
- Incoterm module

= Development =
Development of this module is not included inside the standard GIT repository of Dolibarr but inside a repository dedicated to modules not supported by the Dolibarr development team but supported by Atoo.Net on Framasoft Git :
https://git.framasoft.org/grandoc/ultimatepdf

Module Timesheet

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:timesheet]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
<seo metak="timesheet, Dolibarr, interface, project, task, report, approval" />

= Informations =
{{TemplateModuleInfo
|modulename=timesheet
|editor=delcroip
|webbuy={{LinkToPluginDownloadDoliStore|keyword=timesheet}}
|status=stable
|prerequisites=projects
|minversion=3.5.0
|maxversion=6.0
|note=Latest Module version: 2.0.1
}}

= Manual =
[https://wiki.dolibarr.org/upload/b/bd/Module_timesheet.pdf Timesheet 1.5.1 manual]

[https://wiki.dolibarr.org/upload/4/45/Module_timesheet_2.0.pdf Timesheet 2.0.1 manual]

= Features =

- Timesheet interface for all the user task per week
- Generate report on user and on project per month
- favourties to show only some project/task by a simple click on a start icon next to the task name
- Approval of the timesheets per the N+1
- Approval of the timesheets per project manager
- Generate project invoice from timesheet data

[[File:timesheet_timeentry.jpg]]

= Change logs =
2.0.1 Change log from 2.0
* Project approval corrected (for non admin no approval was shown)
* PHP warning removed
* Home timesheet box correted (was not showing the # of timesheet to approve)

2.0 Change log from 1.5.1
* Week on two month are spliced to enable monthly approval
* Chained approval for team & project.
* Create invoice with ad-hoc and already defined service based on time saved.
* Report always shows time in day and hours
* Layout change for the setup page
* Layout change for the favorite handling
* Email are sent to user when a timesheet is rejected by the team leader
* Note on task are shown as info when hoovering over the task line
* Searchbox are available instead of dropdown list (use other core module setup).
* More translation (ES, DE, IT, FR, US , mostly automated)
* Note editing available for each tasks (also in the approval flow)

Change log from 1.5
* Support dolibarr 4.0.1
* Hidden option to join file to timesheets via the setting TIMESHEET_ADD_DOCS

Change log from 1.4.3:
* Timesheet approval by N+1,
* Reminder (email) for to be approved timesheet possible through dolibarr planned tasks
* admin wiew for the Approval (change a approval status outside the normal approval flow)
* Home box with the pending timesheet to be approved
* Blocking some weekdays (e.g week ends)
* Holiday showed in the timesheet
* Holiday time can be included in the timesheet totals
* Typo correction for French.
* Posibility to add a note
* Compatible with dolibarr 3.9.2

Change log from 1.4.1:

* Correction of the Spanish language (thanks to vinclar)
* Possible to deactivate the dolibarr Ajax for the dropdown list for the setup page (in case of issue to add whitelist)
* Keep the whitlistmode after submit / go to date / next / previsous week

Change log from 1.4:
* Bugfix for the tasktime date in the project page
* Link to have the different whitelist behaviour (black list, and none)
* Spanish language (google trad)
* Typo correction for French
* Support the print mode for timesheet & the report
* Show the project open to everyone on the new whitelist page

Change log from 1.3.7:
* layout improvement: timesheet, setup page, reports
* whitelist to show only some project/task
* taslk column customisation
* new task column: company, parent task
* new report option: report all, export friendly layout
* user report available for the N-2, N-3

Change log from 1.3.6:
* compatible avec dolibarr 3.7
* Change log from 1.3.3:
* Works with PHP<=5.3
* Possibility to remove the 0:00
* Color code for already filled tasktime / new tasktime and error
* Bux fixes in the report
* Better date dialog
* N+1 is able to check the user report of his N's

Module ReStock

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:restock - reStock]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="reStock, détermination des quantités à commander et création des commandes fournisseur" />

= Informations =
{{TemplateModuleInfo
|modulename=reStock
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.4.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/gestion-produits-ou-services/353-reStock--d--termination-des-quantit--s----commander-et-cr--ation-des-commandes-fournisseur.html?search_query=restock&results=1]
|note=
}}

= Fonctionnalités =
Ce module améliore la fonction achat dans Dolibarr en vous assistant dans la détermination des quantités de produits à commander à vos fournisseurs (à partir de vos devis, commandes et facture clients).
Il prend en compte les produits composés, les grilles de prix fournisseurs et génère les bons de commandes fournisseurs. Indispensable pour acheter au meilleur prix

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-ReStock//]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/product/index.php?mainmenu=products&leftmenu=] : lien de menu secondaire "reStock" du menu principal produit/services
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-reStock/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/49372-restock-generateur-de-commandes-fournisseurs#57600]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module Process

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Process - process]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="Process : amélioration de la vue des workflow commerciaux" />

= Informations =
{{TemplateModuleInfo
|modulename=Process
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.3.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/255-Process---am--lioration-de-la-vue-des-workflow-commerciaux.html?search_query=process&results=2]
|note=
}}

= Fonctionnalités =
* Ce module améliore la gestion des process / workflow commerciaux sur les devis, les commandes et les factures en ajoutant :
** Un suivi par étape personnalisable de l'avancement des process
** Une coloration et des champs personnalisables sur l'élément
** Une vue "agenda" des éléments pour superviser leurs dates importantes -
** Et la possibilité de gérer finement les liaisons entre éléments

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/]
* Démontration [http://dlbdemo.patas-monkey.com/htdocs/]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-Process/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/526-autres-modules/52531-process-workflow-commerciaux#57682]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module PrestaShop To Dolibarr

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
<seo metak="prestashop, shop, webservice, api"/>

= Information =
{{TemplateModuleInfo
|modulename=PrestaShopToDolibarr
|editor=
|web=
|status=stable
|minversion=
|note=
|webbuy=https://www.dolistore.com/fr/modules/497-Prestashop-to-Dolibarr-PRO.html
}}

= Features =
Synchronise its Prestashop to Dolibarr.

his multi module (one Prestashop and one Dolibarr) lets you synchronise all of your PrestaShop stores with Dolibarr.

It allows synchronization of:

1. Your customers, intelligently sorted prospects or customers in Dolibarr.
2. Your categories.
3. Your products, stored in their categories with their picture, barcode and inventory sorted according to your warehouse.
4. Your orders with repercussion of internal links to your internal products and your internal customers into Dolibarr.
5. Bills with also impact internal links to your products and your customers into Dolibarr.
6. Orders statuts update from dolibarr to prestashop and from Prestashop to Dolibarr it's an exclusivity of our module

The module works by communicating with Dolibarr by imporved web-services. So you can have your PrestaShop and your Dolibarr on two different machines.

The Prestashop to Dolibarr Pro module is the only one to synchronize big data. This, with an auto-stop technology and intelligent recovery that will stop communicating himself before time-out of the server. And, with our technology you can sync all your data without server crashes and can catch without duplicates up as we can see in other similar modules. Moreover, when a phase shift occurs, a notification is inserted into PrestaShop.

= Features =

VIDEO :

Install and configure : https://youtu.be/U8HTJ8tA9Xg

Module Version: 1.1.6 PRO

Publisher / License: PJ-Conseil / AGPL

User interface language: French, English, Spanish

Help / Support: pj.conseil.sa@gmail.com

Prerequisites:

Dolibarr min version: 3.6

Dolibarr max version: 7.0.*

Prestashop min version: 1.5.*

Prestashop max version: 1.7.*

= Installation =

Download the archive file of module (.zip file) from web site DoliStore.com
go to prestashop and click on modules and services
click on add (on the top right)
follow the instructions

= Development =
Development of this module is not included into standard GIT repository of Dolibarr but inside a dedicated repository managed by [http://www.teclib.com TecLib].
* GIT Repository: https://github.com/johanbernard/prestashop_to_dolibarr

Please submit your PR to this repository if you make enhancements to this module.

Module PrestaShop

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
<seo metak="prestashop, shop, webservice, api"/>

= Informations =
{{TemplateModuleInfo
|modulename=PrestaShop
|editor=SM 2i
|web=https://soamichel.fr
|status=stable
|minversion=4.0.0
|note=
|webbuy=https://www.dolistore.com/fr/modules/757-PrestaShop.html
}}

= Fonctionnalités =
Gérer entièrement* sa boutique Prestashop sur Dolibarr via le Webservice de PrestaShop. Aucun module est nécessaire à installer sur PrestaShop.

Ce module est compatible avec PrestaShop 1.6 max. Une compatibilité avec 1.7 est en étude.

Si vous boutique PrestaShop est déjà en service, ce module ne permet pas (pour le moment !) de prendre en charge la synchronisation des articles déjà sur PrestaShop. Pour que la synchronisation soit prise en charge, il faudra faire la correspondance des articles directement dans la base de données du module (n'hésitez à me contacter pour vous avez besoin d'un support pour cela).

= Installation =
{{InstallModuleFr}}

= Configuration =

== Sur PrestaShop ==

Sur PrestaShop, il est nécessaire d'activer le web service.

Dans le back-office de PrestaShop, allez dans le menu '''Préférences''' -> '''SEO & URLs''' puis activer l''''''URL simplifié'''''.

Ensuite, dans le menu '''Paramètres avancés''' -> '''Webservice''', activer le '''''service web'''''. Sur la même page, ajouter une nouvelle clé de service web avec les permissions suivantes au minimum:

{| align="left" width="100%" border="0" cellpadding="1" cellspacing="0" class="dolbox"
|style="background-color: #e9e9ef"| <b>Ressource</b>
|style="background-color: #e9e9ef"| <b>GET</b>
|style="background-color: #e9e9ef"| <b>PUT</b>
|style="background-color: #e9e9ef"| <b>POST</b>
|style="background-color: #e9e9ef"| <b>DELETE</b>
|-
| categories
| X
| X
| X
| X
|-
| customers
| X
| X
| X
| X
|-
| images
| X
|
| X
| X
|-
| languages
| X
|
|
|
|-
| order_states
| X
|
|
|
|-
| orders
| X
| X
|
| X
|-
| products
| X
| X
| X
| X
|-
| specific_prices (nécessaire seulement pour une utilisation du module [https://www.dolistore.com/fr/modules/663-Tarif-d--gressif.html Tarifs dégressifs])
| X
|
| X
| X
|-
| stock_availables
| X
| X
|
|
|-
| tax_rule_groups
| X
|
|
|
|}

== Sur Dolibarr ==

Sur Dolibarr, allez dans la configuration du module PrestaShop.

[[File:ModPrestaShop_Config1.png‎]]

Si la configuration coté PrestaShop est correct, d'autres paramètres apparaissent après la sauvegarde des paramètres de base.

[[File:ModPrestaShop_Config2.png‎]]

Adapter les à votre configuration.

En adaptant les statuts de commande, lors de changement de statut sur Dolibarr, ça met à jour automatiquement le statut de la commande sur PrestaShop (sur l'exemple en capture, la validation de la commande sur Dolibarr passe la commande PrestaShop en Paiement accepté). Vous pouvez les laisser sur ''Ne rien faire'' et il sera toujours possible de modifier le statut de la commande PrestaShop directement dans Dolibarr (voir le paragraphe '''Utilisation''').

'''Bien faire correspondre les taux TVA pour les prix TTC soient corrects sur PrestaShop lors de l'importation des articles'''

= Utilisation =

== Ajout de client ==

Cette partie est facultative. C'est utile dans le cadre d'une boutique B2B. Aller dans le menu '''PrestaShop''' puis '''Clients'''. Sélectionner dans la liste déroulante le contact de la société que vous voulez ajouter en tant que client sur PrestaShop. Si tous va bien, un nouveau mot de passe de l'utilisateur sur PrestaShop est affiché dans une notification.

[[File:ModPrestShop_AjoutClient.png]]

Vous pouvez supprimer l'utilisateur avec l'icône à droite. '''Pour un utilisateur qui a déjà passé des commandes, je déconseille cette action car PrestaShop ne fait pas de vérification et ses commandes se trouvent sans client. Désactiver plutôt le contact dans Dolibarr, ce qui a pour effet de le désactiver aussi sur PrestaShop.'''

Les données synchronisées dans PrestaShop:
* le nom du contact;
* le prénom;
* l'email ''(champs obligatoire pour pouvoir importé le contact)'';
* le statut;
* le nom de la société du client;
* le siret de la société;
* le code APE de la société;

'''''Toute modification de ces informations sur Dolibarr est automatiquement synchronisée sur PrestaShop.'''''

== Ajout de catégorie d'articles ==

Pour avoir le même classement par catégorie des article sur PrestaShop, ajouter les catégories de produits en allant dans le menu '''PrestaShop''', puis '''Catégories'''. Sélectionner le catégorie à ajouter dans la liste déroulante.

[[File:ModPrestaShop_AjoutCategorie.png]]

Vous pouvez ajouter autant les catégories parents (sous PrestaShop, ils seront rattachés au catégorie par défaut selon la configuration du module) que les sous catégories (sous PrestaShop, ils seront rattachés au catégorie parent si ce dernier a été ajouté sinon au catégorie par défaut).

Les données importées dans PrestaShop :
* le nom;
* la description;
* et les images;

'''''Toute modification sur Dolibarr des catégories ajoutées est automatiquement synchronisée sur PrestaShop (sauf pour les images, voir le paragraphe Ajout d'article pour savoir comment mettre à jour les images sur PrestaShop).'''''

== Ajout d'article ==

Pour ajouter des articles (produit ou service), allez dans le menu '''PrestaShop''' puis '''Produits'''. Sélectionner l'article à ajouter dans la liste déroulante.

[[File:ModPrestaShop_AjoutProduit.png]]

Vous pouvez supprimer l'article de PrestaShop, cliquez sur l’icône à droite. '''Pour un article déjà présent dans une commande, je déconseille cette action car PrestaShop ne fait pas de vérification. Mettez plutôt l'article en Hors vente sur Dolibarr'''

Les données synchronisées sur PrestaShop:
* le type d'article (produit standard pour les produits, produit dématérialisé pour les services);
* la référence;
* le libellé;
* la description;
* le prix HT;
* le TVA correspondant sur PrestaShop (voir le paragraphe Configuration);
* le statut;
* les images;
* le stock (pour les produits uniquement);
* et les tarifs dégressifs (si le module est disponible et activé - voir paragraphe Configuration).

Toute modification de ces informations sont automatiquement synchronisée sur PrestaShop sauf pour les images. Appuyer sur le bouton "Synchroniser les images des Produits/Services et des catégories" pour mettre à jour les images sur PrestaShop.

== Gestion de commandes ==

Avec ce module, toute la gestion des commandes PrestaShop doit se faire directement dans Dolibarr.

Pour récupérer les commandes par les clients sur PrestaShop, cliquez sur le menu '''PrestaShop''' de votre Dolibarr puis cliquez sur le bouton '''Synchroniser les commandes'''. '''Une fois la commande importée dans Dolibarr, toute modification future de cette commande dans PrestaShop ne sera pas synchronisé sur Dolibarr'''

[[File:ModPrestaShop_SyncCommande.png]]

[[File:ModPrestaShop vueCommande.png]]

'''''Sur Dolibarr, vous ne pouvez pas ajouter/supprimer des articles, modifier la quantité des commandes importés de PrestaShop.'''''

En fonction de votre configuration du module, le changement de la statut de la commande met à jour aussi la statut de la commande sur PrestaShop. Vous pouvez aussi modifier le statut de la commande PrestaShop directement à partir de la fiche de la commande sur PrestaShop (cf note rouge sur le capture précédent).

Module Portofolio

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:portofolio - portofolio]]
[[Category:patas-monkey]]
[[Category:benke]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
<seo metak="affectation, commerciaux, tiers, masse, groupe" />

= Informations =
{{TemplateModuleInfo
|modulename=portofolio
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.6.x
|webbuy=www.dolistore.com[http://https://www.dolistore.com/fr/crm-gestion-relation-client/529-Portofolio---Gestion-de-portefeuille-Client.html?search_query=portofolio&results=1]
|note=
}}

= Fonctionnalités =
Pour affecter un utilisateur en tant que commercial d'un tiers :
* L’utilisation de la page s’effectue en 4 étapes.
** Le filtrage des tiers dont on souhaite modifier l’affectation
** La sélection de l’utilisateur à affecter (ou désaffecter)
** La sélection ou non des tiers à modifier avec les cases à cocher en bout de ligne
** La validation des saisies effectuées

* Portofolio permet par filtrage et sélection, de :
** voir la liste des tiers auxquels est affecté un utilisateur/commercial
** voir la liste des tiers sans utilisateur/commercial affecté
** voir la liste des tiers auxquels un utilisateur/commercial n'est pas affecté

et

** d'affecter un utilisateur/commercial à une sélection de tiers
** de supprimer l'affectation d'un utilisateur/commercial à une sélection de tiers

Pour affecter un utilisateur à un groupe :
Utilisez le lien Portofolio du menu utilisateur et groupe, cliquez sur les icônes pour ajouter les utilisateurs dans les groupes souhaités.
= Utilisation =
* Fiche technique []
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/portofolio/list.php?mainmenu=home&leftmenu=modulesadmintools&idmenu=348]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-Portofolio/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module MydoliBoard

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:mydoliBoard - mydoliboard]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="création, tableau de bord, tableaux de bord, personnalisé, personnalisés, myList"/>

= Informations =
{{TemplateModuleInfo
|modulename=mydoliBoard
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.5.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/outils-systemes/316-MyDoliboard---tableau-de-bord-personnalis--es.html?search_query=mydoliboard&results=1]
|note=
}}

= Fonctionnalités =
Ce module permet de créer, à partir de requête SQL, des tableaux de bord personnalisés.
Il est possible d'associer un graphique au tableau obtenu.
Ceux-ci s'intègrent naturellement dans dolibarr (menus, habilitation, traduction).
Il est enfin possible d'importer et d'exporter les tableaux de bord au format XML.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-MyDoliboard/]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/mydoliboard/index.php?idmenu=25] : menu secondaire customTabs du menu principal "patas tools"
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-MyDoliboard-1.2.1/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/creation-a-la-demande/realisation-de-doliboards]

Module MyListMore

2019-07-23T12:26:21Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:myListMore - mylistmore]]
[[Category:patas-monkey]]
[[Category:benke]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
<seo metak="liste personnalisé, total, somme, édition, PDF"/>

= Informations =
{{TemplateModuleInfo
|modulename=myListMore
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.6.x
|webbuy=www.dolistore.com[http://www.dolistore.com]
|note=
}}

= Fonctionnalités =
MyListMore est un module additionnel à myList 2.0.2 qui ajoute les éditions PDF et la totalisation de champs de la liste en somme et moyenne.

= Utilisation =
* Démonstration [http://dlbdemo.patas-monkey.com]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-mylistmore/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Assistance =
Formulaire de contact[http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module MyList

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:myList - myList]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="liste, listes, dolibarr, personnalisée, personnalisées, dynamique, dynamiques, personnalisation, liste personnalisée, listes personnalisées, mydoliBoard" />

= Informations =
{{TemplateModuleInfo
|modulename=myList
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.4.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/300-myList---cr--ation-de-listes-dynamiques-personnalis--es.html?search_query=mylist&results=1]
|note=
}}

= Fonctionnalités =
*MyList permet la création de listes dynamiques personnalisées à placer dans les menus de Dolibarr.
*A partir de requêtes SQL, il permet de définir
** pour chaque liste : titre, positionnement et droits d’accès et
** dans chaque liste : le paramétrage des champs, leur nom, leur position, leur sélection dans la liste des choix, et les conditions d'affichage et de filtrage.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/]
* Démontration [http://dlbdemo.patas-monkey.com/htdocs/myfield/core/patastools.php?mainmenu=patastools&leftmenu=mylist&idmenu=114&mainmenu=patastools&leftmenu=] : menu secondaire myList du menu principal "patas tools"
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-myList/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/44529-mylist-creation-de-liste-personnalisees-dynamique]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/creation-a-la-demande/listes-mylist]

Module MyField

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:myfield - myField]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="personnalisation, champ, personnalisés" />

= Informations =
{{TemplateModuleInfo
|modulename=myField
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.6.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/469-myField---personnalisation-des-champs-de-Dolibarr-et-de-leur-acc--s.html?search_query=myfield&results=1]
|note=
}}

= Fonctionnalités =
* myField offre la possibilité de personnaliser les champs natifs et supplémentaires de dolibarr :
** Masquer définitivement
** Rendre invisible (fonction show/hide)
** Gérer l'accès par groupes d'utilisateurs en visu et saisie
** Surligner
** Définir une valeur par défaut pour un champ
** Ajouter un masque de saisie
** Remplacer dynamiquement le libellé d'un champ par un autre

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-MyField/]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/myfield/core/patastools.php?mainmenu=patastools&leftmenu=mylist&idmenu=114&mainmenu=patastools&leftmenu=]: menu secondaire myField du menu principal "patas tools"
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-myField/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module MyClock

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:myClock - myclock]]
[[Category:patas-monkey]]
[[Category:benke]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
<seo metak="horloge,pop-up, temps, tache, intervention, action"/>

= Informations =
{{TemplateModuleInfo
|modulename=myClock
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.1.x
|webbuy=www.dolistore.com[http://www.dolistore.com]
|note=
}}

= Fonctionnalités =
Le module myClock affiche une horloge dans l'interface Dolibarr.
MyClock propose différentes skin pour l'horloge et 3 boutons qui afficheront différentes fenêtres au contenu personnalisable :
Le contenu des fenêtres est à sélectionner dans la configuration du module :

= Utilisation =
* Démonstration [http://dlbdemo.patas-monkey.com]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-myclock/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Assistance =
Formulaire de contact[http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module Management

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Management - management]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="gestion, temps passé, temps consommé, coût, intervention, projet, contrat"/>

= Informations =
{{TemplateModuleInfo
|modulename=Management
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.5.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/outils-systemes/444-Management--gestion-des-co--ts-et-du-temps-pass--.html?search_query=management&results=2]
|note=
}}

= Fonctionnalités =
Management améliore les fonctions natives de dolibarr de gestion de projet, d'interventions et de contrats.
* Rapport sur les interventions
* Echéances de contrats
* Amélioration de la saisie des temps consommés (mensuel et à la volée)
* Amélioration du suivi des temps consommés sur les projets
* Facturation des échéances des contrats, des interventions et des projets
* Vue agenda (projet et intervention)

= Utilisation =
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/management/projet/costintask.php?id=1&withproject=1] : onglet "management" des taches, projets et interventions
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-Management---version-provisoire/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/507-agenda/31361-management-ameliorations-de-la-gestion-du-temps]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module Google

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:Google]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
<seo metak="Google, Dolibarr, synchro, synchronize, interface, calendar, contacts, address, map, maps, event, addresses, link" />
= Informations =
{{TemplateModuleInfo
|modulename=Google
|editor=NLTechno
|web=[http://www.nltechno.com www.nltechno.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=google}}
|status=stable
|prerequisites=
|minversion=3.9+
- Having module openssl extension enabled into your PHP. To check this, go into module Home - Setup - PHP infos and make a search into page of "openssl". If you don't find, openssl module is not installed.

- Having module xml extension enabled into your PHP. To check this, go into module Home - Setup - PHP infos and make a search into page of "xml". If you don't find, xml module is not installed.

- Having module curl extension enabled into your PHP. To check this, go into module Home - Setup - PHP infos and make a search into page of "curl". If you don't find, curl module is not installed.
|note=
}}

= Features =
This module provides some Google integration into Dolibarr:
* Synchronize your third parties/contacts or members into Google Contacts.
* Add into menu a new entry called "Google Agenda" to show contents of your Google Agendas.
* Synchronize any event created or modified into Dolibarr agenda to Google Agenda.
* Add a pictogram near all addresses. A click on it show address inside a Google Maps.
* Add a view of location of all your customers/members into Google Maps.
* Can add a Google Adsense tag into logon page.
* Can add a Google Analytics tag into any software pages.

* Compatible with all standard Google Gmail account and with Google Apps Gmail account (from version 3.4.5 of module)

= Install =
{{InstallModuleEn}}

= Setup =
{{ActivationModuleEn}}

== Setup of Google Calendar/agenda features ==
This module provide 2 different features:

=== Showing Google calendar tab into Agenda view ===
First feature is to show the Google calendar view into a tab into Agenda view. This feature does not provide any synchronization (see next feature for this) but only a visibility of Google native calendar into a Dolibarr tab. This list of agenda will be the same for every users so this feature is not usefull if you have different agenda that need different visibility according to users (The next feature may be more interesting if you are in this case).

To define list of Google calendar to see into your Dolibarr, go onto Google module setup page, tab "View Google calendar" and:

Choose "Activate this tool" to Yes.

Then for each Google agenda you want to show in menus, you must enter:
* A label for this Agenda.
* A color for this Agenda.
* Google ID of Agenda. It can be found on the Google parameters pages for the agendas like this:
# Log to http://calendar.google.com
# Click on the "Parameters" link in the wheels
# Click on the name of Agenda to show the Details of agenda.
# Search line "URL Address", you will see a text "Calendar ID: theagendaid@gmail.com" like into the following screenshot (click twice on image to have it enlarged)
[[File:Find your Google Calendar or Agenda ID.png|400px]]

The Agenda ID is value that looks like an email. If you have only one Agenda, it might simply
be your Google login.

The last section of configuration (Google Client ID and Google Client secret) is only needed if you want the authentication request to Google is integrated into Dolibarr screens.

=== Synchronize events from Dolibarr to Google Agenda ===
The other feature is to write/update an event into Google Calendar, each time an event is added/updated into Dolibarr.
The event is pushed to a unique Agenda, or if you choose to use one agenda per user, to the agenda of the owner of the event.

To setup this synchronization, go onto module setup page, tab "Sync to Google Agenda", and set "Create a Google event into Google Calendar when creating a Dolibarr event" to "Yes".

Then, you must setup and enter the API keys provided by Google. This is done in several step.

1) You must also enable the API for your Google account. For this go on page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Authentication" -> "Enable API". Click to enable API for "Calendar API".

2) Find the Google Agenda ID or your calendar.
For this,
# Log to http://calendar.google.com
# Click on the "Parameters" link in the wheels
# Click on the name of Agenda to show the Details of agenda.
# Search line "URL Address", you will see a text "Calendar ID: theagendaid@gmail.com" like into the following screenshot (click twice on image to have it enlarged)

[[File:Find your Google Calendar or Agenda ID.png|400px]]

Fill this found ID into the Dolibarr setup field "ID Agenda". It means all events will be synchronized toward this agenda.

Note: you can keep this field empty and fill instead the "ID Agenda" at the user card level (into tab "Google" on '''each user card'''). Each user can have its own calendar. In such a case, it is the owner of the event (visible on Dolibarr event card) that will be used by Dolibarr to know which Agenda ID to target for synchronization. It means each event into Dolibarr can be pushed only toward one and only one agenda (if there is several users assigned to event, it is the owner of event that will be targeted). Note also that in such a case, step 5 must also be done for each Google account.

3) You must create a service account user/email from page {{ModuleGoogleUrlToCreateApiAccount}}, menu "Credentials" . Click on "Create a client ID" and choose "Service Account" then choose "type of file P12" then "Create". You will get:
* A new service account with a Service account client ID and a Service account EMail. You need here to enter the Service account EMail.
* A .p12 file was also downloaded.

If you choose to synchronize to only 1 unique Google agenda target or to one different agenda for each user, you have only to create 1 service account. However, you may need to give permissions to all google account if you set 1 different agenda for each user (see step 5).

You can also create a service account from page {{ModuleGoogleUrlToCreateApiAccountBis}}.

4) Submit the information received and the downloaded file on the Dolibarr setup page, tab "Sync to Google Agenda".

5) You must also share the agenda (all permissions) with the service account user/email (created at step 2): For this, go into Google calendar, choose "'''Settings and Sharing'''" from the combo list on the right of your Agenda on the area "'''My Calendars'''" (It must be same Agenda than the one chosen on parameter "ID Agenda" at step 1). Click on link "Share with Specific people". Then add the service account user into the email field, choose permission "'''Make changes to events'''" and validate.

With Google Apps for work (not required for standard gmail account), permissions may be forced to "Ready only" instead of "Edit". To solve this, go onto
{{GoogleURLToSetupCalendarAppSharing}} and check that sharing option of Agenda application allows sharing with external service account. [[File:Warning.png]] A 24h delay may be required to be able to return and finish step 5.

Once all steps are done, you can use the button to make a synchronization test. Click on it to make a test.

'''TroubleShooting'''

* If you receive error "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (404) Not Found": Check the step 5 was done.

* If you receive error "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (403) Forbidden": Check the step 5 was done and that permission granted was read and write and not read only.

* [[File:Warning.png]] Note: A possible error is that Google denies access, even if your setup is correct, just because the server that host Dolibarr is located into another country or region than the one using google apps usually.
To check Google has locked your access for this reason, go onto page https://security.google.com/settings/security/activity?hl=fr after failure.

If it appears Google has blocked access attempts from an unusual location, accept this attempt. Then, you must wait 24 hours to try again.

* [[File: Warning.png]] Note: Another possible error is that Google denies access even if your setup is correct, because you turn on Google option 2-step validation. To check if you have actually enabled this option, go to the page: {{GoogleURLToSetup2StepValidation}}

If in the "Validation in two stages," you have "On", try to disable it. Module should works even with the two step validation on, but errors are easier to diagnose if this option if off.

* [[File: Warning.png]] Note: Another possible error is that Google denies access even if your setup is correct, because the server Dolibarr runs on or your local computer is not on time. Check that date and hour of your computer and server are correct.

== Setup of Google Contact ==
This module allows you to synchronize Dolibarr with your Google contact annuary. Synchronisation of contacts can be done toward only one Google account. However, using the Google sharing features (delegate contacts), everybody could see them.

1) You must first enable the API for your Google account. For this go on page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Authentication" -> "Enable API". Click to enable API for "Contact API".

2) Then go on the setup page of Google module in Dolibarr, choose all Dolibarr elements you want to synchronize among (You can choose several choices):
* Thirdparties (if module Thirdparty is enabled)
* Contacts/addresses of thirdparties (if module Thirdparty is enabed)
* Members (if module foundation members is enabled)

For each type of synchronization activated, enter a label of the Google Group of your choice. This is the group visible into Google to group all records together. Group will be created into Google Contact if not exists. You can also use a label of one of any predefined Google system group like: '''"System Group: My Contacts", "System Group: Friend", "System Group: CoWorker", "System Group: Family"'''

Note also that only the predefined system group '''"System Group: My Contacts"''' is shared by the "Delegate contacts" Google feature of Google contact (Google Apps for Work). So if you want to share your Google contact annuary, that contains Dolibarr records, to have other users seeing it, you must put your Dolibarr records into this group. They can't be put into another group if you plan such a share (only one account can be used).

Then enter the following information:

# The Google login account (example myaccount@gmail.com or myname@mycompany.com)
# The Google Client ID and the Google Client Secret. You can create your Google Client ID and Secret from page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Authentication" -> "Credentials". Click on "Create a client ID" and choose "Web Application", set "Allowed Javascript origin" to empty and set "Redirect URI" to the value provided into the "Note" on the setup page. It should be something like http://mycompanydomain/.../google/oauth2callback.php
# Then click on button "Create". You will get a new '''Client ID''' and a '''Secret code'''. Save the Google setup page after filling Client ID and Secret Code.
# A warning should say you don't have yet any Google token saved into your Dolibarr database. Click on the link to authenticate, enter your Google credential if requested (same account than the account entered at step 2 and accept any confirmation. You should go back on the Dolibarr setup page, but a value for the token, saved into your Dolibarr database should appears.

Buttons to make synchronization tests should be available. Click on them to make tests.

'''TroubleShooting'''

* [[File:Warning.png]] Note: A possible error is that Google denies access, even if your setup is correct, just because the server that host Dolibarr is located into another country than country uou are using google apps usually.
To check Google has locked your access for this reason, go onto page https://security.google.com/settings/security/activity?hl=fr after failure.

If it appears Google has blocked access attempts from an unusual location, accept this attempt. Then, you must wait 24 hours to try again.

* [[File: Warning.png]] Note: Another possible error is that Google denies access even if your setup is correct, because you turned on Google option 2-step validation. To check if you have actually enabled this option, go to the page: {{GoogleURLToSetup2StepValidation}}

If in the "Validation in two stages," you have "On", the problem is found. You do not have to disable it. You can solve the problem as follows:
Click "Edit" next to the title of the "Validation in two steps."
Click the link "Manage passwords specific to applications". Enter a name, for example "Google Access for Dolibarr" and confirm. A password will be provided.
Return to the configuration page of Google Dolibarr module and enter this password in the configuration page of the module, instead of your regular password, then click '''Save'''.
Retry the test synchronization.

* [[File: Warning.png]] Note: Another possible error is that Google denies access even if your setup is correct, because the server Dolibarr runs on or your local computer is not on time. Check that date and hour of your computer and server are correct.

== Setup of GMaps features ==

1) You must first enable the API for your Google account. For this go on page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Authentication" -> "Enable API". Click to enable API for "Google Maps Geocoding API" and "Google Maps JavaScript API".

2) Create an API key of type "Server" and enter it on the setup page of module Google in Dolibarr, tab GMaps.

=== Link to localize a specific address ===
Choose elements on which you want to see a GMaps picto after addresses, among (you can choose several choices):
* Third parties (if module Third party is enabled)
* Contacts/addresses of third parties (if module Third party is enabled)
* Members (if module foundation members is enabled)
Then define the zoom level to define scale used by default when a map will be output (value from 1 to 10, 10 is the more accurate zoom level). 7 is a recommended value.

=== Links to global maps ===
The other feature provided by module, is to show a global map with all your third parties, contact/addresses or members. To see link to those maps, go into menu Home -Setup - Boxes/Widgets.
Check that the box "Links to Google Maps" is activated. Return to Dolibarr home page. If boxes does not appears, choose it into the combo list on the left, to add it definitely on you screen.

== Setup of Adsense==
If you want to enable adsense feature, on Adsense tab, enter:
* Your adsense customer id (ca-pub-xxxxxx)
Id specific to ad shown (you can find this id into Google adsenses dashboard adsense.google.com)
An advert will be added onto demo and logon page.

== Setup of Google analytics ==
If you want to enable analytics feature, on Analytics tab, enter:
* Your Google analytics id (something like UA-xxxxxxx-y). You can find this id on Google analytics dashboard.
The Google Analytics tag will be then output onto all Dolibarr pages.

= Usage =

== Usage of Google Agendas features ==

=== If you activate synchronization ===

* Dolibarr -> Google: Just go onto Google calendar, after creating or editing a Dolibarr event. You should see it into Google calendar (for example on calendar of your Android smartphone).

* Google -> Dolibarr: If you need to synchronize changes done on Google side, go onto the agenda view. You should see a link to force synchronization from Google to Dolibarr. See example here. Link is sentence "'''Click to resfresh agenda database with ...'''"

<div class="divforimgcentpercent">
[[File:Link for sync from google.png|border]]
</div>

=== If you enabled feature to show Google agenda ===
Choose menu Agenda Google, the agenda will be shown.
If you have defined several agendas, you can limit view for only one of them using the left menu.
The Google agenda is shown in read only mode.
To add event into it, you must click on link "+ Google calendar" at bottom of agenda (this is a Google limit).

<div class="divforimgcentpercent">
[[File:screen_shot_google_view_agenda.png|border]]
</div>

For security reasons imposed by Google, the Google calendar view will display correctly only if you are logged in to Google.
To facilitate this, it is possible to configure a key to allow the application to offer the Google Logon if you are not connected (See setup of module Google, tab Agenda setup, last section).

== Usage of Google Contact feature ==
* Dolibarr -> Google: Create or edit a thirdparty, contact or memeber (depending on which sync you enabled). Then go to Google contact. You should see the card created into Google.
* Google -> Dolibarr: Change on this direction is not supported.

== Usage of GMaps feature ==
Depending on the choice made in configuration, a small pictogram appears on the third page, Contacts / Addresses or members after the address. By clicking above, you will see a map with the address positioned above. It is possible for you to navigate the map without leaving Dolibarr.

<div class="divforimgcentpercent">
[[File:screen_shot_google_address.png|border]]
</div>

In addition, you also have access to a box on the home page with a link to see all of your third party or members on the same map.

<div class="divforimgcentpercent">
[[File:screen_shot_google_box.png|border]]
</div>

This is an example when you click on link on home page to see "Map of customers".
Note that you can filter on sale representative, or any customer or supplier tag.

<div class="divforimgcentpercent">
[[File:screen_shot_google_map.png|border]]
</div>

== Usage of Adsense feature ==

There is no particular things to do. Once setup is done (see previous chapter), a Google Adsense advert will appear on login page.

Note: When Dolibarr is used with the [[Application Android - DoliDroid]], advert will not be active.

== Usage of Google Analytics ==

There is no particular things to do. Once setup is done (see previous chapter), a Google Analytics tag is added onto each Dolibarr page. By using the Google Analytic interface, you can have statistics on your Dolibarr usage, as if it was a public web site.

Note: When Dolibarr is used with the [[Application Android - DoliDroid]], tag will not be active.

= Development =
{{TemplateModNLTechnoEn}}

Module Google FR

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Google]]
[[Category:NLTechno]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
<seo metak="Google, Dolibarr, synchro, synchronisation, interface, calendrier, contacts, adresses, map, maps, plan, carte, évènements, agenda" />
= Informations =
{{TemplateModuleInfo
|modulename=Google
|editor=NLTechno
|web=[http://www.nltechno.com www.nltechno.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=google}}
|status=stable
|prerequisites=
|minversion=3.9+
- Avoir le module PHP openssl activé. Pour vérifier cela, aller dans accueil - information système - PHP et faire une recherche sur "openssl". Si vous ne trouvez pas, le module n'est pas installé.

- Avoir le module PHP xml activé. Pour vérifier cela, aller dans accueil - information système - PHP et faire une recherche sur "xml". Si vous ne trouvez pas, le module n'est pas installé.

- Avoir le module PHP curl activé. Pour vérifier cela, aller dans accueil - information système - PHP et faire une recherche sur "curl". Si vous ne trouvez pas, le module n'est pas installé.
|note=
}}

= Fonctionnalités =
Intègre des fonctions Google dans Dolibarr:
* Synchronise les tiers, contacts ou adhérents saisi dans Dolibarr vers Google Contacts.
* Ajoute un menu avec une vue d'agenda Google dans un onglet à côté de l'onglet vue agenda standard.
* Synchronise tout événement saisi dans Dolibarr vers l'agenda Google.
* Ajoute un pictogramme à coté des adresses. Un clic fait apparaître l'adresse au sein d'une carte Google Maps.
* Offre une vue sur Google Maps de la position de tous ses clients ou adhérents.
* Permet d'ajouter une pub AdSense sur la page de logon.
* Permet d'ajouter un tag de suivi Analytics sur toutes les pages de Dolibarr.

* Compatible avec les comptes google Gmail standard et les comptes Gmail Google Apps (à partir de la version 3.4.5 du module).

= Installation =
{{InstallModuleFr}}

= Configuration =
{{ActivationModuleFr}}

== Configuration Google Agenda ==
Le module apporte 2 fonctions distinctes:

=== Affichage de l'agenda Google ===
Si vous désirer faire apparaître les agendas Google dans les menus Dolibarr, sur la page de configuration du module, pour l'onglet "View Google Agenda", il vous faut saisir:

"Activer cet outil" à Oui.

Ensuite, pour chaque agenda à faire apparaitre, saisir:
* Un nom pour l'agenda Google
* Une couleur pour l'Agenda Google.
* L'ID de l'Agenda Google. Il peut etre trouvé en allant sur la page de paramétrage des agendas Google de la manière suivante
# Se Connecter à http://calendar.google.com
# Cliquer sur le lien "Parametres"
# Cliquer sur le nom de l'Agenda voulu pour en afficher les détails.
# Trouver la ligne "Adresses de l'URL", vous verrez le texte "ID Agenda : theagendaid@gmail.com" comme sur cet exemple de copie d'écran (cliquer 2 fois pour élargir l'image au maximum)
[[File:Find your Google Calendar or Agenda ID.png|400px]]

L'ID d'Agenda est la valeur qui ressemble à une adresse email. Si vous n'avez qu'un seul agenda, il peut s'agir simplement de votre compte Google.

La dernière rubrique de configuration (Google Client id et Google Client secret) ne sert que si vous désirez que la demande d'authentification à Google soit intégrée dans les écrans Dolibarr.

=== Synchronisation des événements Dolibarr vers Google Agenda ===

L'autre fonctionnalité est d'écrire / mettre à jour un événement dans Google Calendar, chaque fois qu'un événement est ajouté / mis à jour dans Dolibarr.

Pour cela, aller sur la page de configuration du module, onglet "Synchro vers Google Agenda", et réglez "Créer un événement Google dans Google Calendar lors de la création d'un événement Dolibarr" sur "Oui".

Ensuite, vous devez configurer et entrer les clés API fournies par Google. Ceci se fait en plusieurs étapes.

1) Dans un premier temps, vous devez également activer l'API pour votre compte Google. Pour cela, aller sur la page {{ModuleGoogleUrlToCreateApiAccount}}. Cliquez pour "Activer API" pour "API Calendrier".

2) Trouver le Google Agenda ID de votre calendrier. Il peut etre trouvé en allant sur la page de paramétrage des agendas Google de la manière suivante:
# Se Connecter à http://calendar.google.com
# Cliquer sur le lien "Parametres"
# Cliquer sur le nom de l'Agenda voulu pour en afficher les détails.
# Trouver la ligne "Adresses de l'URL", vous verrez le texte "ID Agenda : theagendaid@gmail.com" comme sur cet exemple de copie d'écran (cliquer 2 fois pour élargir l'image au maximum)
[[File:Find your Google Calendar or Agenda ID.png|400px]]

Renseignez cet ID dans le champ "Agenda ID" de la page de configuration de Dolibarr. C'est vers cet agenda que seront synchronisé tous les évènements.

Vous pouvez toutefois laisser ce champ vide et renseigner à la place l Agenda ID cible au niveau de la fiche de chaque utilisateur (dans l'onglet "Google setup" ou "Configuration Google" de la fiche utilisateur). Chaque utilisateur pouvant avoir son propre agenda. Dans ce cas, c'est le propriétaire de l'événement Dolibarr qui sera utilisé pour connaitre l'agenda cible de la synchronisation. Chaque événement Dolibarr ne peut donc aller que vers un seul agenda (si il y a plusieurs utilisateurs affectés à l événement, ce sera le propriétaire qui sera déterminant). Notez aussi que dans ce cas, l'étape 5 doit être faite pour chaque compte google.

3) Vous devez créer un compte/email de service sur la page {{ModuleGoogleUrlToCreateApiAccount}}, menu "Identifiants". Cliquez sur "Créer un identifiant" et choisissez "Compte de service", puis choisir le format "P12" puis "Créer". Vous obtiendrez:
* un nouveau compte de service avec un client ID de ce compte de service client et un e-mail de ce compte de service. Vous devez ici récupérer l''''e-mail''' du compte de service.
* Un fichier .p12 a aussi du se télécharger. On utilisera ce fichier téléchargé à l'étape suivante.

Note: Que vous ayez mis à l'étape 2 un seul compte Google cible pour la synchronisation ou 1 sur chaque fiche utilisateur, vous n'aurez toujours qu'un seul compte de service à créer. Par contre ce compte devra avoir les droits sur tous les comptes des autres (voir étape 5)

Il est aussi possible de créer un compte de service par la page {{ModuleGoogleUrlToCreateApiAccountBis}}.

4) Soumettez l'email du compte de service ainsi que le fichier .p12 sur la page de configuration du module sous Dolibarr, onglet "Synchro vers Google Agenda".

5) Vous devez également partager l'agenda (toutes permissions) avec le compte/email de service (créé à l'étape 2): Pour cela, allez dans le calendrier Google, choisissez "'''Paramètres et Partage'''" depuis le menu déroulant à droite du nom de l'agenda dans la zone '''"Mes Agendas"''' (Prendre le même que la paramètre ID Agenda de l'étape 1), puis "'''Partager avec des personnes en particulier'''". Puis ajouter l'email du compte de service dans le champ, choisissez la permission "Modifier les événements" et valider.

Avec Google Suite (non requis pour le compte gmail standard), les autorisations proposées peuvent être forcées sur "Lecture seule" au lieu de "Modifier". Pour résoudre ce problème, aller sur {{GoogleURLToSetupCalendarAppSharing}} et vérifiez que l'option de partage d'application de l'Agenda permet de partager avec les comptes de service externe.
[[File:Warning.png]] Si ce n'est pas le cas, corriger, mais un délai de 24h peut être nécessaire pour être en mesure de revenir et de terminer l'étape 5.

Une fois que toutes les point ont été traités, vous pouvez utiliser le bouton pour faire un test de synchronisation. Cliquez dessus pour faire un test.

'''TroubleShooting'''

* Si vous recevez l'erreur "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (404) Not Found": Vérifiez que l'étape 5 a été fait.

* Si vous recevez l'erreur "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (403) Forbidden": Vérifiez que l'étape 5 a été fait et que la permission accordée est lire et écrire et non lire seulement.

* [[File:Warning.png]] Note: Une erreur possible est que Google refuse l'accès, même si votre configuration est correcte, simplement parce que le serveur hôte que Dolibarr est situé dans un autre pays/région que le pays/région où vous utilisez Google Suite en général.
Pour vérifier si Google a verrouillé votre accès pour cette raison, aller sur la page https://security.google.com/settings/security/activity?hl=fr après l'échec.
Si il apparaît que Google a bloqué les tentatives d'accès à partir d'un endroit inhabituel, accepter cette tentative. Ensuite, vous devez attendre 24 heures pour essayer de nouveau.

* [[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès, même si votre configuration est correcte, parce que vous avez activé l'option Google validation en 2 étapes. Pour vérifier si vous avez effectivement activé cette option, aller à la page: {{GoogleURLToSetup2StepValidation}}

Si dans "validation en deux étapes," vous avez "On", le problème est trouvé. Vous n'avez pas besoin de désactiver l'option. Vous pouvez résoudre le problème comme suit: Cliquez sur le lien '''Mot de passe d'application''' près de "validation en deux étapes." Cliquez sur le lien "Gérer les mots de passe spécifiques aux applications". Entrez un nom, par exemple "Dolibarr" et validez. Un mot de passe sera généré par Google. Retournez à la page de configuration du module Google Dolibarr, et entrer ce mot de passe dans la page de configuration du module, à la place de votre mot de passe habituel, puis cliquez sur '''Enregistrer'''. Réessayez la synchronisation de test.

* [[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès, même si votre configuration est correcte, parce que le serveur sur lequel tourne Dolibarr ou l'ordinateur avec lequel vous y accédez n'est pas à l'heure.

== Configuration Google Contacts ==
Le module permet de réaliser une synchronisation de Dolibarr avec votre annuaire de contact Google. La synchronisation ne peut se faire que vers un seul compte Google, mais il est possible via les fonctions de partage Google que tout le monde ait accès aux contacts de ce compte.

1) Dans un premier temps, vous devez activer l'API pour votre compte Google. Pour cela, aller sur la page {{ModuleGoogleUrlToCreateApiAccount}}. Cliquez pour "Activer API" pour "API Contact".

2) Ensuite, allez sur la page de configuration du module Google dans Dolibarr et choisissez les éléments que vous voulez synchroniser. Vous pouvez choisir l'un d'eux ou tous:
* Tiers (si le module Tiers est activé)
* Contacts/Adresses (si le module Tiers est activé)
* Adhérents (si le module Adhérents est activé)

Pour chaque type de synchro activé, renseigner le nom du libellé de groupe de votre choix. Ce groupe sera celui visible dans Google Contact qui regroupera toutes les fiches issues de Dolibarr. Le groupe sera créé dans Google Contact si il n'existe pas. Vous pouvez aussi utiliser un des libellés de groupes systèmes prédéfinis par Google comme: '''"System Group: My Contacts", "System Group: Friend", "System Group: CoWorker", "System Group: Family"'''

Notez aussi que seul le groupe système prédéfini '''"System Group: My Contacts"''' est partagé par la fonction "Delegation de contacts" de Google contact (Google Apps for Work). Aussi, si vous désirez partager votre annuaire Google pour que d'autres voient cet annuaire, il vous faut mettre vos fiches Dolibarr dans ce groupe. Elles ne doivent être mise dans un groupe autre dans ce cas.

Ensuite, renseignez les informations suivantes:

3) Le compte google (exemple myaccount@gmail.com ou myname@mycompany.com)

4) Le Google Client ID et le Google Client Secret. Vous pouvez créer votre Google Client ID et Secret depuis la page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Authentication" -> "Identifiants". Cliquer sur "Créer un client ID" et choisir "Web Application", positionner "Allowed Javascript origin" à vide et positionner "URI de Redirection" sur la valeur proposée dans le champ "Note" sur la page de configuration. Ce doit être une valeur du genre http://mycompanydomain/.../google/oauth2callback.php
Ensuite cliquer sur "Créer". Vous obtiendrez un nouveau Client ID et un Code secret du client.

5) Recopier les valeurs du Client ID et du Code secret client sur la page de configuration du module Google de Dolibarr puis Enregistrer.

6) Une alerte doit indiquer que vous n'avez pas encore de jetons Google sauvé dans votre base de donnée Dolibarr. Cliquez sur le lien sous le warning pour vous authentifier sur Google, et entrez vos identifiants/mot de passe Google si demandé (ceux en rapport avec le compte saisi à l'étape 2 et accepter toute confirmation. Vous allez revenir sur la page de configuration Dolibarr mais avec une valeur de jeton sauvé en base Dolibarr qui sera renseigné.

7) Les boutons pour réaliser des test de synchronisation deviennent disponibles. Utilisez les pour faire des tests.

'''Troubleshooting'''

* [[File:Warning.png]] Note: Une erreur possible est que Google refuse l'accès même si votre configuration est correcte, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous.
Pour vérifier si Google a bien bloqué l'accès pour ce motif, allez sur la page https://security.google.com/settings/security/activity?hl=fr après l'échec.

Si Google affiche qu'il a bloqué des tentatives d'accès depuis un lien inhabituel, accepter cette tentative. Ensuite, il faut attendre 24h pour essayer à nouveau.

* [[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès même si votre configuration est correcte, parce que vous avez activez la validation en 2 étapes. Pour vérifiez si vous avez effectivement activé cette option, aller sur la page: {{GoogleURLToSetup2StepValidation}}

Si dans la rubrique "Validation en deux étapes", vous avez "Activé", le problème est la. Vous n'êtes pas obligé de la désactiver. Vous pouvez résoudre le problème ainsi: Cliquer sur "Modifier" à côté du titre de la rubrique "Validation en 2 étapes".
Cliquez sur le lien "Gérer les mots de passe spécifiques à des applications". Saisissez un nom, par exemple "Accès google par Dolibarr" et valider. Un mot de passe vous sera fourni.
Retournez sur la page de configuration du module Google dans Dolibarr et enregistrez ce mot de passe dans la page de configuration du module à la place de votre mot de passe habituel, puis '''Enregistrer'''. Réessayer le test de synchro.

* [[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès, même si votre configuration est correcte, parce que le serveur sur lequel tourne Dolibarr ou l'ordinateur avec lequel vous y accédez n'est pas à l'heure.

== Configuration fonction GMaps ==

1) Dans un premier temps, vous devez activer l'API pour votre compte Google. Pour cela, aller sur la page {{ModuleGoogleUrlToCreateApiAccount}}. Cliquez pour "Activer API" pour "Google Maps Geocoding API" and "Google Maps JavaScript API".

2) Créer une clé API de type "Serveur" et saisissez la dans la page de configuration du module Google sur Dolibarr, onglet GMaps.

=== Lien de localisation d'une adresse particulière ===
Choisissez les éléments sur lesquels faire apparaître le picto GMaps après les adresses parmi les suivants:
* Tiers (si le module Tiers est activé)
* Contacts/Adresses (si le module est activé)
* Adhérents (si le module Adhérents est activé)

Choisissez le niveau de zoom de Google pour définir l'échelle par défaut de la carte qui sera affichée (valeur de 1 à 10, 10 étant un zoom plus fort). En général, 7 est une bonne valeur.

=== Liens de cartes globales ===
L'autre fonctionnalité de carte GMaps, est d'offrir une carte globale situant tous vos tiers ou contacts/adresses. Pour voir apparaître les liens vers ces cartes, allez dans le menu Accueil - Configuration - Boites. Assurez vous que la boite "Liens de cartes GMaps" est active.
Retourner sur la page d'accueil de Dolibarr. Si la boite n’apparaît pas, choisissez la dans la liste déroulante des boites que vous pouvez ajouter sur votre espace.

== Configuration Adsense ==
Sur la page de configuration du module, pour l'onglet Agenda, vous devez saisir:
* Votre id client adsense (ca-pub-xxxxxx)
* L'id de slot propre au format de pub à afficher (à retrouver sur la page de configuration adsense.google.com)
Une publicité sera alors affichés sur la page de demo et la logon.

== Configuration Google Analytics ==
Sur la page de configuration du module, pour l'onglet Analytics, vous devez saisir:
* Votre ID Google analytics (Du genre UA-xxxxxxx-y). Cet id s'obtient depuis la console d'administration de Google analytics.
Le tag Google Analytics sera alors affiché sur toutes les pages de Dolibarr.

= Utilisation =
== Utilisation fonction Agenda Google ==

=== Si vous avez activé la synchro Dolibarr vers Google calendar ===

* Créer un événement dans Dolibarr et allez voir dans google Calendar (depuis votre smartphone par exemple). L’événement doit apparaître.

* Si vous voulez synchroniser les changements réalisé du côté Google, aller sur la vue agenda de Dolibarr. Vous devriez trouve un lien pour synchroniser Google vers Dolibarr.

Voir l'exemple ci-dessous. Le lien est la phrase "Click to resfresh agenda database with ..."

<div class="divforimgcentpercent">
[[File:Link for sync from google.png|border]]
</div>

=== Si vous avez activé la fonction affichage de Google calendar ===
Aller dans le menu Agenda. Choisissez l'onglet Agenda Google, le ou les agendas Google configurés s'afficheront alors.
Si vous avez définis plusieurs agenda, vous pouvez restreindre la vue sur l'un à l'autre uniquement via le menu gauche.
Il s'agit ici d'un affichage en lecture seule.
Pour faire des ajouts d’événements dans cet agenda, il faut cliquer sur le lien "+ Google calendar" en bas à droite de l'agenda.

<div class="divforimgcentpercent">
[[File:screen_shot_google_view_agenda.png|border]]
</div>

Pour des raisons de sécurité imposées par Google, la vue agenda de Google ne s'affichera correctement que si vous êtes logué sous Google.
Afin de faciliter cela, il est possible de configurer une clé pour permettre à l'application de proposer la Logon Google si vous n'êtes pas déjà connecté (Voir pour cela la dernière rubrique de paramètres de l'onglet Agenda de la page de configuration du module Google).

== Utilisation fonction GMaps ==
Selon le choix fait à la configuration, un petit picto apparaît sur la fiche Tiers, Contacts/Adresses ou adhérents au bout de l'adresse. En cliquant dessus, vous voyez apparaître une carte avec l'adresse positionnée dessus. Il vous ait possible de naviguer dans la carte sans quitter Dolibarr.

Voici un exemple obtenu en cliquant sur le picto qui apparait au bout de l'adresse de la fiche d'un tiers.

<div class="divforimgcentpercent">
[[File:screen_shot_google_address.png|border]]
</div>

De plus, à partir de la version 3.4, vous avez aussi accès à une boite sur la page d'accueil présentant un lien pour voir l'ensemble de vos Tiers, ou Adhérents sur une même carte.

<div class="divforimgcentpercent">
[[File:screen_shot_google_box.png|border]]
</div>

Voici un exemple obtenu en cliquant sur le lien "Carte des adhérents" qui sera sur la page d'accueil.
Notez que, pour les tiers, vous pouvez filtrer sur le commercial, ou toute tag/catégorie client ou fournisseur.

<div class="divforimgcentpercent">
[[File:screen_shot_google_map.png|border]]
</div>

== Utilisation fonction Adsense ==
Il n'y a rien à faire à l'utilisation. Une fois la configuration faite (voir précédemment), une publicité adsense apparait sur la page de logon.

Note: Lorsque Dolibarr est accéder via l'[[Application Android - DoliDroid FR]], la publicité ne sera toutefois pas active.

== Utilisation fonction Google Analytics ==
La aussi, il n'y a rien de particulier à faire. Une fois configuré (voir précédemment), un tag Google Analytics invisible est inséré dans chaque page de Dolibarr. En utilisant l'interface Google de Google Analytics, vous pouvez avoir des statistiques de consultation des pages de Dolibarr, comme si il s'agissait d'une application Web publique.

Note: Lorsque Dolibarr est accédé via l'[[Application Android - DoliDroid FR]], le tags ne seront toutefois pas actif.

= Développement =
{{TemplateModNLTechnoFr}}

Module Factory

2019-07-23T12:26:20Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Factory - factory]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="GPAO, gestion de production, gestion, fabrication, composition"/>

= Informations =
{{TemplateModuleInfo
|modulename=Factory
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.4.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/gestion-produits-ou-services/386-Factory--la-GPAO-pour-Dolibarr.html?search_query=factory&results=3]
|note=
}}

= Fonctionnalités =
Factory est le module de GPAO (gestion de produit assisté par ordinateur) de Dolibarr.
* Factory permet la composition, la planification de fabrication et complète la gestion globale de produits native de Dolibarr.
** Détermination de la composition
** Fabrication directe ou indirecte (ordres de fabrication)
** Grande ou petite série
** Interne ou externe
** Gestion des mouvements de stock associés
** Déclinaisons de produits.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-Factory/]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/factory/list.php?idmenu=45] : lien de menu secondaire "factory" du menu principal produit/services
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-Factory/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/17277-module-gestion-de-production?start=90#57880]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module ExtraPrice

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:ExtraPrice - extraprice]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="pondération, prix de vente, formule"/>

= Informations =
{{TemplateModuleInfo
|modulename=extraPrice
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.5.1
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/outils-systemes/350-Extraprice-Premium---R--gle-de-calcul-du-Prix-de-vente.html?search_query=extraprice&results=2]
|note=
}}

= Fonctionnalités =
Ce module permet de définir une règle de calcul pour la détermination du prix de vente unitaire (par exemple en prenant des paramètres supplémentaires - extrafields), cette version premium ajoute le paramétrages de valeurs personnalisées par catégories (client et produit).

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-ExtraPrice/]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-Extraprice-1.1.0/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/47693-nouveau-module-extraprice-pour-3-5-1#57659]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/creation-a-la-demande/formule-extraprice]

Module ExtraOdt

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:ExtraOdt - extraOdt]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="personnalisation, document, texte, ODT, condition, filtre, tableau, liste édition"/>

= Informations =
{{TemplateModuleInfo
|modulename=extraOdt
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.6.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modeles-de-documents/440-ExtraODT---tableaux-suppl--mentaires-sur-les-ODT.html?search_query=extraodt&results=1]
|note=
}}

= Fonctionnalités =
Ajoute champs et tableaux supplémentaires dans les éditions ODT de dolibarr avec condition d'affichage.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-ExtraOdt/]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-ExtraOdt-1.0.0/]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/index.php] : fichiers joints sur les fiches tiers

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/3-installation/51802-extraodt-tableaux-et-fonctions-avancees-pour-odt#55468]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/creation-a-la-demande/document-texte-personnalise]

Module Equipement

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Equipement - equipement]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="traçabilité, sérialisation, numéro de série"/>

= Informations =
{{TemplateModuleInfo
|modulename=Equipement
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.4.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/193-Equipement---tra--abilit---et-s--rialisation-produits.html?search_query=equipement&results=1]
|note=
}}

= Fonctionnalités =
Equipement permet la traçabilité et l'attribution de numéro de série sur les produits manufacturés ou vendus et aussi de suivre le cycle de vie des produits en liant des état et des conditions aux produits. Equipement fonctionne avec les multiples modules natifs de Dolibarr.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-Equipement/]
* Démontration [http://dlbdemo.patas-monkey.com/htdocs/equipement/index.php?leftmenu=equipement&idmenu=176] : menu secondaire "Equipements"
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-%C3%A9quipement-1.4.1/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/12-howto--aide/9610-produits-et-numeros-de-serie?start=75]

= Assistance =
Formulaire de contact[http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module Eco Taxe DEEE

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:EcoTax WEEE]]
[[Category:NLTechno]]
{{TemplateDocDevFr}}
{{TemplateDocUtil}}
<seo metak="eco tax, deee, weee, taxe, éco" />
= Informations =
{{TemplateModuleInfo
|modulename=Eco Tax DEEE
|editor=NLTechno
|web=[https://www.nltechno.com www.nltechno.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ecotaxdeee}}
|status=stable
|prerequisites=
|minversion=3.7.0
|note=
}}

= Fonctionnalités =
Ce module ajoute la fonction de gestion de l'écotaxe européenne DEEE (Déchets d'équipements électriques et électroniques):
* Permet de définir un montant de taxe DEEE sur chaque produit.
* Quand un produit est ajouté à une facture, commande ou proposition commercial, une ligne est automatiquement ajoutée avec le montant de la taxe éco (si le produit a un montant d'éco taxe DEEE défini dessus). Rem: Les objects fournisseurs ne sont pas gérés.
* Permet d'exporter la liste des lignes et montants des éco taxes facturés.

= Installation =
{{InstallModuleFr}}

= Configuration =
{{ActivationModuleFr}}

Une fois sur l'onglet de configuration, choisissez si vous voulez avoir une ligne éco taxe ajoutée pour les
* propositions clients
* commandes clients
* factures clients
ou toute combinaison des 3.

De plus, la directive européenne impose que le barème des coûts unitaire de l'éco taxe DEEE soit jointe avec la facture (en pied de page ou en annexe). Ce montant des taxes unitaires (barème) est indépendant du contenu de la facture et doit être hors corps des lignes de factures.
Pour ajouter une telle information, saisir dans la zone "'''Contenu de la page Annexe à ajouter...'''", le texte à ajouter sur la page annexe. Cette page sera ajoutée à tout PDF généré, dès lors que celui-ci contient au moins une ligne de tax DEEE.

Example: Copie écran de la page de configuration du module (cliquez pour agrandir)

<div class="divforimgcentpercent">
[[File:Ecotax screen shot 1.png|border]]
</div>

[[File:warning.png]] Attention, avec Dolibarr < 3.7, le champ pour stocker le montant de l'éco tax DEEE sur les fiches produits n'est pas disponible par défaut, aussi vous devez l'ajouter manuellement: Allez dans le menu '''Accueil - Configuration - Modules - Produits - Attributs complémentaires''' et ajouter le champ avec le libellé "'''Eco tax DEEE'''", code "'''ecotaxdeee'''" et le format "'''décimal'''".

= Utilisation =
== Modification des produits ==
Une fois la configuration complète, vous pouvez renseigner le montant HT de l'eco taxe DEEE sur vos produits. Ne la renseignez que sur les produits qui sont sujets à l'éco taxe DEEE.
Il est recommandé également d'ajouter dans le libellé du produit, une ligne stipulant la catégorie de l'éco taxe du produit. Par exemple, au lieu d'avoir comme descriptif
<source lang="ini">
Emetteur ultrason contre les insectes
Inaudible pour l'homme
</source>
vous pouvez mettre
<source lang="ini">
Emetteur ultrason contre les insectes
Inaudible pour l'homme
Catégorie de contribution DEEE: A
</source>

== Création des propositions/commandes/factures ==
Ensuite, quand vous créerez une proposition/commande ou facture client (selon les options activées dans la configuration), lorsque vous ajouterez le produit concerné, le montant de l'éco taxe DEEE sera calculée et une ligne spéciale ajoutée avec ce montant. Notez que l'eco taxe DEEE étant considéré comme un service, si la TVA est applicable à votre cas, elle sera aussi incluse dans le total TTC.

Vous pouvez toutefois éditer le montant de l'écotaxe manuellement. Attention toutefois, ce montant est recalculé et modifié dès que vous ajouterez, supprimerez ou modifierez une ligne de produit.

Il n'y a pas de règle pour tenir compte du pays de l'acheteur. La ligne Eco taxe DEEE sera donc ajoutée dès lors que la ligne produit a une Eco Taxe DEEE définie dessus, quelquesoit le pays de l'acheteur. Libre à vous de modifier ou pas pour les cas particuliers.

Voici un exemple de facture générée avec un produit vendu en 5 exemplaire et qui a une ecotaxe de 0.02 euros:

[[File:Example of invoice with weee.png|border]]

== Export des lignes de DEEE ==
Pour obtenir un fichier export qui recense toutes les lignes de DEEE saisies, faites un export des "'''Factures clients et lignes de factures'''" depuis le menu '''Outil - Export''' (le Module Export doit avoir été activé).
A l'étape 3 de l'assistant export, dans le champ "Ligne de facture - Description ligne", mettez le libellé de ligne que vous avez défini dans la configuration du module DEEE (Par défaut "Eco Tax WEEE").
Ainsi, lors de l'export, vous aurez toutes les factures avec la ligne correspondant à la DEEE (et uniquement ces lignes).

Note: Vous pouvez aussi mettre un filtre avec des caractères génériques comme '''%WEEE%''' pour sortir toutes les lignes qui contiennent le mot "WEEE" dans la description.

= Développement =
{{TemplateModNLTechnoFr}}

Module Eco Tax WEEE

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:EcoTax WEEE]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
<seo metak="eco tax, deee, weee, tax, eco" />
= Informations =
{{TemplateModuleInfo
|modulename=Eco Tax WEEE
|editor=NLTechno
|web=[https://www.nltechno.com www.nltechno.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ecotaxdeee}}
|status=stable
|prerequisites=
|minversion=3.7.0
|note=
}}

= Features =
This module allow you to manage eco tax WEEE:
* Can define amount of the WEEE tax for each predefined product.
* When you add a product into invoice, order or proposal, a line is automatically added with amount of eco tax (if product has an eco tax weee defined for it).
* Can export list of all invoices lines / amount of ecotax weee you used.

= Install =
{{InstallModuleEn}}

= Setup =
{{ActivationModuleEn}}

Once on setup tab, just choose if you want to have the automatic weee line added on
* customer proposals
* customer orders
* customer invoices
or any combination of them.

Also, in some countries (for example France), you must add an annex page into your PDF to provide list of unit amount for each category of eco tax.
Starting from Dolibarr 3.6, just fill the area "Content of new page to add" with content your want to have into this annex page. This page will be added into generated PDF if there is at least one weee tax line. Keep this field empty if you don't want to add annex page.

Example: Screenshot of module setup page (click to enlarge)

<div class="divforimgcentpercent">
[[File:Ecotax screen shot 1.png|border]]
</div>

[[File:warning.png]] With Dolibarr 3.4+, the field to store Eco tax is not available by default onto product card, so you must define it manually: Go into menu '''Home - Setup - Modules - Products - Complementary attributes''' and add the field with label "'''Eco tax'''", code "'''ecotaxdeee'''" and format "'''float'''".

= Development =
{{TemplateModNLTechnoEn}}

Module ECommerce NG (Magento)

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:Magento]]
[[Category:E-commerce]]
[[Category:Teclib]]
{{TemplateDocDev}}
{{TemplateDocUser}}
<seo metak="Magento, Dolibarr, synchro, synch, interface" />
= Informations =
{{TemplateModuleInfo
|modulename=Ecommerce NG (Magento)
|editor=Teclib
|web=[http://www.teclib.com www.teclib.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=magento}}
|status=development
|prerequisites=
|minversion=3.9.0+
Prerequisite of Magento: Magento version 1.9.* - 1Gb of allowed memory on the PHP where Magento run may be required
|note=
}}

= Features =

Integrates a Magento - Dolibarr synchronyzation. It is a module to be installed in Dolibarr.
Access to Magento is done by dolibarr using default Magento's WebServices.

WARNING : Actually this module is under developpement and use the same core as [https://wiki.dolibarr.org/index.php/Module_woocommerce_EN Module ECommerce NG (Woocommerce) EN].

= Installation =
== Magento ==
We suppose you have a Magento already available. If not, this is quick steps to install it:
* Go on www.magento.com to download last version.
* Unzip package on a magento root directory
* Create an empty database on your mysql/mariadb server
* Create a virtual host on your apache server to point to this magento directory and call this url. Use external url for your localhost. A wizard will start to initialize Magento. Note: If you need to work locally only, with an internal URL, you must known than with magento < 2, the name of the virtual host can't be "localhost". But you can edit your /etc/hosts file to add an entry like '''magento.local''' or '''localhost.localdomain''' on ip '''127.0.0.1''' and use this (this suppose you want to work locally only).

Note 1: The URL for administration backoffice may be /index.php/admin or /index.php/administrator or /index.php/admin_xxxxx (where xxxxx is a number)

Note 2: To reset password of an admin user: UPDATE admin_user SET password = MD5('NEWPASSWORD') WHERE username = 'admin';

Note 3: config files of Magento are stored into '''app/etc'''

== Dolibarr module ==
{{InstallModuleEn}}

= Setup =
{{ActivationModuleEn}}

== Setup on Magento side ==
* Create first a Webservice SOAP/XML RPC role from admin interface '''System - Webservices - SOAP/XML RPC Roles''', for example role '''soaprole'''. Grant this role Access to *All resources*.
* Create a Webservice SOAP/XML RPC account from admin interface '''System - Webservices - SOAP/XML RPC User''', for example account '''soapuser'''. Remember the password you used into field API key during user creation. Set this user to the role you created at previous step. Note: A user with no role set is useless and Dolibarr won't be able to login with it.
* The parameter '''System - Configuration - Services - Magento Core API - WS/I Compliant''' can be set to true or false.
* Note: If you create a product, to have it visible on Magento shop, check that qty in stock is higher than zero, that status "'''Stock Availability'''" is set to "'''In stock'''" and that product is inside a category of the site.
* Note: With Magento, the stock of a product decrease on Magento side as soon as an order is done on Magento shop.

== Setup on Dolibarr side ==

Aller sur la page de configuration Dolibarr du module Magento.

[[File:Config Magento.jpg|400px]]

* Saisir l'URL des services SOAP Magento.
* Renseigner le login et l'API key créé à l'étape précédente dans Magento (soapuser).
* Choisir la catégorie à utiliser pour marquer les tiers issus de Magento ou ceux à pousser sur Magento. Le tiers assigné à cette catégorie seront poussés en temps réel sur Magento.
* Choisir la catégorie mère dans laquelle sera créée les catégories produits issues de Magento. Les produits créés ou modifiés qui sont assignés à une catégorie ou sous-catégorie de cette dernière seront poussés sur Magento en temps réel.
* '''Stock synchronisation direction''': Option Stock synchronisation direction: Mettre le sens de la synchronisation du stock.
* '''Warehouse for stock initialization''': Enter here the warehouse that will be used for any stock init/change when a product is created into Dolibarr because a new product (with a stock not empty) is found on eCommerce shop. This parameter is not used if previous option '''Stock synchronisation direction''' is set to '''None''' or '''dolibarr2ecommerce'''.

= Usage=

== Synchronize from Magento to Dolibarr ==

Before doing your first synchronization, you must check this:

* Be sure to not having too much categories on Magento side (< 1000)
* If you already have thirdparties on Dolibarr side, check that reference of thirdparties are same than name on your ecommerce. If not, the synch won't be able to detect a record already exists and it will recreate another thirdparty on Dolibarr side. For contact/addresses, check is done on all fields "firstname + lastname + address + zip + town".

Synchronizing can be done manually from page '''Synchronizing Site ...''':

{|class="wikitable sortable"
|-
!Action into Magento !! Effect into Dolibarr !! When !! Note
|-
|Categories created/modified into Magento || Created into Dolibarr as sub-categories of the parent category used for Mangeto categories (defined into module setup) || Manual click on "Magento to Dolibarr sync" button || <div style="color: #060">Available</div>Table llx_ecommerce_category is updated to store a link between dolibarr category id and remote magento id. Due to a lack of search on last modified time on Magento API, this sync may be slow if you have a high number of categories
|-
| Products or Stock created/modified into Magento || Created into Dolibarr and linked to its categories.<br>If module stock is enabled and '''Stock synchronisation direction''' was set to "ecommerce2dolibarr", stock is also initialised/updated into warehouse defined into eCommerce dolibarr module setup || Manual click on "Magento to Dolibarr sync" button || <div style="color: #060">Available</div>Table llx_ecommerce_product is updated to store a link between dolibarr product id and remote magento id
|-
| Thirdparties and contact/addresses created/modified into Magento || Created into Dolibarr || Manual click on "Magento to Dolibarr sync" button || <div style="color: #060">Available</div>Table llx_ecommerce_societe and llx_ecommerce_socpeople is updated to store a link between dolibarr thirdparty id and remote magento id. To know if a thirdparty already exists, Magento check on the ref. To know if a contact already exists, Magento check on all fields firstname, lastname, address, zip, town (and thirdparty).
|-
| Orders created/modified into Magento || Created into Dolibarr || Manual click on "Magento to Dolibarr sync" button || <div style="color: #060">Available</div>Table llx_ecommerce_commande is updated to store link of dolibarr order id and remote magento id
|-
| Shipment created/modified in Magento || Creating a shipment in Magento is changing Magento status of the Order from "pending" to "processing". Because it is changing status of order, see case "Order created/modified into Magento". || Manual click on "Magento to Dolibarr sync" button ||<div style="color: #060">Available</div>''Note:'' The shipment is not downloaded into Dolibarr, only status of Dolibarr Order will be changed like is the Magento order.<br>''Note:'' You may choose to manage shipment on Dolibarr or Magento (we recommand to create/update shipments on Dolibarr and not into Magento).
|-
| Invoices created/modified into Magento || Created into Dolibarr (with correct status but without payments) || Manual click on "Magento to Dolibarr sync" button || <div style="color: #660">Available</div>Table llx_ecommerce_facture is updated to store a link between dolibarr invoice id and remote magento id.<br>''Note:'' in develop git only the payment is also recorded in dolibarr.
|}

TODO In a future version, the "Magento to Dolibarr sync" button could be replaced with a scheduled job/script to launch it automaticaly every hour for example.

== Synchronize from Dolibarr to Magento ==

Synchronizing is done in real time.

{|class="wikitable sortable"
|-
!Action into Dolibarr !! Effect into Magento !! When !! Note
|-
| Categories created into Dolibarr || No update is currently done on Magento. In a future version, creation will be done into Magento if category is inside the parent category for Magento, defined into module setup || No creation/update is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Categories modified into Dolibarr || No update is currently done on Magento. In a future version, update will be done into Magento if category is linked to Magento (category was created by a "Magento to Dolibarr sync") || No creation/update is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Products created into Dolibarr || None. In a future, creation will be done into Magento if product has a category inside tree of Magento categories || No creation is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Products or Stock modified into Dolibarr || Update into Magento is done if product is linked to Magento (product was created by a "Magento to Dolibarr sync")<br>If module stock is enabled and '''Stock synchronisation direction''' was set to "dolibarr2ecommerce", then stock is also overwritten on Magento|| Real time || <div style="color: #060">Available</div>
|-
| Thirdparties created || None. In a future version, creation will be done into Magento if thirdparty has the category of Magento thirdparties (defined into setup) || No creation is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Thirdparties modified into Dolibarr || Update into Magento is done if thirdparty is linked to Magento (thirdparty was created by a "Magento to Dolibarr sync") || Real time || <div style="color: #060">Available</div>
|-
| Contact/addresses created into Dolibarr || None. In a future version, creation will be done into Magento if thirdparty has the category of Magento thirdparties (defined into setup) || No creation is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Contact/addresses modified into Dolibarr || Update into Magento is done if contact/address is linked to Magento (contact/address was created by a "Magento to Dolibarr sync") || Real time || <div style="color: #060">Available</div>
|-
| Orders created (validated) into Dolibarr || None || || Orders created directly into backoffice does not need to appear into ecommerce. See next line for Orders modified.
|-
| Orders modified into Dolibarr || Order will be updated into Magento if order is linked to Magento (order was created by a "Magento to Dolibarr sync") || No update is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Shipments created (validated) into Dolibarr || Shipment will be created/modified into Magento if source order of shipment was created by a "Magento to Dolibarr sync" || Real time || <div style="color: #060">Available</div>
|-
| Shipments modified (closed) into Dolibarr || This step does not exists on Mangento, so nothing is done || || NA
|-
| Invoice created (validated) into Dolibarr || None. In a future, invoice will be created/modified into Magento if source order was coming from Magento || No creation/update is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO</div>
|-
| Invoice modified into Dolibarr (for exemple when status change to paid because of a payment entered) || None. In a future, invoice will be created/modified into Magento if source order was coming from Magento || No creation/update is currently done on Magento. In a future version, sync will be in real time || <div style="color: #600">TODO Priority 1</div>
|-
| Stock of a product modified into Dolibarr (whatever is reason: shipment processed, order or invoice validated, depending on your Dolibarr setup of the stock change rule, manuel change of stock or inventory)|| Stock is updated on Magento if product exists also in Magento || Real time || <div style="color: #060">Available</div>
|}

= Development =
{{TemplateModTeclibEn}}

Please submit your PR to this repository if you make enhancements to this module.

= TroubleShooting =
Due to a problem in Magento, if you have a large number of product categories, you may experience low performance when counting data to synchronize and when making a synchronize.
This is how you can fix this:

On Magento 1.9 side, edit the file '''app/code/core/Mage/Catalog/Model/Category/Api.php''' to add the line that is under the comment /* FIX */

<source lang="php">

...

/**
* Convert node to array
*
* @param Varien_Data_Tree_Node $node
* @return array
*/
protected function _nodeToArray(Varien_Data_Tree_Node $node)
{
// Only basic category data
$result = array();
$result['category_id'] = $node->getId();
$result['parent_id'] = $node->getParentId();
$result['name'] = $node->getName();
$result['is_active'] = $node->getIsActive();
$result['position'] = $node->getPosition();
$result['level'] = $node->getLevel();

/* FIX Add here this new line to add the missing property returned by web service */
$result['updated_at'] = $node->getUpdatedAt();

$result['children'] = array();

foreach ($node->getChildren() as $child) {
$result['children'][] = $this->_nodeToArray($child);
}

return $result;
}

...

</source>

Module ECommerce NG (Magento) FR

2019-07-23T12:26:19Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:Magento]]
[[Category:Teclib]]
[[Category:E-commerce]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
<seo metak="Magento, Dolibarr, synchro, synchronisation, interface" />
= Informations =
{{TemplateModuleInfo
|modulename=ECommerce NG (Magento)
|editor=Teclib
|web=[http://www.teclib.com www.teclib.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=magento}}
|status=development
|prerequisites=
|minversion=3.9.0+
Prerequisite of Magento: Magento version 1.9.* - 1Gb of allowed memory on the PHP where Magento run may be required
|note=
}}

= Fonctionnalités =
Intègre une synchronisation Magento - Dolibarr.
Il s'agit d'un module qui s'installe sur Dolibarr. L'accès à Magento est fait par Dolibarr en utilisant les Web services par défaut de Magento.

= Installation =
{{InstallModuleFr}}

= Configuration =
{{ActivationModuleFr}}

== Configuration côté Magento ==
* Créer un compte Webservice SOAP/XML RPC depuis l'interface admin System - Webservices - SOAP/XML RPC, par exemple le compte '''soapuser'''.
* Mettre un mot de passe dans le champ API key.

== Configuration côté Dolibarr ==

Aller sur la page de configuration Dolibarr du module Magento.

[[File:Config Magento.png|400px]]

* Saisir l'URL des services SOAP Magento.
* Renseigner le login et l'API key créé à l'étape précédente dans Magento (soapuser).
* Choisir la catégorie à utiliser pour marquer les tiers issus de Magento ou ceux à pousser sur Magento. Le tiers assigné à cette catégorie seront poussés en temps réel sur Magento.
* Choisir la catégorie mère dans laquelle sera créée les catégories produits issues de Magento. Les produits créés ou modifiés qui sont assignés à une catégorie ou sous-catégorie de cette dernière seront poussés sur Magento en temps réel.

= Utilisation=

== Synchronisation de Magento vers Dolibarr ==

== Synchronisation de Dolibarr vers Magento ==

= Développement =
{{TemplateModTeclibFr}}

= TroubleShooting =
A cause de problemes dans Magento, si vous avez un nombre important de catégories de produits, vous constaterez de très mauvaise performance lors du comptage des données à synchroniser ou lors de la synchronisation. Voici une modification qui peut améliorer cela:

Sur Magento 1.9, éditer le fichier '''app/code/core/Mage/Catalog/Model/Category/Api.php''' pour ajouter la ligne visible en commentaire

<source lang="php">

...

/**
* Convert node to array
*
* @param Varien_Data_Tree_Node $node
* @return array
*/
protected function _nodeToArray(Varien_Data_Tree_Node $node)
{
// Only basic category data
$result = array();
$result['category_id'] = $node->getId();
$result['parent_id'] = $node->getParentId();
$result['name'] = $node->getName();
$result['is_active'] = $node->getIsActive();
$result['position'] = $node->getPosition();
$result['level'] = $node->getLevel();

/* FIX Add here this new line to add the missing property returned by web service */
/*********/
$result['updated_at'] = $node->getUpdatedAt();
/*********/

$result['children'] = array();

foreach ($node->getChildren() as $child) {
$result['children'][] = $this->_nodeToArray($child);
}

return $result;
}

...

</source>

Module DoliPresta

2019-07-23T12:26:16Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Complementary modules]]
[[Category:E-commerce]]
[[Category:Tiaris]]
{{TemplateDocDev}}
{{TemplateDocUser}}
<seo metak="Prestashop, Opencart, E-commerce, Magento, Dolibarr, synchro, synch, interface" />

= Informations =
{{TemplateModuleInfo
|modulename=Dolipresta
|editor=Tiaris
|web=[http://www.tiaris.eu Tiaris]
|webbuy=[https://www.dolistore.com/fr/modules/472-Tiaris-Dolipresta-Gestion-e-commerce-de-Dolibarr-pour-Prestashop.html Dolistore]
|status=stable
|prerequisites=
|minversion=3.7
|maxversion=3.9
Prestashop version 1.6
|note=
}}

= Features =

Dolipresta allows to manage products, orders, customers from coming Prestashop e-commerce sites with Dolibarr.
It is developped and maintained by http://tiaris.eu since 2008.

It is the Prestashop version of our general E-commerce module for Dolibarr wich is also available for Opencart, Magento and oscommerce sites.

Philosphy of our system is : "sell on e-commerce sites, and manage with Dolibarr".

With our system you can :

- manage products with Dolibarr, send them on sell on e-commerce sites
- synchronise Dolibarr stock with e-comme'ce sites
- import orders to Dolibarr and process your orders with your favorite ERP. order status is autoamtically sybchronized with e-commerce.
- create orders invoice with Dolibarr, customer can download it from his account on the e-commerce site.
- manage several e-commerce sites with one dolibarr system

Our system for Prestashop is available in several versions :

- Community : simple for e-merchants who do not need the full stuff, and want to install and manage by themseleves (available on dolistore)
- Pro : installed by our specialists on your servers (ask for price)
- Cloud : as a Cloud service hosted by Tiaris (ask for prices)

For Opencart, Magento, Oscommerce : Only versions Pro and Cloud are available

Module CustomTabs

2019-07-23T12:26:13Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:customTabs - customtabs]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="création, onglet, onglets, personnalisé personnalisés, GED"/>

= Informations =
{{TemplateModuleInfo
|modulename=customTabs
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.3.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/354-customTabs--g--n--rateur-d-onglets-personnalis--s.html?search_query=customtabs&results=1]
|note=
}}

= Fonctionnalités =
* CustomTabs permet l'ajout d'onglets supplémentaires sur les fiches d'éléments de Dolibarr (clients, produits,...) sous forme de fiche ou de liste.
* Possibilité d'ajout de template et une gestion de documents (GED).
* Les droits d'accès aux onglets sont gérés par groupes d'utilisateurs. Les données saisies dans des onglets peuvent être utilisées dans les ODT.
* CustomTabs est compatible avec Factory.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-CustomTabs/]
* Démonstration [http://dlbdemo.patas-monkey.com/htdocs/myfield/core/patastools.php?mainmenu=patastools&leftmenu=mylist&idmenu=114&mainmenu=patastools&leftmenu=] : menu secondaire customTabs
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-de-module-CustomTabs-1.1.2/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/49041-customtabs-creation-d-onglets-personnalises?start=15#58270]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/creation-a-la-demande/realisation-d-onglets]

Module CustomLink

2019-07-23T12:26:13Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:customLink - customlink]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="liaison, éléments"/>

= Informations =
{{TemplateModuleInfo
|modulename=customLink
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.3.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/outils-systemes/383-customLink--am--lioration-des-liens-entre---l--ments.html?search_query=customLink&results=1]
|note=
}}

= Fonctionnalités =
Le module CustomLink améliore les liaisons entre éléments de Dolibarr par :
* L’amélioration de la gestion native des liaisons entre documents
* Ajout de tags sur les documents
* Liaison de contacts et d’utilisateurs entre tiers
* Ventilation de facture fournisseur sur des factures

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-CustomLink/]
* Démontration [http://dlbdemo.patas-monkey.com/htdocs/]
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-CustomLink-1.1.0/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/50580-nouveau-module-customlink]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/contact/nous-contacter]

Module CustomLine

2019-07-23T12:26:13Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
[[Category:customLine - customline]]
[[Category:patas-monkey]]
[[Category:benke]]
<seo metak="personnalisation, saisie, produit, services, libres, prédéfini"/>

= Informations =
{{TemplateModuleInfo
|modulename=customLine
|editor=[[File:Patasmonkey.jpg]]
|web=[http://www.patas-monkey.com]
|status=stable
|minversion=3.6.x
|webbuy=www.dolistore.com[http://www.dolistore.com/fr/modules/438-customLine--s--lection-du-mode-d-entr--e-des-produits-services.html?search_query=customLin&results=2/]
|note=
}}

= Fonctionnalités =
* CustomLine permet la personnalisation du tableau d’affichage de nouvelles lignes dans les documents commerciaux
* CustomLine permet de choisir pour chacun des documents commerciaux si doit être proposé la liste déroulante
des produits/ services enregistrés et/ou la liste de produits/ services libres avec saisie de description.

= Utilisation =
* Fiche technique [http://patas-monkey.com/index.php/fr/support/repository/Pr%C3%A9sentation-de-nos-modules/Versions-fran%C3%A7aises/Pr%C3%A9sentation-CustomLine/]
* Démontration [http://dlbdemo.patas-monkey.com/htdocs/] : option de saisie de produits prédéfinis seulement activée sur les propositions commerciales, commande et factures.
* Guide utilisateur [http://patas-monkey.com/index.php/fr/support/repository/Documentation/FR/Guide-utilisateur-du-module-CustomLine-1.0.1/]

= Installation =
* Télécharger le fichier archive du module (.zip) depuis le site web dolistore.com
* Décompresser le fichier zip dans le répertoire '''/htdocs/''' de dolibarr.
* Le module peut alors être activé, paramétré si besoin (Accueil->Configuration->Modules) et utilisé

= Forum des utilisateurs =
Forum Dolibarr [http://www.dolibarr.fr/forum/511-creation-dun-nouveau-module/51993-customline-mieux-gerer-la-saisie-des-produits#56764]

= Assistance =
Formulaire de contact [http://patas-monkey.com/index.php/fr/support/support-sur-nos-modules]

Module AdresseFrance

2019-07-23T12:26:13Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

[[Category:Modules complémentaires]]
<seo metak="adresse, postal code, city, france, autocomplete"/>

= Informations =
{{TemplateModuleInfo
|modulename=AdresseFrance
|editor=SM 2i
|web=https://soamichel.fr
|status=stable
|minversion=3.7.0
|note=
|webbuy=https://www.dolistore.com/fr/modules/674-AdresseFrance.html
}}

= Fonctionnalités =
Lors de la création et l'édition d'un tiers et d'un contact, la saisie d'adresse postale est autocompleté via l'API https://adresse.data.gouv.fr/api/. Le code postal et la ville sont remplis automatiquement.

= Installation =
{{InstallModuleFr}}

Migrer mon Dolibarr vers une offre Cloud

2019-07-23T12:26:13Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="migrer, bascule, restauration, instance, en ligne, hébergement, serveur, changement, DoliCloud, Dolibarr" />
[[File:Reseau.png]] '''J'utilise Dolibarr sur un autre serveur. Comment puis-je migrer vers une offre SaaS comme [https://www.dolicloud.com DoliCloud] ou [https://www.novafirstcloud.com NovaFirstCloud] (Hébergement de Dolibarr dans le Cloud) ?'''

Cette page explique comment déplacer une instance existante de Dolibarr ERP & CRM dans un service d'hébergement Web à distance dans le Cloud. Ce tutorial devrait fonctionner pour chaque installation Dolibarr utilisant une base de données MySql. L'exemple est basé sur [https://www.dolicloud.com DoliCloud] (mais fonctionne aussi pour [https://www.novafirstcloud.com NovaFirstCloud] et autre. Vous devriez être en mesure de remplacer toutes les choses spécifiques au fournisseur SaaS pris en exemple par n'importe quel autre fournisseur SaaS de Dolibarr).

Vous pouvez exécuter le processus de migration vous-même en suivant ce tutorial.
Toutefois, si vous avez besoin de plus d'aide, vous pouvez poser vos questions par email au support de l'hébergement choisi (par exemple à '''support@dolicloud.com''' pour DoliCloud, ou '''support@novafirstcloud.com''' pour NovaFirstCloud)

= Pré-requis =
* Vérifier que la version de votre Dolibarr (vous la trouverez sur la page de login) est plus faible ou égale à la version proposé en SaaS.
Si votre version locale est plus ancienne, vous pouvez réaliser une mise à jour localement mais ce n'est pas obligatoire, la mise à jour pourra aussi se faire après migration.
Si votre version locale est plus récente, et uniquement dans ce cas, demandez à l'hébergeur de votre nouvelle instance Dolibarr si il peut mettre la même version que la votre avant de dérouler la migration.

= Etape 1 - Sauvegarder votre ancienne base de donnée =
* La première étape est de sauvegarder la base de donnée à migrer dans le SaaS/Cloud.
Pour cela, aller dans le menu '''Accueil - Outils systèmes - Sauvegardes'''. Cliquer sur '''Générer le fichier backup''' (avec la méthode mysqldump de préférence si plusieurs méthodes sont proposées). Ceci lancera la commande de sauvegarde et affichera le fichier de sauvegarde généré qu'il sera possible de télécharger en cliquant dessus.

Note: Si vous rencontrez des problèmes avec cette phase (par exemple à cause de votre ancien hébergeur qui bride votre hébergement ne permettant pas l'exécution de cette commande mysqldump), vous pouvez lancer la commande de sauvegarde depuis n'importe quel autre ordinateur équipé du logiciel MySql installé. Pour cela, il faut lancer la commande suivante:
<source lang="bash">
mysqldump -h ip_ancien_serveur_mysql -P port_ancien_serveur_mysql -u utilisateur_base -pmot_de_passe_base > monancienserveurdump.YYYYMMDD.sql
</source>

* Ouvrez le fichier dump/sauvegarde généré (son nom est du genre mysqldump_A.B.C_YYYYMMDDHHMMSS.sql) pour voir si ce fichier est bien complet: Le fichier doit se terminer par une ligne du genre
<source lang="sql">
-- Dump completed on YYYY-MM-DD HH:mm:ss
</source>
Si oui, enregistrez ce fichier en lieu sur. Il sera requis à l'étape 5.

= Etape 2 - Sauvegarder le contenu de votre répertoire documents =
Tous les fichiers envoyés ou générés sur Dolibarr de votre ancienne instance sont stockés dans un répertoire, nommé en général '''documents''' ou '''dolibar_documents'''. Pour savoir quel est le nom complet exact de ce répertoire pour votre cas, aller sur l'instance à sauvegarder, dans le menu '''Accueil - Infos Systèmes - Dolibarr - Tous les paramètres'''. Le chemin complet ou sont stockés vos fichiers est visible sur la ligne commençant par '''dolibarr_main_data_root'''.

Sauvez ce répertoire et tout son contenu (sous-répertoires et fichiers), en réalisant un fichier zip du répertoire et sous répertoire, ou en recopiant toute l'arborescence sur un autre emplacement du disque dur. Remarque: rarement mais parfois, un fichier '''dolibarr.log''' se trouve à la racine de ce répertoire, vous pouvez le supprimer avant de faire votre zip pour réduire la taille du zip.

= Etape 3 - Créer une instance Cloud =
Si vous n'avez pas encore votre propre instance, inscrivez-vous pour créer votre instance privée.
* Pour DoliCloud, cela se fait sur la page {{UrlDoliCloudRegister}}.
* Pour NovaFirstCloud, cela se fait sur la page {{UrlNovaFirstCloudRegister}}.

Notez que la création d'une instance est gratuite (pour 15 jours) mais vous pouvez demander une prolongation si vous avez besoin de plus de temps pour tester votre migration ou pour prendre plus de temps à vous décider à complètement basculer.

= Etape 4 - Recopier vos documents sur votre instance Cloud =

== Si vous n'avez pas de connaissances techniques dans l'utilisation d'un logiciel FTP ==

Envoyez simplement le fichier généré à l'étape 2 par mail (à '''support@dolicloud.com''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstcloud). Si il est trop gros, mettez le à disposition via un système comme Google Drive, DropBox ou FileTransfer). Indiquer dans le message du mail "'''Pour migration dans ma nouvelle instance Cloud nommée xxxxx'''" (remplacer xxxxx par le nom/url de votre instance). Un technicien écrasera votre répertoire documents de votre nouvelle instance Cloud vierge avec ces fichiers de votre ancienne installation, et vous répondra par mail une fois l'opération faite (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).

== Si vous avez des connaissances dans l'utilisation de logiciel FTP ==

Vous pouvez réaliser cette étape vous-même en suivant la procédure suivante pour remplacer les fichiers documents de votre instance DoliCloud par ceux de votre ancienne installation:

Une fois l'instance DoliCloud créée, vous avez du recevoir un mail avec les identifiants pour vos logguer à votre Dolibarr ainsi qu'à votre panneau de contrôle client.

* D'abord, connectez-vous sur votre nouvelle instance Dolibarr sur DoliCloud (le login est admin par défaut). Aller dans le menu '''Accueil - Infos systèmes - Dolibarr - Tous les paramètres'''. Vous trouverez sur la ligne commençant par '''dolibarr_main_data_root''', le chemin complet du répertoire ou sont stockés les documents de votre nouvelle instance sur DoliCloud.

* Ensuite, loguez-vous sur votre panneau de contrôle client ({{UrlDoliCloudMyAccount}}, le login est votre email d'inscription). Vous y trouverez vos identifiants d'accès SFTP.

* Avec un logiciel SFTP (WinSCP ou FileZilla pour Windows, Nautilus pour la plupart des Linux), loguez-vous sur le serveur de votre instance via le protocole SFTP et ces identifiants. Copiez tous les fichiers et sous-répertoires documents que vous avez sauvegardés, vers le répertoire document de DoliCloud. Un tutoriel plus complet pour se connecter par SFTP et transférer des fichiers peut être trouvé ici: https://www.dolicloud.com/fr/faq/142-faq-how-to-setup-my-sftp

= Etape 5 - Recharger votre ancienne base de donnée sur votre instance Cloud =

== Si vous n'avez pas de connaissances techniques dans le logiciel de gestion de base de donnée Mysql ==

Envoyez simplement le fichier généré à l'étape 1 par mail (à '''support@dolicloud.com''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstCloud) en indiquant dans le message:

''"Pour migration dans ma nouvelle instance dont l'url est __a_completer__"''.

Un technicien écrasera votre nouvelle base DoliCloud vierge avec les données de votre ancienne installation, et vous répondra par mail une fois l'opération faite (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).

== Si vous avez des connaissances dans le logiciel de gestion de base de donnée Mysql ==

Vous pouvez suivre la procédure suivante pour remplacer la base de donnée de votre instance DoliCloud par celle de votre ancienne installation.

* Loguez-vous à votre panneau de contrôle client à nouveau. Vous trouverez un espace donnant vos identifiants MySql.
Aller sur n'importe quel ordinateur sur lequel MySql a été installé. Lancer la commande suivante pour sauvegarder votre base de donnée DoliCloud telle qu'elle est actuellement, avant l'import de vos anciennes données (au cas où, pour la restaurer plus tard si quelque chose se passe mal).
<source lang="bash">
mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql
</source>
avec toutes les informations yourinstance.with.dolicloud.com, doliclouduser, dolicloudpassword et doliclouddatabase qui sont les identifiants Mysql trouvés sur votre espace client.

* Lancez la commande suivante pour remplacer les données de votre base DoliCloud avec les données de votre ancienne base.
<source lang="bash">
mysql -h yourinstance.with.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < monancienserveurdump.YYYYMMDD.sql
</source>

[[Image:Warning.png]] Remarque: Si vous obtenez une erreur de type ''"ERROR 1005 (HY000) at line 25: Can't create table `...`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")"'', alors effacez les 4 tables suivantes, si elles existent, manuellement: llx_accounting_account, llx_accounting_system, llx_accountingaccount, llx_accountingsystem.
Puis retenter la commande de chargement.

[[Image:Warning.png]] Remarque: Si vous obtenez une erreur de type ''"ERROR 1064 (42000) at line 18: You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'TYPE=InnoDb...' at line ..."'', remplacer alors les chaines "TYPE=InnoDB" par "ENGINE=InnoDb" dans le fichier dump. Puis retenter la commande de chargement.

= Tester =
Maintenant, appeler la page de login de votre Dolibarr de votre nouvelle instance.

Si votre ancienne version de Dolibarr était plus ancienne que la version de DoliCloud, vous devriez avoir un message vous invitant à lancer le processus de migration de données. Choisissez simplement le choix proposé recommandé par l'assistant. Si vous recevez un message disant que le processus de mise à jour est "vérrouillé" par le fichier '''install.lock''', lancez à nouveau votre client SFTP et supprimer le fichier '''documents/install.lock'''.

Une fois la mise à jour réalisée, ou si votre version était la même que celle de DoliCloud, vous arrivez sur la page de login et vous pouvez vous connecter à votre Dolibarr en utilisant n'importe quel utilisateur qui existait dans votre ancienne installation, avec le même mot de passe qu'anciennement. Notez que votre login/mot de passe admin qui avait été fourni après la génération de votre instance DoliCloud n'existe plus car il a été écrasé par le chargement de votre ancienne base de donnée à l'étape précédente. Ce sont vos anciens comptes qui sont maintenant valides.

Votre instance privée est en ligne et opérationnelle pour un usage en production. Vous recevrez un mail peu avant la fin de la période de test pour savoir si vous désirez continuer sur une offre payante...

Migrate my Dolibarr To the Cloud

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="migrate, switch, restoration, restoring, instance, on line, hosting, server, change, Dolibarr, DoliCloud, NovaFirstCloud" />
[[File:Reseau.png]] '''I use Dolibarr onto another server. How can I migrate to a Cloud hosting like [https://www.dolicloud.com DoliCloud] or [https://www.novafirstcloud.com NovaFirstCloud] (Hosting service of Dolibarr in the Cloud) ?'''

This description explain how to move an existing instance of Dolibarr ERP & CRM into a remote web hosting service in the Cloud. Tutorial should works for every Dolibarr installation using a MySql database. Example is provided with [https://www.dolicloud.com DoliCloud] (but works similarly for [https://www.novafirstcloud.com NovaFirstCloud] and you should be able to replace all things specific to DoliCloud with any other SaaS provider of Dolibarr).

You can execute all the migrate process yourself following this tutorial.
However, if you need more help, you can ask your questions by email (to '''support@dolicloud.com''' for DoliCloud or '''support@novafirstcloud.com''' for NovaFirstCloud).

= Prerequisites =
* Check that you Dolibarr version (you will find it onto logon page) is lower or equals to DoliCloud version (In most cases, it should be true because DoliCloud plan offers the last stable version).
If your local version is older, it is better to upgrade first locally to same version than DoliCloud, but not necessarily. Upgrade process can also be done after migration to DoliCloud (see later).

= Step 1 - Backup your old database =
* First step is to backup your database. For this, go into menu '''Home - System tools - Backup'''. Click to generate a backup file (with mysqldump method). This will launch mysqldump command and show you the generated file.

Note: If you experience problem running this command (for example because your old hosting provider does not allow to run command mysqldump), you can launch the command from any other computer where MySql client software is installed. For this, run the following command:
<source lang="bash">
mysqldump -h ip_of_old_mysql_server -P port_of_old_mysql_server -u user_database -ppassword_database > myoldserverdump.YYYYMMDD.sql
</source>

* Open the generated dump/backup file (name should looks like mysqldump_A.B.C_YYYYMMDDHHMMSS.sql) to see if file is complete: File should end with such a line:
<source lang="sql">
-- Dump completed on YYYY-MM-DD HH:mm:ss
</source>
If yes, record this file in a secured place. It will be required at step 5.

= Step 2 - Backup content of your documents directory =
All files uploaded or generated using Dolibarr are stored into a directory called '''documents''' or '''dolibarr_documents'''. To know full path of this directory, go into menu '''Home - System info - Dolibarr - All parameters'''. Full path where all you files are stored is visible on line starting with key '''dolibarr_main_data_root'''.

Save this directory and all its content (subdirectories and files).
Note: sometimes, a file called '''dolibarr.log''' may be found into the root of this directory. If you find it you can remote it safely before building your zip file. This will reduce its size.

= Step 3 - Create a Cloud instance =
If you don't have your own DoliCloud instance, create it using the registration form of the provider:
* For DoliCloud, go onto {{UrlDoliCloudRegister}}.
* For NovaFirstCloud, go onto {{UrlNovaFirstCloudRegister}}.
Note that creating your instance is completely free (for 15 days). But you can ask to increase this period if you need more time to complete your migration or to decide if you will continue or not using the service.

= Step 4 - Upload documents into your Cloud instance =

== If you don't have knowledge in using a FTP software ==

Just send the file generated during step 2 by Email (to '''support@dolicloud.com''' for DoliCloud or '''support@novafirstcloud.com''' for NovaFirstCloud). If file is to large, provide it on a Google Drive or DropBox platform). Add the following message into your email "'''To migrate into my new Cloud instance called xxxxx'''" (replace xxxxx by name/URL of your instance). Our support team will overwrite your documents directory of your new empty Cloud instance with files of your old installation and will answer you once action is done.

== If you have technical knowledge in usign a FTP software ==

You can do this step yourself by following this process to replace files into your documents directory of your DoliCloud instance with files of your old installation:

Once DoliCloud instance has been created, you should have received an email with id to log to Dolibarr and to log to your customer dashboard.

* First, log to your new Dolibarr instance on DoliCloud. Go into menu '''Home - System info - Dolibarr - All parameters'''. You will find on line for key '''dolibarr_main_data_root''', the value of full path of directory where documents are stored on DoliCloud instance.

* Then log to your cloud customer dashboard ({{UrlDoliCloudMyAccount}}). You will find an area with your SFTP credentials identifiers.

* With any SFTP software (WinSCP or FileZilla for Windows, Nautilus for most Linux), login to the server of your instance using SFTP protocol and those credentials, to copy all documents files and sub-directories you saved from previous step into the DoliCloud document directory identified at previous step.
A more complete tutorial to connect with SFTP and transfer files may be found here: https://www.dolicloud.com/en/faq/142-faq-how-to-setup-my-sftp

= Step 5 - Load your old database into your Cloud instance =

== If you do not have technical knowledge in Mysql database management software ==

Simply send the file generated in step 1 by email to '''support@dolicloud.com''' indicating in the message "To migrate into my new dolicloud instance called xxxxx.with.dolicloud.com". Our support team will replace your empty new DoliCloud instance with data of your old database and will answer you by email as soon as work is done.

== If you have technical knowledge in Mysql database management software ==

You can use the following procedure to replace the database of your new DoliCloud instance by data of your old installation.

* Log to your new DoliCloud customer dashboard again. You will find an area with your Mysql identifiers.
Go on any computer where MySql and mysqldump command is install. Launch the following command to save the new DoliCloud initialized database (to restore DoliCloud if something is wrong later).
<source lang="bash">
mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql
</source>
where all information yourinstance.with.dolicloud.com ,doliclouduser, dolicloudpassword and doliclouddatabase can be found onto your DoliCloud dashboard.

* Run the following command to overwrite database with database of your old server.
<source lang="bash">
mysql -h yourinstance.on.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < myoldserverdump.YYYYMMDD.sql
</source>

[[Image:Warning.png]] Note: If you get an error like ''"ERROR 1005 (HY000) at line 25: Can't create table `...`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")"'', remove/drop manually the
4 following table if they exists: llx_accounting_account, llx_accounting_system, llx_accountingaccount, llx_accountingsystem. Then try again.

[[Image:Warning.png]] Note: If you get an error like ''"ERROR 1064 (42000) at line 18: You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'TYPE=InnoDb...' at line ..."'', replace the strings "TYPE=InnoDB" with "ENGINE=InnoDb" into dump file. Then try again.

= Test =
Now, call your Dolibarr login page of your new instance.

If your old Dolibarr version was older than DoliCloud Dolibarr version, you should receive a page to ask you to launch the upgrade process. Just choose the choice suggested by the upgrade wizard. If you receive a message saying upgrade is "locked" by file '''install.lock''', launch again your SFTP client and remove the file '''documents/install.lock'''.

Once upgrade is done, or if your version was same than DoliCloud, you can connect using a user that did exists into old server database, with same password.
Your admin user created during the instance init does no more exists as it was overwritten by the database load at previous step.

Migrar en un servicio en la Nube (Cloud)

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="migrar, bascule, restaurar, instancia, en línea, alojamiento, servidor, cambio, DoliCloud, Dolibarr" />
[[File:Reseau.png]] '''Uso Dolibarr en otro servidor. ¿Cómo puedo migrar a [https://www.dolicloud.com DoliCloud] (Alojamiento en la nube Dolibarr)?'''

Esta página explica cómo mover una instancia existente del ERP y CRM Dolibarr en un servicio de alojamiento web remoto en la nube. Este tutorial debería servir para cualquier instalación de Dolibarr que use una base de datos MySQL. El ejemplo se basa en [https://www.dolicloud.com DoliCloud] (pero debería ser capaz de reemplazar todas las referencias específicas a DoliCloud por cualquier otro proveedor de SaaS Dolibarr).

Siguiendo este tutorial usted mismo puede realizar el proceso de migración.
Sin embargo, si necesita más ayuda, puede realizar sus consultas a '''support@dolicloud.com''' (el soporte para la migración se incluye en todos los planes, incluyendo los planes básicos).

= Requisitos previos =
* Compruebe que la versión de su Dolibarr (la encontrará en la página de inicio de sesión) es menor o igual que la versión de Dolicloud (En la mayoría de los casos, debe ser así ya que los planes de DoliCloud se basan en la última versión estable).
Si su versión local es más antigua, puede realizar una actualización a nivel local, pero no es obligatorio, puede realizar la actualización después de la migración a DoliCloud.

= Paso 1 - Guardar su antigua base de datos =
* El primer paso consiste en hacer copia de seguridad la base de datos.
Para ello, vaya al menú '''Inicio - Utilidades sistema - Copia de seguridad'''. Haga clic en '''Generar copia de seguridad''' (preferiblemente con el método mysqldump). Esto lanzará el comando de copia de seguridad y verá el archivo de copia de seguridad generada. Podrá descargarlo haciendo clic sobre él.

Nota: Si ha teniendo problemas en este paso (por ejemplo, debido a que su antiguo servidor ne loe permite ejecutar mysqldump), puede ejecutar el comando de copia de seguridad desde cualquier otro ordenador con MySQL instalado. Para esto, debe ejecutar el siguiente comando:
<source lang="bash">
mysqldump -h ip_antiguo_servidor_mysql -P puerto_antiguo_servidor_mysql -u usuario_base -pcontraseñaacceso > micopiadolibarrantigua.YYYYMMDD.sql
</source>

* Abra el archivo de copia de seguridad generado (su nombre será al estilo mysqldump_A.B.C_YYYYMMDDHHMMSS.sql) para ver si el archivo está completo: El archivo debe terminar con una línea al estilo
<source lang="sql">
-- Dump completed on YYYY-MM-DD HH:mm:ss
</source>
Si es así, guardarde el archivo en un lugar seguro. Lo necesitará en el paso 5.

= Paso 2 - Guardar el contenido de la carpeta documentos =
Todos los archivos enviados o generados en Dolibarr en su antigua instancia se encuentran almacenados en un directorio llamado generalmente '''documents''' o '''dolibar_documents'''. Para saber cual es el nombre exacto de este directorio en su caso, ir al menú '''Inicio - Utilidades sistema - Info. Dolibarr'''. La ruta completa donde se guardan sus archivos la encontrará en la línia que empieza con '''dolibarr_main_data_root'''.

Guarde este directorio y todo su contenido (subdirectorios y archivos), creando un zip del directorio y su contenido o copiando todo su contenido a otra ubicación en el disco duro. Nota: si se encuentra un archivo '''dolibarr.log''' está en la raíz de este directorio, puede eliminarlo antes de hacer su zip postal para reducir el tamaño del mismo.

= Paso 3 - Crear una instancia Dolicloud =
Si no dispone de su propia instancia de DoliCloud, vata al sitio web {{UrlDoliCloudRegister}} y regístrese para crear su instancia privada (haciendo clic en el botón "Crear su instancia ..."). Tenga en cuenta que la creación de una instancia es gratuita (durante 15 días), pero puede solicitar una extensión si necesita más tiempo para probar la migración o decide cambiar por completo.

= Paso 4 - Copiar sus documentos a DoliCloud =

== Si no tiene conocimientos técnicos en el uso de programas de FTP ==

Sólo tiene que enviar por e-mail el archivo generado en el paso 2 a '''support@dolicloud.com''' (o si es demasiado grande, póngalo a disposición a través de un sistema como Dropbox o Google Drive) indicando en el mensaje de e-mail "''' Para migración a mi nueva instancia Dolicloud llamada xxxxx.with.dolicloud.com''' (reemplazando xxxxx con el nombre de la instancia). Un técnico copiará sus documentos a su nueva instancia de DoliCloud y le responderá por e-mail una vez hecha la transacción.

== Si tiene conocimientos técnicos en el uso de programas de FTP ==

Puede hacer este paso usted mismo siguiendo el siguiente procedimiento para reemplazar los archivos de documentos de su instancia DoliCloud por los de su antigua instalación:

Una vez que la instancia DoliCloud haya sido creada, debería haber recibido un e-mail con la contraseña de acceso a su Dolibarr así como a su panel de control del cliente.

* En primer lugar, acceda a su nueva instancia de Dolibarr Dolicloud (login es admin por defecto). Vaya al menú '''Inicio - Utilidades sistema - Info. Dolibarr'''. Encontrará en la línea que empieza con '''dolibarr_main_data_root''', que le indica el directorio completo donde se almacenan los documentos en su nueva instancia DoliCloud.

* A continuación, inicie sesión en su panel de control de cliente ({{UrlDoliCloudMyAccount}}, el inicio de sesión es e-mail de registro). Allí encontrará la información de acceso SFTP

* Con un programa SFTP (WinSCP o FileZilla para Windows, Nautilus en la mayoría de Linux), entre en la cuenta Dolicloud en el servidor a través de SFTP con sus identificadores. Copie todos los directorios y archivos que ha guardado en el directorio de documentos DoliCloud. Puede encontrar aquí un tutorial más completo para conectarse a través de SFTP y transferir de archivos: https://www.dolicloud.com/es/faq/142-faq-how-to-setup-my-sftp

= Paso 5 - Recargar su antigua base de datos en DoliCloud =

== Si no tiene conocimientos técnicos en gestión de base de datos MySql ==

Sólo tiene que enviar por e-mail el archivo generado en el paso 1 a '''support@dolicloud.com''' (o si es demasiado grande, póngalo a disposición a través de un sistema como Dropbox o Google Drive) indicando en el mensaje de e-mail "''' Para migración a mi nueva instancia Dolicloud llamada xxxxx.with.dolicloud.com''' (reemplazando xxxxx con el nombre de la instancia). Un técnico copiará la base de datos a su nueva instancia de DoliCloud y le responderá por e-mail una vez hecha la transacción.

== Si tiene conocimientos técnicos en gestión de base de datos MySql ==

Siga este procedimiento para reemplazar la base de datos de la instancia DoliCloud con la de su antigua instalación.

* Ingrese a su panel de control de cliente Dolicloud de nuevo. Va a encontrar un espacio con sus identificadores de MySql.
Vaya a cualquier equipo en el que tenga instalado MySQL. Ejecute el siguiente comando para realizar copia de seguridad de su base de datos DoliCloud antes de importar los datos antiguos (para restaurarla si algo va mal).
<source lang="bash">
mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql
</source>
con todos los datos yourinstance.with.dolicloud.com ,doliclouduser, dolicloudpassword et doliclouddatabase que son los identificadore MySql que encontró en su panel de control de cliente DoliCloud.

* Ejecute el siguiente comando para reemplazar los datos de su base de DoliCloud con los datos de su base de datos antigua.
<source lang="bash">
mysql -h yourinstance.with.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < micopiaantigua.YYYYMMDD.sql
</source>

= Testear =
Ahora vaya a la página de inicio de sesión de su Dolibarr DoliCloud.

Si su versión antigua de Dolibarr era menor que la versión de DoliCloud, debe tener un mensaje que le pide iniciar el proceso de migración de datos. Basta con elegir la opción recomendada ofrecida por el asistente. Si recibe un mensaje de que el proceso de actualización está "bloqueado" por el archivo '''install.lock''', entre de nuevo con su cliente SFTP y elimine el archivo '''documents/install.lock'''.

Una vez terminada la actualización, o si su versión era la misma que la de DoliCloud, puede conectarse a su Dolibarr usando un usuario existente en su antigua instalación con la misma contraseña. Tenga en cuenta que su contraseña de usuario/administrador que se le proporcionó al generar la instancia DoliCloud ya no existe, ya que fue sustituido en la carga de su antigua base de datos en el paso anterior.

Zh

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="documentation, help, information, development, user, guide, tutorial" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''别笑！用开源的Dolibarr软件系统来管理您的公司真的是轻轻松松，洒洒水啦！不信就往下翻翻看，本WIKI带你如何用Dolibarr管理公司指南入门。'''
</center>

本WIKI指南是献给Dolibarr用户、开发者，翻译人员三类读者的。 ('''users''', '''developers''' 和 '''translators''' 指南文档) 以及 Dolibarr ERP/CRM的种类资源。
可从 Dolibarr 官方网站下载到 (官网： http://www.dolibarr.org).

{{Info}}{{InfoZh}}

= [[File:art.png|link=]] Dolibarr简介 =
* [[What Dolibarr Do|What is Dolibarr ?]] - [[FAQ Who use Dolibarr|Who use Dolibarr ?]]
* [http://www.dolibarr.org/onlinedemo 在线demo演示]
* [http://www.dolibarr.org/downloads/ 下载地址]
* [[Dolibarr Project|Resources and project organization]]
* [[Dolibarr foundation|The Dolibarr foundation]]

= [[File:File_Doc_user.png|link=]] 用户手册 =
* [[User documentation]]
* [[User FAQ]]
* [[Screenshots]]
* [[Dolibarr help and support|Help and support center]] (community forum, commercial support...)
* [[Security informations]]

= [[File:File_Doc_dev.png|link=]] 开发指南 =
* [[Developer documentation]]
* [[Developer FAQ]]
* [[Dolibarr Project|Resources and project organization]]

= [[File:File_Doc_trans.png|link=]] 翻译人员帮助文档 =
* [[Translator documentation]]

= [[File:File_Doc_tester.png|link=]] 测试人员指南 =
* [[Tester documentation]]

Home

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="documentation, help, information, development, user, guide, tutorial" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''Easy to use OpenSource software for business. Be free to manage your small and medium company, freelance or foundation activity'''
</center>

This wiki contains all documentation ('''users''', '''developers''' and '''translators''' documentation) and resources about Dolibarr ERP/CRM.
Downloads are available on the Dolibarr project web portal (go to https://www.dolibarr.org).

{{Info}}{{InfoEn}}

= [[File:art.png|link=]] The project =
* [[What Dolibarr Do|What is Dolibarr ?]] - [[FAQ Who uses Dolibarr|Who uses Dolibarr ?]]
* [https://www.dolibarr.org/onlinedemo Online demo]
* [https://www.dolibarr.org/downloads/ Downloads]
* [[Dolibarr Project|Resources, history and project organization]]
* [[Dolibarr foundation|The Dolibarr foundation]]

= [[File:File_Doc_user.png|link=]] User documentation =
* [[User documentation]]
* [[User FAQ]]
* [[Screenshots]]
* [[Dolibarr help and support|Help and support center]] (community forum, commercial support...)
* [[Security information]]

= [[File:File_Doc_dev.png|link=]] Developer documentation =
* [[Developer documentation]]
* [[Developer FAQ]]
* [[Dolibarr Project|Resources and project organization]]

= [[File:File_Doc_trans.png|link=]] Translators documentation =
* [[Translator documentation]]

= [[File:File_Doc_tester.png|link=]] Testers documentation =
* [[Tester documentation]]
[[Category:Proofreading done]]

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité" />
Ceci est une page de suivi du projet Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), applicable au 1er janvier 2018 en France (sans tolérance en 2019).

= 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 "compatibilité format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], "compatibilité pour télétransmission EDI", voir ) 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, 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 ce point ''' 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'''. 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).
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 à soit 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 texte de loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi, cela aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre suivant "Questions / Réponses" vous offre une vue rapide de la loi 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:

* 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 v7 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v7 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 v7 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v7 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 pass 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.

'''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, ...) rentre 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, 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 republication 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 l'attestation de conformité) ?'''

* 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 v7 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 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 (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 aussi obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir, 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). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Une liste de prestataires possibles, non exhaustive, sera ouverte courant 1er trimestre 2018.
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 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 v7 répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v7, 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 et non chaque module de votre application individuellement. Le logiciel Dolibarr v7 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).
* 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 en cours et à venir dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v7 est prêt et attestable.
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

Hauptseite

2019-07-23T12:26:12Z

TaggerArtistBot: Replacing "<keywords content" tag by new "<seo metak" tag after migrating from MetaKeywordsTag extension to AddHTMLMetaAndTitle extension.

<seo metak="Dokumentation" />
<center>


[[File:Dolibarr logo.png|180px|link=]]

'''Die einfach zu nutzende Open-Source-Software fürs Business.'''<br>
</center>

* Managen Sie kostenlos und einfach Ihr kleines oder mittleres Unternehmen, Ihre Selbstständigkeit oder Ihren Verein.

* Dieses Wiki enthält alle Dokumentationen (für '''Nutzer''', '''Admins''', '''Entwickler''' und '''Übersetzer''') und alle Ressourcen über Dolibarr ERP/CRM.

* Downloads sind verfügbar über das Dolibarr-Webportal (https://www.dolibarr.org oder https://www.dolibarr.de).

{{Info}}{{InfoDe}}

= [[File:art.png|link=]] Das Projekt =
* [[Was_macht_Dolibarr| Was ist / was macht Dolibarr?]]
* [[Wer_nutzt_Dolibarr| Wer nutzt Dolibarr?]]
* [[Versionen| Programmversionen (Releases)]]
* [https://www.dolibarr.org/onlinedemo Online-Demo]
* [http://www.dolibarr.de/download Downloads]
* [[Dolibarr Project| Ressourcen- und Projektorganisation]] (Text: englisch)
* [[Dolibarr_foundation| Dolibarr-Association (gemeinnützig) in Frankreich]] (Text: englisch)
* [http://www.dolibarr.de/dolibarr-verein Dolibarr e.V. in Deutschland] - externer Link

= [[File:File_Doc_user.png|link=]] Benutzerdokumentation =
* [[Benutzerdokumentation | Benutzer-Handbuch]]
* [[Benutzer_FAQ | Benutzer-FAQ]]
* [[Screenshots_(de)|Screenshots]]
* [[Dolibarr_Hilfe_und_Support|Dolibarr Hilfe- und Support-Zentrum]]

= [[File:File_Doc_user.png|link=]] Administration =
* [[Voraussetzungen|Systemvoraussetzungen für Dolibarr]]
* [[Mass_imports|Daten Importe (engl.)]] / [[ExportsEn|Datenexport (engl.)]]
* [[Datensicherung|Datensicherung (Backup)]] / [[Datenrücksicherung|Datenrücksicherung (Restore)]]
* [[Security_informations|Sicherheitsinformationen (Security-Alerts)]]
* [[:Category:Admin]]

= [[File:File_Doc_dev.png|link=]] Entwicklerdokumentation =
* [[Entwickler_Dokumentation|Entwickler-Dokumentation]] (deutsch)
* [[Developer_documentation|Entwicker-Dokumentation]] (englisch)
* [[Developer_FAQ|Entwickler-FAQ]] (englisch)
* [[Dolibarr_Project|Ressourcen- und Projektorganisation]] (englisch)

= [[File:File_Doc_trans.png|link=]] Übersetzerdokumentation =
* [[Translator_documentation|Dokumentation für Übersetzer/Sprachanpassungen]] (englisch)

= [[File:File_Doc_tester.png|link=]] Testerdokumentation =
* [[Tester_documentation|Dokumentation für Tester]] (englisch)