wptexturize_after_shortcodes() – Replaces common plain text characters into formatted entities

Description

Replaces common plain text characters into formatted entities

As an example,

• 'cause today's effort makes it worth tomorrow's "holiday" …

Becomes:

• ’cause today’s effort makes it worth tomorrow’s “holiday” …

Code within certain html blocks are skipped.

Usage

$string = wptexturize_after_shortcodes( $text, $reset );

Parameters

$text

( string ) required – The text to be formatted

$reset

( bool ) optional – Set to true for unit testing. Translated patterns will reset.

Returns

string The string replaced with html entities

Source

File name: oik-css/includes/formatting-later.php
Lines:

function wptexturize_after_shortcodes($text, $reset = false) {
  global $wp_cockneyreplace, $shortcode_tags;
  static $static_characters, $static_replacements, $dynamic_characters, $dynamic_replacements,
    $default_no_texturize_tags, $default_no_texturize_shortcodes, $run_texturize = true;

  // If there's nothing to do, just stop.
  if ( empty( $text ) || false === $run_texturize ) {
    return $text;
  }

  // Set up static variables. Run once only.
  if ( $reset || ! isset( $static_characters ) ) {
    
/**
 * Filter whether to skip running wptexturize().
 *
 * Passing false to the filter will effectively short-circuit wptexturize().
 * returning the original text passed to the function instead.
 *
 * The filter runs only once, the first time wptexturize() is called.
 *
 * @since 4.0.0
 *
 * @see wptexturize()
 *
 * @param bool $run_texturize Whether to short-circuit wptexturize().
 */
    $run_texturize = apply_filters( 'run_wptexturize', $run_texturize );
    if ( false === $run_texturize ) {
      return $text;
    }

    /* translators: opening curly double quote */
    $opening_quote = _x( '“', 'opening curly double quote' );
    /* translators: closing curly double quote */
    $closing_quote = _x( '”', 'closing curly double quote' );

    /* translators: apostrophe, for example in 'cause or can't */
    $apos = _x( '’', 'apostrophe' );

    /* translators: prime, for example in 9' (nine feet) */
    $prime = _x( '′', 'prime' );
    /* translators: double prime, for example in 9" (nine inches) */
    $double_prime = _x( '″', 'double prime' );

    /* translators: opening curly single quote */
    $opening_single_quote = _x( '‘', 'opening curly single quote' );
    /* translators: closing curly single quote */
    $closing_single_quote = _x( '’', 'closing curly single quote' );

    /* translators: en dash */
    $en_dash = _x( '–', 'en dash' );
    /* translators: em dash */
    $em_dash = _x( '—', 'em dash' );

    $default_no_texturize_tags = array('pre', 'code', 'kbd', 'style', 'script', 'tt');
    $default_no_texturize_shortcodes = array('code');

    // if a plugin has provided an autocorrect array, use it
    if ( isset($wp_cockneyreplace) ) {
      $cockney = array_keys($wp_cockneyreplace);
      $cockneyreplace = array_values($wp_cockneyreplace);
    } elseif ( "'" != $apos ) { // Only bother if we're doing a replacement.
      $cockney = array( "'tain't", "'twere", "'twas", "'tis", "'twill", "'til", "'bout", "'nuff", "'round", "'cause" );
      $cockneyreplace = array( $apos . "tain" . $apos . "t", $apos . "twere", $apos . "twas", $apos . "tis", $apos . "twill", $apos . "til", $apos . "bout", $apos . "nuff", $apos . "round", $apos . "cause" );
    } else {
      $cockney = $cockneyreplace = array();
    }

    $static_characters = array_merge( array( '...', '``', '\'\'', ' (tm)' ), $cockney );
    $static_replacements = array_merge( array( '…', $opening_quote, $closing_quote, ' ™' ), $cockneyreplace );


    // Pattern-based replacements of characters.
    // Sort the remaining patterns into several arrays for performance tuning.
    $dynamic_characters = array( 'apos' => array(), 'quote' => array(), 'dash' => array() );
    $dynamic_replacements = array( 'apos' => array(), 'quote' => array(), 'dash' => array() );
    $dynamic = array();
    $spaces = wp_spaces_regexp();

    // '99' and '99" are ambiguous among other patterns; assume it's an abbreviated year at the end of a quotation.
    if ( "'" !== $apos || "'" !== $closing_single_quote ) {
      $dynamic[ '/\'(\d\d)\'(?=\Z|[.,)}\-\]]|>|' . $spaces . ')/' ] = $apos . '$1' . $closing_single_quote;
    }
    if ( "'" !== $apos || '"' !== $closing_quote ) {
      $dynamic[ '/\'(\d\d)"(?=\Z|[.,)}\-\]]|>|' . $spaces . ')/' ] = $apos . '$1' . $closing_quote;
    }

    // '99 '99s '99's (apostrophe)  But never '9 or '99% or '999 or '99.0.
    if ( "'" !== $apos ) {
      $dynamic[ '/\'(?=\d\d(?:\Z|(?![%\d]|[.,]\d)))/' ] = $apos;
    }

    // Quoted Numbers like '0.42'
    if ( "'" !== $opening_single_quote && "'" !== $closing_single_quote ) {
      $dynamic[ '/(?<=\A|' . $spaces . ')\'(\d[.,\d]*)\'/' ] = $opening_single_quote . '$1' . $closing_single_quote;
    }

    // Single quote at start, or preceded by (, {, <, [, ", -, or spaces.
    if ( "'" !== $opening_single_quote ) {
      $dynamic[ '/(?<=\A|[([{"\-]|&lt;|' . $spaces . ')\'/' ] = $opening_single_quote;
 

 View on GitHub View on Trac