如何创建 WordPress 简码并使用它们

WordPress 简码是小标签，用作在帖子和页面中执行特定功能的快捷方式。 您可以通过围绕简单单词或短语的方括号识别短代码。 它们是在 2.5 版中引入的，其使命是帮助人们以简单的方式执行功能。

您可能已经知道，WordPress 使用 PHP 编程语言来启动自身。 因此，当您想直接向帖子和页面添加特定功能时，您必须在文本编辑器中编写代码。 相反，短代码允许用户用一个简单的术语替换整个代码块，并通过发布帖子来运行它。 很神奇，不是吗？

如何使用 WordPress 短代码

要使用短代码，人们不必知道如何编码或了解它们在后端是如何工作的。 WordPress 本身以及大多数 WordPress 主题和插件使用不同的短代码来允许使用许多高级功能。

例如，要显示整个图片库，您只需使用 WordPress 随附的[gallery]短代码。 大多数短代码都可以像前面的示例一样以其基本形式使用。

简码参数

通常情况下，短代码可以有额外的参数。 通过向它们添加额外信息，您可以自定义和更改输出。 例如，虽然微不足道的 [gallery] 短代码显示附加到帖子的所有图像，但可以对其进行更改。 图库简码可让您通过 ID 指定图片，以便您可以只显示特定图片，甚至包含不属于该特定帖子的图片。

此外，可以通过提供附加参数来定义图库的大小以及许多其他内容。 下面是一个例子：

此示例中的图库将仅显示具有指定 ID 号的图像。 在这种情况下，大小将自动更改为中。 你可以通过一个简单的短代码获得这一切。 现在想象一下，如果您要手动添加包含数十行甚至数百行的 PHP 代码，整个过程会是什么样子。 谢谢，短代码！

开始和结束标签

例如，谷歌地图插件可能允许您通过短代码在地图上显示位置。 大多数这样的插件都有开始和结束标签，而地址应该写在两者之间。 下面是一个例子：

[[地图]]美国纽约[[/地图]]

从示例中可以看出，结束标记始终以斜杠“/”开头。 通过同时拥有这两个标签，WordPress 可以更轻松地识别短代码的各个部分。

在文本编辑器中工作

尽管它们只是功能的快捷方式，但短代码实际上是特定于 WordPress 的密码本身。 因此，如果您尝试在可视化编辑器中编写短代码，WordPress 将立即向您显示该短代码的输出（或仅占位符）。 如果您按照图库示例并在可视化编辑器中编写短代码，您会看到 WordPress 立即显示其内容（请参阅本文中的第一张图片以了解其工作原理）。

默认的 WordPress 简码

短代码通常由主题和插件管理。 每个开发人员都可以自己注册短代码，所以每个都是不同的。 短代码的作用是什么，它的参数和功能是什么，完全取决于您使用的特定插件和主题。

例如，帮助您在 Google 地图上显示位置的插件可能具有 [[maps]] 短代码，显示订阅表单的插件将使用 [[form]] 等。

但是，WordPress 附带了一组默认短代码，您无需安装其他扩展即可使用。 默认情况下，这些是您可以使用的短代码：

转义短代码（显示短代码的文本而不执行它）

有时，您可能希望显示代表短代码的文本而不是执行它。 如果您尝试向文本编辑器和可视化编辑器添加短代码，您就会意识到它在两种情况下都被执行。

如果要显示带有开始和结束标记的短代码，请仅使用第一个和最后一个双括号： [[maps]New York, USA[/maps]]

在文本编辑器中工作时，您还可以用方括号的代码替换方括号。 因此，您可以使用“[”代替“[”，而使用“]”代替“]”。 例如： [简码&#93 ; 也将显示短代码而不执行它。

如何创建一个简单的短代码

当您每天在 WordPress 中写文章时，有时您会重复自己，并且必须一遍又一遍地输入内容。 无论是网站 URL、长句还是您不断从头开始编写的一段 HTML 代码，您都应该考虑为它编写一个短代码。

有了这个简单的功能，您不必成为程序员，或者您甚至不会聘请程序员来为您简化工作。 按照接下来的几个步骤，让自己成为一个自定义的短代码：

1. 在 Appearance -> Editor 菜单中打开 function.php 文件
2. 将以下代码放在文件末尾：

 函数 fsg_shortURL() {
 返回“http://www.firstsiteguide.com”；
 }
 add_shortcode('fsg', 'fsg_shortURL');

3. 转到文本编辑器并输入[fsg]以获取 URL 而不是短代码

没那么难，对吧？

更高级的示例：添加图像短代码

通过在functions.php中放置以下代码，您可以创建用于放置具有自定义宽度和高度属性的图像的短代码：

1. 转到functions.php文件
2. 粘贴以下代码：

 函数 img_shortcode( $atts , $content = null ) {

	提取（shortcode_atts（
		大批（
			'宽度' => '',
			'高度' => '',
		), $atts )
	);
返回 '​​';
}
add_shortcode( 'img', 'img_shortcode' );

3. 打开文本编辑器：

在这里，您可以使用[img width='x' height='y'] http://... [/img]短代码，其中“x”和“y”是表示宽度和高度（以像素为单位）的数字。

如果需要，您可以轻松添加其他图像属性； 查看 W3 Schools 上所有图像属性的列表。

如何在文本小部件中使用短代码

简码可以包含您可以添加到 WordPress 网站的不同功能。 无论您是为自己创建的还是带有主题或刚刚安装的插件，您都可能一直在使用短代码。 由于您确实可以节省时间并从中受益，因此没有理由不使用短代码。

如果您刚刚开始构建您的 WordPress 网站，您可能只在帖子编辑器中使用过短代码。 但是，事实是您几乎可以在任何地方使用短代码。

例如，如果您使用的是 5 秒 Google Maps PRO 插件，它允许您轻松创建带有无数图钉的地图，您可能希望通过短代码直接在文本小部件中插入地图，并在侧边栏上显示您的位置，而不是单个邮政。 但是如果您的主题不支持小部件中的短代码，您将需要自己启用该功能，这就是我们将在本文中展示的内容。

如果您需要在 PHP 文件中使用短代码（例如，如果您想在 header.php 文件中运行代码并在标头所在的任何地方运行短代码），您可以通过将代码包装在它周围轻松实现. 但是，如果您尝试在我们上面提到的示例中使用文本小部件中的短代码，您最终会感到失望，因为这根本不起作用，小部件显示的是短代码，而不是它的内容。 除非您的主题已经注册了该功能，否则您需要自己启用它。

因此，如果您希望能够将短代码放入 Text Widget 并使其运行，请不要担心； 你可以在几秒钟内实现它：

1. 打开functions.php
2. 复制并粘贴以下两行：

 add_filter('widget_text', 'shortcode_unautop');
 add_filter('widget_text', 'do_shortcode');

3. 保存更改

虽然实际上只使用使短代码工作的第二行就足够了，但您将需要第一行以避免 WordPress 自动插入段落和中断标签，您会通过在小部件中格式化文本而无意识地创建换行符. 以防万一您将短代码放在单独的行上， unautop将删除这些段落标签，并且短代码将像魅力一样工作。

现在您可以导航到Appearance -> Widgets并将 Text Widget 拖到您想要的位置。 毕竟，当您将短代码直接写入您的文本小部件（当然，它已在您的网站上注册）时，它会像在帖子编辑器中输入一样执行。

同样，您可以从 Text Widget 运行 PHP 代码。 这很容易，不是吗？ 享受您的短代码。

短代码无处不在

如果您刚刚开始创建 WordPress 博客，短代码可能看起来多余且难以理解。 大多数情况下，可以通过使用插件提供的用户友好界面来避免短代码。 但是，当您更多地参与博客并开始使用更多插件时，您将了解短代码的真正力量。

使用它们将成为一种例行公事，您很快就会习惯于在您创建的每篇新文章中都写上方括号。 因此，请花几分钟时间，使用本文来学习基础知识。