From b99e7db21f78e831da44aae54ee8f18d7f270f6b Mon Sep 17 00:00:00 2001
From: Lennard Golsch <lennard.golsch@icloud.com>
Date: Thu, 19 Feb 2026 15:49:02 +0100
Subject: [PATCH 1/2] Fix README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 40f901c..66a927c 100644
--- a/README.md
+++ b/README.md
@@ -55,8 +55,8 @@ For historical reasons, the link to the RSS feed is always displayed, but it can
 All in all, configure as follows:
 
 ```text
-# Add 'series-banner' and 'series-layout'.
-MIR.Layout.End=mir-edit,series-banner,series-layout,mir-citation,mir-thumbnail,mir-epusta,mir-access-rights,mir-export,mir-admindata,mir-historydata
+# Add 'series-layout'.
+MIR.Layout.End=mir-edit,series-layout,mir-citation,mir-thumbnail,mir-epusta,mir-access-rights,mir-export,mir-admindata,mir-historydata
 
 # Optional: disable RSS feed.
 MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled=false

From db342372667378866317b1c0acf8566cb8a9736b Mon Sep 17 00:00:00 2001
From: Lennard Golsch <36492865+golsch@users.noreply.github.com>
Date: Wed, 13 May 2026 17:38:32 +0200
Subject: [PATCH 2/2] Improve MyCoreWebPage support (#20)

* Decouple series panel rendering

* Add MyCoReWebPage support

* Add extended MyCoreWebPage support

* Fix README.md
---
 README.md                                     |  58 +++++++++
 .../xsl/navigation-flatmir-layout.xsl         |  22 ++--
 .../resources/xsl/render-series-panel.xsl     | 116 ++++++++++++++++++
 .../resources/xsl/series-panel-adapter.xsl    |  18 +++
 .../resources/xsl/series-panel-enricher.xsl   |  26 ++++
 src/main/resources/xsl/series-panel.xsl       | 116 ++----------------
 6 files changed, 236 insertions(+), 120 deletions(-)
 create mode 100644 src/main/resources/xsl/render-series-panel.xsl
 create mode 100644 src/main/resources/xsl/series-panel-adapter.xsl
 create mode 100644 src/main/resources/xsl/series-panel-enricher.xsl

diff --git a/README.md b/README.md
index 66a927c..4880edb 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,8 @@ Build the JAR file with `mvn clean install` and copy it to `~/.mycore/(dev-)mir/
 
 ### Configure `mycore.properties`
 
+#### Enable navigation on object pages in frontend
+
 To use the plugin, configuration in `~/.mycore/(dev-)mir/mycore.properties` is required.
 The RSS feed requires a `mycoreobject-rss` stylesheet, which is not included by default.
 For historical reasons, the link to the RSS feed is always displayed, but it can be disabled if needed.
@@ -62,6 +64,62 @@ MIR.Layout.End=mir-edit,series-layout,mir-citation,mir-thumbnail,mir-epusta,mir-
 MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled=false
 ```
 
+#### MyCoReWebPage support
+
+The panel can optionally be rendered within a
+[MyCoReWebPage](https://www.mycore.de/documentation/frontend/frontend_static_content/).
+To enable this, the stylesheet `series-panel-adapter.xsl` is provided.
+The panel can be embedded using a `<series-panel />` element in your MyCoReWebPage.
+When embedding, pay attention to the layout to ensure the panel is formatted correctly.
+
+> ⚠️ Note: The parameters `MCRObjectID` and `MCRDerivateID` must be present in the transformer session to resolve the
+> navigation.
+
+To activate it, add the stylesheet as follows:
+
+```text
+# Add 'series-panel-adapter.xsl' to enable series panel rendering in MyCoReWebPage.
+MCR.URIResolver.xslIncludes.MyCoReWebPage=%MCR.URIResolver.xslIncludes.MyCoReWebPage%,series-panel-adapter.xsl
+```
+
+Example MyCoReWebPage with panel and layout:
+
+```xml
+<MyCoReWebPage>
+  <section xml:lang="en" title="Title">
+    <div class="row detail_row">
+      <div class="col-xs-12 col-sm-8">
+        <p>Hello world</p>
+      </div>
+      <div class="col-xs-12 col-sm-4">
+        <series-panel />
+      </div>
+    </div>
+  </section>
+</MyCoReWebPage>
+```
+
+#### Extended MyCoReWebPage support
+
+MyCoReWebPage support can be extended with `series-panel-enricher.xsl`. By setting `render-series-panel="true"` in a 
+MyCoReWebPage, a series panel with layout is automatically generated, using the section’s content.
+To activate it, add the stylesheet alongside `series-panel-adapter.xsl` as follows:
+
+```text
+# Add 'series-panel-enricher.xsl' to enable extended series panel rendering in MyCoReWebPage.
+MCR.URIResolver.xslIncludes.MyCoReWebPage=%MCR.URIResolver.xslIncludes.MyCoReWebPage%,series-panel-enricher.xsl,series-panel-adapter.xsl
+```
+
+Example MyCoReWebPage with automatic panel and layout using `render-series-panel`:
+
+```xml
+<MyCoReWebPage render-series-panel="true">
+  <section xml:lang="en" title="Title">
+    <p>Hello world</p>
+  </section>
+</MyCoReWebPage>
+```
+
 ### Reload and rebuild Solr
 
 The plugin leverages enhanced Solr handling for parent documents.
diff --git a/src/main/resources/xsl/navigation-flatmir-layout.xsl b/src/main/resources/xsl/navigation-flatmir-layout.xsl
index 759e8e3..1f1e639 100644
--- a/src/main/resources/xsl/navigation-flatmir-layout.xsl
+++ b/src/main/resources/xsl/navigation-flatmir-layout.xsl
@@ -1,12 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- ============================================== -->
-<!-- $Revision$ $Date$ -->
-<!-- ============================================== -->
-<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-  xmlns:i18n="xalan://org.mycore.services.i18n.MCRTranslation" xmlns:xalan="http://xml.apache.org/xalan"
-  exclude-result-prefixes="xalan i18n">
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
 
-  <xsl:include href="series-panel.xsl" />
+  <xsl:include href="resource:xsl/render-series-panel.xsl" />
   <xsl:include href="copynodes.xsl" />
 
   <xsl:param name="WebApplicationBaseURL" />
@@ -15,24 +10,21 @@
 
   <xsl:template match="/MyCoReWebPage">
     <xsl:copy>
-
       <section xml:lang="all">
-
         <div class="row detail_row">
           <div class="col-xs-12 col-sm-8" id="main_col">
             <xsl:copy-of select="@*" />
             <xsl:apply-templates select="*|text()" />
           </div>
           <div class="col-xs-12 col-sm-4" id="aux_col">
-            <xsl:apply-templates select="document(concat('notnull:mcrfile:',$MCRDerivateID,'/navigation.xml'))/item"
-              mode="seriesLayout">
-              <xsl:with-param name="rootID" select="$MCRObjectID" />
-            </xsl:apply-templates>
+            <xsl:call-template name="resolve-navigation-and-render-series-panel">
+              <xsl:with-param name="root-object-id" select="$MCRObjectID" />
+              <xsl:with-param name="derivate-id" select="$MCRDerivateID" />
+            </xsl:call-template>
           </div>
         </div>
       </section>
-
     </xsl:copy>
   </xsl:template>
 
-</xsl:stylesheet>
\ No newline at end of file
+</xsl:stylesheet>
diff --git a/src/main/resources/xsl/render-series-panel.xsl b/src/main/resources/xsl/render-series-panel.xsl
new file mode 100644
index 0000000..f45b08b
--- /dev/null
+++ b/src/main/resources/xsl/render-series-panel.xsl
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+  <xsl:param name="CurrentLang" />
+  <xsl:param name="ServletsBaseURL" />
+  <xsl:param name="WebApplicationBaseURL" />
+
+  <xsl:param name="MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled" />
+
+  <xsl:template name="resolve-navigation-and-render-series-panel">
+    <xsl:param name="root-object-id" />
+    <xsl:param name="derivate-id" />
+    <xsl:variable name="navigation-uri" select="concat('notnull:mcrfile:', $derivate-id, '/navigation.xml')" />
+    <xsl:variable name="nav-item" select="document($navigation-uri)/item" />
+    <xsl:if test="$nav-item">
+      <xsl:call-template name="render-series-panel">
+        <xsl:with-param name="nav" select="$nav-item" />
+        <xsl:with-param name="root-object-id" select="$root-object-id" />
+      </xsl:call-template>
+    </xsl:if>
+  </xsl:template>
+
+  <xsl:template name="render-series-panel">
+    <xsl:param name="nav" />
+    <xsl:param name="root-object-id" />
+
+    <div id="series-layout">
+      <xsl:if test="normalize-space($nav/@banner) != ''">
+        <a class="banner-link" href="{$WebApplicationBaseURL}receive/{$root-object-id}">
+          <img
+            src="{$WebApplicationBaseURL}{$nav/@banner}"
+            class="card-img-top"
+            alt="Logo { $nav/label[lang($CurrentLang)] }" />
+        </a>
+      </xsl:if>
+      <div class="card series-card">
+        <div class="card-header">
+          <h3 class="card-title">
+            <xsl:value-of select="$nav/label[lang($CurrentLang)]" />
+          </h3>
+        </div>
+        <div class="card-body">
+          <ul>
+            <xsl:for-each select="$nav/item">
+              <xsl:call-template name="render-nav-item">
+                <xsl:with-param name="itemNode" select="." />
+              </xsl:call-template>
+            </xsl:for-each>
+            <xsl:if test="$MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled='true'">
+              <xsl:call-template name="render-rss-item">
+                <xsl:with-param name="object-id" select="$root-object-id" />
+              </xsl:call-template>
+            </xsl:if>
+          </ul>
+        </div>
+        <div class="card-footer">
+          <xsl:call-template name="render-search-form">
+            <xsl:with-param name="root-object-id" select="$root-object-id" />
+          </xsl:call-template>
+        </div>
+      </div>
+    </div>
+  </xsl:template>
+
+  <xsl:template name="render-nav-item">
+    <xsl:param name="itemNode" />
+    <li>
+      <xsl:choose>
+        <xsl:when test="starts-with($itemNode/@ref, 'http')">
+          <a href="{$itemNode/@ref}">
+            <xsl:value-of select="$itemNode/label[lang($CurrentLang)]" />
+          </a>
+        </xsl:when>
+        <xsl:otherwise>
+          <a href="{concat($WebApplicationBaseURL, $itemNode/@ref)}">
+            <xsl:value-of select="$itemNode/label[lang($CurrentLang)]" />
+          </a>
+        </xsl:otherwise>
+      </xsl:choose>
+    </li>
+  </xsl:template>
+
+  <xsl:template name="render-search-form">
+    <xsl:param name="root-object-id" />
+    <form role="search" action="{$ServletsBaseURL}solr/select" method="post" class="rssfeed-search form-inline">
+      <input type="hidden" name="q" value="root:{$root-object-id}" />
+      <div class="input-group" style="width:100%;">
+        <label class="sr-only input-group-prepend" for="qSeries">
+          <xsl:text>Suche in </xsl:text>
+          <xsl:value-of select="label[lang($CurrentLang)]" />
+        </label>
+        <input
+          id="qSeries"
+          type="text"
+          name="fq"
+          class="form-control"
+          placeholder="Suche in {label[lang($CurrentLang)]}" />
+        <div class="input-group-append">
+          <button class="btn btn-primary" type="submit">
+            <i class="fas fa-search" />
+          </button>
+        </div>
+      </div>
+    </form>
+  </xsl:template>
+
+  <xsl:template name="render-rss-item">
+    <xsl:param name="object-id" />
+    <li>
+      <a href="{$WebApplicationBaseURL}receive/{$object-id}?XSL.Style=rss">
+        <i class="fas fa-rss" />
+        <xsl:text>RSS 2.0 Feed</xsl:text>
+      </a>
+    </li>
+  </xsl:template>
+</xsl:stylesheet>
diff --git a/src/main/resources/xsl/series-panel-adapter.xsl b/src/main/resources/xsl/series-panel-adapter.xsl
new file mode 100644
index 0000000..85c3836
--- /dev/null
+++ b/src/main/resources/xsl/series-panel-adapter.xsl
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+  <xsl:include href="resource:xsl/render-series-panel.xsl" />
+
+  <xsl:param name="MCRDerivateID" />
+  <xsl:param name="MCRObjectID" />
+
+  <xsl:template match="series-panel">
+    <xsl:if test="$MCRObjectID and $MCRDerivateID">
+      <xsl:call-template name="resolve-navigation-and-render-series-panel">
+        <xsl:with-param name="root-object-id" select="$MCRObjectID" />
+        <xsl:with-param name="derivate-id" select="$MCRDerivateID" />
+      </xsl:call-template>
+    </xsl:if>
+  </xsl:template>
+
+</xsl:stylesheet>
diff --git a/src/main/resources/xsl/series-panel-enricher.xsl b/src/main/resources/xsl/series-panel-enricher.xsl
new file mode 100644
index 0000000..38143a9
--- /dev/null
+++ b/src/main/resources/xsl/series-panel-enricher.xsl
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:exslt="http://exslt.org/common"
+  extension-element-prefixes="exslt">
+
+  <xsl:template match="/MyCoReWebPage[@render-series-panel='true']/section" priority="10">
+    <xsl:variable name="enriched-section">
+      <div class="row detail_row">
+        <div class="col-xs-12 col-sm-8" id="main_col">
+          <xsl:apply-templates select="node()[not(self::head)]"/>
+        </div>
+        <div class="col-xs-12 col-sm-4" id="aux_col">
+          <series-panel />
+        </div>
+      </div>
+    </xsl:variable>
+
+    <section>
+      <xsl:copy-of select="@*"/>
+      <xsl:apply-templates select="head/node()"/>
+      <xsl:apply-templates select="exslt:node-set($enriched-section)/node()"/>
+    </section>
+  </xsl:template>
+
+</xsl:stylesheet>
diff --git a/src/main/resources/xsl/series-panel.xsl b/src/main/resources/xsl/series-panel.xsl
index 42aa5c3..6fe1c08 100644
--- a/src/main/resources/xsl/series-panel.xsl
+++ b/src/main/resources/xsl/series-panel.xsl
@@ -1,119 +1,25 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <xsl:stylesheet version="1.0"
   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-  xmlns:mcr="xalan://org.mycore.common.xml.MCRXMLFunctions"
-  xmlns:i18n="xalan://org.mycore.services.i18n.MCRTranslation"
-  xmlns:mods="http://www.loc.gov/mods/v3"
   xmlns:xlink="http://www.w3.org/1999/xlink"
-  exclude-result-prefixes="i18n mcr mods xlink"
->
-  
-  <xsl:param name="WebApplicationBaseURL" />
-  <xsl:param name="CurrentLang" />
-  <xsl:param name="ServletsBaseURL" />
-  <xsl:param name="MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled" />
-  
+  exclude-result-prefixes="xlink">
+
+  <xsl:include href="resource:xsl/render-series-panel.xsl" />
+
   <xsl:template match="mycoreobject" mode="seriesLayout">
-    <xsl:apply-templates select="structure/derobjects/derobject[classification[@classid='derivate_types'][@categid='navigation']]/@xlink:href" mode="seriesLayout">
+    <xsl:apply-templates
+      select="structure/derobjects/derobject[classification[@classid='derivate_types'][@categid='navigation']]/@xlink:href"
+      mode="seriesLayout">
       <xsl:with-param name="rootID" select="@ID" />
     </xsl:apply-templates>
   </xsl:template>
 
   <xsl:template match="derobject/@xlink:href" mode="seriesLayout">
     <xsl:param name="rootID" />
-    <xsl:apply-templates select="document(concat('notnull:mcrfile:',.,'/navigation.xml'))/item" mode="seriesLayout">
-      <xsl:with-param name="rootID" select="$rootID" />
-    </xsl:apply-templates>
-  </xsl:template>
-  
-  <xsl:template match="/item" mode="seriesLayout">
-    <xsl:param name="rootID" />
-
-    <div id="series-layout">
-
-      <xsl:if test="normalize-space(@banner) != ''">
-        <a class="banner-link" href="{$WebApplicationBaseURL}receive/{$rootID}">
-          <img class="card-img-top" src="{$WebApplicationBaseURL}{@banner}" alt="Logo {../label[lang($CurrentLang)]}" />
-        </a>
-      </xsl:if>
-
-      <div class="card series-card">
-        <div class="card-header">
-          <h3 class="card-title">
-            <xsl:value-of select="label[lang($CurrentLang)]" />
-          </h3>
-        </div>
-        
-        <div class="card-body">
-          <ul>
-            <xsl:apply-templates select="item" mode="seriesLayout" />
-            <xsl:if test="$MIR.Metadata.Navigation.SeriesPanel.RSS.Enabled='true'">
-              <xsl:call-template name="rssLink">
-                <xsl:with-param name="rootID" select="$rootID" />
-              </xsl:call-template>
-            </xsl:if>
-          </ul>
-        </div>
-
-        <div class="card-footer">
-          <xsl:call-template name="searchForm">
-            <xsl:with-param name="rootID" select="$rootID" />
-          </xsl:call-template>
-        </div>
-
-      </div>
-    </div>
-  </xsl:template>
-    
-  <xsl:template match="item/item" mode="seriesLayout">
-    <xsl:choose>
-      <xsl:when test="not(starts-with(@ref, 'http'))">
-        <li>
-          <a href="{$WebApplicationBaseURL}{@ref}">
-            <xsl:value-of select="label[lang($CurrentLang)]" />
-          </a>
-        </li>
-      </xsl:when>
-      <xsl:otherwise>
-        <li>
-          <a href="{@ref}">
-            <xsl:value-of select="label[lang($CurrentLang)]" />
-          </a>
-        </li>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template name="searchForm">
-    <xsl:param name="rootID" />
-
-    <form role="search" action="{$ServletsBaseURL}solr/select" method="post" class="rssfeed-search form-inline">
-      <input type="hidden" name="q" value="root:{$rootID}" />
-      <div class="input-group" style="width:100%;">
-        <label class="sr-only input-group-prepend" for="qSeries">
-          <xsl:text>Suche in </xsl:text>
-          <xsl:value-of select="label[lang($CurrentLang)]" />
-        </label>
-        <input id="qSeries" type="text" name="fq" class="form-control" placeholder="Suche in {label[lang($CurrentLang)]}"/>
-        <div class="input-group-append">
-          <button class="btn btn-primary" type="submit">
-            <i class="fas fa-search" />
-          </button>
-        </div>
-      </div>
-    </form>
+    <xsl:call-template name="resolve-navigation-and-render-series-panel">
+      <xsl:with-param name="root-object-id" select="$rootID" />
+      <xsl:with-param name="derivate-id" select="." />
+    </xsl:call-template>
   </xsl:template>
-  
-  <xsl:template name="rssLink">
-    <xsl:param name="rootID" />
 
-    <li>
-      <a href="{$WebApplicationBaseURL}receive/{$rootID}?XSL.Style=rss">
-        <i class="fas fa-rss" />
-        <xsl:text> RSS 2.0 Feed</xsl:text>
-      </a>
-    </li>
-  </xsl:template>
-  
 </xsl:stylesheet>