1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
|
<?php
/**
* webtrees: online genealogy
* Copyright (C) 2018 webtrees development team
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
declare(strict_types=1);
namespace Fisharebest\Webtrees\Http\Controllers;
use Fisharebest\Webtrees\Auth;
use Fisharebest\Webtrees\Date;
use Fisharebest\Webtrees\I18N;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
/**
* Controller for help text.
*/
class HelpTextController extends AbstractBaseController {
const FRENCH_DATES = [
'@#DFRENCH R@ 12',
'@#DFRENCH R@ VEND 12',
'ABT @#DFRENCH R@ BRUM 12',
'BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12',
'FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12',
'AFT @#DFRENCH R@ GERM 12',
'BEF @#DFRENCH R@ FLOR 12',
'ABT @#DFRENCH R@ PRAI 12',
'FROM @#DFRENCH R@ MESS 12',
'TO @#DFRENCH R@ THER 12',
'EST @#DFRENCH R@ FRUC 12',
'@#DFRENCH R@ 03 COMP 12',
];
const HIJRI_DATES = [
'@#DHIJRI@ 1497',
'@#DHIJRI@ MUHAR 1497',
'ABT @#DHIJRI@ SAFAR 1497',
'BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497',
'FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497',
'AFT @#DHIJRI@ RAJAB 1497',
'BEF @#DHIJRI@ SHAAB 1497',
'ABT @#DHIJRI@ RAMAD 1497',
'FROM @#DHIJRI@ SHAWW 1497',
'TO @#DHIJRI@ DHUAQ 1497',
'@#DHIJRI@ 03 DHUAH 1497',
];
const JEWISH_DATES = [
'@#DHEBREW@ 5481',
'@#DHEBREW@ TSH 5481',
'ABT @#DHEBREW@ CSH 5481',
'BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481',
'FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481',
'AFT @#DHEBREW@ ADR 5481',
'AFT @#DHEBREW@ ADS 5480',
'BEF @#DHEBREW@ NSN 5481',
'ABT @#DHEBREW@ IYR 5481',
'FROM @#DHEBREW@ SVN 5481',
'TO @#DHEBREW@ TMZ 5481',
'EST @#DHEBREW@ AAV 5481',
'@#DHEBREW@ 03 ELL 5481',
];
const JULIAN_DATES = [
'@#DJULIAN@ 14 JAN 1700',
'@#DJULIAN@ 44 B.C.',
'@#DJULIAN@ 20 FEB 1742/43',
'BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752',
];
const DATE_SHORTCUTS = [
'1900' => [],
'JAN 1900' => [],
'FEB 1900' => [],
'MAR 1900' => [],
'APR 1900' => [],
'MAY 1900' => [],
'JUN 1900' => [],
'JUL 1900' => [],
'AUG 1900' => [],
'SEP 1900' => [],
'OCT 1900' => [],
'NOV 1900' => [],
'DEC 1900' => [],
'ABT 1900' => ['~1900'],
'EST 1900' => ['*1900'],
'CAL 1900' => ['#1900'],
'INT 1900 (...)' => [],
];
const DATE_RANGE_SHORTCUTS = [
'BET 1900 AND 1910' => ['1900-1910'],
'AFT 1900' => ['>1900'],
'BEF 1910' => ['<1910'],
'BET JAN 1900 AND MAR 1900' => ['Q1 1900'],
'BET APR 1900 AND JUN 1900' => ['Q2 1900'],
'BET JUL 1900 AND SEP 1900' => ['Q3 1900'],
'BET OCT 1900 AND DEC 1900' => ['Q4 1900'],
];
const DATE_PERIOD_SHORTCUTS = [
'FROM 1900 TO 1910' => ['1900~1910'],
'FROM 1900' => ['1900-'],
'TO 1910' => ['-1900'],
];
const DMY_SHORTCUTS = [
'11 DEC 1913' => ['11/12/1913', '11-12-1913', '11.12.1913',],
'01 FEB 2003' => ['01/02/03', '01-02-03', '01.02.03',],
];
const MDY_SHORTCUTS = [
'11 DEC 1913' => ['12/11/1913', '12-11-1913', '12.11.1913',],
'01 FEB 2003' => ['02/01/03', '02-01-03', '02.01.03',],
];
const YMD_SHORTCUTS = [
'11 DEC 1913' => ['11/12/1913', '11-12-1913', '11.12.1913',],
'01 FEB 2003' => ['03/02/01', '03-02-01', '03.02.01',],
];
/**
* Help for dates.
*
* @param Request $request
*
* @return Response
*/
public function helpText(Request $request): Response {
$topic = $request->get('topic');
switch ($topic) {
case 'DATE':
switch ($this->dmyOrder()) {
case 'YMD':
$date_shortcuts = self::DATE_SHORTCUTS + self::YMD_SHORTCUTS;
break;
case 'MDY':
$date_shortcuts = self::DATE_SHORTCUTS + self::MDY_SHORTCUTS;
break;
case 'DMY':
default:
$date_shortcuts = self::DATE_SHORTCUTS + self::DMY_SHORTCUTS;
break;
}
$title = I18N::translate('Date');
$text = view('help/date', [
'date_dates' => $this->formatDates(array_keys($date_shortcuts)),
'date_shortcuts' => $date_shortcuts,
'date_period_dates' => $this->formatDates(array_keys(self::DATE_PERIOD_SHORTCUTS)),
'date_period_shortcuts' => self::DATE_PERIOD_SHORTCUTS,
'date_range_dates' => $this->formatDates(array_keys(self::DATE_RANGE_SHORTCUTS)),
'date_range_shortcuts' => self::DATE_RANGE_SHORTCUTS,
'french_dates' => $this->formatDates(self::FRENCH_DATES),
'hijri_dates' => $this->formatDates(self::HIJRI_DATES),
'jewish_dates' => $this->formatDates(self::JEWISH_DATES),
'julian_dates' => $this->formatDates(self::JULIAN_DATES),
]);
break;
case 'NAME':
$title = I18N::translate('Name');
$text = view('help/name');
break;
case 'SURN':
$title = I18N::translate('Surname');
$text = view('help/surname');
break;
case 'OBJE':
$title = I18N::translate('Media object');
$text = view('help/media-object');
break;
case 'PLAC':
$title = I18N::translate('Place');
$text = view('help/place');
break;
case 'RESN':
$title = I18N::translate('Restriction');
$text = view('help/romanized');
break;
case 'ROMN':
$title = I18N::translate('Romanized');
$text = view('help/restriction');
break;
case '_HEB':
$title = I18N::translate('Hebrew');
$text = view('help/hebrew');
break;
case 'annivers_year_select':
$title = I18N::translate('Year input box');
$text = view('help/calendar-year');
break;
case 'edit_SOUR_EVEN':
$title = I18N::translate('Associate events with this source');
$text = view('help/source-events');
break;
case 'pending_changes':
$title = I18N::translate('Pending changes');
$text = view('help/pending-changes', [
'is_admin' => Auth::isAdmin(),
]);
break;
default:
$title = I18N::translate('Help');
$text = I18N::translate('The help text has not been written for this item.');
break;
}
$html = view('modals/help', [
'title' => $title,
'text' => $text,
]);
return new Response($html);
}
/**
* Format GEDCOM dates in the local language.
*
* @param string[] $gedcom_dates
*
* @return string[]
*/
private function formatDates(array $gedcom_dates): array {
$dates = [];
foreach ($gedcom_dates as $gedcom_date) {
$date = new Date($gedcom_date);
$dates[$gedcom_date] = strip_tags($date->display(false, null, false));
}
return $dates;
}
/**
* Does the current language use DMY, MDY or YMD for numeric date.
*
* @return string
*/
private function dmyOrder(): string {
return preg_replace('/[^DMY]/', '', str_replace([
'J',
'F',
], [
'D',
'M',
], I18N::dateFormat()));
}
}
|
