云策 WordPress 开发者社区

函数文档

apply_shortcodes()

查看官方原文 ↗
💡 云策文档标注

概述

apply_shortcodes() 是 WordPress 5.4 引入的函数，用于在内容中搜索并处理短代码。它是 do_shortcode() 的别名，提供相同的功能。

关键要点

  • apply_shortcodes() 是 do_shortcode() 的别名，两者功能完全一致。
  • 函数接受两个参数：$content（必需，要搜索短代码的内容）和 $ignore_html（可选，默认为 false，当为 true 时跳过 HTML 元素内的短代码）。
  • 返回处理后的内容字符串，短代码已被替换为实际输出。
  • 从 WordPress 5.4.0 版本开始引入。

代码示例

// 旧方法使用 do_shortcode()
echo do_shortcode( '[myshrtcode]My Text[/myshrtcode]' );

// WordPress 5.4 引入的新方法使用 apply_shortcodes()
echo apply_shortcodes( '[myshrtcode]My Text[/myshrtcode]' );
// 显示短代码的处理结果
📄 原文内容

Searches content for shortcodes and filter shortcodes through their hooks.

Description

This function is an alias for do_shortcode() .

See also

Parameters

$contentstringrequired
Content to search for shortcodes.
$ignore_htmlbooloptional
When true, shortcodes inside HTML elements will be skipped.

Default:false

Return

string Content with shortcodes filtered out.

Source

function apply_shortcodes( $content, $ignore_html = false ) {
	return do_shortcode( $content, $ignore_html );
}

View all references View on Trac View on GitHub

Uses Description
do_shortcode()wp-includes/shortcodes.php

Searches content for shortcodes and filter shortcodes through their hooks.

Changelog

Version Description
5.4.0 Introduced.

User Contributed Notes

  2. Skip to note 4 content


    Ataur R


    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Old method –

    echo do_shortcode( '[wpdocs_my_shrtcode text="My Text"]', false );
echo do_shortcode( '[wpdocs_my_shrtcode]My Text[/wpdocs_my_shrtcode]', false );

    WordPress 5.4 Introduces apply_shortcodes() 

    echo apply_shortcodes( '[wpdocs_my_shrtcode text="My Text"]', false );
echo apply_shortcodes( '[wpdocs_my_shrtcode]My Text[/wpdocs_my_shrtcode]', false );

    // Displays the result of the shortcode