Bootsy is a WYSIWYG editor for Rails based on Bootstrap-wysihtml5 with image uploads using CarrierWave.
4;3 fully installed in your app.gem 'bootsy'
bundle install
bundle exec rails generate bootsy:install
It will include the javascripts and stylesheets in the assets pipeline,
create the bootsy.rb initializer and add a copy of the english translations.
Note: If your project uses SASS or LESS and application.css does not exist,
you will be required to require bootsy manually using *= require bootsy or if you prefer
to import assets yourself @import "bootsy";
bundle exec rake bootsy:install:migrations
bundle exec rake db:migrate
Just call bootsy_area in your FormBuilder instances, the
same way you'd call textarea. Example:
<%= form_for(@post) do |f| %>
<%= f.label :title %>
<%= f.text_field :title %>
<%= f.label :content %>
<%= f.bootsy_area :content %>
<%= f.submit %>
<% end %>
Bootsy will group the uploaded images as galleries and associate them to one of
your models. For instance, if you have a Post model and you want to use bootsy_area
with it, you must include the Bootsy::Container module:
class Post < ActiveRecord::Base
include Bootsy::Container
end
Don't forget to ensure the association between your model objects with Bootsy
image galleries. For strong_parameters, you must whitelist the bootsy_image_gallery_id parameter
in your controller:
private
def post_params
params.require(:post).permit(:title, :content, :bootsy_image_gallery_id)
end
You can use bootsy as an input type in SimpleForm::FormBuilder instances. Example:
<%= simple_form_for @post do |f| %>
<%= f.input :title %>
<%= f.input :content, as: :bootsy %>
<%= f.button :submit %>
<% end %>
You can customize Bootsy through a hash of editor_options:
You can enable and disable features as you like. For instance, if you don't want link and color features:
<%= f.bootsy_area :my_attribute, editor_options: { link: false, color: false } %>
Available options are: :blockquote, :font_styles, :emphasis, :lists, :html, :link, :image and :color.
By default Bootsy alerts the user about unsaved changes if the page is closed or reloaded. You can disable this feature with:
<%= f.bootsy_area :my_attribute, editor_options: { alert_unsaved: false } %>
If you don't want to have image uploads, just call bootsy_area in a form builder not
associated to a Bootsy::Container model. This way users will still be able to insert
images in the text area using an external image URL.
You can set the default editor options, image sizes available (small, medium,
large and/or its original), dimensions and more. Take a look at Bootsy's initalizer
file /config/initializers/bootsy.rb in your app and feel free to uncomment and change
the options as you like.
Bootsy defines some I18n keys. English translations are added by default to your
config/locales directory as bootsy.en.yml. You can use it as a template
to translate Bootsy to your language.
Here are some examples.
You also need to translate Bootsy on the JavaScript side. Just follow
this example.
Bootsy will try to guess the locale based on the lang attribute of the page's <html> tag.
You can set the locale directly by setting a data-bootsy-locale attribute on your <textarea>.
MIT License. Copyright 2012-2015 Volmer Soares
FAQs
Unknown package
We found that bootsy_full_html demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
MCP spec updated with structured tool output, stronger OAuth 2.1 security, resource indicators, and protocol cleanups for safer, more reliable AI workflows.
Security News
More than half of CISOs now manage 10+ security areas, often with few legal safeguards and short tenures, yet continue to secure budgets and higher pay.
Security News
Libxml2’s solo maintainer drops embargoed security fixes, highlighting the burden on unpaid volunteers who keep critical open source software secure.