add kml output filename support

Author: hcooper

i18n/en.json

@@ -207,6 +207,7 @@
 	"semanticmaps-kml-text": "The text associated with each page. Overridden by the additional queried properties if any.",
 	"semanticmaps-kml-title": "The default title for results",
 	"semanticmaps-kml-linkabsolute": "Should links be absolute (as opposed to relative)",
+	"semanticmaps-kml-filename": "The filename for the KML file",
 	"semanticmaps-kml-pagelinktext": "The text to use for the links to the page, in which $1 will be replaced by the page title",
 	"semanticmaps-shapes-improperformat": "Improper formatting of $1. Please see documentation for formatting",
 	"semanticmaps-shapes-missingshape": "No shapes found for $1. Please see documentation for available shapes",

src/SemanticMW/KmlPrinter.php

@@ -58,6 +58,10 @@ private function getKMLLink( QueryResult $res, int $outputMode ): string {
 			$link->setParameter( $this->params['text'], 'text' );
 		}
 
+		if ( $this->params['filename'] !== '' ) {
+			$link->setParameter( $this->params['filename'], 'filename' );
+		}
+
 		// Fix for offset-error in getQueryLink()
 		// (getQueryLink by default sets offset to point to the next
 		// result set, fix by setting it to 0 if now explicitly set)
@@ -104,6 +108,11 @@ public function getParamDefinitions( array $definitions ) {
 			'default' => true,
 		];
 
+		$definitions['filename'] = [
+			'message' => 'semanticmaps-kml-filename',
+			'default' => 'kml.kml',
+		];
+
 		return $definitions;
 	}
 
@@ -126,6 +135,9 @@ public function getMimeType( QueryResult $queryResult ) {
 	 * @return string|boolean
 	 */
 	public function getFileName( QueryResult $queryResult ) {
+		if ( $this->params['filename'] !== '' ) {
+			return $this->params['filename'];
+		}
 		return 'kml.kml';
 	}