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