bf4-browsercms 3.1.0

data/lib/browsercms.rb

@@ -0,0 +1,12 @@
+require 'cms/extensions'
+require 'cms/init'
+require 'cms/routes'
+require 'cms/caching'
+
+#Load libraries that are included with CMS
+require 'acts_as_list'
+ActiveRecord::Base.send(:include, ActsAsList)
+
+#Include CMS Behaviors
+ActiveRecord::Base.send(:include, Cms::Acts::ContentBlock)
+require 'cms/behaviors'

data/lib/cms/acts/content_block.rb

@@ -0,0 +1,31 @@
+module Cms
+  module Acts
+    module ContentBlock
+      def self.included(model_class)
+        model_class.extend(MacroMethods)
+      end
+      module MacroMethods
+        def acts_as_content_block(options={})
+          belongs_to_attachment(options[:belongs_to_attachment].is_a?(Hash) ? options[:belongs_to_attachment] : {}) if options[:belongs_to_attachment]
+          is_archivable(options[:archiveable].is_a?(Hash) ? options[:archiveable] : {}) unless options[:archiveable] == false
+          is_connectable(options[:connectable].is_a?(Hash) ? options[:connectable] : {}) unless options[:connectable] == false
+          flush_cache_on_change(options[:flush_cache_on_change].is_a?(Hash) ? options[:flush_cache_on_change] : {}) unless options[:flush_cache_on_change] == false
+          is_renderable({:instance_variable_name_for_view => "@content_block"}.merge(options[:renderable].is_a?(Hash) ? options[:renderable] : {})) unless options[:renderable] == false
+          is_publishable(options[:publishable].is_a?(Hash) ? options[:publishable] : {}) unless options[:publishable] == false
+          is_searchable(options[:searchable].is_a?(Hash) ? options[:searchable] : {}) unless options[:searchable] == false
+          uses_soft_delete(options[:soft_delete].is_a?(Hash) ? options[:soft_delete] : {}) unless options[:soft_delete] == false
+          is_taggable(options[:taggable].is_a?(Hash) ? options[:taggable] : {}) if options[:taggable]
+          is_userstamped(options[:userstamped].is_a?(Hash) ? options[:userstamped] : {}) unless options[:userstamped] == false  
+          is_versioned(options[:versioned].is_a?(Hash) ? options[:versioned] : {}) unless options[:versioned] == false
+        
+          include InstanceMethods
+        end
+        module InstanceMethods
+          def to_s
+            "#{self.class.name.titleize} '#{name}'"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cms/acts/content_page.rb

@@ -0,0 +1,69 @@
+#
+# Can be included into Controllers in your project to allow them to act as though they are CMS pages.
+# This means they can be:
+#
+#   1. Marked as having requiring permission as though they were in a particular section.
+#   2. Handle errors thrown from within the methods in the same way that CMS Pages do.
+#   3. Use CMS page templates as layouts (like TemplateSupport)
+#
+# This is intend to replace and deprecate TemplateSupport (which will be supported for a while for backwards compatibility)
+#
+# Minor Issue:
+#   Error handling for Page not found behaves slightly differently than ContentController currently. If the user is logged
+#   in as an editor, they will get a 500 page rather than 404. This would require reworking how the error processing
+#   works in Cms::ContentRenderingSupport. 
+module Cms
+  module Acts
+
+
+    module ContentPage
+
+      def self.included(base)
+        base.send :include, Cms::ContentRenderingSupport
+        base.send :include, Cms::Authentication::Controller
+        base.extend ClassMethods
+
+        base.helper Cms::PageHelper
+        base.helper Cms::RenderingHelper
+        base.helper Cms::MenuHelper
+      end
+
+      # Before filter that determines if the current user can access a specific section.
+      def check_access_to_section
+        user = current_user
+        logger.warn "Checking that current_user '#{user.login}' has access to view section with path '#{self.class.in_section}'."
+        unless user.able_to_view?(self.class.in_section)
+          store_location
+          raise Cms::Errors::AccessDenied
+        end
+      end
+
+      module ClassMethods
+
+        # Requires that some or all of the actions on this controller require the same permissions as a specific section of the website.
+        # Note that section paths aren't currently unique so the 'first' section found will be looked at.
+        #
+        # Params:
+        #   path - Should match the 'path' attribute for a given section.
+        #   options - Hash of options that will be passed to the before_filter call. See before_filter for valid options.
+        #
+        # Example:
+        #   MyController < ApplicationController
+        #     include Cms::Acts::ContentPage
+        #     requires_permission_for_section "/somepath", :except=>"action_name"
+        #   ...
+        #
+        def requires_permission_for_section(path, options={})
+          logger.warn "Setting path #{path}"
+          @section_path = path
+          before_filter :check_access_to_section, options
+        end
+
+        def in_section
+          @section_path
+        end
+      end
+    end
+
+  end
+end

data/lib/cms/authentication/controller.rb

@@ -0,0 +1,214 @@
+#
+# Defines the authentication behavior for controllers in BrowserCMS. It can be added to any controller that needs to 
+# hook into the BrowserCMS Authentication behavior like so:
+#
+# class MySuperSecureController < ApplicationController
+#   include Cms::Authentication::Controller
+#
+# It is based off Restful_Authentication, and adds in behavior to deal with several concepts specific to BrowserCMS.
+#
+# (Note: 10/8/09 - I was comparing this to a very old version of the generated code from Restful_Authentication,
+# so some of the following items may be 'stock' to that. (Especially #2)
+#
+# 1. Guests - These represents users that are not logged in. What guests can see and do can be modified via the CMS UI. Guests
+#             are not considered to be 'logged in'.
+# 2. 'Current' User - The currently logged in user is stored in a thread local, and can be accessed anywhere via 'User.current'.
+#             This allows model code to easily record which user is making changes to records, for versioning, etc.
+#
+# 3. 'Admin' Access Denied Page - If users try to access a protected controller, they are redirected to the CMS administration Login page
+#             which may be different than the 'front end' user login page. (Cms::Controller handles that differently)
+#
+#
+# To Dos: It appears as though we are storing the 'current' user in two places, @current_user and User.current. This is probably not DRY, but
+#   more testing would be needed.
+#
+module Cms
+  module Authentication
+    module Controller
+      protected
+        # Returns true or false if the user is logged in.
+        # Preloads User.current with the user model if they're logged in.
+        def logged_in?
+          !current_user.nil? && !current_user.guest?
+        end
+
+        # Accesses the current user from the session or 'remember me' cookie.
+        # If the user is not logged in, this will be set to the guest user, which represents a public
+        # user, who will likely have more limited permissions
+        def current_user
+          # Note: We have disabled basic_http_auth
+          @current_user ||= begin
+            User.current = (login_from_session || login_from_cookie || User.guest)  
+          end
+        end
+
+        # Store the given user id in the session.
+        def current_user=(new_user)
+          session[:user_id] = new_user ? new_user.id : nil
+          @current_user = new_user || false
+          @current_user = User.current
+        end
+
+        # Check if the user is authorized
+        #
+        # Override this method in your controllers if you want to restrict access
+        # to only a few actions or if you want to check if the user
+        # has the correct rights.
+        #
+        # Example:
+        #
+        #  # only allow nonbobs
+        #  def authorized?
+        #    current_user.login != "bob"
+        #  end
+        #
+        def authorized?(action=nil, resource=nil, *args)
+          logged_in?
+        end
+
+        # Filter method to enforce a login requirement.
+        #
+        # To require logins for all actions, use this in your controllers:
+        #
+        #   before_filter :login_required
+        #
+        # To require logins for specific actions, use this in your controllers:
+        #
+        #   before_filter :login_required, :only => [ :edit, :update ]
+        #
+        # To skip this in a subclassed controller:
+        #
+        #   skip_before_filter :login_required
+        #
+        def login_required
+          authorized? || access_denied
+        end
+
+        # Redirect as appropriate when an access request fails.
+        #
+        # The default action is to redirect to the BrowserCMS admin login screen.
+        #
+        # Override this method in your controllers if you want to have special
+        # behavior in case the user is not authorized
+        # to access the requested action.  For example, a popup window might
+        # simply close itself.
+        def access_denied
+          respond_to do |format|
+            format.html do
+              store_location
+              redirect_to cms_login_path
+            end
+          end
+        end
+
+        # Store the URI of the current request in the session.
+        #
+        # We can return to this location by calling #redirect_back_or_default.
+        def store_location
+          session[:return_to] = request.request_uri
+        end
+
+        # Redirect to the URI stored by the most recent store_location call or
+        # to the passed default.  Set an appropriately modified
+        #   after_filter :store_location, :only => [:index, :new, :show, :edit]
+        # for any controller you want to be bounce-backable.
+        def redirect_back_or_default(default)
+          redirect_to(session[:return_to] || default)
+          session[:return_to] = nil
+        end
+
+        # Inclusion hook to make #current_user and #logged_in?
+        # available as ActionView helper methods.
+        def self.included(base)
+          base.send :helper_method, :current_user, :logged_in?, :authorized? if base.respond_to? :helper_method
+        end
+
+        #
+        # Login
+        #
+
+        # Called from #current_user.  First attempt to login by the user id stored in the session.
+        def login_from_session
+          self.current_user = User.find_by_id(session[:user_id]) if session[:user_id]
+        end
+
+        # Called from #current_user.  Now, attempt to login by basic authentication information.
+        def login_from_basic_auth
+          authenticate_with_http_basic do |login, password|
+            self.current_user = User.authenticate(login, password)
+          end
+        end
+    
+        #
+        # Logout
+        #
+
+        # Called from #current_user.  Finaly, attempt to login by an expiring token in the cookie.
+        # for the paranoid: we _should_ be storing user_token = hash(cookie_token, request IP)
+        def login_from_cookie
+          user = cookies[:auth_token] && User.find_by_remember_token(cookies[:auth_token])
+          if user && user.remember_token?
+            self.current_user = user
+            handle_remember_cookie! false # freshen cookie token (keeping date)
+            self.current_user
+          end
+        end
+
+        # This is ususally what you want; resetting the session willy-nilly wreaks
+        # havoc with forgery protection, and is only strictly necessary on login.
+        # However, **all session state variables should be unset here**.
+        def logout_keeping_session!
+          # Kill server-side auth cookie
+          User.current.forget_me if User.current.is_a? User
+          User.current = false     # not logged in, and don't do it for me
+          kill_remember_cookie!     # Kill client-side auth cookie
+          session[:user_id] = nil   # keeps the session but kill our variable
+          # explicitly kill any other session variables you set
+        end
+
+        # The session should only be reset at the tail end of a form POST --
+        # otherwise the request forgery protection fails. It's only really necessary
+        # when you cross quarantine (logged-out to logged-in).
+        def logout_killing_session!
+          logout_keeping_session!
+          reset_session
+        end
+    
+        #
+        # Remember_me Tokens
+        #
+        # Cookies shouldn't be allowed to persist past their freshness date,
+        # and they should be changed at each login
+
+        # Cookies shouldn't be allowed to persist past their freshness date,
+        # and they should be changed at each login
+        def valid_remember_cookie?
+          return nil unless User.current
+          (User.current.remember_token?) && 
+            (cookies[:auth_token] == User.current.remember_token)
+        end
+    
+        # Refresh the cookie auth token if it exists, create it otherwise
+        def handle_remember_cookie! new_cookie_flag
+          return unless User.current
+          case
+          when valid_remember_cookie? then User.current.refresh_token # keeping same expiry date
+          when new_cookie_flag        then User.current.remember_me 
+          else                             User.current.forget_me
+          end
+          send_remember_cookie!
+        end
+  
+        def kill_remember_cookie!
+          cookies.delete :auth_token
+        end
+    
+        def send_remember_cookie!
+          cookies[:auth_token] = {
+            :value   => User.current.remember_token,
+            :expires => User.current.remember_token_expires_at }
+        end
+
+    end
+  end
+end

data/lib/cms/authentication/model.rb

@@ -0,0 +1,116 @@
+module Cms
+  module Authentication
+    module Model
+      def self.included(model_class)
+        model_class.extend ClassMethods
+        model_class.class_eval do
+          include InstanceMethods
+        
+          # Virtual attribute for the unencrypted password
+          attr_accessor :password
+          validates_presence_of     :password,                   :if => :password_required?
+          validates_presence_of     :password_confirmation,      :if => :password_required?
+          validates_confirmation_of :password,                   :if => :password_required?
+          #validates_length_of       :password, :within => 6..40, :if => :password_required?
+          before_save :encrypt_password
+        end      
+      end
+
+      module ClassMethods
+        def authenticate(login, password)
+          u = find_by_login(login) # need to get the salt
+          u && u.authenticated?(password) && !u.expired? ? u : nil
+        end
+
+        #Method to make it easy to change a user's password from the console, not used in the app
+        def change_password(login, new_password)
+          find_by_login(login).change_password(new_password)
+        end
+
+        def make_token
+          secure_digest(Time.now, (1..10).map{ rand.to_s })
+        end
+
+        def password_digest(password, salt)
+          key = '8771d0d9bef6f1091b723d2e701a17c811d69b26'
+          digest = key
+          10.times do
+            digest = secure_digest(digest, salt, password, key)
+          end
+          digest
+        end      
+      
+        def secure_digest(*args)
+          Digest::SHA1.hexdigest(args.flatten.join('--'))
+        end      
+      
+      end
+    
+      module InstanceMethods
+        #Method to make it easy to change a user's password from the console, not used in the app
+        def change_password(new_password)
+          update_attributes(:password => new_password, :password_confirmation => new_password)
+        end      
+      
+        # Encrypts the password with the user salt
+        def encrypt(password)
+          self.class.password_digest(password, salt)
+        end
+      
+        def authenticated?(password)
+          crypted_password == encrypt(password)
+        end
+      
+        # before filter 
+        def encrypt_password
+          return if password.blank?
+          self.salt = self.class.make_token if new_record?
+          self.crypted_password = encrypt(password)
+        end
+      
+        def password_required?
+          crypted_password.blank? || !password.blank?
+        end      
+      
+        def remember_token?
+          (!remember_token.blank?) && 
+            remember_token_expires_at && (Time.now.utc < remember_token_expires_at.utc)
+        end
+
+        # These create and unset the fields required for remembering users between browser closes
+        def remember_me
+          remember_me_for 2.weeks
+        end
+
+        def remember_me_for(time)
+          remember_me_until time.from_now.utc
+        end
+
+        def remember_me_until(time)
+          self.remember_token_expires_at = time
+          self.remember_token            = self.class.make_token
+          save
+        end
+
+        # refresh token (keeping same expires_at) if it exists
+        def refresh_token
+          if remember_token?
+            self.remember_token = self.class.make_token 
+            save      
+          end
+        end
+
+        # 
+        # Deletes the server-side record of the authentication token.  The
+        # client-side (browser cookie) and server-side (this remember_token) must
+        # always be deleted together.
+        #
+        def forget_me
+          self.remember_token_expires_at = nil
+          self.remember_token            = nil
+          save
+        end      
+      end
+    end
+  end
+end

data/lib/cms/behaviors.rb

@@ -0,0 +1,33 @@
+# Behaviors are used in CMS to add features to a model. 
+# They are very similar to the various "acts_as_*" or "*_fu" plugins/gems 
+# that have been created for Rails.  
+#
+# Generally, each behavior has three modules in it.  They are:
+# * MacroMethods
+# * ClassMethods
+# * InstanceMethods
+#
+# When the CMS starts up, all of the Behaviors are included into ActiveRecord::Base.
+# The MacroMethods module of each Behavior is also included into ActiveRecord::Base.
+# The MacroMethods module contains Class methods that you can call within your model
+# in order to enable that Behavior for that Class.  For example, if you want to have
+# an Article module that is taggable, you would do this:
+#
+#     class Article < ActiveRecord::Base
+#       is_taggable
+#     end
+#
+# So in this case, you are calling the `is_taggable` macro method, which enables the 
+# taggable behavior for the Article model.  It enables the behavior by extending the
+# ClassMethods module and including the InstanceMethods module into the Article class.
+# Each Behavior typically has one macro method which takes an options Hash, which of course
+# varies from Behavior to Behavior.  The macro method will also sometimes call other
+# macro methods, like before_fitler, named_scope, etc. to modify the model.
+# Consult the documentation for each module for specific details as to what
+# the Behavior does.
+module Cms::Behaviors; end
+
+Dir["#{File.dirname(__FILE__)}/behaviors/*.rb"].each do |b| 
+  require File.join("cms", "behaviors", File.basename(b, ".rb"))
+  ActiveRecord::Base.send(:include, "Cms::Behaviors::#{File.basename(b, ".rb").camelize}".constantize)
+end