station 0.0.145 → 0.1.0

data/lib/nexmo_developer/app/models/blog/blogpost.rb

@@ -0,0 +1,68 @@
+class Blog::Blogpost
+  attr_accessor :title, :description, :thumbnail, :author, :published, :published_at,
+                :updated_at, :category, :tags, :link, :locale, :slug, :spotlight,
+                :filename, :content, :header_img_url
+
+  CLOUDFRONT_BLOG_URL    = 'https://d226lax1qjow5r.cloudfront.net/blog/'.freeze
+  DEFAULT_HEADER_IMG_URL = 'https://s3.eu-west-1.amazonaws.com/developer.vonage.com/vonage-logo-images/vonage-wide-logo.png'.freeze
+
+  def initialize(attributes)
+    @title        = attributes['title']
+    @description  = attributes['description']
+    @thumbnail    = attributes['thumbnail']    || ''
+    @published    = attributes['published']    || false
+    @published_at = attributes['published_at']
+    @updated_at   = attributes['updated_at']
+    @tags         = attributes['tags']         || []
+    @link         = attributes['link']         || ''
+    @filename     = attributes['filename']
+    @locale       = attributes['locale']       || 'en'
+    @outdated     = attributes['outdated']     || false
+    @spotlight    = attributes['spotlight']    || false
+
+    @author       = Blog::Author.new(attributes['author'] || {})  # TODO: DEFAULT AUTHOR
+    @category     = Blog::Category.new(attributes['category'])
+
+    @content        = ''
+    @header_img_url = build_header_img_url
+
+    @replacement_url  = attributes['replacement_url']
+  end
+
+  def self.build_blogpost_from_path(path, locale)
+    return if path.blank?
+
+    path = "#{Rails.configuration.blog_path}/blogposts/#{locale}/#{path}.md"
+
+    default_not_found_page(path) unless File.exist?(path)
+
+    document = File.read(path)
+
+    blogpost = new(BlogpostParser.build_show_with_locale(path, locale))
+    blogpost.content = Nexmo::Markdown::Renderer.new({}).call(document)
+
+    blogpost
+  end
+
+  def build_header_img_url
+    require 'net/http'
+    require 'addressable'
+
+    url = Addressable::URI.parse("#{Blog::Blogpost::CLOUDFRONT_BLOG_URL}blogposts/#{thumbnail.gsub('/content/blog/', '')}")
+
+    Net::HTTP.start(url.host, url.port) do |http|
+      if http.head(url.request_uri)['Content-Type'].start_with? 'image'
+        url
+      else
+        DEFAULT_HEADER_IMG_URL
+      end
+    end
+  end
+
+  def self.default_not_found_page(path)
+    # TODO: - default not found page
+    #  get '*unmatched_route', to: 'application#not_found'
+    #  is already taking care of any wrong route
+    "<h1>No such blog</h1><p>#{path}</p>"
+  end
+end

data/lib/nexmo_developer/app/models/blog/category.rb

@@ -0,0 +1,25 @@
+class Blog::Category
+  attr_reader   :name, :plural, :slug, :color
+  attr_accessor :blogposts
+
+  def initialize(attributes)
+    # attributes.each {|k, v| self.instance_variable_set("@#{k}", v)}
+
+    @name   = attributes['name']
+    @plural = attributes['plural']
+    @slug   = attributes['slug']
+    @color  = attributes['color']
+
+    @blogposts = []
+  end
+
+  def build_n_blogposts_by_category(blogposts_json, num = 0)
+    bp = blogposts_json.select { |b| b['category']['slug'].downcase == @slug.downcase }
+
+    bp = bp.first(num) if num.positive?
+
+    @blogposts = bp.map { |b| Blog::Blogpost.new b }
+
+    self
+  end
+end

data/lib/nexmo_developer/app/services/author_parser.rb

@@ -0,0 +1,61 @@
+require 'json'
+
+class AuthorParser
+  PATH_TO_AUTHORS = "#{Rails.configuration.blog_path}/authors/".freeze
+
+  def self.fetch_all_authors
+    authors = {}
+
+    authors_folder_path = Dir.glob("#{PATH_TO_AUTHORS}*.json")
+
+    authors_folder_path.each do |filename|
+      document = File.read(filename)
+
+      author_hash = YAML.safe_load(document)
+
+      short_name = File.basename(filename, '.json')
+
+      author_hash.merge!({ 'short_name' => short_name })
+
+      authors[short_name.to_sym] = author_hash
+    end
+
+    authors
+  end
+
+  def self.fetch_author(name)
+    author_json_path = "#{PATH_TO_AUTHORS}#{name}.json"
+
+    return unless File.exist?(author_json_path)
+
+    file = File.read(author_json_path)
+
+    short_name = File.basename(author_json_path, '.json')
+
+    JSON.parse(file).merge!({ 'short_name' => short_name })
+  end
+
+  def self.fetch_all_blogposts_from(author)
+    blogposts_hash = JSON.parse(File.read(BlogpostParser::PATH_TO_INDEX))
+
+    blogposts_hash.select { |blogpost| blogpost['author'] == author }
+  end
+
+  def self.asset_exist?(path)
+    if Rails.configuration.assets.compile
+      Rails.application.precompiled_assets.include? path
+    else
+      Rails.application.assets_manifest.assets[path].present?
+    end
+  end
+end
+
+# :"abdul-ajetunmobi"=>
+# {"team"=>true,
+#  "name"=>"Abdul Ajetunmobi",
+#  "image_url"=>"https://github.com/abdulajet.png",
+#  "bio"=>
+# 	"Abdul is a Developer Advocate for Vonage. He has a background working in consumer products as an iOS Engineer. In his spare time, he enjoys biking, listening to music and mentoring those who are just beginning their journey in tech",
+#  "website_url"=>"https://abdulajet.me",
+#  "twitter"=>"abdulajet",
+#  "title"=>"Vonage Developer Advocate"},

data/lib/nexmo_developer/app/services/blogpost_parser.rb

@@ -0,0 +1,57 @@
+require 'json'
+
+class BlogpostParser
+  PATH_TO_INDEX = "#{Rails.configuration.blog_path}/blogposts/blogposts_info.json".freeze
+
+  def self.fetch_all
+    # Add Rescue from error
+    file = File.read(PATH_TO_INDEX)
+
+    JSON.parse(file)
+  end
+
+  def self.build
+    all_blogposts = []
+
+    ['en', 'cn', 'it'].each { |locale| all_blogposts += build_index_with_locale(locale) }
+
+    #   Sort by DATE
+    all_blogposts = all_blogposts.sort_by { |k| k['published_at'] }.reverse
+
+    #   Write content
+    File.write(PATH_TO_INDEX, JSON.pretty_generate(all_blogposts))
+  end
+
+  def self.build_index_with_locale(locale = 'en')
+    blogposts_locale_path = Dir.glob("#{ENV['BLOG_PATH']}/blogposts/#{locale}/*.md")
+
+    # TODO: - fix the issue with this blogpost
+    blogposts_locale_path -= ["#{Rails.configuration.blog_path}/blogposts/en/add-video-capabilities-to-zendesk-with-vonage-video-api.md"]
+
+    blogposts_locale_path.map { |filename| build_show_with_locale(filename, locale) }
+  end
+
+  def self.build_custom_attributes(frontmatter, filename, locale)
+    frontmatter.except!('comments', 'redirect', 'canonical', 'old_categories')
+
+    filename = File.basename(filename, '.md')
+    year, month, day = frontmatter['published_at'].strftime('%y %m %d').split
+
+    {
+      'locale' => locale,
+      'link' => "blog/#{locale == 'en' ? '' : "#{locale}/"}#{year}/#{month}/#{day}/#{filename}",
+      'filename' => File.basename(filename, '.md'),
+      'author' => AuthorParser.fetch_author(frontmatter['author']),
+      'category' => CategoryParser.fetch_category(frontmatter['category']),
+    }
+  end
+
+  def self.build_show_with_locale(filename, locale = 'en')
+    document = File.read(filename)
+
+    # body = Nexmo::Markdown::Renderer.new.call(document)
+    frontmatter = YAML.safe_load(document, [Time])
+
+    frontmatter.merge!(build_custom_attributes(frontmatter, filename, locale))
+  end
+end

data/lib/nexmo_developer/app/services/category_parser.rb

@@ -0,0 +1,19 @@
+require 'json'
+
+class CategoryParser
+  PATH_TO_CATEGORIES = "#{Rails.configuration.blog_path}/categories.json".freeze
+
+  def self.fetch_all_categories
+    JSON.parse(File.read(PATH_TO_CATEGORIES))['categories']
+  end
+
+  def self.fetch_category(slug)
+    fetch_all_categories.find { |c| c['slug'] == slug.downcase }
+  end
+
+  def self.fetch_blogposts_with_category(category)
+    blogposts_hash = JSON.parse(File.read(BlogpostParser::PATH_TO_INDEX))
+
+    blogposts_hash.select { |blogpost| blogpost['category'] == category }
+  end
+end

data/lib/nexmo_developer/app/services/tag_parser.rb

@@ -0,0 +1,38 @@
+require 'json'
+
+class TagParser
+  # PATH_TO_CATEGORIES = "#{Rails.configuration.blog_path}/categories.json"
+
+  # def self.fetch_all_categories
+  #   JSON.parse(File.read(PATH_TO_CATEGORIES))
+  # end
+
+  TAGS_WITH_ICON = [
+    'dispatch-api',
+    'messages-api',
+    'messages-api-sandbox',
+    'number-insight-api',
+    'number-api',
+    'reports-api',
+    'account-api',
+    'pricing-api',
+    'external-accounts-api',
+    'redact-api',
+    'audit-api',
+    'verify-api',
+    'media-api',
+    'voice-api',
+    'conversation-api',
+    'video-api',
+    'sms-api',
+    'station',
+    'spotlight',
+    'voyagers',
+  ].freeze
+
+  def self.fetch_blogposts_with_tag(tag)
+    blogposts_hash = JSON.parse(File.read(BlogpostParser::PATH_TO_INDEX))
+
+    blogposts_hash.select { |b| b['tags'].include?(tag) && b['published'] && !b['outdated'] }
+  end
+end

data/lib/nexmo_developer/app/views/blog/authors/_social_links.html.erb

@@ -0,0 +1,67 @@
+<div class="social-links">
+
+<% if author.website_url.present? %>
+  <%= link_to author.website_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-icons.svg#Vlt-icon-world"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.twitter.present? %>
+  <%= link_to "https://www.twitter.com/#{author.twitter}", target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-twitter-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.linkedin_url.present? %>
+  <%= link_to author.linkedin_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-linkedin-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.github_url.present? %>
+  <%= link_to author.github_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-github-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.youtube_url.present? %>
+  <%= link_to author.youtube_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-youtube-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.facebook_url.present? %>
+  <%= link_to author.facebook_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-facebook-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.twitch_url.present? %>
+  <%= link_to author.twitch_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-twitch-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+<% if author.stackoverflow_url.present? %>
+  <%= link_to author.stackoverflow_url, target: '_blank', rel: "noopener" do %>
+    <div class="Vlt-btn Vlt-btn--white Vlt-btn--icon">
+      <svg><use xlink:href="/symbol/volta-brand-icons.svg#Brand-icon-stackoverflow-color"/></svg>
+    </div>
+  <% end %>
+<% end %>
+
+</div>

data/lib/nexmo_developer/app/views/blog/authors/show.html.erb

@@ -0,0 +1,46 @@
+<div class="max-w-screen-xl mx-auto">
+
+  <div style="display: flex; justify-content: space-between">
+
+    <!-- Author -->
+    <div class="Vlt-card Vlt-bg-white" style="width:28%;height: fit-content;">
+      <div class="Vlt-card__image" style="background-image: url('<%= @author.url %>'); background-size: cover; min-height: 40vh; background-position: center;"></div>
+
+      <div class="Vlt-card__content">
+        <h2 class="Vlt-title--icon center-author-name">
+          <svg class="Vlt-icon Vlt-icon--larger">
+            <use xlink:href="/symbol/volta-icons.svg#Vlt-icon-pentool" />
+          </svg>
+          <%= @author.name %>
+        </h2>
+        
+        <p class="author-title"><code><small><%= @author.title %></small></code></p>
+
+        <p style="opacity:.8;font-weight: bold;">
+          <%= @author.bio if @author.bio.present? %>
+        </p>
+      </div>
+
+      <%= render partial: 'blog/authors/social_links', locals: { author: @author} %>
+    </div>
+
+    <!-- Blogposts -->
+    <div style="width:70%;">
+      <% unless @author.blogposts.count.positive? %>
+        <div class="Vlt-callout Vlt-callout--warning">
+          <div class="Vlt-callout__content">No Blogpost available</div>
+        </div>
+      <% else %>
+
+        <div class="my-3col-grid">
+          <% @author.blogposts.in_groups(2) do |blogposts| %>
+            <%= render partial: 'blog/blogpost/blogpost', collection: blogposts, as: :blogpost, 
+                  locals: { show_category_label: true, show_author: false, show_tag_labels: true } %>
+          <% end %>
+        </div>
+      
+      <% end %>
+    </div>
+  </div>
+
+</div>

data/lib/nexmo_developer/app/views/blog/blogpost/_blogpost.html.erb

@@ -0,0 +1,74 @@
+<% if blogpost %>
+  <% author   = blogpost.author %>
+  <% category = blogpost.category %>
+
+
+  <div class="Vlt-card Vlt-card--border d-flex-column">
+    
+    <!-- CATEGORY -->
+    <% if show_category_label %>
+      <a href="<%= blog_category_path(category.slug)%>" class="category-name" style="color: <%= category.color %>;padding:0 0 16px 0;">
+        < <%= category.name %> />
+      </a>
+    <% end %>
+
+    <!-- TOP TAGs label -->  
+    <%= render partial: 'blog/blogpost/tag_labels', locals: { blogpost: blogpost } %>
+
+    <!-- CONTENT -->  
+    <div class="blogpost_card_content">
+      <div class="">
+        <a href="/<%= blogpost.link %>">
+          <p class="p-large"><b><%= blogpost.title %></b></p>
+        </a>
+
+        <p><%= blogpost.description.truncate(150) %></p>
+      </div>
+
+
+      <!-- AUTHOR -->
+      <% if author && author.name && show_author %>
+        <div class="">
+          
+          <a href="/<%= blogpost.link %>" class="Vlt-blue-darker">
+            [<%= t('read_more') %>]
+          </a>
+
+          <hr class="hr--short">
+
+          <div style='display:flex; justify-content: flex-start;'>
+          
+            <% if author.image_url %>
+              <%= image_tag author.url, style: "display: block; width: 4.5rem; height: 4.5rem; border-radius: 50%;" %>
+            <% end %>
+          
+            <div style='margin-left: 1.5rem;'>
+              <h5>
+                <%= link_to author.name, blog_author_path(author.short_name) %>
+          
+                <p class='Vlt-grey-darker'><strong><%= Date.parse(blogpost.published_at).strftime('%b %d, %Y') %></strong></p>
+              </h5>
+            </div>
+            
+          </div>
+          
+        </div>
+
+      <% else %>
+      <!-- NO AUTHOR -->
+        <div class="">
+
+          <div style="display: flex;justify-content: space-between;">
+            <a href="/<%= blogpost.link %>" class="Vlt-blue-darker">
+              [<%= t('read_more') %>]
+            </a>
+            <p class='Vlt-grey-darker'><strong><%= Date.parse(blogpost.published_at).strftime('%b %d, %Y') %></strong></p>
+          </div>
+
+        </div>
+      <% end # if author && author.name && show_author %>
+
+    </div>
+  </div>
+
+<% end %>

data/lib/nexmo_developer/app/views/blog/blogpost/_blogpost_with_image.html.erb

@@ -0,0 +1,59 @@
+<% if blogpost %>
+  <% author   = blogpost.author %>
+  <% category = blogpost.category %>
+
+
+  <div class="Vlt-card Vlt-card--border Vlt-col d-flex-column" style="padding:0;">
+
+    <a href="/<%= blogpost.link %>" class="Vlt-blue-darker">
+      <div class="Vlt-card--border border-radius-top card-header-image" style="background-image: url(<%= blogpost.header_img_url %>);"></div>
+    </a>
+
+    <a href="<%= blog_category_path(category.slug)%>" class="category-name" style="color: <%= category.color %>">
+      < <%= category.name %> />
+    </a>
+
+    <div class="blogpost_card_content Vlt-card--lesspadding">
+      <div class="">
+        <a href="/<%= blogpost.link %>">
+          <p class="p-large"><b><%= blogpost.title %></b></p>
+        </a>
+
+        <p><%= blogpost.description %></p>
+      </div>
+
+
+
+      <% if author && author.name %>
+        <div class="card-footer">
+
+          <a href="/<%= blogpost.link %>" class="Vlt-blue-darker">
+            [<%= t('read_more') %>]
+          </a>
+
+          <hr class="hr--short">
+
+          <div style='display:flex; justify-content: flex-start;'>
+
+            <% if author.image_url %>
+              <%= image_tag author.url, class: "image-tag-author" %>
+            <% end %>
+
+            <div style='margin-left: 1.5rem;'>
+              <h5>
+                <%= link_to author.name, blog_author_path(author.short_name) %>
+
+                <p class='Vlt-grey-darker'>
+                  <strong><%= Date.parse(blogpost.published_at).strftime('%b %d, %Y') %></strong>
+                </p>
+              </h5>
+            </div>
+
+          </div>
+        </div>
+      <% end %>
+
+    </div>
+  </div>
+
+<% end %>

data/lib/nexmo_developer/app/views/blog/blogpost/_tag_labels.html.erb

@@ -0,0 +1,20 @@
+<% if blogpost.tags.count > 0 %>
+  <div style='margin-bottom: 1.5rem;'>
+    <% blogpost.tags.each do |tag| %>
+      <% next if tag.empty? %>
+        <a href="<%= blog_tag_path(tag.downcase)%>">
+          <small class="Vlt-badge Vlt-badge--<%= tag.downcase %> Vlt-badge--transparent">
+            <% if TagParser::TAGS_WITH_ICON.include? tag %>
+              <span class="fix-position-V-icon">
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="width: 1em;" class="Vlt-white">
+                  <path d="M9.3 11.6L4.7 1.5H0l6.8 15.3s.1.1.1 0l2.4-5.2zm9.9-10.1s-6.1 13.9-6.9 15.6c-1.8 4.1-3.2 5.1-4.6 5.3H12c1.9 0 3.2-1.3 5.1-5.3.6-1.4 6.9-15.6 6.9-15.6h-4.8z" />
+                </svg>
+              </span>
+            <% else %>
+              #
+            <% end %>
+          <%= tag == "Objective_C" ? "Objective-C" : tag.downcase %></small>
+        </a>
+    <% end %>
+  </div>
+<% end %>

data/lib/nexmo_developer/app/views/blog/blogpost/index.html.erb

@@ -0,0 +1,43 @@
+<% unless @categories_with_blogposts.present? %>
+
+  <div class="Vlt-callout Vlt-callout--warning">
+    <i></i>
+    <div class="Vlt-callout__content">
+      No Blogpost available
+    </div>
+  </div>
+
+<% else %>
+
+
+  <div class="max-w-screen-xl mx-auto">
+
+    <div class="header-separator hr--tall Vlt-text-separator Vlt-text-separator--big">
+      <span>LATEST POSTS</span>
+    </div>
+
+    <div class="my-2col-grid">
+        <%= render partial: 'blog/blogpost/blogpost_with_image', collection: @latest_blogposts, as: :blogpost %>
+    </div>
+
+
+  <% @categories_with_blogposts.each do |category| %>
+    
+    <div class="header-separator hr--tall Vlt-text-separator Vlt-text-separator--big">
+      <span>< <%= category.plural.upcase %> /></span>
+    </div>
+
+    <div class="my-3col-grid">
+      <% category.blogposts.compact.in_groups(3) do |blogposts| %>
+        <%# cache blogpost do %>
+        <%= render partial: 'blog/blogpost/blogpost', collection: blogposts, as: :blogpost, locals: { show_category_label: false, show_author: true } %>
+        <%# end %>
+      <% end %>
+    </div>
+
+  <% end # @categories_with_blogposts.each %> 
+
+  </div>
+
+
+<% end %>