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