xref: /webtrees/app/GuestUser.php (revision d11be7027e34e3121be11cc025421873364403f9)
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     * GuestUser constructor.
37e5a6b4d4SGreg Roach     *
38e5a6b4d4SGreg Roach     * @param string $email
39e5a6b4d4SGreg Roach     * @param string $real_name
40e5a6b4d4SGreg Roach     */
41e2cbf57aSGreg Roach    public function __construct(string $email = 'GUEST_USER', string $real_name = 'GUEST_USER')
42e2cbf57aSGreg Roach    {
43e5a6b4d4SGreg Roach        $this->email = $email;
44e5a6b4d4SGreg Roach        $this->real_name = $real_name;
45e5a6b4d4SGreg Roach    }
46e5a6b4d4SGreg Roach
47e5a6b4d4SGreg Roach    /**
48e5a6b4d4SGreg Roach     * The user‘s internal identifier.
49e5a6b4d4SGreg Roach     *
50e5a6b4d4SGreg Roach     * @return int
51e5a6b4d4SGreg Roach     */
52e5a6b4d4SGreg Roach    public function id(): int
53e5a6b4d4SGreg Roach    {
54e5a6b4d4SGreg Roach        return 0;
55e5a6b4d4SGreg Roach    }
56e5a6b4d4SGreg Roach
57e5a6b4d4SGreg Roach    /**
58e5a6b4d4SGreg Roach     * The users email address.
59e5a6b4d4SGreg Roach     *
60e5a6b4d4SGreg Roach     * @return string
61e5a6b4d4SGreg Roach     */
62e5a6b4d4SGreg Roach    public function email(): string
63e5a6b4d4SGreg Roach    {
64e5a6b4d4SGreg Roach        return $this->email;
65e5a6b4d4SGreg Roach    }
66e5a6b4d4SGreg Roach
67e5a6b4d4SGreg Roach    /**
68e5a6b4d4SGreg Roach     * The user‘s real name.
69e5a6b4d4SGreg Roach     *
70e5a6b4d4SGreg Roach     * @return string
71e5a6b4d4SGreg Roach     */
72e5a6b4d4SGreg Roach    public function realName(): string
73e5a6b4d4SGreg Roach    {
74e5a6b4d4SGreg Roach        return $this->real_name;
75e5a6b4d4SGreg Roach    }
76e5a6b4d4SGreg Roach
77e5a6b4d4SGreg Roach    /**
78e5a6b4d4SGreg Roach     * The user‘s login name.
79e5a6b4d4SGreg Roach     *
80e5a6b4d4SGreg Roach     * @return string
81e5a6b4d4SGreg Roach     */
82e5a6b4d4SGreg Roach    public function userName(): string
83e5a6b4d4SGreg Roach    {
84e5a6b4d4SGreg Roach        return '';
85e5a6b4d4SGreg Roach    }
86e5a6b4d4SGreg Roach
87e5a6b4d4SGreg Roach    /**
88e5a6b4d4SGreg Roach     * @param string $setting_name
89e5a6b4d4SGreg Roach     * @param string $default
90e5a6b4d4SGreg Roach     *
91e5a6b4d4SGreg Roach     * @return string
92e5a6b4d4SGreg Roach     */
93e5a6b4d4SGreg Roach    public function getPreference(string $setting_name, string $default = ''): string
94e5a6b4d4SGreg Roach    {
95d8809d62SGreg Roach        $preference = Session::get('_GUEST_' . $setting_name);
96d8809d62SGreg Roach
97d8809d62SGreg Roach        return is_string($preference) ? $preference : $default;
98e5a6b4d4SGreg Roach    }
99e5a6b4d4SGreg Roach
100e5a6b4d4SGreg Roach    /**
101e5a6b4d4SGreg Roach     * @param string $setting_name
102e5a6b4d4SGreg Roach     * @param string $setting_value
103e5a6b4d4SGreg Roach     *
1047c4add84SGreg Roach     * @return void
105e5a6b4d4SGreg Roach     */
1067c4add84SGreg Roach    public function setPreference(string $setting_name, string $setting_value): void
107e5a6b4d4SGreg Roach    {
108e5a6b4d4SGreg Roach        Session::put('_GUEST_' . $setting_name, $setting_value);
109e5a6b4d4SGreg Roach    }
110e5a6b4d4SGreg Roach}
111