siel/acumulus

Siel Acumulus Web API库,适用于所有网店插件

8.3.0 2024-09-26 12:51 UTC

README

@作者: Buro RaDer
@版权: SIEL BV
@许可: GPLv3
@支持: Webkoppelingen - Acumulus 论坛
@源代码: Acumulus 网络服务 API 客户端库

简介

这个Acumulus网络服务API库是为了简化与Acumulus网络服务通信的客户端代码的开发而编写的。因此,它特别针对荷兰的公众。

目前由HikaShop、Magento、PrestaShop、OpenCart、VirtueMart和WooCommerce网店软件的扩展使用,但构建起来也易于与其他网店/CMS软件系统一起使用。

给扩展/插件/模块审查员的注意

这是一个跨网店/CMS库,因此无法遵守特定网店或CMS包经常冲突的编码标准和指南。我们在此请求您的理解。

这个库使用

  • PSR-12编码标准。
  • Phpdoc来完全记录代码的每一部分。
  • 需要时,使用自己的PSR-4自动加载器来规避许多网店/CMS系统仍然存在于PSR4自动加载时代之前的事实,这意味着如果已经存在自动加载器,那么它通常不会与PSR4标准一起工作。
  • 自己的翻译系统来呈现这个库的英文和荷兰文版本。
  • 自己的表单渲染器/构建器。

这个库可能以以下方式偏离特定的编码标准

  • 类放在遵循PSR4结构的命名空间中,因此可能需要注册自己的自动加载器函数,而不是使用网店/CMS特定的一个。
  • 类常量使用StudlyCaps。
  • 类属性使用camelCase。
  • 表单定义放在库中,并在库中渲染/构建,但也遵循特定于网店/CMS包的表单指南。
  • 使用自带的翻译系统进行翻译,只支持荷兰语和英语。由于在线SIEL Acumulus服务仅针对在荷兰运营的小型企业,这并不被视为限制因素。

许可

这个库根据GNU GPLv3开源许可授权。英文和唯一官方文本可在以下网址找到: https://gnu.ac.cn/licenses/gpl.html。非约束性荷兰语版本可在以下网址找到: http://bartbeuving.files.wordpress.com/2008/07/gpl-v3-nl-101.pdf。这两个文本也作为本库的一部分提供。

开发

这个库仍在开发中,将

  • 必要时适应税收规则的变化。
  • 必要时适应与更多网店包一起工作。
  • 扩展新功能。
  • 尽可能有用地进一步抽象。

在进行此操作时,向后兼容性是一个考虑因素,但并非必须。因为网络商店插件与这个库一起交付,所以这对用户来说没有问题。然而,在上述库之上开发自己软件的开发人员应仔细检查新版本是否向后不兼容。