lato_blog 2.1

data/app/jobs/lato_blog/application_job.rb

@@ -0,0 +1,4 @@
+module LatoBlog
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/lato_blog/application_mailer.rb

@@ -0,0 +1,6 @@
+module LatoBlog
+  class ApplicationMailer < ActionMailer::Base
+    default from: 'from@example.com'
+    layout 'mailer'
+  end
+end

data/app/models/lato_blog/application_record.rb

@@ -0,0 +1,5 @@
+module LatoBlog
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/lato_blog/category.rb

@@ -0,0 +1,119 @@
+module LatoBlog
+  class Category < ApplicationRecord
+
+    include Category::EntityHelpers
+    include Category::SerializerHelpers
+
+    # Validations:
+
+    validates :title, presence: true, length: { maximum: 250 }
+
+    validates :meta_permalink, presence: true, uniqueness: true,
+                               length: { maximum: 250 }
+    validates :meta_language, presence: true, length: { maximum: 250 },
+                              inclusion: { in: ([nil] + BLOG_LANGUAGES_IDENTIFIER) }
+
+    # Relations:
+
+    belongs_to :category_parent, foreign_key: :lato_blog_category_parent_id,
+                                 class_name: 'LatoBlog::CategoryParent'
+
+    belongs_to :superuser_creator, foreign_key: :lato_core_superuser_creator_id,
+                                   class_name: 'LatoCore::Superuser'
+
+    has_many :category_children, foreign_key: :lato_blog_category_id,
+                                 class_name: 'LatoBlog::Category',
+                                 dependent: :nullify
+    belongs_to :category_father, foreign_key: :lato_blog_category_id,
+                                 class_name: 'LatoBlog::Category',
+                                 optional: true
+
+    has_many :post_relations, foreign_key: :lato_blog_category_id,
+                              class_name: 'LatoBlog::CategoryPost',
+                              dependent: :destroy
+    has_many :posts, through: :post_relations
+
+    # Scopes:
+
+    scope :roots, -> { where(lato_blog_category_id: nil) }
+
+    # Callbacks:
+
+    before_validation :check_meta_permalink, on: :create
+
+    before_save do
+      self.meta_permalink = meta_permalink.parameterize
+      meta_language.downcase!
+
+      check_category_father_circular_dependency
+      check_category_father_language
+
+      check_lato_blog_category_parent
+    end
+
+    after_destroy do 
+      blog__clean_category_parents
+    end
+
+    private
+
+    # This function check if current permalink is valid. If it is not valid it
+    # generate a new from the post title.
+    def check_meta_permalink
+      candidate = (self.meta_permalink ? self.meta_permalink : self.title.parameterize)
+      accepted = nil
+      counter = 0
+
+      while accepted.nil?
+        if LatoBlog::Category.find_by(meta_permalink: candidate)
+          counter += 1
+          candidate = "#{candidate}-#{counter}"
+        else
+          accepted = candidate
+        end
+      end
+
+      self.meta_permalink = accepted
+    end
+
+    # This function check the category parent of the category do not create a circular dependency.
+    def check_category_father_circular_dependency
+      return unless self.lato_blog_category_id
+
+      all_children = self.get_all_category_children
+      same_children = all_children.select { |child| child.id === self.lato_blog_category_id }
+
+      if same_children.length > 0
+        errors.add('Category father', 'can not be a children of the category')
+        throw :abort
+      end
+    end
+
+    # This function check the chategory parent has the same language of the child.
+    def check_category_father_language
+      return unless self.lato_blog_category_id
+      if self.category_father.meta_language != self.meta_language
+        errors.add('Category father', 'must have the same language of the child')
+        throw :abort
+      end
+    end
+
+    # This function check that the category parent exist and has not others categories for the same language.
+    def check_lato_blog_category_parent
+      category_parent = LatoBlog::CategoryParent.find_by(id: lato_blog_category_parent_id)
+      if !category_parent
+        errors.add('Category parent', 'not exist for the category')
+        throw :abort
+        return
+      end
+
+      same_language_category = category_parent.categories.find_by(meta_language: meta_language)
+      if same_language_category && same_language_category.id != id
+        errors.add('Category parent', 'has another category for the same language')
+        throw :abort
+        return
+      end
+    end
+
+  end
+end

data/app/models/lato_blog/category/entity_helpers.rb

@@ -0,0 +1,55 @@
+module LatoBlog
+  module Category::EntityHelpers
+
+    # This function return the pretty name of the language of the category.
+    def get_pretty_language
+      CONFIGS[:lato_blog][:languages].values.each do |language|
+        return language[:title] if language[:identifier] === self.meta_language
+      end
+    end
+
+    # This function returns a pretty presentation of the creation date for the post.
+    def get_pretty_created_at
+      self.created_at.strftime('%d/%m/%Y - %H:%M')
+    end
+
+    # This function returns a pretty presentation of the update date for the post.
+    def get_pretty_updated_at
+      self.updated_at.strftime('%d/%m/%Y - %H:%M')
+    end
+
+    # This function returns the name of the superuser creator of the post.
+    def get_superuser_creator_name
+      self.superuser_creator ? self.superuser_creator.get_complete_name : 'Anonymous'
+    end
+
+    # This function return the title of the category father.
+    def get_category_father_title
+      self.category_father.title if self.category_father
+    end
+
+    # This function the post translation for a specific language.
+    def get_translation_for_language language_identifier
+      self.category_parent.categories.find_by(meta_language: language_identifier)
+    end
+
+    # This function return all category children of the current category.
+    def get_all_category_children
+      direct_children = self.category_children
+      all_children = []
+
+      direct_children.each do |direct_child|
+        all_children.push(direct_child)
+        all_children = all_children + direct_child.get_all_category_children
+      end
+
+      all_children
+    end
+
+    # This function return the number of posts of the category.
+    def get_number_of_posts
+      self.posts.length
+    end
+
+  end
+end

data/app/models/lato_blog/category/serializer_helpers.rb

@@ -0,0 +1,66 @@
+module LatoBlog
+  module Category::SerializerHelpers
+
+    # This function serializes a complete version of the category.
+    def serialize
+      serialized = {}
+
+      # set basic info
+      serialized[:id] = id
+      serialized[:title] = title
+      serialized[:meta_language] = meta_language
+      serialized[:meta_permalink] = meta_permalink
+
+      # add category father informations
+      serialized[:category_father] = category_father ? category_father.serialize_base : nil
+
+      # add category children informations
+      serialized[:category_children] = serialize_category_children
+
+      # add category parent informations
+      serialized[:other_informations] = serialize_other_informations
+
+      # return serialized post
+      serialized
+    end
+
+    # This function serializes a basic version of the category.
+    def serialize_base
+      serialized = {}
+
+      # set basic info
+      serialized[:id] = id
+      serialized[:title] = title
+      serialized[:meta_language] = meta_language
+      serialized[:meta_permalink] = meta_permalink
+
+      # return serialized category
+      serialized
+    end
+
+    private
+
+    def serialize_category_children
+      serialized = {}
+      category_children.each do |category|
+        serialized[category.id] = category.serialize_base
+      end
+      serialized
+    end
+
+    def serialize_other_informations
+      serialized = {}
+
+      # set translations links
+      serialized[:translations] = {}
+      category_parent.categories.each do |category|
+        next if category.id == id
+        serialized[:translations][category.meta_language] = category.serialize_base
+      end
+
+      # return serialzed informations
+      serialized
+    end
+
+  end
+end

data/app/models/lato_blog/category_parent.rb

@@ -0,0 +1,9 @@
+module LatoBlog
+  class CategoryParent < ApplicationRecord
+
+    # Relations:
+
+    has_many :categories, foreign_key: :lato_blog_category_parent_id, class_name: 'LatoBlog::Category', dependent: :destroy
+
+  end
+end

data/app/models/lato_blog/category_post.rb

@@ -0,0 +1,35 @@
+module LatoBlog
+  class CategoryPost < ApplicationRecord
+
+    # Validations:
+
+    validates :lato_blog_category_id, presence: true
+    validates :lato_blog_post_id, presence: true
+
+    # Relations:
+
+    belongs_to :category, foreign_key: :lato_blog_category_id, class_name: 'LatoBlog::Category'
+
+    belongs_to :post, foreign_key: :lato_blog_post_id, class_name: 'LatoBlog::Post'
+
+    # Callbacks:
+
+    before_save do
+      check_relation_language
+    end
+
+    after_save do
+      blog__sync_config_post_fields_with_db_post_fields_for_post(post)
+    end
+
+    private
+
+    def check_relation_language
+      if self.category.meta_language != self.post.meta_language
+        errors.add('Category and Post', 'have not same language')
+        throw :abort
+      end
+    end
+
+  end
+end

data/app/models/lato_blog/post.rb

@@ -0,0 +1,112 @@
+module LatoBlog
+  class Post < ApplicationRecord
+
+    include Post::EntityHelpers
+    include Post::SerializerHelpers
+
+    # Validations:
+
+    validates :title, presence: true, length: { maximum: 250 }
+
+    validates :meta_permalink, presence: true, uniqueness: true, length: { maximum: 250 }
+    validates :meta_status, presence: true, length: { maximum: 250 }, inclusion: { in: BLOG_POSTS_STATUS.values }
+    validates :meta_language, presence: true, length: { maximum: 250 }, inclusion: { in: ([nil] + BLOG_LANGUAGES_IDENTIFIER) }
+
+    # Relations:
+
+    belongs_to :post_parent, foreign_key: :lato_blog_post_parent_id,
+                             class_name: 'LatoBlog::PostParent'
+
+    belongs_to :superuser_creator, foreign_key: :lato_core_superuser_creator_id,
+                                   class_name: 'LatoCore::Superuser'
+
+    has_many :post_fields, foreign_key: :lato_blog_post_id,
+                           class_name: 'LatoBlog::PostField',
+                           dependent: :destroy
+
+    has_many :category_relations, foreign_key: :lato_blog_post_id,
+                                  class_name: 'LatoBlog::CategoryPost',
+                                  dependent: :destroy
+    has_many :categories, through: :category_relations
+
+    # Scopes:
+
+    scope :published, -> { where(meta_status: BLOG_POSTS_STATUS[:published]) }
+    scope :drafted, -> { where(meta_status: BLOG_POSTS_STATUS[:drafted]) }
+    scope :deleted, -> { where(meta_status: BLOG_POSTS_STATUS[:deleted]) }
+
+    # Callbacks:
+
+    before_validation :check_meta_permalink, on: :create
+
+    before_save do
+      self.meta_permalink = meta_permalink.parameterize
+      meta_status.downcase!
+      meta_language.downcase!
+
+      check_lato_blog_post_parent
+    end
+
+    after_save do
+      blog__sync_config_post_fields_with_db_post_fields_for_post(self)
+    end
+
+    after_create do
+      add_to_default_category
+    end
+
+    after_destroy do
+      blog__clean_post_parents
+    end
+
+    private
+
+    # This function check if current permalink is valid. If it is not valid it
+    # generate a new from the post title.
+    def check_meta_permalink
+      candidate = (meta_permalink ? meta_permalink : title.parameterize)
+      accepted = nil
+      counter = 0
+
+      while accepted.nil?
+        if LatoBlog::Post.find_by(meta_permalink: candidate)
+          counter = counter + 1
+          candidate = "#{candidate}-#{counter}"
+        else
+          accepted = candidate
+        end
+      end
+
+      self.meta_permalink = accepted
+    end
+
+    # This function check that the post parent exist and has not others post for the same language.
+    def check_lato_blog_post_parent
+      post_parent = LatoBlog::PostParent.find_by(id: lato_blog_post_parent_id)
+      if !post_parent
+        errors.add('Post parent', 'not exist for the post')
+        throw :abort
+        return
+      end
+
+      same_language_post = post_parent.posts.find_by(meta_language: meta_language)
+      if same_language_post && same_language_post.id != id
+        errors.add('Post parent', 'has another post for the same language')
+        throw :abort
+        return
+      end
+    end
+
+    # This function add the post to the default category.
+    def add_to_default_category
+      default_category_parent = LatoBlog::CategoryParent.find_by(meta_default: true)
+      return unless default_category_parent
+
+      category = default_category_parent.categories.find_by(meta_language: meta_language)
+      return unless category
+
+      LatoBlog::CategoryPost.create(lato_blog_post_id: id, lato_blog_category_id: category.id)
+    end
+
+  end
+end

data/app/models/lato_blog/post/entity_helpers.rb

@@ -0,0 +1,42 @@
+module LatoBlog
+  module Post::EntityHelpers
+
+    # This function returns a pretty presentation of the pubblication date for the post.
+    def get_pretty_publication_datetime
+      return self.post_parent.publication_datetime.strftime('%d/%m/%Y - %H:%M')
+    end
+
+    # This function returns a pretty presentation of the creation date for the post.
+    def get_pretty_created_at
+      return self.created_at.strftime('%d/%m/%Y - %H:%M')
+    end
+
+    # This function returns a pretty presentation of the update date for the post.
+    def get_pretty_updated_at
+      return self.updated_at.strftime('%d/%m/%Y - %H:%M')
+    end
+
+    # This function returns a pretty presentation of the post status.
+    def get_pretty_status
+      return LANGUAGES[:lato_blog][:posts_status][self.meta_status]
+    end
+
+    # This function returns a pretty presentation of the post language.
+    def get_pretty_language
+      CONFIGS[:lato_blog][:languages].values.each do |language|
+        return language[:title] if language[:identifier] === self.meta_language
+      end
+    end
+
+    # This function returns the name of the superuser creator of the post.
+    def get_superuser_creator_name
+      return self.superuser_creator ? self.superuser_creator.get_complete_name : 'Anonymous'
+    end
+
+    # This function the post translation for a specific language.
+    def get_translation_for_language(language_identifier)
+      return self.post_parent.posts.find_by(meta_language: language_identifier)
+    end
+
+  end
+end