. */ /** * Class Source - A GEDCOM source (SOUR) object */ class Source extends GedcomRecord { const RECORD_TYPE = 'SOUR'; const URL_PREFIX = 'source.php?sid='; /** * Get an instance of a source object. For single records, * we just receive the XREF. For bulk records (such as lists * and search results) we can receive the GEDCOM data as well. * * @param string $xref * @param Tree $tree * @param string|null $gedcom * * @return Source|null */ public static function getInstance($xref, Tree $tree, $gedcom = null) { $record = parent::getInstance($xref, $tree, $gedcom); if ($record instanceof Source) { return $record; } else { return null; } } /** {@inheritdoc} */ protected function canShowByType($access_level) { // Hide sources if they are attached to private repositories ... preg_match_all('/\n1 REPO @(.+)@/', $this->gedcom, $matches); foreach ($matches[1] as $match) { $repo = Repository::getInstance($match, $this->tree); if ($repo && !$repo->canShow($access_level)) { return false; } } // ... otherwise apply default behaviour return parent::canShowByType($access_level); } /** {@inheritdoc} */ protected function createPrivateGedcomRecord($access_level) { return '0 @' . $this->xref . "@ SOUR\n1 TITL " . I18N::translate('Private'); } /** {@inheritdoc} */ protected static function fetchGedcomRecord($xref, $tree_id) { return Database::prepare( "SELECT s_gedcom FROM `##sources` WHERE s_id = :xref AND s_file = :tree_id" )->execute(array( 'xref' => $xref, 'tree_id' => $tree_id, ))->fetchOne(); } /** {@inheritdoc} */ public function extractNames() { parent::extractNamesFromFacts(1, 'TITL', $this->getFacts('TITL')); } }