/wp-content/plugins/s2member/includes/classes/admin-notices.inc.php

<?php
/**
* Enqueues/displays administrative notices.
*
* Copyright: © 2009-2011
* {@link http://www.websharks-inc.com/ WebSharks, Inc.}
* (coded in the USA)
*
* Released under the terms of the GNU General Public License.
* You should have received a copy of the GNU General Public License,
* along with this software. In the main directory, see: /licensing/
* If not, see: {@link http://www.gnu.org/licenses/}.
*
* @package s2Member\Admin_Notices
* @since 3.5
*/
if (realpath (__FILE__) === realpath ($_SERVER["SCRIPT_FILENAME"]))
	exit("Do not access this file directly.");

if (!class_exists ("c_ws_plugin__s2member_admin_notices"))
	{
		/**
		* Enqueues/displays administrative notices.
		*
		* @package s2Member\Admin_Notices
		* @since 3.5
		*/
		class c_ws_plugin__s2member_admin_notices
			{
				/**
				* Enqueues administrative notices.
				*
				* @package s2Member\Admin_Notices
				* @since 3.5
				*
				* @param str $notice String value of actual notice *(i.e. the message)*.
				* @param str|array $on_pages Optional. Defaults to any page. String or array of pages to display this notice on.
				* @param bool $error Optional. True if this notice is regarding an error. Defaults to false.
				* @param int $time Optional. Unix timestamp indicating when this notice will be displayed.
				* @param bool $dismiss Optional. If true, the notice will remain persistent, until dismissed. Defaults to false.
				* @return null
				*/
				public static function enqueue_admin_notice ($notice = FALSE, $on_pages = FALSE, $error = FALSE, $time = FALSE, $dismiss = FALSE)
					{
						foreach(array_keys(get_defined_vars())as$__v)$__refs[$__v]=&$$__v;
						do_action ("ws_plugin__s2member_before_enqueue_admin_notice", get_defined_vars ());
						unset /* Unset defined __refs, __v. */ ($__refs, $__v);

						if  /* If we have a valid string. */(is_string ($notice) && $notice)
							{
								$notices = (array)get_option ("ws_plugin__s2member_notices");

								array_push ($notices, array ("notice" => $notice, "on_pages" => $on_pages, "error" => $error, "time" => $time, "dismiss" => $dismiss));

								foreach(array_keys(get_defined_vars())as$__v)$__refs[$__v]=&$$__v;
								do_action ("ws_plugin__s2member_during_enqueue_admin_notice", get_defined_vars ());
								unset /* Unset defined __refs, __v. */ ($__refs, $__v);

								update_option ("ws_plugin__s2member_notices", c_ws_plugin__s2member_utils_arrays::array_unique ($notices));
							}
						do_action ("ws_plugin__s2member_after_enqueue_admin_notice", get_defined_vars ());

						return /* Return for uniformity. */;
					}
				/**
				* Displays an administrative notice.
				*
				* @package s2Member\Admin_Notices
				* @since 3.5
				*
				* @param str $notice String value of actual notice *(i.e. the message)*.
				* @param bool $error Optional. True if this notice is regarding an error. Defaults to false.
				* @param bool $dismiss Optional. If true, the notice will be displayed with a dismissal link. Defaults to false.
				* @return null
				*/
				public static function display_admin_notice ($notice = FALSE, $error = FALSE, $dismiss = FALSE)
					{
						foreach(array_keys(get_defined_vars())as$__v)$__refs[$__v]=&$$__v;
						do_action ("ws_plugin__s2member_before_display_admin_notice", get_defined_vars ());
						unset /* Unset defined __refs, __v. */ ($__refs, $__v);

						if /* Slightly different/special format for errors. */ (is_string ($notice) && $notice && $error)
							{
								$notice .= ($dismiss) ? ' [ <a href="' . esc_attr(add_query_arg ("ws-plugin--s2member-dismiss-admin-notice", urlencode (md5 ($notice)), $_SERVER["REQUEST_URI"])) . '">dismiss message</a> ]' : '';

								echo /* Error. */ '<div class="error fade"><p>' . $notice . '</p></div>';
							}
						else if (is_string ($notice) && $notice)
							{
								$notice .= ($dismiss) ? ' [ <a href="' . esc_attr(add_query_arg ("ws-plugin--s2member-dismiss-admin-notice", urlencode (md5 ($notice)), $_SERVER["REQUEST_URI"])) . '">dismiss message</a> ]' : '';

								echo '<div class="updated fade"><p>' . $notice . '</p></div>';
							}
						do_action ("ws_plugin__s2member_after_display_admin_notice", get_defined_vars ());

						return /* Return for uniformity. */;
					}
				/**
				* Processes all administrative notices.
				*
				* @package s2Member\Admin_Notices
				* @since 3.5
				*
				* @attaches-to ``add_action("admin_notices");``
				* @attaches-to ``add_action("user_admin_notices");``
				* @attaches-to ``add_action("network_admin_notices");``
				* @todo Update to ``add_action("all_admin_notices");``.
				*
				* @return null
				*/
				public static function admin_notices ()
					{
						global /* This holds the current page filename. */ $pagenow;

						do_action ("ws_plugin__s2member_before_admin_notices", get_defined_vars ());

						if (is_admin () && is_array ($notices = get_option ("ws_plugin__s2member_notices")) && !empty ($notices))
							{
								$a = (is_blog_admin ()) ? "blog" : $a;
								$a = (is_user_admin ()) ? "user" : $a;
								$a = (is_network_admin ()) ? "network" : $a;
								$a =  /* Default Blog Admin. */(!$a) ? "blog" : $a;

								foreach /* Check several things about each Notice. */ ($notices as $i => $notice)
									foreach (((!$notice["on_pages"]) ? array ("*"): (array)$notice["on_pages"]) as $page)
										{
											if /* NO prefix? */ (!preg_match ("/^(.+?)\:/", $page))
												$page = /* `blog:` */ "blog:" . ltrim ($page, ":");

											$adms = preg_split ("/\|/", preg_replace ("/\:(.*)$/i", "", $page));
											$page = preg_replace ("/^([^\:]*)\:/i", "", $page);

											if (empty ($adms) || in_array ("*", $adms) || in_array ($a, $adms))
												if (!$page || "*" === $page || $pagenow === $page || $_GET["page"] === $page)
													{
														if /* Time to show it? */ (strtotime ("now") >= (int)$notice["time"])
															{
																foreach(array_keys(get_defined_vars())as$__v)$__refs[$__v]=&$$__v;
																do_action ("ws_plugin__s2member_during_admin_notices_before_display", get_defined_vars ());
																unset /* Unset defined __refs, __v. */ ($__refs, $__v);

																if (!$notice["dismiss"] || (!empty ($_GET["ws-plugin--s2member-dismiss-admin-notice"]) && $_GET["ws-plugin--s2member-dismiss-admin-notice"] === md5 ($notice["notice"])))
																	unset /* Clear this administrative notice now? */($notices[$i]);

																if (!$notice["dismiss"] || empty ($_GET["ws-plugin--s2member-dismiss-admin-notice"]) || $_GET["ws-plugin--s2member-dismiss-admin-notice"] !== md5 ($notice["notice"]))
																	c_ws_plugin__s2member_admin_notices::display_admin_notice ($notice["notice"], $notice["error"], $notice["dismiss"]);

																do_action ("ws_plugin__s2member_during_admin_notices_after_display", get_defined_vars ());
															}
														continue /* This Notice processed; continue. */ 2;
													}
										}
								$notices = /* Re-index array. */array_merge ($notices);

								foreach(array_keys(get_defined_vars())as$__v)$__refs[$__v]=&$$__v;
								do_action ("ws_plugin__s2member_during_admin_notices", get_defined_vars ());
								unset /* Unset defined __refs, __v. */ ($__refs, $__v);

								update_option ("ws_plugin__s2member_notices", $notices);
							}
						do_action ("ws_plugin__s2member_after_admin_notices", get_defined_vars ());

						return /* Return for uniformity. */;
					}
			}
	}
?>