toolbar-extras-mainwp.php

<?php # -*- coding: utf-8 -*-
/**
 * Main plugin file.
 * @package           Toolbar Extras for MainWP
 * @author            David Decker
 * @copyright         Copyright (c) 2018-2019, David Decker - DECKERWEB
 * @license           GPL-2.0-or-later
 * @link              https://deckerweb.de/twitter
 *
 * @wordpress-plugin
 * Plugin Name:       Toolbar Extras for MainWP
 * Plugin URI:        https://toolbarextras.com/addons/mainwp-dashboard/
 * Description:       Spice up your WordPress Toolbar for your MainWP Dashboard: Make managing your Websites via MainWP even faster with enhanced quick jump links. - This is an Add-On plugin for Toolbar Extras.
 * Version:           1.1.0
 * Author:            David Decker - DECKERWEB
 * Author URI:        https://toolbarextras.com/
 * License:           GPL-2.0-or-later
 * License URI:       https://opensource.org/licenses/GPL-2.0
 * Text Domain:       toolbar-extras-mainwp
 * Domain Path:       /languages/
 * Requires WP:       4.7
 * Requires PHP:      5.6
 * GitHub Plugin URI: https://github.com/deckerweb/toolbar-extras-mainwp
 * GitHub Branch:     master
 *
 * Copyright (c) 2018-2019 David Decker - DECKERWEB
 */

/**
 * Exit if called directly.
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit( 'Sorry, you are not allowed to access this file directly.' );
}


/**
 * Setting constants.
 *
 * @since 1.0.0
 */
/** Plugin version */
define( 'TBEXMWP_PLUGIN_VERSION', '1.1.0' );

/** Required base plugin version */
define( 'TBEXMWP_REQUIRED_BASE_PLUGIN_VERSION', '1.4.6' );

/** Plugin directory */
define( 'TBEXMWP_PLUGIN_DIR', trailingslashit( dirname( __FILE__ ) ) );

/** Plugin base directory */
define( 'TBEXMWP_PLUGIN_BASEDIR', trailingslashit( dirname( plugin_basename( __FILE__ ) ) ) );

/** Plugin base URL */
define( 'TBEXMWP_PLUGIN_URL', trailingslashit( plugin_dir_url( __FILE__ ) ) );


add_action( 'init', 'ddw_tbexmwp_load_translations', 1 );
/**
 * Load the text domain for translation of the plugin.
 *
 * @since 1.0.0
 *
 * @uses get_user_locale()
 * @uses load_textdomain() To load translations first from WP_LANG_DIR sub folder.
 * @uses load_plugin_textdomain() To additionally load default translations from plugin folder (default).
 */
function ddw_tbexmwp_load_translations() {

	/** Set unique textdomain string */
	$tbexmwp_textdomain = 'toolbar-extras-mainwp';

	/**
	 * The 'plugin_locale' filter is also used by default in
	 *   load_plugin_textdomain()
	 */
	$locale = esc_attr(
		apply_filters(
			'plugin_locale',
			get_user_locale(),
			$tbexmwp_textdomain
		)
	);

	/**
	 * WordPress languages directory
	 *   Will default to:
	 *   wp-content/languages/toolbar-extras-mainwp/toolbar-extras-mainwp-{locale}.mo
	 */
	$tbexmwp_wp_lang_dir = trailingslashit( WP_LANG_DIR ) . trailingslashit( $tbexmwp_textdomain ) . $tbexmwp_textdomain . '-' . $locale . '.mo';

	/**
	 * Translations: Firstly, look in WordPress' "languages" folder = custom and
	 *   update-safe!
	 */
	load_textdomain(
		$tbexmwp_textdomain,
		$tbexmwp_wp_lang_dir
	);

	/**
	 * Translations: Secondly, look in 'wp-content/languages/plugins/' for the
	 *   proper .mo file (= default)
	 */
	load_plugin_textdomain(
		$tbexmwp_textdomain,
		FALSE,
		TBEXMWP_PLUGIN_BASEDIR . 'languages'
	);

}  // end function


/**
 * Check for a plugin path if plugin is installed.
 *
 * @since 1.0.0
 *
 * @uses get_plugins()
 *
 * @param string $plugin Unique handle of plugin to check for.
 * @return bool TRUE if checked plugin is in the list of installed plugins,
 *              FALSE otherwise.
 */
function ddw_tbexmwp_is_plugin_installed( $plugin = '' ) {

	$file_path = '';

	if ( 'tbex' === sanitize_key( $plugin ) ) {
		$file_path = 'toolbar-extras/toolbar-extras.php';
	}

	if ( 'mainwp' === sanitize_key( $plugin ) ) {
		$file_path = 'mainwp/mainwp.php';
	}

	$installed_plugins = get_plugins();

	return isset( $installed_plugins[ $file_path ] );

}  // end function


add_action( 'plugins_loaded', 'ddw_tbexmwp_check_plugin_environment' );
/**
 * Check the environment for required base plugin Toolbar Extras (available for
 *   free on the official plugin directory at WordPress.org).
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_load_translations()
 */
function ddw_tbexmwp_check_plugin_environment() {

	/** Load translations first. Just to be sure. */
	ddw_tbexmwp_load_translations();

	/** 1st case: Plugin is not installed or not activated yet */
	if ( ! defined( 'TBEX_PLUGIN_VERSION' )	) {

		add_action( 'admin_notices', 'ddw_tbexmwp_activation_missing_toolbar_extras' );
		return;

	}  // end if

	/** 2nd case: Plugin is installed & active but needs an update */
	//$tbex_version_required = '1.3.5';

	if ( version_compare( TBEX_PLUGIN_VERSION, TBEXMWP_REQUIRED_BASE_PLUGIN_VERSION, '<' ) ) {

		add_action( 'admin_notices', 'ddw_tbexmwp_activation_needs_update_toolbar_extras' );
		return;

	}  // end if

}  // end function


/**
 * Styling tweak for our admin notices.
 *
 * @since 1.0.0
 *
 * @return string Echoing inline CSS styles.
 */
function ddw_tbexmwp_activation_style_tweaks() {

	?>
		<style type="text/css">
			.tbexmwp-notice .dashicons-before:before {
				clear: left;
				color: #f15959;
				display: block;
				float: left;
				font-size: 60px;
				padding: 5px 60px 5px 10px;
			}
			.tbex-notice-button {
				display: inline-block;
				font-weight: 500;
			}
		</style>
	<?php

}  // end function


/**
 * Activation Logic: Show an admin (error) notice if the Toolbar Extras plugin
 *   is either not installed or not activated yet.
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_is_plugin_installed()
 *
 * @return string Echoing markup and string of admin notice message.
 */
function ddw_tbexmwp_activation_missing_toolbar_extras() {

	/** Bail early if in Network Admin in Multisite */
	if ( is_network_admin() ) {
		return;
	}

	/** Avoid doublicated notices on plugin update screen */
	$screen = get_current_screen();

	if ( isset( $screen->parent_file )
		&& 'plugins.php' === $screen->parent_file
		&& 'update' === $screen->id
	) {
		return;
	}

	/** Set main file path of base plugin */
	$plugin = 'toolbar-extras/toolbar-extras.php';

	if ( ddw_tbexmwp_is_plugin_installed( 'tbex' ) ) {

		if ( ! current_user_can( 'activate_plugins' ) ) {
			return;
		}

		$activation_link = wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . $plugin . '&amp;plugin_status=all&amp;paged=1&amp;s', 'activate-plugin_' . $plugin );

		$message = sprintf(
			'<p class="dashicons-before dashicons-info">' . __( 'The needed base plugin %s is already installed but not activated. (Toolbar Extras for MainWP is an Add-On plugin which DEPENDS on Toolbar Extras.)', 'toolbar-extras-mainwp' ) . '</p>',
			'<strong>' . esc_html__( 'Toolbar Extras', 'toolbar-extras-mainwp' ) . '</strong>'
		);
		$message .= sprintf(
			'<p class="tbex-notice-button"><a href="%s" class="button-primary">&rarr; %s</a></p>',
			$activation_link,
			esc_html__( 'Activate Toolbar Extras Now', 'toolbar-extras-mainwp' )
		);

	} else {

		if ( ! current_user_can( 'install_plugins' ) ) {
			return;
		}

		$install_link = wp_nonce_url( self_admin_url( 'update.php?action=install-plugin&plugin=toolbar-extras' ), 'install-plugin_toolbar-extras' );

		$message = sprintf(
			/* translators: %1$s - name of the base plugin "Toolbar Extras" / %2$s - required version of base plugin, for example: 1.4.3 */
			'<p class="dashicons-before dashicons-info">' . __( 'Toolbar Extras for MainWP is an Add-On plugin which DEPENDS on the (free) %1$s plugin in version %2$s or higher to be installed and activated.', 'toolbar-extras-mainwp' ) . '</p>',
			'<strong>' . esc_html__( 'Toolbar Extras', 'toolbar-extras-mainwp' ) . '</strong>',
			TBEXMWP_REQUIRED_BASE_PLUGIN_VERSION
		);
		$message .= sprintf(
			'<p class="tbex-notice-button"><a href="%s" class="button-primary">&rarr; %s</a></p>',
			$install_link,
			esc_html__( 'Install Toolbar Extras Now', 'toolbar-extras-mainwp' )
		);

	}  // end if

	/** Setup HTML notice message and echo it */
	$html_message = sprintf(
		'<div class="notice error is-dismissible tbexmwp-notice">%s</div>',
		wpautop( $message )
	);

	ddw_tbexmwp_activation_style_tweaks();

	echo wp_kses_post( $html_message );

}  // end function


/**
 * Activation Logic: Show an admin (error) notice if the Toolbar Extras plugin
 *   is active but still on an older version (below v1.4.0).
 *
 * @since 1.0.0
 *
 * @return string Echoing markup and string of admin notice message.
 */
function ddw_tbexmwp_activation_needs_update_toolbar_extras() {

	/** Bail early if current user cannot update plugins */
	if ( ! current_user_can( 'update_plugins' ) ) {
		return;
	}

	/** Set main file path of base plugin */
	$file_path = 'toolbar-extras/toolbar-extras.php';

	$upgrade_link = wp_nonce_url( self_admin_url( 'update.php?action=upgrade-plugin&plugin=' ) . $file_path, 'upgrade-plugin_' . $file_path );

	$message = sprintf(
		'<p class="dashicons-before dashicons-info">' . __( 'Toolbar Extras for MainWP is not working yet because you are using an old version of the base plugin %s.', 'toolbar-extras-mainwp' ) . '</p>',
		'<strong>' . esc_html__( 'Toolbar Extras', 'toolbar-extras-mainwp' ) . '</strong>'
	);
	$message .= sprintf(
		'<p class="tbex-notice-button"><a href="%s" class="button-primary">&rarr; %s</a></p>',
		$upgrade_link,
		esc_html__( 'Update Toolbar Extras Now', 'toolbar-extras-mainwp' )
	);

	/** Setup HTML notice message and echo it */
	$html_message = sprintf(
		'<div class="notice error is-dismissible tbexmwp-notice">%s</div>',
		wpautop( $message )
	);

	ddw_tbexmwp_activation_style_tweaks();

	echo wp_kses_post( $html_message );

}  // end function


/** Include global functions */
require_once TBEXMWP_PLUGIN_DIR . 'includes/functions-global.php';

/** Include (global) conditionals functions */
require_once TBEXMWP_PLUGIN_DIR . 'includes/functions-conditionals.php';

/** Include string functions */
require_once TBEXMWP_PLUGIN_DIR . 'includes/string-switcher.php';


/** Include function for settings updates on version changes functions */
require_once TBEXMWP_PLUGIN_DIR . 'includes/tbexmwp-update-settings.php';


/**
 * Steps of the plugin activation routine.
 *
 * @since 1.0.0
 *
 * @see includes/admin/tbexmwp-settings.php
 *
 * @uses ddw_tbexmwp_register_settings_mainwp()
 */
function ddw_tbexmwp_addon_activation_routine() {

	/** Bail early if permissions are not in place */
	if ( ! current_user_can( 'activate_plugins' ) ) {
		return;
	}

	/**
	 * During run of the activation hook no other hooks and functions are
	 *   available, so we need to load them temporarily.
	 * @link https://premium.wpmudev.org/blog/activate-deactivate-uninstall-hooks/
	 */
	ddw_tbexmwp_load_translations();
	require_once TBEXMWP_PLUGIN_DIR . 'includes/admin/tbexmwp-settings.php';

	/** Register our settings and save the defaults */
	ddw_tbexmwp_register_settings_mainwp();

}  // end function


register_activation_hook( __FILE__, 'ddw_tbexmwp_run_addon_activation', 10, 1 );
/**
 * On plugin activation register the plugin's options and save their defaults.
 *
 * @since 1.0.0
 *
 * @link https://leaves-and-love.net/blog/making-plugin-multisite-compatible/
 *
 * @uses ddw_tbexmwp_addon_activation_routine()
 */
function ddw_tbexmwp_run_addon_activation( $network_wide ) {

	/** 1st case: Network-wide activation in a Multisite Network */
    if ( is_multisite() && $network_wide ) {

    	$site_ids = get_sites( array( 'fields' => 'ids', 'network_id' => get_current_network_id() ) );

        foreach ( $site_ids as $site_id ) {

        	/** Run Site after Site */
            switch_to_blog( $site_id );

            ddw_tbexmwp_addon_activation_routine();

            restore_current_blog();

        }  // end foreach

    }

    /** 2nd case: Activation on a regular single site install */
    else {

        ddw_tbexmwp_addon_activation_routine();

    }  // end if

}  // end function


add_action( 'wpmu_new_blog', 'ddw_tbexmwp_network_new_site_run_addon_activation', 10, 6 );
/**
 * When creating a new Site within a Multisite Network run the plugin activation
 *   routine - if Toolbar Extras is activated Network-wide.
 *   Note: The 'wpmu_new_blog' hook fires only in Multisite.
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_addon_activation_routine()
 */
function ddw_tbexmwp_network_new_site_run_addon_activation( $blog_id, $user_id, $domain, $path, $site_id, $meta ) {

    if ( is_plugin_active_for_network( TBEX_PLUGIN_BASEDIR . 'toolbar-extras.php' )					// base plugin
    	&& is_plugin_active_for_network( TBEXMWP_PLUGIN_BASEDIR . 'toolbar-extras-mainwp.php' )		// add-on plugin
	) {

        switch_to_blog( $blog_id );

        ddw_tbexmwp_addon_activation_routine();

        restore_current_blog();

    }  // end if

}  // end function


add_action( 'plugins_loaded', 'ddw_tbexmwp_setup_plugin_manager', 50 );
/**
 * Setup Plugin Manager of Toolbar Extras v1.4.3 or higher for suggested plugins
 *   for this Add-On to be used within the required/ recommended environment.
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_is_toolbar_extras_active()
 */
function ddw_tbexmwp_setup_plugin_manager() {

	/** Include admin helper functions */
	if ( is_admin() ) {

		if ( ddw_tbexmwp_is_toolbar_extras_active()
			&& version_compare( TBEX_PLUGIN_VERSION, TBEXMWP_REQUIRED_BASE_PLUGIN_VERSION, '>=' )
		) {
			require_once TBEXMWP_PLUGIN_DIR . 'includes/plugin-manager.php';
		}

	}  // end if

}  // end function


add_action( 'plugins_loaded', 'ddw_tbexmwp_setup_plugin', 20 );
/**
 * Finally setup the plugin for the main tasks.
 *   Note: The setup fires after all activation checks and routines.
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_is_toolbar_extras_active()
 * @uses ddw_tbexmwp_is_mainwp_active()
 */
function ddw_tbexmwp_setup_plugin() {

	/** Bail early if no TBEX */
	if ( ! ddw_tbexmwp_is_toolbar_extras_active() ) {
		return;
	}

	/** Include admin helper functions */
	if ( is_admin() ) {

		require_once TBEXMWP_PLUGIN_DIR . 'includes/admin/admin-help.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/admin/admin-extras.php';

	}  // end if

	/** Load plugin's settings */
	require_once TBEXMWP_PLUGIN_DIR . 'includes/admin/tbexmwp-settings.php';

	/** Load needed files if required plugins are active */
	if ( ddw_tbexmwp_is_toolbar_extras_active() && ddw_tbexmwp_is_mainwp_active() ) {

		require_once TBEXMWP_PLUGIN_DIR . 'includes/tbexmwp-styles.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/tweaks.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/items-tbexmwp.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/items-mainwp.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/items-mainwp-resources.php';
		require_once TBEXMWP_PLUGIN_DIR . 'includes/mainwp-extensions.php';

		if ( ddw_tbexmwp_display_child_sites_subitems() ) {
			require_once TBEXMWP_PLUGIN_DIR . 'includes/items-mainwp-sites.php';
		}

		if ( ddw_tbexmwp_display_groups_subitems() ) {
			require_once TBEXMWP_PLUGIN_DIR . 'includes/items-mainwp-groups.php';
		}

		if ( ddw_tbexmwp_display_statuses_subitems() ) {
			require_once TBEXMWP_PLUGIN_DIR . 'includes/items-mainwp-statuses.php';
		}

	}  // end if

	/** Add links to Settings and Menu pages to Plugins page */
	if ( ( is_admin() || is_network_admin() )
		&& ( current_user_can( 'manage_options' ) )
	) {

		add_filter(
			'plugin_action_links_' . plugin_basename( __FILE__ ),
			'ddw_tbexmwp_custom_settings_links'
		);

		add_filter(
			'network_admin_plugin_action_links_' . plugin_basename( __FILE__ ),
			'ddw_tbexmwp_custom_settings_links'
		);

	}  // end if

}  // end function


add_filter( 'mainwp-getextensions', 'ddw_tbexmwp_register_mainwp_extension', 10, 1 );
/**
 * Register our extension to MainWP Extension array and page listing.
 *
 * @since 1.0.0
 *
 * @param array $plugins Array which holds all registered MainWP Extensions.
 * @return array Modified array of MainWP Extensions.
 */
function ddw_tbexmwp_register_mainwp_extension( $plugins ) {

	$plugins[] = array(
		'plugin'     => __FILE__,
		'api'        => '',	//basename( __FILE__, '.php' ),
		'apiManager' => '',
		'mainwp'     => FALSE,
		'callback'   => 'ddw_tbexmwp_mainwp_extension_page_redirect',
		'icon'       => TBEXMWP_PLUGIN_URL . 'assets/images/icon-tbexmwp.png',
	);

	return $plugins;

}  // end function


add_action( 'load-mainwp_page_Extensions-Toolbar-Extras-Mainwp', 'ddw_tbexmwp_mainwp_extension_page_redirect' );
/**
 * Redirect from the generated "virtual" MainWP Extension's admin page to our
 *   real admin settings page (dedicated tab on Toolbar Extras page).
 *   Note I: Generated screen ID from get_current_screen() is:
 *           'mainwp_page_Extensions-Toolbar-Extras-Mainwp'
 *   Note II: Since MainWP Dashboard currently doesn't support callbacks to
 *            existing setting pages we have to use wp_safe_redirect() for the
 *            time being.
 *
 * @since 1.0.0
 *
 * @TODO Proper callback support in MainWP - GitHub issue upcoming...! ;-)
 */
function ddw_tbexmwp_mainwp_extension_page_redirect() {

	wp_safe_redirect( admin_url( 'options-general.php?page=toolbar-extras&tab=mainwp' ) );
	die;

}  // end function


add_filter( 'tbex_filter_unloading_textdomains', 'ddw_tbexmwp_tweak_unload_textdomain_toolbar_extras_mainwp' );
/**
 * Unload Textdomain for "Toolbar Extras for MainWP" plugin.
 *
 * @since 1.0.0
 *
 * @uses ddw_tbexmwp_use_tweak_unload_translations_tbexmwp()
 *
 * @param array $textdomains Array of textdomains.
 * @return array Modified array of textdomains for unloading.
 */
function ddw_tbexmwp_tweak_unload_textdomain_toolbar_extras_mainwp( $textdomains ) {

	/** Bail early if tweak shouldn't be used */
	if ( ! ddw_tbexmwp_use_tweak_unload_translations_tbexmwp() ) {
		return $textdomains;
	}

	$tbexmwp_domains = array( 'toolbar-extras-mainwp' );

	return array_merge( $textdomains, $tbexmwp_domains );

}  // end function