xref: /webtrees/app/Statistics/Repository/GedcomRepository.php (revision 89f7189b61a494347591c99bdb92afb7d8b66e1b)
18add1155SRico Sonntag<?php
23976b470SGreg Roach
38add1155SRico Sonntag/**
48add1155SRico Sonntag * webtrees: online genealogy
5*89f7189bSGreg Roach * Copyright (C) 2021 webtrees development team
68add1155SRico Sonntag * This program is free software: you can redistribute it and/or modify
78add1155SRico Sonntag * it under the terms of the GNU General Public License as published by
88add1155SRico Sonntag * the Free Software Foundation, either version 3 of the License, or
98add1155SRico Sonntag * (at your option) any later version.
108add1155SRico Sonntag * This program is distributed in the hope that it will be useful,
118add1155SRico Sonntag * but WITHOUT ANY WARRANTY; without even the implied warranty of
128add1155SRico Sonntag * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
138add1155SRico Sonntag * GNU General Public License for more details.
148add1155SRico Sonntag * You should have received a copy of the GNU General Public License
15*89f7189bSGreg Roach * along with this program. If not, see <https://www.gnu.org/licenses/>.
168add1155SRico Sonntag */
17fcfa147eSGreg Roach
188add1155SRico Sonntagdeclare(strict_types=1);
198add1155SRico Sonntag
208add1155SRico Sonntagnamespace Fisharebest\Webtrees\Statistics\Repository;
218add1155SRico Sonntag
228fd23e11SGreg Roachuse Fisharebest\Webtrees\Carbon;
23820b62dfSGreg Roachuse Fisharebest\Webtrees\Fact;
246b9cb339SGreg Roachuse Fisharebest\Webtrees\Registry;
251635452cSGreg Roachuse Fisharebest\Webtrees\Header;
268add1155SRico Sonntaguse Fisharebest\Webtrees\Statistics\Repository\Interfaces\GedcomRepositoryInterface;
278add1155SRico Sonntaguse Fisharebest\Webtrees\Tree;
288add1155SRico Sonntaguse Illuminate\Database\Capsule\Manager as DB;
298add1155SRico Sonntag
30dec352c1SGreg Roachuse function str_contains;
31dec352c1SGreg Roach
328add1155SRico Sonntag/**
338add1155SRico Sonntag * A repository providing methods for GEDCOM related statistics.
348add1155SRico Sonntag */
358add1155SRico Sonntagclass GedcomRepository implements GedcomRepositoryInterface
368add1155SRico Sonntag{
378add1155SRico Sonntag    /**
388add1155SRico Sonntag     * @var Tree
398add1155SRico Sonntag     */
408add1155SRico Sonntag    private $tree;
418add1155SRico Sonntag
428add1155SRico Sonntag    /**
438add1155SRico Sonntag     * Constructor.
448add1155SRico Sonntag     *
458add1155SRico Sonntag     * @param Tree $tree
468add1155SRico Sonntag     */
478add1155SRico Sonntag    public function __construct(Tree $tree)
488add1155SRico Sonntag    {
498add1155SRico Sonntag        $this->tree = $tree;
508add1155SRico Sonntag    }
518add1155SRico Sonntag
528add1155SRico Sonntag    /**
538add1155SRico Sonntag     * Get information from the GEDCOM's HEAD record.
548add1155SRico Sonntag     *
558add1155SRico Sonntag     * @return string[]
568add1155SRico Sonntag     */
578add1155SRico Sonntag    private function gedcomHead(): array
588add1155SRico Sonntag    {
598add1155SRico Sonntag        $title   = '';
608add1155SRico Sonntag        $version = '';
618add1155SRico Sonntag        $source  = '';
628add1155SRico Sonntag
636b9cb339SGreg Roach        $head = Registry::headerFactory()->make('HEAD', $this->tree);
648add1155SRico Sonntag
651635452cSGreg Roach        if ($head instanceof Header) {
66820b62dfSGreg Roach            $sour = $head->facts(['SOUR'])->first();
678add1155SRico Sonntag
68820b62dfSGreg Roach            if ($sour instanceof Fact) {
698add1155SRico Sonntag                $source  = $sour->value();
708add1155SRico Sonntag                $title   = $sour->attribute('NAME');
718add1155SRico Sonntag                $version = $sour->attribute('VERS');
728add1155SRico Sonntag            }
738add1155SRico Sonntag        }
748add1155SRico Sonntag
758add1155SRico Sonntag        return [
768add1155SRico Sonntag            $title,
778add1155SRico Sonntag            $version,
788add1155SRico Sonntag            $source,
798add1155SRico Sonntag        ];
808add1155SRico Sonntag    }
818add1155SRico Sonntag
828add1155SRico Sonntag    /**
830dcd9387SGreg Roach     * @return string
848add1155SRico Sonntag     */
858add1155SRico Sonntag    public function gedcomFilename(): string
868add1155SRico Sonntag    {
878add1155SRico Sonntag        return $this->tree->name();
888add1155SRico Sonntag    }
898add1155SRico Sonntag
908add1155SRico Sonntag    /**
910dcd9387SGreg Roach     * @return int
928add1155SRico Sonntag     */
938add1155SRico Sonntag    public function gedcomId(): int
948add1155SRico Sonntag    {
958add1155SRico Sonntag        return $this->tree->id();
968add1155SRico Sonntag    }
978add1155SRico Sonntag
988add1155SRico Sonntag    /**
990dcd9387SGreg Roach     * @return string
1008add1155SRico Sonntag     */
1018add1155SRico Sonntag    public function gedcomTitle(): string
1028add1155SRico Sonntag    {
1038add1155SRico Sonntag        return e($this->tree->title());
1048add1155SRico Sonntag    }
1058add1155SRico Sonntag
1068add1155SRico Sonntag    /**
1070dcd9387SGreg Roach     * @return string
1088add1155SRico Sonntag     */
1098add1155SRico Sonntag    public function gedcomCreatedSoftware(): string
1108add1155SRico Sonntag    {
1118add1155SRico Sonntag        return $this->gedcomHead()[0];
1128add1155SRico Sonntag    }
1138add1155SRico Sonntag
1148add1155SRico Sonntag    /**
1150dcd9387SGreg Roach     * @return string
1168add1155SRico Sonntag     */
1178add1155SRico Sonntag    public function gedcomCreatedVersion(): string
1188add1155SRico Sonntag    {
1198add1155SRico Sonntag        $head = $this->gedcomHead();
1208add1155SRico Sonntag
1218add1155SRico Sonntag        // Fix broken version string in Family Tree Maker
122dec352c1SGreg Roach        if (str_contains($head[1], 'Family Tree Maker ')) {
1238add1155SRico Sonntag            $p       = strpos($head[1], '(') + 1;
1248add1155SRico Sonntag            $p2      = strpos($head[1], ')');
1258add1155SRico Sonntag            $head[1] = substr($head[1], $p, $p2 - $p);
1268add1155SRico Sonntag        }
1278add1155SRico Sonntag
1288add1155SRico Sonntag        // Fix EasyTree version
1298add1155SRico Sonntag        if ($head[2] === 'EasyTree') {
1308add1155SRico Sonntag            $head[1] = substr($head[1], 1);
1318add1155SRico Sonntag        }
1328add1155SRico Sonntag
1338add1155SRico Sonntag        return $head[1];
1348add1155SRico Sonntag    }
1358add1155SRico Sonntag
1368add1155SRico Sonntag    /**
1370dcd9387SGreg Roach     * @return string
1380dcd9387SGreg Roach     * @throws \Exception
1398add1155SRico Sonntag     */
1408add1155SRico Sonntag    public function gedcomDate(): string
1418add1155SRico Sonntag    {
1426b9cb339SGreg Roach        $head = Registry::headerFactory()->make('HEAD', $this->tree);
1438add1155SRico Sonntag
1441635452cSGreg Roach        if ($head instanceof Header) {
145820b62dfSGreg Roach            $fact = $head->facts(['DATE'])->first();
1468add1155SRico Sonntag
147820b62dfSGreg Roach            if ($fact instanceof Fact) {
1488fd23e11SGreg Roach                return Carbon::make($fact->value())->local()->isoFormat('LL');
1498add1155SRico Sonntag            }
1508add1155SRico Sonntag        }
1518add1155SRico Sonntag
1528add1155SRico Sonntag        return '';
1538add1155SRico Sonntag    }
1548add1155SRico Sonntag
1558add1155SRico Sonntag    /**
1560dcd9387SGreg Roach     * @return string
1578add1155SRico Sonntag     */
1588add1155SRico Sonntag    public function gedcomUpdated(): string
1598add1155SRico Sonntag    {
1608fd23e11SGreg Roach        $row = DB::table('change')
1618fd23e11SGreg Roach            ->where('gedcom_id', '=', $this->tree->id())
1628fd23e11SGreg Roach            ->where('status', '=', 'accepted')
1638fd23e11SGreg Roach            ->orderBy('change_id', 'DESC')
1648fd23e11SGreg Roach            ->select(['change_time'])
1658fd23e11SGreg Roach            ->first();
1668fd23e11SGreg Roach
1678fd23e11SGreg Roach        if ($row === null) {
1688fd23e11SGreg Roach            return $this->gedcomDate();
1698add1155SRico Sonntag        }
1708add1155SRico Sonntag
1718fd23e11SGreg Roach        return Carbon::make($row->change_time)->local()->isoFormat('LL');
1728add1155SRico Sonntag    }
1738add1155SRico Sonntag
1748add1155SRico Sonntag    /**
1750dcd9387SGreg Roach     * @return string
1768add1155SRico Sonntag     */
1778add1155SRico Sonntag    public function gedcomRootId(): string
1788add1155SRico Sonntag    {
1798add1155SRico Sonntag        return $this->tree->getPreference('PEDIGREE_ROOT_ID');
1808add1155SRico Sonntag    }
1818add1155SRico Sonntag}
182