Static Blocks

Static Blocks is an ultra light-weight CMS for Ruby on Rails.

Create snippets of content. Place them anywhere in your views.

• Simple admin interface
• i18n internationalization support
• Optional http basic authentication
• Search
• wysihtml5 editor
• csv import & export

Add the following to Gemfile:

gem 'static_blocks'

Run bundle from shell:

bundle install

Run static blocks install generator from shell:

rails generate static_blocks:install

Run migrations:

rake db:migrate

Ensure that engine is mounted in routes.rb:

mount StaticBlocks::Engine => "/static_blocks"

Visit /static_blocks and create some static blocks.

Use the snippet_for method or it's alias s to output a block onto any view template. Pass in the title of the static block as argument. Use raw if you do not want to escape the html.

<%=raw snippet_for('foo') %>
<%=raw s('foo') %>

When you ran the install generator, a configuration file should have been created in config/initializers/static_blocks.rb:

StaticBlocks.config do |config|
  config.locales = ['en']
  config.http_auth = false
  config.username = ENV['STATIC_BLOCKS_USERNAME']
  config.password = ENV['STATIC_BLOCKS_PASSWORD']
  config.wysihtml5 = true
end

Static Blocks supports i18n internationalization. Pass in an array of locales to it's config option:

config.locales = ['en', 'wk', 'pirate']

Static Blocks has an optional http basic authentication which is turned off by default. To activate, set the config option to true and create environment variables for the username and password.

config.http_auth = true

Static Blocks uses the wysihtml5 editor which is turned on by default. To deactive, set the config option to false.

Created by Travis Luong

MIT