xref: /webtrees/app/Tree.php (revision 4f381cf13570ea4dee2005bf18db82f547158780)
1<?php
2namespace Fisharebest\Webtrees;
3
4/**
5 * webtrees: online genealogy
6 * Copyright (C) 2015 webtrees development team
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation, either version 3 of the License, or
10 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 */
18
19use PDOException;
20
21/**
22 * Class Tree - Provide an interface to the wt_gedcom table
23 */
24class Tree {
25	/** @var integer The tree's ID number */
26	private $tree_id;
27
28	/** @var string The tree's name */
29	private $name;
30
31	/** @var string The tree's title */
32	private $title;
33
34	/** @var integer[] Default access rules for facts in this tree */
35	private $fact_privacy;
36
37	/** @var integer[] Default access rules for individuals in this tree */
38	private $individual_privacy;
39
40	/** @var integer[][] Default access rules for individual facts in this tree */
41	private $individual_fact_privacy;
42
43	/** @var Tree[] All trees that we have permission to see. */
44	private static $trees;
45
46	/** @var string[] Cached copy of the wt_gedcom_setting table. */
47	private $preferences;
48
49	/** @var string[][] Cached copy of the wt_user_gedcom_setting table. */
50	private $user_preferences = array();
51
52	/**
53	 * Create a tree object.  This is a private constructor - it can only
54	 * be called from Tree::getAll() to ensure proper initialisation.
55	 *
56	 * @param integer $tree_id
57	 * @param string  $tree_name
58	 * @param string  $tree_title
59	 */
60	private function __construct($tree_id, $tree_name, $tree_title) {
61		$this->tree_id                 = $tree_id;
62		$this->name                    = $tree_name;
63		$this->title                   = $tree_title;
64		$this->fact_privacy            = array();
65		$this->individual_privacy      = array();
66		$this->individual_fact_privacy = array();
67
68		// Load the privacy settings for this tree
69		$rows = Database::prepare(
70			"SELECT SQL_CACHE xref, tag_type, CASE resn WHEN 'none' THEN :priv_public WHEN 'privacy' THEN :priv_user WHEN 'confidential' THEN :priv_none WHEN 'hidden' THEN :priv_hide END AS resn" .
71			" FROM `##default_resn` WHERE gedcom_id = :tree_id"
72		)->execute(array(
73			'priv_public' => WT_PRIV_PUBLIC,
74			'priv_user'   => WT_PRIV_USER,
75			'priv_none'   => WT_PRIV_NONE,
76			'priv_hide'   => WT_PRIV_HIDE,
77			'tree_id'     => $this->tree_id
78		))->fetchAll();
79
80		foreach ($rows as $row) {
81			if ($row->xref !== null) {
82				if ($row->tag_type !== null) {
83					$this->individual_fact_privacy[$row->xref][$row->tag_type] = (int) $row->resn;
84				} else {
85					$this->individual_privacy[$row->xref] = (int) $row->resn;
86				}
87			} else {
88				$this->fact_privacy[$row->tag_type] = (int) $row->resn;
89			}
90		}
91
92
93	}
94
95	/**
96	 * The ID of this tree
97	 *
98	 * @return integer
99	 */
100	public function getTreeId() {
101		return $this->tree_id;
102	}
103
104	/**
105	 * The name of this tree
106	 *
107	 * @return string
108	 */
109	public function getName() {
110		return $this->name;
111	}
112
113	/**
114	 * The name of this tree
115	 *
116	 * @return string
117	 */
118	public function getNameHtml() {
119		return Filter::escapeHtml($this->name);
120	}
121
122	/**
123	 * The name of this tree
124	 *
125	 * @return string
126	 */
127	public function getNameUrl() {
128		return Filter::escapeUrl($this->name);
129	}
130
131	/**
132	 * The title of this tree
133	 *
134	 * @return string
135	 */
136	public function getTitle() {
137		return $this->title;
138	}
139
140	/**
141	 * The title of this tree, with HTML markup
142	 *
143	 * @return string
144	 */
145	public function getTitleHtml() {
146		return Filter::escapeHtml($this->title);
147	}
148
149	/**
150	 * The fact-level privacy for this tree.
151	 *
152	 * @return integer[]
153	 */
154	public function getFactPrivacy() {
155		return $this->fact_privacy;
156	}
157
158	/**
159	 * The individual-level privacy for this tree.
160	 *
161	 * @return integer[]
162	 */
163	public function getIndividualPrivacy() {
164		return $this->individual_privacy;
165	}
166
167	/**
168	 * The individual-fact-level privacy for this tree.
169	 *
170	 * @return integer[][]
171	 */
172	public function getIndividualFactPrivacy() {
173		return $this->individual_fact_privacy;
174	}
175
176	/**
177	 * Get the tree’s configuration settings.
178	 *
179	 * @param string      $setting_name
180	 * @param string|null $default
181	 *
182	 * @return string|null
183	 */
184	public function getPreference($setting_name, $default = null) {
185		if ($this->preferences === null) {
186			$this->preferences = Database::prepare(
187				"SELECT SQL_CACHE setting_name, setting_value FROM `##gedcom_setting` WHERE gedcom_id = ?"
188			)->execute(array($this->tree_id))->fetchAssoc();
189		}
190
191		if (array_key_exists($setting_name, $this->preferences)) {
192			return $this->preferences[$setting_name];
193		} else {
194			return $default;
195		}
196	}
197
198	/**
199	 * Set the tree’s configuration settings.
200	 *
201	 * @param string $setting_name
202	 * @param string $setting_value
203	 *
204	 * @return $this
205	 */
206	public function setPreference($setting_name, $setting_value) {
207		if ($setting_value !== $this->getPreference($setting_name)) {
208			// Update the database
209			if ($setting_value === null) {
210				Database::prepare(
211					"DELETE FROM `##gedcom_setting` WHERE gedcom_id = :tree_id AND setting_name = :setting_name"
212				)->execute(array(
213					'tree_id'      => $this->tree_id,
214					'setting_name' => $setting_name,
215				));
216			} else {
217				Database::prepare(
218					"REPLACE INTO `##gedcom_setting` (gedcom_id, setting_name, setting_value)" .
219					" VALUES (:tree_id, :setting_name, LEFT(:setting_value, 255))"
220				)->execute(array(
221					'tree_id'       => $this->tree_id,
222					'setting_name'  => $setting_name,
223					'setting_value' => $setting_value,
224				));
225			}
226			// Update our cache
227			$this->preferences[$setting_name] = $setting_value;
228			// Audit log of changes
229			Log::addConfigurationLog('Tree setting "' . $setting_name . '" set to "' . $setting_value . '"', $this);
230		}
231
232		return $this;
233	}
234
235	/**
236	 * Get the tree’s user-configuration settings.
237	 *
238	 * @param User        $user
239	 * @param string      $setting_name
240	 * @param string|null $default
241	 *
242	 * @return string
243	 */
244	public function getUserPreference(User $user, $setting_name, $default = null) {
245		// There are lots of settings, and we need to fetch lots of them on every page
246		// so it is quicker to fetch them all in one go.
247		if (!array_key_exists($user->getUserId(), $this->user_preferences)) {
248			$this->user_preferences[$user->getUserId()] = Database::prepare(
249				"SELECT SQL_CACHE setting_name, setting_value FROM `##user_gedcom_setting` WHERE user_id = ? AND gedcom_id = ?"
250			)->execute(array($user->getUserId(), $this->tree_id))->fetchAssoc();
251		}
252
253		if (array_key_exists($setting_name, $this->user_preferences[$user->getUserId()])) {
254			return $this->user_preferences[$user->getUserId()][$setting_name];
255		} else {
256			return $default;
257		}
258	}
259
260	/**
261	 * Set the tree’s user-configuration settings.
262	 *
263	 * @param User    $user
264	 * @param string  $setting_name
265	 * @param string  $setting_value
266	 *
267	 * @return $this
268	 */
269	public function setUserPreference(User $user, $setting_name, $setting_value) {
270		if ($this->getUserPreference($user, $setting_name) !== $setting_value) {
271			// Update the database
272			if ($setting_value === null) {
273				Database::prepare(
274					"DELETE FROM `##user_gedcom_setting` WHERE gedcom_id = :tree_id AND user_id = :user_id AND setting_name = :setting_name"
275				)->execute(array(
276					'tree_id'      => $this->tree_id,
277					'user_id'      => $user->getUserId(),
278					'setting_name' => $setting_name,
279				));
280			} else {
281				Database::prepare(
282					"REPLACE INTO `##user_gedcom_setting` (user_id, gedcom_id, setting_name, setting_value) VALUES (:user_id, :tree_id, :setting_name, LEFT(:setting_value, 255))"
283				)->execute(array(
284					'user_id'       => $user->getUserId(),
285					'tree_id'       => $this->tree_id,
286					'setting_name'  => $setting_name,
287					'setting_value' => $setting_value
288				));
289			}
290			// Update our cache
291			$this->user_preferences[$user->getUserId()][$setting_name] = $setting_value;
292			// Audit log of changes
293			Log::addConfigurationLog('Tree setting "' . $setting_name . '" set to "' . $setting_value . '" for user "' . $user->getUserName() . '"', $this);
294		}
295
296		return $this;
297	}
298
299	/**
300	 * Can a user accept changes for this tree?
301	 *
302	 * @param User $user
303	 *
304	 * @return boolean
305	 */
306	public function canAcceptChanges(User $user) {
307		return Auth::isModerator($this, $user);
308	}
309
310	/**
311	 * Fetch all the trees that we have permission to access.
312	 *
313	 * @return Tree[]
314	 */
315	public static function getAll() {
316		if (self::$trees === null) {
317			self::$trees = array();
318			$rows = Database::prepare(
319				"SELECT SQL_CACHE g.gedcom_id AS tree_id, g.gedcom_name AS tree_name, gs1.setting_value AS tree_title" .
320				" FROM `##gedcom` g" .
321				" LEFT JOIN `##gedcom_setting`      gs1 ON (g.gedcom_id=gs1.gedcom_id AND gs1.setting_name='title')" .
322				" LEFT JOIN `##gedcom_setting`      gs2 ON (g.gedcom_id=gs2.gedcom_id AND gs2.setting_name='imported')" .
323				" LEFT JOIN `##gedcom_setting`      gs3 ON (g.gedcom_id=gs3.gedcom_id AND gs3.setting_name='REQUIRE_AUTHENTICATION')" .
324				" LEFT JOIN `##user_gedcom_setting` ugs ON (g.gedcom_id=ugs.gedcom_id AND ugs.setting_name='canedit' AND ugs.user_id=?)" .
325				" WHERE " .
326				"  g.gedcom_id>0 AND (" . // exclude the "template" tree
327				"    EXISTS (SELECT 1 FROM `##user_setting` WHERE user_id=? AND setting_name='canadmin' AND setting_value=1)" . // Admin sees all
328				"   ) OR (" .
329				"    gs2.setting_value = 1 AND (" . // Allow imported trees, with either:
330				"     gs3.setting_value <> 1 OR" . // visitor access
331				"     IFNULL(ugs.setting_value, 'none')<>'none'" . // explicit access
332				"   )" .
333				"  )" .
334				" ORDER BY g.sort_order, 3"
335			)->execute(array(Auth::id(), Auth::id()))->fetchAll();
336			foreach ($rows as $row) {
337				self::$trees[$row->tree_id] = new self($row->tree_id, $row->tree_name, $row->tree_title);
338			}
339		}
340
341		return self::$trees;
342	}
343
344	/**
345	 * Get the tree with a specific ID.
346	 *
347	 * @param integer $tree_id
348	 *
349	 * @return Tree
350	 */
351	public static function get($tree_id) {
352		$trees = self::getAll();
353
354		return $trees[$tree_id];
355	}
356
357	/**
358	 * Create arguments to select_edit_control()
359	 * Note - these will be escaped later
360	 *
361	 * @return string[]
362	 */
363	public static function getIdList() {
364		$list = array();
365		foreach (self::getAll() as $tree) {
366			$list[$tree->tree_id] = $tree->title;
367		}
368
369		return $list;
370	}
371
372	/**
373	 * Create arguments to select_edit_control()
374	 * Note - these will be escaped later
375	 *
376	 * @return string[]
377	 */
378	public static function getNameList() {
379		$list = array();
380		foreach (self::getAll() as $tree) {
381			$list[$tree->name] = $tree->title;
382		}
383
384		return $list;
385	}
386
387	/**
388	 * Find the ID number for a tree name
389	 *
390	 * @param integer $tree_name
391	 *
392	 * @return integer|null
393	 */
394	public static function getIdFromName($tree_name) {
395		foreach (self::getAll() as $tree_id => $tree) {
396			if ($tree->name == $tree_name) {
397				return $tree_id;
398			}
399		}
400
401		return null;
402	}
403
404	/**
405	 * Find the tree name from a numeric ID.
406	 * @param integer $tree_id
407	 *
408	 * @return string
409	 */
410	public static function getNameFromId($tree_id) {
411		return self::get($tree_id)->name;
412	}
413
414	/**
415	 * Create a new tree
416	 *
417	 * @param string $tree_name
418	 * @param string $tree_title
419	 *
420	 * @return Tree
421	 */
422	public static function create($tree_name, $tree_title) {
423		try {
424			// Create a new tree
425			Database::prepare(
426				"INSERT INTO `##gedcom` (gedcom_name) VALUES (?)"
427			)->execute(array($tree_name));
428			$tree_id = Database::prepare("SELECT LAST_INSERT_ID()")->fetchOne();
429		} catch (PDOException $ex) {
430			// A tree with that name already exists?
431			return self::get(self::getIdFromName($tree_name));
432		}
433
434		// Update the list of trees - to include this new one
435		self::$trees = null;
436		$tree        = self::get($tree_id);
437
438		$tree->setPreference('imported', '0');
439		$tree->setPreference('title', $tree_title);
440
441		// Module privacy
442		Module::setDefaultAccess($tree_id);
443
444		// Gedcom and privacy settings
445		$tree->setPreference('ADVANCED_NAME_FACTS', 'NICK,_AKA');
446		$tree->setPreference('ADVANCED_PLAC_FACTS', '');
447		$tree->setPreference('ALLOW_THEME_DROPDOWN', '1');
448		$tree->setPreference('CALENDAR_FORMAT', 'gregorian');
449		$tree->setPreference('CHART_BOX_TAGS', '');
450		$tree->setPreference('COMMON_NAMES_ADD', '');
451		$tree->setPreference('COMMON_NAMES_REMOVE', '');
452		$tree->setPreference('COMMON_NAMES_THRESHOLD', '40');
453		$tree->setPreference('CONTACT_USER_ID', Auth::id());
454		$tree->setPreference('DEFAULT_PEDIGREE_GENERATIONS', '4');
455		$tree->setPreference('EXPAND_RELATIVES_EVENTS', '0');
456		$tree->setPreference('EXPAND_SOURCES', '0');
457		$tree->setPreference('FAM_FACTS_ADD', 'CENS,MARR,RESI,SLGS,MARR_CIVIL,MARR_RELIGIOUS,MARR_PARTNERS,RESN');
458		$tree->setPreference('FAM_FACTS_QUICK', 'MARR,DIV,_NMR');
459		$tree->setPreference('FAM_FACTS_UNIQUE', 'NCHI,MARL,DIV,ANUL,DIVF,ENGA,MARB,MARC,MARS');
460		$tree->setPreference('FAM_ID_PREFIX', 'F');
461		$tree->setPreference('FORMAT_TEXT', 'markdown');
462		$tree->setPreference('FULL_SOURCES', '0');
463		$tree->setPreference('GEDCOM_ID_PREFIX', 'I');
464		$tree->setPreference('GEDCOM_MEDIA_PATH', '');
465		$tree->setPreference('GENERATE_UIDS', '0');
466		$tree->setPreference('HIDE_GEDCOM_ERRORS', '1');
467		$tree->setPreference('HIDE_LIVE_PEOPLE', '1');
468		$tree->setPreference('INDI_FACTS_ADD', 'AFN,BIRT,DEAT,BURI,CREM,ADOP,BAPM,BARM,BASM,BLES,CHRA,CONF,FCOM,ORDN,NATU,EMIG,IMMI,CENS,PROB,WILL,GRAD,RETI,DSCR,EDUC,IDNO,NATI,NCHI,NMR,OCCU,PROP,RELI,RESI,SSN,TITL,BAPL,CONL,ENDL,SLGC,_MILI,ASSO,RESN');
469		$tree->setPreference('INDI_FACTS_QUICK', 'BIRT,BURI,BAPM,CENS,DEAT,OCCU,RESI');
470		$tree->setPreference('INDI_FACTS_UNIQUE', '');
471		$tree->setPreference('KEEP_ALIVE_YEARS_BIRTH', '');
472		$tree->setPreference('KEEP_ALIVE_YEARS_DEATH', '');
473		$tree->setPreference('LANGUAGE', WT_LOCALE); // Default to the current admin’s language
474		$tree->setPreference('MAX_ALIVE_AGE', 120);
475		$tree->setPreference('MAX_DESCENDANCY_GENERATIONS', '15');
476		$tree->setPreference('MAX_PEDIGREE_GENERATIONS', '10');
477		$tree->setPreference('MEDIA_DIRECTORY', 'media/');
478		$tree->setPreference('MEDIA_ID_PREFIX', 'M');
479		$tree->setPreference('MEDIA_UPLOAD', WT_PRIV_USER);
480		$tree->setPreference('META_DESCRIPTION', '');
481		$tree->setPreference('META_TITLE', WT_WEBTREES);
482		$tree->setPreference('NOTE_FACTS_ADD', 'SOUR,RESN');
483		$tree->setPreference('NOTE_FACTS_QUICK', '');
484		$tree->setPreference('NOTE_FACTS_UNIQUE', '');
485		$tree->setPreference('NOTE_ID_PREFIX', 'N');
486		$tree->setPreference('NO_UPDATE_CHAN', '0');
487		$tree->setPreference('PEDIGREE_FULL_DETAILS', '1');
488		$tree->setPreference('PEDIGREE_LAYOUT', '1');
489		$tree->setPreference('PEDIGREE_ROOT_ID', '');
490		$tree->setPreference('PEDIGREE_SHOW_GENDER', '0');
491		$tree->setPreference('PREFER_LEVEL2_SOURCES', '1');
492		$tree->setPreference('QUICK_REQUIRED_FACTS', 'BIRT,DEAT');
493		$tree->setPreference('QUICK_REQUIRED_FAMFACTS', 'MARR');
494		$tree->setPreference('REPO_FACTS_ADD', 'PHON,EMAIL,FAX,WWW,RESN');
495		$tree->setPreference('REPO_FACTS_QUICK', '');
496		$tree->setPreference('REPO_FACTS_UNIQUE', 'NAME,ADDR');
497		$tree->setPreference('REPO_ID_PREFIX', 'R');
498		$tree->setPreference('REQUIRE_AUTHENTICATION', '0');
499		$tree->setPreference('SAVE_WATERMARK_IMAGE', '0');
500		$tree->setPreference('SAVE_WATERMARK_THUMB', '0');
501		$tree->setPreference('SHOW_AGE_DIFF', '0');
502		$tree->setPreference('SHOW_COUNTER', '1');
503		$tree->setPreference('SHOW_DEAD_PEOPLE', WT_PRIV_PUBLIC);
504		$tree->setPreference('SHOW_EST_LIST_DATES', '0');
505		$tree->setPreference('SHOW_FACT_ICONS', '1');
506		$tree->setPreference('SHOW_GEDCOM_RECORD', '0');
507		$tree->setPreference('SHOW_HIGHLIGHT_IMAGES', '1');
508		$tree->setPreference('SHOW_LDS_AT_GLANCE', '0');
509		$tree->setPreference('SHOW_LEVEL2_NOTES', '1');
510		$tree->setPreference('SHOW_LIVING_NAMES', WT_PRIV_USER);
511		$tree->setPreference('SHOW_MEDIA_DOWNLOAD', '0');
512		$tree->setPreference('SHOW_NO_WATERMARK', WT_PRIV_USER);
513		$tree->setPreference('SHOW_PARENTS_AGE', '1');
514		$tree->setPreference('SHOW_PEDIGREE_PLACES', '9');
515		$tree->setPreference('SHOW_PEDIGREE_PLACES_SUFFIX', '0');
516		$tree->setPreference('SHOW_PRIVATE_RELATIONSHIPS', '1');
517		$tree->setPreference('SHOW_RELATIVES_EVENTS', '_BIRT_CHIL,_BIRT_SIBL,_MARR_CHIL,_MARR_PARE,_DEAT_CHIL,_DEAT_PARE,_DEAT_GPAR,_DEAT_SIBL,_DEAT_SPOU');
518		$tree->setPreference('SHOW_STATS', '0');
519		$tree->setPreference('SOURCE_ID_PREFIX', 'S');
520		$tree->setPreference('SOUR_FACTS_ADD', 'NOTE,REPO,SHARED_NOTE,RESN');
521		$tree->setPreference('SOUR_FACTS_QUICK', 'TEXT,NOTE,REPO');
522		$tree->setPreference('SOUR_FACTS_UNIQUE', 'AUTH,ABBR,TITL,PUBL,TEXT');
523		$tree->setPreference('SUBLIST_TRIGGER_I', '200');
524		$tree->setPreference('SURNAME_LIST_STYLE', 'style2');
525		switch (WT_LOCALE) {
526		case 'es':
527			$tree->setPreference('SURNAME_TRADITION', 'spanish');
528			break;
529		case 'is':
530			$tree->setPreference('SURNAME_TRADITION', 'icelandic');
531			break;
532		case 'lt':
533			$tree->setPreference('SURNAME_TRADITION', 'lithuanian');
534			break;
535		case 'pl':
536			$tree->setPreference('SURNAME_TRADITION', 'polish');
537			break;
538		case 'pt':
539		case 'pt-BR':
540			$tree->setPreference('SURNAME_TRADITION', 'portuguese');
541			break;
542		default:
543			$tree->setPreference('SURNAME_TRADITION', 'paternal');
544			break;
545		}
546		$tree->setPreference('THEME_DIR', 'webtrees');
547		$tree->setPreference('THUMBNAIL_WIDTH', '100');
548		$tree->setPreference('USE_RIN', '0');
549		$tree->setPreference('USE_SILHOUETTE', '1');
550		$tree->setPreference('WATERMARK_THUMB', '0');
551		$tree->setPreference('WEBMASTER_USER_ID', Auth::id());
552		$tree->setPreference('WEBTREES_EMAIL', '');
553		$tree->setPreference('WORD_WRAPPED_NOTES', '0');
554
555		// Default restriction settings
556		$statement = Database::prepare(
557			"INSERT INTO `##default_resn` (gedcom_id, xref, tag_type, resn) VALUES (?, NULL, ?, ?)"
558		);
559		$statement->execute(array($tree_id, 'SSN', 'confidential'));
560		$statement->execute(array($tree_id, 'SOUR', 'privacy'));
561		$statement->execute(array($tree_id, 'REPO', 'privacy'));
562		$statement->execute(array($tree_id, 'SUBM', 'confidential'));
563		$statement->execute(array($tree_id, 'SUBN', 'confidential'));
564
565		// Genealogy data
566		// It is simpler to create a temporary/unimported GEDCOM than to populate all the tables...
567		$john_doe = /* I18N: This should be a common/default/placeholder name of an individual.  Put slashes around the surname. */
568			I18N::translate('John /DOE/');
569		$note     = I18N::translate('Edit this individual and replace their details with your own');
570		Database::prepare("INSERT INTO `##gedcom_chunk` (gedcom_id, chunk_data) VALUES (?, ?)")->execute(array(
571			$tree_id,
572			"0 HEAD\n1 CHAR UTF-8\n0 @I1@ INDI\n1 NAME {$john_doe}\n1 SEX M\n1 BIRT\n2 DATE 01 JAN 1850\n2 NOTE {$note}\n0 TRLR\n"
573		));
574
575		// Set the initial blocks
576		Database::prepare(
577			"INSERT INTO `##block` (gedcom_id, location, block_order, module_name)" .
578			" SELECT ?, location, block_order, module_name" .
579			" FROM `##block`" .
580			" WHERE gedcom_id = -1"
581		)->execute(array($tree_id));
582
583		// Update our cache
584		self::$trees[$tree->tree_id] = $tree;
585
586		return $tree;
587	}
588
589	/**
590	 * Delete all the genealogy data from a tree - in preparation for importing
591	 * new data.  Optionally retain the media data, for when the user has been
592	 * editing their data offline using an application which deletes (or does not
593	 * support) media data.
594	 *
595	 * @param bool $keep_media
596	 */
597	public function deleteGenealogyData($keep_media) {
598		Database::prepare("DELETE FROM `##gedcom_chunk` WHERE gedcom_id = ?")->execute(array($this->tree_id));
599		Database::prepare("DELETE FROM `##individuals`  WHERE i_file    = ?")->execute(array($this->tree_id));
600		Database::prepare("DELETE FROM `##families`     WHERE f_file    = ?")->execute(array($this->tree_id));
601		Database::prepare("DELETE FROM `##sources`      WHERE s_file    = ?")->execute(array($this->tree_id));
602		Database::prepare("DELETE FROM `##other`        WHERE o_file    = ?")->execute(array($this->tree_id));
603		Database::prepare("DELETE FROM `##places`       WHERE p_file    = ?")->execute(array($this->tree_id));
604		Database::prepare("DELETE FROM `##placelinks`   WHERE pl_file   = ?")->execute(array($this->tree_id));
605		Database::prepare("DELETE FROM `##name`         WHERE n_file    = ?")->execute(array($this->tree_id));
606		Database::prepare("DELETE FROM `##dates`        WHERE d_file    = ?")->execute(array($this->tree_id));
607		Database::prepare("DELETE FROM `##change`       WHERE gedcom_id = ?")->execute(array($this->tree_id));
608
609		if ($keep_media) {
610			Database::prepare("DELETE FROM `##link` WHERE l_file =? AND l_type<>'OBJE'")->execute(array($this->tree_id));
611		} else {
612			Database::prepare("DELETE FROM `##link`  WHERE l_file =?")->execute(array($this->tree_id));
613			Database::prepare("DELETE FROM `##media` WHERE m_file =?")->execute(array($this->tree_id));
614		}
615	}
616
617	/**
618	 * Delete everything relating to a tree
619	 */
620	public function delete() {
621		// If this is the default tree, then unset it
622		if (Site::getPreference('DEFAULT_GEDCOM') === self::getNameFromId($this->tree_id)) {
623			Site::setPreference('DEFAULT_GEDCOM', '');
624		}
625
626		$this->deleteGenealogyData(false);
627
628		Database::prepare("DELETE `##block_setting` FROM `##block_setting` JOIN `##block` USING (block_id) WHERE gedcom_id=?")->execute(array($this->tree_id));
629		Database::prepare("DELETE FROM `##block`               WHERE gedcom_id = ?")->execute(array($this->tree_id));
630		Database::prepare("DELETE FROM `##user_gedcom_setting` WHERE gedcom_id = ?")->execute(array($this->tree_id));
631		Database::prepare("DELETE FROM `##gedcom_setting`      WHERE gedcom_id = ?")->execute(array($this->tree_id));
632		Database::prepare("DELETE FROM `##module_privacy`      WHERE gedcom_id = ?")->execute(array($this->tree_id));
633		Database::prepare("DELETE FROM `##next_id`             WHERE gedcom_id = ?")->execute(array($this->tree_id));
634		Database::prepare("DELETE FROM `##hit_counter`         WHERE gedcom_id = ?")->execute(array($this->tree_id));
635		Database::prepare("DELETE FROM `##default_resn`        WHERE gedcom_id = ?")->execute(array($this->tree_id));
636		Database::prepare("DELETE FROM `##gedcom_chunk`        WHERE gedcom_id = ?")->execute(array($this->tree_id));
637		Database::prepare("DELETE FROM `##log`                 WHERE gedcom_id = ?")->execute(array($this->tree_id));
638		Database::prepare("DELETE FROM `##gedcom`              WHERE gedcom_id = ?")->execute(array($this->tree_id));
639
640		// After updating the database, we need to fetch a new (sorted) copy
641		self::$trees = null;
642	}
643
644	/**
645	 * Export the tree to a GEDCOM file
646	 *
647	 * @param $gedcom_file
648	 *
649	 * @return bool
650	 */
651	public function exportGedcom($gedcom_file) {
652		// To avoid partial trees on timeout/diskspace/etc, write to a temporary file first
653		$tmp_file = $gedcom_file . '.tmp';
654
655		$file_pointer = @fopen($tmp_file, 'w');
656		if ($file_pointer === false) {
657			return false;
658		}
659
660		$buffer = reformat_record_export(gedcom_header($this->name));
661
662		$stmt = Database::prepare(
663			"SELECT i_gedcom AS gedcom FROM `##individuals` WHERE i_file = ?" .
664			" UNION ALL " .
665			"SELECT f_gedcom AS gedcom FROM `##families`    WHERE f_file = ?" .
666			" UNION ALL " .
667			"SELECT s_gedcom AS gedcom FROM `##sources`     WHERE s_file = ?" .
668			" UNION ALL " .
669			"SELECT o_gedcom AS gedcom FROM `##other`       WHERE o_file = ? AND o_type NOT IN ('HEAD', 'TRLR')" .
670			" UNION ALL " .
671			"SELECT m_gedcom AS gedcom FROM `##media`       WHERE m_file = ?"
672		)->execute(array($this->tree_id, $this->tree_id, $this->tree_id, $this->tree_id, $this->tree_id));
673
674		while ($row = $stmt->fetch()) {
675			$buffer .= reformat_record_export($row->gedcom);
676			if (strlen($buffer) > 65535) {
677				fwrite($file_pointer, $buffer);
678				$buffer = '';
679			}
680		}
681
682		fwrite($file_pointer, $buffer . '0 TRLR' . WT_EOL);
683		fclose($file_pointer);
684
685		return @rename($tmp_file, $gedcom_file);
686	}
687
688	/**
689	 * Import data from a gedcom file into this tree.
690	 *
691	 * @param string  $path       The full path to the (possibly temporary) file.
692	 * @param string  $filename   The preferred filename, for export/download.
693	 * @param boolean $keep_media Whether to retain any existing media records
694	 *
695	 * @throws \Exception
696	 */
697	public function importGedcomFile($path, $filename, $keep_media) {
698		// Read the file in blocks of roughly 64K.  Ensure that each block
699		// contains complete gedcom records.  This will ensure we don’t split
700		// multi-byte characters, as well as simplifying the code to import
701		// each block.
702
703		$file_data = '';
704		$fp = fopen($path, 'rb');
705
706		// Don’t allow the user to cancel the request.  We do not want to be left with an incomplete transaction.
707		ignore_user_abort(true);
708
709		Database::beginTransaction();
710		$this->deleteGenealogyData($keep_media);
711		$this->setPreference('gedcom_filename', $filename);
712		$this->setPreference('imported', '0');
713
714		while (!feof($fp)) {
715			$file_data .= fread($fp, 65536);
716			// There is no strrpos() function that searches for substrings :-(
717			for ($pos = strlen($file_data) - 1; $pos > 0; --$pos) {
718				if ($file_data[$pos] === '0' && ($file_data[$pos - 1] === "\n" || $file_data[$pos - 1] === "\r")) {
719					// We’ve found the last record boundary in this chunk of data
720					break;
721				}
722			}
723			if ($pos) {
724				Database::prepare(
725					"INSERT INTO `##gedcom_chunk` (gedcom_id, chunk_data) VALUES (?, ?)"
726				)->execute(array($this->tree_id, substr($file_data, 0, $pos)));
727				$file_data = substr($file_data, $pos);
728			}
729		}
730		Database::prepare(
731			"INSERT INTO `##gedcom_chunk` (gedcom_id, chunk_data) VALUES (?, ?)"
732		)->execute(array($this->tree_id, $file_data));
733
734		Database::commit();
735		fclose($fp);
736	}
737}
738