From c782c45b1e777ae92b296d031e441da6e386c3b1 Mon Sep 17 00:00:00 2001
From: Cyperghost <olaf_schmitz_1@t-online.de>
Date: Tue, 12 Nov 2024 15:08:03 +0100
Subject: [PATCH] Add migration guide from 6.1

---
 docs/javascript/components_image_viewer.md |  2 ++
 docs/migration/wsc61/templates.md          | 23 ++++++++++++++++++++++
 mkdocs.yml                                 |  1 +
 3 files changed, 26 insertions(+)
 create mode 100644 docs/migration/wsc61/templates.md

diff --git a/docs/javascript/components_image_viewer.md b/docs/javascript/components_image_viewer.md
index 4f30e722..385a9068 100644
--- a/docs/javascript/components_image_viewer.md
+++ b/docs/javascript/components_image_viewer.md
@@ -64,6 +64,8 @@ final class FooBBCode extends AbstractBBCode
             ], true);
         } elseif ($parser->getOutputType() == 'text/simplified-html') {
             return StringUtil::getAnchorTag($foo->getLink(), $foo->getTitle());
+        } else {
+            return StringUtil::encodeHTML($foo->getLink());
         }
     }
 }
diff --git a/docs/migration/wsc61/templates.md b/docs/migration/wsc61/templates.md
new file mode 100644
index 00000000..9d678aa0
--- /dev/null
+++ b/docs/migration/wsc61/templates.md
@@ -0,0 +1,23 @@
+# Migrating from WoltLab Suite 6.1 - Templates
+
+## Image Viewer
+
+The previous image viewer `WCF.ImageViewer` has been open by the HTML class `.jsImageViewer`.
+From now on this is done via the attribute `data-fancybox`, which opens the new [Image Viewer](../../javascript/components_image_viewer.md).
+Which also now supports grouping, `data-fancybox="foo"`.
+
+#### Previous Code Example
+
+```smarty
+<a href="{$link}" class="jsImageViewer" title="{$title}">
+    <img src="{$link}">
+</a>
+```
+
+#### New Code Example
+
+```smarty
+<a href="{$link}" data-caption="{$title}" data-fancybox>
+    <img src="{$link}">
+</a>
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index e992b066..06369974 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -128,6 +128,7 @@ nav:
   - 'Migration':
       - 'From WoltLab Suite 6.1':
           - 'Deprecations and Removals': 'migration/wsc61/deprecations_removals.md'
+          - 'Templates': 'migration/wsc61/templates.md'
       - 'From WoltLab Suite 6.0':
           - 'PHP API': 'migration/wsc60/php.md'
           - 'Templates': 'migration/wsc60/templates.md'
-- 
2.20.1