CSL locale support

Via the 'locale' query parameter

Closes FiligranHQ#4

Author: dstillman

model/API.inc.php

@@ -75,6 +75,7 @@ class Zotero_API {
 		'style' => "chicago-note-bibliography",
 		'css' => "inline",
 		'linkwrap' => 0,
+		'locale' => "en-US",
 
 		// search
 		'fq' => '',

model/Cite.inc.php

@@ -387,11 +387,12 @@ private static function getCacheKey($mode, $item, array $queryParams) {
 
 		// Any query parameters that have an effect on the output
 		// need to be added here
-		$allowedParams = array(
+		$allowedParams = [
 			'style',
+			'locale',
 			'css',
 			'linkwrap'
-		);
+		];
 		$cachedParams = Z_Array::filterKeys($queryParams, $allowedParams);
 
 		return $mode . "_" . $lk . "_"
@@ -407,6 +408,7 @@ private static function getBibCacheKey(array $items, array $queryParams) {
 		// need to be added here
 		$allowedParams = array(
 			'style',
+			'locale',
 			'css',
 			'linkwrap'
 		);
@@ -449,6 +451,13 @@ private static function buildURLPath(array $queryParams, $mode) {
 		if ($mode == 'citation') {
 			$url .= "&citations=1&bibliography=0";
 		}
+		if ($queryParams['locale'] != "en-US"
+				&& preg_match('/^[a-z]{2}(-[A-Z]{2})?/', $queryParams['locale'], $matches)) {
+			if (strlen($matches[0]) == 2) {
+				$matches[0] = $matches . '-' . strtoupper($matches[0]);
+			}
+			$url .= "&locale=" . $matches[0];
+		}
 		return $url;
 	}