Difference between revisions of "开发文档"

Revision as of 01:15, 13 September 2023

页是与开发者文档相关的文章索引。有关使用者文档，请参阅用户手册

返回
用户手册

返回
首页

组织和开发工具

本章包含在开始任何Dolibarr开发行动之前需要阅读的一般信息。

编码规则和最佳实践

模块清单

特定于Dolibarr标准功能模块的技术文档在每个模块的开发文档页上定义。请选择要访问的页面：

标准模块清单请参阅：List of standard modules
扩展模块清单请参阅：List of complementary modules

为 GUI 开发新的模块/扩展

本章介绍如何开发影响 Dolibarr 用户界面的新模块。可以是屏幕、外观（主题）、代码（CSS样式表）或数据。

脚本开发不在此范围内，将在下一章中进行描述。

要开发自己的Dolibarr扩展模块，请前往教程：模块开发

开发命令行或批处理脚本

本章描述了开发自己的批处理脚本以在Dolibarr中执行任务处理（读、写等）的过程。

对图形用户界面（GUI）进行变更不属于此范围。请参阅上一章。

要开发脚本，如 cron 处理脚本或从其他系统导入数据的脚本，请参阅：脚本开发

Dolibarr的技术组件

文件树

当前版本的文件层次结构请参阅：源代码的 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配置文件中定义。有关更多信息，请参阅配置文件。

功能设置存储在LLX-CONST表中。有关更多信息，请参阅常量页面。

特定于用户的设置存储在LLX-USER-PARAM表中。有关更多信息，请参阅常量页面。

配置参数的存储

Dolibarr设置参数有3个位置。

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

画布

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

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

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

见画布.

触发器

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

见 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:

if (versioncompare(versiondolibarrarray(), array(3,5,0)) > 0)
{
 ...
}

批量导出/导入

与其他应用程序的接口和链接

Interfaces Dolibarr toward foreign systems or toward Dolibarr (Dolibarr Triggers)
Interfaces from foreign systems toward Dolibarr
Web Services

FAQ

All FAQs are available through the FAQ index page FAQ EN

--Roger-QQ12464313 09:00, 19 July 2018 (UTC)

@@ Line 56: / Line 56: @@
 创建新模块时用于添加文件的路径在新模块开发文档中描述（请参阅 [[模块开发]]）。
+===配置文件===
+*/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部件的预先配置文件
 ===设置系统===
@@ Line 65: / Line 72: @@
 特定于用户的设置存储在LLX-USER-PARAM表中。有关更多信息，请参阅常量页面。
-===配置文件===
-*/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个位置。