这篇文章最后修改于 2023-12-25 日,距今已有 214 天,请注意甄别内容是否已经过时!

目录 - Table of Contents

正式版 v0.6.2 已经发布
如果您启用此插件,那么后台的 Markdown 解释器便会由 Typecho Plus 接管,并且会变更部分文章结构!
比如 Typecho 的文章内都是以</p><p>来对超过两行以上的文章内容进行分行,而我将其替换成了<br /><br />来兼容 Typecho-Plus 的UBB代码块。

若因此造成部分插件、以及您主题风格的失效,还请适当修改主题与插件中的CSS风格!


测试与开发环境
Typecho 1.2 https://github.com/typecho/typecho
WAMP + PHP 7.2
Linux + Apache + PHP 7.2 + FPM
Chrome 76

未在 1.2.1 实测,如有BUG请反馈(但不一定修

如果您最近访问过本站,请使用 Shift+F5 \ Ctrl+F5 刷新本页面,防止浏览器缓存阻碍页面更新!
有任何的BUG反馈请附带您的主机系统、PHP版本、Typecho版本、是否安装过其他插件等信息!

系统增强

一些有用或没用的系统增强功能。

因为本插件大量应用了自定义字段功能,Typecho默认会将无用字段也存储进数据库中。
如果你不想每次更新文章时都加入这些无用字段的话,请参考下面这篇文章!
https://blog.clso.fun/posts/103.html

用户浏览权限

在发布与编辑文章时,编辑器下方有一个文章类型的自定义字段,您可以通过填入数字来决定这篇文章的浏览权限,其中:
1 = 不在首页显示此文章
2 = 仅限登录会员浏览
4 = 在索引页(如首页、分类、标签、搜索等页面)向游客隐藏该文章,但游客可以通过链接访问
某些碎片文章,你可能不想让它出现在首页、或者只想给特定的人浏览,就可以利用到这个功能了。
其中隐藏文章的功能与Typecho默认的隐藏功能不同,只要用户已经登录、就可以在索引页中看到此文章,而非像Typecho一样对注册用户也隐藏。

你甚至可以结合数字来组合功能:
比如3代表不显示在首页、且仅限会员浏览;
6代表不显示在索引页、且游客即便知道地址,也必须要登录后才能浏览!

自定义文章摘要

厌烦了用 <!--more--> 来分割摘要?或者想要换一个更贴合文章内容的介绍?
你只需将自定义的摘要内容,输入到自定义字段的文章摘要中即可,此字段支持Markdown、HTML和UBB代码!
如果摘要为空,则索引页会使用模板的默认摘要功能。

去索引页查看自定义摘要效果

文章过时提醒

在自定义字段的 过时提醒 中设置一个数字,即可在文章的开头或是结尾添加一个文章过期、过时的提醒内容。
填入的数字为正数,则按照文章修改日期进行提醒,填入的数字为负数,则按照文章的创建日期进行提醒。

v0.6.0 添加了全局过期提醒设置,用法与自定义字段一样。
当文章设置过自定义字段后,优先以文章内的设置为准。也可以将自定义字段设置为no,表示本文不启用过期提醒。

禁止搜索引擎索引页面

在自定义字段的 禁止搜索引擎索引 中设置一个数值,即可禁止搜索引擎索引当前的页面。

自定义CSS与JS

v0.6.1 新添加的功能,当开启后,Typecho-Plus 就会自动加载插件目录下的 tpluscustom.csstpluscustom.js 文件,你可以将自定义的CSS风格、JS脚本写入到这两个文件当中。
今后插件在更新时,就不会再覆盖掉你的自定义内容了!

自定义UBB new

v0.6.2 新添加的功能,当开启后,Typecho-Plus 就会自动加载插件目录下的 tpluscustom.php 文件,你可以将自定义的UBB解析方法写入到这个文件当中。
/** 请在此写入您的PHP扩展,格式为:
 * tagParser($utag, $pars, $content, $matches) {return "html";}
 * $utag = TAG名,$pars = 参数集合,$content = 内容,$matches = 原始的正则匹配集合
 */
function testParser($utag, $pars, $content){
    $size = sizeof($pars);
    return "<span class=\"tplus-test\">TAG $utag, 内容 $content, 拥有 $size 个参数</span>";
}
[test=参数1,参数2,参数3]默认的测试方法[/test]
TAG test, 内容 默认的测试方法, 拥有 3 个参数

URL域名检测

可以在设置中输入您网站的主域名,所有使用Markdown解析出来的URL都会进行域名检测。
凡是第三方域名都会被设置为新标签打开、添加禁止追踪等安全属性描述。
若是您不需要该功能,请留空该选项!

图片加载错误处理

在后台设置中可设定当图片加载错误后,自动加载的替换图片。
若该字段为空,则不会对图片进行错误处理。


v0.5.1 现在原始图片路径被保存在 data-src 属性中
v0.5.3 现在支持点击重载图片

安全地址检查

使用 [safe]url[/safe] 标签将生成一个指向安全检查的跳转地址。
若您没有这个需求,请留空该字段!

给链接添加一个URL检测,服务器端的页面你需要自己写,格式为 你的服务器检测地址 + urlencode(目标URL)
比如你的网站用于检测URL安全的页面是 check.php,就可以传递这样的参数进去 https://clso.fun/check.php?url=[safe]url[/safe] 会解析为 https://clso.fun/check.php?url=经过URL编码的url

后台优化

因为 Typecho 的后台Hook接口实在太少,优化功能只能插入在 footer-end 这个事件中,所以JS的代码是在HTML标签之后的……所幸Chrome与IE都能认得HTML标签外的JS代码,功能并未受到影响。
若是此功能影响到了您后台的布局与功能,请关闭此选项!

建议您修改一下 /admin/footer.php,将代码替换为:
<?php
if(!defined('__TYPECHO_ADMIN__')) exit;
/** 注册一个结束插件 */
Typecho_Plugin::factory('admin/footer.php')->end();
?>
</body>
</html>
目前 Typecho-Plus 所提供的后台优化有:
  • 优化后台textarea控件,让模板设置、文章自定义字段中的textarea控件可以随着输入而自动调整大小
  • 将『发布文章』的按钮移动到了编辑器的上方
  • 当编辑器或其他文本控件拥有焦点时,按下 Ctrl+Enter 便可以快速发布文章,并且会在后台异步发送数据

UBB块级代码禁用

现在您可以自己选择是否启用Typecho-Plus的布局以及UBB块级代码。
若是您不需要块级代码的功能,又或者块级代码与您的主题风格有冲突,建议同时关闭这两个选项,即可启用默认的Typecho Markdown布局!

文章内UBB代码禁用

现在您可以选择是否禁用文章内的UBB代码。
不过一般不建议您这么做,除非您的UBB与Markdown解释器有所冲突,或者您干脆就不喜欢UBB代码。

是否允许解析多行 BR

Typecho默认将超过2行以上的换行全部换成两行,而当您启用这个选项后,Typecho-Plus会原本还原您文章内的换行符数量。



我是间隔超过三行的文本哦!
需要注意的是:此功能只有在开启Typecho-Plus 布局之后才会有效!

版权声明

Typecho-Plus 会利用JQ在您的页面 footer 插入一行版权声明,此声明是动态插入的,并不会影响您网站的SEO效果。
若是该声明影响了您网站的布局,可以在源码中注释掉这行代码:
$('footer, #footer, .footer').first().append('<div>本站<del>自嚎</del>、自豪地采用<a href="https://blog.clso.fun/posts/2019-04-27/typecho-plus.html" target="_blank"> Typecho-Plus </a>插件</div>');
当然,若是您能为本站加一个友链或者推荐,那是再好不过了~


下一页是Markdown语法增强
下一页是Markdown语法增强