AbstractOEmbedHelper.php

Go to the documentation of this file.

<?php
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers;
 
use ‪TYPO3\CMS\Core\Resource\Exception\OnlineMediaAlreadyExistsException;
use ‪TYPO3\CMS\Core\Resource\File;
use ‪TYPO3\CMS\Core\Resource\Folder;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
abstract class ‪AbstractOEmbedHelper extends ‪AbstractOnlineMediaHelper
{
    abstract protected function ‪getOEmbedUrl($mediaId, $format = 'json');
 
    protected function ‪transformMediaIdToFile($mediaId, ‪Folder $targetFolder, $fileExtension)
    {
        $file = $this->‪findExistingFileByOnlineMediaId($mediaId, $targetFolder, $fileExtension);
        if ($file !== null) {
            throw new ‪OnlineMediaAlreadyExistsException($file, 1695236851);
        }
        // no existing file create new
        $oEmbed = $this->‪getOEmbedData($mediaId);
        if (!empty($oEmbed['title'])) {
            $fileName = $oEmbed['title'] . '.' . $fileExtension;
        } else {
            $fileName = $mediaId . '.' . $fileExtension;
        }
        return $this->‪createNewFile($targetFolder, $fileName, $mediaId);
    }
 
    protected function ‪getOEmbedData($mediaId)
    {
        $oEmbed = (string)‪GeneralUtility::getUrl(
            $this->‪getOEmbedUrl($mediaId)
        );
        if ($oEmbed !== '') {
            $oEmbed = json_decode($oEmbed, true);
            if (is_array($oEmbed)) {
                return $oEmbed;
            }
        }
        return null;
    }
 
    public function ‪getMetaData(‪File $file)
    {
        $metadata = [];
 
        $oEmbed = $this->‪getOEmbedData($this->‪getOnlineMediaId($file));
 
        if (is_array($oEmbed) && $oEmbed !== []) {
            $metadata['width'] = (int)($oEmbed['width'] ?? 0);
            $metadata['height'] = (int)($oEmbed['height'] ?? 0);
            if (empty($file->‪getProperty('title'))) {
                $metadata['title'] = strip_tags($oEmbed['title'] ?? '');
            }
            $metadata['author'] = $oEmbed['author_name'] ?? '';
        }
 
        return $metadata;
    }
}