WP编辑器添加快捷键,一键调用简码

接触过一段时间WordPress后,你会发现它有一个非常实用的功能,那就是可以自由扩展。你可以根据自己的需求添加插件并可自定义标签的短代码(WordPress Shortcode)。短代码也就是简码,通俗来说它指的是一些使用[ ]包含的短代码,WordPress会识别这些短代码并根据短代码的定义输出为特定的内容。通常使用WordPress编辑器编辑一篇文章时,为了构建一个美观的页面需要借助这些短代码,短的容易记忆稍长的就需要我们去查找准确再去使用,非常耗时,这是一点。另外一点是调用短代码需要频繁切换输入法,很容易打乱创作文章的思路。综合以上原因,就有了今天这篇文章,添加wordpress快捷键,在WordPress编辑器的文本(HTML)模式下创建简码快捷键,如下图的效果,调用简码只需轻轻一点,即可完成需要的特定功能。

一、快捷键代码的标准用法介绍

在上图可以看出添加wordpress添加快捷键就是在wordpress编辑器界面中添加快捷键按钮,完成以上需求的前提是我们要知道它需要使用哪个API接口或是代码,通过查阅wordpress官方文档资料可以找到关于添加快捷键功能的标准代码为:

Quicktags API: QTags.addButton(id,display,arg1,arg2,access_key,title,priority,instance); 

下面详细介绍快捷键代码的具体参数与使用方法:
Quicktags API:代码名,在具体使用时不需要写,在此处只是写出来让你知道是调用的那个API,此函数允许您在WordPress编辑器的文本(HTML)模式下包括其他按钮。

“id” (必要参数) 为该按钮定义一个ID,可任意定义(字符串)。

“display” (必要参数)为该按钮显示的内容,即该快捷键在wordpress编辑界面显示的内容,可随意输入。

“arg1” (必要参数)为短代码码的具体代码内容,开始标记。
“arg2” (可选参数)为段代码的结束标记,如不需要关闭标签,则留空。
注意:arg1和arg2分别对应开始标签和闭合标签。即假设你的需要把和标签加入在线编辑器,那么对应arg1参数,而需要闭合标签则对应arg2参数。当你首次点击该按钮时就会在编辑器出现,而第二次点击则出现另一种。如果需加入的仅是一段代码,则只需输入arg1即可,arg2必须留空。

“access_key”(可选参数)按钮的快捷访问键,可随便写,也可不写。

“title” (可选参数)指HTML title属性,即对快捷按钮的注释,当你把鼠标移动到按钮上是显示的一段提示文本。

“priority”(可选参数)一个数字,表示按钮在工具栏中的期望位置。1-9 为第一行,11-19 为第二行,21-29为第三行,依此类推(int类型)。

“instance” (可选参数) 把快捷按钮限制在某特定实例,如果未定义,则添加到所有实例。(此项不懂也没有关系可不用设置。)

二、举例介绍使用

这里我以WP-player(一个在文章中插入音乐播放器的插件)为例介绍,安装好插件后,如果想在文章中插入,需要插入简码  [playe r autoplay=“0" random="1"] ,其中短代码中 autoplay 表示是否自动播放;参数"0"表示否;"1"表示是;短代码中 random 表示是否随机播放;参数"0"表示否;"1"表示是;

1.  接下来在文章中主题的funtions.php文件中加入如下代码(可直接复制将其中参数替换成你需要的功能):

function appthemes_add_quicktags() {
?>
	<script type="text/javascript">
		QTags.addButton( 'WP-Player',  'Player简码',' [play er autoplay="0" randplay="1"]','[play er autoplay="1" randplay="0"] ','access_key="h"','title="WP-Player简码"',);
	</script>
<?php
}
add_action('admin_print_footer_scripts', 'appthemes_add_quicktags' );

2. 效果图

是不是方便了许多,赶紧行动起来吧,只需一键即可调用简码,轻松提高工作效率,妈妈再也不用担心我熬夜码字了。

参考wopress官方文档:https://codex.wordpress.org/Quicktags_API

本文由 梦栖小驿 作者:掌柜 发表,其版权均为 梦栖小驿 所有,文章内容系作者个人观点,不代表 梦栖小驿 对观点赞同或支持。如需转载,请注明文章来源。
124

发表回复