biigle/module

BIIGLE模块的模板。

v1.3.0 2023-05-02 13:36 UTC

This package is auto-updated.

Last update: 2024-08-30 10:56:37 UTC


README

Test status

这是一个可用于开发新BIIGLE模块的模板。

如何开发BIIGLE模块

BIIGLE手册包含一些教程,可以帮助你开始BIIGLE模块开发。此存储库实现了前三个教程中涵盖的代码。

如何使用此模板

首先,基于此模板 创建一个新的存储库。然后,将此模块的名称从 biigle/module 更改为你想要使用的任何名称。名称需要在以下位置进行更新

  1. QuotesController.php
  2. index.blade.php#L13
  3. index.blade.php#L16
  4. ModuleServiceProvider.php#L21
  5. ModuleServiceProvider.php#L30
  6. ModuleServiceProvider.php#L43
  7. composer.json#L2
  8. test.yml#L15

接下来,更新所有PHP类(Biigle\Modules\Module)的命名空间,并用你的模块名称替换 Module。同时,在 webpack.mix.js#L23 中也进行此操作。还要更新此README以适应你的新模块。你应该删除前两个小节,并更新安装说明。现在你可以安装此模块并开始开发。

除了教程中的代码之外,此存储库还包含了教程的配置,用于Laravel Mix作为构建系统。要安装构建系统,运行,然后运行 npm install。现在你可以使用以下命令

  • npm run dev:一次性构建和发布资源。
  • npm run prod:一次性构建、压缩并发布资源。在提交新代码之前,始终执行此操作。
  • npm run watch:每当资源文件更改时,持续构建和发布资源。
  • npm run lint:运行静态分析以检查错误。

安装

注意,你必须将 biigle/module 替换为你的模块/存储库的实际名称。

  1. 运行 composer require biigle/module这要求你的模块在 Packagist 上发布。如果你不想发布你的包,请参阅有关替代选项的更多信息。
  2. Biigle\Modules\Module\ModuleServiceProvider::class 添加到 config/app.php 中的 providers 数组。将类命名空间中的 Module 替换为你的模块名称。
  3. 运行 php artisan vendor:publish --tag=public 以刷新模块的公共资源。每次更新此模块时都要这样做。

开发

查看核心存储库的 开发指南 以开始开发设置。

想要开发新模块?前往 biigle/module 模板存储库。

贡献和错误报告

欢迎为BIIGLE做出贡献。查看贡献指南 以开始。