+ action_text + active_storage

Author: palkan

src/content/tutorial/11-rich-text/1-action-text/_files/.tk-config.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../../../../templates/active-storage"
+}

src/content/tutorial/11-rich-text/1-action-text/_files/workspace/.keep

@@ -0,0 +1,9 @@
+<% cache @product do %>
+  <h1><%= @product.name %></h1>
+<% end %>
+
+<%= link_to "Back", products_path %>
+<% if authenticated? %>
+  <%= link_to "Edit", edit_product_path(@product) %>
+  <%= button_to "Delete", @product, method: :delete, data: { turbo_confirm: "Are you sure?" } %>
+<% end %>

src/content/tutorial/11-rich-text/1-action-text/_files/workspace/store/app/views/products/show.html.erb

@@ -0,0 +1,84 @@
+---
+type: lesson
+title: Rich Text Fields with Action Text
+focus: /workspace/store/app/models/product.rb
+previews:
+  - 3000
+custom:
+  shell:
+    workdir: "/workspace/store"
+---
+
+Rich Text Fields with Action Text
+---------------------------------
+
+Many applications need rich text with embeds (i.e. multimedia elements) and
+Rails provides this functionality out of the box with Action Text.
+
+To use Action Text, you'll first run the installer:
+
+```bash
+$ bin/rails action_text:install
+$ bin/rails db:migrate
+```
+
+Restart your Rails server to make sure all the new features are loaded.
+
+Now, let's add a rich text description field to our product.
+
+First, add the following to the `Product` model:
+
+```ruby ins={2}
+class Product < ApplicationRecord
+  has_rich_text :description
+  validates :name, presence: true
+end
+```
+
+The form can now be updated to include a rich text field for editing the
+description in `app/views/products/_form.html.erb` before the submit button.
+
+```erb ins={4-7}
+<%= form_with model: product do |form| %>
+  <%# ... %>
+
+  <div>
+    <%= form.label :description, style: "display: block" %>
+    <%= form.rich_textarea :description %>
+  </div>
+
+  <div>
+    <%= form.submit %>
+  </div>
+<% end %>
+```
+
+Our controller also needs to permit this new parameter when the form is
+submitted, so we'll update the permitted params to include description in
+`app/controllers/products_controller.rb`
+
+```ruby ins={3}
+    # Only allow a list of trusted parameters through.
+    def product_params
+      params.expect(product: [ :name, :description ])
+    end
+```
+
+We also need to update the show view to display the description in
+`app/views/products/show.html.erb`:
+
+```erb ins={3}
+<% cache @product do %>
+  <h1><%= @product.name %></h1>
+  <%= @product.description %>
+<% end %>
+```
+
+The cache key generated by Rails also changes when the view is modified. This
+makes sure the cache stays in sync with the latest version of the view template.
+
+Create a new product and add a description with bold and italic text. You'll see
+that the show page displays the formatted text and editing the product retains
+this rich text in the text area.
+
+Check out the [Action Text Overview](https://guides.rubyonrails.org/action_text_overview.html) to learn more.

src/content/tutorial/11-rich-text/1-action-text/content.md

@@ -0,0 +1,7 @@
+---
+type: part
+title: Rich Text
+prepareCommands:
+  - ['npm install', 'Preparing Ruby runtime']
+  - ['node scripts/rails.js db:prepare', 'Prepare development database']
+---

src/content/tutorial/11-rich-text/meta.md

@@ -0,0 +1,3 @@
+{
+  "extends": "../../../../../templates/active-storage"
+}

src/content/tutorial/12-file-uploads/1-active-storage/_files/.tk-config.json

@@ -0,0 +1,49 @@
+class ProductsController < ApplicationController
+  allow_unauthenticated_access only: %i[ index show ]
+  before_action :set_product, only: %i[ show edit update destroy]
+
+  def index
+    @products = Product.all
+  end
+
+  def show
+  end
+
+  def new
+    @product = Product.new
+  end
+
+  def create
+    @product = Product.new(product_params)
+    if @product.save
+      redirect_to @product
+    else
+      render :new, status: :unprocessable_entity
+    end
+  end
+
+  def edit
+  end
+
+  def update
+    if @product.update(product_params)
+      redirect_to @product
+    else
+      render :edit, status: :unprocessable_entity
+    end
+  end
+
+	def destroy
+    @product.destroy
+    redirect_to products_path
+  end
+
+  private
+    def set_product
+      @product = Product.find(params[:id])
+    end
+
+    def product_params
+      params.expect(product: [ :name, :description ])
+    end
+end

src/content/tutorial/12-file-uploads/1-active-storage/_files/workspace/.keep

@@ -0,0 +1,4 @@
+class Product < ApplicationRecord
+  has_rich_text :description
+  validates :name, presence: true
+end

src/content/tutorial/12-file-uploads/1-active-storage/_files/workspace/store/app/controllers/products_controller.rb

@@ -0,0 +1,15 @@
+<%= form_with model: product do |form| %>
+  <div>
+    <%= form.label :name %>
+    <%= form.text_field :name %>
+  </div>
+
+  <div>
+    <%= form.label :description, style: "display: block" %>
+    <%= form.rich_textarea :description %>
+  </div>
+
+  <div>
+    <%= form.submit %>
+  </div>
+<% end %>