跳到主要内容

项目结构

前置条件​

WooCommerce 遵循 WordPress 的代码标准和指南，因此最好熟悉 WordPress 开发 以及 PHP。目前 WooCommerce 需要 PHP 7.4 或更高版本。

了解 WooCommerce 的钩子和过滤器 将允许您在不修改核心文件的情况下添加和更改代码。您可以在 WordPress 插件开发手册 中了解更多关于 WordPress 钩子和过滤器的信息。

推荐阅读​

WooCommerce 扩展是一种特殊的 WordPress 插件。如果您是 WordPress 插件开发的初学者，请阅读 WordPress 插件开发者手册 中的一些文章。

WordPress 环境的结构​

虽然开发环境可能有所不同，但 WordPress 环境的基本文件结构应该保持一致。

在开发 WooCommerce 扩展时，您通常会在本地服务器的 public_html/ 目录中进行大部分工作。

一个 WordPress 安装包含三个目录。wp-admin 和 wp-includes 目录包含核心功能，不应进行修改。第三个目录，wp-content，用于存储自定义配置和用户生成的媒体文件。

花一些时间熟悉 wp-content 目录下的几个关键路径：

  • wp-content/debug.log 是 WordPress 写入重要输出的文件，例如错误和其他消息，这些消息对于调试很有用。
  • wp-content/plugins/ 是服务器上存放 WordPress 插件文件夹的目录。
  • wp-content/themes/ 是服务器上存放 WordPress 主题文件夹的目录。一个主题是一组模板和样式，并且 WordPress 只能有一个活动主题。

最后，在 WordPress 安装的根目录下还有一个可配置的文件，wp-config.php。该文件类似于 .env 文件，用于存储重要的安全凭据和变量，这些变量定义了您的环境配置。

WooCommerce 插件结构​

当向 WordPress 安装添加 WooCommerce 时，您可以选择从 WordPress 仪表盘内部安装插件，或者手动将插件目录上传到 wp-content/plugins 目录。

重要： WooCommerce 仓库是一个单仓库，包含多个插件和包。要从仓库安装 WooCommerce，您不能简单地将整个仓库克隆到 wp-content/plugins 目录。WooCommerce 插件位于单仓库内的 plugins/ 目录中，因此，如果您计划从仓库进行开发，我们建议您将其克隆到本地 WordPress 安装之外，然后使用符号链接将其“放置”在 wp-content/plugins 目录中。

每个插件、包和工具都有自己的 package.json 文件，其中包含项目特定的依赖项和脚本。大多数项目还包含一个 README.md 文件，其中包含任何项目特定的设置说明和文档。

  • Plugins: 我们的仓库包含与 WooCommerce 开发相关的插件和其他辅助工具。
  • Packages: 包目录包含所有提供的 PHP 和 JavaScript，供社区使用。其中一些是内部依赖项，并带有 internal- 前缀。
  • Tools: 我们的仓库中还拥有越来越多的工具。其中许多工具旨在用作单仓库中的实用程序和脚本，但此目录也可能包含外部工具。

如果您想了解更多关于我们单仓库的工作方式，请查看 此指南。

主题和扩展功能​

除非您直接为 WooCommerce 核心代码做出贡献，否则您不会直接编辑 WordPress 或 WooCommerce 文件。所有功能的修改都通过创建自定义扩展或修改您当前主题的 functions.php 文件来完成。

要修改 WooCommerce 商店的 设计，我们建议修改或创建自定义主题。 了解更多关于如何在我们的 主题开发手册 中进行 WooCommerce 主题定制。

要修改 WooCommerce 商店的 功能，您有多种 选项。 首先，您可以使用 Woo Marketplace 查找合适的、现成的扩展程序，以满足您的需求。 对于简单的自定义，您可以了解更多关于轻松添加 代码片段 到您的商店的方法。 对于更高级的 开发 需求，我们建议构建自定义扩展程序（即，一个 WordPress 插件）。