Static Blocks
Static Blocks is an ultra light-weight CMS for Ruby on Rails. Create static blocks of content. Place them anywhere in your views.
Features
- Simple admin interface
- i18n internationalization support
- Optional http basic authentication
- Search
- wysihtml5 editor
Installation
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
Mount engine in routes.rb:
mount StaticBlocks::Engine => "/static_blocks_admin"
Usage
Visit /static_blocks_admin
and create some static blocks.
Use the static_block_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 static_block_for('foo') %>
<%=raw s('foo') %>
Configuration
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']
end
i18n Internationalization
Static Blocks supports i18n internationalization. Pass in an array of locales to it's config option:
config.locales = ['en', 'wk', 'zh', 'pirate']
Optional http basic authentication
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
Credits
Written by Travis Luong