跳至主要內容

插件系统

大约 2 分钟...

用户可以通过 Waline 提供的 Hook 扩展自定义钩子函数来实现自定义功能。但如果用户之间想要共享自定义的 Hook 方法的话,只能使用复制的方式。为了解决这个问题,Waline 插件系统应运而生。

安装插件

Waline 初始化配置新增了 plugins 属性,支持配置多个插件。

// index.js
const Waline = require('@waline/vercel');
const HelloWorldPlugin = require('@waline-plugins/hello-world');

module.exports = Waline({
  plugins: [HelloWorldPlugin],
});

除了直接安装别人的插件之外,我们也可以在这里配置自己的插件逻辑。

// index.js
const Waline = require('@waline/vercel');
const HelloWorldPlugin = require('@waline-plugins/hello-world');

module.exports = Waline({
  plugins: [
    {
      hooks: {
        async postSave() {
          // do what ever you want after comment saved
        },
      },
      middlewares: [
        async (ctx, next) => {
          await next();
        },
      ],
    },
  ],
});

制作插件

基于 Hook 制作

开发一款插件也非常的简单,基本和之前 Hook 的使用方法一致,只是做了一层封装。

module.exports = {
  hooks: {
    async postSave() {
      // do what ever you want after comment saved
    },
  },
};

需要注意,如果用户安装了多个 Hook 类插件,同一个钩子函数的执行是安装插件加载的先后顺序来执行的。如果前置有钩子方法提前返回的话,就不会执行后续的操作了。

基于中间件制作

如果 Hook 没办法满足你的需求,则可以使用更强大的中间件模式来自定义开发。Waline 最底层是使用了 Node.js 框架 Koaopen in new window,我们将 Koa 的中间件配置整体暴露出来,这样可以满足高级开发者的各种自定义需求。

如果你不清楚 Koa 中间件是什么,可以先搜索了解一下。使用中间件模式制作插件需要注意的是,回调方法一定要写 await next() 的执行,否则不会执行后续操作。

module.exports = {
  middlewares: [
    async (ctx, next) => {
      await next();
    },
  ],
};

当然你完全可以讲 Hook 类插件和中间件类插件逻辑放在一块,这些 Waline 都是支持的。

插件列表

欢迎提交插件~

友情提示:评论区仅作评论展示,如有问题咨询请去 Github Discussion 中提问。
你认为这篇文章怎么样?
  • 0
  • 0
  • 0
  • 0
  • 0
  • 0
评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v3.1.2