page_structured_data 1.0.12 → 1.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 885b125f1d2fed94a1e0bba7d2c70877f0dba9c5f4ebde59c52f970f2fc4fce4
-  data.tar.gz: 513764c63a8dae5e609d2e92ea1e99dee3fe0555a3727afa24c3d2afdcc64ffd
+  metadata.gz: 8e263a2b3ad541c2b5e72aa79e71d47d72803ddb8a4ac286898e6c6f35105394
+  data.tar.gz: 96f01f8fc820456eb69ba5a351f8971022758088d0a5633240c38c7831df43f9
 SHA512:
-  metadata.gz: 1e4530a70cf06b4d81cab2322759500bdb29acb31ef8c33846f40d9095cb981c2272feb0fe6c57b6b5c363915e59ab7300071d618799459d2e34317bfc1434e8
-  data.tar.gz: 6a900ab594f816e1b2edd833a350a15c0837503af68f3efa0a475ac723e05b21bdc66cbad39384c680a2dfab4dfd173137dd9a05f245f236df450e757f162f98
+  metadata.gz: 802b70166a18b5475e702822cfb7b0c565c7fc59d8dd5059831261676831e1150c95b8f0e1e11b0de493aa120f3e23f2ddd9a619238ebcdd5f25c8f3920d3d6e
+  data.tar.gz: bc818be71ea5d603ac3fb6b84e99dcf79fd76607f3272039cde49d65c772f365d812c0f7d260cdf7beda88762012994ae207b309e7a5dc21b94ab129608e0c9e

data/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here.
 
 ## Unreleased
 
+## 1.0.13 - 2026-05-06
+
+- Add `PageStructuredData::PageTypes::Person` for reusable schema.org person values.
+- Accept richer article author values and omit blank nested schema fields.
+- Add page-level `base_app_name` and `render_breadcrumb_json_ld` options.
+- Omit blank description and image meta tags.
+
 ## 1.0.12 - 2026-05-06
 
 - Add reusable interaction statistics for article-like page types.

data/README.md

@@ -16,6 +16,7 @@ It helps Rails applications render:
 - Article structured data for `BlogPosting` and `NewsArticle`
 - Discussion forum post structured data
 - Interaction statistics for public engagement counts
+- Reusable Person structured data
 - Organization and WebSite structured data
 
 ## Requirements
@@ -144,6 +145,7 @@ PageStructuredData includes page types for:
 - [`BlogPosting`](https://schema.org/BlogPosting)
 - [`NewsArticle`](https://schema.org/NewsArticle)
 - [`DiscussionForumPosting`](https://schema.org/DiscussionForumPosting)
+- [`Person`](https://schema.org/Person)
 - [`Organization`](https://schema.org/Organization)
 - [`WebSite`](https://schema.org/WebSite)
 
@@ -277,10 +279,15 @@ PageStructuredData::Page.new(
   page_type: nil,
   page_types: nil,
   canonical_url: nil,
-  fallback_image: nil
+  fallback_image: nil,
+  base_app_name: nil,
+  render_breadcrumb_json_ld: nil
 )
 ```
 
+`base_app_name` overrides `PageStructuredData.base_app_name` for one page. Pass an empty string to suppress the global app name for a specific page.
+`render_breadcrumb_json_ld` can be set to `true` or `false` for one page. Leave it as `nil` to use the global `PageStructuredData.render_default_breadcrumb_json_ld` behavior for generated default breadcrumbs. Explicit breadcrumb objects still render when the global default is disabled unless the page sets `render_breadcrumb_json_ld: false`.
+
 Important methods:
 
 - `page_title`: returns the composed page title.
@@ -341,7 +348,7 @@ PageStructuredData::PageTypes::NewsArticle.new(
 )
 ```
 
-`authors` should be an array of hashes with `:name` and `:url` keys.
+`authors` can be an array of hashes, `PageStructuredData::PageTypes::Person` objects, or other objects that respond to `to_h`.
 `image` is a convenience option for one image URL. Use `images` when passing multiple image URLs.
 `text` is an alias for `article_body`.
 `interaction_statistics` should be an array of `PageStructuredData::PageTypes::InteractionStatistic` objects or schema-compatible hashes.
@@ -393,6 +400,30 @@ Important methods:
 
 - `to_h`: returns a structured hash for `InteractionCounter` JSON-LD.
 
+### Person
+
+```ruby
+PageStructuredData::PageTypes::Person.new(
+  name:,
+  url: nil,
+  image: nil,
+  same_as: []
+)
+```
+
+Use `Person` for article authors, organization founders, and other schema.org person values:
+
+```ruby
+author = PageStructuredData::PageTypes::Person.new(
+  name: "Jane Doe",
+  url: "https://example.com/jane"
+)
+```
+
+Important methods:
+
+- `to_h`: returns a compact structured hash for `Person` JSON-LD.
+
 ### Organization Page Type
 
 ```ruby

data/app/src/page_structured_data/page.rb

@@ -4,11 +4,11 @@ module PageStructuredData
   # Basic page metadata for any page
   class Page
     attr_reader :title, :description, :image, :extra_title, :breadcrumb, :page_type, :page_types, :canonical_url,
-                :fallback_image
+                :fallback_image, :base_app_name, :render_breadcrumb_json_ld
 
     def initialize(title:, description: nil, image: nil, # rubocop:disable Metrics/ParameterLists
                    extra_title: '', breadcrumb: nil, page_type: nil, page_types: nil, canonical_url: nil,
-                   fallback_image: nil)
+                   fallback_image: nil, base_app_name: nil, render_breadcrumb_json_ld: nil)
       @title = title
       @description = description
       @image = image
@@ -18,6 +18,8 @@ module PageStructuredData
       @page_types = page_types
       @canonical_url = canonical_url
       @fallback_image = fallback_image
+      @base_app_name = base_app_name
+      @render_breadcrumb_json_ld = render_breadcrumb_json_ld
     end
 
     def title_with_hierarchies
@@ -28,8 +30,8 @@ module PageStructuredData
 
     def page_title
       result = title_with_hierarchies.join(separator)
-      if base_app_name.present?
-        result += separator + base_app_name
+      if resolved_base_app_name.present?
+        result += separator + resolved_base_app_name
       end
       result
     end
@@ -52,13 +54,22 @@ module PageStructuredData
     end
 
     def breadcrumb_json_ld
+      return if render_breadcrumb_json_ld == false
       return breadcrumb.json_ld(current_page_title: title) if breadcrumb.present?
-      return unless PageStructuredData.render_default_breadcrumb_json_ld
+      return unless render_breadcrumb_json_ld?
 
       Breadcrumbs.new.json_ld(current_page_title: title)
     end
 
-    def base_app_name
+    def render_breadcrumb_json_ld?
+      return render_breadcrumb_json_ld unless render_breadcrumb_json_ld.nil?
+
+      PageStructuredData.render_default_breadcrumb_json_ld
+    end
+
+    def resolved_base_app_name
+      return base_app_name unless base_app_name.nil?
+
       PageStructuredData.base_app_name
     end
 

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

@@ -4,6 +4,8 @@ module PageStructuredData
   module PageTypes
     # Shared structured data for schema.org article-like page types.
     class Article
+      include SchemaNode
+
       attr_reader :headline, :images, :published_at, :updated_at, :authors, :article_body, :url,
                   :interaction_statistics, :likes_count, :comments_count, :shares_count
 
@@ -30,13 +32,7 @@ module PageStructuredData
           image: images,
           datePublished: published_at,
           dateModified: updated_at,
-          author: authors.map do |author|
-            {
-              '@type': 'Person',
-              name: author[:name],
-              url: author[:url],
-            }
-          end,
+          author: authors.map { |author| author_to_h(author) },
         }
 
         node[:articleBody] = article_body if article_body.present?
@@ -60,6 +56,18 @@ module PageStructuredData
         raise NotImplementedError, "#{self.class.name} must define #schema_type"
       end
 
+      def author_to_h(author)
+        return object_to_h(author) if author.respond_to?(:to_h) && !author.is_a?(Hash)
+
+        compact_node(
+          '@type': 'Person',
+          name: author[:name] || author['name'],
+          url: author[:url] || author['url'],
+          image: author[:image] || author['image'],
+          sameAs: author[:same_as] || author[:sameAs] || author['same_as'] || author['sameAs']
+        )
+      end
+
       def interaction_statistics_to_h
         @interaction_statistics_to_h ||= all_interaction_statistics.map do |interaction_statistic|
           if interaction_statistic.respond_to?(:to_h)

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

@@ -4,6 +4,8 @@ module PageStructuredData
   module PageTypes
     # schema.org InteractionCounter structured data.
     class InteractionStatistic
+      include SchemaNode
+
       ACTION_TYPES = {
         like: 'LikeAction',
         likes: 'LikeAction',
@@ -34,15 +36,12 @@ module PageStructuredData
       end
 
       def to_h
-        node = {
+        compact_node(
           '@type': 'InteractionCounter',
           interactionType: interaction_type_to_h,
           userInteractionCount: user_interaction_count,
-        }
-
-        node[:interactionService] = object_to_h(interaction_service) if interaction_service.present?
-
-        node
+          interactionService: object_to_h(interaction_service)
+        )
       end
 
       private
@@ -54,12 +53,6 @@ module PageStructuredData
 
         { '@type': type }
       end
-
-      def object_to_h(object)
-        return object.to_h if object.respond_to?(:to_h)
-
-        object
-      end
     end
   end
 end

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

@@ -4,6 +4,8 @@ module PageStructuredData
   module PageTypes
     # Organization structured data for a page
     class Organization
+      include SchemaNode
+
       attr_reader :name, :url, :description, :logo, :same_as, :parent_organization, :founder
 
       def initialize(name:, url:, description: nil, logo: nil, same_as: [], parent_organization: nil, founder: nil)
@@ -11,33 +13,23 @@ module PageStructuredData
         @url = url
         @description = description
         @logo = logo
-        @same_as = same_as
+        @same_as = Array(same_as)
         @parent_organization = parent_organization
         @founder = founder
       end
 
       def to_h # rubocop:disable Metrics/MethodLength
-        node = {
+        compact_node(
           '@context': 'https://schema.org',
           '@type': 'Organization',
-        }
-
-        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] = {
-            '@type': 'Organization',
-            name: parent_organization[:name],
-            url: parent_organization[:url],
-          }
-        end
-
-        node
+          name: name,
+          url: url,
+          description: description,
+          logo: logo,
+          sameAs: same_as,
+          founder: object_to_h(founder),
+          parentOrganization: parent_organization_to_h
+        )
       end
 
       def json_ld
@@ -50,10 +42,15 @@ module PageStructuredData
 
       private
 
-      def founder_to_h
-        return founder.to_h if founder.respond_to?(:to_h)
+      def parent_organization_to_h
+        return object_to_h(parent_organization) if parent_organization.respond_to?(:to_h) && !parent_organization.is_a?(Hash)
+        return unless parent_organization.present?
 
-        founder
+        compact_node(
+          '@type': 'Organization',
+          name: parent_organization[:name] || parent_organization['name'],
+          url: parent_organization[:url] || parent_organization['url']
+        )
       end
     end
   end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module PageStructuredData
+  module PageTypes
+    # schema.org Person structured data.
+    class Person
+      include SchemaNode
+
+      attr_reader :name, :url, :image, :same_as
+
+      def initialize(name:, url: nil, image: nil, same_as: [])
+        @name = name
+        @url = url
+        @image = image
+        @same_as = Array(same_as)
+      end
+
+      def to_h
+        compact_node(
+          '@type': 'Person',
+          name: name,
+          url: url,
+          image: image,
+          sameAs: same_as
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module PageStructuredData
+  module PageTypes
+    # Shared helpers for schema.org hash values.
+    module SchemaNode
+      private
+
+      def compact_node(node)
+        node.each_with_object({}) do |(key, value), compacted|
+          next if blank_schema_value?(value)
+
+          compacted[key] = value
+        end
+      end
+
+      def object_to_h(object)
+        return object.to_h if object.respond_to?(:to_h)
+
+        object
+      end
+
+      def blank_schema_value?(value)
+        value.nil? || (value.respond_to?(:empty?) && value.empty?)
+      end
+    end
+  end
+end

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

@@ -4,6 +4,8 @@ module PageStructuredData
   module PageTypes
     # WebSite structured data for a page
     class WebSite
+      include SchemaNode
+
       attr_reader :name, :url, :description, :publisher, :potential_action
 
       def initialize(name:, url:, description: nil, publisher: nil, potential_action: nil)
@@ -15,18 +17,15 @@ module PageStructuredData
       end
 
       def to_h
-        node = {
+        compact_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
+          description: description,
+          publisher: object_to_h(publisher),
+          potentialAction: object_to_h(potential_action)
+        )
       end
 
       def json_ld
@@ -37,13 +36,6 @@ module PageStructuredData
         )
       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

@@ -11,16 +11,28 @@
 <% end %>
 
 <meta name="title" content="<%= title %>">
+<% if description.present? %>
 <meta name="description" content="<%= description %>">
+<% end %>
+<% if image.present? %>
 <meta name="image" content="<%= image %>">
+<% end %>
 
 <meta property="og:title" content="<%= title %>">
+<% if description.present? %>
 <meta property="og:description" content="<%= description %>">
+<% end %>
+<% if image.present? %>
 <meta property="og:image" content="<%= image %>">
+<% end %>
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:title" content="<%= title %>">
+<% if description.present? %>
 <meta name="twitter:description" content="<%= description %>">
+<% end %>
+<% if image.present? %>
 <meta name="twitter:image" content="<%= image %>">
+<% end %>
 
 <%= page&.json_lds&.html_safe %>

data/lib/page_structured_data/version.rb

@@ -1,3 +1,3 @@
 module PageStructuredData
-  VERSION = "1.0.12"
+  VERSION = "1.0.13"
 end

data/lib/page_structured_data.rb

@@ -2,6 +2,8 @@ require "page_structured_data/version"
 require "page_structured_data/engine"
 require_relative "../app/src/page_structured_data/anchors"
 require_relative "../app/src/page_structured_data/breadcrumbs"
+require_relative "../app/src/page_structured_data/page_types/schema_node"
+require_relative "../app/src/page_structured_data/page_types/person"
 require_relative "../app/src/page_structured_data/page_types/interaction_statistic"
 require_relative "../app/src/page_structured_data/page_types/article"
 require_relative "../app/src/page_structured_data/page_types/blog_posting"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_structured_data
 version: !ruby/object:Gem::Version
-  version: 1.0.12
+  version: 1.0.13
 platform: ruby
 authors:
 - Jey Geethan
@@ -32,8 +32,8 @@ dependencies:
         version: '9.0'
 description: PageStructuredData gives Rails applications a small page object and view
   partial for rendering page titles, basic meta tags, Open Graph tags, Twitter card
-  tags, breadcrumb JSON-LD, article and forum post JSON-LD, Organization JSON-LD,
-  WebSite JSON-LD, and public interaction statistics.
+  tags, breadcrumb JSON-LD, article and forum post JSON-LD, Person, Organization,
+  and WebSite JSON-LD, and public interaction statistics.
 email:
 - opensource@rocketapex.com
 executables: []
@@ -53,6 +53,8 @@ files:
 - app/src/page_structured_data/page_types/interaction_statistic.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/person.rb
+- app/src/page_structured_data/page_types/schema_node.rb
 - app/src/page_structured_data/page_types/web_site.rb
 - app/views/page_structured_data/_meta_tags.html.erb
 - config/routes.rb