Landable is an API for building your CMS. It's implemented as a Rails Engine. We like to use Landable with Publicist, a great UI for managing content.
Landable requires Postgres. Make sure you have Postgres installed and configured in your app.
Add gem 'landable' to your project's Gemfile and run bundle.
Run bundle exec rails g landable:install, and update the landable initializer to taste.
Open your routes file, and ensure that the engine is mounted properly. Typically, this will be your final, catch-all route:
My::Application.routes.draw do
mount Landable::Engine => '/'
endInstall Landable's migrations:
rake landable:install:migrations
rake db:migrateCheckout the wiki for steps on configuration.
Landable includes the ability to track visits.
Landable.configure do |config|
# To enable tracking, put one of the following in your Landable initializer:
config.traffic_enabled = true # Enables tracking for all requests. (:all is also accepted here.)
config.traffic_enabled = :html # Enables tracking for only HTML requests.
endRead more about Visit Tracking
Run ./script/redb to refresh the dummy app's database.
Run the test suite with rake landable.
Contributions are welcome - submit a pull request.
- Do include specs to back up all code changes.
- Do add your changes to the "unreleased" section of CHANGELOG.md (adding this section if it does not exist). Include the pull request number.
- Don't bump Landable's version number.
Landable is released under the MIT License.