[IMP] website, *: introduce JsonLd builder and structured data

*=website_blog

Body:
This commit introduces a reusable JsonLd builder for Schema.org
payloads and integrates structured data generation in website and
website_blog.

- add a JsonLd helper with snake_case to camelCase normalization,
  nested schema support, datetime normalization, and safe rendering for
  single or multiple schemas
- add website structured data foundations (organization schema default
  and breadcrumb helper) through a dedicated mixin
- expose website-level structured data generation and inject
  structured_data in template rendering context
- render JSON-LD payload in website layout head
- add images_from_html utility to collect post images from blog content
- generate blog schemas for listing and detail pages (Blog,
  CollectionPage, BlogPosting, BreadcrumbList)
- pass structured_data from blog controllers for both list and detail
  routes
- add dedicated tests validating JsonLd behavior and serialization rules

This change enables consistent, extensible structured-data generation
across website and blog pages.

task-4655276

[IMP] website_blog: WIP

Author: gppa-odoo

addons/website/helpers/jsonld_builder.py

@@ -113,9 +113,7 @@ def to_iso_datetime(dt) -> str | None:
         return as_datetime.isoformat()
 
     def get(self, key: str, default=None):
-        """Retrieve a stored value by its snake_case key.
-        The key is normalised exactly like :meth:`set` / :meth:`add_nested`
-        so callers never have to know the internal camelCase representation.
+        """Retrieve a stored value by key.
         Args:
             key: Property name
             default: Value returned when the key is absent.
@@ -144,7 +142,7 @@ def set(self, values: dict[str, Any]) -> JsonLd:
             self.values[key] = value
         return self
 
-    def add_nested(self, values: dict[str, JsonLd | list[JsonLd | None] | None]) -> JsonLd:
+    def add_nested(self, values: dict[str, JsonLd | list[JsonLd] | None]) -> JsonLd:
         """Add nested schema builder(s).
         A single nested value is stored as-is; values are converted to a list
         only when multiple nested values exist for the same key. None values

addons/website/models/mixins.py

@@ -877,7 +877,7 @@ class WebsiteStructuredDataMixin(models.AbstractModel):
     _name = 'website.structured_data.mixin'
     _description = 'Website Structured Data Mixin'
 
-    def get_jsonLD(self, is_detail_page=False):
+    def get_json_ld(self, is_detail_page=False):
         """Return the JSON-LD structured data for this record.
         :param is_detail_page: whether the structured data is for a detail page
         :return: string containing the JSON-LD structured data

addons/website/models/website.py

@@ -2493,7 +2493,7 @@ def _is_tag_domains_watchlisted(self, tagName, atts):
     def _is_tag_classes_watchlisted(self, tagName, atts):
         return self._get_blocked_iframe_containers_classes().intersection((atts.get('class') or '').split(' '))
 
-    def get_jsonLD(self):
+    def get_json_ld(self):
         """Generate structured data for the website."""
         self.ensure_one()
         return JsonLd.render_structured_data([self.organization_structured_data()])
@@ -2504,7 +2504,9 @@ def organization_structured_data(self):
         base_url = self.get_base_url()
         logo_url = f"{base_url}/logo.png?company={self.company_id.id}"
         return JsonLd("Organization",
-            {"name": self.name,
-            "url": base_url,
-            "@id": f"{base_url}/#organization"},
+            {
+                "name": self.name,
+                "url": base_url,
+                "@id": f"{base_url}/#organization",
+            },
         ).add_nested({"logo": JsonLd("ImageObject", {"url": logo_url})})

addons/website/tests/__init__.py

@@ -19,6 +19,7 @@
 from . import test_iap
 from . import test_import_files
 from . import test_ir_asset
+from . import test_jsonld_builder
 from . import test_lang_url
 from . import test_menu
 from . import test_multi_website
@@ -32,7 +33,6 @@
 from . import test_sitemap
 from . import test_skip_website_configurator
 from . import test_snippets
-from . import test_structure_data_defination
 from . import test_theme
 from . import test_ui
 from . import test_unsplash_beacon

…/tests/test_structure_data_defination.py …ons/website/tests/test_jsonld_builder.pyaddons/website/tests/test_structure_data_defination.py renamed to addons/website/tests/test_jsonld_builder.py addons/website/tests/test_structure_data_defination.py renamed to addons/website/tests/test_jsonld_builder.py

@@ -94,27 +94,24 @@ def text_from_html(html_fragment, collapse_whitespace=False):
     return content
 
 
-def images_from_html(html_fragment, website_url):
+def images_from_html(html_fragment, base_url):
     """
     Extract unique image URLs from an HTML fragment.
-    Preserves order.
+
     :param html_fragment: document from which image URLs must be extracted
-    :param website_url: base URL of the website to resolve relative URLs
+    :param base_url: base URL of the website to resolve relative URLs
     :return: list of image URLs extracted from the html
     """
     if not html_fragment:
         return []
 
     tree = html.fromstring(html_fragment)
-    image_paths = []
     seen = set()
 
     for img in tree.xpath("//img[@src]"):
-        src = urljoin(website_url, img.get("src"))
-        if src not in seen:
-            seen.add(src)
-            image_paths.append(src)
-    return image_paths
+        src = urljoin(base_url, img.get("src"))
+        seen.add(src)
+    return list(seen)
 
 
 def get_base_domain(url, strip_www=False):

addons/website/tools.py

@@ -177,7 +177,7 @@
         <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin=""/>
         <link rel="apple-touch-icon" t-att-href="x_icon"/>
         <!-- Render structured data from context or fallback to website-level schema -->
-        <script type="application/ld+json" t-out="structured_data or website.get_jsonLD()"/>
+        <script type="application/ld+json" t-out="structured_data or website.get_json_ld()"/>
     </xpath>
 
     <xpath expr="//head/script" position="before">

addons/website/views/website_templates.xml

@@ -227,7 +227,7 @@ def blog(self, blog=None, tag=None, page=1, search=None, **opt):
         posts = values['posts']
         if blog:
             posts = posts.with_context(blog_id=blog.id)
-        values['structured_data'] = posts.get_jsonLD()
+        values['structured_data'] = posts.get_json_ld()
 
         return request.render("website_blog.blog_post_short", values)
 
@@ -339,7 +339,7 @@ def blog_post(self, blog, blog_post, tag_id=None, page=1, enable_editor=None, **
             'is_next_post_recommended': is_next_post_recommended,
             'date': date_begin,
             'blog_url': blog_url,
-            'structured_data': blog_post.get_jsonLD(is_detail_page=True),
+            'structured_data': blog_post.get_json_ld(is_detail_page=True),
         }
         response = request.render("website_blog.blog_post_complete", values)