Completed
Push — develop ( cd5e45...778c00 )
by Greg
19:49 queued 10:28
created

ShareAnniversaryModule::share()   A

Complexity

Conditions 4
Paths 5

Size

Total Lines 34
Code Lines 23

Duplication

Lines 0
Ratio 0 %

Importance

Changes 1
Bugs 0 Features 1
Metric Value
cc 4
eloc 23
c 1
b 0
f 1
nc 5
nop 1
dl 0
loc 34
rs 9.552
1
<?php
2
3
/**
4
 * webtrees: online genealogy
5
 * Copyright (C) 2021 webtrees development team
6
 * This program is free software: you can redistribute it and/or modify
7
 * it under the terms of the GNU General Public License as published by
8
 * the Free Software Foundation, either version 3 of the License, or
9
 * (at your option) any later version.
10
 * This program is distributed in the hope that it will be useful,
11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
 * GNU General Public License for more details.
14
 * You should have received a copy of the GNU General Public License
15
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
16
 */
17
18
declare(strict_types=1);
19
20
namespace Fisharebest\Webtrees\Module;
21
22
use Aura\Router\RouterContainer;
23
use Fisharebest\Webtrees\Auth;
24
use Fisharebest\Webtrees\Date\GregorianDate;
25
use Fisharebest\Webtrees\Exceptions\HttpNotFoundException;
26
use Fisharebest\Webtrees\Fact;
27
use Fisharebest\Webtrees\Family;
28
use Fisharebest\Webtrees\GedcomRecord;
29
use Fisharebest\Webtrees\I18N;
30
use Fisharebest\Webtrees\Individual;
31
use Fisharebest\Webtrees\Registry;
32
use Fisharebest\Webtrees\Tree;
33
use Illuminate\Support\Collection;
34
use Psr\Http\Message\ResponseInterface;
35
use Psr\Http\Message\ServerRequestInterface;
36
use Psr\Http\Server\RequestHandlerInterface;
37
use Sabre\VObject\Component\VCalendar;
38
39
use function app;
40
use function assert;
41
use function response;
42
use function route;
43
use function strip_tags;
44
use function view;
45
46
/**
47
 * Class ShareAnniversaryModule
48
 */
49
class ShareAnniversaryModule extends AbstractModule implements ModuleShareInterface, RequestHandlerInterface
50
{
51
    use ModuleShareTrait;
52
53
    protected const INDIVIDUAL_EVENTS = ['BIRT', 'DEAT'];
54
    protected const FAMILY_EVENTS     = ['MARR'];
55
56
    protected const ROUTE_URL = '/tree/{tree}/anniversary-ics/{xref}/{fact_id}';
57
58
    /**
59
     * Initialization.
60
     *
61
     * @return void
62
     */
63
    public function boot(): void
64
    {
65
        $router_container = app(RouterContainer::class);
66
        assert($router_container instanceof RouterContainer);
67
68
        $router_container->getMap()
69
            ->get(static::class, static::ROUTE_URL, $this);
70
    }
71
72
    /**
73
     * How should this module be identified in the control panel, etc.?
74
     *
75
     * @return string
76
     */
77
    public function title(): string
78
    {
79
        return I18N::translate('Share the anniversary of an event');
80
    }
81
82
    /**
83
     * A sentence describing what this module does.
84
     *
85
     * @return string
86
     */
87
    public function description(): string
88
    {
89
        return I18N::translate('Download a .ICS file containing an anniversary');
90
    }
91
92
    /**
93
     * HTML to include in the share links page.
94
     *
95
     * @param GedcomRecord $record
96
     *
97
     * @return string
98
     */
99
    public function share(GedcomRecord $record): string
100
    {
101
        if ($record instanceof Individual) {
102
            $facts = $record->facts(static::INDIVIDUAL_EVENTS, true)
103
                ->merge($record->spouseFamilies()->map(fn (Family $family): Collection => $family->facts(static::FAMILY_EVENTS, true)));
104
        } elseif ($record instanceof Family) {
105
            $facts = $record->facts(static::FAMILY_EVENTS, true);
106
        } else {
107
            return '';
108
        }
109
110
        // iCalendar only supports exact Gregorian dates.
111
        $facts = $facts
112
            ->flatten()
113
            ->filter(fn (Fact $fact): bool => $fact->date()->isOK())
114
            ->filter(fn (Fact $fact): bool => $fact->date()->qual1 === '')
115
            ->filter(fn (Fact $fact): bool => $fact->date()->minimumDate() instanceof GregorianDate)
116
            ->filter(fn (Fact $fact): bool => $fact->date()->minimumDate() === $fact->date()->maximumDate())
117
            ->mapWithKeys(fn (Fact $fact): array => [
118
                route(static::class, ['tree' => $record->tree()->name(), 'xref' => $fact->record()->xref(), 'fact_id' => $fact->id()]) =>
119
                    $fact->label() . ' — ' . $fact->date()->display(false, null, false),
120
            ]);
121
122
        if ($facts->isNotEmpty()) {
123
            $url = route(static::class, ['tree' => $record->tree()->name(), 'xref' => $record->xref()]);
124
125
            return view('modules/share-anniversary/share', [
126
                'facts'  => $facts,
127
                'record' => $record,
128
                'url'    => $url,
129
            ]);
130
        }
131
132
        return '';
133
    }
134
135
    /**
136
     * @param ServerRequestInterface $request
137
     *
138
     * @return ResponseInterface
139
     */
140
    public function handle(ServerRequestInterface $request): ResponseInterface
141
    {
142
        $tree = $request->getAttribute('tree');
143
        assert($tree instanceof Tree);
144
145
        $xref    = $request->getAttribute('xref');
146
        $fact_id = $request->getAttribute('fact_id');
147
148
        $record = Registry::gedcomRecordFactory()->make($xref, $tree);
149
        $record = Auth::checkRecordAccess($record);
150
151
        $fact = $record->facts()
152
            ->filter(fn (Fact $fact): bool => $fact->id() === $fact_id)
153
            ->first();
154
155
        if ($fact instanceof Fact) {
156
            $date             = $fact->date()->minimumDate()->format('%Y%m%d');
157
            $vcalendar        = new VCalendar();
158
            $vevent           = $vcalendar->add('VEVENT');
159
            $dtstart          = $vevent->add('DTSTART', $date);
0 ignored issues
show
Bug introduced by
The method add() does not exist on Sabre\VObject\Node. It seems like you code against a sub-type of said class. However, the method does not exist in Sabre\VObject\Parameter. Are you sure you never get one of those? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

159
            /** @scrutinizer ignore-call */ 
160
            $dtstart          = $vevent->add('DTSTART', $date);
Loading history...
160
            $dtstart['VALUE'] = 'DATE';
161
            $vevent->add('RRULE', 'FREQ=YEARLY');
162
            $vevent->add('SUMMARY', strip_tags($record->fullName()) . ' — ' . $fact->label());
163
164
            return response($vcalendar->serialize())
165
                ->withHeader('Content-Type', 'text/calendar')
166
                ->withHeader('Content-Disposition', 'attachment; filename="' . $fact->id() . '.ics');
167
        }
168
169
        throw new HttpNotFoundException();
170
    }
171
}
172