better_seo 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c5febaa764505c7680d89bd6858600708fbd362d811818c7206b6e8f8768b32
-  data.tar.gz: 7a6928082bed979115b7411049182fbd6591ac0156fa5670a9cadb843d3b23d8
+  metadata.gz: 8e54a1f72d1782db6366637bd76336b7af2bf1d51dd3241dc7ba4be9f0deb75b
+  data.tar.gz: a2bc94c2c62edc86b3bf50db8f56424b11649d7aa4d3b53867b55d3561a69a5d
 SHA512:
-  metadata.gz: 8a4c80163add6a90ddabb694ec95c6defddf0ef4a3357bc0e3defc2ea4cb3ace4556bec7f5303571dbc72caf860f0092f54c43e61a4f8a70f573b88d6d39b146
-  data.tar.gz: 9abc8a475e9380e85b0a410547f63eca11682f21b0271acbab83a6f855212c888c3a937d9db5358e0518697acb3af61d9e852060a0f871dd80b86c313eb43916
+  metadata.gz: b53dd20aa929536a0de6f293bf2e1efe35437cb9431db5f86f0865bf4bdc8ec3575fd95dbc9843fdb4ebb3c259da65bf9f39ee636c199ec4818141019f71dcbb
+  data.tar.gz: 79f5dd0ae283b0a05af28c3f5372db36e9d618fffc4596a5c716b3c67ae4ea5751b2e697dc637837dcb6619d94801be79519364621b339b0df40a3701ed552c5

data/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2025-01-23
+
+### Added
+- Rails Structured Data View Helpers for easy integration
+  - `structured_data_tag(type, **properties, &block)` - Generic helper with type symbol or object
+  - `organization_sd(**properties, &block)` - Organization structured data helper
+  - `article_sd(**properties, &block)` - Article structured data helper
+  - `person_sd(**properties, &block)` - Person structured data helper
+  - `product_sd(**properties, &block)` - Product structured data helper
+  - `breadcrumb_list_sd(items:, &block)` - Breadcrumb list structured data helper
+  - `structured_data_tags(array)` - Multiple structured data tags generation
+- Helper features
+  - Support for both hash configuration and block-based DSL
+  - Type mapping with symbol-based factory methods
+  - Automatic HTML safety with `raw` method
+  - Pass existing structured data objects or create on-the-fly
+  - Seamless integration with Rails views and layouts
+- Complete Rails integration examples
+  - Product page with breadcrumbs and structured data
+  - Helper method reference table
+  - Type-specific helper examples
+
+### Test Coverage
+- 552 tests passing (+22 from v0.7.0)
+- 98.83% code coverage (931/942 lines)
+- 22 new tests for StructuredDataHelper
+
 ## [0.7.0] - 2025-01-23
 
 ### Added

data/README.md

@@ -2,14 +2,14 @@
 
 A comprehensive SEO gem for Ruby and Rails applications. BetterSeo provides a clean, fluent DSL for managing meta tags, Open Graph, Twitter Cards, structured data, sitemaps, and more.
 
-[![Tests](https://img.shields.io/badge/tests-530%20passing-brightgreen)](https://github.com/yourusername/better_seo)
-[![Coverage](https://img.shields.io/badge/coverage-98.89%25-brightgreen)](https://github.com/yourusername/better_seo)
+[![Tests](https://img.shields.io/badge/tests-552%20passing-brightgreen)](https://github.com/yourusername/better_seo)
+[![Coverage](https://img.shields.io/badge/coverage-98.83%25-brightgreen)](https://github.com/yourusername/better_seo)
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.0.0-red)](https://www.ruby-lang.org)
 [![Rails](https://img.shields.io/badge/rails-%3E%3D%206.1-red)](https://rubyonrails.org)
 
 ## Features
 
-### ✅ Implemented (v0.7.0)
+### ✅ Implemented (v0.8.0)
 
 - **Core Configuration System**
   - Singleton configuration with block-style setup
@@ -33,7 +33,8 @@ A comprehensive SEO gem for Ruby and Rails applications. BetterSeo provides a cl
   - Integration with DSL builders
 
 - **Rails Integration**
-  - **View Helpers**: `seo_meta_tags`, `seo_open_graph_tags`, `seo_twitter_tags`, `seo_tags`
+  - **SEO View Helpers**: `seo_meta_tags`, `seo_open_graph_tags`, `seo_twitter_tags`, `seo_tags`
+  - **Structured Data Helpers**: `structured_data_tag`, `organization_sd`, `article_sd`, `person_sd`, `product_sd`, `breadcrumb_list_sd`
   - Support for hash configuration and DSL blocks
   - Automatic HTML safety with `raw` helper
   - Integration with global configuration defaults
@@ -1312,6 +1313,174 @@ And in article views:
 <%= article_structured_data(@article) %>
 ```
 
+#### Rails View Helpers (v0.8.0)
+
+BetterSeo includes built-in Rails view helpers for easy structured data integration:
+
+**Generic Helper - `structured_data_tag`**
+
+```erb
+<%# Create from type symbol with hash %>
+<%= structured_data_tag(:organization,
+  name: "Acme Corp",
+  url: "https://acme.com",
+  logo: "https://acme.com/logo.png"
+) %>
+
+<%# Create from type symbol with block %>
+<%= structured_data_tag(:article) do |article|
+  article.headline("My Article")
+  article.author("John Doe")
+  article.date_published("2024-01-15")
+end %>
+
+<%# Pass an existing object %>
+<% org = BetterSeo::StructuredData::Organization.new(name: "Acme") %>
+<%= structured_data_tag(org) %>
+```
+
+**Type-Specific Helpers**
+
+Convenience methods for each structured data type:
+
+```erb
+<%# Organization %>
+<%= organization_sd(
+  name: "Acme Corp",
+  url: "https://acme.com"
+) %>
+
+<%# Or with block %>
+<%= organization_sd do |org|
+  org.name("Acme Corp")
+  org.url("https://acme.com")
+  org.logo("https://acme.com/logo.png")
+end %>
+
+<%# Article %>
+<%= article_sd(
+  headline: @article.title,
+  author: @article.author.name,
+  date_published: @article.published_at.iso8601
+) %>
+
+<%# Person %>
+<%= person_sd do |person|
+  person.name("John Doe")
+  person.email("john@example.com")
+  person.job_title("Software Engineer")
+end %>
+
+<%# Product %>
+<%= product_sd do |product|
+  product.name(@product.name)
+  product.brand(@product.brand)
+  product.offers(
+    price: @product.price,
+    price_currency: "USD",
+    availability: "InStock"
+  )
+  product.aggregate_rating(
+    rating_value: @product.average_rating,
+    review_count: @product.reviews_count
+  )
+end %>
+
+<%# Breadcrumb List %>
+<%= breadcrumb_list_sd do |breadcrumb|
+  breadcrumb.add_item(name: "Home", url: root_url)
+  breadcrumb.add_item(name: "Products", url: products_url)
+  breadcrumb.add_item(name: @product.name, url: product_url(@product))
+end %>
+
+<%# Or from array %>
+<% items = [
+  { name: "Home", url: root_url },
+  { name: "Products", url: products_url }
+] %>
+<%= breadcrumb_list_sd(items: items) %>
+```
+
+**Multiple Tags Helper - `structured_data_tags`**
+
+Generate multiple script tags at once:
+
+```erb
+<% org = BetterSeo::StructuredData::Organization.new(name: "Acme") %>
+<% person = BetterSeo::StructuredData::Person.new(name: "John") %>
+<% article = BetterSeo::StructuredData::Article.new(headline: "Title") %>
+
+<%= structured_data_tags([org, person, article]) %>
+```
+
+**Complete Rails Example**
+
+```erb
+<%# app/views/products/show.html.erb %>
+<head>
+  <%# Page SEO tags %>
+  <%= seo_tags do |seo|
+    seo.meta do |meta|
+      meta.title @product.name
+      meta.description @product.description
+    end
+    seo.og do |og|
+      og.type "product"
+      og.title @product.name
+      og.image @product.image_url
+    end
+  end %>
+
+  <%# Structured data %>
+  <%= organization_sd do |org|
+    org.name("My Shop")
+    org.url(root_url)
+  end %>
+
+  <%= breadcrumb_list_sd do |bc|
+    bc.add_item(name: "Home", url: root_url)
+    bc.add_item(name: "Products", url: products_url)
+    bc.add_item(name: @product.category, url: category_url(@product.category))
+    bc.add_item(name: @product.name, url: product_url(@product))
+  end %>
+
+  <%= product_sd do |product|
+    product.name(@product.name)
+    product.description(@product.description)
+    product.image(@product.image_url)
+    product.brand(@product.brand)
+    product.sku(@product.sku)
+    product.offers(
+      price: @product.price,
+      price_currency: "USD",
+      availability: @product.in_stock? ? "InStock" : "OutOfStock",
+      url: product_url(@product)
+    )
+    if @product.reviews.any?
+      product.aggregate_rating(
+        rating_value: @product.average_rating,
+        review_count: @product.reviews_count,
+        best_rating: 5
+      )
+    end
+  end %>
+</head>
+```
+
+**Helper Method Reference**
+
+| Helper | Description |
+|--------|-------------|
+| `structured_data_tag(type, **props, &block)` | Generic helper for any type |
+| `organization_sd(**props, &block)` | Organization structured data |
+| `article_sd(**props, &block)` | Article structured data |
+| `person_sd(**props, &block)` | Person structured data |
+| `product_sd(**props, &block)` | Product structured data |
+| `breadcrumb_list_sd(items:, &block)` | Breadcrumb list structured data |
+| `structured_data_tags(array)` | Multiple structured data tags |
+
+All helpers support both hash configuration and block-based DSL for maximum flexibility.
+
 #### Complete Example
 
 ```ruby
@@ -1478,11 +1647,13 @@ bundle exec rspec --format documentation
 ```
 
 Current test statistics:
-- **286 tests** passing
-- **100% code coverage** (562/562 lines)
+- **552 tests** passing
+- **98.83% code coverage** (931/942 lines)
 - **3 DSL builders** fully tested
 - **3 HTML generators** fully tested
-- **1 Rails view helper module** fully tested
+- **2 Rails view helper modules** fully tested
+- **5 Structured data types** fully tested
+- **1 Sitemap generation system** fully tested
 - **1 core configuration system** fully tested
 
 ## Architecture

data/lib/better_seo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BetterSeo
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/better_seo.rb

@@ -13,7 +13,6 @@ require_relative "better_seo/dsl/twitter_cards"
 require_relative "better_seo/generators/meta_tags_generator"
 require_relative "better_seo/generators/open_graph_generator"
 require_relative "better_seo/generators/twitter_cards_generator"
-require_relative "better_seo/rails/helpers/seo_helper"
 require_relative "better_seo/sitemap/url_entry"
 require_relative "better_seo/sitemap/builder"
 require_relative "better_seo/sitemap/generator"
@@ -24,6 +23,8 @@ require_relative "better_seo/structured_data/person"
 require_relative "better_seo/structured_data/product"
 require_relative "better_seo/structured_data/breadcrumb_list"
 require_relative "better_seo/structured_data/generator"
+require_relative "better_seo/rails/helpers/seo_helper"
+require_relative "better_seo/rails/helpers/structured_data_helper"
 
 module BetterSeo
   class << self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_seo
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - alessiobussolari