control_center 1.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2009 Alan Johnson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,188 @@
+Control Center
+==============
+
+Control Center is a Rails plugin for bootstrapping the interface side of an application very quickly. It provides an interface with tabs and subtabs, and with a few nice default styles. Control Center is can be installed through the rails script/plugin script, or as a RubyGem.
+
+Installation As A Rails Plugin
+------------------------------
+While we recommend installing as a RubyGem, installing as a Rails plugin is dead simple. From within the root of your Rails project do:
+
+    script/plugin install git://github.com/commondream/control_center.git
+    script/generate control_center
+
+Installation As A RubyGem
+-------------------------
+Installation as a RubyGem ensures that you don't get any weirdness due to installing directly from the repository. Make sure you have GitHub in your gem sources before you try to do the install.
+
+    gem install commondream-control_center
+
+Now that you've got the gem installed, you'll need to configure your application to use control center. Add a line like the following to your environment.rb:
+
+    config.gem "commondream-control_center", :lib => "control_center"
+
+Now, from the root of your rails project, run the following command:
+
+    script/generate control_center
+
+Post-Installation Configuration
+-------------------------------
+Using Control Center is as easy as setting it as a layout in one of your controllers (or in your ApplicationController if you want it to be the layout across your entire app) with:
+
+    layout 'control_center'
+
+You'll want to look at environment/initializers/control_center.rb to customize the Control Center title, the color of the header and several other options. Also, you'll want to set your tabs up in app/views/layouts/_tabs.html.erb.
+
+Tabs
+----
+Tabs are defined by default in the app/views/layouts/_tabs.html.erb partial. You can override the tabs in any page with the tabs helper.
+
+Tabs are defined as follows:
+
+    <%= tab "Title", "url" %>
+
+You can create as many tabs as you would like, but be aware that at present the tabs will simply wrap to the next line if you include too many. We'll hopefully fix that in a future release, although you probably shouldn't use so many tabs that it would wrap anyway.
+
+The tab method passes the url on to the Rails link_to helper, so the url can be a has or anything else that link_to accepts for its url parameter.
+
+To select a tab, simply use the select_tab method in your view. select_tab chooses a tab based on the title given to the tab, so for example, with a tab definition like:
+
+    <%= tab "Tab 1", "/some_url" %>
+    <%= tab "Tab 2", "/some_other_url" %>
+
+if you called:
+
+    <% select_tab "Tab 1" %>
+
+in your view, the tab titled *Tab 1* would be selected.
+
+Subtabs
+-------
+Subtabs will typically be defined in a partial that you create and included in the views that use that particular set of subtabs. Although that's typical,
+it's not mandatory. The app/views/layouts/_tabs.html.erb partial is another
+great spot to put subtabs if you want to do more of a per-app tab configuration,
+but that's tricker to implement in many cases. Anyway, a set of subtabs will
+look something like this in your view:
+
+    <% sub_tabs do %>
+      <%= sub_tab "Sub Tab", "/subtab" %>
+      <%= sub_tab "Sub Tab 2", "/subtab2" %>
+    <% end %>
+    
+You can select what tab to mark as the current one with the select_sub_tab helper:
+
+    <% select_sub_tab "Sub Tab" %>
+    
+The sub_tabs helper does not output the tabs, because the Control Center
+layout has a specific place where it needs to put them. So, don't worry about
+where you put the sub tab definition in your view... as long as its in your
+view, they'll show up correctly.
+
+Please note that sub_tabs at present don't work with versions of Rails < 2.2.
+
+Header Navigation
+-----------------
+The content at the very top right of Control Center is great for login/logout links, help links, etc. You can modify that content by editing the app/views/layouts/_header_links.html.erb partial.
+
+Sidebars
+--------
+Control Center has two primary layouts at present, a single column display and a two column display. The two column display shows a sidebar to the right side of the screen. To generate content for the sidebar, simply put normal content, like p, div, ul tags into the sidebar helper in your view:
+
+    <% sidebar do %>
+      <h3>This is a sidebar!</h3>
+    
+      <p>
+        Aw, yeah! This is a sidebar. Didn't think you'd be creating sidebars
+        today, did you? Well, you are!
+      </p>
+    <% end %>
+
+Forms
+-----
+Forms in Control Center are fairly simple to implement. Control Center puts labels above fields and allows you to do either a single column of fields in your form or to do two columns.
+
+The markup for a field should look something like the following:
+
+    <div>
+      <label for="username">Username</label>
+      <input type="text" name="username" id="username" />
+    </div>
+    
+Of course, if you used the Rails helpers, it might look more like:
+
+    <div>
+      <%= f.label :username %>
+      <%= f.text_field :username %>
+    </div>
+
+If you would like a two column layout, use markup similar to the following:
+
+    <div>
+      <div class="col2">
+        [FIELD GOES HERE]
+      </div>
+      <div class="col2">
+        [FIELD GOES HERE]
+      </div>
+    </div>
+
+Control Center includes styles for the error states of the Rails helpers, and for the error_messages helper, so that you won't have to create style rules yourself.
+
+You can learn more about how to lay out your forms in Control Center by looking at the sample/app/views/test/forms.html.erb file in Control Center's source repository.
+
+Custom CSS
+----------
+To add custom CSS to Control Center, simply use the custom_css config property in the initializer. It expects a hash with keys for each of the stylesheets to pass to the Rails stylesheet_link_tag helper, and with values for the options to pass to the helper. For example:
+
+    ControlCenter::Config.custom_css = { 
+      "custom_css_1" => { :media => :all }, 
+      "custom_css_2" => { :media => :print }
+    }
+
+Would create two links in Control Center, one to a stylesheet named custom_css_1 with a media attribute of all, and one to custom_css_2 with a media attribute of print.
+
+Custom JavaScript
+-----------------
+Add custom JavaScript to the Control Center interface by using the include_javascript property in the initializer. The value you set to include_javascript gets passed to the Rails javascript_include_tag helper.
+
+    ControlCenter::Config.include_javascript = [ :defaults ]
+    
+This would cause the Rails default javascripts (Prototype, Scriptaculous, and application.js) to be inluded with Control Center. The scripts are included at the bottom of the body of your page, as per the YSlow guidelines.
+
+Where are the tests?
+--------------------
+I'm usually very good about testing my code, but I wasn't sure of the best way to test something that was so interface intensive, so tests simply aren't present for the 1.0 release. Tests are one of my biggest goals for the 1.1 release.
+
+What about IE?
+--------------
+I think most of Control Center should work fine in IE, but I haven't been as thorough as I would with, say, a production website design in testing IE compatibility, so don't be surprised if there are a few issues here and there.
+
+Reporting Issues
+----------------
+If something's not working like you expect it to, submit an issue through the GitHub issues tool for Control Center, and I'll take a look at your problem. You can find the issues tool [here](http://github.com/commondream/control_center/issues).
+
+Screenshot
+----------
+![Control Center Screenshot](http://cloud.github.com/downloads/commondream/control_center/Control_Center_-_Forms_Sample-1.png)
+
+License
+-------
+Copyright (c) 2008-2009 Alan Johnson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/generators/control_center/control_center_generator.rb

@@ -0,0 +1,26 @@
+class ControlCenterGenerator < Rails::Generator::Base
+  def banner
+    "Usage #{$0} #{spec.name}"
+  end
+  
+  def manifest
+    record do |m|
+      # set up the stylesheet
+      m.directory('public/stylesheets')
+      m.file('control_center.css',
+          'public/stylesheets/control_center.css')
+      
+      # copy the layouts over
+      layouts_path = 'app/views/layouts'
+      m.directory(layouts_path)
+      m.file('_tabs.html.erb', 
+          File.join(layouts_path, "_tabs.html.erb"))
+      m.file('_header_links.html.erb',
+          File.join(layouts_path, "_header_links.html.erb"))
+          
+      # copy the initializer over
+      m.file 'control_center.rb', 
+        File.join("config", "initializers", "control_center.rb")
+    end
+  end
+end

data/generators/control_center/templates/control_center.rb

@@ -0,0 +1,14 @@
+# This is an initializer script for Control Center. Customize it to your
+# preferences
+
+ControlCenter::Config.app_title = "Control Center"
+ControlCenter::Config.theme_color = "#0033CC"
+
+# Custom Stylesheets
+# ControlCenter::Config.custom_css = { 
+#   "custom_css_1" => { :media => :all }, 
+#   "custom_css_2" => { :media => :print }
+# }
+
+# Custom JavaScript Includes
+#ControlCenter::Config.include_javascript = [:defaults]

data/lib/control_center.rb

@@ -0,0 +1,20 @@
+module ControlCenter
+  require_relative 'control_center/helpers/layout_helper'
+  require_relative 'control_center/helpers/tab_builder'
+  require 'control_center/engine' if defined?(Rails)
+  
+  class Config
+    cattr_accessor :app_title
+    cattr_accessor :theme_color
+    cattr_accessor :custom_css
+    cattr_accessor :include_javascript
+    
+    def self.custom_css
+      @@custom_css ||= {}
+    end
+    
+    def self.include_javascript
+      @@include_javascript || []
+    end
+  end
+end

data/lib/control_center/engine.rb

@@ -0,0 +1,18 @@
+module ControlCenter
+  class Engine < Rails::Engine
+    engine_name :control_center
+
+    if Rails.version >= '3.1'
+      initializer :assets do |config|
+        Rails.application.config.assets.precompile += Dir.glob(File.join("#{self.root}", 'app', 'assets', '**', '*'))
+      end
+    end
+    
+    initializer 'action_view.helper_mehtods' do |app|
+      ActiveSupport.on_load(:action_view) do
+        ::ActionView::Base.send :include, ControlCenter::Helpers::LayoutHelper
+      end
+    end
+    
+  end
+end

data/lib/control_center/helpers/layout_helper.rb

@@ -0,0 +1,65 @@
+require_relative 'tab_builder'
+
+# Helpers that control center uses
+module ControlCenter
+  module Helpers
+    module LayoutHelper
+  
+      def title(title)
+        @control_center_title = title
+      end
+  
+      def select_tab(tab)
+        @cc_current_tab = tab
+      end
+      def current_tab
+        @cc_current_tab
+      end
+  
+      def sub_tabs
+        if block_given?
+          content_for :sub_tabs do
+            yield
+          end
+        end
+      end
+  
+      def select_sub_tab(tab)
+        @cc_current_sub_tab = tab
+      end
+      def current_sub_tab
+        @cc_current_sub_tab
+      end
+  
+      # Sets up a sidebar in control center.
+      def sidebar
+        if block_given?
+          @sidebar_set = true
+          content_for :sidebar do
+            yield
+          end
+        end
+      end
+  
+      def sidebar?
+        @sidebar_set ||= false
+      end
+  
+      def tab(tab_name, tab_url)
+        options = {}
+        options[:class] = "active" if  current_tab == tab_name
+        content_tag "li", options, true do
+          link_to tab_name, tab_url
+        end
+      end
+  
+      def sub_tab(tab_name, tab_url)
+        options = {}
+        options[:class] = "active" if  current_sub_tab == tab_name
+        content_tag "li", options, true do
+          link_to tab_name, tab_url
+        end
+      end
+    end
+  end
+end

data/lib/control_center/helpers/tab_builder.rb

@@ -0,0 +1,14 @@
+module ControlCenter
+  module Helpers
+    class TabBuilder
+  
+      def initialize(&block)
+        @block = block
+      end
+    
+      def tab(tab_name, url)
+        @block.call(tab_name, url)
+      end
+    end
+  end
+end

data/lib/tasks/control_center_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :control_center do
+#   # Task goes here
+# end

data/rails/init.rb

@@ -0,0 +1,7 @@
+# Include hook code here
+require File.join(File.dirname(__FILE__), "..", "lib", "control_center.rb")
+
+# Include the helpers we've written
+ActionView::Base.send :include, ControlCenter::Helpers
+
+config.middleware.use ::ActionDispatch::Static, "#{root}/public"

data/test/rails/README

@@ -0,0 +1,2 @@
+== Control Center
+

data/test/rails/Rakefile

@@ -0,0 +1,10 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/rails'

data/test/rails/app/controllers/application.rb

@@ -0,0 +1,15 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+
+  # See ActionController::RequestForgeryProtection for details
+  # Uncomment the :secret if you're not using the cookie session store
+  protect_from_forgery # :secret => '50fafc1e38ed429580dd1235acd03744'
+  
+  # See ActionController::Base for details 
+  # Uncomment this to filter the contents of submitted sensitive data parameters
+  # from your application log (in this case, all fields with names like "password"). 
+  # filter_parameter_logging :password
+end

data/test/rails/app/controllers/application_controller.rb

@@ -0,0 +1,15 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+
+  # See ActionController::RequestForgeryProtection for details
+  # Uncomment the :secret if you're not using the cookie session store
+  protect_from_forgery # :secret => '50fafc1e38ed429580dd1235acd03744'
+  
+  # See ActionController::Base for details 
+  # Uncomment this to filter the contents of submitted sensitive data parameters
+  # from your application log (in this case, all fields with names like "password"). 
+  # filter_parameter_logging :password
+end

data/test/rails/app/controllers/test_controller.rb

@@ -0,0 +1,3 @@
+class TestController < ApplicationController
+  layout "control_center"
+end