convert_smilies() │ WP 0.71

Replaces textual smilies in the text with the corresponding smilie images.

The function works only if the "use smilies" option is enabled and the global variables (arrays) ($wp_smiliessearch, $wp_smiliesreplace) with smilies are not empty.

No Hooks.

Returns

String. formatted text.

Usage

<?php convert_smilies( $text ) ?>
$text(string) (required)
Text in which to convert smilies.

Examples

0

#1 Displays text with converted smilies 

$text = "Text with emoticons :) :(";

echo convert_smilies( $text );

// output:
// Text with emoticons <img src='/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> 
// <img src='/wp-includes/images/smilies/icon_sad.gif' alt=':(' class='wp-smiley' />

Notes

  • Global. String|Array. $wp_smiliessearch

Changelog

Since 0.71 Introduced.

convert_smilies() code WP 7.0

wp-includes/formatting.php 
function convert_smilies( $text ) {
	global $wp_smiliessearch;

	if ( ! get_option( 'use_smilies' ) || empty( $wp_smiliessearch ) ) {
		// Return default text.
		return $text;
	}

	// HTML loop taken from texturize function, could possible be consolidated.
	$textarr = preg_split( '/(<[^>]*>)/U', $text, -1, PREG_SPLIT_DELIM_CAPTURE ); // Capture the tags as well as in between.

	if ( false === $textarr ) {
		// Return default text.
		return $text;
	}

	// Loop stuff.
	$stop   = count( $textarr );
	$output = '';

	// Ignore processing of specific tags.
	$tags_to_ignore       = 'code|pre|style|script|textarea';
	$ignore_block_element = '';

	for ( $i = 0; $i < $stop; $i++ ) {
		$content = $textarr[ $i ];

		// If we're in an ignore block, wait until we find its closing tag.
		if ( '' === $ignore_block_element && preg_match( '/^<(' . $tags_to_ignore . ')[^>]*>/', $content, $matches ) ) {
			$ignore_block_element = $matches[1];
		}

		// If it's not a tag and not in ignore block.
		if ( '' === $ignore_block_element && strlen( $content ) > 0 && '<' !== $content[0] ) {
			$content = preg_replace_callback( $wp_smiliessearch, 'translate_smiley', $content );
		}

		// Did we exit ignore block?
		if ( '' !== $ignore_block_element && '</' . $ignore_block_element . '>' === $content ) {
			$ignore_block_element = '';
		}

		$output .= $content;
	}

	return $output;
}

Formatting