meta-tags 2.12.0 → 2.16.0

data/README.md

@@ -5,19 +5,19 @@
 [![Code Climate](https://codeclimate.com/github/kpumuk/meta-tags/badges/gpa.svg)](https://codeclimate.com/github/kpumuk/meta-tags)
 [![Test Coverage](https://codeclimate.com/github/kpumuk/meta-tags/badges/coverage.svg)](https://codeclimate.com/github/kpumuk/meta-tags/coverage)
 [![Gem Downloads](https://img.shields.io/gem/dt/meta-tags.svg)](https://badge.fury.io/rb/meta-tags)
-[![Changelog](https://img.shields.io/badge/Changelog-latest-blue.svg)](https://github.com/kpumuk/meta-tags/blob/master/CHANGELOG.md)
+[![Changelog](https://img.shields.io/badge/Changelog-latest-blue.svg)](https://github.com/kpumuk/meta-tags/blob/main/CHANGELOG.md)
 
 Search Engine Optimization (SEO) plugin for Ruby on Rails applications.
 
 ## Ruby on Rails
 
-MetaTags master branch fully supports Ruby on Rails 4.2+, and is tested against all
-major Rails releases up to 6.0.beta2.
+MetaTags main branch fully supports Ruby on Rails 5.1+, and is tested against all
+major Rails releases up to 6.1.
 
-Ruby versions older than 2.2.0 are no longer officially supported.
+Ruby versions older than 2.5 are no longer officially supported.
 
-_Please note_ that we are no longer support Ruby versions older than 2.2.0 and
-Ruby on Rails older than 4.2, because they [reached their End of Life](https://github.com/kpumuk/meta-tags/pull/143).
+_Please note_ that we are no longer support Ruby versions older than 2.4.0 and
+Ruby on Rails older than 5.1, because they [reached their End of Life](https://github.com/kpumuk/meta-tags/pull/143).
 
 ## Installation
 
@@ -152,30 +152,30 @@ If you want to set the title and display another text, use this:
 
 Use these options to customize the title format:
 
-| Option         | Description |
-| -------------- | ----------- |
-| `:site`        | site title |
-| `:title`       | page title |
-| `:description` | page description |
-| `:keywords`    | page keywords |
-| `:charset`     | page character set |
-| `:prefix`      | text between site name and separator |
-| `:separator`   | text used to separate website name from page title |
-| `:suffix`      | text between separator and page title |
-| `:lowercase`   | when true, the page name will be lowercase |
-| `:reverse`     | when true, the page and site names will be reversed |
-| `:noindex`     | add noindex meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings |
-| `:index`       | add index meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings |
-| `:nofollow`    | add nofollow meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings |
-| `:follow`      | add follow meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings |
+| Option         | Description                                                                                                          |
+| -------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `:site`        | site title                                                                                                           |
+| `:title`       | page title                                                                                                           |
+| `:description` | page description                                                                                                     |
+| `:keywords`    | page keywords                                                                                                        |
+| `:charset`     | page character set                                                                                                   |
+| `:prefix`      | text between site name and separator                                                                                 |
+| `:separator`   | text used to separate website name from page title                                                                   |
+| `:suffix`      | text between separator and page title                                                                                |
+| `:lowercase`   | when true, the page name will be lowercase                                                                           |
+| `:reverse`     | when true, the page and site names will be reversed                                                                  |
+| `:noindex`     | add noindex meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings   |
+| `:index`       | add index meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings     |
+| `:nofollow`    | add nofollow meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings  |
+| `:follow`      | add follow meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings    |
 | `:noarchive`   | add noarchive meta tag; when true, 'robots' will be used; accepts a string with a robot name, or an array of strings |
-| `:canonical`   | add canonical link tag |
-| `:prev`        | add prev link tag |
-| `:next`        | add next link tag |
-| `:image_src`   | add image_src link tag |
-| `:og`          | add Open Graph tags (Hash) |
-| `:twitter`     | add Twitter tags (Hash) |
-| `:refresh`     | refresh interval and optionally url to redirect to |
+| `:canonical`   | add canonical link tag                                                                                               |
+| `:prev`        | add prev link tag                                                                                                    |
+| `:next`        | add next link tag                                                                                                    |
+| `:image_src`   | add image_src link tag                                                                                               |
+| `:og`          | add Open Graph tags (Hash)                                                                                           |
+| `:twitter`     | add Twitter tags (Hash)                                                                                              |
+| `:refresh`     | refresh interval and optionally url to redirect to                                                                   |
 
 And here are a few examples to give you ideas.
 
@@ -307,7 +307,7 @@ Recommended title tag length: up to <b>70 characters</b>, <b>10 words</b>.
 
 Further reading:
 
-* [Title Tag](https://moz.com/learn/seo/title-tag)
+- [Title Tag](https://moz.com/learn/seo/title-tag)
 
 ### Description
 
@@ -325,8 +325,8 @@ Recommended description tag length: up to <b>300 characters</b>.
 
 Further reading:
 
-* [Meta Description](https://moz.com/learn/seo/meta-description)
-* [How Long Should Your Meta Description Be? (2018 Edition)](https://moz.com/blog/how-long-should-your-meta-description-be-2018)
+- [Meta Description](https://moz.com/learn/seo/meta-description)
+- [How Long Should Your Meta Description Be? (2018 Edition)](https://moz.com/blog/how-long-should-your-meta-description-be-2018)
 
 ### Keywords
 
@@ -360,8 +360,8 @@ This is useful for pages like login, password reset, privacy policy, etc.
 
 Further reading:
 
-* [Blocking Google](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93708)
-* [Using meta tags to block access to your site](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93710)
+- [Blocking Google](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93708)
+- [Using meta tags to block access to your site](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93710)
 
 ### Index
 
@@ -388,12 +388,12 @@ set_meta_tags nofollow: 'googlebot'
 
 Further reading:
 
-* [About rel="nofollow"](http://www.google.com/support/webmasters/bin/answer.py?answer=96569)
-* [Meta tags](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=79812)
+- [About rel="nofollow"](http://www.google.com/support/webmasters/bin/answer.py?answer=96569)
+- [Meta tags](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=79812)
 
 ### Follow
 
-Follow will work with Noindex  meta tag
+Follow will work with Noindex meta tag
 
 ```ruby
 set_meta_tags noindex: true, follow: true
@@ -409,6 +409,9 @@ Canonical link element tells a search engine what is the canonical or main URL
 for a content which have multiple URLs. The search engine will always return
 that URL, and link popularity and authority will be applied to that URL.
 
+Note: If you like follow a hint of John Mueller that you shouldn't mix canonical with noindex, then you can
+set `MetaTags.config.skip_canonical_links_on_noindex = true` and we'll handle it for you.
+
 ```ruby
 set_meta_tags canonical: "http://yoursite.com/canonical/url"
 # <link rel="canonical" href="http://yoursite.com/canonical/url">
@@ -416,8 +419,8 @@ set_meta_tags canonical: "http://yoursite.com/canonical/url"
 
 Further reading:
 
-* [About rel="canonical"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139394)
-* [Canonicalization](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139066)
+- [About rel="canonical"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139394)
+- [Canonicalization](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139066)
 
 ### Icon
 
@@ -440,9 +443,8 @@ set_meta_tags icon: [
 
 Further reading:
 
-* [Favicon](https://www.wikiwand.com/en/Favicon)
-* [Touch Icons](https://mathiasbynens.be/notes/touch-icons)
-
+- [Favicon](https://www.wikiwand.com/en/Favicon)
+- [Touch Icons](https://mathiasbynens.be/notes/touch-icons)
 
 ### Multi-regional and multilingual URLs, RSS and mobile links
 
@@ -471,9 +473,9 @@ set_meta_tags alternate: [
 
 Further reading:
 
-* [Multi-regional and multilingual sites](https://support.google.com/webmasters/answer/182192)
-* [About rel="alternate" hreflang="x"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=189077)
-* [Separate URLs](https://developers.google.com/webmasters/mobile-sites/mobile-seo/configurations/separate-urls#annotation-in-the-html)
+- [Multi-regional and multilingual sites](https://support.google.com/webmasters/answer/182192)
+- [About rel="alternate" hreflang="x"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=189077)
+- [Separate URLs](https://developers.google.com/webmasters/mobile-sites/mobile-seo/configurations/separate-urls#annotation-in-the-html)
 
 ### Pagination links
 
@@ -490,8 +492,8 @@ set_meta_tags next: "http://yoursite.com/url?page=3"
 
 Further reading:
 
-* [Pagination](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1663744)
-* [Pagination with rel="next" and rel="prev"](http://googlewebmastercentral.blogspot.ca/2011/09/pagination-with-relnext-and-relprev.html)
+- [Pagination](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1663744)
+- [Pagination with rel="next" and rel="prev"](http://googlewebmastercentral.blogspot.ca/2011/09/pagination-with-relnext-and-relprev.html)
 
 ### image_src links
 
@@ -518,8 +520,17 @@ set_meta_tags amphtml: url_for(format: :amp, only_path: false)
 
 To link back to normal version, use `canonical`.
 
-* [What Is AMP?](https://www.ampproject.org/learn/about-amp/)
-* [Make Your Page Discoverable](https://www.ampproject.org/docs/guides/discovery)
+- [What Is AMP?](https://www.ampproject.org/learn/about-amp/)
+- [Make Your Page Discoverable](https://www.ampproject.org/docs/guides/discovery)
+
+### Manifest links
+
+```ruby
+set_meta_tags manifest: 'manifest.json'
+# <link rel="manifest" href="manifest.json">
+```
+
+- [What is manifest?](https://developer.mozilla.org/en-US/docs/Web/Manifest)
 
 ### Refresh interval and redirect URL
 
@@ -539,9 +550,8 @@ set_meta_tags refresh: '5;url=http://example.com'
 
 Further reading:
 
-* [Meta refresh](http://en.wikipedia.org/wiki/Meta_refresh)
-* [What is the Meta Refresh Tag](http://webdesign.about.com/od/metataglibraries/a/aa080300a.htm)
-
+- [Meta refresh](http://en.wikipedia.org/wiki/Meta_refresh)
+- [What is the Meta Refresh Tag](http://webdesign.about.com/od/metataglibraries/a/aa080300a.htm)
 
 ### Open Search
 
@@ -557,8 +567,8 @@ set_meta_tags open_search: {
 
 Further reading:
 
-* [OpenSearch specs](http://www.opensearch.org/Specifications/OpenSearch/1.1)
-* [OpenSearch wiki](http://en.wikipedia.org/wiki/OpenSearch)
+- [OpenSearch specs](http://www.opensearch.org/Specifications/OpenSearch/1.1)
+- [OpenSearch wiki](http://en.wikipedia.org/wiki/OpenSearch)
 
 ### Hashes
 
@@ -660,8 +670,8 @@ set_meta_tags article: {
 
 Further reading:
 
-* [Open Graph protocol](http://developers.facebook.com/docs/opengraph/)
-* [Must-Have Social Meta Tags for Twitter, Google+, Facebook and More](https://moz.com/blog/meta-data-templates-123)
+- [Open Graph protocol](http://developers.facebook.com/docs/opengraph/)
+- [Must-Have Social Meta Tags for Twitter, Google+, Facebook and More](https://moz.com/blog/meta-data-templates-123)
 
 ### Twitter Cards
 
@@ -696,9 +706,27 @@ set_meta_tags twitter: {
 # <meta name="twitter:image:height" content="100">
 ```
 
+Special parameter `itemprop` can be used on a "anonymous" tag "\_" to generate "itemprop" HTML attribute:
+
+```ruby
+set_meta_tags twitter: {
+  card:  "photo",
+  image: {
+    _:        "http://example.com/1.png",
+    width:    100,
+    height:   100,
+    itemprop: "image",
+  }
+}
+# <meta name="twitter:card" content="photo">
+# <meta name="twitter:image" content="http://example.com/1.png" itemprop="image">
+# <meta name="twitter:image:width" content="100">
+# <meta name="twitter:image:height" content="100">
+```
+
 Further reading:
 
-* [Twitter Cards Documentation](https://dev.twitter.com/cards/)
+- [Twitter Cards Documentation](https://dev.twitter.com/cards/)
 
 ### App Links
 
@@ -719,7 +747,7 @@ set_meta_tags al: {
 
 Further reading:
 
-* [App Links Documentation](https://developers.facebook.com/docs/applinks)
+- [App Links Documentation](https://developers.facebook.com/docs/applinks)
 
 ### Custom meta tags
 

data/Rakefile

@@ -16,3 +16,34 @@ task :circleci do
   config_path = File.expand_path('.circleci/config.yml', __dir__)
   File.write config_path, ERB.new(File.read(template_path)).result
 end
+
+module SteepRunner
+  def self.run(*command)
+    require "steep"
+    require "steep/cli"
+
+    Steep::CLI.new(argv: command, stdout: $stdout, stderr: $stderr, stdin: $stdin).run
+  end
+end
+
+task :steep do
+  SteepRunner.run("check")
+end
+
+namespace :steep do
+  task :stats do
+    SteepRunner.run("stats", "--log-level=fatal")
+  end
+end
+
+namespace :rbs do
+  task :spec do
+    exec(
+      {
+        'RBS_TEST_TARGET' => 'MetaTags::*',
+        'RUBYOPT'         => '-rrbs/test/setup',
+      },
+      'bundle exec rspec',
+    )
+  end
+end

data/Steepfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+target :lib do
+  signature "sig"
+
+  check "lib"
+  # check "Gemfile"
+
+  # We don't want to type check Rails/RSpec related code
+  # (because we don't have RBS files for it)
+  ignore "lib/meta_tags/railtie.rb"
+  ignore "lib/generators"
+end

data/certs/kpumuk.pem

@@ -1,7 +1,7 @@
 -----BEGIN CERTIFICATE-----
 MIIDODCCAiCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhrcHVt
-dWsvREM9a3B1bXVrL0RDPWluZm8wHhcNMTgxMTE2MTgxOTIzWhcNMTkxMTE2MTgx
-OTIzWjAjMSEwHwYDVQQDDBhrcHVtdWsvREM9a3B1bXVrL0RDPWluZm8wggEiMA0G
+dWsvREM9a3B1bXVrL0RDPWluZm8wHhcNMjAxMjEwMjA1MTE5WhcNMjExMjEwMjA1
+MTE5WjAjMSEwHwYDVQQDDBhrcHVtdWsvREM9a3B1bXVrL0RDPWluZm8wggEiMA0G
 CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC8NmK6GXPiE/q7PDbj7nNdw3pa8a6Q
 IDxLtc7kW95e1mh0TVgOE8kvGegGtRtjvhXVGTTFtZ+yMD/0DCfTM2oUQYk5oYpO
 ZGrCfbNIdZauf4WYsnJtKOTrRoqFMwpL5PlBDKczB2y5lUmQs2HIsjQ0Q21wdKyy
@@ -10,11 +10,11 @@ ZGrCfbNIdZauf4WYsnJtKOTrRoqFMwpL5PlBDKczB2y5lUmQs2HIsjQ0Q21wdKyy
 RryRTj5NVZbq9p1/WRc5zxD9QhAEPjRa5ikbd+eWebIDpAKI0hpyC/9bAgMBAAGj
 dzB1MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBT2uFRXNWDpVdbv
 +xBk8DAgJPGBPTAdBgNVHREEFjAUgRJrcHVtdWtAa3B1bXVrLmluZm8wHQYDVR0S
-BBYwFIESa3B1bXVrQGtwdW11ay5pbmZvMA0GCSqGSIb3DQEBCwUAA4IBAQB9bd46
-p2C6r49hmuxMrIFRi05MS0Nze6GvlYvF5mb2+KS9YCLWLFb1G+0zttX51qVdO3nc
-uw1O5ku+Up47jv5ClyguHinCntFCA5hupyYkbpnFuURZE3QIY6UZQyJ2xuIPFfnR
-Q8sXb5/btWSNhKXx29TL35SkEH5fzPA90DljUPGp3lLEK0+7FQk0OkRVumdyanEE
-LUchqnAWHnNCdQhEhsnbYhSvG0NE2uzMWeUd6uDONYsRFNRXaRwj8tykWgKZvIod
-j0ZkOZOMk6hzny9+AnYZ7eiUqp/XX7Hn+hqtl/AebKhbFapnTu0n7KcfM0oDaLUr
-Fc+FAHErSClMb7YN
+BBYwFIESa3B1bXVrQGtwdW11ay5pbmZvMA0GCSqGSIb3DQEBCwUAA4IBAQBdcrpl
+32OlNaf68v38yzqYkviLELtbzRvEpRuQWZZyxOwU1OWSFAWkkALuseLWHDLYRDE8
+lOzQHewKodqaSPEo63vMZ28UQ3kDP1YE+cXR12fOg4YbCH8VETrTJa3X0AOOAbgA
+ZLMcZD6wu9Zu2rPhxLxs6Q/PaGGEc8bonOirCZrwVDzHFA1cPjcSoApdsyGdRiyj
+1f+XHXjCE5A1A6b8o4ffpAI6gkuaQOIrgGCyLS9oos6DSuofkvXI9g62G+2ZOmKJ
+U97JEQmXCpruLEeSVT2UqR+iJAWEAxPzqzDbTzZBTSPKn+nXeuF6h81e4hsJtkeJ
+HkYAoatF9iZrxT4E
 -----END CERTIFICATE-----

data/lib/meta_tags/configuration.rb

@@ -33,6 +33,12 @@ module MetaTags
     # - an array of strings or symbols representing their names or name-prefixes.
     attr_reader :property_tags
 
+    # Configure whenever Meta-Tags should skip canonicals on pages with noindex: true
+    # "shouldn't mix noindex & rel=canonical comes from: they're very contradictory pieces of information for us."
+    # - John Mueller (Webmaster Trends Analyst at Google)
+    # https://www.reddit.com/r/TechSEO/comments/8yahdr/2_questions_about_the_canonical_tag/e2dey9i/
+    attr_accessor :skip_canonical_links_on_noindex
+
     # Initializes a new instance of Configuration class.
     def initialize
       reset_defaults!
@@ -77,6 +83,7 @@ module MetaTags
       @property_tags = default_property_tags.dup
       @open_meta_tags = true
       @minify_output = false
+      @skip_canonical_links_on_noindex = false
     end
   end
 end

data/lib/meta_tags/controller_helper.rb

@@ -15,9 +15,9 @@ module MetaTags
     # Processes the <tt>@page_title</tt>, <tt>@page_keywords</tt>, and
     # <tt>@page_description</tt> instance variables and calls +render+.
     def render(*args, &block)
-      meta_tags[:title]       = @page_title       if @page_title
-      meta_tags[:keywords]    = @page_keywords    if @page_keywords
-      meta_tags[:description] = @page_description if @page_description
+      meta_tags[:title]       = @page_title       if defined?(@page_title) && @page_title
+      meta_tags[:keywords]    = @page_keywords    if defined?(@page_keywords) && @page_keywords
+      meta_tags[:description] = @page_description if defined?(@page_description) && @page_description
 
       super
     end

data/lib/meta_tags/meta_tags_collection.rb

@@ -38,7 +38,13 @@ module MetaTags
     # @return [Hash] result of the merge.
     #
     def update(object = {})
-      meta_tags = object.respond_to?(:to_meta_tags) ? object.to_meta_tags : object
+      meta_tags = if object.respond_to?(:to_meta_tags)
+                    # @type var object: (_MetaTagish & Object)
+                    object.to_meta_tags
+                  else
+                    # @type var object: Hash[String | Symbol, untyped]
+                    object
+                  end
       @meta_tags.deep_merge! normalize_open_graph(meta_tags)
     end
 
@@ -99,7 +105,7 @@ module MetaTags
     #
     def extract_full_title
       site_title = extract(:site) || ''
-      title      = extract_title || []
+      title      = extract_title
       separator  = extract_separator
       reverse    = extract(:reverse) == true
 
@@ -112,8 +118,9 @@ module MetaTags
     #
     def extract_title
       title = extract(:title).presence
-      return unless title
+      return [] unless title
 
+      # @type var title: Array[String]
       title = Array(title)
       return title.map(&:downcase) if extract(:lowercase) == true
 

data/lib/meta_tags/railtie.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module MetaTags
+  class Railtie < Rails::Railtie
+    initializer 'meta_tags.setup_action_controller' do
+      ActiveSupport.on_load :action_controller do
+        ActionController::Base.include MetaTags::ControllerHelper
+      end
+    end
+
+    initializer 'meta_tags.setup_action_view' do
+      ActiveSupport.on_load :action_view do
+        ActionView::Base.include MetaTags::ViewHelper
+      end
+    end
+  end
+end

data/lib/meta_tags/renderer.rb

@@ -26,6 +26,7 @@ module MetaTags
       render_with_normalization(tags, :description)
       render_with_normalization(tags, :keywords)
       render_refresh(tags)
+      render_canonical_link(tags)
       render_noindex(tags)
       render_alternate(tags)
       render_open_search(tags)
@@ -150,7 +151,7 @@ module MetaTags
     # @param [Array<Tag>] tags a buffer object to store tag in.
     #
     def render_links(tags)
-      [ :amphtml, :canonical, :prev, :next, :image_src, :manifest ].each do |tag_name|
+      [ :amphtml, :prev, :next, :image_src, :manifest ].each do |tag_name|
         href = meta_tags.extract(tag_name)
         if href.present?
           @normalized_meta_tags[tag_name] = href
@@ -159,6 +160,19 @@ module MetaTags
       end
     end
 
+    # Renders canonical link
+    #
+    # @param [Array<Tag>] tags a buffer object to store tag in.
+    #
+    def render_canonical_link(tags)
+      href = meta_tags.extract(:canonical) # extract, so its not used anywhere else
+      return if MetaTags.config.skip_canonical_links_on_noindex && meta_tags[:noindex]
+      return if href.blank?
+
+      @normalized_meta_tags[:canonical] = href
+      tags << Tag.new(:link, rel: :canonical, href: href)
+    end
+
     # Renders complex hash objects.
     #
     # @param [Array<Tag>] tags a buffer object to store tag in.
@@ -201,16 +215,17 @@ module MetaTags
     # @param [Hash, Array, String, Symbol] content text content or a symbol reference to
     # top-level meta tag.
     #
-    def process_tree(tags, property, content, **opts)
+    def process_tree(tags, property, content, itemprop: nil, **opts)
       method = case content
                when Hash
                  :process_hash
                when Array
                  :process_array
                else
+                 iprop = itemprop
                  :render_tag
                end
-      __send__(method, tags, property, content, **opts)
+      __send__(method, tags, property, content, itemprop: iprop, **opts)
     end
 
     # Recursive method to process a hash with meta tags
@@ -220,10 +235,21 @@ module MetaTags
     # @param [Hash] content nested meta tag attributes.
     #
     def process_hash(tags, property, content, **opts)
+      itemprop = content.delete(:itemprop)
       content.each do |key, value|
-        key = key.to_s == '_' ? property : "#{property}:#{key}"
-        value = normalized_meta_tags[value] if value.kind_of?(Symbol)
-        process_tree(tags, key, value, **opts)
+        if key.to_s == '_'
+          iprop = itemprop
+          key = property
+        else
+          key = "#{property}:#{key}"
+        end
+
+        normalized_value = if value.kind_of?(Symbol)
+                             normalized_meta_tags[value]
+                           else
+                             value
+                           end
+        process_tree(tags, key, normalized_value, **opts.merge(itemprop: iprop))
       end
     end
 
@@ -243,17 +269,18 @@ module MetaTags
     # @param [String, Symbol] name a Hash or a String to render as meta tag.
     # @param [String, Symbol] value text content or a symbol reference to
     # top-level meta tag.
+    # @param [String, Symbol] itemprop value of the itemprop attribute.
     #
-    def render_tag(tags, name, value, name_key: nil, value_key: :content)
+    def render_tag(tags, name, value, itemprop: nil)
       name_key ||= configured_name_key(name)
-      tags << Tag.new(:meta, name_key => name.to_s, value_key => value) if value.present?
+      tags << Tag.new(:meta, name_key => name.to_s, content: value, itemprop: itemprop) if value.present?
     end
 
     # Returns meta tag property name for a give meta tag based on the
     # configured list of property tags in MetaTags::Configuration#property_tags.
     #
-    # @param [String, Symbol] meta tag key.
-    # @return [String] meta tag attribute name ("property" or "name").
+    # @param [String, Symbol] name tag key.
+    # @return [Symbol] meta tag attribute name (:property or :name).
     #
     def configured_name_key(name)
       is_property_tag = MetaTags.config.property_tags.any? do |tag_name|

data/lib/meta_tags/tag.rb

@@ -11,7 +11,7 @@ module MetaTags
     # @param [Hash] attributes list of HTML tag attributes
     #
     def initialize(name, attributes = {})
-      @name = name
+      @name = name.to_s
       @attributes = attributes
     end