Hera aims to enable you to easily add Content Managment to your Rails projects, with a very friendly user interface.
gem 'hera_cms'
bundle
rails g hera_cms:install
rails db:migrate
First, you need to add the Hera routes. Its highly recommended that you add some authentication logic (with devise or another library) to the routes level. Example with Devise:
# config/routes.rb
authenticate :user, lambda { |u| u.admin? } do
mount HeraCms::Engine => "/hera_cms"
end
Then, you need to add the Hera navbar to your layout. Here is also highly recommended to add authentication logic, in order to restrict who is able to update the content of your website. Example with Devise:
# app/views/layouts/application.html.erb
<!DOCTYPE html>
<html>
<head>
<!-- ... -->
</head>
<body>
<!-- ... -->
<% if current_user&.admin? %>
<%= hera_admin_navbar %>
<% end %>
<%= yield %>
<!-- ... -->
</body>
</html>
We use hera_cms tables to store the editable content of your website, in order for it to be updatable dynamically by the website owner.
There are 3 types of editable content you can use: Links, Texts and Images
To add an editable link to the view, you first need to create it in the rails console
# rails console
pry(main)> HeraCms::Link.create(identifier: 'home-link-main', inner_text: "HortaTech", path: 'https://www.hortatech.com.br')
Then you can just add it to the view using the Hera Link Helper, passing the correct identifier
<!-- ... -->
<%= hera_link 'home-link-main' %>
<!-- ... -->
Alternatively, you can create links passing a block, similar to the link_to rails helper
<!-- ... -->
<%= hera_link 'home-link-main', class: 'main-link' do %>
<div class="card">
<p>Lorem ipsum</p>
</div>
<% end %>
<!-- ... -->
To add an editable text to the view, it is exactly like addings links. You first need to create it in the rails console
# rails console
pry(main)> HeraCms::Text.create(identifier: 'home-description', inner_text: "These are not the droids you're looking for")
Then you can just add it to the view using the Hera Text Helper, passing the correct identifier
<!-- ... -->
<%= hera_text 'home-description', html_tag: :p %>
<!-- ... -->
To use images that the owner can edit the SRC URL that will be displayed, it's almost the same as the other models
First you create the image in the rails console
# rails console
pry(main)> HeraCms::Image.create(identifier: 'tutorial-01', url: 'https://picsum.photos/200/300')
Then you add it to the view using the Hera Image Helper, passing the correct identifier
<!-- ... -->
<%= hera_image 'tutorial-01' %>
<!-- ... -->
Hera currently has support for Image uploads with Active Storage. To enable the owner to change the editable Images by uploading new images, you first need to configure Active Storage properly, according to the Active Storage Documentation
After Active Storage is properly set, you will need to update the HeraCms config file
# config/initializers/hera.rb
HeraCms.setup do |config|
config.image_upload = true
config.upload_service = :active_storage
end
And create an image with upload in the rails console
# rails console
pry(main)> image = HeraCms::Image.new(identifier: 'tutorial-02')
pry(main)> image.upload.attach(io: File.open(Rails.root.join('app/assets/images/logo.jpg')), filename: 'logo.jpg')
pry(main)> image.save
In order to facilitate you not have to duplicate all of your created records from development to production, we use a YAML file to store all record's information from development, located at db/hera_cms/hera_database_seed.yml
After you finish developing your application and want to build it in production, you can just run this command in production to replicate your created Hera Links, Texts and Images to your production database
rails hera_cms:populate_database
For the image uploads, you will have to re-attach your image files to your populated production images
If you want to contribute, feel free to open an issue or contact me at rayan@hortatech.com.br
The gem is available as open source under the terms of the MIT License.
FAQs
Unknown package
We found that hera_cms 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
AGENTS.md is a fast-growing open format giving AI coding agents a shared, predictable way to understand project setup, style, and workflows.
Security News
/Research
Malicious npm package impersonates Nodemailer and drains wallets by hijacking crypto transactions across multiple blockchains.
Security News
This episode explores the hard problem of reachability analysis, from static analysis limits to handling dynamic languages and massive dependency trees.