Typecho Plus (v0.6.2) 教程
这篇文章最后修改于 2023-12-25 日,距今已有 337 天,请注意甄别内容是否已经过时!
正式版 v0.6.2 已经发布
如果您启用此插件,那么后台的 Markdown 解释器便会由 Typecho Plus 接管,并且会变更部分文章结构!
比如 Typecho 的文章内都是以
若因此造成部分插件、以及您主题风格的失效,还请适当修改主题与插件中的CSS风格!
比如 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请反馈(但不一定修 )
Typecho 1.2 https://github.com/typecho/typecho
WAMP + PHP 7.2
Linux + Apache + PHP 7.2 + FPM
Chrome 76
未在 1.2.1 实测,如有BUG请反馈(但不一定修 )
如果您最近访问过本站,请使用
有任何的BUG反馈请附带您的主机系统、PHP版本、Typecho版本、是否安装过其他插件等信息!
Shift+F5
\ Ctrl+F5
刷新本页面,防止浏览器缓存阻碍页面更新!有任何的BUG反馈请附带您的主机系统、PHP版本、Typecho版本、是否安装过其他插件等信息!
系统增强
一些有用或没用的系统增强功能。因为本插件大量应用了自定义字段功能,Typecho默认会将无用字段也存储进数据库中。
如果你不想每次更新文章时都加入这些无用字段的话,请参考下面这篇文章!
https://blog.clso.fun/posts/103.html
如果你不想每次更新文章时都加入这些无用字段的话,请参考下面这篇文章!
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.css
和 tpluscustom.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语法增强
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。
博主,我问一下,点进文章后收缩框点不开,需要再刷新一次才可以,这怎么解决呢
应该是JS加载的位置不对,可能是JS脚本被过早加载,没能触发对后面内容的处理。
请修改模板内JS的位置,尽量将脚本加载位置放到最后面,或者给JS标签添加延迟加载的属性。
好的,谢谢博主!
感谢博主,此乃神器,typecho也能写出五彩斑斓,功能丰富的华丽页面了!原版的Markdown还是太素了!
已知BUG 权限浏览在MIP模式下毫无作用,一览无余
请提供更多信息,是否启用了第三方的模板或者插件所实现的MIP功能。
可能你安装的插件或者模板,并非通过Typecho默认的接口对内容进行了操作,才会避开了typecho hook的触发。
如需兼容,可以参考 typecho plus 内的 content 函数,到相关的模板或插件中对内容进行过滤和修改。
使用login功能文章502
感谢博主,此乃神器,typecho也能写出五彩斑斓,功能丰富的华丽页面了!原版的Markdown还是太素了!