From 9fa8fa5390f8fdbb1339621b50ff1a41dc0caa02 Mon Sep 17 00:00:00 2001
From: DIVYA PAHUJA <divyapahuja@DIVYAs-MacBook-Pro.local>
Date: Sat, 7 Feb 2026 23:33:27 +0530
Subject: [PATCH 1/2] feat: Enhance SEO/SMO with dynamic Open Graph tags

Added dynamic og:url and og:image generation for better social media previews.
---
 .../groovy/org/grails/gradle/BlogTask.groovy     |  1 +
 .../org/grails/gradle/RenderSiteTask.groovy      | 16 +++++++++++++++-
 templates/document.html                          |  6 ++----
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/buildSrc/src/main/groovy/org/grails/gradle/BlogTask.groovy b/buildSrc/src/main/groovy/org/grails/gradle/BlogTask.groovy
index 2e4ca6f0912..eb8e159b36c 100644
--- a/buildSrc/src/main/groovy/org/grails/gradle/BlogTask.groovy
+++ b/buildSrc/src/main/groovy/org/grails/gradle/BlogTask.groovy
@@ -240,6 +240,7 @@ class BlogTask extends DefaultTask {
         }
         String html = writer.toString()
         Map<String, String> metadata = htmlPost.metadata.toMap()
+        metadata['ogurl'] = postLink(htmlPost)
         html = RenderSiteTask.renderHtmlWithTemplateContent(html, metadata, templateText)
         html = RenderSiteTask.highlightMenu(html, metadata, htmlPost.path)
         metadata['body'] = metadata['body'] ? metadata['body'] : ''
diff --git a/buildSrc/src/main/groovy/org/grails/gradle/RenderSiteTask.groovy b/buildSrc/src/main/groovy/org/grails/gradle/RenderSiteTask.groovy
index 1f311b32b2d..81a75f28dff 100644
--- a/buildSrc/src/main/groovy/org/grails/gradle/RenderSiteTask.groovy
+++ b/buildSrc/src/main/groovy/org/grails/gradle/RenderSiteTask.groovy
@@ -108,7 +108,9 @@ class RenderSiteTask extends DefaultTask {
 
     static void renderPages(Map<String, String> sitemeta, List<Page> listOfPages, File outputDir, final String templateText) {
         for (Page page : listOfPages) {
-            Map<String, String> resolvedMetadata = processMetadata(sitemeta + page.metadata)
+            String permalink = sitemeta['url'] + page.path
+            Map<String, String> pageMeta = sitemeta + page.metadata + [ogurl: permalink]
+            Map<String, String> resolvedMetadata = processMetadata(pageMeta)
             String html = renderHtmlWithTemplateContent(page.content, resolvedMetadata, templateText)
             html = highlightMenu(html, sitemeta, page.path)
             if (page.body) {
@@ -166,6 +168,18 @@ class RenderSiteTask extends DefaultTask {
         if (!resolvedMetadata.containsKey("robots")) {
             resolvedMetadata.put('robots', "all")
         }
+        
+        if (!resolvedMetadata.containsKey('ogimage')) {
+            if (resolvedMetadata.containsKey('image')) {
+                resolvedMetadata.put('ogimage', resolvedMetadata['url'] + '/images/' + resolvedMetadata['image'])
+            } else if (resolvedMetadata.containsKey('video') && parseVideoId(resolvedMetadata)) {
+                String videoId = parseVideoId(resolvedMetadata)
+                resolvedMetadata.put('ogimage', "https://img.youtube.com/vi/${videoId}/maxresdefault.jpg".toString())
+            } else {
+                resolvedMetadata.put('ogimage', resolvedMetadata['url'] + '/images/grails.png')
+            }
+        }
+        
         resolvedMetadata.put('twittercard', twitterCard('summary_large_image'))
         if (resolvedMetadata.containsKey('video')) {
             String videoId = parseVideoId(resolvedMetadata)
diff --git a/templates/document.html b/templates/document.html
index 190bceeb5df..21b688b2f97 100644
--- a/templates/document.html
+++ b/templates/document.html
@@ -13,10 +13,8 @@
     <meta name='twitter:site' content='@grailsframework'/>
     <meta name='twitter:description' content='[%description]'/>
     <meta name='twitter:creator' content='@grailsframework'/>
-    <meta property='og:image' content='[%url]/images/grails.png'/>
-    <meta property='og:image:width' content='300'/>
-    <meta property='og:image:height' content='300'/>
-    <meta property='og:url' content='[%url]'/>
+    <meta property='og:image' content='[%ogimage]'/>
+    <meta property='og:url' content='[%ogurl]'/>
     <meta property='og:title' content='[%title]'/>
     <meta property='og:description' content='[%description]'/>
     <meta property='og:type' content='website'/>

From 98dfc3985663226ffe5d1bfebb682e9f35cc8f13 Mon Sep 17 00:00:00 2001
From: DIVYA PAHUJA <divyapahuja@DIVYAs-MacBook-Pro.local>
Date: Sat, 7 Feb 2026 23:39:39 +0530
Subject: [PATCH 2/2] chore: Add lazy loading to images for better performance

---
 templates/document.html | 243 ++++++++++++++++++++--------------------
 1 file changed, 120 insertions(+), 123 deletions(-)

diff --git a/templates/document.html b/templates/document.html
index 21b688b2f97..b7925474391 100644
--- a/templates/document.html
+++ b/templates/document.html
@@ -1,29 +1,30 @@
 <!DOCTYPE html>
 <html>
+
 <head>
     <title>[%title]</title>
-    <meta name="keywords" content="[%keywords]"/>
-    <meta name="description" content="[%description]"/>
-    <meta name="date" content="[%date]"/>
-    <meta name="robots" content="[%robots]"/>
-    <link rel="alternate" type="application/rss+xml" title="RSS" href="[%url]/rss.xml"/>
-    <meta charset='UTF-8'/>
-    <link rel='icon' href='[%url]/images/favicon.ico'/>
+    <meta name="keywords" content="[%keywords]" />
+    <meta name="description" content="[%description]" />
+    <meta name="date" content="[%date]" />
+    <meta name="robots" content="[%robots]" />
+    <link rel="alternate" type="application/rss+xml" title="RSS" href="[%url]/rss.xml" />
+    <meta charset='UTF-8' />
+    <link rel='icon' href='[%url]/images/favicon.ico' />
     [%twittercard]
-    <meta name='twitter:site' content='@grailsframework'/>
-    <meta name='twitter:description' content='[%description]'/>
-    <meta name='twitter:creator' content='@grailsframework'/>
-    <meta property='og:image' content='[%ogimage]'/>
-    <meta property='og:url' content='[%ogurl]'/>
-    <meta property='og:title' content='[%title]'/>
-    <meta property='og:description' content='[%description]'/>
-    <meta property='og:type' content='website'/>
+    <meta name='twitter:site' content='@grailsframework' />
+    <meta name='twitter:description' content='[%description]' />
+    <meta name='twitter:creator' content='@grailsframework' />
+    <meta property='og:image' content='[%ogimage]' />
+    <meta property='og:url' content='[%ogurl]' />
+    <meta property='og:title' content='[%title]' />
+    <meta property='og:description' content='[%description]' />
+    <meta property='og:type' content='website' />
 
-    <meta name='viewport' content='width=device-width, initial-scale=1'/>
-    <link rel='mask-icon' href='[%url]/images/grails-pinned-icon.svg' color='feb672'/>
-    <link rel='stylesheet' href='[%url]/stylesheets/screen.css'/>
-    <link rel='stylesheet' href='[%url]/stylesheets/plugin.css'/>
-    <link rel='stylesheet' href='[%url]/stylesheets/paginate.css'/>
+    <meta name='viewport' content='width=device-width, initial-scale=1' />
+    <link rel='mask-icon' href='[%url]/images/grails-pinned-icon.svg' color='feb672' />
+    <link rel='stylesheet' href='[%url]/stylesheets/screen.css' />
+    <link rel='stylesheet' href='[%url]/stylesheets/plugin.css' />
+    <link rel='stylesheet' href='[%url]/stylesheets/paginate.css' />
     <script src='[%url]/javascripts/navigation.js'></script>
     <script src='[%url]/javascripts/paginate.js'></script>
     [%HTML header]
@@ -33,121 +34,116 @@
 
     <!-- Matomo -->
     <script>
-      var _paq = window._paq = window._paq || [];
-      /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
-      _paq.push(["setDoNotTrack", true]);
-      _paq.push(["disableCookies"]);
-      _paq.push(['trackPageView']);
-      _paq.push(['enableLinkTracking']);
-      (function() {
-        var u="https://analytics.apache.org/";
-        _paq.push(['setTrackerUrl', u+'matomo.php']);
-        _paq.push(['setSiteId', '79']);
-        var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
-        g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
-      })();
+        var _paq = window._paq = window._paq || [];
+        /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
+        _paq.push(["setDoNotTrack", true]);
+        _paq.push(["disableCookies"]);
+        _paq.push(['trackPageView']);
+        _paq.push(['enableLinkTracking']);
+        (function () {
+            var u = "https://analytics.apache.org/";
+            _paq.push(['setTrackerUrl', u + 'matomo.php']);
+            _paq.push(['setSiteId', '79']);
+            var d = document, g = d.createElement('script'), s = d.getElementsByTagName('script')[0];
+            g.async = true; g.src = u + 'matomo.js'; s.parentNode.insertBefore(g, s);
+        })();
     </script>
     <!-- End Matomo Code -->
 
-    <script
-        async
-        src="https://widget.kapa.ai/kapa-widget.bundle.js"
-        data-website-id="d804a9f2-51a2-414c-97f7-12f2a1ba4609"
-        data-project-name="Apache Grails"
+    <script async src="https://widget.kapa.ai/kapa-widget.bundle.js"
+        data-website-id="d804a9f2-51a2-414c-97f7-12f2a1ba4609" data-project-name="Apache Grails"
         data-project-color="#3F4346"
         data-font-family="system-ui,-apple-system,BlinkMacSystemFont,Roboto,Helvetica,Arial,Segoe UI,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol;"
-        data-project-logo="https://grails.apache.org/images/grails.png"
-        data-modal-override-open-id="ask-ai-input"
-        data-modal-override-open-class="search-input"
-        data-user-analytics-fingerprint-enabled="true"
-        data-modal-title="Apache Grails AI Assistant"
-        data-modal-example-questions-title="Try asking me..."
+        data-project-logo="https://grails.apache.org/images/grails.png" data-modal-override-open-id="ask-ai-input"
+        data-modal-override-open-class="search-input" data-user-analytics-fingerprint-enabled="true"
+        data-modal-title="Apache Grails AI Assistant" data-modal-example-questions-title="Try asking me..."
         data-modal-disclaimer="This is a custom LLM for Apache Grails using [documentation](https://docs.grails.org/latest/), [groovy documentation](https://docs.groovy-lang.org/docs/groovy-4.0.28/html/documentation/) [github issues](https://github.com/apache/grails-core/issues) and more.
 
 Companies deploy assistants like this [](https://kapa.ai) on docs via [website widget](https://docs.kapa.ai/integrations/website-widget) (Docker, Reddit), in [support forms](https://docs.kapa.ai/integrations/support-form-deflector) for ticket deflection (Monday.com, Mapbox), or as [an internal assistant](https://docs.kapa.ai/integrations/internal-assistant) with access to private sources."
         data-modal-example-questions="How does database migration work?,How does Spring Security work?"
-        data-button-text-color="#FBB576"
-        data-modal-header-bg-color="#FFFFFF"
-        data-modal-title-color="#FBB576"
+        data-button-text-color="#FBB576" data-modal-header-bg-color="#FFFFFF" data-modal-title-color="#FBB576"
         data-consent-required="true"
         data-consent-screen-disclaimer="By clicking &quot;I agree, let&#39;s chat&quot;, you consent to the use of the AI assistant in accordance with kapa.ai&#39;s [Privacy Policy](https://www.kapa.ai/content/privacy-policy). This service uses reCAPTCHA, which requires your consent to Google&#39;s [Privacy Policy](https://policies.google.com/privacy) and [Terms of Service](https://policies.google.com/terms). By proceeding, you explicitly agree to both kapa.ai&#39;s and Google&#39;s privacy policies.">
     ></script>
 </head>
+
 <body>
-<header class='mainheader'>
-    <div class='content'>
-        <a href='[%url]/index.html'><img class='grailslogo' src='[%url]/images/grails_logo.svg' alt='Grails Logo'/></a>
-        <a href='javascript:show(&apos;topmenus&apos;, &apos;showNavigationLink&apos;)' id='showNavigationLink'
-           class='mobile align-center'>Show Navigation</a>
-        <div id='topmenus'>
-            <nav class='secondarymenu' id='secondarymenu'>
-                <ul>
-                    <li><a href='[%url]/casestudies/index.html'>Case Studies</a></li>
-                    <li><a href='[%url]/blog/index.html'>Blog</a></li>
-                    <li><a href='[%url]/learning.html'>Learning</a></li>
-                    <li><a href='[%url]/community.html'>Community</a></li>
-                    <li><a href='[%url]/search.html'>Search</a></li>
-                </ul>
-            </nav>
-            <nav class='mainmenu' id='mainmenu'>
+    <header class='mainheader'>
+        <div class='content'>
+            <a href='[%url]/index.html'><img class='grailslogo' src='[%url]/images/grails_logo.svg' alt='Grails Logo'
+                    loading="lazy" /></a>
+            <a href='javascript:show(&apos;topmenus&apos;, &apos;showNavigationLink&apos;)' id='showNavigationLink'
+                class='mobile align-center'>Show Navigation</a>
+            <div id='topmenus'>
+                <nav class='secondarymenu' id='secondarymenu'>
+                    <ul>
+                        <li><a href='[%url]/casestudies/index.html'>Case Studies</a></li>
+                        <li><a href='[%url]/blog/index.html'>Blog</a></li>
+                        <li><a href='[%url]/learning.html'>Learning</a></li>
+                        <li><a href='[%url]/community.html'>Community</a></li>
+                        <li><a href='[%url]/search.html'>Search</a></li>
+                    </ul>
+                </nav>
+                <nav class='mainmenu' id='mainmenu'>
+                    <ul>
+                        <li><a href='[%url]/documentation.html'>Documentation</a></li>
+                        <li><a href='[%url]/download.html'>Download</a></li>
+                        <li><a href='[%url]/plugins.html'>Plugins</a></li>
+                        <li><a href='https://guides.grails.org/index.html'>Guides</a></li>
+                        <li><a href='[%url]/faq.html'>FAQ</a></li>
+                        <li><a href='[%url]/support.html'>Support</a></li>
+                        <li><a href='https://start.grails.org'>Forge App</a></li>
+                    </ul>
+                </nav>
+            </div>
+        </div>
+    </header>
+    <article data-document>&nbsp;</article>
+    <footer>
+        <div class='content'>
+            <div class='apache-grails'>
+                <p>Apache Grails is supported by the Apache Software Foundation and the Grails community.</p>
+                <a href='https://apache.org'><img class='' src='https://www.apache.org/img/asf_logo.png' width='300px'
+                        alt='Apache Software Foundation' /></a>
+                <p>The Apache Software Foundation</p>
+                <p>Apache, Apache Grails, Grails, Groovy, and the ASF logo are either registered trademarks or
+                    trademarks
+                    of The Apache Software Foundation.
+                </p>
+
+            </div>
+            <nav class='socialmedianav'>
                 <ul>
-                    <li><a href='[%url]/documentation.html'>Documentation</a></li>
-                    <li><a href='[%url]/download.html'>Download</a></li>
-                    <li><a href='[%url]/plugins.html'>Plugins</a></li>
-                    <li><a href='https://guides.grails.org/index.html'>Guides</a></li>
-                    <li><a href='[%url]/faq.html'>FAQ</a></li>
-                    <li><a href='[%url]/support.html'>Support</a></li>
-                    <li><a href='https://start.grails.org'>Forge App</a></li>
+                    <li>
+                        <a href='mailto:dev@grails.apache.org'><img class='' src='[%url]/images/email.svg'
+                                alt='Email Icon' loading="lazy" /></a>
+                    </li>
+                    <li>
+                        <a href='https://slack.grails.org'><img class='' src='[%url]/images/slack.svg' alt='Slack Icon'
+                                loading="lazy" /></a>
+                    </li>
+                    <li>
+                        <a href='https://www.youtube.com/@GrailsFramework'><img class='' src='[%url]/images/youtube.svg'
+                                alt='Youtube Icon' loading="lazy" /></a>
+                    </li>
+                    <li>
+                        <a href='https://www.linkedin.com/showcase/official-grails/'><img class=''
+                                src='[%url]/images/linkedin.svg' alt='LinkedIn Icon' loading="lazy" /></a>
+                    </li>
+                    <li>
+                        <a href='https://github.com/apache/grails-core'><img class='' src='[%url]/images/github.svg'
+                                alt='Github Icon' loading="lazy" /></a>
+                    </li>
+                    <li style="margin-bottom:10px;">
+                        <a href='https://twitter.com/grailsframework'><img class='' src='[%url]/images/x-twitter.svg'
+                                alt='Twitter Icon' loading="lazy" /></a>
+                    </li>
                 </ul>
             </nav>
         </div>
-    </div>
-</header>
-<article data-document>&nbsp;</article>
-<footer>
-    <div class='content'>
-        <div class='apache-grails'>            
-            <p>Apache Grails is supported by the Apache Software Foundation and the Grails community.</p>
-            <a href='https://apache.org'><img class='' src='https://www.apache.org/img/asf_logo.png' width='300px'
-                                              alt='Apache Software Foundation'/></a>
-            <p>The Apache Software Foundation</p>
-            <p>Apache, Apache Grails, Grails, Groovy, and the ASF logo are either registered trademarks or trademarks
-                of The Apache Software Foundation.
-            </p>
-
-        </div>
-        <nav class='socialmedianav'>
-            <ul>
-                <li>
-                    <a href='mailto:dev@grails.apache.org'><img class='' src='[%url]/images/email.svg' alt='Email Icon'/></a>
-                </li>
-                <li>
-                    <a href='https://slack.grails.org'><img class='' src='[%url]/images/slack.svg'
-                                                            alt='Slack Icon'/></a>
-                </li>
-                <li>
-                    <a href='https://www.youtube.com/@GrailsFramework'><img class='' src='[%url]/images/youtube.svg'
-                                                                             alt='Youtube Icon'/></a>
-                </li>
-                <li>
-                    <a href='https://www.linkedin.com/showcase/official-grails/'><img class=''
-                                                                                      src='[%url]/images/linkedin.svg'
-                                                                                      alt='LinkedIn Icon'/></a>
-                </li>
-                <li>
-                    <a href='https://github.com/apache/grails-core'><img class='' src='[%url]/images/github.svg'
-                                                              alt='Github Icon'/></a>
-                </li>
-                <li style="margin-bottom:10px;">
-                    <a href='https://twitter.com/grailsframework'><img class='' src='[%url]/images/x-twitter.svg'
-                                                                       alt='Twitter Icon'/></a>
-                </li>
-            </ul>
-        </nav>
-    </div>
-    <div class="content">
-        <nav class='footer' style="margin-bottom: 10px">
-                <p>© 2005-2026 the Apache Grails project — Grails is Open Source: 
+        <div class="content">
+            <nav class='footer' style="margin-bottom: 10px">
+                <p>© 2005-2026 the Apache Grails project — Grails is Open Source:
                     <a href='https://www.apache.org/licenses/'>License</a>,
                     <a href='https://privacy.apache.org/policies/privacy-policy-public.html'>Privacy Policy</a>,
                     <a href='https://www.apache.org/foundation/sponsorship'>Sponsor Apache</a>,
@@ -156,11 +152,12 @@
                     <a href='https://www.apache.org/foundation/thanks.html'>Thanks</a>,
                     <a href='[%url]/support-schedule.html'>Support Schedule</a>
                 </p>
-        </nav>
-    </div>
-</footer>
-<div>
+            </nav>
+        </div>
+    </footer>
+    <div>
 
-</div>
+    </div>
 </body>
-</html>
+
+</html>
\ No newline at end of file