community_engine 2.0.0.beta1

data/app/helpers/base_helper.rb

@@ -0,0 +1,290 @@
+require 'digest/md5'
+
+# Methods added to this helper will be available to all templates in the application.
+module BaseHelper
+  include TagsHelper
+  
+  def commentable_url(comment)
+    if comment.commentable_type != "User"
+      polymorphic_url([comment.recipient, comment.commentable])+"#comment_#{comment.id}"
+    else
+      user_url(comment.recipient)+"#comment_#{comment.id}"
+    end
+  end
+  
+  def forum_page?
+    %w(forums topics sb_posts).include?(controller.controller_name)
+  end
+  
+  def is_current_user_and_featured?(u)
+    u && u.eql?(current_user) && u.featured_writer?
+  end
+  
+  def resize_img(classname, width=90, height=135)
+    "<style>
+      .#{classname} {
+        max-width: #{width}px;
+      }
+    </style>
+    <script type=\"text/javascript\">
+    	//<![CDATA[
+        Event.observe(window, 'load', function(){
+      		$$('img.#{classname}').each(function(image){
+      			CommunityEngine.resize_image(image, {max_width: #{width}, max_height:#{height}});
+      		});          
+        }, false);
+    	//]]>
+    </script>"
+  end
+
+  def rounded(options={}, &content)
+    options = {:class=>"box"}.merge(options)
+    options[:class] = "box " << options[:class] if options[:class]!="box"
+
+    str = '<div'
+    options.collect {|key,val| str << " #{key}=\"#{val}\"" }
+    str << '><div class="box_top"></div>'
+    str << "\n"
+    
+    concat(str)
+    yield(content)
+    concat('<br class="clear" /><div class="box_bottom"></div></div>')
+  end
+  
+  def block_to_partial(partial_name, html_options = {}, &block)
+    concat(render(:partial => partial_name, :locals => {:body => capture(&block), :html_options => html_options}))
+  end
+
+  def box(html_options = {}, &block)
+    block_to_partial('shared/box', html_options, &block)
+  end  
+    
+  def city_cloud(cities, classes)
+    max, min = 0, 0
+    cities.each { |c|
+      max = c.users.size.to_i if c.users.size.to_i > max
+      min = c.users.size.to_i if c.users.size.to_i < min
+    }
+
+    divisor = ((max - min) / classes.size) + 1
+
+    cities.each { |c|
+      yield c, classes[(c.users.size.to_i - min) / divisor]
+    }
+  end
+
+  def truncate_words(text, length = 30, end_string = '...')
+    return if text.blank?
+    words = strip_tags(text).split()
+    string = words[0..(length-1)].join(' ') + (words.length > length ? end_string : '')
+    string.html_safe
+  end
+  
+  def truncate_words_with_highlight(text, phrase)
+    t = excerpt(text, phrase)
+    highlight truncate_words(t, 18), phrase
+  end
+
+  def excerpt_with_jump(text, end_string = ' ...')
+    return if text.blank?
+    doc = Hpricot( text )
+    paragraph = doc.at("p")
+    if paragraph
+      paragraph.to_html + end_string
+    else
+      truncate_words(text, 150, end_string) 
+    end
+  end
+
+  def page_title
+    divider = " | ".html_safe    
+    
+    app_base = configatron.community_name
+    tagline = " #{divider} #{configatron.community_tagline}"
+		title = app_base
+
+		case controller.controller_name
+			when 'base'
+        title += tagline
+      when 'pages'
+        if @page and @page.title
+          title = @page.title + divider + app_base + tagline
+        end
+			when 'posts'
+        if @post and @post.title
+          title = @post.title + divider + app_base + tagline
+          title += (@post.tags.empty? ? '' : "#{divider}#{:keywords.l}: " + @post.tags[0...4].join(', ') )
+          @canonical_url = user_post_url(@post.user, @post)
+        end
+      when 'users'
+        if @user && !@user.new_record? && @user.login 
+          title = @user.login
+          title += divider + app_base + tagline
+          @canonical_url = user_url(@user)          
+        else
+          title = :showing_users.l+divider + app_base + tagline
+        end
+      when 'photos'
+        if @user and @user.login
+          title = :users_photos.l(:user => @user.login) + divider + app_base + tagline
+        end
+      when 'clippings'
+        if @user and @user.login
+          title = :user_clippings.l(:user => @user.login) + divider + app_base + tagline
+        end
+      when 'tags'
+        case controller.action_name
+          when 'show'
+            if params[:type]
+              title = I18n.translate('all_' + params[:type].downcase.pluralize + '_tagged', :tag_name => @tags.map(&:name).join(', '))
+            else
+              title = :posts_photos_and_bookmarks.l(:name => @tags.map(&:name).join(', '))
+            end
+            title += " (#{:related_tags.l}: #{@related_tags.join(', ')})" if @related_tags
+            title += divider + app_base    
+            @canonical_url = tag_url(URI.escape(@tags_raw, /[\/.?#]/)) if @tags_raw
+          else
+            title = "Showing tags #{divider} #{app_base} #{tagline}"
+          end
+      when 'categories'
+        if @category and @category.name
+          title = :posts_photos_and_bookmarks.l(:name => @category.name) + divider + app_base + tagline
+        else
+          title = :showing_categories.l + divider + app_base + tagline            
+        end
+      when 'sessions'
+        title = :login.l + divider + app_base + tagline            
+    end
+
+    if @page_title
+      title = @page_title + divider + app_base + tagline
+    elsif title == app_base          
+		  title = :showing.l + ' ' + controller.controller_name + divider + app_base + tagline
+    end
+
+    title
+  end
+
+  def add_friend_link(user = nil)
+		html = "<span class='friend_request' id='friend_request_#{user.id}'>"
+    html += link_to_remote :request_friendship.l,
+				{:update => "friend_request_#{user.id}",
+					:loading => "$$('span#friend_request_#{user.id} span.spinner')[0].show(); $$('span#friend_request_#{user.id} a.add_friend_btn')[0].hide()", 
+					:complete => visual_effect(:highlight, "friend_request_#{user.id}", :duration => 1),
+          500 => "alert('"+:sorry_there_was_an_error_requesting_friendship.l.gsub(/'/, "\\\\'")+"')",
+					:url => hash_for_user_friendships_url(:user_id => current_user.id, :friend_id => user.id), 
+					:method => :post }, {:class => "add_friend button"}
+		html +=	"<span style='display:none;' class='spinner'>"
+		html += image_tag 'spinner.gif', :plugin => "community_engine"
+		html += :requesting_friendship.l+" ...</span></span>"
+		html.html_safe
+  end
+
+  def topnav_tab(name, options)
+    classes = [options.delete(:class)]
+    classes << 'current' if options[:section] && (options.delete(:section).to_a.include?(@section))
+    
+    string = "<li class='#{classes.join(' ')}'>" + link_to( content_tag(:span, name), options.delete(:url), options) + "</li>"
+    string.html_safe
+  end
+  
+  def more_comments_links(commentable)
+    html = link_to "&raquo; ".html_safe + :all_comments.l, commentable_comments_url(commentable.class.to_s.tableize, commentable.to_param)
+    html += "<br />".html_safe
+		html += link_to "&raquo; ".html_safe + :comments_rss.l, commentable_comments_url(commentable.class.to_s.tableize, commentable.to_param, :format => :rss)
+		html.html_safe
+  end
+    
+  def show_footer_content?
+    return true #you can override this in your app
+  end
+  
+  def clippings_link
+    "javascript:(function() {d=document, w=window, e=w.getSelection, k=d.getSelection, x=d.selection, s=(e?e():(k)?k():(x?x.createRange().text:0)), e=encodeURIComponent, document.location='#{home_url}new_clipping?uri='+e(document.location)+'&title='+e(document.title)+'&selection='+e(s);} )();"    
+  end
+  
+  def paginating_links(paginator, options = {}, html_options = {})
+    paginate paginator
+  end  
+  
+  def last_active
+    session[:last_active] ||= Time.now.utc
+  end
+    
+  def ajax_spinner_for(id, spinner="spinner.gif")
+    "<img src='/assets/#{spinner}' style='display:none; vertical-align:middle;' id='#{id.to_s}_spinner'> ".html_safe
+  end
+
+  def avatar_for(user, size=32)
+    image_tag user.avatar_photo_url(:medium), :size => "#{size}x#{size}", :class => 'photo'
+  end
+
+  def feed_icon_tag(title, url)
+    (@feed_icons ||= []) << { :url => url, :title => title }
+    link_to image_tag('feed.png', :size => '14x14', :alt => :subscribe_to.l+" #{title}", :plugin => 'community_engine'), url
+  end
+
+  def search_posts_title
+    (params[:q].blank? ? :recent_posts.l : :searching_for.l+" '#{h params[:q]}'").tap do |title|
+      title << " by #{h User.find(params[:user_id]).display_name}" if params[:user_id]
+      title << " in #{h Forum.find(params[:forum_id]).name}"       if params[:forum_id]
+    end
+  end
+
+  def search_user_posts_path(rss = false)
+    options = params[:q].blank? ? {} : {:q => params[:q]}
+    options[:format] = :rss if rss
+    [[:user, :user_id], [:forum, :forum_id]].each do |(route_key, param_key)|
+      return send("#{route_key}_sb_posts_path", options.update(param_key => params[param_key])) if params[param_key]
+    end
+    options[:q] ? search_all_sb_posts_path(options) : send("all_#{prefix}sb_posts_path", options)
+  end
+
+  def time_ago_in_words(from_time, to_time = Time.now, include_seconds = false)
+    from_time = from_time.to_time if from_time.respond_to?(:to_time)
+    to_time = to_time.to_time if to_time.respond_to?(:to_time)
+    distance_in_minutes = (((to_time - from_time).abs)/60).round
+      
+    case distance_in_minutes
+      when 0              then :a_few_seconds_ago.l
+      when 1..59          then :minutes_ago.l(:count => distance_in_minutes)
+      when 60..1440       then :hours_ago.l(:count => (distance_in_minutes.to_f / 60.0).round)
+      when 1440..2880     then :days_ago.l(:count => (distance_in_minutes.to_f / 1440.0).round) # 1.5 days to 2 days
+      else I18n.l(from_time, :format => :time_ago)
+    end
+  end
+
+  def time_ago_in_words_or_date(date)
+    if date.to_date.eql?(Time.now.to_date)
+      display = I18n.l(date.to_time, :format => :time_ago)
+    elsif date.to_date.eql?(Time.now.to_date - 1)
+      display = :yesterday.l
+    else
+      display = I18n.l(date.to_date, :format => :date_ago)
+    end
+  end
+  
+  def profile_completeness(user)
+    segments = [
+      {:val => 2, :action => link_to(:upload_a_profile_photo.l, edit_user_path(user, :anchor => 'profile_details')), :test => !user.avatar.nil? },
+      {:val => 1, :action => link_to(:tell_us_about_yourself.l, edit_user_path(user, :anchor => 'user_description')), :test => !user.description.blank?},      
+      {:val => 2, :action => link_to(:select_your_city.l, edit_user_path(user, :anchor => 'location_chooser')), :test => !user.metro_area.nil? },            
+      {:val => 1, :action => link_to(:tag_yourself.l, edit_user_path(user, :anchor => "user_tags")), :test => user.tags.any?},                  
+      {:val => 1, :action => link_to(:invite_some_friends.l, new_invitation_path), :test => user.invitations.any?}
+    ]
+    
+    completed_score = segments.select{|s| s[:test].eql?(true)}.sum{|s| s[:val]}
+    incomplete = segments.select{|s| !s[:test] }
+    
+    total = segments.sum{|s| s[:val] }
+    score = (completed_score.to_f/total.to_f)*100
+
+    {:score => score, :incomplete => incomplete, :total => total}
+  end
+  
+
+  def possesive(user)
+    user.gender ? (user.male? ? :his.l : :her.l)  : :their.l    
+  end
+
+end

data/app/helpers/forums_helper.rb

@@ -0,0 +1,31 @@
+module ForumsHelper
+  
+  # used to know if a topic has changed since we read it last
+  def recent_topic_activity(topic)
+    return false if not logged_in?
+    return false unless last_active || session[:topics]
+    
+    return topic.replied_at > (last_active || session[:topics][topic.id])
+  end 
+  
+  # used to know if a forum has changed since we read it last
+  def recent_forum_activity(forum)
+    return false unless logged_in? && forum.topics.first
+    return false unless last_active || session[:forums]
+     
+    return forum.topics.order("replied_at desc").first.replied_at > (last_active || session[:forums][forum.id])
+  end
+  
+  def icon_and_color_and_post_for(topic)
+    icon = "comment"
+    color = ""
+    post = ''
+    if topic.locked?
+      icon = "lock" 
+      post = ", "+:this_topic_is_locked.l
+      color = "darkgrey"
+    end  
+    [icon, color, post  ]
+  end
+  
+end

data/app/helpers/friendships_helper.rb

@@ -0,0 +1,16 @@
+module FriendshipsHelper
+
+  def friendship_control_links(friendship)
+    html = case friendship.friendship_status_id
+      when FriendshipStatus[:pending].id
+        "#{(link_to(:accept.l, accept_user_friendship_path(friendship.user, friendship), :method => :put, :class => 'button positive') unless friendship.initiator?)} #{link_to(:deny.l, deny_user_friendship_path(friendship.user, friendship), :method => :put, :class => 'button negative')}"
+      when FriendshipStatus[:accepted].id
+        "#{link_to(:remove_this_friend.l, deny_user_friendship_path(friendship.user, friendship), :method => :put, :class => 'button negative')}"
+      when FriendshipStatus[:denied].id
+    		"#{link_to(:accept_this_request.l, accept_user_friendship_path(friendship.user, friendship), :method => :put, :class => 'button positive')}"
+    end
+    
+    html.html_safe
+  end
+
+end

data/app/helpers/monitorships_helper.rb

@@ -0,0 +1,2 @@
+module MonitorshipsHelper
+end

data/app/helpers/posts_helper.rb

@@ -0,0 +1,17 @@
+module PostsHelper
+
+  # The ShareThis widget defines a bunch of attributes you can customize.
+  # Facebook seems to ignore them (it uses title and description meta tags
+  # instead).  MySpace, however, only works if you set these attributes.
+  def sharethis_options(post)
+    content_tag :script, :type=>"text/javascript" do   
+      <<-eos
+	SHARETHIS.addEntry({
+		title:'#{escape_javascript(post.title)}',
+                content:'#{escape_javascript(truncate_words(post.post, 75, '...' ))}'
+	}, {button:true});
+      eos
+    end
+  end
+
+end

data/app/helpers/sitemap_helper.rb

@@ -0,0 +1,7 @@
+module SitemapHelper
+
+  def w3c_date(date)
+     date.utc.strftime("%Y-%m-%dT%H:%M:%S+00:00")
+  end
+
+end

data/app/helpers/users_helper.rb

@@ -0,0 +1,6 @@
+module UsersHelper
+  def friends?(user, friend)
+    Friendship.friends?(user, friend)
+  end    
+      
+end

data/app/models/ad.rb

@@ -0,0 +1,43 @@
+class Ad < ActiveRecord::Base
+  FREQUENCIES = 1..10
+  AUDIENCES = %w(all logged_in logged_out)
+
+  validates_presence_of :html
+  validates_inclusion_of :audience, :in => AUDIENCES
+  validates_inclusion_of :frequency, :in => FREQUENCIES  
+  
+  def self.display(location, logged_in = false)
+    return nil if location.blank?
+    ads = find(:all, 
+      :conditions => ["location = ? 
+        AND published = ? 
+        AND (time_constrained = ? OR (start_date > ? AND end_date < ?))
+        AND (audience IN (?) )", 
+        location.to_s, true, false, Time.now, Time.now, audiences_for(logged_in) ])
+        
+    ad = random_weighted(ads.map{|a| [a, a.frequency] })
+    ad ? ad.html.html_safe : ''
+  end
+    
+  def self.audiences_for(logged_in)
+    ["all", "logged_#{logged_in ? 'in' : 'out'}"]
+  end
+  
+  def self.frequencies_for_select
+    FREQUENCIES.map{|f| [f, f.to_s]}
+  end
+  
+  def self.audiences_for_select
+    AUDIENCES.map{|a| [a, a.to_s]}
+  end  
+  
+  def self.random_weighted(items)
+    total = 0
+    pick = nil
+    items.each do |item, weight|
+      pick = item if rand(total += weight) < weight
+    end
+    pick
+  end    
+
+end

data/app/models/album.rb

@@ -0,0 +1,12 @@
+class Album < ActiveRecord::Base
+  has_many :photos, :dependent => :destroy
+  belongs_to :user
+  validates_presence_of :user_id
+  acts_as_activity :user
+  acts_as_commentable
+  validates_presence_of :title  
+
+  def owner
+    self.user
+  end
+end

data/app/models/asset.rb

@@ -0,0 +1,3 @@
+class Asset < ActiveRecord::Base
+  belongs_to :attachable, :polymorphic => true  
+end

data/app/models/authorization.rb

@@ -0,0 +1,60 @@
+class Authorization < ActiveRecord::Base
+  belongs_to :user
+  validates_presence_of :user_id, :uid, :provider
+  validates_uniqueness_of :uid, :scope => :provider
+  validates_associated :user
+  before_destroy :allow_destroy?
+
+  def self.find_or_create_from_hash(hash, existing_user = nil)
+    if (auth = find_from_hash(hash))
+      auth.assign_account_info(hash)
+      auth.save
+      auth
+    else
+      create_from_hash(hash, existing_user)
+    end
+  end
+  
+  def self.create_from_hash(hash, existing_user = nil)
+    create do |authorization|
+      authorization.assign_account_info(hash)
+      authorization.find_or_create_or_associate_user(existing_user)
+    end    
+  end
+  
+  def self.find_from_hash(hash)    
+    find_by_provider_and_uid(hash['provider'], hash['uid'])
+  end
+
+  def find_or_create_or_associate_user(existing_user = nil)
+    if existing_user
+      self.user = existing_user
+    elsif self.user 
+      self.user
+    else
+      self.user = User.find_or_create_from_authorization(self)      
+    end
+  end
+  
+  
+  def allow_destroy?
+    if user.authorizations.count.eql?(1)    
+      errors.add(:base, "You must have at least one authorization provider.") 
+      raise ActiveRecord::Rollback    
+    end
+  end
+  
+  def assign_account_info(auth_hash)
+    self.uid                 = auth_hash['uid']
+    self.provider            = auth_hash['provider']
+    self.nickname            = auth_hash['user_info']['nickname']
+    self.email               = auth_hash['user_info']['email']    
+    self.picture_url         = auth_hash['user_info']['image']
+    self.name                = auth_hash['user_info']['name']
+    if auth_hash['credentials']
+      self.access_token        = auth_hash['credentials']['token']
+      self.access_token_secret = auth_hash['credentials']['secret']
+    end
+  end  
+
+end

data/app/models/category.rb

@@ -0,0 +1,20 @@
+class Category < ActiveRecord::Base
+  has_many :posts, :order => "published_at desc"
+
+  def to_param
+    id.to_s << "-" << (name ? name.parameterize : '' )
+  end
+  
+  def slug
+    name.parameterize.downcase
+  end
+
+  def self.get(name)
+    self.find_by_name(name.to_s.humanize)
+  end
+  
+  def display_new_post_text
+    new_post_text
+  end
+  
+end

data/app/models/choice.rb

@@ -0,0 +1,13 @@
+class Choice < ActiveRecord::Base
+  belongs_to :poll
+  validates_presence_of :poll
+  validates_presence_of :description
+  has_many :votes, :dependent => :destroy
+  
+  def votes_percentage(precision = 1)
+    total_votes = poll.votes.count    
+    percentage = total_votes.eql?(0) ? 0 : ((votes.count.to_f/total_votes.to_f)*100)
+    "%01.#{precision}f" % percentage
+  end
+  
+end

data/app/models/clipping.rb

@@ -0,0 +1,78 @@
+class Clipping < ActiveRecord::Base
+
+  acts_as_commentable
+  belongs_to :user
+  validates_presence_of :user
+  validates_presence_of :url
+  validates_presence_of :image_url
+
+  before_validation :add_image
+  validates_associated :image
+  validates_presence_of :image
+  after_save :save_image
+  
+  has_one  :image, :as => :attachable, :class_name => "ClippingImage", :dependent => :destroy
+  has_many :favorites, :as => :favoritable, :dependent => :destroy
+  
+  acts_as_taggable
+  acts_as_activity :user
+    
+  scope :recent, :order => 'clippings.created_at DESC'    
+    
+    
+  def self.find_related_to(clipping, options = {})
+    options.reverse_merge!({:limit => 8, 
+        :order => 'created_at DESC',
+        :conditions => [ 'clippings.id != ?', clipping.id ]
+    })
+
+    limit(options[:limit]).order(options[:order]).where(options[:conditions]).tagged_with(clipping.tags.collect{|t| t.name })
+  end
+
+  def self.find_recent(options = {:limit => 5})
+    find(:all, :conditions => "created_at > '#{7.days.ago.iso8601}'", :order => "created_at DESC", :limit => options[:limit])
+  end
+
+  def previous_clipping
+    self.user.clippings.order('created_at DESC').where('created_at < ?', self.created_at).first
+  end
+  def next_clipping
+    self.user.clippings.where('created_at > ?', self.created_at).order('created_at ASC').first    
+  end
+
+  def owner
+    self.user
+  end
+  
+  def image_uri(size = '')
+    image && image.asset.url(size) || image_url
+  end
+  
+  def title_for_rss
+    description.empty? ? created_at.to_formatted_s(:long) : description
+  end
+
+  def has_been_favorited_by(user = nil, remote_ip = nil)
+    f = Favorite.find_by_user_or_ip_address(self, user, remote_ip)
+    return f
+  end
+  
+  def add_image
+    begin
+      clipping_image = ClippingImage.new
+      uploaded_data = clipping_image.data_from_url(self.image_url)
+      clipping_image.asset = uploaded_data
+      self.image = clipping_image
+    rescue
+      nil
+    end
+  end
+  
+  def save_image
+    if valid? && image
+      image.attachable = self
+      image.save
+    end
+  end
+
+end

data/app/models/clipping_image.rb

@@ -0,0 +1,9 @@
+class ClippingImage < Asset
+  include UrlUpload
+  
+  has_attached_file :asset, configatron.clipping.paperclip_options
+  validates_attachment_presence :asset
+  validates_attachment_content_type :asset, :content_type => configatron.clipping.validation_options.content_type
+  validates_attachment_size :asset, :less_than => configatron.clipping.validation_options.max_size.to_i.megabytes
+  
+end