From f0b2c07290dfbb9619bc06d11ed7a5d9e2bab667 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 16:49:10 -0300
Subject: [PATCH 01/27] chore: upgrade @libresign/vue-pdf-editor to v1.5.0

Update to latest version which includes:
- initialScale prop for setting initial zoom level
- @scale-changed event for zoom updates
- @pdf-editor:ready event for initialization

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 package-lock.json | 8 ++++----
 package.json      | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index f558404e30..923b94503d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -10,7 +10,7 @@
       "license": "agpl",
       "dependencies": {
         "@fontsource/dancing-script": "^5.2.8",
-        "@libresign/vue-pdf-editor": "^1.4.8",
+        "@libresign/vue-pdf-editor": "^1.5.0",
         "@marionebl/option": "^1.0.8",
         "@mdi/js": "^7.4.47",
         "@mdi/svg": "^7.4.47",
@@ -2794,9 +2794,9 @@
       "peer": true
     },
     "node_modules/@libresign/vue-pdf-editor": {
-      "version": "1.4.8",
-      "resolved": "https://registry.npmjs.org/@libresign/vue-pdf-editor/-/vue-pdf-editor-1.4.8.tgz",
-      "integrity": "sha512-EU95u+MG97bjhAWDBUGqGRfjkK9lDmqvHTWUCbB6AmwU1bTEr5z385kZbpOBY+ES9e0XwN3kNt9JRAD3xLE+KA==",
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@libresign/vue-pdf-editor/-/vue-pdf-editor-1.5.0.tgz",
+      "integrity": "sha512-O14H/+w2bROiAyVq5R9r5X9doWemCkhkxNFZNhxRZeAObqDIrTe5bmRPWKaKwesjSjIj6mv39SvXO4Vgk+Xg7w==",
       "license": "MIT",
       "dependencies": {
         "@cantoo/pdf-lib": "^2.2.3",
diff --git a/package.json b/package.json
index aea9215310..1689a85b7a 100644
--- a/package.json
+++ b/package.json
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "@fontsource/dancing-script": "^5.2.8",
-    "@libresign/vue-pdf-editor": "^1.4.8",
+    "@libresign/vue-pdf-editor": "^1.5.0",
     "@marionebl/option": "^1.0.8",
     "@mdi/js": "^7.4.47",
     "@mdi/svg": "^7.4.47",

From 478b07a505224d8b6f5583b937915e091b80ba05 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 16:49:41 -0300
Subject: [PATCH 02/27] feat: add FooterTemplateEditor component with live
 preview

- Auto-save footer template with 500ms debounce
- Live PDF preview with zoom controls
- Persistent zoom level using AppConfig
- Reset to default functionality
- Uses VuePdfEditor v1.5.0 events to eliminate workarounds
- Dynamic textarea height adjustment

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/FooterTemplateEditor.vue | 301 ++++++++++++++++++++++++
 1 file changed, 301 insertions(+)
 create mode 100644 src/components/FooterTemplateEditor.vue

diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
new file mode 100644
index 0000000000..02eaa6179e
--- /dev/null
+++ b/src/components/FooterTemplateEditor.vue
@@ -0,0 +1,301 @@
+<!--
+  - SPDX-FileCopyrightText: 2024 LibreCode coop and LibreCode contributors
+  - SPDX-License-Identifier: AGPL-3.0-or-later
+-->
+<template>
+	<div class="footer-template-section">
+		<div class="footer-template-header">
+			<label>{{ t('libresign', 'Footer template') }}</label>
+			<NcButton v-if="!isDefaultFooterTemplate"
+				type="tertiary"
+				@click="resetFooterTemplate">
+				{{ t('libresign', 'Reset to default') }}
+			</NcButton>
+		</div>
+		<NcTextArea ref="textareaEditor"
+			v-model="footerTemplate"
+			label=""
+			placeholder="A twig template to be used at footer of PDF. Will be rendered by mPDF."
+			resize="vertical"
+			@input="debouncedSaveFooterTemplate"
+			@mousemove="resizeHeight"
+			@keypress="resizeHeight" />
+		<div v-if="pdfPreviewFile" class="footer-preview">
+			<h4>{{ t('libresign', 'Preview') }}</h4>
+			<div class="footer-preview__zoom-controls">
+				<NcButton :aria-label="t('libresign', 'Decrease zoom level')"
+					@click="changeZoomLevel(-10)">
+					<template #icon>
+						<MagnifyMinusOutline :size="20" />
+					</template>
+				</NcButton>
+				<NcButton :aria-label="t('libresign', 'Increase zoom level')"
+					@click="changeZoomLevel(+10)">
+					<template #icon>
+						<MagnifyPlusOutline :size="20" />
+					</template>
+				</NcButton>
+			<NcTextField
+				v-model="zoomLevel"
+				class="footer-preview__zoom-level"
+				:label="t('libresign', 'Zoom level')"
+				type="number"
+				:min="10"
+				:step="10"
+				:spellcheck="false"
+				@input="onZoomInput" />
+			</div>
+			<div ref="pdfContainer" class="footer-preview__pdf" :style="previewHeight ? `min-height: ${previewHeight}px` : ''">
+				<div v-if="loadingPreview" class="footer-preview__loading">
+					<NcLoadingIcon :size="64" />
+				</div>
+				<VuePdfEditor ref="pdfPreview"
+					:key="pdfKey"
+					:show-choose-file-btn="false"
+					:show-customize-editor="false"
+					:show-line-size-select="false"
+					:show-font-size-select="false"
+					:show-font-select="false"
+					:show-rename="false"
+					:show-save-btn="false"
+					:save-to-upload="false"
+					:init-file="pdfPreviewFile"
+					:initial-scale="zoomLevel / 100"
+					@scale-changed="onScaleChanged"
+					@pdf-editor:ready="onPdfReady" />
+			</div>
+		</div>
+	</div>
+</template>
+
+<script>
+import debounce from 'debounce'
+
+import axios from '@nextcloud/axios'
+import { loadState } from '@nextcloud/initial-state'
+import { generateOcsUrl } from '@nextcloud/router'
+
+import NcButton from '@nextcloud/vue/components/NcButton'
+import NcLoadingIcon from '@nextcloud/vue/components/NcLoadingIcon'
+import NcTextArea from '@nextcloud/vue/components/NcTextArea'
+import NcTextField from '@nextcloud/vue/components/NcTextField'
+// eslint-disable-next-line import/default
+import VuePdfEditor from '@libresign/vue-pdf-editor'
+
+import MagnifyMinusOutline from 'vue-material-design-icons/MagnifyMinusOutline.vue'
+import MagnifyPlusOutline from 'vue-material-design-icons/MagnifyPlusOutline.vue'
+
+export default {
+	name: 'FooterTemplateEditor',
+	components: {
+		NcButton,
+		NcLoadingIcon,
+		NcTextArea,
+		NcTextField,
+		VuePdfEditor,
+		MagnifyMinusOutline,
+		MagnifyPlusOutline,
+	},
+	props: {
+		initialTemplate: {
+			type: String,
+			default: '',
+		},
+		initialIsDefault: {
+			type: Boolean,
+			default: true,
+		},
+	},
+	data() {
+		return {
+			footerTemplate: this.initialTemplate,
+			isDefaultFooterTemplate: this.initialIsDefault,
+			pdfPreviewFile: null,
+			loadingPreview: false,
+			pdfKey: 0,
+			zoomLevel: loadState('libresign', 'footer_preview_zoom_level', 100),
+			previewHeight: null,
+		}
+	},
+	watch: {
+		initialTemplate(newValue) {
+			this.footerTemplate = newValue
+			if (newValue) {
+				this.saveFooterTemplate()
+			}
+		},
+		initialIsDefault(newValue) {
+			this.isDefaultFooterTemplate = newValue
+		},
+	},
+	created() {
+		this.debouncedSaveFooterTemplate = debounce(this.saveFooterTemplate, 500)
+		this.debouncedUpdateScale = debounce(this.updateScale, 300)
+	},
+	mounted() {
+		this.resizeHeight()
+		this.saveFooterTemplate()
+	},
+	methods: {
+		async resetFooterTemplate() {
+			await axios.post(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
+			this.$emit('template-reset')
+		},
+		saveFooterTemplate() {
+			axios.post(
+				generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'),
+				{ template: this.footerTemplate, width: 595, height: 80 },
+				{ responseType: 'blob' }
+			).then(response => {
+				this.isDefaultFooterTemplate = false
+				this.setPdfPreview(response.data)
+				this.$emit('template-saved', this.footerTemplate)
+			}).catch(error => {
+				console.error('Error saving footer template:', error)
+			})
+		},
+		setPdfPreview(blob) {
+			this.loadingPreview = true
+
+			if (this.$refs.pdfContainer) {
+				this.previewHeight = this.$refs.pdfContainer.offsetHeight
+			}
+
+			this.$nextTick(() => {
+				const timestamp = Date.now()
+				const pdfFile = new File([blob], `footer-preview-${timestamp}.pdf`, { type: 'application/pdf' })
+				this.pdfPreviewFile = pdfFile
+				this.pdfKey++
+			})
+		},
+		onPdfReady() {
+			this.loadingPreview = false
+			this.previewHeight = null
+		},
+		changeZoomLevel(delta) {
+			this.zoomLevel = Number(this.zoomLevel) + delta
+			this.updateScale()
+		},
+		onZoomInput() {
+			this.debouncedUpdateScale()
+		},
+		updateScale() {
+			if (this.$refs.pdfPreview) {
+				this.$refs.pdfPreview.scale = this.zoomLevel / 100
+			}
+		},
+		onScaleChanged(newScale) {
+			this.zoomLevel = Math.round(newScale * 100)
+			OCP.AppConfig.setValue('libresign', 'footer_preview_zoom_level', this.zoomLevel)
+		},
+
+		resizeHeight: debounce(function() {
+			const wrapper = this.$refs.textareaEditor
+			if (!wrapper || !wrapper.$el) {
+				return
+			}
+			const mainWrapper = wrapper.$el.querySelector('.textarea__main-wrapper')
+			const textarea = wrapper.$el.querySelector('textarea')
+			if (mainWrapper && textarea) {
+				mainWrapper.style.height = 'auto'
+				mainWrapper.style.height = `${textarea.scrollHeight + 4}px`
+			}
+		}, 100),
+	},
+}
+</script>
+
+<style lang="scss" scoped>
+.footer-template-section {
+	display: flex;
+	flex-direction: column;
+	gap: 16px;
+
+	.footer-template-header {
+		display: flex;
+		justify-content: space-between;
+		align-items: center;
+
+		label {
+			font-weight: bold;
+			font-size: 14px;
+		}
+	}
+
+	:deep(.textarea) {
+		textarea {
+			height: 100%;
+		}
+	}
+}
+
+.footer-preview {
+	padding: 8px;
+	border: 1px solid var(--color-border);
+	border-radius: var(--border-radius);
+	background-color: var(--color-background-hover);
+
+	h4 {
+		margin: 0 0 8px 0;
+		font-weight: bold;
+		color: var(--color-text-maxcontrast);
+		font-size: 14px;
+	}
+
+	&__zoom-controls {
+		display: flex;
+		gap: 8px;
+		align-items: center;
+		margin-bottom: 10px;
+	}
+
+	&__zoom-level {
+		width: 100px;
+	}
+
+	&__pdf {
+		width: 100%;
+		max-width: 100%;
+		overflow: hidden;
+		position: relative;
+
+		:deep(.py-12) {
+			padding: unset;
+		}
+
+		:deep(.pdf-editor),
+		:deep(.pdf-wrapper) {
+			overflow-x: hidden;
+		}
+
+		:deep(.vue-pdf-embed__page) {
+			margin: 0;
+			padding: 0;
+		}
+	}
+
+	&__loading {
+		position: absolute;
+		top: 0;
+		left: 0;
+		right: 0;
+		bottom: 0;
+		display: flex;
+		align-items: center;
+		justify-content: center;
+		background-color: rgba(255, 255, 255, 0.8);
+		z-index: 100;
+	}
+}
+</style>
+
+<style>
+/** @todo remove this, only necessary because VuePdfEditor use Tailwind and the Tailwind have a global CSS that affect this */
+audio, canvas, embed, iframe, img, object, svg, video {
+	display: unset;
+}
+
+canvas {
+	border-bottom: 2px solid #eee;
+}
+</style>

From 81954130819b8eef6ba55aef4a0c640a41999604 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 16:49:49 -0300
Subject: [PATCH 03/27] feat: integrate FooterTemplateEditor into Validation
 settings

Replace inline footer template editing with dedicated component
providing better UX with live preview and zoom controls

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/views/Settings/Validation.vue | 65 ++++++++++++++++++-------------
 1 file changed, 38 insertions(+), 27 deletions(-)

diff --git a/src/views/Settings/Validation.vue b/src/views/Settings/Validation.vue
index 84db88c2ad..e3c69b88d6 100644
--- a/src/views/Settings/Validation.vue
+++ b/src/views/Settings/Validation.vue
@@ -25,7 +25,7 @@
 				{{ t('libresign', 'Write QR code on footer with validation URL') }}
 			</NcCheckboxRadioSwitch>
 		</p>
-		<p v-if="addFooter">
+		<p v-if="addFooter && writeQrcodeOnFooter">
 			{{ t('libresign', 'To validate the signature of the documents. Only change this value if you want to replace the default validation URL with a different one.') }}
 			<input id="validation_site"
 				ref="urlInput"
@@ -35,12 +35,18 @@
 				@click="fillValidationUrl()"
 				@keypress.enter="validationUrlEnter()">
 		</p>
-		<p v-if="addFooter && isExtraSettingsEnabled">
-			<NcTextArea v-model="footerTemplate"
-				label="Footer template"
-				placeholder="A twig template to be used at footer of PDF. Will be rendered by mPDF."
-				@update:value="saveFooterTemplate" />
+		<p v-if="addFooter">
+			<NcCheckboxRadioSwitch type="switch"
+				:checked.sync="customizeFooter"
+				@update:checked="toggleCustomizeFooter">
+				{{ t('libresign', 'Customize footer template') }}
+			</NcCheckboxRadioSwitch>
 		</p>
+		<FooterTemplateEditor v-if="addFooter && customizeFooter"
+			:initial-template="footerTemplate"
+			:initial-is-default="isDefaultFooterTemplate"
+			@template-saved="onTemplateSaved"
+			@template-reset="onTemplateReset" />
 	</NcSettingsSection>
 </template>
 <script>
@@ -50,14 +56,15 @@ import { generateOcsUrl } from '@nextcloud/router'
 
 import NcCheckboxRadioSwitch from '@nextcloud/vue/components/NcCheckboxRadioSwitch'
 import NcSettingsSection from '@nextcloud/vue/components/NcSettingsSection'
-import NcTextArea from '@nextcloud/vue/components/NcTextArea'
+
+import FooterTemplateEditor from '../../components/FooterTemplateEditor.vue'
 
 export default {
 	name: 'Validation',
 	components: {
 		NcSettingsSection,
 		NcCheckboxRadioSwitch,
-		NcTextArea,
+		FooterTemplateEditor,
 	},
 	data() {
 		return {
@@ -67,8 +74,9 @@ export default {
 			url: null,
 			addFooter: true,
 			writeQrcodeOnFooter: true,
-			isExtraSettingsEnabled: false,
+			customizeFooter: false,
 			footerTemplate: '',
+			isDefaultFooterTemplate: true,
 		}
 	},
 	created() {
@@ -83,14 +91,7 @@ export default {
 			this.getAddFooterData()
 			this.getWriteQrcodeOnFooter()
 			this.getValidationUrlData()
-			this.getExtraSettingsEnabled()
-		},
-		async getExtraSettingsEnabled() {
-			const isExtraSettingsEnabled = await axios.get(generateOcsUrl('/apps/provisioning_api/api/v1/config/apps/libresign/extra_settings'))
-			this.isExtraSettingsEnabled = !!isExtraSettingsEnabled.data.ocs.data.data
-			if (this.isExtraSettingsEnabled) {
-				this.getFooterTemplate()
-			}
+			this.getFooterTemplate()
 		},
 		async getMakeValidationUrlPrivate() {
 			const response = await axios.get(
@@ -121,9 +122,18 @@ export default {
 		},
 		async getFooterTemplate() {
 			const response = await axios.get(
-				generateOcsUrl('/apps/provisioning_api/api/v1/config/apps/libresign/footer_template',
-				))
-			this.footerTemplate = response.data.ocs.data.data
+				generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'),
+			)
+			this.footerTemplate = response.data.ocs.data.template
+			this.isDefaultFooterTemplate = response.data.ocs.data.isDefault
+			this.customizeFooter = !response.data.ocs.data.isDefault
+		},
+		onTemplateSaved(template) {
+			this.footerTemplate = template
+			this.isDefaultFooterTemplate = false
+		},
+		async onTemplateReset() {
+			await this.getFooterTemplate()
 		},
 		saveValidationiUrl() {
 			OCP.AppConfig.setValue('libresign', 'validation_site', this.$refs.urlInput.value.trim())
@@ -131,6 +141,12 @@ export default {
 		async toggleSetting(setting, value) {
 			OCP.AppConfig.setValue('libresign', setting, value ? 1 : 0)
 		},
+		toggleCustomizeFooter(value) {
+			this.customizeFooter = value
+			if (!value) {
+				OCP.AppConfig.deleteKey('libresign', 'footer_template')
+			}
+		},
 		placeHolderValidationUrl(data) {
 			if (data !== '') {
 				this.url = data
@@ -145,16 +161,11 @@ export default {
 				}
 			}
 		},
-		saveFooterTemplate() {
-			OCP.AppConfig.setValue('libresign', 'footer_template', this.footerTemplate)
-		},
 	},
 }
 </script>
-<style scoped>
-
-input{
+<style lang="scss" scoped>
+input {
 	width: 100%;
 }
-
 </style>

From 6603c0b236abc163ccb08314559a0cc51c07d569 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 16:49:56 -0300
Subject: [PATCH 04/27] feat: add footer_preview_zoom_level to initial state

Store zoom level preference for footer template preview

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Settings/Admin.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/Settings/Admin.php b/lib/Settings/Admin.php
index 6456a3d0e6..35782a2e71 100644
--- a/lib/Settings/Admin.php
+++ b/lib/Settings/Admin.php
@@ -58,6 +58,7 @@ public function getForm(): TemplateResponse {
 		$this->initialState->provideInitialState('signature_font_size', $this->signatureTextService->getSignatureFontSize());
 		$this->initialState->provideInitialState('signature_height', $this->signatureTextService->getFullSignatureHeight());
 		$this->initialState->provideInitialState('signature_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'signature_preview_zoom_level', 100));
+		$this->initialState->provideInitialState('footer_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'footer_preview_zoom_level', 100));
 		$this->initialState->provideInitialState('signature_render_mode', $this->signatureTextService->getRenderMode());
 		$this->initialState->provideInitialState('signature_text_template', $this->signatureTextService->getTemplate());
 		$this->initialState->provideInitialState('signature_width', $this->signatureTextService->getFullSignatureWidth());

From fe7d43a5f81d749cee6a4b08b565a96f9b370d1e Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:15:04 -0300
Subject: [PATCH 05/27] feat: add footer preview dimensions to initial state

- Add footer_preview_width (default: 595)
- Add footer_preview_height (default: 80)
- Used by FooterTemplateEditor component for preview dimensions

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Settings/Admin.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/Settings/Admin.php b/lib/Settings/Admin.php
index 35782a2e71..4badd78ba4 100644
--- a/lib/Settings/Admin.php
+++ b/lib/Settings/Admin.php
@@ -59,6 +59,8 @@ public function getForm(): TemplateResponse {
 		$this->initialState->provideInitialState('signature_height', $this->signatureTextService->getFullSignatureHeight());
 		$this->initialState->provideInitialState('signature_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'signature_preview_zoom_level', 100));
 		$this->initialState->provideInitialState('footer_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'footer_preview_zoom_level', 100));
+		$this->initialState->provideInitialState('footer_preview_width', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_width', 595));
+		$this->initialState->provideInitialState('footer_preview_height', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_height', 80));
 		$this->initialState->provideInitialState('signature_render_mode', $this->signatureTextService->getRenderMode());
 		$this->initialState->provideInitialState('signature_text_template', $this->signatureTextService->getTemplate());
 		$this->initialState->provideInitialState('signature_width', $this->signatureTextService->getFullSignatureWidth());

From 814581264015ce9b62eb06aeb05da293a17f350c Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:15:18 -0300
Subject: [PATCH 06/27] feat: add dimension controls to footer template editor

- Add width and height controls with validation (100-2000, 10-500)
- Add reset button for dimensions (UndoVariant icon)
- Implement auto-save with debounce (500ms)
- Delete AppConfig keys when dimensions are default (595x80)
- Add watchers for dimension changes to regenerate PDF
- Separate saveDimensions() method for cleaner logic
- Show reset button only when dimensions differ from default
- Fix containerHeight variable naming conflict

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/FooterTemplateEditor.vue | 133 +++++++++++++++++++-----
 1 file changed, 105 insertions(+), 28 deletions(-)

diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
index 02eaa6179e..e3ce86d2fa 100644
--- a/src/components/FooterTemplateEditor.vue
+++ b/src/components/FooterTemplateEditor.vue
@@ -22,30 +22,58 @@
 			@keypress="resizeHeight" />
 		<div v-if="pdfPreviewFile" class="footer-preview">
 			<h4>{{ t('libresign', 'Preview') }}</h4>
-			<div class="footer-preview__zoom-controls">
-				<NcButton :aria-label="t('libresign', 'Decrease zoom level')"
-					@click="changeZoomLevel(-10)">
-					<template #icon>
-						<MagnifyMinusOutline :size="20" />
-					</template>
-				</NcButton>
-				<NcButton :aria-label="t('libresign', 'Increase zoom level')"
-					@click="changeZoomLevel(+10)">
-					<template #icon>
-						<MagnifyPlusOutline :size="20" />
-					</template>
-				</NcButton>
-			<NcTextField
-				v-model="zoomLevel"
-				class="footer-preview__zoom-level"
-				:label="t('libresign', 'Zoom level')"
-				type="number"
-				:min="10"
-				:step="10"
-				:spellcheck="false"
-				@input="onZoomInput" />
+			<div class="footer-preview__controls">
+				<div class="footer-preview__zoom-controls">
+					<NcButton :aria-label="t('libresign', 'Decrease zoom level')"
+						@click="changeZoomLevel(-10)">
+						<template #icon>
+							<MagnifyMinusOutline :size="20" />
+						</template>
+					</NcButton>
+					<NcButton :aria-label="t('libresign', 'Increase zoom level')"
+						@click="changeZoomLevel(+10)">
+						<template #icon>
+							<MagnifyPlusOutline :size="20" />
+						</template>
+					</NcButton>
+					<NcTextField
+						v-model="zoomLevel"
+						class="footer-preview__zoom-level"
+						:label="t('libresign', 'Zoom level')"
+						type="number"
+						:min="10"
+						:step="10"
+						:spellcheck="false"
+						@input="onZoomInput" />
+				</div>
+				<div class="footer-preview__dimension-controls">
+					<NcTextField
+						v-model="previewWidth"
+						:label="t('libresign', 'Width')"
+						type="number"
+						:min="100"
+						:max="2000"
+						:spellcheck="false"
+						@input="debouncedSaveFooterTemplate" />
+					<NcTextField
+						v-model="previewHeight"
+						:label="t('libresign', 'Height')"
+						type="number"
+						:min="10"
+						:max="500"
+						:spellcheck="false"
+						@input="debouncedSaveFooterTemplate" />
+					<NcButton v-if="showResetDimensions"
+						:aria-label="t('libresign', 'Reset dimensions')"
+						type="tertiary"
+						@click="resetDimensions">
+						<template #icon>
+							<Undo :size="20" />
+						</template>
+					</NcButton>
+				</div>
 			</div>
-			<div ref="pdfContainer" class="footer-preview__pdf" :style="previewHeight ? `min-height: ${previewHeight}px` : ''">
+			<div ref="pdfContainer" class="footer-preview__pdf" :style="containerHeight ? `min-height: ${containerHeight}px` : ''">
 				<div v-if="loadingPreview" class="footer-preview__loading">
 					<NcLoadingIcon :size="64" />
 				</div>
@@ -84,6 +112,7 @@ import VuePdfEditor from '@libresign/vue-pdf-editor'
 
 import MagnifyMinusOutline from 'vue-material-design-icons/MagnifyMinusOutline.vue'
 import MagnifyPlusOutline from 'vue-material-design-icons/MagnifyPlusOutline.vue'
+import Undo from 'vue-material-design-icons/UndoVariant.vue'
 
 export default {
 	name: 'FooterTemplateEditor',
@@ -95,6 +124,7 @@ export default {
 		VuePdfEditor,
 		MagnifyMinusOutline,
 		MagnifyPlusOutline,
+		Undo,
 	},
 	props: {
 		initialTemplate: {
@@ -114,9 +144,16 @@ export default {
 			loadingPreview: false,
 			pdfKey: 0,
 			zoomLevel: loadState('libresign', 'footer_preview_zoom_level', 100),
-			previewHeight: null,
+			previewWidth: loadState('libresign', 'footer_preview_width', 595),
+			previewHeight: loadState('libresign', 'footer_preview_height', 80),
+			containerHeight: null,
 		}
 	},
+	computed: {
+		showResetDimensions() {
+			return Number(this.previewWidth) !== 595 || Number(this.previewHeight) !== 80
+		},
+	},
 	watch: {
 		initialTemplate(newValue) {
 			this.footerTemplate = newValue
@@ -127,10 +164,19 @@ export default {
 		initialIsDefault(newValue) {
 			this.isDefaultFooterTemplate = newValue
 		},
+		previewWidth() {
+			this.debouncedSaveDimensions()
+			this.debouncedSaveFooterTemplate()
+		},
+		previewHeight() {
+			this.debouncedSaveDimensions()
+			this.debouncedSaveFooterTemplate()
+		},
 	},
 	created() {
 		this.debouncedSaveFooterTemplate = debounce(this.saveFooterTemplate, 500)
 		this.debouncedUpdateScale = debounce(this.updateScale, 300)
+		this.debouncedSaveDimensions = debounce(this.saveDimensions, 500)
 	},
 	mounted() {
 		this.resizeHeight()
@@ -141,10 +187,29 @@ export default {
 			await axios.post(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
 			this.$emit('template-reset')
 		},
+		resetDimensions() {
+			this.previewWidth = 595
+			this.previewHeight = 80
+			this.saveDimensions()
+			this.saveFooterTemplate()
+		},
+		saveDimensions() {
+			if (Number(this.previewWidth) === 595 && Number(this.previewHeight) === 80) {
+				OCP.AppConfig.deleteKey('libresign', 'footer_preview_width')
+				OCP.AppConfig.deleteKey('libresign', 'footer_preview_height')
+			} else {
+				OCP.AppConfig.setValue('libresign', 'footer_preview_width', this.previewWidth)
+				OCP.AppConfig.setValue('libresign', 'footer_preview_height', this.previewHeight)
+			}
+		},
 		saveFooterTemplate() {
 			axios.post(
 				generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'),
-				{ template: this.footerTemplate, width: 595, height: 80 },
+				{
+					template: this.footerTemplate,
+					width: Number(this.previewWidth),
+					height: Number(this.previewHeight),
+				},
 				{ responseType: 'blob' }
 			).then(response => {
 				this.isDefaultFooterTemplate = false
@@ -158,7 +223,7 @@ export default {
 			this.loadingPreview = true
 
 			if (this.$refs.pdfContainer) {
-				this.previewHeight = this.$refs.pdfContainer.offsetHeight
+				this.containerHeight = this.$refs.pdfContainer.offsetHeight
 			}
 
 			this.$nextTick(() => {
@@ -170,7 +235,7 @@ export default {
 		},
 		onPdfReady() {
 			this.loadingPreview = false
-			this.previewHeight = null
+			this.containerHeight = null
 		},
 		changeZoomLevel(delta) {
 			this.zoomLevel = Number(this.zoomLevel) + delta
@@ -242,11 +307,23 @@ export default {
 		font-size: 14px;
 	}
 
+	&__controls {
+		display: flex;
+		flex-wrap: wrap;
+		gap: 12px;
+		margin-bottom: 10px;
+	}
+
 	&__zoom-controls {
 		display: flex;
 		gap: 8px;
 		align-items: center;
-		margin-bottom: 10px;
+	}
+
+	&__dimension-controls {
+		display: flex;
+		gap: 8px;
+		align-items: center;
 	}
 
 	&__zoom-level {

From 319752e65dad8fd6c92eb03160170c6a5283d433 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:22:47 -0300
Subject: [PATCH 07/27] chore: move footer.twig SPDX headers to REUSE.toml

- Remove inline SPDX comment from footer.twig template
- Add lib/Handler/Templates/footer.twig to REUSE.toml annotations

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 REUSE.toml                        | 1 +
 lib/Handler/Templates/footer.twig | 4 ----
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/REUSE.toml b/REUSE.toml
index 965e981dd9..ed835c94c3 100644
--- a/REUSE.toml
+++ b/REUSE.toml
@@ -33,6 +33,7 @@ path = [
     "jsconfig.json",
     "l10n/*.js",
     "l10n/*.json",
+    "lib/Handler/Templates/footer.twig",
     "Makefile",
     "lib/Vendor/.gitkeep",
     "openapi-administration.json",
diff --git a/lib/Handler/Templates/footer.twig b/lib/Handler/Templates/footer.twig
index 6640dfd209..7a0bf52722 100644
--- a/lib/Handler/Templates/footer.twig
+++ b/lib/Handler/Templates/footer.twig
@@ -1,7 +1,3 @@
-{#
-  SPDX-FileCopyrightText: 2024 LibreCode coop and contributors
-  SPDX-License-Identifier: AGPL-3.0-or-later
-#}
 <table style="width:100%; border:0; {% if not qrcode %}padding-left:15px;{% endif %} font-size:8px;">
 	<tr>
 		{% if qrcode %}

From 2ebd84746b8ecba23f19ea115af60761e6ecbde6 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 18:21:46 -0300
Subject: [PATCH 08/27] chore: add vue-codemirror and codemirror dependencies

- Add vue-codemirror@4.0.6 for code editing
- Add codemirror@5.65.18 for syntax highlighting
- Required for CodeEditor component with Twig support

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 package-lock.json | 28 ++++++++++++++++++++++++++++
 package.json      |  2 ++
 2 files changed, 30 insertions(+)

diff --git a/package-lock.json b/package-lock.json
index 923b94503d..cce6d544d2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -31,6 +31,7 @@
         "@nextcloud/vue": "^8.34.0",
         "@vueuse/core": "^11.3.0",
         "blueimp-md5": "^2.19.0",
+        "codemirror": "^5.65.20",
         "copy-webpack-plugin": "^13.0.1",
         "crypto-js": "^4.2.0",
         "debounce": "^2.2.0",
@@ -39,6 +40,7 @@
         "signature_pad": "^5.1.1",
         "vue": "^2.7.16",
         "vue-advanced-cropper": "^1.11.7",
+        "vue-codemirror": "^4.0.6",
         "vue-drag-resize": "^1.5.4",
         "vue-material-design-icons": "^5.3.1",
         "vue-router": "^3.6.5",
@@ -6839,6 +6841,12 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/codemirror": {
+      "version": "5.65.20",
+      "resolved": "https://registry.npmjs.org/codemirror/-/codemirror-5.65.20.tgz",
+      "integrity": "sha512-i5dLDDxwkFCbhjvL2pNjShsojoL3XHyDwsGv1jqETUoW+lzpBKKqNTUWgQwVAOa0tUm4BwekT455ujafi8payA==",
+      "license": "MIT"
+    },
     "node_modules/color": {
       "version": "4.2.3",
       "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",
@@ -7690,6 +7698,12 @@
       "integrity": "sha512-ED3jP8saaweFTjeGX8HQPjeC1YYyZs98jGNZx6IiBvxW7JG5v492kamAQB3m2wop07CvU/RQmzcKr6bgcC5D/Q==",
       "license": "MIT"
     },
+    "node_modules/diff-match-patch": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/diff-match-patch/-/diff-match-patch-1.0.5.tgz",
+      "integrity": "sha512-IayShXAgj/QMXgB0IWmKx+rOPuGMhqm5w6jvFxmVenXKIzRqTAAsbBPT3kWQeGANj3jGgvcvv4yK6SxqYmikgw==",
+      "license": "Apache-2.0"
+    },
     "node_modules/diffie-hellman": {
       "version": "5.0.3",
       "resolved": "https://registry.npmjs.org/diffie-hellman/-/diffie-hellman-5.0.3.tgz",
@@ -17077,6 +17091,20 @@
       "integrity": "sha512-XRRe6Glud4rd/ZGQfiV1ruXSfbvfJedlV9Y6zOlP+2K04vBYiJEte6stfFkCP03aMnY5tsipamumUjL14fofug==",
       "license": "MIT"
     },
+    "node_modules/vue-codemirror": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/vue-codemirror/-/vue-codemirror-4.0.6.tgz",
+      "integrity": "sha512-ilU7Uf0mqBNSSV3KT7FNEeRIxH4s1fmpG4TfHlzvXn0QiQAbkXS9lLfwuZpaBVEnpP5CSE62iGJjoliTuA8poQ==",
+      "license": "MIT",
+      "dependencies": {
+        "codemirror": "^5.41.0",
+        "diff-match-patch": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 4.0.0",
+        "npm": ">= 3.0.0"
+      }
+    },
     "node_modules/vue-color": {
       "version": "2.8.2",
       "resolved": "https://registry.npmjs.org/vue-color/-/vue-color-2.8.2.tgz",
diff --git a/package.json b/package.json
index 1689a85b7a..52bd520bde 100644
--- a/package.json
+++ b/package.json
@@ -42,6 +42,7 @@
     "@nextcloud/vue": "^8.34.0",
     "@vueuse/core": "^11.3.0",
     "blueimp-md5": "^2.19.0",
+    "codemirror": "^5.65.20",
     "copy-webpack-plugin": "^13.0.1",
     "crypto-js": "^4.2.0",
     "debounce": "^2.2.0",
@@ -50,6 +51,7 @@
     "signature_pad": "^5.1.1",
     "vue": "^2.7.16",
     "vue-advanced-cropper": "^1.11.7",
+    "vue-codemirror": "^4.0.6",
     "vue-drag-resize": "^1.5.4",
     "vue-material-design-icons": "^5.3.1",
     "vue-router": "^3.6.5",

From 84aaae14f2554c26ee230b19520a4748de1b8699 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 18:22:14 -0300
Subject: [PATCH 09/27] feat: add CodeEditor component with syntax highlighting

- Create reusable CodeEditor component using vue-codemirror
- Add Twig mode for syntax highlighting
- Enable bracket matching and auto-close
- Use Material theme integrated with Nextcloud colors
- Support line numbers, line wrapping, and auto-indent

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/CodeEditor.vue | 101 ++++++++++++++++++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 src/components/CodeEditor.vue

diff --git a/src/components/CodeEditor.vue b/src/components/CodeEditor.vue
new file mode 100644
index 0000000000..3f3c0b69df
--- /dev/null
+++ b/src/components/CodeEditor.vue
@@ -0,0 +1,101 @@
+<!--
+  - SPDX-FileCopyrightText: 2024 LibreCode coop and LibreCode contributors
+  - SPDX-License-Identifier: AGPL-3.0-or-later
+-->
+<template>
+	<div class="code-editor">
+		<codemirror
+			:value="value"
+			:options="editorOptions"
+			@input="onInput" />
+	</div>
+</template>
+
+<script>
+import { codemirror } from 'vue-codemirror'
+import 'codemirror/lib/codemirror.css'
+import 'codemirror/theme/material.css'
+import 'codemirror/mode/twig/twig.js'
+import 'codemirror/addon/edit/matchbrackets.js'
+import 'codemirror/addon/edit/closebrackets.js'
+import 'codemirror/addon/edit/closetag.js'
+
+export default {
+	name: 'CodeEditor',
+	components: {
+		codemirror,
+	},
+	props: {
+		value: {
+			type: String,
+			default: '',
+		},
+		placeholder: {
+			type: String,
+			default: '',
+		},
+	},
+	computed: {
+		editorOptions() {
+			return {
+				mode: 'twig',
+				theme: 'material',
+				lineNumbers: true,
+				lineWrapping: true,
+				matchBrackets: true,
+				autoCloseBrackets: true,
+				indentUnit: 4,
+				tabSize: 4,
+				indentWithTabs: true,
+				placeholder: this.placeholder,
+			}
+		},
+	},
+	methods: {
+		onInput(value) {
+			this.$emit('input', value)
+		},
+	},
+}
+</script>
+
+<style lang="scss">
+.code-editor {
+	border: 2px solid var(--color-border-dark);
+	border-radius: var(--border-radius);
+	overflow: hidden;
+
+	.CodeMirror {
+		height: auto;
+		min-height: 200px;
+		font-family: 'Courier New', Courier, monospace;
+		font-size: 14px;
+		line-height: 1.5;
+		background-color: var(--color-main-background);
+		color: var(--color-main-text);
+	}
+
+	.CodeMirror-cursor {
+		border-left-color: var(--color-main-text);
+	}
+
+	.CodeMirror-selected {
+		background-color: rgba(var(--color-primary-element-rgb), 0.2);
+	}
+
+	.CodeMirror-gutters {
+		background-color: var(--color-background-dark);
+		border-right: 1px solid var(--color-border);
+	}
+
+	.CodeMirror-linenumber {
+		color: var(--color-text-maxcontrast);
+	}
+
+	.CodeMirror-matchingbracket {
+		color: var(--color-primary-element) !important;
+		background-color: rgba(var(--color-primary-element-rgb), 0.1);
+		font-weight: bold;
+	}
+}
+</style>

From e207ba3c5c012208b51340d157e3472d0f245304 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 18:22:23 -0300
Subject: [PATCH 10/27] feat: replace NcTextArea with CodeEditor in footer
 template

- Replace simple textarea with CodeEditor component
- Add syntax highlighting for Twig templates
- Remove manual textarea resize logic (CodeMirror handles it)
- Improve developer experience with professional code editor

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/FooterTemplateEditor.vue | 35 +++++--------------------
 1 file changed, 6 insertions(+), 29 deletions(-)

diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
index e3ce86d2fa..6eb7815bfa 100644
--- a/src/components/FooterTemplateEditor.vue
+++ b/src/components/FooterTemplateEditor.vue
@@ -12,14 +12,10 @@
 				{{ t('libresign', 'Reset to default') }}
 			</NcButton>
 		</div>
-		<NcTextArea ref="textareaEditor"
+		<CodeEditor
 			v-model="footerTemplate"
-			label=""
-			placeholder="A twig template to be used at footer of PDF. Will be rendered by mPDF."
-			resize="vertical"
-			@input="debouncedSaveFooterTemplate"
-			@mousemove="resizeHeight"
-			@keypress="resizeHeight" />
+			:placeholder="t('libresign', 'A twig template to be used at footer of PDF. Will be rendered by mPDF.')"
+			@input="debouncedSaveFooterTemplate" />
 		<div v-if="pdfPreviewFile" class="footer-preview">
 			<h4>{{ t('libresign', 'Preview') }}</h4>
 			<div class="footer-preview__controls">
@@ -105,11 +101,12 @@ import { generateOcsUrl } from '@nextcloud/router'
 
 import NcButton from '@nextcloud/vue/components/NcButton'
 import NcLoadingIcon from '@nextcloud/vue/components/NcLoadingIcon'
-import NcTextArea from '@nextcloud/vue/components/NcTextArea'
 import NcTextField from '@nextcloud/vue/components/NcTextField'
 // eslint-disable-next-line import/default
 import VuePdfEditor from '@libresign/vue-pdf-editor'
 
+import CodeEditor from './CodeEditor.vue'
+
 import MagnifyMinusOutline from 'vue-material-design-icons/MagnifyMinusOutline.vue'
 import MagnifyPlusOutline from 'vue-material-design-icons/MagnifyPlusOutline.vue'
 import Undo from 'vue-material-design-icons/UndoVariant.vue'
@@ -117,9 +114,9 @@ import Undo from 'vue-material-design-icons/UndoVariant.vue'
 export default {
 	name: 'FooterTemplateEditor',
 	components: {
+		CodeEditor,
 		NcButton,
 		NcLoadingIcon,
-		NcTextArea,
 		NcTextField,
 		VuePdfEditor,
 		MagnifyMinusOutline,
@@ -179,7 +176,6 @@ export default {
 		this.debouncedSaveDimensions = debounce(this.saveDimensions, 500)
 	},
 	mounted() {
-		this.resizeHeight()
 		this.saveFooterTemplate()
 	},
 	methods: {
@@ -253,19 +249,6 @@ export default {
 			this.zoomLevel = Math.round(newScale * 100)
 			OCP.AppConfig.setValue('libresign', 'footer_preview_zoom_level', this.zoomLevel)
 		},
-
-		resizeHeight: debounce(function() {
-			const wrapper = this.$refs.textareaEditor
-			if (!wrapper || !wrapper.$el) {
-				return
-			}
-			const mainWrapper = wrapper.$el.querySelector('.textarea__main-wrapper')
-			const textarea = wrapper.$el.querySelector('textarea')
-			if (mainWrapper && textarea) {
-				mainWrapper.style.height = 'auto'
-				mainWrapper.style.height = `${textarea.scrollHeight + 4}px`
-			}
-		}, 100),
 	},
 }
 </script>
@@ -286,12 +269,6 @@ export default {
 			font-size: 14px;
 		}
 	}
-
-	:deep(.textarea) {
-		textarea {
-			height: 100%;
-		}
-	}
 }
 
 .footer-preview {

From 1c84886080d5d99fd16c7c54dcdc5b1d648843f6 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 19:16:46 -0300
Subject: [PATCH 11/27] fix: use realistic UUID format in footer preview

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Service/FooterService.php | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/lib/Service/FooterService.php b/lib/Service/FooterService.php
index 75b83cac7e..94ffad1809 100644
--- a/lib/Service/FooterService.php
+++ b/lib/Service/FooterService.php
@@ -46,8 +46,18 @@ public function renderPreviewPdf(string $template = '', int $width = 595, int $h
 			$this->saveTemplate($template);
 		}
 
+		// Generate a realistic UUID format for preview (36 chars with hyphens, same as real UUIDs)
+		// This ensures QR code size matches the final document
+		$previewUuid = sprintf(
+			'preview-%04x-%04x-%04x-%012x',
+			random_int(0, 0xffff),
+			random_int(0, 0xffff),
+			random_int(0, 0xffff),
+			random_int(0, 0xffffffffffff)
+		);
+
 		return $this->footerHandler
-			->setTemplateVar('uuid', 'preview-' . bin2hex(random_bytes(8)))
+			->setTemplateVar('uuid', $previewUuid)
 			->setTemplateVar('signers', [
 				[
 					'displayName' => 'Preview Signer',

From 111ca586a230f134a1f42e740579aa860b22261d Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:12:17 -0300
Subject: [PATCH 12/27] refactor: add IL10N injection and metadata to
 TemplateVariables

- Add IL10N dependency injection for translations
- Replace const ALLOWED_VARIABLES with instance property
- Add initializeVariablesMetadata() method with full metadata
- Add getVariablesMetadata() method returning associative array
- Include type, description, example, and optional default for each variable
- Add defaults for signedBy, linkToSite, and validateIn variables
- Update tests with IL10N mock and comprehensive coverage
- Add DataProviders for testing defaults and types

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Handler/TemplateVariables.php             | 88 +++++++++++++++----
 .../Unit/Handler/TemplateVariablesTest.php    | 63 ++++++++++++-
 2 files changed, 134 insertions(+), 17 deletions(-)

diff --git a/lib/Handler/TemplateVariables.php b/lib/Handler/TemplateVariables.php
index b5cd786873..efd4f59bab 100644
--- a/lib/Handler/TemplateVariables.php
+++ b/lib/Handler/TemplateVariables.php
@@ -9,6 +9,8 @@
 
 namespace OCA\Libresign\Handler;
 
+use OCP\IL10N;
+
 /**
  * @method self setDirection(string $value)
  * @method self setLinkToSite(string $value)
@@ -31,21 +33,66 @@
  */
 class TemplateVariables {
 	private array $variables = [];
+	private array $variablesMetadata = [];
 
-	/**
-	 * Allowed template variable names with their expected types
-	 */
-	private const ALLOWED_VARIABLES = [
-		'direction' => 'string',
-		'linkToSite' => 'string',
-		'qrcode' => 'string',
-		'qrcodeSize' => 'integer',
-		'signedBy' => 'string',
-		'signers' => 'array',
-		'uuid' => 'string',
-		'validateIn' => 'string',
-		'validationSite' => 'string',
-	];
+	public function __construct(
+		private IL10N $l10n,
+	) {
+		$this->initializeVariablesMetadata();
+	}
+
+	private function initializeVariablesMetadata(): void {
+		$this->variablesMetadata = [
+			'direction' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Text direction for the footer (ltr or rtl based on language)'),
+				'example' => 'ltr',
+			],
+			'linkToSite' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Link to LibreSign or custom website'),
+				'example' => 'https://libresign.coop',
+				'default' => 'https://libresign.coop',
+			],
+			'qrcode' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('QR Code image in base64 format for document validation'),
+				'example' => 'iVBORw0KGgoAAAANSUhEUgAA...',
+			],
+			'qrcodeSize' => [
+				'type' => 'integer',
+				'description' => $this->l10n->t('QR Code size in pixels (includes margin)'),
+				'example' => 108,
+			],
+			'signedBy' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Message indicating the document was digitally signed'),
+				'example' => 'Digitally signed by LibreSign.',
+				'default' => $this->l10n->t('Digitally signed by LibreSign.'),
+			],
+			'signers' => [
+				'type' => 'array',
+				'description' => $this->l10n->t('Array of signers with displayName and signed timestamp'),
+				'example' => '[{"displayName": "John Doe", "signed": "2025-01-01T10:00:00Z"}]',
+			],
+			'uuid' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Document unique identifier (UUID format)'),
+				'example' => 'de0a18d4-fe65-4abc-bdd1-84e819700260',
+			],
+			'validateIn' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Validation message template with placeholder'),
+				'example' => 'Validate in %s.',
+				'default' => $this->l10n->t('Validate in %s.', ['%s']),
+			],
+			'validationSite' => [
+				'type' => 'string',
+				'description' => $this->l10n->t('Complete URL for document validation with UUID'),
+				'example' => 'https://example.com/validation/de0a18d4-fe65-4abc-bdd1-84e819700260',
+			],
+		];
+	}
 
 	/**
 	 * @throws \InvalidArgumentException if trying to access non-whitelisted variable or wrong type
@@ -70,13 +117,13 @@ public function __call(string $method, array $args): mixed {
 	}
 
 	private function ensureAllowed(string $key): void {
-		if (!array_key_exists($key, self::ALLOWED_VARIABLES)) {
+		if (!array_key_exists($key, $this->variablesMetadata)) {
 			throw new \InvalidArgumentException("Template variable '{$key}' is not allowed");
 		}
 	}
 
 	private function ensureType(string $key, mixed $value): void {
-		$expected = self::ALLOWED_VARIABLES[$key];
+		$expected = $this->variablesMetadata[$key]['type'];
 		$actual = gettype($value);
 
 		if ($actual !== $expected) {
@@ -92,6 +139,15 @@ public function toArray(): array {
 		return $this->variables;
 	}
 
+	/**
+	 * Get metadata for all available template variables
+	 *
+	 * @return array Associative array of variable metadata (name => config)
+	 */
+	public function getVariablesMetadata(): array {
+		return $this->variablesMetadata;
+	}
+
 	/**
 	 * Merge additional variables, validating against whitelist and types
 	 *
diff --git a/tests/php/Unit/Handler/TemplateVariablesTest.php b/tests/php/Unit/Handler/TemplateVariablesTest.php
index a070dabaed..8c278aa77d 100644
--- a/tests/php/Unit/Handler/TemplateVariablesTest.php
+++ b/tests/php/Unit/Handler/TemplateVariablesTest.php
@@ -11,17 +11,23 @@
 
 use OCA\Libresign\Handler\TemplateVariables;
 use OCA\Libresign\Tests\Unit\TestCase;
+use OCP\IL10N;
 use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\MockObject\MockObject;
 
 /**
  * @internal
  */
 final class TemplateVariablesTest extends TestCase {
 	private TemplateVariables $variables;
+	private IL10N&MockObject $l10n;
 
 	public function setUp(): void {
 		parent::setUp();
-		$this->variables = new TemplateVariables();
+		$this->l10n = $this->createMock(IL10N::class);
+		$this->l10n->method('t')->willReturnCallback(fn($text) => $text);
+
+		$this->variables = new TemplateVariables($this->l10n);
 	}
 
 	public static function provideValidValues(): array {
@@ -121,4 +127,59 @@ public function testRejectsInvalidMethod(): void {
 
 		$this->variables->invalidMethod();
 	}
+
+	public function testGetVariablesMetadataStructure(): void {
+		$metadata = $this->variables->getVariablesMetadata();
+
+		$this->assertIsArray($metadata);
+		$this->assertCount(9, $metadata);
+
+		$expectedVariables = [
+			'direction', 'linkToSite', 'qrcode', 'qrcodeSize',
+			'signedBy', 'signers', 'uuid', 'validateIn', 'validationSite'
+		];
+		foreach ($expectedVariables as $varName) {
+			$this->assertArrayHasKey($varName, $metadata);
+			$this->assertArrayHasKey('type', $metadata[$varName]);
+			$this->assertArrayHasKey('description', $metadata[$varName]);
+			$this->assertArrayHasKey('example', $metadata[$varName]);
+		}
+	}
+
+	public static function provideVariablesWithDefaults(): array {
+		return [
+			'linkToSite' => ['linkToSite', 'https://libresign.coop'],
+			'signedBy' => ['signedBy', 'Digitally signed by LibreSign.'],
+			'validateIn' => ['validateIn', 'Validate in %s.'],
+		];
+	}
+
+	#[DataProvider('provideVariablesWithDefaults')]
+	public function testMetadataDefaultValues(string $variable, string $expectedDefault): void {
+		$metadata = $this->variables->getVariablesMetadata();
+
+		$this->assertArrayHasKey('default', $metadata[$variable]);
+		$this->assertSame($expectedDefault, $metadata[$variable]['default']);
+	}
+
+	public static function provideVariableTypes(): array {
+		return [
+			'direction is string' => ['direction', 'string'],
+			'linkToSite is string' => ['linkToSite', 'string'],
+			'qrcode is string' => ['qrcode', 'string'],
+			'qrcodeSize is integer' => ['qrcodeSize', 'integer'],
+			'signedBy is string' => ['signedBy', 'string'],
+			'signers is array' => ['signers', 'array'],
+			'uuid is string' => ['uuid', 'string'],
+			'validateIn is string' => ['validateIn', 'string'],
+			'validationSite is string' => ['validationSite', 'string'],
+		];
+	}
+
+	#[DataProvider('provideVariableTypes')]
+	public function testMetadataTypes(string $variable, string $expectedType): void {
+		$metadata = $this->variables->getVariablesMetadata();
+
+		$this->assertSame($expectedType, $metadata[$variable]['type']);
+	}
 }

From 34bddf004d0b38d4da6b987caec9f858f9445e8c Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:13:37 -0300
Subject: [PATCH 13/27] refactor: inject TemplateVariables into FooterHandler
 via DI

- Add TemplateVariables as constructor parameter
- Remove manual instantiation with 'new TemplateVariables()'
- Add getTemplateVariablesMetadata() method exposing metadata
- Update tests to use real TemplateVariables instance instead of mock
- Test getTemplateVariablesMetadata returns complete metadata structure

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Handler/FooterHandler.php                |  4 +---
 tests/php/Unit/Handler/FooterHandlerTest.php | 18 +++++++++++++++++-
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/lib/Handler/FooterHandler.php b/lib/Handler/FooterHandler.php
index 8d2864e88e..ff475fb2ec 100644
--- a/lib/Handler/FooterHandler.php
+++ b/lib/Handler/FooterHandler.php
@@ -36,8 +36,6 @@ class FooterHandler {
 	private const MIN_QRCODE_SIZE = 100;
 	private const POINT_TO_MILIMETER = 0.3527777778;
 
-	private TemplateVariables $templateVars;
-
 	public function __construct(
 		private IAppConfig $appConfig,
 		private PdfParserService $pdfParserService,
@@ -45,8 +43,8 @@ public function __construct(
 		private IL10N $l10n,
 		private IFactory $l10nFactory,
 		private ITempManager $tempManager,
+		private TemplateVariables $templateVars,
 	) {
-		$this->templateVars = new TemplateVariables();
 	}
 
 	public function getFooter(array $dimensions): string {
diff --git a/tests/php/Unit/Handler/FooterHandlerTest.php b/tests/php/Unit/Handler/FooterHandlerTest.php
index 5d4c6816e2..cdc099041f 100644
--- a/tests/php/Unit/Handler/FooterHandlerTest.php
+++ b/tests/php/Unit/Handler/FooterHandlerTest.php
@@ -8,6 +8,7 @@
 
 use OCA\Libresign\AppInfo\Application;
 use OCA\Libresign\Handler\FooterHandler;
+use OCA\Libresign\Handler\TemplateVariables;
 use OCA\Libresign\Service\PdfParserService;
 use OCP\IAppConfig;
 use OCP\IL10N;
@@ -30,11 +31,11 @@ public function setUp(): void {
 		$this->pdfParserService = $this->createMock(PdfParserService::class);
 		$this->urlGenerator = $this->createMock(IURLGenerator::class);
 		$this->tempManager = \OCP\Server::get(ITempManager::class);
-
 		$this->l10nFactory = \OCP\Server::get(IFactory::class);
 	}
 
 	private function getClass(): FooterHandler {
+		$templateVars = new TemplateVariables($this->l10n);
 		$this->footerHandler = new FooterHandler(
 			$this->appConfig,
 			$this->pdfParserService,
@@ -42,6 +43,7 @@ private function getClass(): FooterHandler {
 			$this->l10n,
 			$this->l10nFactory,
 			$this->tempManager,
+			$templateVars,
 		);
 		return $this->footerHandler;
 	}
@@ -306,4 +308,18 @@ public function testGetTemplateReturnsDefaultWhenEmpty(): void {
 		$defaultTemplate = file_get_contents(__DIR__ . '/../../../../lib/Handler/Templates/footer.twig');
 		$this->assertSame($defaultTemplate, $template);
 	}
+
+	public function testGetTemplateVariablesMetadata(): void {
+		$this->l10n = $this->l10nFactory->get(Application::APP_ID, 'en');
+		$metadata = $this->getClass()->getTemplateVariablesMetadata();
+
+		$this->assertIsArray($metadata);
+		$this->assertCount(9, $metadata);
+		$this->assertArrayHasKey('direction', $metadata);
+		$this->assertArrayHasKey('uuid', $metadata);
+		$this->assertArrayHasKey('signedBy', $metadata);
+		$this->assertSame('string', $metadata['direction']['type']);
+		$this->assertSame('string', $metadata['uuid']['type']);
+		$this->assertArrayHasKey('default', $metadata['signedBy']);
+	}
 }

From 41db62b968624c56e1a19042098e295251a68ac7 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:14:09 -0300
Subject: [PATCH 14/27] feat: add template variables metadata endpoint to
 FooterService

- Add getTemplateVariablesMetadata() method delegating to FooterHandler
- Update tests to validate metadata retrieval
- Fix UUID regex in preview tests to match new format (36 chars with hyphens)

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Service/FooterService.php                |  4 +++
 tests/php/Unit/Service/FooterServiceTest.php | 26 +++++++++++++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/lib/Service/FooterService.php b/lib/Service/FooterService.php
index 94ffad1809..abbe7055d0 100644
--- a/lib/Service/FooterService.php
+++ b/lib/Service/FooterService.php
@@ -66,4 +66,8 @@ public function renderPreviewPdf(string $template = '', int $width = 595, int $h
 			])
 			->getFooter([['w' => $width, 'h' => $height]]);
 	}
+
+	public function getTemplateVariablesMetadata(): array {
+		return $this->footerHandler->getTemplateVariablesMetadata();
+	}
 }
diff --git a/tests/php/Unit/Service/FooterServiceTest.php b/tests/php/Unit/Service/FooterServiceTest.php
index 35942758a0..372f9b652d 100644
--- a/tests/php/Unit/Service/FooterServiceTest.php
+++ b/tests/php/Unit/Service/FooterServiceTest.php
@@ -101,7 +101,7 @@ public function testRenderPreviewPdf(?string $template, int $width, int $height,
 			->method('setTemplateVar')
 			->willReturnCallback(function ($key, $value) {
 				if ($key === 'uuid') {
-					$this->assertMatchesRegularExpression('/^preview-[a-f0-9]{16}$/', $value);
+					$this->assertMatchesRegularExpression('/^preview-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/', $value);
 				} elseif ($key === 'signers') {
 					$this->assertIsArray($value);
 					$this->assertCount(1, $value);
@@ -141,4 +141,28 @@ public static function provideRenderPreviewPdfScenarios(): array {
 			'large dimensions' => ['', 2000, 500, false],
 		];
 	}
+
+	public function testGetTemplateVariablesMetadata(): void {
+		$expectedMetadata = [
+			'direction' => [
+				'type' => 'string',
+				'description' => 'Text direction for the footer',
+				'example' => 'ltr',
+			],
+			'uuid' => [
+				'type' => 'string',
+				'description' => 'Document unique identifier',
+				'example' => 'de0a18d4-fe65-4abc-bdd1-84e819700260',
+			],
+		];
+
+		$this->footerHandler
+			->expects($this->once())
+			->method('getTemplateVariablesMetadata')
+			->willReturn($expectedMetadata);
+
+		$result = $this->service->getTemplateVariablesMetadata();
+
+		$this->assertSame($expectedMetadata, $result);
+	}
 }

From cdae4fa649606617c5a0f62d8e074b0650faadc6 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:14:33 -0300
Subject: [PATCH 15/27] feat: add API endpoint for footer template variables
 metadata

- Add GET /api/v1/admin/footer-template/variables endpoint
- Return complete metadata for all available Twig variables
- Include type, description, example, and optional default values
- Add NoCSRFRequired attribute for read-only endpoint
- Document response schema with psalm annotations

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Controller/AdminController.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/lib/Controller/AdminController.php b/lib/Controller/AdminController.php
index 13d2e10d04..b3cb7c2aa7 100644
--- a/lib/Controller/AdminController.php
+++ b/lib/Controller/AdminController.php
@@ -803,6 +803,21 @@ public function getFooterTemplate(): DataResponse {
 		]);
 	}
 
+	/**
+	 * Get footer template variables metadata
+	 *
+	 * Returns metadata for all available Twig variables that can be used in footer templates.
+	 *
+	 * @return DataResponse<Http::STATUS_OK, array<string, array{type: string, description: string, example: mixed, default?: mixed}>, array{}>
+	 *
+	 * 200: OK
+	 */
+	#[NoCSRFRequired]
+	#[ApiRoute(verb: 'GET', url: '/api/{apiVersion}/admin/footer-template/variables', requirements: ['apiVersion' => '(v1)'])]
+	public function getFooterTemplateVariables(): DataResponse {
+		return new DataResponse($this->footerService->getTemplateVariablesMetadata());
+	}
+
 	/**
 	 * Save footer template and render preview
 	 *

From 397d33e4ad43790bbe59794b37f71d466b617807 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:15:52 -0300
Subject: [PATCH 16/27] docs: update OpenAPI documentation and TypeScript types

- Add getFooterTemplateVariables endpoint to OpenAPI specs
- Generate TypeScript types for template variables metadata
- Document response schema with variable metadata structure
- Update both administration and full API specifications

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 openapi-administration.json                 | 96 +++++++++++++++++++++
 openapi-full.json                           | 96 +++++++++++++++++++++
 src/types/openapi/openapi-administration.ts | 58 +++++++++++++
 src/types/openapi/openapi-full.ts           | 58 +++++++++++++
 4 files changed, 308 insertions(+)

diff --git a/openapi-administration.json b/openapi-administration.json
index 37317baaab..1305f484f1 100644
--- a/openapi-administration.json
+++ b/openapi-administration.json
@@ -2805,6 +2805,102 @@
                 }
             }
         },
+        "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
+            "get": {
+                "operationId": "admin-get-footer-template-variables",
+                "summary": "Get footer template variables metadata",
+                "description": "Returns metadata for all available Twig variables that can be used in footer templates.\nThis endpoint requires admin access",
+                "tags": [
+                    "admin"
+                ],
+                "security": [
+                    {
+                        "bearer_auth": []
+                    },
+                    {
+                        "basic_auth": []
+                    }
+                ],
+                "parameters": [
+                    {
+                        "name": "apiVersion",
+                        "in": "path",
+                        "required": true,
+                        "schema": {
+                            "type": "string",
+                            "enum": [
+                                "v1"
+                            ],
+                            "default": "v1"
+                        }
+                    },
+                    {
+                        "name": "OCS-APIRequest",
+                        "in": "header",
+                        "description": "Required to be true for the API request to pass",
+                        "required": true,
+                        "schema": {
+                            "type": "boolean",
+                            "default": true
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "required": [
+                                        "ocs"
+                                    ],
+                                    "properties": {
+                                        "ocs": {
+                                            "type": "object",
+                                            "required": [
+                                                "meta",
+                                                "data"
+                                            ],
+                                            "properties": {
+                                                "meta": {
+                                                    "$ref": "#/components/schemas/OCSMeta"
+                                                },
+                                                "data": {
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                        "type": "object",
+                                                        "required": [
+                                                            "type",
+                                                            "description",
+                                                            "example"
+                                                        ],
+                                                        "properties": {
+                                                            "type": {
+                                                                "type": "string"
+                                                            },
+                                                            "description": {
+                                                                "type": "string"
+                                                            },
+                                                            "example": {
+                                                                "type": "object"
+                                                            },
+                                                            "default": {
+                                                                "type": "object"
+                                                            }
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
         "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
             "get": {
                 "operationId": "crl_api-list",
diff --git a/openapi-full.json b/openapi-full.json
index 12d1deaf8b..18225dfd02 100644
--- a/openapi-full.json
+++ b/openapi-full.json
@@ -11282,6 +11282,102 @@
                 }
             }
         },
+        "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
+            "get": {
+                "operationId": "admin-get-footer-template-variables",
+                "summary": "Get footer template variables metadata",
+                "description": "Returns metadata for all available Twig variables that can be used in footer templates.\nThis endpoint requires admin access",
+                "tags": [
+                    "admin"
+                ],
+                "security": [
+                    {
+                        "bearer_auth": []
+                    },
+                    {
+                        "basic_auth": []
+                    }
+                ],
+                "parameters": [
+                    {
+                        "name": "apiVersion",
+                        "in": "path",
+                        "required": true,
+                        "schema": {
+                            "type": "string",
+                            "enum": [
+                                "v1"
+                            ],
+                            "default": "v1"
+                        }
+                    },
+                    {
+                        "name": "OCS-APIRequest",
+                        "in": "header",
+                        "description": "Required to be true for the API request to pass",
+                        "required": true,
+                        "schema": {
+                            "type": "boolean",
+                            "default": true
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "required": [
+                                        "ocs"
+                                    ],
+                                    "properties": {
+                                        "ocs": {
+                                            "type": "object",
+                                            "required": [
+                                                "meta",
+                                                "data"
+                                            ],
+                                            "properties": {
+                                                "meta": {
+                                                    "$ref": "#/components/schemas/OCSMeta"
+                                                },
+                                                "data": {
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                        "type": "object",
+                                                        "required": [
+                                                            "type",
+                                                            "description",
+                                                            "example"
+                                                        ],
+                                                        "properties": {
+                                                            "type": {
+                                                                "type": "string"
+                                                            },
+                                                            "description": {
+                                                                "type": "string"
+                                                            },
+                                                            "example": {
+                                                                "type": "object"
+                                                            },
+                                                            "default": {
+                                                                "type": "object"
+                                                            }
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
         "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
             "get": {
                 "operationId": "crl_api-list",
diff --git a/src/types/openapi/openapi-administration.ts b/src/types/openapi/openapi-administration.ts
index 12aa601ad7..764086b185 100644
--- a/src/types/openapi/openapi-administration.ts
+++ b/src/types/openapi/openapi-administration.ts
@@ -323,6 +323,27 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get footer template variables metadata
+         * @description Returns metadata for all available Twig variables that can be used in footer templates.
+         *     This endpoint requires admin access
+         */
+        get: operations["admin-get-footer-template-variables"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
         parameters: {
             query?: never;
@@ -1497,6 +1518,43 @@ export interface operations {
             };
         };
     };
+    "admin-get-footer-template-variables": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Required to be true for the API request to pass */
+                "OCS-APIRequest": boolean;
+            };
+            path: {
+                apiVersion: "v1";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ocs: {
+                            meta: components["schemas"]["OCSMeta"];
+                            data: {
+                                [key: string]: {
+                                    type: string;
+                                    description: string;
+                                    example: Record<string, never>;
+                                    default?: Record<string, never>;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
     "crl_api-list": {
         parameters: {
             query?: {
diff --git a/src/types/openapi/openapi-full.ts b/src/types/openapi/openapi-full.ts
index 1183bf28a1..6e0bc5e1d0 100644
--- a/src/types/openapi/openapi-full.ts
+++ b/src/types/openapi/openapi-full.ts
@@ -1334,6 +1334,27 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get footer template variables metadata
+         * @description Returns metadata for all available Twig variables that can be used in footer templates.
+         *     This endpoint requires admin access
+         */
+        get: operations["admin-get-footer-template-variables"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
         parameters: {
             query?: never;
@@ -5893,6 +5914,43 @@ export interface operations {
             };
         };
     };
+    "admin-get-footer-template-variables": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Required to be true for the API request to pass */
+                "OCS-APIRequest": boolean;
+            };
+            path: {
+                apiVersion: "v1";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ocs: {
+                            meta: components["schemas"]["OCSMeta"];
+                            data: {
+                                [key: string]: {
+                                    type: string;
+                                    description: string;
+                                    example: Record<string, never>;
+                                    default?: Record<string, never>;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
     "crl_api-list": {
         parameters: {
             query?: {

From 41e5d6962d67df6cf24d2856e729ed7f4c11680d Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:18:06 -0300
Subject: [PATCH 17/27] style: fix code style in TemplateVariablesTest

- Add space after fn in arrow function callback

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 tests/php/Unit/Handler/TemplateVariablesTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/php/Unit/Handler/TemplateVariablesTest.php b/tests/php/Unit/Handler/TemplateVariablesTest.php
index 8c278aa77d..aab56ec943 100644
--- a/tests/php/Unit/Handler/TemplateVariablesTest.php
+++ b/tests/php/Unit/Handler/TemplateVariablesTest.php
@@ -25,7 +25,7 @@ final class TemplateVariablesTest extends TestCase {
 	public function setUp(): void {
 		parent::setUp();
 		$this->l10n = $this->createMock(IL10N::class);
-		$this->l10n->method('t')->willReturnCallback(fn($text) => $text);
+		$this->l10n->method('t')->willReturnCallback(fn ($text) => $text);
 
 		$this->variables = new TemplateVariables($this->l10n);
 	}

From 7584b1906c73d1d76413ef229e4867c10f86bba9 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:22:31 -0300
Subject: [PATCH 18/27] refactor: provide footer template variables via initial
 state

- Add FooterService injection to Admin settings
- Provide footer_template_variables in initial state
- Remove API endpoint getFooterTemplateVariables (no longer needed)
- Update OpenAPI specs removing the endpoint
- Variables now loaded at page load instead of via separate API call

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Controller/AdminController.php | 15 -----
 lib/Settings/Admin.php             |  3 +
 openapi-administration.json        | 96 ------------------------------
 openapi-full.json                  | 96 ------------------------------
 4 files changed, 3 insertions(+), 207 deletions(-)

diff --git a/lib/Controller/AdminController.php b/lib/Controller/AdminController.php
index b3cb7c2aa7..13d2e10d04 100644
--- a/lib/Controller/AdminController.php
+++ b/lib/Controller/AdminController.php
@@ -803,21 +803,6 @@ public function getFooterTemplate(): DataResponse {
 		]);
 	}
 
-	/**
-	 * Get footer template variables metadata
-	 *
-	 * Returns metadata for all available Twig variables that can be used in footer templates.
-	 *
-	 * @return DataResponse<Http::STATUS_OK, array<string, array{type: string, description: string, example: mixed, default?: mixed}>, array{}>
-	 *
-	 * 200: OK
-	 */
-	#[NoCSRFRequired]
-	#[ApiRoute(verb: 'GET', url: '/api/{apiVersion}/admin/footer-template/variables', requirements: ['apiVersion' => '(v1)'])]
-	public function getFooterTemplateVariables(): DataResponse {
-		return new DataResponse($this->footerService->getTemplateVariablesMetadata());
-	}
-
 	/**
 	 * Save footer template and render preview
 	 *
diff --git a/lib/Settings/Admin.php b/lib/Settings/Admin.php
index 4badd78ba4..79afc4b990 100644
--- a/lib/Settings/Admin.php
+++ b/lib/Settings/Admin.php
@@ -12,6 +12,7 @@
 use OCA\Libresign\Exception\LibresignException;
 use OCA\Libresign\Handler\CertificateEngine\CertificateEngineFactory;
 use OCA\Libresign\Service\CertificatePolicyService;
+use OCA\Libresign\Service\FooterService;
 use OCA\Libresign\Service\IdentifyMethodService;
 use OCA\Libresign\Service\SignatureBackgroundService;
 use OCA\Libresign\Service\SignatureTextService;
@@ -32,6 +33,7 @@ public function __construct(
 		private IAppConfig $appConfig,
 		private SignatureTextService $signatureTextService,
 		private SignatureBackgroundService $signatureBackgroundService,
+		private FooterService $footerService,
 	) {
 	}
 	public function getForm(): TemplateResponse {
@@ -61,6 +63,7 @@ public function getForm(): TemplateResponse {
 		$this->initialState->provideInitialState('footer_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'footer_preview_zoom_level', 100));
 		$this->initialState->provideInitialState('footer_preview_width', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_width', 595));
 		$this->initialState->provideInitialState('footer_preview_height', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_height', 80));
+		$this->initialState->provideInitialState('footer_template_variables', $this->footerService->getTemplateVariablesMetadata());
 		$this->initialState->provideInitialState('signature_render_mode', $this->signatureTextService->getRenderMode());
 		$this->initialState->provideInitialState('signature_text_template', $this->signatureTextService->getTemplate());
 		$this->initialState->provideInitialState('signature_width', $this->signatureTextService->getFullSignatureWidth());
diff --git a/openapi-administration.json b/openapi-administration.json
index 1305f484f1..37317baaab 100644
--- a/openapi-administration.json
+++ b/openapi-administration.json
@@ -2805,102 +2805,6 @@
                 }
             }
         },
-        "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
-            "get": {
-                "operationId": "admin-get-footer-template-variables",
-                "summary": "Get footer template variables metadata",
-                "description": "Returns metadata for all available Twig variables that can be used in footer templates.\nThis endpoint requires admin access",
-                "tags": [
-                    "admin"
-                ],
-                "security": [
-                    {
-                        "bearer_auth": []
-                    },
-                    {
-                        "basic_auth": []
-                    }
-                ],
-                "parameters": [
-                    {
-                        "name": "apiVersion",
-                        "in": "path",
-                        "required": true,
-                        "schema": {
-                            "type": "string",
-                            "enum": [
-                                "v1"
-                            ],
-                            "default": "v1"
-                        }
-                    },
-                    {
-                        "name": "OCS-APIRequest",
-                        "in": "header",
-                        "description": "Required to be true for the API request to pass",
-                        "required": true,
-                        "schema": {
-                            "type": "boolean",
-                            "default": true
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "type": "object",
-                                    "required": [
-                                        "ocs"
-                                    ],
-                                    "properties": {
-                                        "ocs": {
-                                            "type": "object",
-                                            "required": [
-                                                "meta",
-                                                "data"
-                                            ],
-                                            "properties": {
-                                                "meta": {
-                                                    "$ref": "#/components/schemas/OCSMeta"
-                                                },
-                                                "data": {
-                                                    "type": "object",
-                                                    "additionalProperties": {
-                                                        "type": "object",
-                                                        "required": [
-                                                            "type",
-                                                            "description",
-                                                            "example"
-                                                        ],
-                                                        "properties": {
-                                                            "type": {
-                                                                "type": "string"
-                                                            },
-                                                            "description": {
-                                                                "type": "string"
-                                                            },
-                                                            "example": {
-                                                                "type": "object"
-                                                            },
-                                                            "default": {
-                                                                "type": "object"
-                                                            }
-                                                        }
-                                                    }
-                                                }
-                                            }
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        },
         "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
             "get": {
                 "operationId": "crl_api-list",
diff --git a/openapi-full.json b/openapi-full.json
index 18225dfd02..12d1deaf8b 100644
--- a/openapi-full.json
+++ b/openapi-full.json
@@ -11282,102 +11282,6 @@
                 }
             }
         },
-        "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
-            "get": {
-                "operationId": "admin-get-footer-template-variables",
-                "summary": "Get footer template variables metadata",
-                "description": "Returns metadata for all available Twig variables that can be used in footer templates.\nThis endpoint requires admin access",
-                "tags": [
-                    "admin"
-                ],
-                "security": [
-                    {
-                        "bearer_auth": []
-                    },
-                    {
-                        "basic_auth": []
-                    }
-                ],
-                "parameters": [
-                    {
-                        "name": "apiVersion",
-                        "in": "path",
-                        "required": true,
-                        "schema": {
-                            "type": "string",
-                            "enum": [
-                                "v1"
-                            ],
-                            "default": "v1"
-                        }
-                    },
-                    {
-                        "name": "OCS-APIRequest",
-                        "in": "header",
-                        "description": "Required to be true for the API request to pass",
-                        "required": true,
-                        "schema": {
-                            "type": "boolean",
-                            "default": true
-                        }
-                    }
-                ],
-                "responses": {
-                    "200": {
-                        "description": "OK",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "type": "object",
-                                    "required": [
-                                        "ocs"
-                                    ],
-                                    "properties": {
-                                        "ocs": {
-                                            "type": "object",
-                                            "required": [
-                                                "meta",
-                                                "data"
-                                            ],
-                                            "properties": {
-                                                "meta": {
-                                                    "$ref": "#/components/schemas/OCSMeta"
-                                                },
-                                                "data": {
-                                                    "type": "object",
-                                                    "additionalProperties": {
-                                                        "type": "object",
-                                                        "required": [
-                                                            "type",
-                                                            "description",
-                                                            "example"
-                                                        ],
-                                                        "properties": {
-                                                            "type": {
-                                                                "type": "string"
-                                                            },
-                                                            "description": {
-                                                                "type": "string"
-                                                            },
-                                                            "example": {
-                                                                "type": "object"
-                                                            },
-                                                            "default": {
-                                                                "type": "object"
-                                                            }
-                                                        }
-                                                    }
-                                                }
-                                            }
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        },
         "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
             "get": {
                 "operationId": "crl_api-list",

From 37490206f02f726e79c1b7df93d067e30636e2f2 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 22:32:25 -0300
Subject: [PATCH 19/27] feat: add accessibility label support to CodeEditor
 component

- Add label prop to display accessible label for screen readers
- Generate unique ID for editor instance
- Bind label to editor via for attribute

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/CodeEditor.vue | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/components/CodeEditor.vue b/src/components/CodeEditor.vue
index 3f3c0b69df..1132b59482 100644
--- a/src/components/CodeEditor.vue
+++ b/src/components/CodeEditor.vue
@@ -4,7 +4,11 @@
 -->
 <template>
 	<div class="code-editor">
+		<label v-if="label" :for="editorId" class="code-editor__label">
+			{{ label }}
+		</label>
 		<codemirror
+			:id="editorId"
 			:value="value"
 			:options="editorOptions"
 			@input="onInput" />
@@ -30,11 +34,20 @@ export default {
 			type: String,
 			default: '',
 		},
+		label: {
+			type: String,
+			default: '',
+		},
 		placeholder: {
 			type: String,
 			default: '',
 		},
 	},
+	data() {
+		return {
+			editorId: `code-editor-${Math.random().toString(36).substr(2, 9)}`,
+		}
+	},
 	computed: {
 		editorOptions() {
 			return {
@@ -65,6 +78,16 @@ export default {
 	border-radius: var(--border-radius);
 	overflow: hidden;
 
+	&__label {
+		display: block;
+		padding: 8px 12px;
+		font-weight: bold;
+		font-size: 14px;
+		background-color: var(--color-background-dark);
+		border-bottom: 1px solid var(--color-border);
+		color: var(--color-main-text);
+	}
+
 	.CodeMirror {
 		height: auto;
 		min-height: 200px;

From fb7c24190a70e4c68d7766762bff4351b5780661 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Thu, 4 Dec 2025 22:32:39 -0300
Subject: [PATCH 20/27] feat: add template variables helper dialog to footer
 editor

- Add dialog with list of available Twig template variables
- Display variable metadata: type, description, example, default value
- Implement click-to-copy functionality with icon feedback
- Use NcFormBoxButton for consistent UI with Nextcloud standards
- Variables loaded via initial state for performance
- Icon changes from copy to check mark for 2 seconds after copying
- Fallback to prompt() if Clipboard API unavailable

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/FooterTemplateEditor.vue | 141 ++++++++++++++++++++++--
 1 file changed, 134 insertions(+), 7 deletions(-)

diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
index 6eb7815bfa..76002fe7a2 100644
--- a/src/components/FooterTemplateEditor.vue
+++ b/src/components/FooterTemplateEditor.vue
@@ -5,7 +5,14 @@
 <template>
 	<div class="footer-template-section">
 		<div class="footer-template-header">
-			<label>{{ t('libresign', 'Footer template') }}</label>
+			<NcButton type="tertiary"
+				:aria-label="t('libresign', 'Show available variables')"
+				@click="showVariablesDialog = true">
+				<template #icon>
+					<HelpCircleOutline :size="20" />
+				</template>
+				{{ t('libresign', 'Available variables') }}
+			</NcButton>
 			<NcButton v-if="!isDefaultFooterTemplate"
 				type="tertiary"
 				@click="resetFooterTemplate">
@@ -14,6 +21,7 @@
 		</div>
 		<CodeEditor
 			v-model="footerTemplate"
+			:label="t('libresign', 'Footer template')"
 			:placeholder="t('libresign', 'A twig template to be used at footer of PDF. Will be rendered by mPDF.')"
 			@input="debouncedSaveFooterTemplate" />
 		<div v-if="pdfPreviewFile" class="footer-preview">
@@ -89,6 +97,41 @@
 					@pdf-editor:ready="onPdfReady" />
 			</div>
 		</div>
+
+		<NcDialog :name="t('libresign', 'Available template variables')"
+			:open.sync="showVariablesDialog"
+			size="normal">
+			<div class="variables-dialog">
+				<p class="variables-dialog__description">
+					{{ t('libresign', 'Click on a variable to copy it to clipboard') }}
+				</p>
+				<div class="variables-list">
+					<NcFormBoxButton v-for="(meta, name) in templateVariables"
+						:key="name"
+						inverted-accent
+						@click="copyToClipboard(getVariableText(name))">
+						<template #default>
+							<span class="hidden-visually">
+								{{ t('libresign', 'Copy to clipboard') }}
+							</span>
+							{{ getVariableText(name) }}
+						</template>
+					<template #icon>
+						<Check v-if="isCopied(name)" :size="20" />
+						<ContentCopy v-else :size="20" />
+					</template>
+						<template #description>
+							<p class="variable-description">{{ meta.description }}</p>
+							<div class="variable-meta">
+								<span class="meta-badge">{{ meta.type }}</span>
+								<code v-if="meta.example" class="meta-example">{{ meta.example }}</code>
+								<span v-if="meta.default" class="meta-default">{{ t('libresign', 'Default:') }} {{ meta.default }}</span>
+							</div>
+						</template>
+					</NcFormBoxButton>
+				</div>
+			</div>
+		</NcDialog>
 	</div>
 </template>
 
@@ -100,6 +143,8 @@ import { loadState } from '@nextcloud/initial-state'
 import { generateOcsUrl } from '@nextcloud/router'
 
 import NcButton from '@nextcloud/vue/components/NcButton'
+import NcDialog from '@nextcloud/vue/components/NcDialog'
+import NcFormBoxButton from '@nextcloud/vue/components/NcFormBoxButton'
 import NcLoadingIcon from '@nextcloud/vue/components/NcLoadingIcon'
 import NcTextField from '@nextcloud/vue/components/NcTextField'
 // eslint-disable-next-line import/default
@@ -107,6 +152,9 @@ import VuePdfEditor from '@libresign/vue-pdf-editor'
 
 import CodeEditor from './CodeEditor.vue'
 
+import Check from 'vue-material-design-icons/Check.vue'
+import ContentCopy from 'vue-material-design-icons/ContentCopy.vue'
+import HelpCircleOutline from 'vue-material-design-icons/HelpCircleOutline.vue'
 import MagnifyMinusOutline from 'vue-material-design-icons/MagnifyMinusOutline.vue'
 import MagnifyPlusOutline from 'vue-material-design-icons/MagnifyPlusOutline.vue'
 import Undo from 'vue-material-design-icons/UndoVariant.vue'
@@ -114,8 +162,13 @@ import Undo from 'vue-material-design-icons/UndoVariant.vue'
 export default {
 	name: 'FooterTemplateEditor',
 	components: {
+		Check,
 		CodeEditor,
+		ContentCopy,
+		HelpCircleOutline,
 		NcButton,
+		NcDialog,
+		NcFormBoxButton,
 		NcLoadingIcon,
 		NcTextField,
 		VuePdfEditor,
@@ -144,6 +197,9 @@ export default {
 			previewWidth: loadState('libresign', 'footer_preview_width', 595),
 			previewHeight: loadState('libresign', 'footer_preview_height', 80),
 			containerHeight: null,
+			showVariablesDialog: false,
+			templateVariables: loadState('libresign', 'footer_template_variables', {}),
+			copiedVariable: null,
 		}
 	},
 	computed: {
@@ -179,6 +235,31 @@ export default {
 		this.saveFooterTemplate()
 	},
 	methods: {
+		getVariableText(name) {
+			return `{{ ${name} }}`
+		},
+		isCopied(name) {
+			return this.copiedVariable === this.getVariableText(name)
+		},
+		copyToClipboard(text) {
+			if (this.copiedVariable === text) {
+				return
+			}
+
+			const value = text
+			try {
+				navigator.clipboard.writeText(value)
+			} catch {
+				// Fallback for a case when clipboard API is not available or permission denied
+				// eslint-disable-next-line no-alert
+				prompt('', value)
+			}
+
+			this.copiedVariable = text
+			setTimeout(() => {
+				this.copiedVariable = null
+			}, 2000)
+		},
 		async resetFooterTemplate() {
 			await axios.post(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
 			this.$emit('template-reset')
@@ -261,15 +342,61 @@ export default {
 
 	.footer-template-header {
 		display: flex;
-		justify-content: space-between;
-		align-items: center;
+		gap: 8px;
+		flex-wrap: wrap;
+		margin-bottom: 4px;
+	}
+}
 
-		label {
-			font-weight: bold;
-			font-size: 14px;
-		}
+.variables-dialog {
+	padding: 16px;
+
+	&__description {
+		margin-bottom: 16px;
+		color: var(--color-text-lighter);
+		font-size: 14px;
 	}
 }
+.variables-list {
+	display: flex;
+	flex-direction: column;
+	gap: 8px;
+	max-height: 60vh;
+	overflow-y: auto;
+}
+
+.variable-description {
+	margin: 0 0 8px 0;
+}
+
+.variable-meta {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 8px;
+	align-items: center;
+	font-size: 12px;
+	margin-top: 8px;
+}
+
+.meta-badge {
+	padding: 2px 6px;
+	background-color: var(--color-background-dark);
+	color: var(--color-text-maxcontrast);
+	border-radius: var(--border-radius);
+	font-weight: 500;
+	text-transform: uppercase;
+	font-size: 10px;
+}
+
+.meta-example {
+	color: var(--color-text-maxcontrast);
+	font-family: monospace;
+}
+
+.meta-default {
+	color: var(--color-text-maxcontrast);
+	font-style: italic;
+}
 
 .footer-preview {
 	padding: 8px;

From 9952fc33da0b835128141b4eabd8097239d5092a Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:31:43 -0300
Subject: [PATCH 21/27] feat: provide footer template data via initial state

- Add footer_template to initial state
- Add footer_template_is_default to initial state
- Update footer_preview_height default from 80 to 100
- Eliminates extra API call on settings page load

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Settings/Admin.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/Settings/Admin.php b/lib/Settings/Admin.php
index 79afc4b990..917d2171e6 100644
--- a/lib/Settings/Admin.php
+++ b/lib/Settings/Admin.php
@@ -62,8 +62,10 @@ public function getForm(): TemplateResponse {
 		$this->initialState->provideInitialState('signature_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'signature_preview_zoom_level', 100));
 		$this->initialState->provideInitialState('footer_preview_zoom_level', $this->appConfig->getValueFloat(Application::APP_ID, 'footer_preview_zoom_level', 100));
 		$this->initialState->provideInitialState('footer_preview_width', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_width', 595));
-		$this->initialState->provideInitialState('footer_preview_height', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_height', 80));
+		$this->initialState->provideInitialState('footer_preview_height', $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_height', 100));
 		$this->initialState->provideInitialState('footer_template_variables', $this->footerService->getTemplateVariablesMetadata());
+		$this->initialState->provideInitialState('footer_template', $this->footerService->getTemplate());
+		$this->initialState->provideInitialState('footer_template_is_default', $this->footerService->isDefaultTemplate());
 		$this->initialState->provideInitialState('signature_render_mode', $this->signatureTextService->getRenderMode());
 		$this->initialState->provideInitialState('signature_text_template', $this->signatureTextService->getTemplate());
 		$this->initialState->provideInitialState('signature_width', $this->signatureTextService->getFullSignatureWidth());

From bd8409b3d0104276ecfbf9816e38728856977469 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:32:22 -0300
Subject: [PATCH 22/27] docs: improve footer template endpoint documentation

- Clarify that empty template parameter resets to default
- Document width and height parameters with defaults
- Add response type annotations

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Controller/AdminController.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/Controller/AdminController.php b/lib/Controller/AdminController.php
index 13d2e10d04..183ee5940f 100644
--- a/lib/Controller/AdminController.php
+++ b/lib/Controller/AdminController.php
@@ -800,6 +800,8 @@ public function getFooterTemplate(): DataResponse {
 		return new DataResponse([
 			'template' => $this->footerService->getTemplate(),
 			'isDefault' => $this->footerService->isDefaultTemplate(),
+			'preview_width' => $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_width', 595),
+			'preview_height' => $this->appConfig->getValueInt(Application::APP_ID, 'footer_preview_height', 100),
 		]);
 	}
 

From 21d804800f5c3b5c802a6c0afc9aa0aad165bf64 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:33:59 -0300
Subject: [PATCH 23/27] feat: add footer template editor with variable helper

- Add FooterTemplateEditor component with Twig template editor
- Implement template variables helper dialog with click-to-copy
- Add preview controls (zoom, width, height) with reset functionality
- Display variable metadata (type, description, example, default)
- Use constants for default dimensions (595x100)
- Integrate with Validation settings via template-reset event
- Load template data from initial state to avoid extra API call

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/FooterTemplateEditor.vue | 74 ++++++++-----------------
 src/views/Settings/Validation.vue       | 28 +++-------
 2 files changed, 31 insertions(+), 71 deletions(-)

diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
index 76002fe7a2..e205c0dfb2 100644
--- a/src/components/FooterTemplateEditor.vue
+++ b/src/components/FooterTemplateEditor.vue
@@ -13,11 +13,6 @@
 				</template>
 				{{ t('libresign', 'Available variables') }}
 			</NcButton>
-			<NcButton v-if="!isDefaultFooterTemplate"
-				type="tertiary"
-				@click="resetFooterTemplate">
-				{{ t('libresign', 'Reset to default') }}
-			</NcButton>
 		</div>
 		<CodeEditor
 			v-model="footerTemplate"
@@ -58,7 +53,7 @@
 						:min="100"
 						:max="2000"
 						:spellcheck="false"
-						@input="debouncedSaveFooterTemplate" />
+						@input="debouncedSaveDimensions" />
 					<NcTextField
 						v-model="previewHeight"
 						:label="t('libresign', 'Height')"
@@ -66,7 +61,7 @@
 						:min="10"
 						:max="500"
 						:spellcheck="false"
-						@input="debouncedSaveFooterTemplate" />
+						@input="debouncedSaveDimensions" />
 					<NcButton v-if="showResetDimensions"
 						:aria-label="t('libresign', 'Reset dimensions')"
 						type="tertiary"
@@ -176,26 +171,19 @@ export default {
 		MagnifyPlusOutline,
 		Undo,
 	},
-	props: {
-		initialTemplate: {
-			type: String,
-			default: '',
-		},
-		initialIsDefault: {
-			type: Boolean,
-			default: true,
-		},
-	},
 	data() {
+		const DEFAULT_PREVIEW_WIDTH = 595
+		const DEFAULT_PREVIEW_HEIGHT = 100
 		return {
-			footerTemplate: this.initialTemplate,
-			isDefaultFooterTemplate: this.initialIsDefault,
+			DEFAULT_PREVIEW_WIDTH,
+			DEFAULT_PREVIEW_HEIGHT,
+			footerTemplate: '',
 			pdfPreviewFile: null,
 			loadingPreview: false,
 			pdfKey: 0,
 			zoomLevel: loadState('libresign', 'footer_preview_zoom_level', 100),
-			previewWidth: loadState('libresign', 'footer_preview_width', 595),
-			previewHeight: loadState('libresign', 'footer_preview_height', 80),
+			previewWidth: DEFAULT_PREVIEW_WIDTH,
+			previewHeight: DEFAULT_PREVIEW_HEIGHT,
 			containerHeight: null,
 			showVariablesDialog: false,
 			templateVariables: loadState('libresign', 'footer_template_variables', {}),
@@ -204,26 +192,7 @@ export default {
 	},
 	computed: {
 		showResetDimensions() {
-			return Number(this.previewWidth) !== 595 || Number(this.previewHeight) !== 80
-		},
-	},
-	watch: {
-		initialTemplate(newValue) {
-			this.footerTemplate = newValue
-			if (newValue) {
-				this.saveFooterTemplate()
-			}
-		},
-		initialIsDefault(newValue) {
-			this.isDefaultFooterTemplate = newValue
-		},
-		previewWidth() {
-			this.debouncedSaveDimensions()
-			this.debouncedSaveFooterTemplate()
-		},
-		previewHeight() {
-			this.debouncedSaveDimensions()
-			this.debouncedSaveFooterTemplate()
+			return Number(this.previewWidth) !== this.DEFAULT_PREVIEW_WIDTH || Number(this.previewHeight) !== this.DEFAULT_PREVIEW_HEIGHT
 		},
 	},
 	created() {
@@ -232,7 +201,12 @@ export default {
 		this.debouncedSaveDimensions = debounce(this.saveDimensions, 500)
 	},
 	mounted() {
-		this.saveFooterTemplate()
+		axios.get(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
+			.then(response => {
+				this.footerTemplate = response.data.ocs.data.template
+				this.previewHeight = response.data.ocs.data.preview_height
+				this.previewWidth = response.data.ocs.data.preview_width
+			})
 	},
 	methods: {
 		getVariableText(name) {
@@ -261,23 +235,25 @@ export default {
 			}, 2000)
 		},
 		async resetFooterTemplate() {
-			await axios.post(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
 			this.$emit('template-reset')
+			this.resetDimensions()
+			axios.post(generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'))
 		},
 		resetDimensions() {
-			this.previewWidth = 595
-			this.previewHeight = 80
-			this.saveDimensions()
-			this.saveFooterTemplate()
+			this.previewWidth = this.DEFAULT_PREVIEW_WIDTH
+			this.previewHeight = this.DEFAULT_PREVIEW_HEIGHT
+			OCP.AppConfig.deleteKey('libresign', 'footer_preview_width')
+			OCP.AppConfig.deleteKey('libresign', 'footer_preview_height')
 		},
 		saveDimensions() {
-			if (Number(this.previewWidth) === 595 && Number(this.previewHeight) === 80) {
+			if (Number(this.previewWidth) === this.DEFAULT_PREVIEW_WIDTH && Number(this.previewHeight) === this.DEFAULT_PREVIEW_HEIGHT) {
 				OCP.AppConfig.deleteKey('libresign', 'footer_preview_width')
 				OCP.AppConfig.deleteKey('libresign', 'footer_preview_height')
 			} else {
 				OCP.AppConfig.setValue('libresign', 'footer_preview_width', this.previewWidth)
 				OCP.AppConfig.setValue('libresign', 'footer_preview_height', this.previewHeight)
 			}
+			this.saveFooterTemplate()
 		},
 		saveFooterTemplate() {
 			axios.post(
@@ -289,9 +265,7 @@ export default {
 				},
 				{ responseType: 'blob' }
 			).then(response => {
-				this.isDefaultFooterTemplate = false
 				this.setPdfPreview(response.data)
-				this.$emit('template-saved', this.footerTemplate)
 			}).catch(error => {
 				console.error('Error saving footer template:', error)
 			})
diff --git a/src/views/Settings/Validation.vue b/src/views/Settings/Validation.vue
index e3c69b88d6..c4255fcbe9 100644
--- a/src/views/Settings/Validation.vue
+++ b/src/views/Settings/Validation.vue
@@ -43,14 +43,14 @@
 			</NcCheckboxRadioSwitch>
 		</p>
 		<FooterTemplateEditor v-if="addFooter && customizeFooter"
-			:initial-template="footerTemplate"
 			:initial-is-default="isDefaultFooterTemplate"
-			@template-saved="onTemplateSaved"
+			ref="footerTemplateEditor"
 			@template-reset="onTemplateReset" />
 	</NcSettingsSection>
 </template>
 <script>
 import axios from '@nextcloud/axios'
+import { loadState } from '@nextcloud/initial-state'
 import { translate as t } from '@nextcloud/l10n'
 import { generateOcsUrl } from '@nextcloud/router'
 
@@ -74,8 +74,7 @@ export default {
 			url: null,
 			addFooter: true,
 			writeQrcodeOnFooter: true,
-			customizeFooter: false,
-			footerTemplate: '',
+			customizeFooter: !loadState('libresign', 'footer_template_is_default', true),
 			isDefaultFooterTemplate: true,
 		}
 	},
@@ -91,7 +90,6 @@ export default {
 			this.getAddFooterData()
 			this.getWriteQrcodeOnFooter()
 			this.getValidationUrlData()
-			this.getFooterTemplate()
 		},
 		async getMakeValidationUrlPrivate() {
 			const response = await axios.get(
@@ -120,20 +118,8 @@ export default {
 			)
 			this.placeHolderValidationUrl(response.data.ocs.data.data)
 		},
-		async getFooterTemplate() {
-			const response = await axios.get(
-				generateOcsUrl('/apps/libresign/api/v1/admin/footer-template'),
-			)
-			this.footerTemplate = response.data.ocs.data.template
-			this.isDefaultFooterTemplate = response.data.ocs.data.isDefault
-			this.customizeFooter = !response.data.ocs.data.isDefault
-		},
-		onTemplateSaved(template) {
-			this.footerTemplate = template
-			this.isDefaultFooterTemplate = false
-		},
 		async onTemplateReset() {
-			await this.getFooterTemplate()
+			this.customizeFooter = false
 		},
 		saveValidationiUrl() {
 			OCP.AppConfig.setValue('libresign', 'validation_site', this.$refs.urlInput.value.trim())
@@ -142,9 +128,9 @@ export default {
 			OCP.AppConfig.setValue('libresign', setting, value ? 1 : 0)
 		},
 		toggleCustomizeFooter(value) {
-			this.customizeFooter = value
-			if (!value) {
-				OCP.AppConfig.deleteKey('libresign', 'footer_template')
+			this.customizeFooter = !!value
+			if (!this.customizeFooter) {
+				this.$refs.footerTemplateEditor.resetFooterTemplate()
 			}
 		},
 		placeHolderValidationUrl(data) {

From fe686c23a4e3c6288a60a4cf273a4ea738d71d26 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:38:53 -0300
Subject: [PATCH 24/27] feat: add preview dimensions to footer template GET
 endpoint

- Return preview_width and preview_height in response
- Update PHPDoc return type annotation
- Regenerate OpenAPI specs

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Controller/AdminController.php          |  2 +-
 openapi-administration.json                 | 12 +++-
 openapi-full.json                           | 12 +++-
 src/types/openapi/openapi-administration.ts | 62 ++-------------------
 src/types/openapi/openapi-full.ts           | 62 ++-------------------
 5 files changed, 31 insertions(+), 119 deletions(-)

diff --git a/lib/Controller/AdminController.php b/lib/Controller/AdminController.php
index 183ee5940f..21f1933427 100644
--- a/lib/Controller/AdminController.php
+++ b/lib/Controller/AdminController.php
@@ -791,7 +791,7 @@ public function deleteTsaConfig(): DataResponse {
 	 *
 	 * Returns the current footer template if set, otherwise returns the default template.
 	 *
-	 * @return DataResponse<Http::STATUS_OK, array{template: string, isDefault: bool}, array{}>
+	 * @return DataResponse<Http::STATUS_OK, array{template: string, isDefault: bool, preview_width: int, preview_height: int}, array{}>
 	 *
 	 * 200: OK
 	 */
diff --git a/openapi-administration.json b/openapi-administration.json
index 37317baaab..12dda961f7 100644
--- a/openapi-administration.json
+++ b/openapi-administration.json
@@ -2664,7 +2664,9 @@
                                                     "type": "object",
                                                     "required": [
                                                         "template",
-                                                        "isDefault"
+                                                        "isDefault",
+                                                        "preview_width",
+                                                        "preview_height"
                                                     ],
                                                     "properties": {
                                                         "template": {
@@ -2672,6 +2674,14 @@
                                                         },
                                                         "isDefault": {
                                                             "type": "boolean"
+                                                        },
+                                                        "preview_width": {
+                                                            "type": "integer",
+                                                            "format": "int64"
+                                                        },
+                                                        "preview_height": {
+                                                            "type": "integer",
+                                                            "format": "int64"
                                                         }
                                                     }
                                                 }
diff --git a/openapi-full.json b/openapi-full.json
index 12d1deaf8b..fed1aeaef5 100644
--- a/openapi-full.json
+++ b/openapi-full.json
@@ -11141,7 +11141,9 @@
                                                     "type": "object",
                                                     "required": [
                                                         "template",
-                                                        "isDefault"
+                                                        "isDefault",
+                                                        "preview_width",
+                                                        "preview_height"
                                                     ],
                                                     "properties": {
                                                         "template": {
@@ -11149,6 +11151,14 @@
                                                         },
                                                         "isDefault": {
                                                             "type": "boolean"
+                                                        },
+                                                        "preview_width": {
+                                                            "type": "integer",
+                                                            "format": "int64"
+                                                        },
+                                                        "preview_height": {
+                                                            "type": "integer",
+                                                            "format": "int64"
                                                         }
                                                     }
                                                 }
diff --git a/src/types/openapi/openapi-administration.ts b/src/types/openapi/openapi-administration.ts
index 764086b185..702e288280 100644
--- a/src/types/openapi/openapi-administration.ts
+++ b/src/types/openapi/openapi-administration.ts
@@ -323,27 +323,6 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
-    "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get footer template variables metadata
-         * @description Returns metadata for all available Twig variables that can be used in footer templates.
-         *     This endpoint requires admin access
-         */
-        get: operations["admin-get-footer-template-variables"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
         parameters: {
             query?: never;
@@ -1448,6 +1427,10 @@ export interface operations {
                             data: {
                                 template: string;
                                 isDefault: boolean;
+                                /** Format: int64 */
+                                preview_width: number;
+                                /** Format: int64 */
+                                preview_height: number;
                             };
                         };
                     };
@@ -1518,43 +1501,6 @@ export interface operations {
             };
         };
     };
-    "admin-get-footer-template-variables": {
-        parameters: {
-            query?: never;
-            header: {
-                /** @description Required to be true for the API request to pass */
-                "OCS-APIRequest": boolean;
-            };
-            path: {
-                apiVersion: "v1";
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        ocs: {
-                            meta: components["schemas"]["OCSMeta"];
-                            data: {
-                                [key: string]: {
-                                    type: string;
-                                    description: string;
-                                    example: Record<string, never>;
-                                    default?: Record<string, never>;
-                                };
-                            };
-                        };
-                    };
-                };
-            };
-        };
-    };
     "crl_api-list": {
         parameters: {
             query?: {
diff --git a/src/types/openapi/openapi-full.ts b/src/types/openapi/openapi-full.ts
index 6e0bc5e1d0..7dac34568d 100644
--- a/src/types/openapi/openapi-full.ts
+++ b/src/types/openapi/openapi-full.ts
@@ -1334,27 +1334,6 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
-    "/ocs/v2.php/apps/libresign/api/{apiVersion}/admin/footer-template/variables": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get footer template variables metadata
-         * @description Returns metadata for all available Twig variables that can be used in footer templates.
-         *     This endpoint requires admin access
-         */
-        get: operations["admin-get-footer-template-variables"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/ocs/v2.php/apps/libresign/api/{apiVersion}/crl/list": {
         parameters: {
             query?: never;
@@ -5844,6 +5823,10 @@ export interface operations {
                             data: {
                                 template: string;
                                 isDefault: boolean;
+                                /** Format: int64 */
+                                preview_width: number;
+                                /** Format: int64 */
+                                preview_height: number;
                             };
                         };
                     };
@@ -5914,43 +5897,6 @@ export interface operations {
             };
         };
     };
-    "admin-get-footer-template-variables": {
-        parameters: {
-            query?: never;
-            header: {
-                /** @description Required to be true for the API request to pass */
-                "OCS-APIRequest": boolean;
-            };
-            path: {
-                apiVersion: "v1";
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        ocs: {
-                            meta: components["schemas"]["OCSMeta"];
-                            data: {
-                                [key: string]: {
-                                    type: string;
-                                    description: string;
-                                    example: Record<string, never>;
-                                    default?: Record<string, never>;
-                                };
-                            };
-                        };
-                    };
-                };
-            };
-        };
-    };
     "crl_api-list": {
         parameters: {
             query?: {

From 606b4477fcad42255632f14d7abf62964326675f Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:42:01 -0300
Subject: [PATCH 25/27] fix: stylelint

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/CodeEditor.vue           | 4 ++--
 src/components/FooterTemplateEditor.vue | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/components/CodeEditor.vue b/src/components/CodeEditor.vue
index 1132b59482..72586adbb2 100644
--- a/src/components/CodeEditor.vue
+++ b/src/components/CodeEditor.vue
@@ -99,7 +99,7 @@ export default {
 	}
 
 	.CodeMirror-cursor {
-		border-left-color: var(--color-main-text);
+		border-inline-start-color: var(--color-main-text);
 	}
 
 	.CodeMirror-selected {
@@ -108,7 +108,7 @@ export default {
 
 	.CodeMirror-gutters {
 		background-color: var(--color-background-dark);
-		border-right: 1px solid var(--color-border);
+		border-inline-end: 1px solid var(--color-border);
 	}
 
 	.CodeMirror-linenumber {
diff --git a/src/components/FooterTemplateEditor.vue b/src/components/FooterTemplateEditor.vue
index e205c0dfb2..ed864a8a00 100644
--- a/src/components/FooterTemplateEditor.vue
+++ b/src/components/FooterTemplateEditor.vue
@@ -331,6 +331,7 @@ export default {
 		font-size: 14px;
 	}
 }
+
 .variables-list {
 	display: flex;
 	flex-direction: column;
@@ -432,8 +433,7 @@ export default {
 	&__loading {
 		position: absolute;
 		top: 0;
-		left: 0;
-		right: 0;
+		inset-inline: 0;
 		bottom: 0;
 		display: flex;
 		align-items: center;

From 99e8c5908dd16c2c1f915dab22030551f1a3484e Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 01:47:02 -0300
Subject: [PATCH 26/27] test: add FooterService mock to AdminTest

- Add FooterService to test dependencies

- Fix constructor argument count mismatch

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

[skip ci]
---
 tests/php/Unit/Settings/AdminTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/php/Unit/Settings/AdminTest.php b/tests/php/Unit/Settings/AdminTest.php
index 4f4b89aaa7..16da49a6fa 100644
--- a/tests/php/Unit/Settings/AdminTest.php
+++ b/tests/php/Unit/Settings/AdminTest.php
@@ -11,6 +11,7 @@
 use OCA\Libresign\AppInfo\Application;
 use OCA\Libresign\Handler\CertificateEngine\CertificateEngineFactory;
 use OCA\Libresign\Service\CertificatePolicyService;
+use OCA\Libresign\Service\FooterService;
 use OCA\Libresign\Service\IdentifyMethodService;
 use OCA\Libresign\Service\SignatureBackgroundService;
 use OCA\Libresign\Service\SignatureTextService;
@@ -31,6 +32,7 @@ final class AdminTest extends \OCA\Libresign\Tests\Unit\TestCase {
 	private IAppConfig&MockObject $appConfig;
 	private SignatureTextService&MockObject $signatureTextService;
 	private SignatureBackgroundService&MockObject $signatureBackgroundService;
+	private FooterService&MockObject $footerService;
 	public function setUp(): void {
 		$this->initialState = $this->createMock(IInitialState::class);
 		$this->identifyMethodService = $this->createMock(IdentifyMethodService::class);
@@ -39,6 +41,7 @@ public function setUp(): void {
 		$this->appConfig = $this->createMock(IAppConfig::class);
 		$this->signatureTextService = $this->createMock(SignatureTextService::class);
 		$this->signatureBackgroundService = $this->createMock(SignatureBackgroundService::class);
+		$this->footerService = $this->createMock(FooterService::class);
 		$this->admin = new Admin(
 			$this->initialState,
 			$this->identifyMethodService,
@@ -47,6 +50,7 @@ public function setUp(): void {
 			$this->appConfig,
 			$this->signatureTextService,
 			$this->signatureBackgroundService,
+			$this->footerService,
 		);
 	}
 

From 7da750be6df2152f31bc49cafeed880f831fb3c4 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Fri, 5 Dec 2025 10:58:46 -0300
Subject: [PATCH 27/27] fix: add pendign code after backport of #6006

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 lib/Handler/FooterHandler.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/Handler/FooterHandler.php b/lib/Handler/FooterHandler.php
index ff475fb2ec..946311692d 100644
--- a/lib/Handler/FooterHandler.php
+++ b/lib/Handler/FooterHandler.php
@@ -201,6 +201,10 @@ private function getQrCodeImageBase64(string $text): string {
 		return $qrcode;
 	}
 
+	public function getTemplateVariablesMetadata(): array {
+		return $this->templateVars->getVariablesMetadata();
+	}
+
 	private function setQrCodeSize(): void {
 		$blockValues = $this->getQrCodeBlocks();
 		$this->qrCode->setSize(self::MIN_QRCODE_SIZE);