Completed
Push — develop ( 4b9394...9b940a )
by Greg
10:11
created

HereMaps::leafletJsTileLayers()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 49
Code Lines 44

Duplication

Lines 0
Ratio 0 %

Importance

Changes 1
Bugs 0 Features 0
Metric Value
cc 1
eloc 44
c 1
b 0
f 0
nc 1
nop 0
dl 0
loc 49
rs 9.216
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 Fisharebest\Webtrees\FlashMessages;
23
use Fisharebest\Webtrees\I18N;
24
use Psr\Http\Message\ResponseInterface;
25
use Psr\Http\Message\ServerRequestInterface;
26
27
use function redirect;
28
29
/**
30
 * Class HereMaps - use maps within webtrees
31
 */
32
class HereMaps extends AbstractModule implements ModuleConfigInterface, ModuleMapProviderInterface
33
{
34
    use ModuleConfigTrait;
35
    use ModuleMapProviderTrait;
36
37
    /**
38
     * Name of the map provider.
39
     *
40
     * @return string
41
     */
42
    public function description(): string
43
    {
44
        $link = '<a href="https://www.here.com" dir="ltr">www.here.com</a>';
45
46
        // I18N: %s is a link/URL
47
        return I18N::translate('Create maps using %s.', $link);
48
    }
49
50
    /**
51
     * Should this module be enabled when it is first installed?
52
     *
53
     * @return bool
54
     */
55
    public function isEnabledByDefault(): bool
56
    {
57
        return false;
58
    }
59
60
    /**
61
     * @return ResponseInterface
62
     */
63
    public function getAdminAction(): ResponseInterface
64
    {
65
        $this->layout = 'layouts/administration';
66
67
        $api_key = $this->getPreference('api_key');
68
69
        return $this->viewResponse('modules/here-maps/config', [
70
            'api_key' => $api_key,
71
            'title'   => $this->title(),
72
        ]);
73
    }
74
75
    /**
76
     * Name of the map provider.
77
     *
78
     * @return string
79
     */
80
    public function title(): string
81
    {
82
        return I18N::translate('Here maps');
83
    }
84
85
    /**
86
     * @param ServerRequestInterface $request
87
     *
88
     * @return ResponseInterface
89
     */
90
    public function postAdminAction(ServerRequestInterface $request): ResponseInterface
91
    {
92
        $params = (array) $request->getParsedBody();
93
94
        $this->setPreference('api_key', $params['api_key'] ?? '');
95
96
        FlashMessages::addMessage(I18N::translate('The preferences for the module “%s” have been updated.', $this->title()), 'success');
97
98
        return redirect($this->getConfigLink());
99
    }
100
101
    /**
102
     * Parameters to create a TileLayer in LeafletJs.
103
     *
104
     * @return array<object>
105
     */
106
    public function leafletJsTileLayers(): array
107
    {
108
        $api_key = $this->getPreference('api_key');
109
110
        return [
111
            (object) [
112
                'api_key'     => $api_key,
113
                'attribution' => '<a href="https://legal.here.com/en/terms/serviceterms/us">Terms of use</a> ©1987-2021 HERE',
114
                'base'        => 'base',
115
                'format'      => 'png8',
116
                'label'       => 'Normal',
117
                'mapID'       => 'newest',
118
                'maxZoom'     => 20,
119
                'minZoom'     => 2,
120
                'size'        => 512,
121
                'subdomains'  => ['1', '2', '3', '4'],
122
                'type'        => 'maptile',
123
                'url'         => 'https://{s}.{base}.maps.ls.hereapi.com/maptile/2.1/{type}/{mapID}/{variant}/{z}/{x}/{y}/{size}/{format}?apiKey={apiKey}',
124
                'variant'     => 'normal.day',
125
            ],
126
            (object) [
127
                'api_key'     => $api_key,
128
                'attribution' => '<a href="https://legal.here.com/en/terms/serviceterms/us">Terms of use</a> ©1987-2021 HERE',
129
                'base'        => 'base',
130
                'format'      => 'png8',
131
                'label'       => 'Grey',
132
                'mapID'       => 'newest',
133
                'maxZoom'     => 20,
134
                'minZoom'     => 2,
135
                'size'        => 512,
136
                'subdomains'  => ['1', '2', '3', '4'],
137
                'type'        => 'maptile',
138
                'url'         => 'https://{s}.{base}.maps.ls.hereapi.com/maptile/2.1/{type}/{mapID}/{variant}/{z}/{x}/{y}/{size}/{format}?apiKey={apiKey}',
139
                'variant'     => 'normal.day.grey',
140
            ],
141
            (object) [
142
                'api_key'     => $api_key,
143
                'attribution' => '<a href="https://legal.here.com/en/terms/serviceterms/us">Terms of use</a> ©1987-2021 HERE',
144
                'base'        => 'aerial',
145
                'format'      => 'png8',
146
                'label'       => 'Terrain',
147
                'mapID'       => 'newest',
148
                'maxZoom'     => 20,
149
                'minZoom'     => 2,
150
                'size'        => 512,
151
                'subdomains'  => ['1', '2', '3', '4'],
152
                'type'        => 'maptile',
153
                'url'         => 'https://{s}.{base}.maps.ls.hereapi.com/maptile/2.1/{type}/{mapID}/{variant}/{z}/{x}/{y}/{size}/{format}?apiKey={apiKey}',
154
                'variant'     => 'terrain.day',
155
            ],
156
        ];
157
    }
158
}
159