SiteFramework

A site framework for Ruby on Rails web framework inspired by Django site fremework. The idea of this gem to transparently make Rails apps to work with different domains.

Warning: This gem is still on development. I’ll be happy to have your feedback.

Installation

Add site_framework to your Gemfile:

ruby gem 'site_framework'

and after installing your project dependencies using bundle install command. Install SiteFramework migrations like:

bash rake site_framework:install:migrations

That’s it.

Usage

SiteFramework provides to solution to multi-site support.

In both solution you have to add a migration for your tables and make them domain aware (ActiveRecord Only). e.g in your migration:

ruby # Make posts table domain aware domain_aware(:posts)

If you’re using Mongoid just add a reference to SiteFramework::Domain in your model.

When a request arrives to the Rails application SiteFramework will add three different methods to Rails.application.

domain: An instance of SiteFramework::Domain model which refer to current domain of the request
domain_name: Current domain as string.
Site: An instance of SiteFramework::Site model which refer to current site.

A) Rack middleware:

Simply add SiteFramework::Middleware to your middleware stack.

B) Constrants

Just use sites DSL in your routes.rb. e.g:

```ruby Rails.application.routes.draw do

# Share routes get ‘home/index’

# All the routes defined in this section will be domain aware. sites(self) do root ‘home#index’ end

default_site(self) do # routs for default site end end ``` Note: You can provide default domains for SiteFramework via an initializer like this:

```ruby SiteFramework.setup do |config|

config.default_domains = [‘localhost’, ‘example.com’]

end ```

Personally I prefer this (B) option since it’s more Railish.

Access Current Site and Domain in Controllers

After installing site_framework you’ll have site, domain and domain_name methods on your request objects to access the respected models. But if current request belongs to default site the return value of these methods would be nil

Access Current Site/Domain elsewhre

You can access to current site, domain and domain_name via SiteFramework::CurrentState object every where just like this:

ruby SiteFramework::CurrentState.instance.site SiteFramework::CurrentState.instance.domain SiteFramework::CurrentState.instance.domain_name

In case of default site these methods will return nil

Model Concern

SiteFramework provides an ActiveSupport concern which transparently makes your models aware of the current Site and Domain. By includeing SiteFramework::DomainAware into your model, default scope of your model will change to return only records which belongs to current Site.

This way you can use external gems with your multi-site application easily. All you have to do is to open there models and include the given concern.

Piece of cake. right?

Default template

Since v4.0 site model contains a field aka default_template which is blank by default. By default if current request does not belongs to default site and default_template is not blank, site framework will prepend the default_template to view_path of your application.

By this feature each site can have their own set of views.

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Credit

SiteFramework is maintained and funded by Yellowen. Whenever a code snippet is borrowed or inspired by existing code, we try to credit the original developer/designer in our source code. Let us know if you think we have missed to do this.