
WordPress短代码是一项强大的功能,可以轻松完成很酷的事情。你几乎可以用它们做任何事情。使用短代码,嵌入交互式元素或创建复杂的页面布局就像插入一行代码一样简单。
如果要添加图库,只需输入以下代码:
【gallery ids="47 ,86, 92, 64, 48, 75, 89, 80" columns="4" size="medium"】
####【】替换为[]
这将输出一个带有提到的图像ID的画廊。它将有4列,它们的最大大小将是“medium”(由WordPress定义)。
不需要任何丑陋的HTML代码。

画廊简码示例
短代码消除了对复杂脚本的需要。即使您几乎没有编程技能,也可以在他们的帮助下轻松添加动态内容。
它们在WordPress开发人员中非常受欢迎,因为它们极大地帮助了自动化内容和设计创建。简码之于WordPress开发人员,就像宏之于数据分析师,或键盘快捷键之于专业图形设计师。
在本指南中,您将了解有关短代码的所有知识。您将通过创建自己的短代码了解如何使用Shortcode API。最后,我们将讨论短代码的未来以及它们在WordPress的新区块编辑器中的适用位置。
- 什么是短代码?
- 默认的WordPress简码
- 如何在WordPress中创建自定义短代码(初学者级别)
- WordPress简码:优点与缺点
- 简码和古腾堡区块
什么是短代码?
简而言之,Shortcode = Shortcut + Code。
通常,短代码使用方括号标签 [] 来定义它们的使用方式。每个短代码在站点中执行特定功能。它可以像格式化内容一样简单,也可以像定义整个网站的结构一样复杂。
例如,您可以使用简码嵌入滑块、表格或定价表。您甚至可以使用它们来创建可重复使用的页面设计模板。
简码简史
简码最初是由名为Ultimate Bulletin Board (UBB) 的在线论坛软件流行起来的。1998年,他们推出了BBCode(公告牌代码),这是一组易于使用的标签,供用户轻松设置帖子的格式。

使用简单的BBCode轻松格式化
作为一种轻量级标记语言,BBCode的工作原理与HTML相同,但它更简单。
使用预定义标签也更安全,因为用户无法插入HTML代码并引入安全漏洞。例如,怀有恶意的用户可以使用<script>标签来执行JavaScript代码并破坏网站的功能。
不久之后,其他在线论坛软件,如phpBB、XMB Forum和vBulletin,在他们的留言板中添加了BBCode功能。
短代码使管理员能够更好地控制用户可以做什么和不能做什么。此外,它们允许用户通过简单的标签来格式化他们的内容。
由于相同的安全原因,WordPress会阻止PHP代码在站点内容中运行。为了克服这个限制,WordPress 2.5在2008年随着Shortcode API的发布引入了短代码功能。事实证明,它是许多WordPress插件和主题开发人员最常用的功能之一。
什么是WordPress简码?
WordPress短代码是方括号字符串 ( [ ] ),它神奇地转变为前端迷人的东西。它们为用户提供了一种创建和更改复杂内容的简便方法,而无需担心复杂的HTML或嵌入代码。

WordPress简码简单易用
两种类型的短代码
WordPress中主要有两种类型的短代码。

自闭合和封闭短代码可以在有或没有属性的情况下有效
自闭合短代码:这些不需要结束标记。
示例:图库简码不需要结束标记。我们用不同的属性添加它需要的一切。
封闭短代码:这些需要一个结束标签。封闭短代码通常操纵开始和结束标记之间的内容。
例如:标题短码被用于环绕任何内容的标题。它主要用于为图像添加标题,但它适用于任何HTML元素。
一些短代码可以使用或不使用属性。这取决于它们是如何定义的。
默认的WordPress简码
WordPress带有6个默认短代码:
- audio:在您的网站上嵌入音频文件。它包括简单的播放控件,如播放和暂停。
- caption:用它在你的内容周围加上标题。它主要用于添加图像标题,但您可以将其用于任何HTML元素。
- embed:扩展默认的oEmbed功能。此简码可让您为嵌入设置不同的属性,例如设置它们的最大尺寸。
- gallery:在您的网站上插入一个简单的图片库。您可以使用属性来定义使用哪些图像并自定义图库的外观。
- playlist:显示带有此自封闭短代码的音频或视频文件的集合。你可以用它的style属性给它一个很酷的“黑暗”模式。
- video : 嵌入视频文件并使用简单的视频播放器播放。此短代码支持嵌入以下格式的视频:mp4、webm、m4v、webm、ogv、wmv、flv。
有关如何使用默认短代码以及它们支持哪些属性的更多详细信息,您可以参考链接的Codex文档。
如何使用WordPress简码
在WordPress中使用短代码是一个简单的过程。但这取决于您要将它们添加到站点的哪个位置。请务必阅读短代码文档以了解其工作原理。了解它支持的属性,这样您就可以准确地获得您想要的东西。
在页面和文章中使用WordPress简码
首先,转到要插入短代码的页面/文章编辑器。
如果您使用的是Gutenberg编辑器,则可以在独立的Shortcodes块中添加shortcode标签。我们可以在小工具部分找到它。

在古腾堡中添加短代码区块

古腾堡的专用短代码区块
还在使用经典编辑器(或插件)?您可以以经典方式输入短代码标签。一些短代码甚至可能在编辑器屏幕中有一个按钮可以轻松插入它们。

在经典编辑器中添加短代码
也可以在侧边栏小部件中插入简码。要添加它们,请转到外观»小工具并将文本小工具添加到要添加快捷方式的部分。

使用文本小工具在侧边栏中添加短代码
将短代码粘贴到文本小工具中并保存。您可以访问您网站的前端并在侧边栏中查看短代码的输出。

可以在侧边栏中看到简码输出(图库)
注意: WordPress 4.8及以下版本不支持侧边栏小工具中的短代码。阅读WordPress 4.9更新中的小工具改进以了解更多信息。
WordPress短代码通常用于页面、文章和小工具。但是您有一种简单的方法可以在站点的任何位置插入短代码。
假设您想在页脚或评论部分之前的所有帖子中添加号召性用语按钮。该do_shortcode()回调函数就派上用场了这里。
您需要将以下代码添加到主题的header.php、footer.php或其任何模板文件中:
<?php echo do_shortcode("[name_of_your_shortcode]"); ?>
这将在您插入代码的位置输出短代码。
您需要在引号之间包含方括号以回应短代码。仅仅包括它的名字是行不通的。
同样,您可以使用do_shortcode()回调函数在WordPress中的任何位置启用短代码,例如在评论部分。
Shortcode API简介
在WordPress的简码API定义了如何使用简码定制和扩展您的网站的功能。它使开发人员能够创建独特的内容(例如表单、轮播、滑块等),用户可以通过粘贴相关的短代码将这些内容添加到他们的网站中。
在短代码的帮助下,您几乎可以将您能想到的任何功能添加到您的网站。
API支持自闭合和封闭短代码。它处理所有棘手的解析,并包含用于设置和获取默认属性的辅助函数。
借助API,您可以直接深入开发和自定义短代码,而不是浪费宝贵的时间为您制作的每个短代码定义正则表达式。
了解短代码API的基础知识
每次您在WordPress中打开页面或发帖时,它都会在处理网站内容时查找已注册的短代码。
如果找到注册的简码,简码 API 将接管并返回简码的输出。返回的输出字符串替换它添加位置中的短代码标签。
您可以使用add_shortcode() 函数在WordPress中注册一个短代码。这是它的完成方式:
add_shortcode( 'shortcode_name', 'shortcode_handler_function' );
- shortcode_name: WordPress 将在解析帖子内容时寻找的标签。Shortcode API 建议您仅使用小写字母、数字和下划线来定义其值(避免使用破折号)。
- shortcode_handler_function:在 WordPress 确认存在已注册的短代码后将执行的回调函数。
短代码处理函数定义如下:
function shortcode_handler_function( $atts, $content, $tag ){ }
- $atts:一个关联的属性数组(即键值对数组)。如果没有定义属性,则默认为空字符串。
- $content:包含的内容,如果您要定义封闭的短代码。它是处理函数的责任,以确保$含量值返回到输出。
- $tag:短代码的标签值(上例中的shortcode_name)。如果两个或多个短代码共享相同的回调函数(有效),$tag值将帮助您确定哪个短代码触发了处理函数。
API解析短代码的标签、属性和包含的内容(如果有),绕过这些值到处理程序函数,处理程序函数处理它们并返回输出字符串。
此输出字符串替换您网站前端的短代码宏。您最终在浏览器中看到的是此输出。
在哪里添加您的自定义短代码脚本?
您可以将自定义短代码脚本添加到主题的functions.php文件或将它们包含在插件中。
如果要将其添加到主题文件,则可以按原样运行add_shortcode()函数。
但是,如果您要将其添加到插件中,我建议您仅在WordPress完全加载后才对其进行初始化。您可以通过将add_shortcode()函数包装在另一个函数中来确保这一点。这称为包装函数:
function shortcodes_init(){
add_shortcode( 'shortcode_name', 'shortcode_handler_function' );
}
add_action('init', 'shortcodes_init');
add_action()函数将shortcodes_init函数挂钩,使其仅在WordPress完成加载后启动(称为‘init’钩子)。
如何在WordPress中创建自定义短代码(初学者级别)
现在我们已经介绍了基础知识,是时候创建自定义短代码了。
要按照下面给出的步骤进行操作,您需要熟悉使用PHP代码和编辑WordPress主题文件。当您完成本教程时,您将准备好启动您的第一个自定义WordPress短代码!
我们将从最简单的短代码开始,然后转向更复杂的短代码。在掌握短代码的过程中享受您的短暂里程碑!
示例 1:使用 [current_year] 的简码
让我们创建一个名为 [current_year] 的短代码,用于在您的网站上输出当前年份。
如果您要向网站添加需要每年更新的内容,此短代码会很有帮助。例如,在您网站的页脚中添加版权声明。
我将使用准系统插件来添加我的短代码功能。您可以将其添加到主题的functions.php文件中并获得相同的结果,但我不建议这样做。不过可以测试和学习!
让我们从创建一个插件开始。在/wp-content/plugins/目录中创建一个新文件夹。

注意插件目录的位置
我将我的插件命名为“salcodes”,但您可以随意命名它。
在salcodes插件目录中,创建一个同名的PHP文件(salcodes.php)。完成后,将以下标题添加到您的插件文件中:
<?php
/*
Plugin Name: Salcodes
Version: 1.0
Description: Output the current year in your WordPress site.
Author: Salman Ravoof
Author URI: https://www.salmanravoof.com/
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: salcodes
*/
这个简单的插件头文件足以满足我们的目的。您可以在WordPress Codex中了解有关插件标头要求的更多信息。保存此文件,然后转到您的WordPress仪表板以激活插件。
现在,让我们注册短代码及其处理函数。为此,请将以下代码添加到您的插件文件中:

网络活动可以帮助任何企业发展,这已不是什么秘密。作为企业主,没有更好的方式来建立新的关系——无论是与潜在客户、业务合作伙伴还是投资者。
事件本身有许多不同的风格和不同的目的;从简单的面对面聚会到大型商务会议和聚会。
无论活动规模大小,它们都是一种有效的营销技术的原因是因为它们通常围绕一个主题展开,这意味着您有机会在目标受众面前展示您的业务。
当您选择参加活动时,您不仅会确立自己的权威(特别是如果您是主题演讲者之一),您还将展示您的业务或产品作为解决听众问题的解决方案,从而导致销售额的增加。
无论您的企业规模大小,举办活动,甚至只是参加几个活动都是明智的营销策略。
如果您一直在考虑在营销计划中整合事件,但不知道如何将其添加到您的网站;你来对地方了。
在这篇文章中,我们将向您展示如何手动和使用插件添加WordPress事件。
如何使用代码添加WordPress事件
WordPress拥有强大的引擎盖,使其不仅仅是一个简单的博客平台。
它最强大的功能之一是能够创建自定义内容并以您想要的方式完全显示它。
由于我们想要一种简单的方式在我们的网站上显示事件,我们将利用WordPress的功能并利用自定义文章类型。
首先,您需要登录到您的WordPress仪表盘,然后单击外观,然后单击主题编辑器。
警告:如果操作不当,编辑WordPress主题的源代码可能会破坏您的网站。如果您不习惯这样做,请先与开发人员确认。或者改用下面提到的插件之一。
编辑器加载后,查看屏幕右侧 – 您将看到一堆文件。
我们自定义文章类型的代码需要转到functions.php,因此单击它以将其加载到编辑器中。
现在在functions.php文件的末尾粘贴以下代码:
// register custom post type to work with
function lc_create_post_type() {
// set up labels
$labels = array (
'name' => 'Events',
'singular_name' => 'Event',
'add_new' => 'Add New Event',
'add_new_item' => 'Add New Event',
'edit_item' => 'Edit Event',
'new_item' => 'New Event',
'all_items' => 'All Events',
'view_item' => 'View Event',
'search_items' => 'Search Events',
'not_found' => 'No Events Found',
'not_found_in_trash' => 'No Events found in Trash',
'parent_item_colon' => '',
'menu_name' => 'Events',
);
//register post type
register_post_type ( 'event', array(
'labels' => $labels,
'has_archive' => true,
'public' => true,
'supports' => array( 'title', 'editor', 'excerpt', 'custom-fields', 'thumbnail','page-attributes' ),
'taxonomies' => array( 'post_tag', 'category' ),
'exclude_from_search' => false,
'capability_type' => 'post',
'rewrite' => array( 'slug' => 'events' ),
)
);
}
add_action( 'init', 'lc_create_post_type' );
上面的代码首先创建一个名为event的自定义文章类型,并告诉WordPress您要使用哪些标签。然后我们注册文章类型并将其设置为像帖子一样。我们还添加了类别和标签的标准分类法,这将使以后对我们的事件进行分类变得更加容易。
添加代码后,单击保存文件。您现在会注意到侧边栏中有一个名为Events的新菜单项。

WordPress活动
您现在可以开始向您的网站添加事件,在您有几个事件后,导航回您的仪表盘并单击设置 > 固定链接,然后单击保存更改以刷新永久链接并允许您的自定义文章类型显示在前端.
如果要将事件添加到导航菜单,请转到外观 > 菜单,您将看到Events显示在左侧。只需将任何事件拖到您的菜单上即可包含它们。
通过使用此方法,您将能够在您的网站上添加和显示简单的事件。
但是如果你想要更多的功能呢?如果您希望人们注册您的活动并直接通过您的网站付款怎么办?如果您希望事件以不同于常规帖子的方式显示怎么办?如果您真的不想编写所有这些代码怎么办?
在这种情况下,使用插件是一个明智的选择。让我们来看看WordPress排名前5的事件插件。
创建WordPress活动事件的Top 5插件
1. The Events Calendar

WordPress插件-The Events Calendar
The Events Calendar是一个用户友好的插件,开箱即用:只需安装它,激活它,根据自己的喜好配置选项,就可以了。该插件是完全响应式的,适用于所有主要的主题框架,如Avada、Genesis、WooThemes和Thesis。
最重要的是,该插件还经过SEO优化,包括微格式支持以及翻译和国际化支持。
精简版具有以下功能:
- 快速创建事件
- 保存的场地和组织者
- 带有工具提示的日历月视图
- 列表显示
- 日景
- 事件搜索
- 谷歌地图
- 小工具:即将举行的活动列表
- 事件分类法(类别和标签)
- Google日历和iCal导出
- 和更多
该插件的专业版允许您添加重复事件、额外的视图和小部件,能够从您的WordPress仪表盘中销售门票和管理与会者,并与流行的电子商务插件(如WooCommerce和Easy Digital Downloads以及能够连接您的Eventbrite帐户。
WordPress Events Calendar Pro提供三个定价层,个人许可证起价为89美元,可提供一年的支持和更新。
2. All In One Event Calendar

WordPress插件-All In One Event Calendar
Time.ly的All In One Event Calendar是一种在 WordPress 中列出您的活动并轻松与世界其他地方共享的漂亮方式。他们的日历系统结合了简洁的视觉设计和强大的功能。
该插件还提供免费和高级版本。
该插件的免费版本可从官方插件库获得,允许您创建和导入无限事件。事件可以在日、周、月、议程视图中显示,免费版本还允许您创建重复事件。
您可以借助从免费到付费的附加组件进一步扩展插件的功能。
All In One Events Calendar的专业版可作为托管解决方案提供,可以嵌入到任何站点,并具有额外的功能,例如CSV导入、超级小部件、导入未来事件的能力、导入RSS Feed和前端事件的提交。付费计划起价为每月9美元。
3. WP Event Manager
WP Event Manager是更简单、轻量级的WordPress事件管理插件之一。它非常适合那些希望保持网站速度快且不占用太多空间或用臃肿功能弄乱后端的人。它正在迅速成为一个非常受欢迎的插件,具有很好的评论和更好的客户支持。我们甚至注意到用户对免费版插件的开发者支持赞不绝口。
与此列表中的许多插件一样,WP Event Manager插件提供了一个免费的核心插件,以及购买高级附加组件以扩展其功能的选项。尽管界面时尚简洁,但免费插件的功能列表却令人印象深刻。例如,您会收到从多语言翻译到前端表单、小部件甚至可搜索事件列表的短代码的所有内容。

WordPress插件-WP Event Manager
WP Event Manager开发人员在速度和用户体验方面付出了很多努力——具有漂亮的缓存功能、响应元素、AJAX驱动的事件列表等等。至于高级附加组件,有很长的列表,但这里有一些亮点:
- 日历
- 谷歌地图
- WooCommerce售票
- 注册
- 事件警报
- 一个可嵌入的事件小部件
- 联系主办方
- 电子邮件
- 滑块
- 谷歌分析
- 事件标签
4. Events Manager

WordPress插件-Events Manager
Events Manager是一个功能齐全的事件注册管理插件,包括重复事件、位置管理、日历、谷歌地图集成、预订管理等。
其中一些功能包括:
- 简单的活动注册(单日开始/结束时间)
- 重复性和长期(多日)事件注册
- 预订管理(包括批准/拒绝、导出CVS等!)
- 多张票
- 多站点支持
- BuddyPress支持
- 来宾/会员活动提交
- 分配事件位置并按位置查看事件
- 谷歌地图
- 以及更多。
插件的高级版本Events Manager Pro添加了自动电子邮件提醒、优惠券管理、可定制的预订表格以及与PayPal、Authorize.net和离线支付的集成。1个站点的活动管理器专业版售价75美元。
5. Event Organiser

WordPress插件-Event Organiser
Event Organizer通过使用内置的“自定义文章类型”添加事件管理,并允许您创建具有与文章相同功能的WordPress事件,同时添加允许您管理事件的附加功能。
您可以根据复杂的时间表创建重复的活动,并将您的活动分配到场地。用户界面直观且易于使用,事件可以作为WordPress列表或在日历页面上查看。
该插件可以进一步扩展,包括前端用户提交、折扣代码、附加支付网关和iCal同步。
Event Organizer Pro具有附加功能,例如预订管理、可自定义的电子邮件、场地的自定义字段等。个人许可证的起价为40美元。
小结
活动是一种强大的资产,可以添加到您的营销策略中。无论您是想举办活动还是简单地列出您所在地区的可用活动,都有一种简单的方法可以将活动添加到WordPress。
如果您只需要一种列出活动的方法,而无需处理预订和售票,那么使用自定义帖子类型是一种简单直接的解决方案。
另一方面,如果您需要额外的功能来创建定期活动、集成Google地图、在线销售门票和管理场地,那么使用我们列表中的插件之一是不错的选择。
在做出最终决定之前,请记住以下几点以及要在事件插件中寻找的功能:
- 与第三方工具(如Google日历)集成
- 对移动用户的响应
- 多个日历视图和过滤器
- 活动签到
- 网上售票设施
- 能够将事件保存到用户的第三方日历服务
- 简单的外观定制选项
- 预定和重复发生的事件
- 用于显示事件的侧边栏小部件
- 事件的导入和导出
最后,要考虑的最后一点是价格,并通过了解活动的复杂性预先了解您需要哪些功能。在某些情况下,插件的免费版本就足够了。但是,如果您事先知道您需要高级功能,例如重复出现的WordPress事件和与电子邮件列表的集成,那么选择插件的高级版本是最佳选择。