xref: /webtrees/app/Module/AlbumModule.php (revision f9e6fd40c9b1196453317721786a524f20c06652) 
1<?php
2/**
3 * webtrees: online genealogy
4 * Copyright (C) 2017 webtrees development team
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License
14 * along with this program. If not, see <http://www.gnu.org/licenses/>.
15 */
16namespace Fisharebest\Webtrees\Module;
17
18use Fisharebest\Webtrees\Auth;
19use Fisharebest\Webtrees\I18N;
20use Fisharebest\Webtrees\Media;
21
22/**
23 * Class AlbumModule
24 */
25class AlbumModule extends AbstractModule implements ModuleTabInterface {
26	/** @var Media[] List of media objects. */
27	private $media_list;
28
29	/**
30	 * How should this module be labelled on tabs, menus, etc.?
31	 *
32	 * @return string
33	 */
34	public function getTitle() {
35		return /* I18N: Name of a module */ I18N::translate('Album');
36	}
37
38	/**
39	 * A sentence describing what this module does.
40	 *
41	 * @return string
42	 */
43	public function getDescription() {
44		return /* I18N: Description of the “Album” module */ I18N::translate('An alternative to the “media” tab, and an enhanced image viewer.');
45	}
46
47	/**
48	 * The user can re-arrange the tab order, but until they do, this
49	 * is the order in which tabs are shown.
50	 *
51	 * @return int
52	 */
53	public function defaultTabOrder() {
54		return 60;
55	}
56
57	/**
58	 * Is this tab empty? If so, we don't always need to display it.
59	 *
60	 * @return bool
61	 */
62	public function hasTabContent() {
63		global $WT_TREE;
64
65		return Auth::isEditor($WT_TREE) || $this->getMedia();
66	}
67
68	/**
69	 * A greyed out tab has no actual content, but may perhaps have
70	 * options to create content.
71	 *
72	 * @return bool
73	 */
74	public function isGrayedOut() {
75		return !$this->getMedia();
76	}
77
78	/**
79	 * Generate the HTML content of this tab.
80	 *
81	 * @return string
82	 */
83	public function getTabContent() {
84		global $WT_TREE, $controller;
85
86		$html = '<div id="' . $this->getName() . '_content">';
87		//Show Lightbox-Album header Links
88		if (Auth::isEditor($WT_TREE) && $WT_TREE->getPreference('MEDIA_UPLOAD') >= Auth::accessLevel($WT_TREE)) {
89			$html .= '<div class="descriptionbox">';
90			$html .= '<a href="edit_interface.php?action=add-media-link&amp;ged=' . $controller->record->getTree()->getNameHtml() . '&amp;xref=' . $controller->record->getXref() . '">' . I18N::translate('Add a media object') . '</a>';
91			$html .= '</div>';
92		}
93
94		$html .= '<div class="facts_value">';
95		$html .= '<ul class="album-list">';
96		foreach ($this->getMedia() as $media) {
97			$html .= '<li class="album-list-item">';
98			$html .= '<div class="album-image">' . $media->displayImage(100, 100, 'contain', []) . '</div>';
99			$html .= '<div class="album-title"><a href="' . $media->getXref() . '">' . $media->getFullName() . '</a></div>';
100			$html .= '</li>';
101		}
102		$html .= '</ul>';
103		$html .= '</div>';
104		$html .= '</div>';
105
106		return $html;
107	}
108
109	/**
110	 * Get all facts containing media links for this person and their spouse-family records
111	 *
112	 * @return Media[]
113	 */
114	private function getMedia() {
115		global $controller;
116
117		if ($this->media_list === null) {
118			// Use facts from this individual and all their spouses
119			$facts = $controller->record->getFacts();
120			foreach ($controller->record->getSpouseFamilies() as $family) {
121				foreach ($family->getFacts() as $fact) {
122					$facts[] = $fact;
123				}
124			}
125			// Use all media from each fact
126			$this->media_list = [];
127			foreach ($facts as $fact) {
128				// Don't show pending edits, as the user just sees duplicates
129				if (!$fact->isPendingDeletion()) {
130					preg_match_all('/(?:^1|\n\d) OBJE @(' . WT_REGEX_XREF . ')@/', $fact->getGedcom(), $matches);
131					foreach ($matches[1] as $match) {
132						$media = Media::getInstance($match, $controller->record->getTree());
133						if ($media && $media->canShow()) {
134							$this->media_list[] = $media;
135						}
136					}
137				}
138			}
139			// If a media object is linked twice, only show it once
140			$this->media_list = array_unique($this->media_list);
141			// Sort these using _WT_OBJE_SORT
142			$wt_obje_sort = [];
143			foreach ($controller->record->getFacts('_WT_OBJE_SORT') as $fact) {
144				$wt_obje_sort[] = trim($fact->getValue(), '@');
145			}
146			usort($this->media_list, function (Media $x, Media $y) use ($wt_obje_sort) {
147				return array_search($x->getXref(), $wt_obje_sort) - array_search($y->getXref(), $wt_obje_sort);
148			});
149		}
150
151		return $this->media_list;
152	}
153
154	/**
155	 * Can this tab load asynchronously?
156	 *
157	 * @return bool
158	 */
159	public function canLoadAjax() {
160		return false;
161	}
162
163	/**
164	 * Any content (e.g. Javascript) that needs to be rendered before the tabs.
165	 *
166	 * This function is probably not needed, as there are better ways to achieve this.
167	 *
168	 * @return string
169	 */
170	public function getPreLoadContent() {
171		return '';
172	}
173}
174