class-trackserver-settings.php

<?php

if ( ! defined( 'TRACKSERVER_PLUGIN_DIR' ) ) {
	die( 'No, sorry.' );
}

class Trackserver_Settings {

	// Singleton
	protected static $instance;

	private $trackserver; // Reference to the main object

	public function __construct( $trackserver ) {
		$this->trackserver = $trackserver;
	}

	/**
	 * Create a singleton if it doesn't exist and return it.
	 *
	 * @since 5.0
	 */
	public static function get_instance( $trackserver ) {
		if ( ! self::$instance ) {
			self::$instance = new self( $trackserver );
		}
		return self::$instance;
	}

	public function register() {
		// All options in one array
		$args = array( 'sanitize_callback' => array( &$this, 'sanitize_option_values' ) );  // WP >= 4.7
		register_setting( 'trackserver-options', 'trackserver_options', $args );
		$args = array( 'sanitize_callback' => array( &$this, 'sanitize_map_profiles' ) );  // WP >= 4.7
		register_setting( 'trackserver-options', 'trackserver_map_profiles', $args );

		// Add a custom action to add the settings sections.
		// This was meant to be called from options_page_html(), but that seems too late; the sections aren't rendered.
		add_action( 'trackserver_add_settings_sections', array( &$this, 'add_sections' ) );
		do_action( 'trackserver_add_settings_sections' );
	}

	public function add_sections() {

		// Settings for section 'trackserver-general'
		add_settings_section(
			'trackserver-general',
			esc_html__( 'General settings', 'trackserver' ),
			array( &$this, 'general_settings_html' ),
			'trackserver'
		);
		add_settings_field(
			'trackserver_universal_slug',
			esc_html__( 'Trackserver URL slug', 'trackserver' ),
			array( &$this, 'universal_slug_html' ),
			'trackserver',
			'trackserver-general'
		);

		// Settings for section 'trackserver-map-profile'
		add_settings_section(
			'trackserver-map-profile',
			esc_html__( 'Map profiles', 'trackserver' ),
			array( &$this, 'map_profiles_html' ),
			'trackserver'
		);

		// Settings for section 'trackserver-trackme'
		add_settings_section(
			'trackserver-trackme',
			esc_html__( 'TrackMe settings', 'trackserver' ),
			array( &$this, 'trackme_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_trackme_slug',
			esc_html__( 'TrackMe URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'trackme_slug_html' ),
			'trackserver',
			'trackserver-trackme'
		);
		add_settings_field(
			'trackserver_trackme_extension',
			esc_html__( 'TrackMe server extension', 'trackserver' ),
			array( &$this, 'trackme_extension_html' ),
			'trackserver',
			'trackserver-trackme'
		);

		// Settings for section 'trackserver-mapmytracks'
		add_settings_section(
			'trackserver-mapmytracks',
			esc_html__( 'OruxMaps MapMyTracks settings', 'trackserver' ),
			array( &$this, 'mapmytracks_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_mapmytracks_tag',
			esc_html__( 'MapMyTracks URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'mapmytracks_tag_html' ),
			'trackserver',
			'trackserver-mapmytracks'
		);

		// Settings for section 'trackserver-osmand'
		add_settings_section(
			'trackserver-osmand',
			esc_html__( 'OsmAnd online tracking settings', 'trackserver' ),
			array( &$this, 'osmand_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_osmand_slug',
			esc_html__( 'OsmAnd URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'osmand_slug_html' ),
			'trackserver',
			'trackserver-osmand'
		);
		add_settings_field(
			'trackserver_osmand_trackname_format',
			esc_html__( 'OsmAnd trackname format', 'trackserver' ),
			array( &$this, 'osmand_trackname_format_html' ),
			'trackserver',
			'trackserver-osmand'
		);

		// Settings for section 'trackserver-sendlocation'
		add_settings_section(
			'trackserver-sendlocation',
			esc_html__( 'SendLocation settings', 'trackserver' ),
			array( &$this, 'sendlocation_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_sendlocation_slug',
			esc_html__( 'SendLocation URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'sendlocation_slug_html' ),
			'trackserver',
			'trackserver-sendlocation'
		);
		add_settings_field(
			'trackserver_sendlocation_trackname_format',
			esc_html__( 'SendLocation trackname format', 'trackserver' ),
			array( &$this, 'sendlocation_trackname_format_html' ),
			'trackserver',
			'trackserver-sendlocation'
		);

		// Settings for section 'trackserver-owntracks'
		add_settings_section(
			'trackserver-owntracks',
			esc_html__( 'OwnTracks settings', 'trackserver' ),
			array( &$this, 'owntracks_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_owntracks_slug',
			esc_html__( 'OwnTracks URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'owntracks_slug_html' ),
			'trackserver',
			'trackserver-owntracks'
		);
		add_settings_field(
			'trackserver_owntracks_trackname_format',
			esc_html__( 'OwnTracks trackname format', 'trackserver' ),
			array( &$this, 'owntracks_trackname_format_html' ),
			'trackserver',
			'trackserver-owntracks'
		);

		// Settings for section 'trackserver-httppost'
		add_settings_section(
			'trackserver-httppost',
			esc_html__( 'HTTP upload settings', 'trackserver' ),
			array( &$this, 'httppost_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_upload_tag',
			esc_html__( 'HTTP POST URL slug', 'trackserver' ) . '<br>' . esc_html__( '(deprecated)', 'trackserver' ),
			array( &$this, 'upload_tag_html' ),
			'trackserver',
			'trackserver-httppost'
		);

		// Settings for section 'trackserver-embedded'
		add_settings_section(
			'trackserver-embedded',
			esc_html__( 'Embedded maps settings', 'trackserver' ),
			array( &$this, 'embedded_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_embedded_slug',
			esc_html__( 'Embedded map URL slug', 'trackserver' ),
			array( &$this, 'embedded_slug_html' ),
			'trackserver',
			'trackserver-embedded'
		);

		// Settings for section 'trackserver-advanced'
		add_settings_section(
			'trackserver-advanced',
			esc_html__( 'Advanced settings', 'trackserver' ),
			array( &$this, 'advanced_settings_html' ),
			'trackserver'
		);

		add_settings_field(
			'trackserver_gettrack_slug',
			esc_html__( 'Gettrack URL slug', 'trackserver' ),
			array( &$this, 'gettrack_slug_html' ),
			'trackserver',
			'trackserver-advanced'
		);
		add_settings_field(
			'trackserver_enable_proxy',
			esc_html__( 'Enable proxy', 'trackserver' ),
			array( &$this, 'enable_proxy_html' ),
			'trackserver',
			'trackserver-advanced'
		);
		add_settings_field(
			'trackserver_enable_fetchmode_all',
			esc_html__( 'Single request mode', 'trackserver' ),
			array( &$this, 'fetchmode_all_html' ),
			'trackserver',
			'trackserver-advanced'
		);
	}

	// Force some options to be booleans
	public function sanitize_option_values( $options ) {
		$options['enable_proxy']  = ( isset( $options['enable_proxy'] ) ? (bool) $options['enable_proxy'] : false );
		$options['fetchmode_all'] = ( isset( $options['fetchmode_all'] ) ? (bool) $options['fetchmode_all'] : false );
		return $options;
	}

	/**
	 * Callback for sanitizing map profile data.
	 *
	 * @since 6.0
	 */
	public function sanitize_map_profiles( $data ) {
		if ( is_array( $data ) ) {
			foreach ( $data as $k => $v ) {
				if ( empty( $v['tile_url'] ) && empty( $v['attribution'] ) ) {
					unset( $data[ $k ] );
					continue;
				}
				$data[ $k ]['vector']      = ( isset( $v['vector'] ) && $v['vector'] === 'on' ? true : false );
				$data[ $k ]['label']       = ( empty( $v['label'] ) ? 'profile' . $k : $v['label'] );
				$data[ $k ]['min_zoom']    = ( (int) $v['min_zoom'] < 0 ? '0' : (int) $v['min_zoom'] );
				$data[ $k ]['max_zoom']    = ( (int) $v['max_zoom'] <= 0 ? '18' : (int) $v['max_zoom'] );
				$data[ $k ]['default_lat'] = (float) $v['default_lat'];
				$data[ $k ]['default_lon'] = (float) $v['default_lon'];
			}
		} else {
			$data = $this->trackserver->map_profiles;
		}
		return $data;
	}

	public function general_settings_html() {
		esc_html_e(
			// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText
			'As of version 5.0, Trackserver uses a single URL slug for all ' .
			'the protocols it supports. The old, seperate slugs for TrackMe, ' .
			'MapMyTracks, OsmAnd, SendLocation and OwnTracks are now deprecated and ' .
			'will be removed in a future version.',
			'trackserver'
		);
		echo '<br><br>';
		esc_html_e(
			// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText
			'Some protocols that use HTTP GET need to have a username and ' .
			'password in the URL, while protocols that use HTTP POST and/or Basic ' .
			'Authentication send the password via another method. So there are two ' .
			'versions of the URL, that each can be used with specific protocols, as ' .
			'listed below.',
			'trackserver'
		);
	}

	public function universal_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['trackserver_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[trackserver_slug]" id="trackserver_slug" value="$val" autocomplete="off" /><br /><br />
			<strong>%2\$s:<br></strong> $url/$val<br><br>
			<strong>%3\$s:<br></strong> $url/$val/&lt;<strong>%4\$s</strong>&gt;/&lt;<strong>%5\$s</strong>&gt;<br /><br>
EOF;

		printf(
			$format,
			esc_html__( 'The Trackserver universal URL slug for all protocols', 'trackserver' ),
			esc_html__( 'Full URL for OruxMaps / MapMyTracks, OwnTracks, uLogger', 'trackserver' ),
			esc_html__( 'Full URL for TrackMe, OsmAnd, SendLocation', 'trackserver' ),
			esc_html__( 'username', 'trackserver' ),
			esc_html__( 'password', 'trackserver' )
		);
	}

	/**
	 * Output HTML for the Trackme settings section.
	 *
	 * @since 1.0
	 */
	public function trackme_settings_html() {
	}

	public function trackme_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['trackme_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[trackme_slug]" id="trackserver_trackme_slug" value="$val" autocomplete="off" /><br /><br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for TrackMe, used in 'URL Header' setting in TrackMe", 'trackserver' ),
		);
	}

	public function trackme_extension_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['trackme_extension'] );

		$format = <<<EOF
			%1\$s<br />
			<input type="text" size="25" name="trackserver_options[trackme_extension]" id="trackserver_trackme_extension" value="$val" autocomplete="off" /><br />
			<br />
			<b>%2\$s</b>: %3\$s<br /><br />
EOF;
		printf(
			$format,
			esc_html__( "The Server extension in TrackMe's settings", 'trackserver' ),
			esc_html__( 'WARNING', 'trackserver' ),
			esc_html__(
				// phpcs:disable
				"the default value in TrackMe is 'php', but this will most likely NOT work, so better change " .
				"it to something else. Anything will do, as long as the request is handled by WordPress' index.php, " .
				"so it's better to not use any known file type extension, like 'html' or 'jpg'. A single " .
				"character like 'z' (the default) should work just fine. Change the 'Server extension' setting " .
				'in TrackMe to match the value you put here.', 'trackserver'
				// phpcs:enable
			)
		);
	}

	/**
	 * Output HTML for the Mapmytracks settings section.
	 *
	 * @since 1.0
	 */
	public function mapmytracks_settings_html() {
	}

	public function mapmytracks_tag_html() {
		$val     = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['mapmytracks_tag'] );
		$url     = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );
		$linkurl = esc_attr__( 'http://en.wikipedia.org/wiki/Server_Name_Indication', 'trackserver' );
		$link    = "<a href=\"$linkurl\">SNI</a>";

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[mapmytracks_tag]" id="trackserver_mapmytracks_tag" value="$val" autocomplete="off" /><br /><br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for MapMyTracks, used in 'Custom Url' setting in OruxMaps", 'trackserver' )
		);
	}

	public function osmand_settings_html() {
	}

	public function osmand_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['osmand_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/?...) <br />
			<input type="text" size="25" name="trackserver_options[osmand_slug]" id="trackserver_osmand_slug" value="$val" autocomplete="off" /><br /><br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for OsmAnd, used in 'Online tracking' settings in OsmAnd", 'trackserver' )
		);
	}

	public function osmand_trackname_format_html() {
		$val  = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['osmand_trackname_format'] );
		$link = '<a href="' . esc_attr__( 'http://php.net/manual/en/function.strftime.php', 'trackserver' ) . '" target="_blank">strftime()</a>';

		$format = <<<EOF
			%1\$s<br /><br />
			<input type="text" size="25" name="trackserver_options[osmand_trackname_format]" id="trackserver_osmand_trackname_format" value="$val" autocomplete="off" /><br />
			%%Y = %2\$s, %%m = %3\$s, %%d = %4\$s, %%H = %5\$s, %%F = %%Y-%%m-%%d
			<br />
EOF;

		printf(
			$format,
			sprintf(
				// translators: placeholder is for link to strftime() manual
				esc_html__(
					// phpcs:disable
					'Generated track name in %1$s format. OsmAnd online tracking does not support the concept of ' .
					"'tracks', there are only locations. Trackserver needs to group these in tracks and automatically generates " .
					"new tracks based on the location's timestamp. The format to use (and thus, how often to start a new track) " .
					'can be specified here. If you specify a constant string, without any strftime() format placeholders, one ' .
					'and the same track will be used forever and all locations.', 'trackserver'
					// phpcs:enable
				),
				$link
			),
			esc_html__( 'year', 'trackserver' ),
			esc_html__( 'month', 'trackserver' ),
			esc_html__( 'day', 'trackserver' ),
			esc_html__( 'hour', 'trackserver' )
		);
	}

	public function sendlocation_settings_html() {
	}

	public function owntracks_settings_html() {
	}

	/**
	 * Output HTML for the HTTP POST settings section.
	 *
	 * @since 1.0
	 */
	public function httppost_settings_html() {
	}

	public function embedded_settings_html() {
	}

	public function advanced_settings_html() {
	}

	public function sendlocation_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['sendlocation_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;/&lt;username&gt;/&lt;access key&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[sendlocation_slug]" id="trackserver_sendlocation_slug" value="$val" autocomplete="off" /><br /><br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for SendLocation, used in SendLocation's settings", 'trackserver' )
		);
	}

	public function sendlocation_trackname_format_html() {
		$val  = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['sendlocation_trackname_format'] );
		$link = '<a href="' . esc_attr__( 'http://php.net/manual/en/function.strftime.php', 'trackserver' ) . '" target="_blank">strftime()</a>';

		$format = <<<EOF
			%1\$s<br /><br />
			<input type="text" size="25" name="trackserver_options[sendlocation_trackname_format]" id="trackserver_sendlocation_trackname_format" value="$val" autocomplete="off" /><br />
			%%Y = %2\$s, %%m = %3\$s, %%d = %4\$s, %%H = %5\$s, %%F = %%Y-%%m-%%d
			<br />
EOF;

		printf(
			$format,
			sprintf(
				// translators: placeholder is for link to strftime() manual
				esc_html__(
					// phpcs:disable
					'Generated track name in %1$s format. SendLocation online tracking does not support the concept of ' .
					"'tracks', there are only locations. Trackserver needs to group these in tracks and automatically generates " .
					"new tracks based on the location's timestamp. The format to use (and thus, how often to start a new track) " .
					'can be specified here. If you specify a constant string, without any strftime() format placeholders, one ' .
					'and the same track will be used forever and all locations.', 'trackserver'
					// phpcs:enable
				),
				$link
			),
			esc_html__( 'year', 'trackserver' ),
			esc_html__( 'month', 'trackserver' ),
			esc_html__( 'day', 'trackserver' ),
			esc_html__( 'hour', 'trackserver' )
		);
	}

	public function owntracks_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['owntracks_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[owntracks_slug]" id="trackserver_owntracks_slug" value="$val" autocomplete="off" /><br /><br />
			<strong>%2\$s:</strong> $url/$val/<br /><br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for OwnTracks, used in OwnTracks' settings", 'trackserver' ),
			esc_html__( 'Preferences -> Connection -> Host', 'trackserver' )
		);
	}

	public function owntracks_trackname_format_html() {
		$val  = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['owntracks_trackname_format'] );
		$link = '<a href="' . esc_attr__( 'http://php.net/manual/en/function.strftime.php', 'trackserver' ) . '" target="_blank">strftime()</a>';

		$format = <<<EOF
			%1\$s<br /><br />
			<input type="text" size="25" name="trackserver_options[owntracks_trackname_format]" id="trackserver_owntracks_trackname_format" value="$val" autocomplete="off" /><br />
			%%Y = %2\$s, %%m = %3\$s, %%d = %4\$s, %%H = %5\$s, %%F = %%Y-%%m-%%d
			<br />
EOF;

		printf(
			$format,
			sprintf(
				// translators: placeholder is for link to strftime() manual
				esc_html__(
					// phpcs:disable
					'Generated track name in %1$s format. OwnTracks online tracking does not support the concept of ' .
					"'tracks', there are only locations. Trackserver needs to group these in tracks and automatically generates " .
					"new tracks based on the location's timestamp. The format to use (and thus, how often to start a new track) " .
					'can be specified here. If you specify a constant string, without any strftime() format placeholders, one ' .
					'and the same track will be used forever and all locations.', 'trackserver'
					// phpcs:enable
				),
				$link
			),
			esc_html__( 'year', 'trackserver' ),
			esc_html__( 'month', 'trackserver' ),
			esc_html__( 'day', 'trackserver' ),
			esc_html__( 'hour', 'trackserver' )
		);
	}

	public function upload_tag_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['upload_tag'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[upload_tag]" id="trackserver_upload_tag" value="$val" autocomplete="off" /><br />
			<br />
			<strong>%2\$s:</strong> $url/$val<br />
EOF;
		printf(
			$format,
			esc_html__( 'The URL slug for upload via HTTP POST', 'trackserver' ),
			esc_html__( 'Full URL', 'trackserver' )
		);
	}

	public function tile_url_html() {
		$val = htmlspecialchars( $this->trackserver->options['tile_url'] );
		echo <<<EOF
			<input type="text" size="50" name="trackserver_options[tile_url]" id="trackserver_tile_url" value="$val" autocomplete="off" /><br /><br />
EOF;
	}

	public function attribution_html() {
		$val    = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['attribution'] );
		$format = <<<EOF
			<input type="text" size="50" name="trackserver_options[attribution]" id="trackserver_attribution" value="$val" autocomplete="off" /><br />
			%1\$s<br />
EOF;

		printf( $format, esc_html__( 'Please check with your map tile provider what attribution is required.', 'trackserver' ) );
	}

	public function map_profiles_html() {
		$page = menu_page_url( 'trackserver-options', false );

		_e(
			'A map profile is a set of values that define what a map looks like and how it behaves. It consists of a tile server or style URL,
			an attribution string (often mandatory from the tile provider), a minimum and maximum zoom level for the map, and the default
			coordinates to display when for some reason nothing else is shown on the map. Map profiles have a label by which you can reference them
			in a shortcode (<tt>profile=&lt;label&gt;</tt>). If no profile is specified in the shortcode, the profile with the label
			"<em>default</em>" is used. If that label does not exist, the first profile is used. ',
			'trackserver'
		);

		printf(
			// translators: placeholders are for documentation links
			__(
				'<a href="%1$s">Vector tiles</a> are supported. To use them, specify the URL to the <tt><a href="%2$s">style.json</a></tt> document
				and check the "Vector tiles" checkbox. This will cause the necessary scripts for vector tile support to be loaded.',
				'trackserver'
			),
			'https://en.wikipedia.org/wiki/Vector_tiles',
			'https://maplibre.org/maplibre-style-spec/'
		);

		$strings = array(
			'label'       => esc_html__( 'Label', 'trackserver' ),
			'url'         => esc_html__( 'Tile / style URL', 'trackserver' ),
			'vector'      => esc_html__( 'Vector tiles', 'trackserver' ),
			'attribution' => esc_html__( 'Tile attribution', 'trackserver' ),
			'maxzoom'     => esc_html__( 'Max. zoom', 'trackserver' ),
			'minzoom'     => esc_html__( 'Min. zoom', 'trackserver' ),
			'latitude'    => esc_html__( 'Default latitude', 'trackserver' ),
			'longitude'   => esc_html__( 'Default longitude', 'trackserver' ),
			'delete'      => esc_html__( 'Delete', 'trackserver' ),
			'addprofile'  => esc_html__( 'Add map profile', 'trackserver' ),
			'save'        => esc_html__( 'Save', 'trackserver' ),
			'cancel'      => esc_html__( 'Cancel', 'trackserver' ),
		);

		echo <<<EOF
			<table class="form-table fixed" border="1" id="map-profile-table">
				<tbody>
					<tr>
						<th style="width: 40px; padding-left: 10px">{$strings['label']}</th>
						<th style="padding-left: 10px">{$strings['url']}</th>
						<th style="width: 10px; padding-left: 10px">{$strings['vector']}</th>
						<th style="padding-left: 10px">{$strings['attribution']}</th>
						<th style="width: 20px; padding-left: 10px">{$strings['minzoom']}</th>
						<th style="width: 20px; padding-left: 10px">{$strings['maxzoom']}</th>
						<th style="width: 60px; padding-left: 10px">{$strings['latitude']}</th>
						<th style="width: 60px; padding-left: 10px">{$strings['longitude']}</th>
						<th style="width: 50px">&nbsp;</th>
					</tr>
EOF;

		for ( $i = 0; $i < count( $this->trackserver->map_profiles ); $i++ ) {

			$itemdata  = 'data-id="' . $i . '"';
			$label     = $this->esc_html( $this->trackserver->map_profiles[ $i ]['label'] );
			$url       = $this->esc_html( $this->trackserver->map_profiles[ $i ]['tile_url'] );
			$attrib    = $this->esc_html( $this->trackserver->map_profiles[ $i ]['attribution'] );
			$minzoom   = $this->esc_html( $this->trackserver->map_profiles[ $i ]['min_zoom'] );
			$maxzoom   = $this->esc_html( $this->trackserver->map_profiles[ $i ]['max_zoom'] );
			$latitude  = $this->esc_html( $this->trackserver->map_profiles[ $i ]['default_lat'] );
			$longitude = $this->esc_html( $this->trackserver->map_profiles[ $i ]['default_lon'] );
			$vector    = ( $this->trackserver->map_profiles[ $i ]['vector'] === true ? 'checked' : '' );

			$d = '&nbsp;';
			if ( $i > 0 ) {
				$d = '<a id="delete-profile-button' . $i . '" title="' . $strings['delete'] . '" class="button ts-delete-profile-button" ' .
					$itemdata . ' data-action="deleteprofile">' . $strings['delete'] . '</a>';
			}

			echo <<<EOF
				<tr $itemdata id="profile-row$i" class="trackserver-map-profile">
					<td id="label$i" $itemdata><input type="text" size="5" name="trackserver_map_profiles[$i][label]" value="$label"></td>
					<td style="word-wrap:break-word;"><textarea rows=4 cols=30 name="trackserver_map_profiles[$i][tile_url]">$url</textarea></td>
					<td><input type="checkbox" name="trackserver_map_profiles[$i][vector]" $vector></td>
					<td style="word-wrap:break-word;"><textarea rows=4 cols=30 name="trackserver_map_profiles[$i][attribution]">$attrib</textarea></td>
					<td><input type="text" size="2" id="minzoom{$i}" name="trackserver_map_profiles[$i][min_zoom]" value="$minzoom"></td>
					<td><input type="text" size="2" id="maxzoom{$i}" name="trackserver_map_profiles[$i][max_zoom]" value="$maxzoom"></td>
					<td><input type="text" size="5" id="latitude{$i}" name="trackserver_map_profiles[$i][default_lat]" value="$latitude"></td>
					<td><input type="text" size="5" id="longitude{$i}" name="trackserver_map_profiles[$i][default_lon]" value="$longitude"></td>
					<td>$d</td>
				</tr>
EOF;
		}

		echo <<<EOF
				</tbody>
			</table>
			<br>
      <a id="add-row-button" title="{$strings['addprofile']}"
        class="button" data-id="0" data-action="addprofile">{$strings['addprofile']}</a>
EOF;
	}

	public function embedded_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['embedded_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			<input type="text" size="25" name="trackserver_options[embedded_slug]" id="trackserver_embedded_slug" value="$val" autocomplete="off" /><br />
			<br />
EOF;

		printf(
			$format,
			esc_html__( 'The URL slug for embedded maps', 'trackserver' )
		);

		echo esc_html__( 'Warning: if you change this, links to existing embedded maps will be invalidated.', 'trackserver' );
	}

	public function gettrack_slug_html() {
		$val = $this->trackserver->printf_htmlspecialchars( $this->trackserver->options['gettrack_slug'] );
		$url = $this->trackserver->printf_htmlspecialchars( site_url( null ) . $this->trackserver->url_prefix );

		$format = <<<EOF
			%1\$s ($url/<b>&lt;slug&gt;</b>/) <br />
			%2\$s<br />
			<input type="text" size="25" name="trackserver_options[gettrack_slug]" id="trackserver_gettrack_slug" value="$val" autocomplete="off" /><br />
			<br />
EOF;

		printf(
			$format,
			esc_html__( "The URL slug for the 'gettrack' API, used by Trackserver's shortcode [tsmap]", 'trackserver' ),
			esc_html__( 'There is generally no need to change this.', 'trackserver' )
		);
	}

	public function enable_proxy_html() {
		$checked  = ( $this->trackserver->options['enable_proxy'] ? 'checked' : '' );
		$linkurl  = esc_attr__( 'https://wordpress.org/plugins/trackserver/faq/', 'trackserver' );
		$linktext = esc_html__( 'FAQ about security', 'trackserver' );
		$link     = "<a href=\"$linkurl\">$linktext</a>";

		$format = <<<EOF
			<input type="checkbox" name="trackserver_options[enable_proxy]" id="trackserver_enable_proxy" $checked> %1\$s<br />
			%2\$s<br />
EOF;

		printf(
			$format,
			esc_html__( "Check this to enable the proxy for external tracks, which can be used by prefixing their URL with 'proxy:'", 'trackserver' ),
			sprintf(
				// translators: placeholder is for link to Trackserver FAQ
				esc_html__(
					// phpcs:disable
					'This will enable your authors to invoke HTTP requests originating from your server. ' .
					'Only enable this when you need it and if you trust your authors not to use harmful URLs. ' .
					'Please see the %1$s for more information.', 'trackserver'
					// phpcs:enable
				),
				$link
			)
		);
	}

	public function fetchmode_all_html() {
		$checked = ( $this->trackserver->options['fetchmode_all'] ? 'checked' : '' );
		$format  = '<input type="checkbox" name="trackserver_options[fetchmode_all]" id="trackserver_fetchmode_all" ' . $checked . '> %1$s<br /><br />';
		printf(
			$format,
			esc_html__( 'Check this to enable the mode where Trackserver gets all track data in a single HTTP request when displaying a map.' )
		);
		echo esc_html__(
			// phpcs:disable
			'Disabling this mode will make Trackserver use a separate HTTP request ' .
			'for each single track. This may have a positive or a negative ' .
			'effect on the loading speed of Trackserver maps and tracks. If ' .
			'some of your maps have multiple tracks with many, many locations, ' .
			'unchecking this and disabling the single request mode may improve ' .
			'the performance. On the other hand, if your users are on slow or ' .
			'high-latency networks, enabling single request mode may give ' .
			'better results. You can safely switch between modes to see what works ' .
			'best for you.'
			// phpcs:enable
		);
	}

	/**
	 * A function to fully escape HTML special characters for printing.
	 *
	 * @since @6.0
	 */
	private function esc_html( $text ) {
		return esc_html( htmlspecialchars( $text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' ) );
	}
} // class