| Server IP : 151.101.66.159 / Your IP : 216.73.216.66 Web Server : Flywheel/5.1.0 System : Linux wordpress 6.12.113+ #1 SMP Thu Oct 22 02:38:20 UTC 2026 x86_64 User : root ( ) PHP Version : 7.4.33.18 Disable Function : disk_free_space,diskfreespace,dl,exec,fpassthru,getmypid,getmyuid,highlight_file,link,opcache_compile_file,opcache_get_configuration,opcache_is_script_cached,passthru,pcntl_alarm,pcntl_exec,pcntl_fork,pcntl_get_last_error,pcntl_getpriority,pcntl_setpriority,pcntl_signal,pcntl_signal_dispatch,pcntl_sigprocmask,pcntl_sigtimedwait,pcntl_sigwaitinfo,pcntl_strerror,pcntl_wait,pcntl_waitpid,pcntl_wexitstatus,pcntl_wifcontinued,pcntl_wifexited,pcntl_wifsignaled,pcntl_wifstopped,pcntl_wstopsig,pcntl_wtermsig,phpinfo,popen,posix_ctermid,posix_getcwd,posix_getegid,posix_geteuid,posix_getgid,posix_getgrgid,posix_getgrnam,posix_getgroups,posix_getlogin,posix_getpgid,posix_getpgrp,posix_getpid,posix_getppid,posix_getpwnam,posix_getpwuid,posix_getrlimit,posix_getsid,posix_getuid,posix_isatty,posix_kill,posix_mkfifo,posix_setegid,posix_seteuid,posix_setgid,posix_setpgid,posix_setsid,posix_setuid,posix_times,posix_ttyname,posix_uname,proc_close,proc_get_status,proc_nice,proc_open,proc_terminate,shell_exec,show_source,socket_listen,source,system,virtual MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /www/wp-content/plugins/filester/vendor-prefixed/src/ |
Upload File : |
<?php
namespace FilesterScoped\YayCommerce\AdminShell;
use FilesterScoped\YayCommerce\AdminShell\Contracts\AddonHostAdapter;
use FilesterScoped\YayCommerce\AdminShell\Contracts\PluginMenuAdapter;
use FilesterScoped\YayCommerce\AdminShell\License\Contracts\LicenseConfigAdapter;
use FilesterScoped\YayCommerce\AdminShell\License\LicenseHandler;
use FilesterScoped\YayCommerce\AdminShell\License\PluginInfoFactory;
use FilesterScoped\YayCommerce\AdminShell\Menu\ExternalPluginMenuAdapter;
use FilesterScoped\YayCommerce\AdminShell\Menu\PluginSubmenu;
use FilesterScoped\YayCommerce\AdminShell\Menu\MenuSuppressor;
use FilesterScoped\YayCommerce\AdminShell\Menu\PagesRouter;
use FilesterScoped\YayCommerce\AdminShell\Menu\SubmenuPositioner;
use FilesterScoped\YayCommerce\AdminShell\Menu\TopLevelMenu;
use FilesterScoped\YayCommerce\AdminShell\Pages\RecommendedPluginsPage;
use FilesterScoped\YayCommerce\AdminShell\Registry\AddonBridge;
use FilesterScoped\YayCommerce\AdminShell\Registry\LegacyBridge;
use FilesterScoped\YayCommerce\AdminShell\Registry\LicenseRegistry;
use FilesterScoped\YayCommerce\AdminShell\Support\AdminContext;
use FilesterScoped\YayCommerce\AdminShell\Support\Constants;
\defined('ABSPATH') || exit;
/**
* Public facade — entry point for consuming plugins.
*
* Version election: when multiple scoped copies coexist, the highest
* VERSION wins and registers menus/pages. All copies' register_plugin()
* and enable_license() still run — they hook global WP actions.
* @internal
*/
class AdminShell
{
/** Package version — used for cross-scope version election. */
const VERSION = '2.8.6';
private static ?self $instance = null;
private static bool $booted = \false;
private static array $enabled_slugs = [];
/** The scoped prefix for THIS copy (derived from namespace). */
private static string $prefix = '';
private LicenseRegistry $registry;
private function __construct()
{
$this->registry = new LicenseRegistry();
}
/**
* Bootstrap the shared admin shell.
*
* Each scoped copy calls boot(). All register their version in a shared
* global. Actual menu/page registration is deferred to admin_menu where
* only the highest version runs.
*/
public static function boot() : void
{
if (self::$booted) {
return;
}
self::$booted = \true;
require_once __DIR__ . '/Support/Constants.php';
$instance = self::get_instance();
// Derive our scoped prefix from the namespace (e.g. "YayMailScoped\YayCommerce\AdminShell" → "YayMailScoped")
$ns = __NAMESPACE__;
// YayCommerce\AdminShell or ScopedPrefix\YayCommerce\AdminShell
$parts = \explode('\\', $ns);
self::$prefix = \count($parts) > 2 ? $parts[0] : 'default';
// Register this version in the shared global for cross-scope election
if (!isset($GLOBALS['yaycommerce_admin_shell_versions'])) {
$GLOBALS['yaycommerce_admin_shell_versions'] = [];
}
$GLOBALS['yaycommerce_admin_shell_versions'][self::$prefix] = ['version' => self::VERSION, 'registry' => $instance->registry, 'boot_cb' => [static::class, 'do_shell_registration']];
// Register the version election — only once (first copy to call boot sets it up).
// Bound to both admin_menu and network_admin_menu so election runs in the
// Multisite Network Admin too; only the firing hook's election actually runs.
if (1 === \count($GLOBALS['yaycommerce_admin_shell_versions'])) {
AdminContext::bind_menu([static::class, 'elect_version'], 8);
// bind_menu() already wired BOTH hooks here, so mark the network election
// as done. This is load-bearing: it stops the safety net below from adding
// a SECOND network binding (elect_version is NOT idempotent — a double
// binding would run do_shell_registration twice). Only one copy ever sees
// count==1, so this path wires network at most once.
$GLOBALS['yaycommerce_network_election_wired'] = \true;
}
// Network Admin safety net for MIXED-VERSION installs. Older copies (≤2.6.x)
// wire the election to admin_menu ONLY — they predate network support — and the
// first-boot guard above lets whichever copy loads first (often an old one, by
// plugin folder order) own the wiring. So network_admin_menu would never get an
// election binding even when a newer copy is present. This block is NOT gated by
// that guard: any 2.7.1+ copy wires the network election exactly once (dedicated
// flag), independent of load order, so Network Admin works whenever ≥1 updated
// plugin is active. elect_version still elects the highest version as the winner.
if (empty($GLOBALS['yaycommerce_network_election_wired'])) {
$GLOBALS['yaycommerce_network_election_wired'] = \true;
add_action('network_admin_menu', [static::class, 'elect_version'], 8);
}
// Legacy bridge — reads yaycommerce_licensing_plugins filter.
// Runs for ALL versions (uses global WP hooks, contributes to any winning registry).
$legacy_bridge = new LegacyBridge($instance->registry);
$legacy_bridge->init();
// On AJAX requests admin_menu doesn't fire, so register AJAX handlers directly.
// Global guard ensures only one scoped copy registers (action name is identical across copies).
// DOING_AJAX must be in scoper.inc.php exclude-constants to avoid namespace prefixing.
if (\defined('DOING_AJAX') && \DOING_AJAX) {
$registered_ver = $GLOBALS['yaycommerce_ajax_handlers_registered'] ?? '0.0.0';
if (\version_compare(self::VERSION, $registered_ver, '>')) {
$GLOBALS['yaycommerce_ajax_handlers_registered'] = self::VERSION;
RecommendedPluginsPage::get_instance();
}
}
\do_action('yaycommerce_admin_shell_booted', $instance);
}
/**
* Version election — picks the highest version and runs its shell registration.
* Called once at admin_menu priority 8 (before TopLevelMenu at 9).
*/
public static function elect_version() : void
{
$versions = $GLOBALS['yaycommerce_admin_shell_versions'] ?? [];
if (empty($versions)) {
return;
}
// Find highest version
$winner_prefix = '';
$winner_ver = '0.0.0';
foreach ($versions as $prefix => $data) {
if (\version_compare($data['version'], $winner_ver, '>')) {
$winner_ver = $data['version'];
$winner_prefix = $prefix;
}
}
// Call the winner's registration — may be a different scoped class
$winner = $versions[$winner_prefix];
if (isset($winner['boot_cb']) && \is_callable($winner['boot_cb'])) {
\call_user_func($winner['boot_cb']);
}
}
/**
* Register menus/pages — only called by the winning version.
*/
public static function do_shell_registration() : void
{
$instance = self::get_instance();
// Merge all registries into the winner's registry
foreach ($GLOBALS['yaycommerce_admin_shell_versions'] ?? [] as $prefix => $data) {
if ($prefix !== self::$prefix && isset($data['registry'])) {
$other_registry = $data['registry'];
foreach ($other_registry->all() as $info) {
if (!$instance->registry->get($info->slug)) {
$instance->registry->register($info);
}
}
}
}
$suppressor = new MenuSuppressor();
$suppressor->init();
$top_menu = new TopLevelMenu();
$top_menu->init();
$router = new PagesRouter($instance->registry);
$router->init();
// Order all submenus by declared position — runs once, only for the
// winning version, so a single authority reorders every plugin's submenu.
$positioner = new SubmenuPositioner();
$positioner->init();
}
/**
* Register a plugin with the admin shell.
* Auto-detects pro vs lite via instanceof.
* Runs for ALL versions (not version-gated).
*/
public static function register_plugin(PluginMenuAdapter $adapter) : void
{
self::validate_adapter($adapter);
// Publish this plugin's intended submenu position into a shared,
// cross-scope map (keyed by menu slug). The version-elected winner reads
// this in SubmenuPositioner to order ALL submenus after registration.
// Request-scoped: not pruned (globals don't persist between requests),
// and stale/unknown slugs are harmless — reorder() sorts them last.
$menu_slug = $adapter->get_menu_slug();
if (!empty($menu_slug)) {
if (!isset($GLOBALS[SubmenuPositioner::POSITION_KEY])) {
$GLOBALS[SubmenuPositioner::POSITION_KEY] = [];
}
$GLOBALS[SubmenuPositioner::POSITION_KEY][$menu_slug] = $adapter->get_settings_page_position();
}
// Submenu registration — per-plugin, all versions
$submenu = new PluginSubmenu($adapter);
$submenu->init();
// Action links + row meta — per-plugin, all versions
if (\is_admin()) {
self::register_plugin_links($adapter);
}
// License subsystem — per-plugin, all versions
if ($adapter instanceof LicenseConfigAdapter) {
self::enable_license($adapter);
}
// Addon host — bridge plugin-specific addon filter into registry.
if ($adapter instanceof AddonHostAdapter) {
$filter_name = $adapter->get_addon_licensing_filter();
if (!empty($filter_name)) {
$bridge = new AddonBridge($filter_name, self::get_instance()->registry);
$bridge->init();
}
}
}
/**
* Register an "Other Plugins" submenu under an external plugin's own top-level menu.
* Use for plugins with their own menu hierarchy (e.g. whatsapp, filester) that should
* not appear under the shared YayCommerce menu.
*
* @param array{parent_menu: string, menu_title: string, menu_capability: string, menu_slug: string} $config
*/
public static function register_external_plugin_menu(array $config) : void
{
$adapter = new ExternalPluginMenuAdapter($config);
$adapter->init();
}
/**
* Validate adapter values upfront.
*/
private static function validate_adapter(PluginMenuAdapter $adapter) : void
{
$menu_title = $adapter->get_menu_title();
if (empty($menu_title)) {
\trigger_error('[YayCommerce AdminShell] get_menu_title() must return a non-empty string.', \E_USER_WARNING);
}
$basename = $adapter->get_plugin_basename();
if (empty($basename)) {
\trigger_error('[YayCommerce AdminShell] get_plugin_basename() must return a non-empty string.', \E_USER_WARNING);
}
$callback = $adapter->get_settings_page_callback();
if (null !== $callback && !\is_callable($callback)) {
\trigger_error('[YayCommerce AdminShell] get_settings_page_callback() returned a non-callable value.', \E_USER_WARNING);
}
if ($adapter instanceof LicenseConfigAdapter) {
$slug = $adapter->get_plugin_slug();
if (empty($slug)) {
\trigger_error('[YayCommerce AdminShell] get_plugin_slug() must return a non-empty string.', \E_USER_WARNING);
}
$item_id = $adapter->get_item_id();
if ($item_id <= 0) {
\trigger_error('[YayCommerce AdminShell] get_item_id() must return a positive integer.', \E_USER_WARNING);
}
$store_url = $adapter->get_store_url();
if (empty($store_url)) {
\trigger_error('[YayCommerce AdminShell] get_store_url() must return a non-empty URL.', \E_USER_WARNING);
}
$plugin_file = $adapter->get_plugin_file();
if (empty($plugin_file)) {
\trigger_error('[YayCommerce AdminShell] get_plugin_file() must return a non-empty path.', \E_USER_WARNING);
}
}
}
/**
* Enable the license subsystem for a plugin.
* Runs for ALL versions (not version-gated).
*/
public static function enable_license(LicenseConfigAdapter $adapter) : void
{
$slug = $adapter->get_plugin_slug();
if (isset(self::$enabled_slugs[$slug])) {
return;
}
self::$enabled_slugs[$slug] = \true;
$instance = self::get_instance();
new LicenseHandler($adapter);
$info = PluginInfoFactory::from_adapter($adapter);
$instance->registry->register($info);
\do_action('yaycommerce_admin_shell_license_enabled', $adapter);
}
/**
* Register plugin action links + row meta.
*/
private static function register_plugin_links(PluginMenuAdapter $adapter) : void
{
$basename = $adapter->get_plugin_basename();
add_filter('plugin_action_links_' . $basename, function (array $links) use($adapter) {
$new = [];
$menu_slug = $adapter->get_menu_slug();
if (!empty($menu_slug)) {
$url = \admin_url('admin.php?page=' . $menu_slug);
$new['settings'] = '<a href="' . \esc_url($url) . '">' . \esc_html($adapter->get_settings_label()) . '</a>';
}
$pro_url = $adapter->get_pro_url();
if (!empty($pro_url)) {
$new['go-pro'] = '<a href="' . \esc_url($pro_url) . '" target="_blank" style="color:#00a32a;font-weight:700;">' . \esc_html__('Go Pro', 'yaycommerce') . '</a>';
}
return \array_merge($new, $links);
});
add_filter('plugin_row_meta', function (array $meta, string $file) use($adapter, $basename) {
if ($file !== $basename) {
return $meta;
}
$docs_url = $adapter->get_docs_url();
if (!empty($docs_url)) {
$meta[] = '<a href="' . \esc_url($docs_url) . '" target="_blank">' . \esc_html__('Docs', 'yaycommerce') . '</a>';
}
$meta[] = '<a href="https://yaycommerce.com/support" target="_blank">' . \esc_html__('Support', 'yaycommerce') . '</a>';
return $meta;
}, 10, 2);
}
/**
* Return the shared registry.
*/
public static function registry() : LicenseRegistry
{
return self::get_instance()->registry;
}
private static function get_instance() : self
{
if (null === self::$instance) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Reset state — for unit tests only.
*/
public static function reset() : void
{
self::$instance = null;
self::$booted = \false;
self::$enabled_slugs = [];
self::$prefix = '';
unset($GLOBALS['yaycommerce_admin_shell_versions']);
unset($GLOBALS['yaycommerce_ajax_handlers_registered']);
unset($GLOBALS['yaycommerce_network_election_wired']);
unset($GLOBALS[SubmenuPositioner::POSITION_KEY]);
}
}