settings menu */
add_action('admin_menu', array($this, 'add_to_settings_menu'));
/* Show warning if debug mode is on */
add_action('admin_notices', array($this, 'show_admin_notice'));
/*check for database upgrades*/
add_action('plugins_loaded', array($this, 'may_be_upgrade'));
add_action('plugins_loaded', array($this, 'load_text_domain'));
}
/**
* Function to instantiate our class and make it a singleton
*/
public static function get_instance()
{
$cls = get_called_class();
if (!isset(self::$instances[$cls])) {
self::$instances[$cls] = new static;
}
return self::$instances[$cls];
}
protected function __clone()
{
//don't not allow clones
}
public function __wakeup()
{
throw new Exception("Cannot unserialize singleton");
}
public static function load_text_domain()
{
load_plugin_textdomain('ank-simplified-ga', false, dirname(ASGA_BASE_FILE) . '/languages/');
}
/*
* Save default settings upon plugin activation
*/
function do_upon_plugin_activation()
{
//if options not exists then update with defaults
if (get_option(ASGA_OPTION_NAME) == false) {
update_option(ASGA_OPTION_NAME, $this->get_default_options());
}
}
/*Register our settings, using WP settings API*/
function register_plugin_settings()
{
register_setting(self::PLUGIN_OPTION_GROUP, ASGA_OPTION_NAME, array($this, 'ASGA_validate_options'));
}
/**
* Adds a 'Settings' link for this plugin on plugin listing page
*
* @param $links
* @return array Links array
*/
function add_plugin_actions_links($links)
{
if (current_user_can('manage_options')) {
$build_url = add_query_arg('page', self::PLUGIN_SLUG, 'options-general.php');
array_unshift(
$links,
sprintf('%s', $build_url, __('Settings',ASGA_TEXT_DOMAIN))
);
}
return $links;
}
/*
* Adds link to Plugin Option page + do related stuff
*/
function add_to_settings_menu()
{
$page_hook_suffix = add_submenu_page('options-general.php', 'Ank Simplified Google Analytics', 'Google Analytics', 'manage_options', self::PLUGIN_SLUG, array($this, 'ASGA_options_page'));
/*add help stuff via tab*/
add_action("load-$page_hook_suffix", array($this, 'add_help_menu_tab'));
/*we can load additional css/js to our option page here */
}
/**
* Return all roles plus superAdmin if multi-site is enabled
* @return array
*/
private function get_all_roles()
{
global $wp_roles;
if (!isset($wp_roles)) {
$wp_roles = new WP_Roles();
}
$role_list = $wp_roles->get_names();
//append a custom role if multi-site is enabled
if (is_multisite()) {
$role_list['networkAdmin'] = __('Network Administrator', ASGA_TEXT_DOMAIN);
}
return $role_list;
}
/**
* Return default options for this plugin
* @return array
*/
private function get_default_options()
{
$defaults = array(
'plugin_ver' => ASGA_PLUGIN_VER,
'ga_id' => '',
'js_location' => 1,
'js_load_later' => 0,
'js_priority' => 20,
'log_404' => 0,
'log_search' => 0,
'ua_enabled' => 1,
'displayfeatures' => 0,
'ga_ela' => 0,
'anonymise_ip' => 0,
'ga_domain' => '',
'debug_mode' => 0,
'force_ssl' => 1,
'custom_trackers' => '',
'allow_linker' => 0 ,
'allow_anchor' => 0,
'webmaster' => array(
'google_code' => ''
)
);
//store roles as well
foreach ($this->get_all_roles() as $role => $role_info) {
$defaults['ignore_role_' . $role] = 0;
}
return $defaults;
}
/**
* Callback Function to handle and validate the form data
*
* @param array $in - POST array
* @returns array - Validated array
*/
function ASGA_validate_options($in)
{
$out = array();
//always store plugin version to db
$out['plugin_ver'] = ASGA_PLUGIN_VER;
// Get the actual tracking ID
if (!preg_match('|^UA-\d{4,}-\d+$|', (string)$in['ga_id'])) {
$out['ga_id'] = '';
//warn user that the entered id is not valid
add_settings_error(ASGA_OPTION_NAME, 'ga_id', __('Your GA tracking ID seems invalid. Please validate.', ASGA_TEXT_DOMAIN));
} else {
$out['ga_id'] = sanitize_text_field($in['ga_id']);
}
$radio_items = array('js_location','js_load_later');
foreach($radio_items as $item){
$out[$item] = absint($in[$item]);
}
$out['js_priority'] = (empty($in['js_priority'])) ? 20 : absint($in['js_priority']);
$out['ga_domain'] = sanitize_text_field($in['ga_domain']);
$out['custom_trackers'] = trim($in['custom_trackers']);
$checkbox_items = array('ua_enabled', 'anonymise_ip', 'displayfeatures', 'ga_ela', 'log_404', 'log_search','debug_mode','force_ssl','allow_linker','allow_anchor');
//add rolls to checkbox_items array
foreach ($this->get_all_roles() as $role => $role_info) {
$checkbox_items[] = 'ignore_role_' . $role;
}
foreach ($checkbox_items as $item) {
if (isset($in[$item]) && '1' == $in[$item])
$out[$item] = 1;
else
$out[$item] = 0;
}
// Google webmaster code
$out['webmaster']['google_code'] = trim($in['webmaster']['google_code']);
return $out;
}
/**
* Function will print our option page form
*/
function ASGA_options_page()
{
if (!current_user_can('manage_options')) {
wp_die(__('You do not have sufficient permissions to access this page.', ASGA_TEXT_DOMAIN));
}
?>
add_help_tab(
array(
'id' => 'asga-overview',
'title' => 'Basic',
'content' => 'Do you have a Google Analytics Account ?
' .
'In order to use this plugin you need to have a Google Analytics Account. Create an account here. It is FREE.
' .
'How do i find my Google Analytics ID ?
' .
'Please check out this link
' .
'How do i view my stats ?
' .
'Login to Google Analytics Account with your G-Mail ID to view stats.' .
'
'
)
);
$curr_screen->add_help_tab(
array(
'id' => 'asga-troubleshoot',
'title' => 'Troubleshoot',
'content' => 'Things to remember
' .
'
'.
'- If you are using a cache/performance plugin, you need to flush/delete your site cache after saving settings here.
'.
'- It can take up to 24-48 hours after adding the tracking code before any analytical data appears in your Google Analytics account.
'.
'
'.
''
)
);
$curr_screen->add_help_tab(
array(
'id' => 'asga-more-info',
'title' => 'More',
'content' => 'Need more information ?
' .
'A brief FAQ is available to solve your common issues, ' .
'click here to read more.
' .
'Support is only available on WordPress Forums, click here to ask anything about this plugin.
' .
'You can also browse the source code of this plugin on GitHub. ' .
'
'
)
);
/*add a help sidebar with links */
$curr_screen->set_help_sidebar(
'Quick Links
' .
'Plugin FAQ
' .
'Plugin Home
'
);
}
/**
* Show a warning notice if debug mode is on
*/
function show_admin_notice()
{
if ($this->check_admin_notice()) {
?>
id, self::PLUGIN_SLUG) === false) return false;
$options = $this->get_safe_options();
//id ga id is not set return early
if (empty($options['ga_id'])) return false;
//if debug mode is off return early
if ($options['debug_mode'] == 0) return false;
//else return true
return true;
}
/**
* Get fail safe options
* @return array
*/
private function get_safe_options()
{
//get fresh options from db
$db_options = get_option(ASGA_OPTION_NAME);
//be fail safe, if not array then array_merge may fail
if(!is_array($db_options)) {$db_options=array();}
//if options not exists in db then init with defaults , also always append default options to existing options
$db_options = empty($db_options) ? $this->get_default_options() : array_merge($this->get_default_options(),$db_options);
return $db_options;
}
/**
* Upgrade plugin database options
*/
function may_be_upgrade()
{
//get fresh options from db
$db_options = get_option(ASGA_OPTION_NAME);
//check if we need to proceed , if no return early
if ($this->can_proceed_to_upgrade($db_options) === false) return;
//get default options
$default_options = $this->get_default_options();
//merge with db options , preserve old
$new_options = (empty($db_options)) ? $default_options : array_merge($default_options, $db_options);
//update plugin version
$new_options['plugin_ver'] = ASGA_PLUGIN_VER;
//write options back to db
update_option(ASGA_OPTION_NAME, $new_options);
}
/**
* Check if we need to upgrade database options or not
* @param $db_options
* @return bool|mixed
*/
private function can_proceed_to_upgrade($db_options)
{
if (empty($db_options) || !is_array($db_options)) return true;
if (!isset($db_options['plugin_ver'])) return true;
return version_compare($db_options['plugin_ver'], ASGA_PLUGIN_VER, '<');
}
} //end class