translate_smiley( array $matches )

Convert one smiley code to the icon graphic file equivalent.


Description Description

Callback handler for convert_smilies().

Looks up one smiley code in the $wpsmiliestrans global array and returns an <img> string for that smiley.


Parameters Parameters

$matches

(array) (Required) Single match. Smiley code to convert to image.


Top ↑

Return Return

(string) Image string for smiley.


Top ↑

Source Source

File: wp-includes/formatting.php

3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
function translate_smiley( $matches ) {
    global $wpsmiliestrans;
 
    if ( count( $matches ) == 0 ) {
        return '';
    }
 
    $smiley = trim( reset( $matches ) );
    $img    = $wpsmiliestrans[ $smiley ];
 
    $matches    = array();
    $ext        = preg_match( '/\.([^.]+)$/', $img, $matches ) ? strtolower( $matches[1] ) : false;
    $image_exts = array( 'jpg', 'jpeg', 'jpe', 'gif', 'png' );
 
    // Don't convert smilies that aren't images - they're probably emoji.
    if ( ! in_array( $ext, $image_exts ) ) {
        return $img;
    }
 
    /**
     * Filters the Smiley image URL before it's used in the image element.
     *
     * @since 2.9.0
     *
     * @param string $smiley_url URL for the smiley image.
     * @param string $img        Filename for the smiley image.
     * @param string $site_url   Site URL, as returned by site_url().
     */
    $src_url = apply_filters( 'smilies_src', includes_url( "images/smilies/$img" ), $img, site_url() );
 
    return sprintf( '<img src="%s" alt="%s" class="wp-smiley" style="height: 1em; max-height: 1em;" />', esc_url( $src_url ), esc_attr( $smiley ) );
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.8.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.