Home Original page

GitHub - eadz/typus: An amazing admin interface for Rails.

As Django Admin, Typus is designed for a single activity:

Trusted users editing structured content.

Once installed and configured you can login at http://application.tld/admin/

Note: Typus doesn't try to be all the things to all the people.

Installing

You can view the available tasks running

Step 1: Install extra plugins.

This task will install for you:

  • Gem paginator
  • paperclip File upload
  • acts_as_list
  • acts_as_tree

Step 2: Copy stylesheets to your public/ folder.

Step 3: Create an initial configuration file at config/typus.yml.

Step 4: Create the needed tables on the db by running.

script/generate typus_migration
rake db:migrate
rake typus:seed email='youremail@yourdomain.com' RAILS_ENV=production

Step 5: Start your application.

Start your application and go to http://application.tld/admin/

Plugin Configuration Options

You can overwriting the following settings:

Typus::Configuration.options[:app_name] = "Your app name"
Typus::Configuration.options[:app_description] = "App Details"
Typus::Configuration.options[:per_page] = "20"
Typus::Configuration.options[:form_rows] = "20"
Typus::Configuration.options[:form_columns] = "20"
Typus::Configuration.options[:color] = "20"
Typus::Configuration.options[:app_logo] = "url/to/application/logo"
Typus::Configuration.options[:app_logo_height] = "400px"
Typus::Configuration.options[:app_logo_width] = "400px"

Place this settings in a initializer at config/initializers/typus.rb.

Configuration file options

If the configuration file is broken you'll see a +typus.yml+ text on the admin interface.

Typus Fields

fields:
  list: name, created_at, category_id, status
  form: name, body, created_at, status
  relationship: name, category_id

NOTE: Upload files only works if you follow Paperclip naming conventions.

External Forms

relationships:
  has_and_belongs_to_many: users
  has_many: projects

Filters

filters: status, author_id, created_at

Order

Adding minus (-) sign before the attribute will make the order DESC.

order_by: -attribute1, attribute2

Searches

search: attribute1, attribute2

Want more actions?

actions:
  list: notify_all
  form: notify

These actions will only be available on the context +list+ and +form+ of Typus.

You'll have to create controllers that inherit from TypusController

class Typus::NewslettersController < TypusController

  ##
  # Action to deliver emails ...
  def deliver
    ...
    redirect_to :back
  end

end

For feedback you can use the flash method.

  • flash[:notice] just some feedback.
  • flash[:error] when there's something wront.
  • flash[:success] when the action successfully finished.

Applications, modules and submodules

To group modules into an application use application.

Each module has submodules grouped using module.

Example: (E-Commerce Application)

Product:
  application: ECommerce
Client:
  application: ECommerce
Category:
  module: Product
Option Type:
  module: Product

Example: (Blog)

Post:
  application: Blog
Category:
  application: Blog
Tag:
  module: Post

Custom Views

You can add your custom views to match your application requirements. Views you can customize.

  • index.html.erb
  • edit.html.erb

Example:

You need a custom view on the Articles listing. Under app/view/typus/articles add the file index.html.erb and Typus default listing will be overrided.

Customize Interface

You can customize the interface by placing on views/typus the following files.

Dashboard

  • _dashboard_sidebar.html.erb
  • _dashboard_top.html.erb
  • _dashboard_bottom.html.erb

Models

  • MODEL/_index_top.html.erb
  • MODEL/_index_bottom.html.erb
  • MODEL/_new_top.html.erb
  • MODEL/_new_bottom.html.erb
  • MODEL/_new_bottom.html.erb
  • MODEL/_new_sidebar.html.erb
  • MODEL/_edit_top.html.erb
  • MODEL/_edit_bottom.html.erb
  • MODEL/_edit_bottom.html.erb
  • MODEL/_edit_sidebar.html.erb

Acknowledgments

Author, contact & bugs

You can contact me at fesplugas@intraducibles.net

BROWSE SOURCE on GitHub: http://github.com/fesplugas/typus

Copyright (c) 2007-2008 Francesc Esplugas Marti, released under the MIT license