Skip to content
This repository has been archived by the owner on Nov 30, 2022. It is now read-only.

Latest commit

 

History

History
53 lines (30 loc) · 2.1 KB

multisite.md

File metadata and controls

53 lines (30 loc) · 2.1 KB
Raw

Multisite

Guts has scoped-query support for multsite. You can run the same Guts installation for multiple domains.

How It Works

All models for Guts except for Groups, Users, and Sites, have a default_scope which scopes the queries to the current domain.

So using for example, Guts::Content.all will show all content for the current domain only.

Getting Started

Admin Setup

Open Guts' dashboard and head to Sites in the sidebar. From here, there's two ways to handle your situation...

  1. The current domain is the "default", you add the extra domains
  2. No current "default", you add a default domain and the extra domains

In most cases, you'll use options one and have example.com pointing for Guts (meaning you don't add it in the sites section), then you'd add your secondary domains such as fr.example.com.

Code Setup

Open your application_controller.rb file and add include Guts::MultisiteConcern.

This will do two things:

  1. Adds a before_action to set the current site (@current_site) based on the domain, which is also usable in your views
  2. Adds a around_action which tells the Site model which site ID we're requesting so the models can be scoped to only show data for the current site.

For more insight into this concern see app/concerns/guts/multisite_concern.rb or view the YARD documenation.

Misc. Notes

"Set as Default" option

The Set as Default option the in sites section internally means nothing to Guts. It simply flags the site a boolean value to determine if you've set it as the a default which you can then use in your application (maybe to query it, etc).

Users & Groups

Currenly multisite support does not scope users and groups. This means the same users and groups will appear in all domains.

Unscoping

Because for most models, a default_scope is provided, you may wish to remove this scope in some use-cases (such as pulling content from all sites not just the current site). Simply add unscoped to your ActiveRecord queries.

# For current site
Guts::Content.where(type: @type)

# For all
Guts::Content.unscoped.where(type: @type)