[FEATURE] Add field to include any URL parameters for item links

Configuration/FlexForms/flexform_sgvimeo_vimeo.xml

@@ -195,6 +195,17 @@
 							</config>
 						</TCEforms>
 					</settings.thumbnailImages>
+					<settings.urlParameters>
+						<TCEforms>
+							<exclude>0</exclude>
+							<label>LLL:EXT:sg_vimeo/Resources/Private/Language/locallang.xlf:flexform.urlParameters</label>
+							<description>LLL:EXT:sg_vimeo/Resources/Private/Language/locallang.xlf:flexform.urlParameters.description</description>
+							<config>
+								<type>input</type>
+								<eval>trim</eval>
+							</config>
+						</TCEforms>
+					</settings.urlParameters>
 					<settings.showApiResult>
 						<TCEforms>
 							<exclude>0</exclude>

Configuration/TypoScript/constants.typoscript

@@ -6,6 +6,8 @@ plugin.tx_sgvimeo {
 		clientSecret =
 		# cat=plugin.tx_sgvimeo/file; type=string; label=Vimeo Personal access token
 		personalAccessToken =
+		# cat=plugin.tx_sgvimeo/file; type=string; label=Global URL parameters that will be included in the template if the plugin configuration doesn't set its own value.
+		globalUrlParameters =
 	}
 
 	view {

Configuration/TypoScript/setup.typoscript

@@ -3,6 +3,7 @@ plugin.tx_sgvimeo {
 		clientId = {$plugin.tx_sgvimeo.settings.clientId}
 		clientSecret = {$plugin.tx_sgvimeo.settings.clientSecret}
 		personalAccessToken = {$plugin.tx_sgvimeo.settings.personalAccessToken}
+		globalUrlParameters = {$plugin.tx_sgvimeo.settings.globalUrlParameters}
 	}
 
 	view {

Resources/Private/Language/de.locallang.xlf

@@ -141,6 +141,14 @@
 				<source><![CDATA[Read less]]></source>
 				<target><![CDATA[Weniger]]></target>
 			</trans-unit>
+			<trans-unit id="flexform.urlParameters" approved="yes">
+				<source><![CDATA[Additional URL parameters]]></source>
+				<target><![CDATA[Zusätzliche URL-Parameter]]></target>
+			</trans-unit>
+			<trans-unit id="flexform.urlParameters.description" approved="yes">
+				<source><![CDATA[See https://vimeo.zendesk.com/hc/en-us/articles/360001494447-Player-parameters-overview]]></source>
+				<target><![CDATA[Siehe https://vimeo.zendesk.com/hc/de/articles/360001494447-Verwendung-von-Player-Parametern]]></target>
+			</trans-unit>
 		</body>
 	</file>
 </xliff>

Resources/Private/Language/locallang.xlf

@@ -104,6 +104,12 @@
 			<trans-unit id="vimeoPluginTitle">
 				<source><![CDATA[Vimeo]]></source>
 			</trans-unit>
+			<trans-unit id="flexform.urlParameters">
+				<source><![CDATA[Additional URL parameters]]></source>
+			</trans-unit>
+			<trans-unit id="flexform.urlParameters.description">
+				<source><![CDATA[See https://vimeo.zendesk.com/hc/en-us/articles/360001494447-Player-parameters-overview]]></source>
+			</trans-unit>
 		</body>
 	</file>
 </xliff>

Resources/Private/Templates/Vimeo/Index.html

@@ -124,8 +124,10 @@
 </f:section>
 
 <f:section name="vimeoItem">
+	<f:variable name="urlParameters">{f:if(condition: '{settings.urlParameters}', then: '{settings.urlParameters}', else: '{settings.globalUrlParameters}')}</f:variable>
+	<f:variable name="feedItemUrl">{f:if(condition: '{feedItem.embedLink}', then: '{feedItem.embedLink}', else: '{feedItem.link}')}{urlParameters}</f:variable>
 	<div class="sg-video__item">
-		<a class="sg-video__image-container sg-vimeo-item" href="{f:if(condition: '{feedItem.embedLink}', then: '{feedItem.embedLink}', else: '{feedItem.link}')}" target="_blank"
+		<a class="sg-video__image-container sg-vimeo-item" href="{feedItemUrl}" target="_blank"
 		   data-disable-lightbox="{settings.disableLightbox}"
 		   data-disable-lightbox-mobile="{settings.disableLightboxMobile}">
 			<f:if condition="{feedItem.thumbnail}">