Lopwon Links 使用文档

版本型号：Lopwon Links
适用程序：Typecho
皮肤类型：插件
插件作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/lopwon-links.html
许可方式：MIT
官方演示：Lopwon Links

插件说明

插件 Lopwon Links 的作用是：在页面指定位置，开启申请友链提交功能，以卡片形式展示友情链接，可以多页面同时使用，互不影响，简单改造还能作为评论置顶使用。流程挺简单：访客留言提交友链申请》博主标记并过审该申请》访客友链信息自动展示。

制作由来。之前，已经做有友链功能的模板 Lopwon Link 和 Lopwon Link Pro 但由于是独立页模板，在与用户的主题外观相融合方面不是太理想，毕竟大家的主题样式五花八门。于是制作了 Lopwon Guys 插件，虽然可以适配大部分主题，但是更适用于展示老友，对于只想互换友链的新友，还是不太实用，于是乎，插件 Lopwon Links 诞生。

应用场景：

1. 博主想在博客原有的留言页面中使用申请友链提交功能，并展示友情链接。

2. 在互换友链后，对于链接失效但仍需展示的友链信息，可设置为失效状态。

3. 在互换友链后，对方撤下了博主的链接，博主也可以将其设置为撤下状态。

操作步骤：

1.（访客）平时正常在页面留言，当访客想互换友链时，只需要按友链申请格式（申请友链|这里是博客简介|这里是留言备注）留言即可，其他信息（昵称、链接、头像）直接取自评论表单，不用在留言中重复出现，其中，友链申请格式由竖线 | 隔开，前四个字（申请友链）是必须的：

    固定格式为：申请友链|这里是博客简介

    拓展格式为：申请友链|这里是博客简介|这里是留言备注

留言内容示例：

    申请友链|立云图志，周遭故事

    或者

    申请友链|立云图志，周遭故事|这里是留言备注，友链信息不输出留言备注

2.（博主）当博主看到访客申请友链的留言时，只需要回复该访客的留言，并带上（友链已添加）的关键词即可，该访客的链接信息会自动展示，回复内容示例：

    我回访了你的博客，好多好看的照片呀，友链已添加。

    或者

    友链已添加。

个别情况：

1.（访客）已经成功互换友链，但友链信息需要变更时，访客只需要按以上提到的友链申请格式重新留言即可。

2.（博主）当博主看到访客重新申请友链的留言时，只需要回复该访客的留言，并带上（友链已添加）的关键词即可，该访客的链接信息会自动更新为最新的一条。

假设情况：

1.（博主）如果访客按友链申请格式留言，但是，博主不想和这位访客互换友链，或者说访客的博客内容没有达到博主的预期，那么，博主可以诚恳的回复访客，只要回复的内容中没有包含（友链已添加）的关键词，该访客提交的友链申请就不会过审，也不会展示在友链卡片的列表中。

插件更新

2023年08月18日 发布 Lopwon Links v1.2 修正已知问题。

2023年05月22日 发布 Lopwon Links v1.1 修正已知问题。

2023年05月15日 发布 Lopwon Links

使用方法

A 部署插件

1. 将压缩包里的文件夹 LopwonLinks 及其内部的所有文件，上传至目录 usr/plugins 中。

2. 后台》控制台》插件，找到 Lopwon Links 并启用。

B 调用插件

示例一：在文章页 post.php 的（全局）调用，即所有文章页都会显示。

1. 打开主题文章文件 post.php 在合适位置（如：文末）添加以下代码：

    <?php Typecho_Plugin::factory('Lopwon_Links')->Lopwon(); ?>

示例二：在文章页 post.php 的指定（单篇）文章调用，即只有指定的一篇文章显示。

1. 打开主题文章文件 post.php 在合适位置（如：文末）添加以下代码：

    <?php if ($this->cid == '文章cid编码') { Typecho_Plugin::factory('Lopwon_Links')->Lopwon(); } ?>

2. 请把以上代码中（文章cid编码）替换为你要调用插件的页面 cid

示例三：在文章页 post.php 的指定（多篇）文章调用，即限定哪些文章显示。

1. 打开主题文章文件 post.php 在合适位置（如：文末）添加以下代码：

    <?php if (in_array($this->cid, array('文章cid编码一', '文章cid编码二', '以此类推'))) { Typecho_Plugin::factory('Lopwon_Links')->Lopwon(); } ?>

2. 请把以上代码中（文章cid编码*）替换为你要调用插件的页面 cid 

C 配置插件

后台》控制台》插件，找到 Lopwon Links 并设置，依喜好设置即可。其中，后台》设置》评论，在（评论提交）中，必须勾选「必须填写邮箱」

注意：头像获取自 Gravatar，请确保该服务访问顺畅。

D 使用技巧

1. 插件样式少部分沿用自你的主题样式（如：字体字号等），如有显示异常，请自行调整文件 lopwon.links.css 进行适配。