spree_wordsmith 0.1.0

data/README.markdown

@@ -0,0 +1,121 @@
+Wordsmith 2.0
+=========
+
+A blog/cms extension for spree. Admin users in Spree can create blog posts and static pages. The comment system has been outsourced using the Disqus system. Posts and pages can have commenting disabled allowing the site to work without the Disqus api enabled.
+
+Wordsmith has provided the basic views and a stylesheet that can easily be overridden in your site extension. Also several helpers exist to allow tags, posts and pages to be accesible in your site views.
+
+Wordsmith uses concepts from many projects and tries to integrate them nicely with Spree making it easy to use the extension in your own site.
+
+
+Installation
+------------
+
+'script/extension install git://github.com/tonkapark/spree-wordsmith.git'
+
+rake gems:install
+
+rake db:migrate
+
+All authors for the blog should be given a display name in the admin/users edit form. A new display_name field is added to the spree users table. 
+
+Edit preferences in wordsmith_extension.rb
+
+script/server
+
+Setup
+------
+
+in wordsmith_extension.rb add your disqus account identifier if you plan to use comments.
+
+You can edit the preferences in the extension.rb file or in the http://localhost:3000/admin/wordsmith_settings ui.
+
+The blog home slug requires a server restart so it can only be edited in the extension file.
+
+Wordsmith adds a new column to the users model, display_name. For each admin user that will be blogging a display_name should be given. This can be used for display as the post author. The display_name field is made available only on the admin user view by default but could easily be extended to the public user views.
+
+
+Posts
+-------
+
+New Posts can be created in the admin section http://localhost:3000/admin/posts
+
+Posts have unique permalinks created for all new post entries. The permalink can be modified after initial save.
+
+RedCloth is used for post formatting.
+
+is_taggable gem is used for adding tags to each post. A helper linked_tag_list is provided to display a list of the link tags to filter by.
+
+
+Comments
+--------
+
+Comments can be opened or closed for a post or page.  The comment form displays on the post page when enabled for the specific post.
+
+Comments are now managed by Disqus via the disqus gem, http://github.com/norman/disqus/. Management of spam and comment moderation is done through the disqus ui.
+
+Create disqus account at http://disqus.com/.  
+
+
+Blog
+-----
+
+View the blog at http://localhost:3000/blog or the defined slug from the preferences.
+
+Use helper post_link_list(limit) to get a list of recent post links.
+
+Views are in folder extension/app/views/posts
+
+
+RSS
+-----
+
+http://localhost:3000/blog.rss - All Posts
+
+Customize RSS feed in extension/app/views/posts/index.rss.builder
+
+
+Pages
+-----
+
+Integrated portions of spree-static-content, http://peterberkenbosch.github.com/spree-static-content/
+
+Under Admin section add pages for static-content.
+
+Use helper page_link() to print a link to page, based on ID or Permalink.
+
+Pages are displayed by the content route provided by Spree core. Customize the extension/app/views/content/show.html.erb file.
+
+
+
+Tips
+--------
+
+You can add a blog link anywhere on your site or include the recent_articles partial.
+
+One option is to add the Blog link to the store_menu partial
+
+'<li><%= link_to t('blog'), posts_path %></li>'
+
+Use the wordsmith_content_for partial to include the wordsmith css and recent articles partial in the sidebar.
+
+'<%= render :partial => 'shared/wordsmith_content_for'%>'
+
+
+
+TODO
+-----
+
+- improve permalinks for posts
+
+- wysiwyg editor for blog posts and pages.
+
+- tests
+
+- store and save links (aka blogroll)
+
+
+Credits
+-------
+
+created by [Matt Anderson](http://tonkapark.com/)

data/app/controllers/admin/pages_controller.rb

@@ -0,0 +1,22 @@
+class Admin::PagesController < Admin::BaseController
+  resource_controller
+  
+  def new
+    @page = Page.new(:user_id => current_user.id)    
+    @page.is_active = Spree::Config[:wordsmith_page_status_default]
+    @page.commentable = Spree::Config[:wordsmith_page_comment_default]
+    
+    respond_to do |format|
+      format.html
+    end
+  end  
+  
+  update.response do |wants|
+    wants.html { redirect_to collection_url }
+  end
+
+  create.response do |wants|
+    wants.html { redirect_to collection_url }
+  end
+    
+end

data/app/controllers/admin/posts_controller.rb

@@ -0,0 +1,20 @@
+class Admin::PostsController < Admin::BaseController
+  resource_controller :except => [:show]
+
+  def new
+    @post = Post.new(:user_id => current_user.id)    
+    @post.is_active = Spree::Config[:wordsmith_post_status_default]
+    @post.commentable = Spree::Config[:wordsmith_post_comment_default]
+
+    respond_to do |format|
+      format.html
+    end
+  end
+
+  def edit
+    @post = Post.find(params[:id])
+  end
+
+  create.wants.html {redirect_to admin_posts_path}
+  update.wants.html {redirect_to admin_posts_path}
+end 

data/app/controllers/admin/wordsmith_settings_controller.rb

@@ -0,0 +1,13 @@
+class Admin::WordsmithSettingsController < Admin::BaseController
+
+  def update
+    Spree::Config.set(params[:preferences])
+    
+    respond_to do |format|
+      format.html {
+        redirect_to admin_wordsmith_settings_path
+      }
+    end
+  end
+  
+end 

data/app/controllers/pages_controller.rb

@@ -0,0 +1,19 @@
+class PagesController < Spree::BaseController  
+
+  resource_controller
+  actions :show, :index
+
+  index.before do
+    @pages = Page.listed_pages
+    response do |wants|
+      wants.html
+    end
+  end
+
+  show.before do
+    @page = Page.find(params[:id])
+    response do |wants|
+      wants.html
+    end
+  end
+end

data/app/controllers/posts_controller.rb

@@ -0,0 +1,30 @@
+class PostsController < Spree::BaseController  
+
+  resource_controller
+  actions :show, :index
+
+  index.response do |wants|
+    wants.html
+    wants.rss
+  end
+
+  show.response do |wants|
+    wants.html
+  end
+
+  def tags
+      @posts = Post.publish.find_all_tagged_with(params[:tag_name]).paginate :page => params[:page]    
+  end
+    
+private
+  def collection
+    @collection ||= end_of_association_chain.publish.paginate :page => params[:page]
+  end
+  
+  def object
+    @object ||= end_of_association_chain.publish.find(param) unless param.nil?
+    @object
+  end
+  
+
+end 

data/app/helpers/wordsmith_helper.rb

@@ -0,0 +1,21 @@
+module WordsmithHelper 
+  
+  def linked_tag_list(tags)
+    tags.collect {|tag| link_to(tag.name, tag_posts_url(:tag_name => tag.name ))}.join(", ")
+  end
+  
+  def post_link_list(limit = Spree::Config[:wordsmith_posts_recent])
+    link = Struct.new(:name,:url)
+    Post.publish.find(:all, :limit => limit).collect { |post| link.new(post.title, post_path(post)) }
+  end
+  
+  def page_link(id)
+    if id.kind_of?(String)  
+      page = Page.publish.find_by_permalink(id)
+    elsif id.kind_of?(Fixnum)
+      page = Page.publish.find(id)
+    end
+    link_to page.title, page.link unless page.nil?
+  end
+  
+end 

data/app/models/ability_decorator.rb

@@ -0,0 +1,23 @@
+class AbilityDecorator
+  include CanCan::Ability
+
+  def initialize(user)
+    can :index, Page
+    can :read, Page do |page|
+      page.published_at || user.has_role?(:admin) || (page.user == user)
+    end
+    can :update, Page do |page|
+      user.has_role?(:admin) || (page.user == user)
+    end
+    can :index, Post
+    can :read, Post do |post|
+      post.published_at || user.has_role?(:admin) || (post.user == user)
+    end
+    can :update, Post do |post|
+      user.has_role?(:admin) || (post.user == user)
+    end
+  end
+end
+
+Ability.register_ability(AbilityDecorator)
+

data/app/models/page.rb

@@ -0,0 +1,4 @@
+class Page < WsItem
+
+  scope :listed_pages, lambda { where('published_at is not null').where(:list_page => true).order('order_number') }
+end

data/app/models/post.rb

@@ -0,0 +1,11 @@
+class Post < WsItem
+
+  validates_presence_of :body, :message => 'required'
+  
+  cattr_reader :per_page
+  @@per_page = Spree::Config[:wordsmith_posts_per_page]
+
+  scope :recent_first, lambda { order('published_at DESC') }
+  scope :published_posts, lambda { recent_first.where('published_at is not null') }
+  scope :recent_posts, lambda { published_posts.limit(5) }
+end

data/app/models/ws_item.rb

@@ -0,0 +1,80 @@
+require 'is_taggable'
+
+class WsItem < ActiveRecord::Base
+  attr_accessible :user_id, :title, :body_raw, :published_at, :is_active, :permalink, :tag_list, :excerpt, :commentable, :order_number, :list_page, :meta_keywords, :meta_description
+
+  is_taggable :tags
+  
+  belongs_to :user
+  
+  before_validation :format_markup
+  before_validation :generate_permalink
+  before_validation :published
+   
+  validates_presence_of :title, :message => 'required'
+  validates_uniqueness_of :permalink 
+  
+  default_scope :order => 'published_at DESC'
+  scope :publish, -> { where('published_at < ? and is_active = ?', Time.zone.now, 1) }
+  
+
+  #should be part of is_taggable
+  #pulled from http://github.com/gnugeek/is_taggable/commit/10b590865f0effeed20f00e3581a7aed8a6bd3b4
+  def self.find_all_tagged_with(tag_or_tags, conditions=[])
+    return [] if tag_or_tags.nil? || tag_or_tags.empty?
+    case tag_or_tags
+    when Array, IsTaggable::TagList
+      all(:include => ['tags', 'taggings'], :conditions => conditions ).select { |record| tag_or_tags.all? { |tag| record.tags.map(&:name).include?(tag) } } || []
+    else
+      all(:include => ['tags', 'taggings'], :conditions => conditions).select { |record| record.tags.map(&:name).include?(tag_or_tags)  } || []
+    end
+  end
+    
+  def format_markup
+    self.body = RedCloth.new(self.body_raw,[:sanitize_html, :filter_html]).to_html
+    
+    #~ if self.excerpt.blank?
+      #~ self.excerpt = self.body.gsub(/\<[^\>]+\>/, '')[0...50] + "..."
+    #~ else
+      #~ self.excerpt = self.excerpt.gsub(/\<[^\>]+\>/, '')
+    #~ end
+    
+  end
+  
+  def generate_permalink
+    self.permalink = self.title.dup if self.permalink.blank?
+    self.permalink.linkify!
+  end
+
+  def link
+    ensure_slash_prefix permalink
+  end
+  
+  def published
+    #self.published_at ||= Time.now unless self.is_active == 0
+    if self.is_active == 0
+      if !self.published_at.blank?
+          self.published_at = nil
+      end
+    else
+      if self.published_at.blank?
+          self.published_at = Time.now
+      end
+    end
+  end
+  
+  def month
+    published_at.strftime('%B %Y')
+  end
+  
+  def to_param
+    "#{id}-#{permalink}"
+  end
+  
+private
+
+  def ensure_slash_prefix(str)
+    str.index('/') == 0 ? str : '/' + str
+  end
+  
+end

data/app/stylesheets/wordsmith.less

@@ -0,0 +1,76 @@
+
+.posts {
+  .post {
+    border-bottom: solid 1px #ccc;
+  }
+}
+
+.post {
+  padding-bottom: 10px;
+  margin-bottom: 20px;
+  font-size: 14px;
+
+  .post-content {
+    p {
+      padding: 0 0 .5em 0;
+      margin: .5em 0 0;
+    }
+  }
+  h2.post-title {
+    margin: 0;
+    padding-bottom: 10px;
+    line-height: 1em;
+    text-transform: none;
+    a, a:visited {
+      color: #333;
+      text-decoration: none;
+      font-weight: normal;
+    }
+    a:hover {
+      color: #333;
+      text-decoration: underline;
+    }
+  }
+  .post-date {
+    margin: 0 0 .5em 0;
+    font-size: 11px;
+    padding: 0;
+    color: #a5a5a5;
+    a {
+      text-decoration: none;
+    }
+  }
+}
+
+.post {
+  .post-meta {
+    margin: 3px 0 1.5em 0;
+    font-size: 12px;
+    a {
+      color: #999999;
+      font-weight: normal;
+    }
+  }
+}
+
+
+#comments {
+  border-top: solid 5px #999;
+  padding-top: 10px;
+}
+
+.comment {
+  padding-top: 5px;
+  margin-bottom: 20px;
+  border-top: solid 1px #ccc;
+  p {
+    padding: 5px 0;
+  }
+  .meta {
+    span {
+      padding-left: 5px;
+      font-size: 11px;
+      color: #999;
+    }
+  }
+}