*/
// Exit if accessed directly
if (!defined('ABSPATH')) {
exit;
}
require_once LEAFLET_MAP__PLUGIN_DIR . 'class.plugin-option.php';
// TODO: add option to reset just a single field
/**
* Used to get and set values
*
* Features:
* * Add prefixes to db options
* * built-in admin settings page method
*/
class Leaflet_Map_Plugin_Settings
{
/**
* Prefix for options, for unique db entries
*
* @var string $prefix
*/
public $prefix = 'leaflet_';
/**
* Singleton instance
*
* @var Leaflet_Map_Plugin_Settings
**/
private static $_instance = null;
/**
* Default values and admin form information
* Needs to be created within __construct
* in order to use a function such as __()
*
* @var array $options
*/
public $options = array();
/**
* Singleton
*
* @static
*
* @return Leaflet_Map_Plugin_Settings
*/
public static function init() {
if ( !self::$_instance ) {
self::$_instance = new self;
}
return self::$_instance;
}
/**
* Instantiate the class
*/
private function __construct()
{
/* update leaflet version from main class */
$leaflet_version = Leaflet_Map::$leaflet_version;
$foreachmap = __('You can also change this for each map', 'leaflet-map');
/*
* initiate options using internationalization!
*/
$this->options = array(
'default_lat' => array(
'display_name'=>__('Default Latitude', 'leaflet-map'),
'default'=>'44.67',
'type' => 'number',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map lat="44.67"]',
__('Default latitude for maps.', 'leaflet-map'),
$foreachmap
)
),
'default_lng' => array(
'display_name'=>__('Default Longitude', 'leaflet-map'),
'default'=>'-63.61',
'type' => 'number',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map lng="-63.61"]',
__('Default longitude for maps.', 'leaflet-map'),
$foreachmap
)
),
'default_zoom' => array(
'display_name'=>__('Default Zoom', 'leaflet-map'),
'default'=>'12',
'type' => 'number',
'min' => 0,
'max' => 20,
'step' => 1,
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map zoom="5"]',
__('Default zoom for maps.', 'leaflet-map'),
$foreachmap
)
),
'default_height' => array(
'display_name'=>__('Default Height', 'leaflet-map'),
'default'=>'250',
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map height="250"]',
__('Default height for maps. Values can include "px" but it is not necessary. Can also be "%". ', 'leaflet-map'),
$foreachmap
)
),
'default_width' => array(
'display_name'=>__('Default Width', 'leaflet-map'),
'default'=>'100%',
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map width="100%%"]',
__('Default width for maps. Values can include "px" but it is not necessary. Can also be "%".', 'leaflet-map'),
$foreachmap
)
),
'fit_markers' => array(
'display_name'=>__('Fit Bounds', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map fitbounds]',
__('If enabled, all markers on each map will alter the view of the map; i.e. the map will fit to the bounds of all of the markers on the map.', 'leaflet-map'),
$foreachmap
)
),
'show_zoom_controls' => array(
'display_name'=>__('Show Zoom Controls', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map !zoomcontrol]',
__('The zoom buttons can be large and annoying.', 'leaflet-map'),
$foreachmap
)
),
'scroll_wheel_zoom' => array(
'display_name'=>__('Scroll Wheel Zoom', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map !scrollwheel]',
__('Disable zoom with mouse scroll wheel. Sometimes someone wants to scroll down the page, and not zoom the map.', 'leaflet-map'),
$foreachmap
)
),
'double_click_zoom' => array(
'display_name'=>__('Double Click Zoom', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map !doubleClickZoom]',
__('If enabled, your maps will zoom with a double click. By default it is disabled: If we\'re going to remove zoom controls and have scroll wheel zoom off by default, we might as well stick to our guns and not zoom the map.', 'leaflet-map'),
$foreachmap
)
),
'default_min_zoom' => array(
'display_name'=>__('Default Min Zoom', 'leaflet-map'),
'default' => '0',
'type' => 'number',
'min' => 0,
'max' => 20,
'step' => 1,
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map min_zoom="1"]',
__('Restrict the viewer from zooming in past the minimum zoom. Can set per map in shortcode or adjust for all maps here.', 'leaflet-map'),
$foreachmap
)
),
'default_max_zoom' => array(
'display_name'=>__('Default Max Zoom', 'leaflet-map'),
'default' => '19',
'type' => 'number',
'min' => 0,
'max' => 20,
'step' => 1,
'helptext' => sprintf(
'%1$s %2$s
%3$s',
__('Restrict the viewer from zooming out past the maximum zoom. Can set per map in shortcode or adjust for all maps here', 'leaflet-map'),
$foreachmap,
'[leaflet-map max_zoom="10"]'
)
),
'default_tiling_service' => array(
'display_name'=>__('Default Tiling Service', 'leaflet-map'),
'default' => 'other',
'type' => 'select',
'options' => array(
'other' => __('I will provide my own map tile URL', 'leaflet-map'),
'mapquest' => __('MapQuest (I have an API key)', 'leaflet-map'),
),
'helptext' => __('Choose a tiling service or provide your own.', 'leaflet-map')
),
'mapquest_appkey' => array(
'display_name'=>__('MapQuest API Key (optional)', 'leaflet-map'),
'default' => '',
'placeholder' => __('Supply an API key if you choose MapQuest', 'leaflet-map'),
'type' => 'text',
'noreset' => true,
'helptext' => sprintf(
'%1$s %2$s , %3$s %4$s %5$s',
__('If you choose MapQuest, you must provide an API key.', 'leaflet-map'),
__('Sign up', 'leaflet-map'),
__('then', 'leaflet-map'),
__('Create a new app', 'leaflet-map'),
__('then supply the "Consumer Key" here.', 'leaflet-map')
)
),
'map_tile_url' => array(
'display_name'=>__('Map Tile URL', 'leaflet-map'),
'default'=>'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
'type' => 'text',
'helptext' => sprintf(
'%1$s: %2$s . %3$s: %4$s . %5$s
[leaflet-map tileurl=http://{s}.example.com/{z}/{x}/{y}.jpg subdomains=abcd]',
__('See more tile servers', 'leaflet-map'),
__('here', 'leaflet-map'),
__('Please note: free tiles from MapQuest have been discontinued without use of an API key', 'leaflet-map'),
__('blog post', 'leaflet-map'),
$foreachmap
)
),
'map_tile_url_subdomains' => array(
'display_name'=>__('Map Tile URL Subdomains', 'leaflet-map'),
'default'=>'',
'placeholder'=>'abc',
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map subdomains="1234"]',
__('Some maps get tiles from multiple servers with subdomains such as a,b,c or 1,2,3 or cache1,cache2; pass a string where each char is its own subdomain, or pass comma-separated string', 'leaflet-map'),
$foreachmap
)
),
'detect_retina' => array(
'display_name' => __('Detect Retina', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map detect-retina]',
__('Fetch tiles at different zoom levels to appear smoother on retina displays.', 'leaflet-map'),
$foreachmap
)
),
'tilesize' => array(
'display_name' => __('Tile Size', 'leaflet-map'),
'default' => null,
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map tilesize=512]',
__('Width and height of tiles (in pixels) in the grid. Default is 256', 'leaflet-map'),
$foreachmap
)
),
'mapid' => array(
'display_name' => __('Tile Id', 'leaflet-map'),
'default' => null,
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map mapid="mapbox/streets-v11"]',
__('An id that is passed to L.tileLayer; useful for Mapbox', 'leaflet-map'),
$foreachmap
)
),
'accesstoken' => array(
'display_name' => __('Access Token', 'leaflet-map'),
'default' => null,
'type' => 'text',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map accesstoken="your.mapbox.access.token"]',
__('An access token that is passed to L.tileLayer; useful for Mapbox tiles', 'leaflet-map'),
$foreachmap
)
),
'zoomoffset' => array(
'display_name' => __('Zoom Offset', 'leaflet-map'),
'default' => null,
'type' => 'number',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map zoomoffset="-1"]',
__('The zoom number used in tile URLs will be offset with this value', 'leaflet-map'),
$foreachmap
)
),
'tile_no_wrap' => array(
'display_name' => __('No Wrap (tiles)', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => sprintf(
'%1$s %2$s
[leaflet-map nowrap]',
__('Boolean for whether the layer is wrapped around the antimeridian', 'leaflet-map'),
$foreachmap
)
),
'js_url' => array(
'display_name'=>__('JavaScript URL', 'leaflet-map'),
'default' => sprintf('https://unpkg.com/leaflet@%s/dist/leaflet.js', $leaflet_version),
'type' => 'text',
'helptext' => __('If you host your own Leaflet files, then paste the URL here.', 'leaflet-map')
),
'css_url' => array(
'display_name'=>__('CSS URL', 'leaflet-map'),
'default' => sprintf('https://unpkg.com/leaflet@%s/dist/leaflet.css', $leaflet_version),
'type' => 'text',
'helptext' => __('Same as above.', 'leaflet-map')
),
'default_attribution' => array(
'display_name' => __('Default Attribution', 'leaflet-map'),
'default' => sprintf(
'Leaflet; © OpenStreetMap %2$s',
__("A JS library for interactive maps", 'leaflet-map'),
__("contributors", 'leaflet-map')
),
'type' => 'textarea',
'helptext' => __('Attribution to a custom tile url. Use semi-colons (;) to separate multiple.', 'leaflet-map')
),
'show_scale' => array(
'display_name' => __('Show Scale', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
'helptext' => __(
'Add a scale to each map. Can also be added via shortcode
[leaflet-scale]',
'leaflet-map'
)
),
'geocoder' => array(
'display_name'=>__('Geocoder', 'leaflet-map'),
'default' => 'osm',
'type' => 'select',
'options' => array(
'osm' => __('OpenStreetMap Nominatim', 'leaflet-map'),
'google' => __('Google Maps', 'leaflet-map'),
'dawa' => __('Denmark Addresses', 'leaflet-map')
),
'helptext' => __('Select the Geocoding provider to use to retrieve addresses defined in shortcode.', 'leaflet-map')
),
'nominatim_contact_email' => array(
'display_name'=>__('Nominatim Contact Email (optional)', 'leaflet-map'),
'default' => '',
'type' => 'email',
'placeholder' => sprintf(
__('defaults to admin email (%s)', 'leaflet-map'),
get_bloginfo('admin_email')
),
'helptext' => __(
'Optional contact email to send with OpenStreetMap Nominatim geocoding requests. If blank, the site admin email will be used.',
'leaflet-map'
),
),
'google_appkey' => array(
'display_name'=>__('Google API Key (optional)', 'leaflet-map'),
'default' => '',
'placeholder' => __('Supply a Google API Key', 'leaflet-map'),
'type' => 'text',
'noreset' => true,
'helptext' => sprintf(
'%1$s: %2$s. %3$s %4$s',
__('The Google Geocoder requires an API key with the Places product enabled', 'leaflet-map'),
__('here', 'leaflet-map'),
__('You must create a project and set up a billing account, then you will be given an API key.', 'leaflet-map'),
__('You are unlikely to ever be charged for geocoding.', 'leaflet-map')
),
),
'togeojson_url' => array(
'display_name'=>__('KML/GPX JavaScript Converter', 'leaflet-map'),
'default' => 'https://unpkg.com/@mapbox/togeojson@0.16.0/togeojson.js',
'type' => 'text',
'helptext' => __('ToGeoJSON converts KML and GPX files to GeoJSON; if you plan to use [leaflet-kml] or [leaflet-gpx] then this library is loaded. You can change the default if you need.', 'leaflet-map')
),
'shortcode_in_excerpt' => array(
'display_name' => __('Show maps in excerpts', 'leaflet-map'),
'default' => '0',
'type' => 'checkbox',
),
);
foreach ($this->options as $name => $details) {
$this->options[ $name ] = new Leaflet_Map_Plugin_Option($details);
}
}
/**
* Wrapper for WordPress get_options (adds prefix to default options)
*
* @param string $key
*
* @return varies
*/
public function get($key)
{
$default = $this->options[ $key ]->default;
$key = $this->prefix . $key;
return get_option($key, $default);
}
/**
* Wrapper for WordPress update_option (adds prefix to default options)
*
* @param string $key Unique db key
* @param varies $value Value to insert
*
* @return Leaflet_Map_Plugin_Settings
*/
public function set ($key, $value) {
$key = $this->prefix . $key;
update_option($key, $value);
return $this;
}
/**
* Wrapper for WordPress delete_option (adds prefix to default options)
*
* @param string $key Unique db key
*
* @return boolean
*/
public function delete($key)
{
$key = $this->prefix . $key;
return delete_option($key);
}
/**
* Delete all options
*
* @return Leaflet_Map_Plugin_Settings
*/
public function reset()
{
foreach ($this->options as $name => $option) {
if (
!property_exists($option, 'noreset') ||
$option->noreset != true
) {
$this->delete($name);
}
}
return $this;
}
}