该文档已经迁移，请参考最新文档

【Halo博客】友链自助提交插件

写在前面

因为感觉平时和别的博客交换友链的操作太过麻烦了，当有人申请交换友链时，还需要自己到后台手动添加，麻烦麻烦实在是麻烦，所以开发了这个友链自助提交插件。

功能

TODO

• 支持访客自助提交修改友链
• 友链自助提交框多样式模板
• 暂时与ToolBench不兼容

演示

教程

（一）、插件设置

安装插件之后需要我们配置如下几项：

设置友链提交页面：我们需要挂载提交框的页面，新建一个页面，起一个别名即可（注意：使用links或者已被其他插件渲染过的无效，如friends），在页面设置中找到友链自助提交页面选择是，如图：

提交成功后跳转页面：当访客提交友链成功后跳转的页面，一般是我们的友链页面
本站域名：填写我们自己博客的域名即可，无需http(s): //
友链分组：默认提交的友链分组，查看如何获取

（二）、获取友链分组名

前往友链管理，点击对应的友链分组，这时地址栏的url中group参数值就是分组名，即：link-group-UtwqW

（三）、友链提交记录审核

当不满足自动审核要求的申请记录会在这里，需要我们手动审核或者是删除；
开启自动审核的规则：

• 开启自动审核，开启友链校验：只有访客提交时填写了友链页面，并且对方友链页面已经存在了本站的友链时，才会自动审核通过并展示，否则不通过
• 开启自动审核，关闭友链校验：访客提交友链就会自动审核通过并展示

（四）、邮件通知

使用邮件通知必须先配置博客的通知设置，然后到插件中打开邮件通知，设置通知邮箱
目前通知类型有三种：

1. 提交通知：通知管理员有新的友链提交成功
2. 审核通知：通知管理员有新的待审核友链提交
3. 审核通过通知：通知访客友链申请已审核通过

（五）、自定义挂载位置

注意：使用自定义位置时，需要在插件设置中，挂载位置选择自定义位置

（五）、自定义元数据

在这里可以配置个性化的友链元数据，由于一些主题设置了友链的元数据，插件也可以兼容其个性化配置，这里建议先了解主题的元数据配置

（六）、自定义样式

如果有开发能力的伙伴，觉得默认的提交框太7+1了，可以自己魔改样式，需要注意的是，使用自定义样式会覆盖掉默认的样式，如果你只想在默认样式的基础上微调，你可以先把默认样式代码写上，然后再添加自己的个性化样式代码
默认样式代码如下：

.linksSubmit-div {
    width: 100%;
    margin: 0 auto;
    display: flex;
    justify-content: center;
}

.linksSubmit-form {
    background-color: var(--theme);;
    padding: 20px;
    border-radius: 8px;
    box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
    max-width: 680px; /* 设置最大宽度 */
    width: 100%;
}

.linksSubmit-form label {
    display: block;
    margin-bottom: 8px;
    font-weight: bold;
    position: relative;
    color: var(--routine);
}

.linksSubmit-form label .error-message {
    color: red;
    font-size: 12px;
    margin-top: 4px;
    position: absolute;
    top: 100%;
    left: 0;
}

.linksSubmit-form label>span.required {
    color: red;
    margin-left: 4px;
}

.linksSubmit-form label>span.tip {
    color: #f59406;
    font-size: 12px;
    margin-left: 4px;
}

.linksSubmit-form input,textarea {
    width: 100%;
    padding: 8px;
    margin-bottom: 16px;
    box-sizing: border-box;
    border: 1px solid #ccc;
    border-radius: 4px;
}

.linksSubmit-form button {
    background-color: #4caf50;
    color: #fff;
    padding: 10px 15px;
    border: none;
    border-radius: 4px;
    cursor: pointer;
    font-size: 16px;
    display: block;
    margin: 0 auto;
}

.linksSubmit-form button:hover {
    background-color: #45a049;
}

（七）、定时清理友链功能

定时清理的方式有两种：
①删除：直接删除友链数据
②移动：把友链转移至其他分组
定时表达式配置，请参考文档：Cron 表达式

插件下载

最新地址

插件交流

或者扫一扫下方二维码

常见问题

1. 友链分组为什么不显示？

友链分组只在插件启用时进行首次渲染，如果新建友链分组，需要先禁用然后在启用，刷新页面即可。

2.插件无法正常启动？不显示授权页面？提示错误Cannot invoke "java.net.URL.getAuthority" because "externalUrIRaw" is null？

请检查是否正确配置外部访问地址，详情请参考：官方文档