. */ /** * 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 integer|null $gedcom_id * @param string|null $gedcom * * @return Source|null */ public static function getInstance($xref, $gedcom_id = WT_GED_ID, $gedcom = null) { $record = parent::getInstance($xref, $gedcom_id, $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); 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, $gedcom_id) { static $statement = null; if ($statement === null) { $statement = Database::prepare("SELECT s_gedcom FROM `##sources` WHERE s_id=? AND s_file=?"); } return $statement->execute(array($xref, $gedcom_id))->fetchOne(); } /** {@inheritdoc} */ public function extractNames() { parent::_extractNames(1, 'TITL', $this->getFacts('TITL')); } }