page_meta 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: '098f9bb6d6f41562f414f69b57cb0e5ca6c77034'
-  data.tar.gz: 19a6825dbf0a33b5bdb2cd26b098f80230885ebe
+  metadata.gz: e9c07868edd3c003b06253874a088a2ea0bb00bd
+  data.tar.gz: d228a7a77ef36d2312c03bb0d7b2245872f44448
 SHA512:
-  metadata.gz: b4ca261f7b9ce10155844b32b1d77d470f5f8cce17b71678a114ebc7bdb074d56b8e3b5b2c2f8e6dff7e2d28a4e758028d46e5d33d469d1d0f19ba7658d46ea1
-  data.tar.gz: c330695fe010a45597362f7b26b4b7c16cf6fb5e1f2858296b19b510c637f4f31888fe67e59349c6457f83f09eb4068737f722c9927bd1f8552221295ade3d42
+  metadata.gz: 51d00356fd9df12fcd14867e5bf158f9fa04cf1dbd66d1b20105a8fdeac5e8692fb765c3dc84bd319b8d246aa073345749cf5a7d490fc36dad78c23e05faddae
+  data.tar.gz: 181ead8af4434898b10f609784abecd295f5f098fcf333647997d556ce6b236473e7000bdf8e1bc0d4e2fbe5b661c207470041a3b406fb8fc488c2338479d4d1

data/README.md

@@ -180,6 +180,17 @@ To render all tags, just do something like this:
 </html>
 ```
 
+#### Rendering titles and descriptions
+
+You may want to render title and description on your page. In this case, you may use something like this:
+
+```erb
+<h1><%= page_meta.title.simple %></h1>
+<p><%= page_meta.description.simple %></p>
+```
+
+If your description contains HTML, you can use `page_meta.description(html: true).simple` instead. It will use Rails' `html_safe` helpers to safely retrieve the translation, just like regular Rails would do. [Please read Rails docs](http://guides.rubyonrails.org/i18n.html#using-safe-html-translations) for more info.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/page_meta/base.rb

@@ -10,6 +10,7 @@ module PageMeta
 
     def initialize(controller)
       @controller = controller
+      @description = {}
       @store = {}
     end
 
@@ -33,8 +34,8 @@ module PageMeta
       @title ||= Translator.new(:titles, naming, store)
     end
 
-    def description
-      @description ||= Translator.new(:descriptions, naming, store)
+    def description(html: false)
+      @description[html] ||= Translator.new(:descriptions, naming, store.merge(html: html))
     end
 
     def keywords

data/lib/page_meta/translator.rb

@@ -2,24 +2,32 @@
 
 module PageMeta
   class Translator
-    attr_reader :scope, :naming, :options
+    include ::ActionView::Helpers::TranslationHelper
+
+    attr_reader :scope, :naming, :options, :html
 
     def initialize(scope, naming, options = {})
       @scope = scope
       @naming = naming
+      @html = options[:html]
       @options = options
     end
 
     def to_s
       return "" if simple.blank?
-      I18n.t("page_meta.#{scope}.base", value: simple, default: simple)
+      t("page_meta.#{scope}.base", value: simple, default: simple)
+    end
+
+    def translation_scope
+      "page_meta.#{scope}.#{naming.controller}.#{naming.action}"
     end
 
     def simple
-      I18n.t(
-        "page_meta.#{scope}.#{naming.controller}.#{naming.action}",
-        options.merge(default: "")
-      )
+      override_options = options.merge(default: "")
+
+      translation = t("#{translation_scope}_html", override_options) if html
+      translation = t(translation_scope, override_options) if translation.blank?
+      translation
     end
   end
 end

data/lib/page_meta/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PageMeta
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: page_meta
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Nando Vieira
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-21 00:00:00.000000000 Z
+date: 2017-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails