character 0.1.0 → 1.0.0

data/app/views/posts/author.html.erb

@@ -0,0 +1,18 @@
+<% set_meta_tags  title: "#{ @author.name } | #{ @title }",
+                  description: @description, # use same description as website
+                  canonical: "http://#{ @domain }#{ posts_author_path(@author) }",
+                  open_graph: { type: 'blog',
+                                title: "#{ @author.name } | #{ @title }",
+                                description: @description, # use same description as website
+                                url: "http://#{ @domain }#{ posts_author_path(@author) }" } %>
+
+<% @posts.each do |p| %>
+  <%= render partial: 'post', locals: { post: p } %>
+<% end %>
+
+<nav class='pagination'>
+  <div class='container'>
+    <%= link_to_previous_page @posts, 'Newer Posts', params: @kaminari_params %>
+    <%= link_to_next_page @posts, 'Older Posts', params: @kaminari_params  %>
+  </div>
+</nav>

data/app/views/posts/category.html.erb

@@ -0,0 +1,18 @@
+<% set_meta_tags  title: "#{ @category.title } | #{ @title }",
+                  description: @description, # use same description as website
+                  canonical: "http://#{ @domain }#{ posts_category_path(@category) }",
+                  open_graph: { type: 'blog',
+                                title: "#{ @category.title } | #{ @title }",
+                                description: @description, # use same description as website
+                                url: "http://#{ @domain }#{ posts_category_path(@category) }" } %>
+
+<% @posts.each do |p| %>
+  <%= render partial: 'post', locals: { post: p } %>
+<% end %>
+
+<nav class='pagination'>
+  <div class='container'>
+    <%= link_to_previous_page @posts, 'Newer Posts', params: @kaminari_params %>
+    <%= link_to_next_page @posts, 'Older Posts', params: @kaminari_params  %>
+  </div>
+</nav>

data/app/views/posts/index.html.erb

@@ -0,0 +1,18 @@
+<% set_meta_tags  title: @title,
+                  description: @description,
+                  canonical: "http://#{ @domain }#{ posts_index_path }",
+                  open_graph: { type: 'blog',
+                                title: @title,
+                                description: @description,
+                                url: "http://#{ @domain }#{ posts_index_path }" } %>
+
+<% @posts.each do |p| %>
+  <%= render partial: 'post', locals: { post: p } %>
+<% end %>
+
+<nav class='pagination'>
+  <div class='container'>
+    <%= link_to_previous_page @posts, 'Newer Posts', params: @kaminari_params %>
+    <%= link_to_next_page @posts, 'Older Posts', params: @kaminari_params  %>
+  </div>
+</nav>

data/app/views/posts/rss.builder

@@ -0,0 +1,19 @@
+xml.instruct! :xml, :version => "1.0"
+xml.rss "xmlns:dc" => "http://purl.org/dc/elements/1.1/", :version => "2.0" do
+  xml.channel do
+    xml.title @title
+    xml.description @description
+    xml.link 'http://' + @domain + posts_index_path
+
+    for post in @posts
+      xml.item do
+        xml.title post.title
+        xml.description post.subtitle
+        xml.pubDate post.published_at.to_s(:rfc822)
+        xml.link 'http://' + @domain + posts_show_path(post)
+        xml.guid 'http://' + @domain + posts_show_path(post.id.to_s)
+        xml.category post.category.title if post.category
+      end
+    end
+  end
+end

data/app/views/posts/show.html.erb

@@ -0,0 +1,14 @@
+<% set_meta_tags  title: @post.title,
+                  description: @post.subtitle,
+                  canonical: "http://#{ @domain }#{ posts_show_path(@post) }",
+                  open_graph: { type: 'article',
+                                title: @post.title,
+                                description: @post.subtitle,
+                                url: "http://#{ @domain }#{ posts_show_path(@post) }",
+                                image: @post.featured_image_url.empty? ? '' :  "http:#{ @post.featured_image_url }" } %>
+
+<%= render partial: 'post', locals: { post: @post } %>
+
+<nav class='navigation'>
+  <%= link_to 'Blog Home', posts_index_path %>
+</nav>

data/app/views/shared/_google_analytics.html.erb

@@ -0,0 +1,13 @@
+<% if Rails.env.production? %>
+  <% if not @ga_id.empty? %>
+  <script>
+    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+    ga('create', '<%= @ga_id %>', '<%= @ga_domain %>');
+    ga('send', 'pageview');
+  </script>
+  <% end %>
+<% end %>

data/character.gemspec

@@ -4,13 +4,13 @@ require File.expand_path('../lib/character/version', __FILE__)
 Gem::Specification.new do |gem|
   gem.name          = 'character'
   gem.version       = Character::VERSION
-  gem.summary       = 'Blogging app on the top of activeadmin and mongoid.'
-  gem.description   = ''
+  gem.summary       = 'Admin framework for rails + mongoid web applications.'
   gem.license       = 'MIT'
+  gem.description   = ''
 
-  gem.authors       = ['Alex Kravets']
-  gem.email         = 'santyor@gmail.com'
-  gem.homepage      = 'https://github.com/alexkravets/character-rails'
+  gem.authors       = [ 'Alexander Kravets', 'Roman Lupiichuk', 'Maksym Melnyk', 'Anthony Blackwell' ]
+  gem.email         = 'alex@slatestudio.com'
+  gem.homepage      = 'https://github.com/slate-studio/character'
 
   gem.require_paths = ['lib']
   gem.files         = `git ls-files`.split($\)
@@ -20,5 +20,48 @@ Gem::Specification.new do |gem|
   # Supress the warning about no rubyforge project
   gem.rubyforge_project = 'nowarning'
 
+
+  # automated tests
+  gem.add_development_dependency 'rails', '~> 4.1.0'
+  gem.add_development_dependency 'database_cleaner'
+  gem.add_development_dependency 'factory_girl_rails'
+  gem.add_development_dependency 'minitest-reporters'
+  gem.add_development_dependency 'minitest-focus'
+
+  # javascript
+  gem.add_runtime_dependency 'underscore-rails'
+  gem.add_runtime_dependency 'marionette-rails', '~> 2.0.0'
+  gem.add_runtime_dependency 'jquery-ui-rails'
+  gem.add_runtime_dependency 'momentjs-rails'
+  gem.add_runtime_dependency 'character_editor'
+  gem.add_runtime_dependency 'modernizr-rails'
+
+  # css
+  gem.add_runtime_dependency 'rhythm'
   gem.add_runtime_dependency 'compass-rails'
+  gem.add_runtime_dependency 'font-awesome-rails'
+  gem.add_runtime_dependency 'simple_form_scss'
+
+  # authentication
+  gem.add_runtime_dependency 'browserid-auth-rails', '~> 0.5.7'
+
+  # orm
+  gem.add_runtime_dependency 'mongoid', '~> 4.0.0'
+
+  # forms
+  gem.add_runtime_dependency 'simple_form'
+  gem.add_runtime_dependency 'nested_form'
+
+  # pagination
+  gem.add_runtime_dependency 'kaminari'
+
+  # blog
+  # gem.add_runtime_dependency 'mongoid' <- for now you have to pick github version manually for Rails 4
+  gem.add_runtime_dependency 'mongoid_slug'
+  gem.add_runtime_dependency 'mongoid_search'
+  gem.add_runtime_dependency 'mini_magick'
+  gem.add_runtime_dependency 'meta-tags'
+
+  # analytics
+  gem.add_runtime_dependency 'google-api-client'
 end

data/doc/README_old.md

@@ -0,0 +1,161 @@
+# Character
+
+Character is an admin framework for **rails + mongoid** web applications. It has clean user interface and written with CoffeeScript. Character is very similar to [Django](http://djangoproject.com) admin or [Active Admin](http://www.activeadmin.info) but is much easier to extend. It is built on the top of:
+
+* Back-end: [Rails](http://rubyonrails.org)
+* Front-end Javascript: [Backbone.js](http://backbonejs.org) + [Marionette.js](https://github.com/marionettejs/backbone.marionette)
+* Front-end CSS: [Foundation 5](http://foundation.zurb.com)
+
+![Character Demo](https://raw.github.com/slate-studio/character/master/doc/img/demo-1.jpg)
+
+## Content
+
+* [New Project](#new-project)
+* [Authentification](#authentification)
+  * [Mozilla Persona](#mozilla-persona)
+  * [Login Background](#login-background)
+* [Generic App](#generic-app)
+  * [Model Admin](#model-admin)
+  * [Forms](#forms)
+* [Instances](#instances)
+* [Settings](#settings)
+* [Tests](#tests)
+* [TODO](#todo)
+
+
+## New Project
+
+Start new Rails 4 project:
+
+    rails new ProjectName -T -O
+
+Add following gems to the ```Gemfile```:
+
+    # ORM
+    gem 'mongoid', github: 'mongoid/mongoid'
+    gem 'bson_ext'
+
+    # File uploader
+    gem 'carrierwave-mongoid', github: 'carrierwaveuploader/carrierwave-mongoid', require: 'carrierwave/mongoid'
+    gem 'mongoid-grid_fs',     github: 'ahoward/mongoid-grid_fs'
+
+    gem 'character', github: 'slate-studio/character'
+    gem 'character_redactor',  github: 'slate-studio/character_redactor'
+
+Run ```bundle``` from projects root.
+
+Create mongo database config, initialize Foundation (not required if it's not used in the project) and install Character assets:
+
+    rails g mongoid:config ; rails g foundation:install ; rails g character:install
+
+Run local Rails server:
+
+    rails s
+
+Done! Open [http://localhost:3000/admin](http://localhost:3000/admin) in the browser.
+
+Character generator does:
+
+1. Mount character in the ```config/routes.rb``` with ```mount_character()``` command
+2. Create ```app/assets/javascript/admin.coffee``` and ```app/assets/stylesheets/admin.scss```
+3. Remove ```//= require_tree .``` and ```*= require_tree .``` string from ```app/assets/javascripts/application.js``` and ```app/assets/stylesheets/application.js``` — to do not include admin assets in the application assets
+4. Add character & foundation javascript assets to production environment in ```config/environment/production.rb```: ```config.assets.precompile += %w( admin.js admin.css foundation.js vendor/modernizr.js )```
+5. Create character initializer ```config/initializers/character.rb```
+
+
+### Blog
+
+Character includes basic blog application. To install blog please install character admin using instructions above. And then run blog generator:
+
+    rails g character:blog:install
+
+Done! Open [http://localhost:3000/](http://localhost:3000/) in the browser.
+
+## Authentification
+
+
+#### Mozilla Persona
+
+Character is using [Mozilla Persona](https://login.persona.org/about) as main authentification system. This one chosen as it is very easy to setup and allows us to do not create administrative accounts from one project to another.
+
+While logging to Character for the first time, first administrative account is created. Add other accounts via console or using Character / Settings / Admins tab.
+
+
+#### Login Background
+
+Default login background could be changed using ```config.login_background_image``` option in Character configuration file ```config/initializers/character.rb```.
+
+![Character Default Login](https://raw.github.com/slate-studio/character/master/doc/img/demo-3.jpg)
+
+
+## Generic App
+
+Generic application is a main type of Character apps. It provides a way to setup administrative application for any [Mongoid](http://mongoid.org/en/mongoid/index.html) model in no time.
+
+[Generic Application API Reference](https://github.com/slate-studio/character/blob/master/doc/generic_app.md)
+
+![Character Generic Application Demo](https://raw.github.com/slate-studio/character/master/doc/img/demo-2.jpg)
+
+
+#### Model Admin
+
+Here is an example of adding character admin app for ```Project``` model from the screenshot above. All model setups are added to ```app/assets/javascripts/admin.coffee```:
+
+    new CharacterApp 'Project',
+      icon:         'rocket'
+      reorder:      true
+      scopes:
+        default:
+          order_by: '_position:desc'
+
+Projects app added to character with ```rocket``` menu icon from [Fontawesome Icons](http://fontawesome.io/icons/), default sort order uses ```_position``` model field, and items are reorderable in the list with drag'n'drop to make it possible to reorder projects from the portfolio page.
+
+
+#### Forms
+
+By default object forms are autogenerated, [here](https://github.com/slate-studio/character/blob/master/app/views/character/generic_form.html.erb) is a template with is used to do that. At this point it's very simple generator and we have a plan to make more sophisticated. So you might want to customize objects form and it's pretty easy to do this.
+
+Character looks for forms templates at ```app/views/character/[pluralized_model_name]/form.html.erb```, so in the example above form should be placed at: ```app/views/character/projects/form.html.erb```. Generic template is good to start customization with:
+
+    <%= simple_form_for @object, url: @form_action_url do |f| %>
+      <div class='row'>
+        <% @form_fields.each do |name| %>
+          <%= f.input name, wrapper_class: 'small-12 columns' %>
+        <% end %>
+      </div>
+    <% end %>
+
+[Simple Form](https://github.com/plataformatec/simple_form) and [Nested Form](https://github.com/ryanb/nested_form) could be used for building forms.
+
+[Nested Form](https://github.com/ryanb/nested_form) is a very handy gem to expand forms with editable inlines. It plays very nice with Character. Customized form could include nested forms. Following screenshot shows part of the Project form -- editable list of embeded images into the Project model handled by [Nested Form](https://github.com/ryanb/nested_form).
+
+![Character Nested Forms Demo](https://raw.github.com/slate-studio/character/master/doc/img/demo-4.jpg)
+
+
+## Instances
+
+Instances allow you to use several independent character app instances for one website. Each of them will be using separate configuration, styles and templates.
+
+[See instances section for details](https://github.com/slate-studio/character/blob/master/doc/instances.md)
+
+
+## Settings
+
+Settings application provides a generic way of expanding admin with editable sets of parameters (objects) or editable collections. One of good examples of usage of settings app is an admin application which allows to add/remove admin users:
+
+![Character Nested Forms Demo](https://raw.github.com/slate-studio/character/master/doc/img/demo-5.jpg)
+
+Settings could be used to provide a simple way of editing CTAs, webpage editable content, etc. Read more on Character Settings [here](https://github.com/slate-studio/character/blob/master/doc/settings.md).
+
+
+## Tests
+
+To run the tests use the following command in the gem's root directory:
+
+    $ rspec
+
+
+--
+* [Олександр Кравець](http://www.akravets.com) @ [Slate](http://www.slatestudio.com) - January 23, 2014
+* Роман Лупійчук @ [Slate](http://www.slatestudio.com) - August 9, 2013
+* Мельник Максим @ [Slate](http://www.slatestudio.com) - October 23, 2013

data/doc/generic_app.md

@@ -0,0 +1,19 @@
+## Generic App
+
+[Documentation Index](https://github.com/slate-studio/character/blob/master/README.md)
+
+### API
+
+API url endpoint for model: ```/admin/<ModelName>?```
+
+Parameters:
+
+* ```order_by``` -- sort order for result list, e.g. ```order_by=report_date:asc```
+* ```fields_to_include``` -- comma separated list of field names to be returned, e.g. ```fields_to_include=report_date,revenue,tax,shipping```
+* ```search_query```
+* ```page``` --
+* ```per_page``` --
+* ```__title``` --
+* ```__meta``` --
+* ```reorderable``` -- true/false
+

data/doc/instances.md

@@ -0,0 +1,39 @@
+## Instances
+
+Instances allow you to use several independent admins for one website. Each of them will be using separate configuration, styles and templates.
+
+### Configuration
+
+Example of configuration for two character instances, this must be included in `config/initializers` folder.
+
+```ruby
+Character.configure do |config|
+  config.instance 'producers' do |instance|
+    instance.title      = 'Producer Cabinet'
+    instance.user_model = 'Producer'
+
+    instance.permissions_filter = proc do
+      %w(Producer Videos).include? model_class.name
+    end
+  end
+
+  config.instance 'admin' do |instance|
+    instance.title = 'Admin'
+  end
+end
+```
+
+List of all available options.
+
+| Option                   | Description                   | Default   |
+| ------------------------ | ----------------------------- | --------- |
+| title                    | Title of the instance         |           |
+| user_model               | Model to authenticate users, must be [browserid](https://github.com/alexkravets/browserid-auth-rails) compatible | Character::User |
+| javascript_filename      | JavaScript configuration file | Name of instance |
+| stylesheet_filename      | Stylesheet file               | Name of instance |
+| logo_image               | See main doc for details      |           |
+| login_background_image   | See main doc for details      |           |
+
+### Templates
+
+Each instance has its own templates. They must live under `character/#{ instance name }` folder. E.g. under `character/admin` & `character/producers` for configuration from "Configuration" section.

data/doc/settings.md

@@ -0,0 +1 @@
+## Settings

data/lib/character.rb

@@ -1,3 +1,31 @@
+# frontend assets
+require 'compass-rails'
+require 'font-awesome-rails'
+require 'jquery-ui-rails'
+require 'underscore-rails'
+require 'marionette-rails'
+require 'momentjs-rails'
+require 'character_editor'
+require 'rhythm'
+require 'simple_form_scss'
+require 'modernizr-rails'
+
+# backend
+require 'browserid-rails'
+require 'simple_form'
+require 'nested_form'
+require 'kaminari'
+require 'mongoid'
+require 'mongoid_slug'
+require 'mongoid_search'
+require 'meta_tags'
+require 'mini_magick'
+require 'mongoid/carrierwave_serialization_patch'
+
+# character
+require 'character/settings'
+require 'character/instance'
 require 'character/version'
 require 'character/engine'
-require "character/routing"
+require 'character/routing'
+require 'character/generators/bootstrap_generator'

data/lib/character/engine.rb

@@ -1,5 +1,37 @@
 module Character
+  class << self
+    attr_writer :instances
+
+    def instances
+      if @instances.blank?
+        @instances = { Instance::DEFAULT_NAME => Instance.new }
+      else
+        @instances
+      end
+    end
+
+    def configure(&block)
+      block.call(self)
+    end
+
+    def instance(name, &block)
+      @custom_instance_name_used = true
+      raise StandardError.new("Please don't mix character instance configuration & default character configuration.") if @default_instance_name_used
+
+      block.call( @instances[name] ||= Instance.new(name) )
+    end
+
+    def method_missing(method, *args)
+      @default_instance_name_used = true
+      raise StandardError.new("Please don't mix character instance configuration & default character configuration.") if @custom_instance_name_used
+
+      ( @instances[Instance::DEFAULT_NAME] ||= Instance.new ).send method, *args
+    end
+  end
+
   class Engine < ::Rails::Engine
-    isolate_namespace Character
+    config.before_configuration do
+      Character.instances = {}
+    end
   end
 end