Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A slice'ified fork of merb_mart

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 app
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 public
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO

A slice for the Merb framework. 


Instructions for installation:

file: config/init.rb

# add the slice as a regular dependency

dependency 'merb-E-mart'

# if needed, configure which slices to load and in which order

Merb::Plugins.config[:merb_slices] = { :queue => ["MerbEMart", ...] }

# optionally configure the plugins in a before_app_loads callback

Merb::BootLoader.before_app_loads do
  Merb::Slices::config[:merb_E_mart] = { ... }

file: config/router.rb

# example: /merb-E-mart/:controller/:action/:id


# example: /foo/:controller/:action/:id

r.add_slice(:MerbEMart, 'foo') # same as :path => 'foo'

# example: /:lang/:controller/:action/:id (with :a param set)

r.add_slice(:MerbEMart, :path => ':lang', :params => { :a => 'b' })

# example: /:controller/:action/:id


Normally you should also run the following rake task:

rake slices:merb_E_mart:install


You can put your application-level overrides in:

host-app/slices/merb-E-mart/app - controllers, models, views ...

Templates are located in this order:

1. host-app/slices/merb-E-mart/app/views/*
2. gems/merb-E-mart/app/views/*
3. host-app/app/views/*

You can use the host application's layout by configuring the
merb-E-mart slice in a before_app_loads block:

Merb::Slices.config[:merb_E_mart] = { :layout => :application }

By default :merb_E_mart is used. If you need to override
stylesheets or javascripts, just specify your own files in your layout
instead/in addition to the ones supplied (if any) in 

In any case don't edit those files directly as they may be clobbered any time
rake merb_E_mart:install is run.


About Slices

Merb-Slices is a Merb plugin for using and creating application 'slices' which
help you modularize your application. Usually these are reuseable extractions
from your main app. In effect, a Slice is just like a regular Merb MVC
application, both in functionality as well as in structure.

When you generate a Slice stub structure, a module is setup to serve as a
namespace for your controller, models, helpers etc. This ensures maximum
encapsulation. You could say a Slice is a mixture between a Merb plugin (a
Gem) and a Merb application, reaping the benefits of both.

A host application can 'mount' a Slice inside the router, which means you have
full over control how it integrates. By default a Slice's routes are prefixed
by its name (a router :namespace), but you can easily provide your own prefix
or leave it out, mounting it at the root of your url-schema. You can even
mount a Slice multiple times and give extra parameters to customize an
instance's behaviour.

A Slice's Application controller uses controller_for_slice to setup slice
specific behaviour, which mainly affects cascaded view handling. Additionaly,
this method is available to any kind of controller, so it can be used for
Merb Mailer too for example.

There are many ways which let you customize a Slice's functionality and
appearance without ever touching the Gem-level code itself. It's not only easy
to add template/layout overrides, you can also add/modify controllers, models
and other runtime code from within the host application.

To create your own Slice run this (somewhere outside of your merb app):

$ merb-gen slice <your-lowercase-slice-name>
Something went wrong with that request. Please try again.