云策 WordPress 开发者社区

钩子文档

no_texturize_shortcodes

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

概述

no_texturize_shortcodes 是一个 WordPress 过滤器，用于管理不进行文本化处理的短代码列表。它允许开发者指定哪些短代码的内容应避免被 wptexturize() 函数自动转换引号等字符。

关键要点

  • no_texturize_shortcodes 过滤器控制短代码是否被文本化处理，防止原始文本被意外修改。
  • 参数 $default_no_texturize_shortcodes 是一个字符串数组，包含默认不文本化的短代码名称。
  • 通过 add_filter() 添加自定义短代码到列表中，以保护其内容不被 wptexturize() 影响。

代码示例

add_filter( 'no_texturize_shortcodes', 'shortcodes_to_exempt_from_wptexturize' );

function shortcodes_to_exempt_from_wptexturize( $shortcodes ) {
    $shortcodes[] = 'myshortcode';
    return $shortcodes;
}
📄 原文内容

Filters the list of shortcodes not to texturize.

Parameters

$default_no_texturize_shortcodesstring[]
An array of shortcode names.

More Information

By default, WordPress will automatically texturize all post/page content through the wptexturize() function, even content in shortcodes. The texturize process replaces “normal” quotes with “fancy” quotes (aka “smart” quotes or “curly” quotes). Sometimes this is NOT what you want… particularly if your shortcode must contain raw, preprocessed text.

Source

$no_texturize_shortcodes = apply_filters( 'no_texturize_shortcodes', $default_no_texturize_shortcodes );

View all references View on Trac View on GitHub

Used by Description
wptexturize()wp-includes/formatting.php

Replaces common plain text characters with formatted entities.

Changelog

Version Description
2.8.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content


    Steven Lin


    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

    Example Migrated from Codex:

    The example below adds the shortcode “myshortcode” to the list of shortcodes not to texturize.

    add_filter( 'no_texturize_shortcodes', 'shortcodes_to_exempt_from_wptexturize' );

function shortcodes_to_exempt_from_wptexturize( $shortcodes ) {
    $shortcodes[] = 'myshortcode';
    return $shortcodes;
}