ThumbnailImage.php

Go to the documentation of this file.

<?php
class ThumbnailImage extends MediaTransformOutput {
    private static $firstNonIconImageRendered = false;
 
    function __construct( $file, $url, $path = false, $parameters = [] ) {
        # Previous parameters:
        #   $file, $url, $width, $height, $path = false, $page = false
 
        $defaults = [
            'page' => false,
            'lang' => false
        ];
 
        if ( is_array( $parameters ) ) {
            $actualParams = $parameters + $defaults;
        } else {
            # Using old format, should convert. Later a warning could be added here.
            $numArgs = func_num_args();
            $actualParams = [
                'width' => $path,
                'height' => $parameters,
                'page' => ( $numArgs > 5 ) ? func_get_arg( 5 ) : false
            ] + $defaults;
            $path = ( $numArgs > 4 ) ? func_get_arg( 4 ) : false;
        }
 
        $this->file = $file;
        $this->url = $url;
        $this->path = $path;
 
        # These should be integers when they get here.
        # If not, there's a bug somewhere.  But let's at
        # least produce valid HTML code regardless.
        $this->width = round( $actualParams['width'] );
        $this->height = round( $actualParams['height'] );
 
        $this->page = $actualParams['page'];
        $this->lang = $actualParams['lang'];
    }
 
    function toHtml( $options = [] ) {
        global $wgPriorityHints, $wgPriorityHintsRatio, $wgElementTiming, $wgNativeImageLazyLoading;
 
        if ( func_num_args() == 2 ) {
            throw new MWException( __METHOD__ . ' called in the old style' );
        }
 
        $alt = $options['alt'] ?? '';
 
        $query = $options['desc-query'] ?? '';
 
        $attribs = [
            'alt' => $alt,
            'src' => $this->url,
            'decoding' => 'async',
        ];
 
        if ( $wgNativeImageLazyLoading ) {
            $attribs['loading'] = 'lazy';
        }
 
        $elementTimingName = 'thumbnail';
 
        if ( $wgPriorityHints
            && !self::$firstNonIconImageRendered
            && $this->width * $this->height > 100 * 100 ) {
            self::$firstNonIconImageRendered = true;
 
            // Generate a random number between 0.01 and 1.0, included
            $random = rand( 1, 100 ) / 100.0;
 
            if ( $random <= $wgPriorityHintsRatio ) {
                $attribs['importance'] = 'high';
                $elementTimingName = 'thumbnail-high';
            } else {
                // This lets us track that the thumbnail *would* have gotten high priority but didn't.
                $elementTimingName = 'thumbnail-top';
            }
        }
 
        if ( $wgElementTiming ) {
            $attribs['elementtiming'] = $elementTimingName;
        }
 
        if ( !empty( $options['custom-url-link'] ) ) {
            $linkAttribs = [ 'href' => $options['custom-url-link'] ];
            if ( !empty( $options['title'] ) ) {
                $linkAttribs['title'] = $options['title'];
            }
            if ( !empty( $options['custom-target-link'] ) ) {
                $linkAttribs['target'] = $options['custom-target-link'];
            } elseif ( !empty( $options['parser-extlink-target'] ) ) {
                $linkAttribs['target'] = $options['parser-extlink-target'];
            }
            if ( !empty( $options['parser-extlink-rel'] ) ) {
                $linkAttribs['rel'] = $options['parser-extlink-rel'];
            }
        } elseif ( !empty( $options['custom-title-link'] ) ) {
            $title = $options['custom-title-link'];
            $linkAttribs = [
                'href' => $title->getLinkURL(),
                'title' => empty( $options['title'] ) ? $title->getFullText() : $options['title']
            ];
        } elseif ( !empty( $options['desc-link'] ) ) {
            $linkAttribs = $this->getDescLinkAttribs(
                empty( $options['title'] ) ? null : $options['title'],
                $query
            );
        } elseif ( !empty( $options['file-link'] ) ) {
            $linkAttribs = [ 'href' => $this->file->getUrl() ];
        } else {
            $linkAttribs = false;
            if ( !empty( $options['title'] ) ) {
                $attribs['title'] = $options['title'];
            }
        }
 
        if ( empty( $options['no-dimensions'] ) ) {
            $attribs['width'] = $this->width;
            $attribs['height'] = $this->height;
        }
        if ( !empty( $options['valign'] ) ) {
            $attribs['style'] = "vertical-align: {$options['valign']}";
        }
        if ( !empty( $options['img-class'] ) ) {
            $attribs['class'] = $options['img-class'];
        }
        if ( isset( $options['override-height'] ) ) {
            $attribs['height'] = $options['override-height'];
        }
        if ( isset( $options['override-width'] ) ) {
            $attribs['width'] = $options['override-width'];
        }
 
        // Additional densities for responsive images, if specified.
        // If any of these urls is the same as src url, it'll be excluded.
        $responsiveUrls = array_diff( $this->responsiveUrls, [ $this->url ] );
        if ( !empty( $responsiveUrls ) ) {
            $attribs['srcset'] = Html::srcSet( $responsiveUrls );
        }
 
        Hooks::run( 'ThumbnailBeforeProduceHTML', [ $this, &$attribs, &$linkAttribs ] );
 
        return $this->linkWrap( $linkAttribs, Xml::element( 'img', $attribs ) );
    }
}