page_structured_data 1.0.9 → 1.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53bab1f6112cc7060c86d1eedc6096770ea5a6363a9d4e9939094f3576a417cf
-  data.tar.gz: ecea9e6efd8b44bf45565ec1a790905b55e7794579a91d2b157dec1325ad89c5
+  metadata.gz: 9ffd04020a9a4ba900bb7d4bbdac9dd827d48535073a30c657865469df9e1988
+  data.tar.gz: 4b560fee8a434599acd2ae619fdc7e4a0973f29aa77f8b95191a270047767931
 SHA512:
-  metadata.gz: fda27db244422de502060211a86f759ca0fe7249a8a370fb7d3f7a89ed2f732181eff65d7c8b19ab48a61cc9be4168dae18c14edb1016d2ba7d97941b343c50b
-  data.tar.gz: 78dcbcefc064a3806f41c8f8d83f1943181e05c260501a207cff31ff425f5ad68e2fcf6d436351e4a58ded9c2c4ee12b4768d0f1f27c822951bde8682b4f381d
+  metadata.gz: '08329eddfdf9f7e3682a6016ca84d25b1867e4ce8ebca4c4e7654536b4dff59b8d825351b4489b69342c42d2cc52ab41d96bba1f3cc8adf5a1f8180330d660ba'
+  data.tar.gz: 270c98e7c0071b9e09e75482a5d766ec685f8a7da103c3ddb15f4df03e895b98fcc52d57e50b93cbfddd992de7d0fbdf6d5de9542b07fec52d0eab977da2903f

data/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to this project are documented here.
 
 ## Unreleased
 
+## 1.0.11 - 2026-05-06
+
+- Add optional `description` and `founder` support to organization page types.
+
+## 1.0.10 - 2026-05-06
+
+- Add JSON-LD escaping coverage for organization page types.
+- Add `PageStructuredData::PageTypes::WebSite` for schema.org WebSite JSON-LD.
+- Add `page_types:` support for rendering multiple page type JSON-LD scripts.
+- Add `canonical_url` and `fallback_image` options to `Page`.
+
 ## 1.0.9 - 2026-05-06
 
 - Add release preparation script and release checklist documentation.

data/README.md

@@ -14,7 +14,7 @@ It helps Rails applications render:
 - Google-compatible JSON-LD structured data
 - Breadcrumb structured data
 - Article structured data for `BlogPosting` and `NewsArticle`
-- Organization structured data
+- Organization and WebSite structured data
 
 ## Requirements
 
@@ -93,7 +93,9 @@ Set `@page_meta` in the controller or view before the layout renders:
   title: "Home",
   extra_title: "Official Page",
   description: "Welcome to my page",
-  image: image_url("social/home.png")
+  image: image_url("social/home.png"),
+  canonical_url: home_url,
+  fallback_image: image_url("social/default.png")
 )
 ```
 
@@ -133,13 +135,14 @@ This renders `BreadcrumbList` JSON-LD similar to Google's breadcrumb structured
 
 Current compatibility note: when no breadcrumb object is passed, `PageStructuredData::Page` renders current-page-only breadcrumb JSON-LD by default. To opt out, set `config.render_default_breadcrumb_json_ld = false`.
 
-## Article Page Types
+## Structured Page Types
 
 PageStructuredData includes page types for:
 
 - [`BlogPosting`](https://schema.org/BlogPosting)
 - [`NewsArticle`](https://schema.org/NewsArticle)
 - [`Organization`](https://schema.org/Organization)
+- [`WebSite`](https://schema.org/WebSite)
 
 Use a page type when the current page represents an article:
 
@@ -176,8 +179,14 @@ Use `Organization` when the current page represents an organization:
 organization_page_type = PageStructuredData::PageTypes::Organization.new(
   name: "RocketApex",
   url: "https://rocketapex.com",
+  description: "Open source projects from RocketApex",
   logo: "https://rocketapex.com/logo.png",
   same_as: ["https://github.com/RocketApex"],
+  founder: {
+    "@type": "Person",
+    name: "Jane Doe",
+    url: "https://example.com/jane"
+  },
   parent_organization: {
     name: "Parent Org",
     url: "https://parent.example"
@@ -191,6 +200,30 @@ organization_page_type = PageStructuredData::PageTypes::Organization.new(
 )
 ```
 
+Use `WebSite` with `Organization` when the current page represents a site or homepage:
+
+```ruby
+organization_page_type = PageStructuredData::PageTypes::Organization.new(
+  name: "RocketApex",
+  url: "https://rocketapex.com",
+  logo: "https://rocketapex.com/logo.png"
+)
+
+website_page_type = PageStructuredData::PageTypes::WebSite.new(
+  name: "RocketApex",
+  url: "https://rocketapex.com",
+  description: "Open source projects from RocketApex",
+  publisher: organization_page_type
+)
+
+@page_meta = PageStructuredData::Page.new(
+  title: "RocketApex",
+  description: "Open source projects from RocketApex",
+  canonical_url: "https://rocketapex.com",
+  page_types: [organization_page_type, website_page_type]
+)
+```
+
 ## API Reference
 
 ### `PageStructuredData::Page`
@@ -202,7 +235,10 @@ PageStructuredData::Page.new(
   image: nil,
   extra_title: "",
   breadcrumb: nil,
-  page_type: nil
+  page_type: nil,
+  page_types: nil,
+  canonical_url: nil,
+  fallback_image: nil
 )
 ```
 
@@ -210,6 +246,7 @@ Important methods:
 
 - `page_title`: returns the composed page title.
 - `json_lds`: returns the JSON-LD script tags for breadcrumbs and page type data.
+- `resolved_image`: returns `image` or `fallback_image`.
 
 ### `PageStructuredData::Breadcrumbs`
 
@@ -262,19 +299,41 @@ Important methods:
 PageStructuredData::PageTypes::Organization.new(
   name:,
   url:,
+  description: nil,
   logo: nil,
   same_as: [],
-  parent_organization: nil
+  parent_organization: nil,
+  founder: nil
 )
 ```
 
 `parent_organization` should be a hash with `:name` and `:url` keys.
+`founder` should be a hash or another object that responds to `to_h`.
 
 Important methods:
 
 - `to_h`: returns a structured hash for organization JSON-LD.
 - `json_ld`: returns an organization JSON-LD script tag.
 
+### WebSite Page Type
+
+```ruby
+PageStructuredData::PageTypes::WebSite.new(
+  name:,
+  url:,
+  description: nil,
+  publisher: nil,
+  potential_action: nil
+)
+```
+
+`publisher` can be a hash or another page type that responds to `to_h`, such as `PageStructuredData::PageTypes::Organization`.
+
+Important methods:
+
+- `to_h`: returns a structured hash for WebSite JSON-LD.
+- `json_ld`: returns a WebSite JSON-LD script tag.
+
 ## Development
 
 Run the test suite:

data/app/src/page_structured_data/page.rb

@@ -3,16 +3,21 @@
 module PageStructuredData
   # Basic page metadata for any page
   class Page
-    attr_reader :title, :description, :image, :extra_title, :breadcrumb, :page_type
+    attr_reader :title, :description, :image, :extra_title, :breadcrumb, :page_type, :page_types, :canonical_url,
+                :fallback_image
 
     def initialize(title:, description: nil, image: nil, # rubocop:disable Metrics/ParameterLists
-                   extra_title: '', breadcrumb: nil, page_type: nil)
+                   extra_title: '', breadcrumb: nil, page_type: nil, page_types: nil, canonical_url: nil,
+                   fallback_image: nil)
       @title = title
       @description = description
       @image = image
       @extra_title = extra_title
       @breadcrumb = breadcrumb
       @page_type = page_type
+      @page_types = page_types
+      @canonical_url = canonical_url
+      @fallback_image = fallback_image
     end
 
     def title_with_hierarchies
@@ -32,12 +37,20 @@ module PageStructuredData
     def json_lds
       output = []
       output << breadcrumb_json_ld if (breadcrumb_json_ld = self.breadcrumb_json_ld).present?
-      output << page_type.json_ld if page_type.present?
+      resolved_page_types.each { |resolved_page_type| output << resolved_page_type.json_ld }
       output.join
     end
 
+    def resolved_image
+      image || fallback_image
+    end
+
     private
 
+    def resolved_page_types
+      Array.wrap(page_types.presence || page_type).compact
+    end
+
     def breadcrumb_json_ld
       return breadcrumb.json_ld(current_page_title: title) if breadcrumb.present?
       return unless PageStructuredData.render_default_breadcrumb_json_ld

data/app/src/page_structured_data/page_types/organization.rb

@@ -4,14 +4,16 @@ module PageStructuredData
   module PageTypes
     # Organization structured data for a page
     class Organization
-      attr_reader :name, :url, :logo, :same_as, :parent_organization
+      attr_reader :name, :url, :description, :logo, :same_as, :parent_organization, :founder
 
-      def initialize(name:, url:, logo: nil, same_as: [], parent_organization: nil)
+      def initialize(name:, url:, description: nil, logo: nil, same_as: [], parent_organization: nil, founder: nil)
         @name = name
         @url = url
+        @description = description
         @logo = logo
         @same_as = same_as
         @parent_organization = parent_organization
+        @founder = founder
       end
 
       def to_h # rubocop:disable Metrics/MethodLength
@@ -22,8 +24,10 @@ module PageStructuredData
 
         node[:name] = name
         node[:url] = url
+        node[:description] = description if description.present?
         node[:logo] = logo if logo.present?
         node[:sameAs] = same_as if same_as.present?
+        node[:founder] = founder_to_h if founder.present?
 
         if parent_organization.present?
           node[:parentOrganization] = {
@@ -43,6 +47,14 @@ module PageStructuredData
           </script>
         )
       end
+
+      private
+
+      def founder_to_h
+        return founder.to_h if founder.respond_to?(:to_h)
+
+        founder
+      end
     end
   end
 end

data/app/src/page_structured_data/page_types/web_site.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module PageStructuredData
+  module PageTypes
+    # WebSite structured data for a page
+    class WebSite
+      attr_reader :name, :url, :description, :publisher, :potential_action
+
+      def initialize(name:, url:, description: nil, publisher: nil, potential_action: nil)
+        @name = name
+        @url = url
+        @description = description
+        @publisher = publisher
+        @potential_action = potential_action
+      end
+
+      def to_h
+        node = {
+          '@context': 'https://schema.org',
+          '@type': 'WebSite',
+          name: name,
+          url: url,
+        }
+
+        node[:description] = description if description.present?
+        node[:publisher] = publisher_to_h if publisher.present?
+        node[:potentialAction] = potential_action if potential_action.present?
+
+        node
+      end
+
+      def json_ld
+        %(
+        <script type="application/ld+json">
+          #{to_h.to_json}
+          </script>
+        )
+      end
+
+      private
+
+      def publisher_to_h
+        return publisher.to_h if publisher.respond_to?(:to_h)
+
+        publisher
+      end
+    end
+  end
+end

data/app/views/page_structured_data/_meta_tags.html.erb

@@ -2,9 +2,13 @@
 
 <% title = page&.page_title %>
 <% description = page&.description %>
-<% image = page&.image || default_image_url || nil %>
+<% image = page&.resolved_image || default_image_url || nil %>
+<% canonical_url = page&.canonical_url %>
 
 <title><%= title %></title>
+<% if canonical_url.present? %>
+<link rel="canonical" href="<%= canonical_url %>">
+<% end %>
 
 <meta name="title" content="<%= title %>">
 <meta name="description" content="<%= description %>">

data/lib/page_structured_data/version.rb

@@ -1,3 +1,3 @@
 module PageStructuredData
-  VERSION = "1.0.9"
+  VERSION = "1.0.11"
 end

data/lib/page_structured_data.rb

@@ -6,6 +6,7 @@ require_relative "../app/src/page_structured_data/page_types/article"
 require_relative "../app/src/page_structured_data/page_types/blog_posting"
 require_relative "../app/src/page_structured_data/page_types/news_article"
 require_relative "../app/src/page_structured_data/page_types/organization"
+require_relative "../app/src/page_structured_data/page_types/web_site"
 require_relative "../app/src/page_structured_data/page"
 
 module PageStructuredData

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_structured_data
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.0.11
 platform: ruby
 authors:
 - Jey Geethan
@@ -50,6 +50,7 @@ files:
 - app/src/page_structured_data/page_types/blog_posting.rb
 - app/src/page_structured_data/page_types/news_article.rb
 - app/src/page_structured_data/page_types/organization.rb
+- app/src/page_structured_data/page_types/web_site.rb
 - app/views/page_structured_data/_meta_tags.html.erb
 - config/routes.rb
 - lib/page_structured_data.rb