16, 'anim_duration' => 1.5, 'central_enabled' => false, // Bowden Works (Powell River, BC) — the plugin author's location, used as a placeholder // on fresh installs so the preview map shows something meaningful before the user has // configured their own location. 'central_lat' => 49.688234, 'central_lng' => -124.992516, 'central_title' => 'Bowden Works', 'central_icon_mode' => 'logo', // 'logo' | 'pin' | 'custom' 'central_custom_image_id' => 0, // attachment ID, used when icon_mode = 'custom' 'central_color' => '#f59e0b', // accent — background of the marker (image modes) or pin badge fill. 'show_distance' => true, 'distance_unit' => 'km', 'directions_label' => 'Get directions', ]; } /** * Get the merged settings (stored + defaults). */ public static function all() { $stored = get_option( self::OPTION_KEY, [] ); if ( ! is_array( $stored ) ) { $stored = []; } return wp_parse_args( $stored, self::defaults() ); } public static function get( $key ) { $all = self::all(); return isset( $all[ $key ] ) ? $all[ $key ] : null; } public function boot() { add_action( 'admin_menu', [ $this, 'register_page' ] ); add_action( 'admin_init', [ $this, 'register_settings' ] ); } public function register_page() { add_submenu_page( 'edit.php?post_type=' . BW_MAP_MAGNET_CPT, __( 'Map Magnet Settings', 'bw-map-magnet' ), __( 'Settings', 'bw-map-magnet' ), 'manage_options', 'bw-map-magnet-settings', [ $this, 'render_page' ] ); } public function register_settings() { register_setting( 'bw_map_magnet_settings_group', self::OPTION_KEY, [ 'type' => 'array', 'sanitize_callback' => [ $this, 'sanitize' ], 'default' => self::defaults(), ] ); add_settings_section( 'bw_map_magnet_main', __( 'Map behaviour', 'bw-map-magnet' ), function () { echo '

' . esc_html__( 'Defaults used by every map on the site. Individual shortcodes/blocks and individual map items can override these.', 'bw-map-magnet' ) . '

'; }, 'bw-map-magnet-settings' ); add_settings_field( 'default_zoom', __( 'Default hover zoom level', 'bw-map-magnet' ), [ $this, 'field_default_zoom' ], 'bw-map-magnet-settings', 'bw_map_magnet_main' ); add_settings_field( 'anim_duration', __( 'Animation duration (seconds)', 'bw-map-magnet' ), [ $this, 'field_anim_duration' ], 'bw-map-magnet-settings', 'bw_map_magnet_main' ); add_settings_section( 'bw_map_magnet_central', __( 'Central focus location', 'bw-map-magnet' ), function () { echo '

' . esc_html__( 'A pinned "home" location that stays visible on every map. Hovering an item zooms the map to show both the central location and the hovered item, so visitors can see distance at a glance. Popups can show the distance from this location and a "Get directions" link.', 'bw-map-magnet' ) . '

'; }, 'bw-map-magnet-settings' ); add_settings_field( 'central_enabled', __( 'Enable central location', 'bw-map-magnet' ), [ $this, 'field_central_enabled' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_title', __( 'Label', 'bw-map-magnet' ), [ $this, 'field_central_title' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_coords', __( 'Latitude / Longitude', 'bw-map-magnet' ), [ $this, 'field_central_coords' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_gmaps', __( 'Fetch by Google Maps URL', 'bw-map-magnet' ), [ $this, 'field_central_gmaps' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_icon_mode', __( 'Marker style', 'bw-map-magnet' ), [ $this, 'field_central_icon_mode' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_custom_image_id', __( 'Custom image', 'bw-map-magnet' ), [ $this, 'field_central_custom_image' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'central_color', __( 'Marker accent color', 'bw-map-magnet' ), [ $this, 'field_central_color' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'show_distance', __( 'Show distance in popups', 'bw-map-magnet' ), [ $this, 'field_show_distance' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'distance_unit', __( 'Distance unit', 'bw-map-magnet' ), [ $this, 'field_distance_unit' ], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); add_settings_field( 'directions_label',__( '"Get directions" label', 'bw-map-magnet' ), [ $this, 'field_directions_label'], 'bw-map-magnet-settings', 'bw_map_magnet_central' ); } public function sanitize( $input ) { $defaults = self::defaults(); $out = []; $zoom = isset( $input['default_zoom'] ) ? (int) $input['default_zoom'] : $defaults['default_zoom']; $out['default_zoom'] = max( 6, min( 19, $zoom ) ); $dur = isset( $input['anim_duration'] ) ? (float) $input['anim_duration'] : $defaults['anim_duration']; $out['anim_duration'] = max( 0.1, min( 5.0, $dur ) ); $out['central_enabled'] = ! empty( $input['central_enabled'] ); $out['central_lat'] = isset( $input['central_lat'] ) && '' !== $input['central_lat'] ? (float) $input['central_lat'] : 0.0; $out['central_lng'] = isset( $input['central_lng'] ) && '' !== $input['central_lng'] ? (float) $input['central_lng'] : 0.0; $out['central_lat'] = max( -90.0, min( 90.0, $out['central_lat'] ) ); $out['central_lng'] = max( -180.0, min( 180.0, $out['central_lng'] ) ); $out['central_title'] = isset( $input['central_title'] ) ? sanitize_text_field( $input['central_title'] ) : ''; $mode = isset( $input['central_icon_mode'] ) ? sanitize_key( $input['central_icon_mode'] ) : $defaults['central_icon_mode']; $out['central_icon_mode'] = in_array( $mode, [ 'logo', 'pin', 'custom' ], true ) ? $mode : $defaults['central_icon_mode']; $out['central_custom_image_id'] = isset( $input['central_custom_image_id'] ) ? (int) $input['central_custom_image_id'] : 0; if ( $out['central_custom_image_id'] < 0 ) { $out['central_custom_image_id'] = 0; } $color = isset( $input['central_color'] ) ? sanitize_hex_color( $input['central_color'] ) : $defaults['central_color']; $out['central_color'] = $color ? $color : $defaults['central_color']; $out['show_distance'] = ! empty( $input['show_distance'] ); $unit = isset( $input['distance_unit'] ) ? strtolower( (string) $input['distance_unit'] ) : 'km'; $out['distance_unit'] = in_array( $unit, [ 'km', 'mi' ], true ) ? $unit : 'km'; $out['directions_label'] = isset( $input['directions_label'] ) ? sanitize_text_field( $input['directions_label'] ) : $defaults['directions_label']; return $out; } public function field_default_zoom() { $value = (int) self::get( 'default_zoom' ); ?>