如何在WordPress中添加短代码

如何在WordPress中添加短代码

您想在您的网站上包含短代码吗? 你来对地方了。 在本指南中,我们将向您展示如何在 WordPress 中添加短代码并向您展示一些示例,以便您可以充分利用它们。

自从 WordPress 2.5 版本中添加了短代码以来,用户一直在使用它们来实现各种自定义。 短代码非常有用,它们允许我们在帖子、页面和我们网站的几乎任何地方运行特定的代码段。 最重要的是,即使对于最没有经验的用户,它们也非常易于使用。

什么是短代码?

短代码将触发一段由短代码名称指定的代码,该代码始终用方括号括起来,如下所示: [shortcode-name]

每个短代码运行的代码取决于短代码的创建方式。 许多插件提供了自己的短代码,WordPress 还默认包含一些。 最好的部分是 WP 简码 API 允许您创建自己的自定义简码。

短代码是开发人员的绝佳工具,因为它们允许您在站点的任何位置插入任何脚本。 当您多次使用相同的脚本时,您可以简单地使用相同的短代码而无需重复代码。 这有助于您节省时间并保持代码整洁。

此外,短代码可以采用一些值,其工作方式类似于函数的参数。

[shortcode val1=’hi’ val2=’ok’]

也可以在打开和关闭这样的短代码时用作 HTML 标签 [shortcode]一些文字 [/shortcode].

总之,短代码可让您在前端运行 PHP 脚本,而无需编写任何代码(如果它是现有的短代码)。 WordPress 和一些插件默认有一些短代码,但您也可以根据需要创建自己的短代码。

最后,还有不同类型的短代码:插入画廊、WooCommerce 产品、表单、图像等等。 每个短代码都是不同的,并且做不同的事情。

如果您需要更多信息,请查看有关短代码的完整指南。

现在我们更好地了解它们是什么,让我们看看如何将短代码添加到您的 WordPress 网站。

如何在WordPress中添加短代码

在我们开始之前,请务必注意,由于每个短代码的构建方式不同,因此它们可以具有或不具有值。 这些值特定于每个短代码,它们将值传递给代码以获得我们想要的结果。

正如我们之前提到的,有不同类型的短代码,WooCommerce 短代码是一些最常见的短代码。 例如, [woocommerce_cart] 短代码将在您粘贴它的任何地方显示 de WooCommerce 购物车。

要测试它,只需将短代码粘贴到帖子或页面上,或者像这样输入: [woocommerce_cart]. 然后,查看前端,您将在插入短代码的地方看到 WC 推车。

注意:由于我们将编辑一些核心文件,因此在开始之前,我们建议您对站点进行完整备份并创建子主题。 您可以通过编程方式创建一个或使用这些插件中的任何一个。

添加带有值的 WordPress 短代码

现在让我们使用默认的图库 WordPress 简码来学习如何添加带有值的简码。

画廊简码 显示漂亮的图片库并支持多个值。 您需要包含 ID 值以指定要在图库中显示的图像。 此参数获取 ID 并显示那些特定图像。

例如,如果我们想显示 ID 为 720、729、731 和 732 的图像,我们将短代码添加到帖子或页面,如下所示:

要测试它,只需粘贴短代码,用您自己的 ID 替换图像 ID。 如果您不知道图像 ID,请在媒体库编辑器中打开它们,您将在浏览器 URL 上看到 ID,并在图像详细信息上打印永久链接。

在 WordPress 中添加短代码 - 媒体库中的图像 ID

如果您使用的是经典文本编辑器,则只需将短代码粘贴到内容中即可。 另一方面,在古腾堡,您可以使用短代码块。 此外,许多页面构建器和主题都包含一些您可以使用的其他短代码管理解决方案。

古腾堡

古腾堡简码块

经典编辑器

在经典编辑器中插入短代码

添加短代码后,检查您网站的前端,您应该会看到如下内容:

WordPress画廊简码

在模板文件中使用简码

使用 WordPress 简码的另一种方法是将它们添加到模板文件中。 如果您想开发自定义解决方案,这对您来说是一个有趣的选择。 例如,这允许您在逻辑条件下运行简码或动态更改简码值,以及许多其他可能性。

您可以使用 do_shortcode() PHP 函数在模板文件上使用简码。 这是您可以在任何文件中使用的默认 WordPress 功能。

要从文件运行短代码,只需添加以下内容:

echo do_shortcode(‘

‘);

现在自定义标题并在 header.phpfile 上运行图库简码。 为此,您需要使用子主题覆盖此文件。 有关如何自定义模板的更多信息,请查看本指南。

在您的 WordPress 仪表板中,通过转到外观 > 主题编辑器并打开 header.php 文件,将短代码添加到您的标题中。 转到文件末尾并粘贴代码,如下所示:

模板文件上的简码

在文件中包含上述脚本后,您将在标题中看到图库。

使用带有 WordPress 钩子的简码

以编程方式向 WordPress 添加短代码的另一种方法是将它们与钩子结合使用。 如果您不熟悉钩子,我们建议您查看本指南以了解有关它们的更多信息。

要使用带有钩子的短代码,您需要 do_shortcode() 函数,就像我们在上一节中看到的那样。

以下脚本将适用于子主题的 functions.php 文件。 我们使用 wp_footer() 钩子,所以这将打印在站点的页脚上。

/* 带有 wp_footer 钩子的简码 */
add_action(‘wp_footer’,’QuadLayers_footer_shortcode’);
函数 QuadLayers_footer_shortcode(){
echo do_shortcode(‘[products ids=”623″]’);
}

默认情况下,此短代码随 WooCommerce 一起提供,用于显示产品。 在本例中,我们使用它来显示 ID = 623 的单个产品。

使用带有 WordPress 钩子的简码

有关如何在您的网站上自定义页脚的更多信息,请查看本指南。

如何在 WordPress 中创建自定义短代码

另一个有趣的选择是创建自己的自定义短代码。 这并不难,但它需要一些基本的开发人员技能和一些编码知识。 如果您不是高级用户,请不要担心。 即使是最没有经验的程序员也会发现这很容易。

WordPress 为我们提供了 add_shortcode() 函数来构建和添加我们自己的短代码。 让我们看看如何使用此功能通过一些示例脚本创建自定义短代码。

为登录和注销的用户显示不同的消息

以下脚本将创建一个短代码并向用户打印一条消息。 为了让它更有趣,我们应用了一个条件来为登录和注销的用户显示不同的消息。

/* 短代码登录*/
add_shortcode(‘logedin’,’QuadLayers_shortcode_logedin’);
函数 QuadLayers_shortcode_logedin($atts){
if(is_user_logged_in()==true){
$response=”您已登录”;
}
别的{
$response=”您已注销”;
}
返回 $response;
}

使用 if,我们检查用户是否已登录,如果为真则显示消息“您已登录”,否则显示“您已退出”。

如何在 WordPress 中创建自定义短代码

按 ID 显示单个帖子

另一种选择是添加一个 WordPress 短代码,显示我们将作为短代码中的值传递的指定帖子。

add_shortcode(‘get-post’,’QuadLayers_shortcode_post’);
函数 QuadLayers_shortcode_post($atts) {
$a = shortcode_atts( array(‘id’ => ”,), $atts );
$args = array(‘post_type’ => ‘post’,’p’ => $a[‘id’]);
$query = new WP_Query($args);
$query->the_post();
$string = ‘

‘.get_the_title().’

‘ ;
$string.=the_post_thumbnail();
$string .= get_the_content();
返回 $string;
}

在这个例子中,我们添加了短代码 [get-post id=”483″]它看起来像这样:

按 ID 显示单个帖子

在逻辑条件下运行不同的短代码

在此示例中,我们将创建一个自定义短代码以在逻辑条件下运行不同的短代码。

我们的自定义简码将显示使用联系表单插件创建的不同表单。 因此,我们将为登录和注销的用户打印不同的表单。

add_shortcode(‘show-form’,’QuadLayers_custom_shortcode’);
函数 QuadLayers_custom_shortcode(){
if(is_user_logged_in()==true){
$response=”

联系我们

“;
$响应。=[wpforms id=”1374″]’;
}
别的{
$response=”

订阅我们的时事通讯

“;
$响应。=[wpforms id=”1373″]’;
}
echo do_shortcode($response);
}

再一次,我们使用条件 if 来检查用户是否登录并基于此显示某个表单。

在逻辑条件下运行不同的短代码

笔记

  • 创建短代码时始终返回数据。 如果你echo它,你可能会遇到一些与你应该显示内容的位置相关的问题
  • do_shortcode(); 函数在大多数模板文件中运行良好,但由于需要回显,因此也可能引发一些问题
  • 许多插件提供了可以自由使用的短代码。 但是,某些短代码可能不适用于帖子、页面,或者尝试在页眉、页脚或侧边栏小部件上使用它们时。 这取决于短代码的复杂程度以及它的构建方式
  • 如果您在 Gutenberg 编辑器上使用自定义短代码时看到一些错误,则意味着您的短代码与 Gutenberg 不兼容。 它无论如何都可以在前端工作,您可以尝试切换到默认编辑器以消除此错误

结论

总之,短代码是有用的工具,可让您在站点的任何位置运行特定的代码段。 当您多次使用同一个脚本时,您可以创建一个短代码并使用它来避免一遍又一遍地重复代码。 短代码即使对于初学者也很容易使用,并帮助您节省时间。

在本指南中,我们看到了在 WordPress 中添加短代码的不同方法。 我们已经学习了如何在值、模板文件和钩子中使用短代码。 最重要的是,我们看到了如何创建自定义短代码,并为您提供了几个示例脚本,您可以根据需要进行调整。

要了解有关短代码以及如何自定义站点的更多信息,请查看以下帖子:

您是否向 WordPress 网站添加了短代码? 您在遵循本指南时遇到任何问题吗? 请在下面的评论中告诉我们!

原创文章,作者:WPJIAN,如若转载,请注明出处:https://wpjian.com/tips/2021071147247.html