engine/app/models/locomotive/snippet.rb

module Locomotive
  class Snippet

    include Locomotive::Mongoid::Document

    ## fields ##
    field :name
    field :slug
    field :template

    ## associations ##
    referenced_in :site, :class_name => 'Locomotive::Site'

    ## callbacks ##
    before_validation :normalize_slug
    after_save        :update_templates
    after_destroy     :update_templates

    ## validations ##
    validates_presence_of   :site, :name, :slug, :template
    validates_uniqueness_of :slug, :scope => :site_id

    ## behaviours ##
    attr_protected  :id
    attr_accessible :name, :slug, :template

    ## methods ##

    def to_presenter
      Locomotive::SnippetPresenter.new(self)
    end

    def as_json(options = {})
      self.to_presenter.as_json
    end

    protected

    def normalize_slug
      # TODO: refactor it
      self.slug = self.name.clone if self.slug.blank? && self.name.present?
      self.slug.permalink! if self.slug.present?
    end

    def update_templates
      return unless (self.site rescue false) # not run if the site is being destroyed

      pages = self.site.pages.any_in(:snippet_dependencies => [self.slug]).to_a

      pages.each do |page|
        self._change_snippet_inside_template(page.template.root)

        page.send(:_serialize_template)

        Page.without_callback(:save, :after, :update_template_descendants) do
          page.save(:validate => false)
        end
      end
    end

    def _change_snippet_inside_template(node)
      case node
      when Locomotive::Liquid::Tags::Snippet
        node.refresh(self) if node.slug == self.slug
      when Locomotive::Liquid::Tags::InheritedBlock
        _change_snippet_inside_template(node.parent) if node.parent
      end
      # Walk the children of this entry if they're available.
      if node.respond_to?(:nodelist)
        (node.nodelist || []).each do |child|
          self._change_snippet_inside_template(child)
        end
      end
    end

  end
end