‪TYPO3CMS  ‪main
AbstractOEmbedHelper.php
Go to the documentation of this file.
1 <?php
2 
3 /*
4  * This file is part of the TYPO3 CMS project.
5  *
6  * It is free software; you can redistribute it and/or modify it under
7  * the terms of the GNU General Public License, either version 2
8  * of the License, or any later version.
9  *
10  * For the full copyright and license information, please read the
11  * LICENSE.txt file that was distributed with this source code.
12  *
13  * The TYPO3 project - inspiring people to share!
14  */
15 
17 
21 
27 {
33  abstract protected function ‪getOEmbedUrl($mediaId, $format = 'json');
34 
42  protected function ‪transformMediaIdToFile($mediaId, ‪Folder $targetFolder, $fileExtension)
43  {
44  $file = $this->‪findExistingFileByOnlineMediaId($mediaId, $targetFolder, $fileExtension);
45 
46  // no existing file create new
47  if ($file === null) {
48  $oEmbed = $this->‪getOEmbedData($mediaId);
49  if (!empty($oEmbed['title'])) {
50  $fileName = $oEmbed['title'] . '.' . $fileExtension;
51  } else {
52  $fileName = $mediaId . '.' . $fileExtension;
53  }
54  $file = $this->‪createNewFile($targetFolder, $fileName, $mediaId);
55  }
56  return $file;
57  }
58 
65  protected function ‪getOEmbedData($mediaId)
66  {
67  $oEmbed = (string)‪GeneralUtility::getUrl(
68  $this->‪getOEmbedUrl($mediaId)
69  );
70  if ($oEmbed !== '') {
71  $oEmbed = json_decode($oEmbed, true);
72  if (is_array($oEmbed)) {
73  return $oEmbed;
74  }
75  }
76  return null;
77  }
78 
85  public function ‪getMetaData(‪File $file)
86  {
87  $metadata = [];
88 
89  $oEmbed = $this->‪getOEmbedData($this->‪getOnlineMediaId($file));
90 
91  if (is_array($oEmbed) && $oEmbed !== []) {
92  $metadata['width'] = (int)$oEmbed['width'];
93  $metadata['height'] = (int)$oEmbed['height'];
94  if (empty($file->‪getProperty('title'))) {
95  $metadata['title'] = strip_tags($oEmbed['title']);
96  }
97  $metadata['author'] = $oEmbed['author_name'];
98  }
99 
100  return $metadata;
101  }
102 }
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOnlineMediaHelper\findExistingFileByOnlineMediaId
‪File null findExistingFileByOnlineMediaId($onlineMediaId, Folder $targetFolder, $fileExtension)
Definition: AbstractOnlineMediaHelper.php:78
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper\getOEmbedUrl
‪string getOEmbedUrl($mediaId, $format='json')
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOnlineMediaHelper\getOnlineMediaId
‪string getOnlineMediaId(File $file)
Definition: AbstractOnlineMediaHelper.php:58
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper\getMetaData
‪array getMetaData(File $file)
Definition: AbstractOEmbedHelper.php:85
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper\getOEmbedData
‪array null getOEmbedData($mediaId)
Definition: AbstractOEmbedHelper.php:65
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper\transformMediaIdToFile
‪File transformMediaIdToFile($mediaId, Folder $targetFolder, $fileExtension)
Definition: AbstractOEmbedHelper.php:42
‪TYPO3\CMS\Core\Utility\GeneralUtility\getUrl
‪static string false getUrl($url)
Definition: GeneralUtility.php:1542
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOnlineMediaHelper
Definition: AbstractOnlineMediaHelper.php:30
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOnlineMediaHelper\createNewFile
‪File createNewFile(Folder $targetFolder, $fileName, $onlineMediaId)
Definition: AbstractOnlineMediaHelper.php:106
‪TYPO3\CMS\Core\Resource\Folder
Definition: Folder.php:37
‪TYPO3\CMS\Core\Resource\File
Definition: File.php:24
‪TYPO3\CMS\Core\Resource\File\getProperty
‪mixed getProperty($key)
Definition: File.php:61
‪TYPO3\CMS\Core\Utility\GeneralUtility
Definition: GeneralUtility.php:51
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers
Definition: AbstractOEmbedHelper.php:16
‪TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper
Definition: AbstractOEmbedHelper.php:27