README

使用vAF Wordpress框架开发Wordpress插件的骨架

创建新的插件

要创建一个新的插件，只需运行 composer create-project vonaffenfels/wp-plugin-skeleton <new-plugin-slug>。

Composer将为您安装所有必需的依赖项，询问您一些关于新插件的问题，并将修改/创建所有必要的文件。

为了解决使用具有Composer依赖项的Wordpress插件时的依赖项冲突问题，我们决定使用名为“供应商前缀”的技术。

在这里，我们创建了一个新的命名空间，所有依赖项都可以在其中生存。

查看文件 src/Plugin.php 以了解其工作原理。

在开发过程中，您绝对不能在 vendor 目录中使用依赖项，而应使用 vendor_prefixed 目录中的依赖项。IDE通常会显示所需类所在的命名空间。请确保它带有创建新插件时选择的命名空间前缀。

确保您只使用 vendor_prefixed 目录中的依赖项的最佳方法是，在每次安装后运行命令 composer install --no-dev。这样，所有包都将被删除，并且不会被任何IDE找到。

当您安装新的包时，您必须通过运行 composer require --dev <package> 将其作为开发依赖项要求。

如果您需要一个不应包含在最终插件包中的开发依赖项，只需向文件 scoper.inc.php 中添加一行，其中标记这些包为忽略。然后它将不会进行前缀。

您必须始终提交缓存的依赖注入容器（可在目录 container 中找到）。

要在提交/打包前构建容器，只需运行 composer build-container。然后容器将更新到当前状态。

如果您想使用 composer 部署您的插件（如Bedrock Wordpress环境），则无需做任何特殊操作。

如果您想将插件作为ZIP文件部署到标准Wordpress安装中，请运行命令 composer install --no-dev 以从 vendor 目录中删除所有包。然后您可以压缩完整的插件。别忘了包括 vendor 目录。它包含必要的自动加载文件。

要重建依赖注入容器，只需运行 composer build-container。