. */ use Fisharebest\Webtrees\Functions\FunctionsMedia; use Fisharebest\Webtrees\Functions\FunctionsPrintFacts; /** * Class Media - Class that defines a media object */ class Media extends GedcomRecord { const RECORD_TYPE = 'OBJE'; const URL_PREFIX = 'mediaviewer.php?mid='; /** @var string The "TITL" value from the GEDCOM */ private $title = ''; /** @var string The "FILE" value from the GEDCOM */ private $file = ''; /** {@inheritdoc} */ public function __construct($xref, $gedcom, $pending, $tree) { parent::__construct($xref, $gedcom, $pending, $tree); if (preg_match('/\n1 FILE (.+)/', $gedcom . $pending, $match)) { $this->file = $match[1]; } if (preg_match('/\n\d TITL (.+)/', $gedcom . $pending, $match)) { $this->title = $match[1]; } } /** {@inheritdoc} */ protected function canShowByType($access_level) { // Hide media objects if they are attached to private records $linked_ids = Database::prepare( "SELECT l_from FROM `##link` WHERE l_to = ? AND l_file = ?" )->execute(array( $this->xref, $this->tree->getTreeId(), ))->fetchOneColumn(); foreach ($linked_ids as $linked_id) { $linked_record = GedcomRecord::getInstance($linked_id, $this->tree); if ($linked_record && !$linked_record->canShow($access_level)) { return false; } } // ... otherwise apply default behaviour return parent::canShowByType($access_level); } /** {@inheritdoc} */ protected static function fetchGedcomRecord($xref, $tree_id) { return Database::prepare( "SELECT m_gedcom FROM `##media` WHERE m_id = :xref AND m_file = :tree_id" )->execute(array( 'xref' => $xref, 'tree_id' => $tree_id, ))->fetchOne(); } /** * Get the first note attached to this media object * * @return null|string */ public function getNote() { $note = $this->getFirstFact('NOTE'); if ($note) { $text = $note->getValue(); if (preg_match('/^@' . WT_REGEX_XREF . '@$/', $text)) { $text = $note->getTarget()->getNote(); } return $text; } else { return ''; } } /** * Get the main media filename * * @return string */ public function getFilename() { return $this->file; } /** * Get the media's title (name) * * @return string */ public function getTitle() { return $this->title; } /** * Get the filename on the server - for those (very few!) functions which actually * need the filename, such as mediafirewall.php and the PDF reports. * * @param string $which * * @return string */ public function getServerFilename($which = 'main') { $MEDIA_DIRECTORY = $this->tree->getPreference('MEDIA_DIRECTORY'); $THUMBNAIL_WIDTH = $this->tree->getPreference('THUMBNAIL_WIDTH'); if ($this->isExternal() || !$this->file) { // External image, or (in the case of corrupt GEDCOM data) no image at all return $this->file; } elseif ($which == 'main') { // Main image return WT_DATA_DIR . $MEDIA_DIRECTORY . $this->file; } else { // Thumbnail $file = WT_DATA_DIR . $MEDIA_DIRECTORY . 'thumbs/' . $this->file; // Does the thumbnail exist? if (file_exists($file)) { return $file; } // Does a user-generated thumbnail exist? $user_thumb = preg_replace('/\.[a-z0-9]{3,5}$/i', '.png', $file); if (file_exists($user_thumb)) { return $user_thumb; } // Does the folder exist for this thumbnail? if (!is_dir(dirname($file)) && !File::mkdir(dirname($file))) { Log::addMediaLog('The folder ' . dirname($file) . ' could not be created for ' . $this->getXref()); return $file; } // Is there a corresponding main image? $main_file = WT_DATA_DIR . $MEDIA_DIRECTORY . $this->file; if (!file_exists($main_file)) { Log::addMediaLog('The file ' . $main_file . ' does not exist for ' . $this->getXref()); return $file; } // Try to create a thumbnail automatically try { $imgsize = getimagesize($main_file); // Image small enough to be its own thumbnail? if ($imgsize[0] > 0 && $imgsize[0] <= $THUMBNAIL_WIDTH) { try { copy($main_file, $file); Log::addMediaLog('Thumbnail created for ' . $main_file . ' (copy of main image)'); } catch (\ErrorException $ex) { Log::addMediaLog('Thumbnail could not be created for ' . $main_file . ' (copy of main image)'); } } else { if (FunctionsMedia::hasMemoryForImage($main_file)) { try { switch ($imgsize['mime']) { case 'image/png': $main_image = imagecreatefrompng($main_file); break; case 'image/gif': $main_image = imagecreatefromgif($main_file); break; case 'image/jpeg': $main_image = imagecreatefromjpeg($main_file); break; default: return $file; // Nothing else we can do :-( } if ($main_image) { // How big should the thumbnail be? $width = $THUMBNAIL_WIDTH; $height = round($imgsize[1] * ($width / $imgsize[0])); $thumb_image = imagecreatetruecolor($width, $height); // Create a transparent background, instead of the default black one imagesavealpha($thumb_image, true); imagefill($thumb_image, 0, 0, imagecolorallocatealpha($thumb_image, 0, 0, 0, 127)); // Shrink the image imagecopyresampled($thumb_image, $main_image, 0, 0, 0, 0, $width, $height, $imgsize[0], $imgsize[1]); switch ($imgsize['mime']) { case 'image/png': imagepng($thumb_image, $file); break; case 'image/gif': imagegif($thumb_image, $file); break; case 'image/jpeg': imagejpeg($thumb_image, $file); break; } imagedestroy($main_image); imagedestroy($thumb_image); Log::addMediaLog('Thumbnail created for ' . $main_file); } } catch (\ErrorException $ex) { Log::addMediaLog('Failed to create thumbnail for ' . $main_file); } } else { Log::addMediaLog('Not enough memory to create thumbnail for ' . $main_file); } } } catch (\ErrorException $ex) { // Not an image, or not a valid image? } return $file; } } /** * check if the file exists on this server * * @param string $which specify either 'main' or 'thumb' * * @return bool */ public function fileExists($which = 'main') { return file_exists($this->getServerFilename($which)); } /** * Determine if the file is an external url * * @return bool */ public function isExternal() { return strpos($this->file, '://') !== false; } /** * get the media file size in KB * * @param string $which specify either 'main' or 'thumb' * * @return string */ public function getFilesize($which = 'main') { $size = $this->getFilesizeraw($which); // Round up to the nearest KB. $size = (int) (($size + 1023) / 1024); return /* I18N: size of file in KB */ I18N::translate('%s KB', I18N::number($size)); } /** * get the media file size, unformatted * * @param string $which specify either 'main' or 'thumb' * * @return int */ public function getFilesizeraw($which = 'main') { try { return filesize($this->getServerFilename($which)); } catch (\ErrorException $ex) { return 0; } } /** * get filemtime for the media file * * @param string $which specify either 'main' or 'thumb' * * @return int */ public function getFiletime($which = 'main') { try { return filemtime($this->getServerFilename($which)); } catch (\ErrorException $ex) { return 0; } } /** * Generate an etag specific to this media item and the current user * * @param string $which - specify either 'main' or 'thumb' * * @return string */ public function getEtag($which = 'main') { if ($this->isExternal()) { // etag not really defined for external media return ''; } $etag_string = basename($this->getServerFilename($which)) . $this->getFiletime($which) . $this->tree->getName() . Auth::accessLevel($this->tree) . $this->tree->getPreference('SHOW_NO_WATERMARK'); $etag_string = dechex(crc32($etag_string)); return $etag_string; } /** * Deprecated? This does not need to be a function here. * * @return string */ public function getMediaType() { if (preg_match('/\n\d TYPE (.+)/', $this->gedcom, $match)) { return strtolower($match[1]); } else { return ''; } } /** * Is this object marked as a highlighted image? * * @return string */ public function isPrimary() { if (preg_match('/\n\d _PRIM ([YN])/', $this->getGedcom(), $match)) { return $match[1]; } else { return ''; } } /** * get image properties * * @param string $which specify either 'main' or 'thumb' * @param int $addWidth amount to add to width * @param int $addHeight amount to add to height * * @return array */ public function getImageAttributes($which = 'main', $addWidth = 0, $addHeight = 0) { $THUMBNAIL_WIDTH = $this->tree->getPreference('THUMBNAIL_WIDTH'); $var = $which . 'imagesize'; if (!empty($this->$var)) { return $this->$var; } $imgsize = array(); if ($this->fileExists($which)) { try { $imgsize = getimagesize($this->getServerFilename($which)); if (is_array($imgsize) && !empty($imgsize['0'])) { // this is an image $imgsize[0] = $imgsize[0] + 0; $imgsize[1] = $imgsize[1] + 0; $imgsize['adjW'] = $imgsize[0] + $addWidth; // adjusted width $imgsize['adjH'] = $imgsize[1] + $addHeight; // adjusted height $imageTypes = array('', 'GIF', 'JPG', 'PNG', 'SWF', 'PSD', 'BMP', 'TIFF', 'TIFF', 'JPC', 'JP2', 'JPX', 'JB2', 'SWC', 'IFF', 'WBMP', 'XBM'); $imgsize['ext'] = $imageTypes[0 + $imgsize[2]]; // this is for display purposes, always show non-adjusted info $imgsize['WxH'] = /* I18N: image dimensions, width × height */ I18N::translate('%1$s × %2$s pixels', I18N::number($imgsize['0']), I18N::number($imgsize['1'])); $imgsize['imgWH'] = ' width="' . $imgsize['adjW'] . '" height="' . $imgsize['adjH'] . '" '; if (($which == 'thumb') && ($imgsize['0'] > $THUMBNAIL_WIDTH)) { // don’t let large images break the dislay $imgsize['imgWH'] = ' width="' . $THUMBNAIL_WIDTH . '" '; } } } catch (\ErrorException $ex) { // Not an image, or not a valid image? $imgsize = false; } } if (!is_array($imgsize) || empty($imgsize['0'])) { // this is not an image, OR the file doesn’t exist OR it is a url $imgsize[0] = 0; $imgsize[1] = 0; $imgsize['adjW'] = 0; $imgsize['adjH'] = 0; $imgsize['ext'] = ''; $imgsize['mime'] = ''; $imgsize['WxH'] = ''; $imgsize['imgWH'] = ''; if ($this->isExternal()) { // don’t let large external images break the dislay $imgsize['imgWH'] = ' width="' . $THUMBNAIL_WIDTH . '" '; } } if (empty($imgsize['mime'])) { // this is not an image, OR the file doesn’t exist OR it is a url // set file type equal to the file extension - can’t use parse_url because this may not be a full url $exp = explode('?', $this->file); $imgsize['ext'] = strtoupper(pathinfo($exp[0], PATHINFO_EXTENSION)); // all mimetypes we wish to serve with the media firewall must be added to this array. $mime = array( 'DOC' => 'application/msword', 'MOV' => 'video/quicktime', 'MP3' => 'audio/mpeg', 'PDF' => 'application/pdf', 'PPT' => 'application/vnd.ms-powerpoint', 'RTF' => 'text/rtf', 'SID' => 'image/x-mrsid', 'TXT' => 'text/plain', 'XLS' => 'application/vnd.ms-excel', 'WMV' => 'video/x-ms-wmv', ); if (empty($mime[$imgsize['ext']])) { // if we don’t know what the mimetype is, use something ambiguous $imgsize['mime'] = 'application/octet-stream'; if ($this->fileExists($which)) { // alert the admin if we cannot determine the mime type of an existing file // as the media firewall will be unable to serve this file properly Log::addMediaLog('Media Firewall error: >Unknown Mimetype< for file >' . $this->file . '<'); } } else { $imgsize['mime'] = $mime[$imgsize['ext']]; } } $this->$var = $imgsize; return $this->$var; } /** * Generate a URL directly to the media file * * @param string $which * @param bool $download * * @return string */ public function getHtmlUrlDirect($which = 'main', $download = false) { // “cb” is “cache buster”, so clients will make new request if anything significant about the user or the file changes // The extension is there so that image viewers (e.g. colorbox) can do something sensible $thumbstr = ($which == 'thumb') ? '&thumb=1' : ''; $downloadstr = ($download) ? '&dl=1' : ''; return 'mediafirewall.php?mid=' . $this->getXref() . $thumbstr . $downloadstr . '&ged=' . $this->tree->getNameHtml() . '&cb=' . $this->getEtag($which); } /** * What file extension is used by this file? * * @return string */ public function extension() { if (preg_match('/\.([a-zA-Z0-9]+)$/', $this->file, $match)) { return strtolower($match[1]); } else { return ''; } } /** * What is the mime-type of this object? * For simplicity and efficiency, use the extension, rather than the contents. * * @return string */ public function mimeType() { // Themes contain icon definitions for some/all of these mime-types switch ($this->extension()) { case 'bmp': return 'image/bmp'; case 'doc': return 'application/msword'; case 'docx': return 'application/msword'; case 'ged': return 'text/x-gedcom'; case 'gif': return 'image/gif'; case 'htm': return 'text/html'; case 'html': return 'text/html'; case 'jpeg': return 'image/jpeg'; case 'jpg': return 'image/jpeg'; case 'mov': return 'video/quicktime'; case 'mp3': return 'audio/mpeg'; case 'ogv': return 'video/ogg'; case 'pdf': return 'application/pdf'; case 'png': return 'image/png'; case 'rar': return 'application/x-rar-compressed'; case 'swf': return 'application/x-shockwave-flash'; case 'svg': return 'image/svg'; case 'tif': return 'image/tiff'; case 'tiff': return 'image/tiff'; case 'xls': return 'application/vnd-ms-excel'; case 'xlsx': return 'application/vnd-ms-excel'; case 'wmv': return 'video/x-ms-wmv'; case 'zip': return 'application/zip'; default: return 'application/octet-stream'; } } /** * Display an image-thumbnail or a media-icon, and add markup for image viewers such as colorbox. * * @return string */ public function displayImage() { if ($this->isExternal() || !file_exists($this->getServerFilename('thumb'))) { // Use an icon $mime_type = str_replace('/', '-', $this->mimeType()); $image = ''; } else { $imgsize = getimagesize($this->getServerFilename('thumb')); // Use a thumbnail image $image = ''; } return '' . $image . ''; } /** {@inheritdoc} */ public function getFallBackName() { if ($this->canShow()) { return basename($this->file); } else { return $this->getXref(); } } /** {@inheritdoc} */ public function extractNames() { // Earlier gedcom versions had level 1 titles // Later gedcom versions had level 2 titles $this->extractNamesFromFacts(2, 'TITL', $this->getFacts('FILE')); $this->extractNamesFromFacts(1, 'TITL', $this->getFacts('TITL')); } /** {@inheritdoc} */ public function formatListDetails() { ob_start(); FunctionsPrintFacts::printMediaLinks('1 OBJE @' . $this->getXref() . '@', 1); return ob_get_clean(); } }