settings menu->ank google map */
add_action('admin_menu', array($this, 'add_submenu_page'));
/* Check for database upgrades*/
add_action('plugins_loaded', array($this, 'check_for_db_options'));
}
/*
* Save default settings upon plugin activation
*/
function do_upon_plugin_activation()
{
if (false == get_option('ank_google_map')) {
add_option('ank_google_map', $this->get_default_options());
}
}
/**
* Check if db options exists and create if not found
*/
function check_for_db_options()
{
$this->do_upon_plugin_activation();
}
/**
* Register plugin settings, using WP settings API
*/
function register_plugin_settings()
{
register_setting(self::PLUGIN_OPTION_GROUP, 'ank_google_map', array($this, 'validate_form_post'));
}
/**
* Returns default plugin db options
* @return array
*/
function get_default_options()
{
$default_options = array(
'plugin_ver' => AGM_PLUGIN_VERSION,
'div_width' => '100',
'div_width_unit' => 2,
'div_height' => '300',
'div_border_color' => '',
'map_Lat' => '28.613939100000003',
'map_Lng' => '77.20902120000005',
'map_zoom' => 2,
'map_control_2' => '0',
'map_control_3' => '0',
'map_control_4' => '0',
'map_lang_code' => '',
'map_type' => 1,
'marker_on' => '1',
'marker_title' => 'We are here',
'marker_anim' => 1,
'marker_color' => 1,
'info_on' => '1',
'info_text' => 'Your Destination',
'info_state' => '0',
'disable_mouse_wheel' => '0',
'disable_drag_mobile' => '1',
'api_key' => ''
);
return $default_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'))
);
}
return $links;
}
/**
* Register a page to display plugin options
*/
function add_submenu_page()
{
$page_hook_suffix = add_submenu_page('options-general.php', 'Ank Google Map', 'Google Map', 'manage_options', self::PLUGIN_SLUG, array($this, 'load_option_page'));
/*
* Add the color picker js + css file to option page
* Available for wp v3.5+ only
*/
add_action('admin_print_scripts-' . $page_hook_suffix, array($this, 'add_color_picker'));
/* Add help drop down menu on option page, wp v3.3+ */
add_action("load-$page_hook_suffix", array($this, 'add_help_menu_tab'));
add_action('admin_print_scripts-' . $page_hook_suffix, array($this, 'print_admin_assets'));
}
/**
* Validate form $_POST data
* @param $in array
* @return array Validated array
*/
function validate_form_post($in)
{
$out = array();
//always store plugin version to db
$out['plugin_ver'] = esc_attr(AGM_PLUGIN_VERSION);;
$out['div_width'] = sanitize_text_field($in['div_width']);
$out['div_height'] = sanitize_text_field($in['div_height']);
$out['div_width_unit'] = intval($in['div_width_unit']);
$out['div_border_color'] = sanitize_text_field($in['div_border_color']);
$out['map_Lat'] = sanitize_text_field($in['map_Lat']);
$out['map_Lng'] = sanitize_text_field($in['map_Lng']);
$out['map_zoom'] = intval($in['map_zoom']);
$out['map_lang_code'] = sanitize_text_field($in['map_lang_code']);
$out['map_type'] = intval($in['map_type']);
$out['marker_title'] = sanitize_text_field($in['marker_title']);
$out['marker_anim'] = intval($in['marker_anim']);
$out['marker_color'] = intval($in['marker_color']);
$out['api_key'] = sanitize_text_field($in['api_key']);
$choices_array = array('disable_mouse_wheel', 'disable_drag_mobile', 'map_control_2', 'map_control_3', 'map_control_4', 'marker_on', 'info_on', 'info_state');
foreach ($choices_array as $choice) {
$out[$choice] = (isset($in[$choice])) ? '1' : '0';
}
/*
* Lets allow some html in info window
* This is same as like we make a new post
*/
$out['info_text'] = balanceTags(wp_kses_post($in['info_text']), true);
return $out;
}
/**
* Load plugin option page view
* @throws \Exception
*/
function load_option_page()
{
if (!current_user_can('manage_options')) {
wp_die(__('You do not have sufficient permissions to access this page.'));
}
$file_path = plugin_dir_path(AGM_BASE_FILE) . 'views/options_page.php';
if (is_readable($file_path)) {
require $file_path;
} else {
throw new \Exception("Unable to load settings page, Template File '" . esc_html($file_path) . "'' not found, (v" . AGM_PLUGIN_VERSION . ")");
}
}
/**
* Decides whether to load text editor or not
* @param string $content
*/
private function get_text_editor($content = '')
{
if (user_can_richedit()) {
wp_editor($content, 'agm-info-editor',
array(
'media_buttons' => false, //disable media uploader
'textarea_name' => 'ank_google_map[info_text]',
'textarea_rows' => 5,
'teeny' => false,
'quicktags' => true
));
} else {
/*
* else Show normal text-area to user
*/
echo '';
}
}
/**
* Enqueue color picker related css and js
*/
function add_color_picker()
{
wp_enqueue_style('wp-color-picker');
wp_enqueue_script('wp-color-picker');
}
/**
* Returns dynamic javascript options to be used by admin js
* @return array
*/
private function get_js_options()
{
$options = get_option('ank_google_map');
return array(
'map' => array(
'lat' => esc_attr($options['map_Lat']),
'lng' => esc_attr($options['map_Lng']),
'zoom' => absint($options['map_zoom']),
)
);
}
/**
* Add option page javascript and css
*/
function print_admin_assets()
{
$is_min = (defined('WP_DEBUG') && WP_DEBUG == true) ? '' : '.min';
$db = get_option('ank_google_map');
wp_enqueue_style('agm-admin-css', plugins_url('css/option-page' . $is_min . '.css', AGM_BASE_FILE), array(), AGM_PLUGIN_VERSION, 'all');
$api_key = empty($db['api_key']) ? '' : '&key=' . esc_js($db['api_key']);
wp_enqueue_script('agm-google-map', 'https://maps.googleapis.com/maps/api/js?v=3.24&libraries=places' . $api_key, array(), null, true);
wp_enqueue_script('agm-admin-js', plugins_url("/js/option-page" . $is_min . ".js", AGM_BASE_FILE), array('jquery', 'agm-google-map'), AGM_PLUGIN_VERSION, true);
//wp inbuilt hack to print js options object just before this script
wp_localize_script('agm-admin-js', '_agm_opt', $this->get_js_options());
}
/*
* Add a help tab at top of plugin option page
*/
public static function add_help_menu_tab()
{
$curr_screen = get_current_screen();
$curr_screen->add_help_tab(
array(
'id' => 'agm-overview',
'title' => 'Overview',
'content' => 'Thanks for using "Ank Google Map"
' .
'This plugin allows you to put a custom Google Map on your website. Just configure options below and ' .
'save your settings. Copy/paste [ank_google_map] short-code on your page/post/widget to view your map.
'
)
);
$curr_screen->add_help_tab(
array(
'id' => 'agm-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.
- Only one map is supported at this time. Don't put short-code twice on the same page.
- Only one marker supported at this time, Marker will be positioned at the center of your map.
- Info Window needs marker to be enabled first.
'
)
);
$curr_screen->add_help_tab(
array(
'id' => 'agm-more-info',
'title' => 'More',
'content' => 'Need more information ?
' .
'A brief FAQ is available, ' .
'click here for more.
' .
'Support is only available on WordPress Forums, click here to ask anything about this plugin.
' .
'You can also report a bug at plugin's GitHub page.' .
'I will try to reply as soon as possible.
'
)
);
$curr_screen->set_help_sidebar(
'Quick Links
' .
'Plugin FAQ
' .
'Plugin Home
'
);
}
}