xref: /webtrees/app/GuestUser.php (revision e93a8df2f8d797005750082cc3766c0e80799688)
1e5a6b4d4SGreg Roach<?php
23976b470SGreg Roach
3e5a6b4d4SGreg Roach/**
4e5a6b4d4SGreg Roach * webtrees: online genealogy
5*d11be702SGreg Roach * Copyright (C) 2023 webtrees development team
6e5a6b4d4SGreg Roach * This program is free software: you can redistribute it and/or modify
7e5a6b4d4SGreg Roach * it under the terms of the GNU General Public License as published by
8e5a6b4d4SGreg Roach * the Free Software Foundation, either version 3 of the License, or
9e5a6b4d4SGreg Roach * (at your option) any later version.
10e5a6b4d4SGreg Roach * This program is distributed in the hope that it will be useful,
11e5a6b4d4SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
12e5a6b4d4SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13e5a6b4d4SGreg Roach * GNU General Public License for more details.
14e5a6b4d4SGreg Roach * You should have received a copy of the GNU General Public License
1589f7189bSGreg Roach * along with this program. If not, see <https://www.gnu.org/licenses/>.
16e5a6b4d4SGreg Roach */
17fcfa147eSGreg Roach
18e5a6b4d4SGreg Roachdeclare(strict_types=1);
19e5a6b4d4SGreg Roach
20e5a6b4d4SGreg Roachnamespace Fisharebest\Webtrees;
21e5a6b4d4SGreg Roach
22e5a6b4d4SGreg Roachuse Fisharebest\Webtrees\Contracts\UserInterface;
23e5a6b4d4SGreg Roach
2410e06497SGreg Roachuse function is_string;
2510e06497SGreg Roach
26e5a6b4d4SGreg Roach/**
27e5a6b4d4SGreg Roach * A site visitor.
28e5a6b4d4SGreg Roach */
29e5a6b4d4SGreg Roachclass GuestUser implements UserInterface
30e5a6b4d4SGreg Roach{
3143f2f523SGreg Roach    private string $email;
32e5a6b4d4SGreg Roach
3343f2f523SGreg Roach    private string $real_name;
34e5a6b4d4SGreg Roach
35e5a6b4d4SGreg Roach    /**
36e5a6b4d4SGreg Roach     * @param string $email
37e5a6b4d4SGreg Roach     * @param string $real_name
38e5a6b4d4SGreg Roach     */
39e2cbf57aSGreg Roach    public function __construct(string $email = 'GUEST_USER', string $real_name = 'GUEST_USER')
40e2cbf57aSGreg Roach    {
41e5a6b4d4SGreg Roach        $this->email = $email;
42e5a6b4d4SGreg Roach        $this->real_name = $real_name;
43e5a6b4d4SGreg Roach    }
44e5a6b4d4SGreg Roach
45e5a6b4d4SGreg Roach    /**
46e5a6b4d4SGreg Roach     * The user‘s internal identifier.
47e5a6b4d4SGreg Roach     *
48e5a6b4d4SGreg Roach     * @return int
49e5a6b4d4SGreg Roach     */
50e5a6b4d4SGreg Roach    public function id(): int
51e5a6b4d4SGreg Roach    {
52e5a6b4d4SGreg Roach        return 0;
53e5a6b4d4SGreg Roach    }
54e5a6b4d4SGreg Roach
55e5a6b4d4SGreg Roach    /**
56e5a6b4d4SGreg Roach     * The users email address.
57e5a6b4d4SGreg Roach     *
58e5a6b4d4SGreg Roach     * @return string
59e5a6b4d4SGreg Roach     */
60e5a6b4d4SGreg Roach    public function email(): string
61e5a6b4d4SGreg Roach    {
62e5a6b4d4SGreg Roach        return $this->email;
63e5a6b4d4SGreg Roach    }
64e5a6b4d4SGreg Roach
65e5a6b4d4SGreg Roach    /**
66e5a6b4d4SGreg Roach     * The user‘s real name.
67e5a6b4d4SGreg Roach     *
68e5a6b4d4SGreg Roach     * @return string
69e5a6b4d4SGreg Roach     */
70e5a6b4d4SGreg Roach    public function realName(): string
71e5a6b4d4SGreg Roach    {
72e5a6b4d4SGreg Roach        return $this->real_name;
73e5a6b4d4SGreg Roach    }
74e5a6b4d4SGreg Roach
75e5a6b4d4SGreg Roach    /**
76e5a6b4d4SGreg Roach     * The user‘s login name.
77e5a6b4d4SGreg Roach     *
78e5a6b4d4SGreg Roach     * @return string
79e5a6b4d4SGreg Roach     */
80e5a6b4d4SGreg Roach    public function userName(): string
81e5a6b4d4SGreg Roach    {
82e5a6b4d4SGreg Roach        return '';
83e5a6b4d4SGreg Roach    }
84e5a6b4d4SGreg Roach
85e5a6b4d4SGreg Roach    /**
86e5a6b4d4SGreg Roach     * @param string $setting_name
87e5a6b4d4SGreg Roach     * @param string $default
88e5a6b4d4SGreg Roach     *
89e5a6b4d4SGreg Roach     * @return string
90e5a6b4d4SGreg Roach     */
91e5a6b4d4SGreg Roach    public function getPreference(string $setting_name, string $default = ''): string
92e5a6b4d4SGreg Roach    {
93d8809d62SGreg Roach        $preference = Session::get('_GUEST_' . $setting_name);
94d8809d62SGreg Roach
95d8809d62SGreg Roach        return is_string($preference) ? $preference : $default;
96e5a6b4d4SGreg Roach    }
97e5a6b4d4SGreg Roach
98e5a6b4d4SGreg Roach    /**
99e5a6b4d4SGreg Roach     * @param string $setting_name
100e5a6b4d4SGreg Roach     * @param string $setting_value
101e5a6b4d4SGreg Roach     *
1027c4add84SGreg Roach     * @return void
103e5a6b4d4SGreg Roach     */
1047c4add84SGreg Roach    public function setPreference(string $setting_name, string $setting_value): void
105e5a6b4d4SGreg Roach    {
106e5a6b4d4SGreg Roach        Session::put('_GUEST_' . $setting_name, $setting_value);
107e5a6b4d4SGreg Roach    }
108e5a6b4d4SGreg Roach}
109