Rails/管理者だけが投稿できるミニアプリ！

Railsで開発中のアプリに
"管理者だけが投稿できる"機能を実装したいので、
まずはミニアプリで概要を掴むことにしました！

アプリの概要は、
・トップページに管理者が投稿したメッセージが一覧表示される
・投稿ページは管理者だけが遷移できる
・投稿は管理者だけができる
・ユーザーはログインの可否に関係なくメッセージ一覧が表示される
というとてもシンプルな内容です。

※ミニアプリ完成図
図1.ログアウト状態のトップページ

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
図2.管理者でログインした時:投稿ページへのリンクが表示される

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
図3.投稿画面

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
図4.投稿した内容はトップページに表示：仮に管理者以外のユーザーがログインしても新規投稿のページへのリンクは表示されない

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

0.開発環境

Ruby 2.6.5
Rails 6.0.0
DB mysql

１.全体の流れ

最初に全ての流れを説明します。
忙しい方は、ここだけ見て概要を掴んでいただければ幸いです。

------deviseの導入
・一般ユーザーの管理機能をつけるため gem 'devise'導入
・usersテーブルのカラムにboolean型でadminを追加する。
※adminはdefault: falseとする。
・seeds.rbに管理者用のデータを作成する。
※adminはdefault: trueとする。
・ターミナルでmigrate実行
・ターミナルでrails db:seed実行
(これで管理者のデータがDBに保存される)
・deviseのビューを作成rails g devise:views

------一般ユーザー用のトップページ画面作成
※投稿用のcontrollerをposts controllerという名前にして進めます(ここはご自由に)。
・postsコントローラーの作成 rails g controller posts
・ルーティング設定 indexだけを記述
・posts controllerにもdef index ~ endを記述
・index.html.erbに必要最低限の記述

------管理者用の投稿機能作成
↓ここがポイント！
・管理者用のコントローラーを作成 rails g controller admin::posts
・管理者用のViewも作成 rails g devise:views admins
・ルーティング設定 管理者用のnewアクション,createアクションを記述
※先程の一般ユーザー用のindexアクションとは別に記述するので注意。
・controller/admin/posts_controller に投稿のためのアクションを設定する
※before_actionで管理者か否かの設定をする。

------モデルの作成
・Postモデルを作成する rails g model Post
・UserモデルとPostモデル間のアソシエーションを各モデルに記述
・migrationファイルには、投稿内容を保存するtextと、投稿者を保存するuserカラムを追記する
・rails g db:migrate

------投稿用のViewの作成
・投稿画面に当たるviews/adimin/posts/new.html.erbに、
form_withを使用した投稿フォームを記述。

以上が、全体の流れです。
細かい記述の内容は下記の各項目を参照してください！

2-1.deviseの導入

まずは、一般ユーザーの新規登録・ログイン・ログアウト機能を実装するためにgem 'devise'を使用します。

Gemfile

gem 'devise'

terminal

bundle install

2-2.カラムにnicknameとadminを追加

db/migrate/devese_create_users.rb

t.string  :email,              null: false, default: ""
t.string  :encrypted_password, null: false, default: ""
t.string  :nickname,           null: false, default: ""
t.boolean :admin,                           default: false

マイグレートを実行する。
rails db:migrate

2-3.管理者用のデータを作成し、DBに保存する

db/seeds.rb

User.create!(nickname:  "管理者",
  email: "[e-mail]",
  password:  "11111111",
  password_confirmation: "11111111",
  admin: true)

これをDBに保存するには下記のコマンドを実行する。
rails db:seeds

これで管理者の情報がテーブルに反映される。

・最後にUserのviewページも作成しておく
rails g devise:views

3.indexビューの作成

・投稿を保存するPosts controllerを作成する
rails g controller posts

・ルーティングとコントローラーにindexアクション

config/routes.rb

  devise_for :users
  root to: 'posts#index'
  resources :posts, only: [:index]

app/controllers/posts_controller.rb

  def index
    @posts = Post.includes(:user).order("created_at DESC")
  end
# 最新投稿から順に表示する

・viewの作成
(下記は完成後のものなので、すでに管理者か否かの条件分岐も含まれています)

app/views/posts/index.html.erb

<h1>管理者の投稿メモを一覧表示<h1>
<div>
  <% if user_signed_in? %>
    <%= link_to 'ログアウト', destroy_user_session_path, method: :delete %>
    <%= "#{current_user.nickname}さんはログイン中です"%>
  <% else %>
    <%= link_to 'ユーザー新規登録', new_user_registration_path %>
    <%= link_to 'ログイン', new_user_session_path %>
  <% end %>
</div>

<div>
  <% if user_signed_in? && current_user.admin? %>
    <%= link_to '管理者用:投稿ページ', new_admin_post_path %>
  <% end %>
</div>

<div class="posts">
  <ul>＜管理者のメモ一覧＞
    <% @posts.each do |f| %>
      <li>
        <td><%= f.text %></td>
        <td><%= f.created_at %></td>
      </li>
    <% end %>
  </ul>
<div>

4.管理者用コントローラーとルーティング

・一般ユーザーとは別に管理者用のコントローラーを作成する。
rails g controller admin::posts

・ルーティングを追加記述

config/routes.rb

  devise_for :users
  root to: 'posts#index'
  resources :posts, only: [:index]

  namespace :admin do
    resources :posts, only: [:new, :create, :edit, :destroy]
  end

namespaceとは、URLとファイル構成を指定のパスにしたい場合に使います。
今回は、admin用のパスを指定したいので、使用しています。

ここでルーティングのパスを確認をすると、adminが追加されています。

% rails routes
   admin_posts POST   /admin/posts(.:format)　　　　　　admin/posts#create

・作成したコントローラーに管理者に付与したい処理を加えます。
before_actionでは、管理者以外が下記のアクションを実行するとトップページに遷移する設定を加えました。

controllers/admin/posts_controller.rb

class Admin::PostsController < ApplicationController
  #管理者ユーザー以外でアクションをしようとするとトップページに遷移する
  before_action :if_not_admin

  #管理者だけにさせたいアクションはここに記述する！
  def new
    @post = Post.new
  end

  def create
    @post = Post.new(post_params)
    if @post.valid?
      @post.save
      redirect_to root_path
    else
      render 'new'
    end
  end

#実装していないが削除は下記を参照
  def destroy
    post = Post.find(params[:id])
    post.destroy
  end


  private
  def if_not_admin
    redirect_to root_path unless current_user.admin?
  end

  def post_params
    params.require(:post).permit(:text).merge(user_id: current_user.id)
  end
end

・ここで、管理者用のViewも作成しておきます。
rails g devise:views admins

5.モデルの作成

・投稿を保存するPostモデルを作成します.
rails g model post

・モデル間のアソシエーションは下記の通りです。

app/models/post.rb

class Post < ApplicationRecord
  belongs_to :user
end

app/models/user.rb

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable
  has_many :posts
end

・Postsのマイグレーションファイルは下記のようになります。

config/db/migrate/create_posts.rb

class CreatePosts < ActiveRecord::Migration[6.0]
  def change
    create_table :posts do |t|
      t.text         :text,  null: false
      t.references   :user, foreign_key: true
      t.timestamps
    end
  end
end

・migrateを実行
rails g db:migrate

6.最後に投稿画面の作成

ここで注意するのは、
new.html.erbのディレクトリです！
index.html.erbのあるapp/views/postsには作成しません。
前に作成した管理者用のviewフォルダに新規投稿のビューを作成します。

views/admin/posts/new.html.erb

<h1>メモ投稿ページ<h1>
<%= form_with url: admin_posts_path, model: @post, local: true do |form| %>
  <%= form.text_area :text, placeholder: "text", rows: "5", cols: "30" %>
  <%= form.submit "投稿する" %>
<% end %>

これで、冒頭に掲載した超簡易的ミニプリの完成です！
面倒でも、ミニアプリを作りながら機能を理解していくのはおすすめです！！
※ご指摘・アドバイスお待ちしております。閲覧ありがとうございました。

00.　参考記事