xref: /webtrees/app/FlashMessages.php (revision 7fb00f20f3d1ff7197d3b4f35893144badc6644f)
1a25f0a04SGreg Roach<?php
2dd04c183SGreg Roachnamespace Fisharebest\Webtrees;
3a25f0a04SGreg Roach
4a25f0a04SGreg Roach/**
5a25f0a04SGreg Roach * webtrees: online genealogy
6a25f0a04SGreg Roach * Copyright (C) 2015 webtrees development team
7a25f0a04SGreg Roach * This program is free software: you can redistribute it and/or modify
8a25f0a04SGreg Roach * it under the terms of the GNU General Public License as published by
9a25f0a04SGreg Roach * the Free Software Foundation, either version 3 of the License, or
10a25f0a04SGreg Roach * (at your option) any later version.
11a25f0a04SGreg Roach * This program is distributed in the hope that it will be useful,
12a25f0a04SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
13a25f0a04SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14a25f0a04SGreg Roach * GNU General Public License for more details.
15a25f0a04SGreg Roach * You should have received a copy of the GNU General Public License
16a25f0a04SGreg Roach * along with this program. If not, see <http://www.gnu.org/licenses/>.
17a25f0a04SGreg Roach */
18a25f0a04SGreg Roach
19a25f0a04SGreg Roach/**
20a25f0a04SGreg Roach * Class FlashMessages - Flash messages allow us to generate messages
21a25f0a04SGreg Roach * in one context, and display them in another.
22a25f0a04SGreg Roach */
23a25f0a04SGreg Roachclass FlashMessages {
24*7fb00f20SGreg Roach	// Session storage key
25*7fb00f20SGreg Roach	const FLASH_KEY = 'flash_messages';
26*7fb00f20SGreg Roach
27a25f0a04SGreg Roach	/**
28a25f0a04SGreg Roach	 * Add a new message to the session storage.
29a25f0a04SGreg Roach	 *
30a25f0a04SGreg Roach	 * @param string $text
31a25f0a04SGreg Roach	 * @param string $status "success", "info", "warning" or "danger"
32a25f0a04SGreg Roach	 */
33a25f0a04SGreg Roach	public static function addMessage($text, $status = 'info') {
34a25f0a04SGreg Roach		$message         = new \stdClass;
35a25f0a04SGreg Roach		$message->text   = $text;
36a25f0a04SGreg Roach		$message->status = $status;
37a25f0a04SGreg Roach
38*7fb00f20SGreg Roach		$messages = Session::get(self::FLASH_KEY, array());
3931bc7874SGreg Roach		$messages[] = $message;
40*7fb00f20SGreg Roach		Session::put(self::FLASH_KEY, $messages);
41a25f0a04SGreg Roach	}
42a25f0a04SGreg Roach
43a25f0a04SGreg Roach	/**
44a25f0a04SGreg Roach	 * Get the current messages, and remove them from session storage.
45a25f0a04SGreg Roach	 *
46a25f0a04SGreg Roach	 * @return string[]
47a25f0a04SGreg Roach	 */
48a25f0a04SGreg Roach	public static function getMessages() {
49*7fb00f20SGreg Roach		$messages = Session::get(self::FLASH_KEY, array());
50*7fb00f20SGreg Roach		Session::forget(self::FLASH_KEY);
51a25f0a04SGreg Roach
52a25f0a04SGreg Roach		return $messages;
53a25f0a04SGreg Roach	}
54a25f0a04SGreg Roach}
55