MyFirstRails

ActiveAdmin使用ブログ!

概要

Railsにこれから初めて触れる人を対象にしたチュートリアルです

チュートリアル

Railsのひな型を作る

まず、rails newを実行し、Railsアプリのひな型を作成します

rails new railspress

次に、作成したRailsアプリのディレクトリへと移動します

cd railspress

SQLite3のバージョンを修正

先ほどのrails newでsqlite3のインストールがエラーになっている場合は、以下のようにバージョンを修正します

gem 'sqlite3', '1.3.13'

その後、bundle installを実行します

bundle install

これでOKです!

ActiveAdminの導入

まず、Gemfileに以下のgemを追加します

# Using ActiveAdmin
gem 'devise'
gem 'activeadmin'

その後、bundle installを実行します

bundle install

そして、rails g active_admin:installを実行します

rails g active_admin:install

その後、rails db:migrateを実行します

rails db:migrate

rails db:seedを実行し、ログイン用ユーザーのデータを作成します

rails db:seed

あとはrails sを実行し、localhost:3000/adminにアクセスします

localhost:3000/adminにアクセスするとログインフォームが表示されます IDとパスワードは以下の通りです

ID:admin@example.com
PASS:password

ログインできればActiveAdminの導入は完了です!

記事のModelを作成

rails g model Post title:string content:text auther:string date:date

その後、rails db:migrateを実行します

rails db:migrate

あとは、rails generate active_admin:resource postを実行してActiveAdminで管理できるようにします

rails generate active_admin:resource post

ActiveAdminの日本語化

まず、config/application.rbconfig.i18n.default_locale = :jaを追加します

config.i18n.default_locale = :ja

その後、config/locales/ja.ymlを追加します

ja:
  time:
    formats:
      long: "%d/%m/%Y %H:%M"
  date:
    formats:
      long:  "%d/%m/%Y %H:%M"

ActiveAdminの編集フォームにエディター導入

activeadmin_froala_editorを使い、記事内容にリッチテキストエディターを導入します

まずはGemfilegemを追加します

gem 'activeadmin_froala_editor'

その後、bundle installを実行します

bundle install

次に、app/assets/stylesheets/active_admin.scssSCSSを読み込ませます

@import 'font-awesome/font-awesome';
@import 'activeadmin/froala_editor_input'; 

app/assets/javascripts/active_admin.js.coffeeapp/assets/javascripts/active_admin.jsにリネームし、

//= require active_admin/base
//= require activeadmin/froala_editor/froala_editor.pkgd.min
//= require activeadmin/froala_editor_input

上記のJavaScriptファイルを読み込みます

次に、app/admin/posts.rbを以下のように編集します

ActiveAdmin.register Post do
    permit_params :title, :content, :auther, :date
    form do |f|
        f.inputs 'Article' do
          f.input :title
          f.input :content, as: :froala_editor
          f.input :auther
          f.input :date
        end
        f.actions
      end

end

app/views/resources/_show.html.erbを作成します

<p>
  <strong>Title:</strong>
  <%= resource.title %>
</p>

 <p>
  <strong>Content:</strong>
  <%= sanitize resource.content %>
</p>

 <p>
  <strong>Date:</strong>
  <%= resource.date %>
</p> 

最後に、app/admin/posts.rbに記事の個別ページのアクションを設定します

ActiveAdmin.register Post do
    permit_params :title, :content, :auther, :date

    show do
        render partial: 'resources/show'
    end

    form do |f|
        f.inputs 'Article' do
          f.input :title
          f.input :content, as: :froala_editor
          f.input :auther
          f.input :date
        end
        f.actions
      end

end

これで、ActiveAdminの管理画面から記事を作成する際にリッチテキストエディターを使用できるようになりました!

このままではデザインなどが簡素すぎるのでBootstrapを使いたいと思います。

まず、Gemfilegem 'bootstrap', '~> 4.2.1'gem 'jquery-rails'を追加し、bundle installします。

gem 'bootstrap', '~> 4.2.1'
gem 'jquery-rails'
bundle install

もし、gemの依存関係でうまくいかない場合は、bundle updateを実行してからbundle installを実行してください

bundle update
bundle install

その後、app/assets/javascripts/application.jsapp/assets/stylesheets/application.scssを下記のように変更します

// This is a manifest file that'll be compiled into application.js, which will include all the files
// listed below.
//
// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, or any plugin's
// vendor/assets/javascripts directory can be referenced here using a relative path.
//
// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
// compiled file. JavaScript code in this file should be added after the last require_* statement.
//
// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
// about supported directives.
//
//= require rails-ujs
//= require activestorage
//= require trix
//= require jquery3
//= require popper
//= require bootstrap-sprockets
//= require turbolinks
//= require_tree .
/*
 * This is a manifest file that'll be compiled into application.css, which will include all the files
 * listed below.
 *
 * Any CSS and SCSS file within this directory, lib/assets/stylesheets, or any plugin's
 * vendor/assets/stylesheets directory can be referenced here using a relative path.
 *
 * You're free to add application-wide styles to this file and they'll appear at the bottom of the
 * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
 * files in this directory. Styles in this file should be added after the last require_* statement.
 * It is generally better to create a new file per style scope.
 *
 *= require_tree .
 *= require_self
 */
 @import "trix";
 @import "bootstrap";

その後、config/boot.rbを以下のように修正します

ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __dir__)

ENV['EXECJS_RUNTIME'] = 'Node'

require 'bundler/setup' # Set up gems listed in the Gemfile.
require 'bootsnap/setup' # Speed up boot time by caching expensive operations.

これでBootstrapが使用できるようになりました。

最後に、app/views/layouts/_header.html.erbを作成し、app/views/layouts/application.html.erbでパーシャルとして呼び出します。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <%= link_to "Blog", root_path, class: "navbar-brand" %>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
</nav> 
<!DOCTYPE html>
<html>
  <head>
    <title>Rails Tube</title>
    <%= csrf_meta_tags %>
    <%= csp_meta_tag %>

    <%= stylesheet_link_tag    'application', media: 'all', 'data-turbolinks-track': 'reload' %>
    <%= javascript_include_tag 'application', 'data-turbolinks-track': 'reload' %>
  </head>

  <body>
    <%= render 'layouts/header'%>
    <div class="container">
      <%= yield %>
    </div>
  </body>
</html>

rails sでサーバを起動し、ナビゲーションバーが表示されていればOKです

記事の一覧&閲覧ページ作成

管理画面から記事を作成できる状態ですが、外部から記事を読むことはできていません

そこで、記事の一覧&閲覧ページを作成します

rails g controller post index show

次に、config/routes.rbにルーティングを設定します

Rails.application.routes.draw do
  root 'posts#index'
  resources :posts, :only => [:index, :show]
  devise_for :admin_users, ActiveAdmin::Devise.config
  ActiveAdmin.routes(self)
  # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html
end

そして、app/controllers/posts_controller.rbを以下のように変更します

class PostsController < ApplicationController
  before_action :set_post, :only => [:show]

  def index
    @posts = Post.all
  end

  def show
  end

  private
    def set_post
      @post = Post.find(params[:id])
    end
end

app/views/posts/index.html.erbを以下のように修正します

<div class="row">
<% @posts.each do |post| %>
    <div class="card col-lg-4" style="width: 18rem;">
        <div class="card-body">
            <h5 class="card-title"><%= post.title %></h5>
            <p class="card-text"><%= %></p>
            <%= link_to "Show Post", post_path(post), :class => "btn btn-primary" %>
        </div>
    </div>
<% end %>
</div>

次に、app/views/posts/show.html.erbを以下のように修正します

<h1><%= @post.title %></h1>

<p><%= sanitize @post.content %><p>

<h1>Auther</h1>

<%= @post.auther %>

これで作成した記事を見ることができるようになります!

コメント機能の作成

感想としてコメントを投稿できるようにしたいと思います

まず、コメントを取り扱うCommentモデルを作成します

rails g model comment content:text post:references

次にマイグレーションを行います

rails db:migrate

app/models/post.rbCommentとのリレーションを追加します

class Post < ApplicationRecord
    has_many :comments
end

config/routes.rbにてルーティングを設定します

Rails.application.routes.draw do
  root 'posts#index'
  resources :posts, :only => [:index, :show] do
    resources :comments, :only => [:create, :destroy]
  end
  devise_for :admin_users, ActiveAdmin::Devise.config
  ActiveAdmin.routes(self)
  # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html
end

次に、各記事にコメントフォームを追加します

<h1><%= @post.title %></h1>

<p><%= sanitize @post.content %><p>

<h1>Auther</h1>

<%= @post.auther %>

<h2>Comments</h2>
  <div id="comments">
    <%= render @post.comments %>
  </div>

<%= render 'comments/new', post: @post %> 

変更箇所としては、この部分になります

<h2>Comments</h2>
  <div id="comments">
    <%= render @post.comments %>
  </div>

<%= render 'comments/new', post: @post %> 

<%= render @post.comments %>の部分でコメントを一覧できるviewファイルをパーシャルとして呼び出しています

また、<%= render ‘comments/new’, post: @post %> の部分では新規作成するコメントのviewファイルをパーシャルとして呼び出しています

パーシャルとして呼び出している部分をそれぞれ作っていきます

まず、app/views/comments/_comment.html.erbを作成し、下記のようにします。

<p><%= comment.content %></p>
<p><%= link_to "Delete", [@post, comment], method: :delete, data: { confirm: 'Are you sure?' } %> 

次に、app/views/comments/_new.html.erbを作成します

<%= form_with(model: [ @post, Comment.new ], remote: true) do |form| %>
    Your Comment:<br>
    <%= form.text_area :content, size: '50x20' %><br>
    <%= form.submit %>
<% end %> 

これで、コメントの入力フォームが表示されるようになっているはずです

次に、コメントの作成と削除を行うアクションを作成します

app/controllers/comments_controller.rbを作成します

class CommentsController < ApplicationController
    before_action :set_post

    def create
        @post.comments.create! comments_params
        redirect_to @post
    end

    def destroy
        @post.comments.destroy params[:id]
        redirect_to @post
    end

     private
        def set_post
            @post = Post.find(params[:post_id])
        end

         def comments_params
            params.required(:comment).permit(:content)
        end
end

rails sでローカルサーバを建てて、実際にコメントが作成&削除できていればOKです。

これでActiveAdminを使用したブログアプリのチュートリアルは終わりです!