Overview¶ ↑
ActiveScaffold
provides a quick and powerful user interfaces for CRUD (create, read, update, delete) operations for Rails applications. It offers additonal features including searching, pagination & layout control. Rails >= 5.2.0 is supported, ruby >= 2.5 required.
Branch Details¶ ↑
3-7-stable supports rails >= 5.2.x and <= 7.1.x, and ruby >= 2.5.0
These versions are not supported anymore:
3-6-stable supports rails >= 4.2.x and <= 6.1.x, and ruby >= 2.3.0 3-5-stable supports rails >= 4.0.x and <= 5.1.x, and ruby >= 2.0.0
3-4-stable supports rails >= 3.2.x and <= 4.2.x, and ruby >= 1.9.3
3-3-stable supports rails 3.2.x and ruby >= 1.8
rails-3.2 supports Rails 3.1 & 3.2, and is the current source of the 3.2.x line of gems.
Quick Start¶ ↑
To get started with a new Rails project
Added to Gemfile
gem 'active_scaffold'
For rails >= 5.1, add jquery-rails to Gemfile, and install generator will jquery to application.js before rails-ujs. Also it’s possible to load jquery in your layout before application.js using CDN (e.g. jquery-rails-cdn). You can replace rails-ujs with jquery_ujs, although rails-ujs should work (never load both).
gem 'jquery-rails'
For rails >= 6.0, installer generator will create app/assets/javascripts/application.js, add it to assets.precompile array and add javascript_include_tag in layout, as ActiveScaffold
doesn’t work with webpack yet. Jquery may be loaded by packs or assets pipeline.
Run the following commands, for rails 4.2
bundle install rails g active_scaffold:install bundle exec rake db:create rails g active_scaffold:resource Model [attrs] bundle exec rake db:migrate
Or run the following commands, for rails >= 5
bundle install rails g active_scaffold:install rails db:create rails g active_scaffold:resource Model [attrs] rails db:migrate
Run the app and visit localhost:3000/<plural_model>
It’s recommended to call clear_helpers
in ApplicationController, as some helpers defined by ActiveScaffold
, such as active_scaffold_enum_options, options_for_association_conditions, association_klass_scoped, are usually overrided for different controllers, and it may cause issues when all helper modules are available to every controller, specially when models have associations or columns with the same name but need different code for those overrided helper methods.
Threadsafe¶ ↑
Threadsafe can be enabled calling ActiveScaffold.threadsafe!
in an initializer. It should be enabled on app start and it can’t be disabled. Threadsafety is a new feature and not well tested yet.
Configuration¶ ↑
See Wiki for instructions on customising ActiveScaffold
and to find the full API details.
Credits¶ ↑
ActiveScaffold
grew out of a project named Ajaxscaffold dating back to 2006. It has had numerous contributors including:
ActiveScaffold
Gem/Plugin by Scott Rutherford (scott@caronsoftware.com), Richard White (rrwhite@gmail.com), Lance Ivy (lance@cainlevy.net), Ed Moss, Tim Harper and Sergio Cambra (sergio@programatica.es)
Uses DhtmlHistory by Brad Neuberg (bkn3@columbia.edu) codinginparadise.org
Uses Querystring by Adam Vandenberg adamv.com/dev/javascript/querystring
Uses Paginator
by Bruce Williams paginator.rubyforge.org/
Supports RecordSelect by Lance Ivy and Sergio Cambra github.com/scambra/recordselect/
License¶ ↑
Released under the MIT license (included)
A ruby translation project managed on Locale that’s open to all!
Contributing to active_scaffold¶ ↑
-
Edit the translations directly on the active_scaffold project on Locale.
-
That’s it!
-
The maintainer will then pull translations from the Locale project and push to Github.
Happy translating!