admin 管理员组

文章数量: 887191


2024年1月23日发(作者:如何对数组去重)

如何在WordPress中添加自定义短代码

随着WordPress的普及,它的可定制化程度也越来越高。在使用WordPress建站时,我们会经常用到短代码(Shortcode),它是一种简短的代码片段,可以将一些复杂的功能和内容集成到页面中。虽然WordPress自带了许多短代码,但是我们经常需要自己添加一些自定义的短代码来满足自己的需求。本文将从以下几个方面来介绍如何在WordPress中添加自定义短代码。

一、了解WordPress短代码的基本知识

短代码是WordPress的一种特殊语法,用于在文章和页面中嵌入特定的功能和内容。它通常用方括号([ ])包围,里面是对应的短代码名称,如 [gallery] 等。我们可以将短代码理解为一个函数或者一个插件的简称。

在WordPress中,可以自定义短代码。比如,在写文章时,我们可以使用 [mycode] 表示某个自定义的短代码。另外,在文章中强制使用原格式语言的情况下需要使用短代码。

二、创建一个简单的自定义短代码

现在,我们来看看如何创建一个简单的自定义短代码。这个代码我们可以称之为“hello world”。首先,我们需要在WordPress的函数文件()中添加下列代码:

```php

function my_hello_world() {

return "Hello World!";

}

add_shortcode('hw', 'my_hello_world');

```

代码解释:

- 第一行用于定义一个函数 my_hello_world(),这个函数的返回值为字符串 “Hello World!”。

- 在第二行中,我们使用了 add_shortcode 函数来添加一个名为

hw 的短代码,它的回调函数是 my_hello_world()。

现在,我们可以在文章中使用 [hw] 来代替“Hello World!”这个字符串了。

三、添加带参数的自定义短代码

一个自定义短代码是否实用,并不仅仅取决于它的名称和返回值,还要看它是否支持参数的传递。接下来,我们会使用一个带参数的短代码作为示例,来介绍如何添加带参数的自定义短代码。

```php

function my_simple_list( $atts ) {

$atts = shortcode_atts( array(

'title' => '',

'items' => '',

), $atts );

$title = esc_attr( $atts['title'] );

$items = explode( ',', $atts['items'] );

$output = '

' . $title . '

';

$output .= '

    ';

    foreach( $items as $item ) {

    $output .= '

  • ' . esc_html( $item ) . '
  • ';

    }

    $output .= '

';

return $output;

}

add_shortcode( 'simple_list', 'my_simple_list' );

```

代码解释:

- 第一行的 $atts 参数用于存储传递进来的参数。shortcode_atts

函数默认设置了title和items参数,如果没有传入参数那么这两个参数的默认值都为空。

- 接下来的 $title 和 $items 变量用于获取传递进来的参数值。其中,$items 表示列表的条目,需要使用 explode 函数进行分割。

- 然后,我们将标题和列表渲染到 $output 变量中,最后将它返回,即可在页面中显示完整内容。

然后,我们就可以在文章中使用 [simple_list title="My List"

items="Item1,Item2,Item3"] 来渲染一个标题为“My List”的列表了。

四、使用短代码生成器插件

如果你不熟悉PHP或者不愿意手写自定义短代码,还可以使用现成的短代码生成器插件。这些插件通常提供一个可视化界面,让你可以在后台轻松创建自己的短代码,而不用手写代码。

常见的短代码生成器插件有:

- Shortcoder — WordPress 短代码插件

- Simple Shortcodes

- Shortcodes Ultimate

在使用这些插件时,只需要在后台创建自己的短代码,输入名称和内容然后保存即可。一些高级的短代码生成器插件还支持表单、按钮和其他各种交互式元素。

总结

在本文中,我们看到了如何使用PHP编写自定义短代码,并理解了添加自定义短代码的基本规则。带参数的自定义短代码更加实用,可以满足很多用户需求。如果你对PHP不太熟悉,可以使用短代码生成器插件来创建自己的短代码。无论你是什么水平的开发人员,都可以在WordPress网站上添加自定义短代码来提高功能和用户体验。


本文标签: 代码 使用 参数