[],
'values' => [],
'renderLabels' => false
];
foreach ( $groupData as $item ) {
$data = $item[ 'data' ];
if ( $item[ 'type' ] === 'data' ) {
array_push( $horizontalGroupData[ 'labels' ], $data[ 'label' ] );
array_push( $horizontalGroupData[ 'values' ], $data[ 'value' ] );
if ( !empty( $data[ 'label' ] ) ) {
$horizontalGroupData[ 'renderLabels' ] = true;
}
} else if ( $item[ 'type' ] === 'header' ) {
$horizontalGroupData[ 'header' ] = $data[ 'value' ];
}
}
return $horizontalGroupData;
}
/**
* check if infobox item is a title, title inside the hero module or a label
* and if so, remove from it HTML tags.
* If label after sanitization is empty- contain only image- do not
* sanitize it.
*
* @param string $type type of infobox item
* @param array $data infobox item data
* @return array infobox $data with sanitized title param if needed
*/
public function sanitizeInfoboxFields( $type, $data ) {
if ( $type === 'data' ) {
$sanitizedLabel = $this->sanitizeElementData( $data[ 'label' ], '' );
if ( !empty( $sanitizedLabel) ) {
$data[ 'label' ] = $sanitizedLabel;
}
} else if ( $type === 'horizontal-group-content' ) {
foreach ( $data[ 'labels' ] as $key => $label ) {
$sanitizedLabel = $this->sanitizeElementData( $label, '' );
if ( !empty( $sanitizedLabel ) ) {
$data[ 'labels' ][ $key ] = $sanitizedLabel;
}
}
} else if ( $type === 'title' ) {
$data[ 'value' ] = $this->sanitizeElementData( $data[ 'value' ] );
} else if ( $type === 'hero-mobile' && !empty( $data[ 'title' ][ 'value' ] ) ) {
$data[ 'title' ][ 'value' ] = $this->sanitizeElementData( $data[ 'title' ][ 'value' ] );
}
return $data;
}
/**
* process single title or label
*
* @param $elementText
* @param string $allowedTags
* @return string
*/
private function sanitizeElementData( $elementText, $allowedTags = null ) {
$elementTextAfterTrim = trim( strip_tags( $elementText, $allowedTags ) );
if ( $elementTextAfterTrim !== $elementText ) {
WikiaLogger::instance()->info( 'Striping HTML tags from infobox element' );
$elementText = $elementTextAfterTrim;
}
return $elementText;
}
/**
* extends image data
*
* @param array $data
*
* @return bool|array
*/
public function extendImageData( $data ) {
$thumbnail = $this->getThumbnail( $data[ 'name' ] );
$ref = null;
if ( !$thumbnail ) {
return false;
}
wfRunHooks( 'PortableInfoboxRenderServiceHelper::extendImageData', [ $data, &$ref ] );
$dimensions = self::getImageSizesToDisplay( $thumbnail );
$data[ 'ref' ] = $ref;
$data[ 'height' ] = $dimensions[ 'height' ];
$data[ 'width' ] = $dimensions[ 'width' ];
$data[ 'thumbnail' ] = $thumbnail->getUrl();
$data[ 'key' ] = urlencode( $data[ 'key' ] );
$data[ 'media-type' ] = $data[ 'isVideo' ] ? 'video' : 'image';
return $data;
}
/**
* checks if infobox data item is valid hero component data.
* If image is smaller than MINIMAL_HERO_IMG_WIDTH const, doesn't render the hero module.
*
* @param array $item - infobox data item
* @param array $heroData - hero component data
*
* @return bool
*/
public function isValidHeroDataItem( $item, $heroData ) {
$type = $item[ 'type' ];
if ( $type === 'title' && !array_key_exists( 'title', $heroData ) ) {
return true;
}
if ( $type === 'image' && !array_key_exists( 'image', $heroData ) && count( $item[ 'data' ] ) === 1 ) {
$imageWidth = $this->getFileWidth( $item[ 'data' ][ 0 ][ 'name' ] );
if ( $imageWidth >= self::MINIMAL_HERO_IMG_WIDTH ) {
return true;
}
}
return false;
}
/**
* required for testing mobile template rendering
* @return bool
*/
public function isWikiaMobile() {
return \F::app()->checkSkin( 'wikiamobile' );
}
/**
* check if item type is supported and logs unsupported types
*
* @param string $type - template type
* @param array $templates - array of supported templates
*
* @return bool
*/
public function isTypeSupportedInTemplates( $type, $templates ) {
$isValid = true;
if ( !isset( $templates[ $type ] ) ) {
WikiaLogger::instance()->info( self::LOGGER_LABEL, [
'type' => $type
] );
$isValid = false;
}
return $isValid;
}
/**
* return real width of the image.
* @param Title $title
* @return int number
*/
private function getFileWidth( $title ) {
$file = \WikiaFileHelper::getFileFromTitle( $title );
if ( $file ) {
return $file->getWidth();
}
}
/**
* @desc create a thumb of the image from file title.
* @param Title $title
* @return bool|MediaTransformOutput
*/
private function getThumbnail( $title ) {
$file = \WikiaFileHelper::getFileFromTitle( $title );
if ( $file ) {
$size = $this->getImageSizesForThumbnailer( $file );
$thumb = $file->transform( $size );
if ( !is_null( $thumb ) && !$thumb->isError() ) {
return $thumb;
}
}
return false;
}
/**
* @desc get image size to be passed to a thumbnailer.
*
* Return size according to the width and height limitations:
* Height on desktop cannot be bigger than 500px
* Width have to be adjusted to const for mobile or desktop infobox
* if $wgPortableInfoboxCustomImageWidth is set, do not change max height
* and set width to $wgPortableInfoboxCustomImageWidth.
* @param $image
* @return array width and height
*/
public function getImageSizesForThumbnailer( $image ) {
global $wgPortableInfoboxCustomImageWidth;
if ( $this->isWikiaMobile() ) {
$width = self::MOBILE_THUMBNAIL_WIDTH;
$height = null;
} else if ( empty( $wgPortableInfoboxCustomImageWidth ) ) {
$height = min( self::MAX_DESKTOP_THUMBNAIL_HEIGHT, $image->getHeight() );
$width = self::DESKTOP_THUMBNAIL_WIDTH;
} else {
$height = $image->getHeight();
$width = $wgPortableInfoboxCustomImageWidth;
}
return [ 'height' => $height, 'width' => $width ];
}
/**
* @desc if it's not a request from mobile skin and wgPortableInfoboxCustomImageWidth
* is set, the $thumbnail->getWidth() can return some big value - we need
* to adjust it to DESKTOP_THUMBNAIL_WIDTH to look good in the infobox.
* Also, the $height have to be adjusted here to make image look good in infobox.
* @param $thumbnail
* @return array width and height which will be displayed i.e. in the width
* and height properties of the img tag
*/
public function getImageSizesToDisplay( $thumbnail ) {
global $wgPortableInfoboxCustomImageWidth;
if ( !$this->isWikiaMobile() && !empty( $wgPortableInfoboxCustomImageWidth ) ) {
$width = min( self::DESKTOP_THUMBNAIL_WIDTH, $thumbnail->getWidth() );
$height = min( self::MAX_DESKTOP_THUMBNAIL_HEIGHT, $width * $thumbnail->getHeight() / $thumbnail->getWidth());
} else {
$width = $thumbnail->getWidth();
$height = $thumbnail->getHeight();
}
return [ 'height' => $height, 'width' => $width ];
}
}