README

Giới thiệu: Đây là package dùng để quản lý bình luận của SudoCms.

Mặc định package sẽ tạo ra giao diện quản lý cho toàn bộ bình luận được đặt tại /{admin_dir}/comments, trong đó admin_dir là đường dẫn admin được đặt tại config('app.admin_dir')

Cài đặt để sử dụng

• Package cần phải có base sudo/core để có thể hoạt động không gây ra lỗi
• Để có thể sử dụng Package cần require theo lệnh composer require sudo/comment
• Chạy php artisan migrate để tạo các bảng phục vụ cho package

Publish

Mặc định khi chạy lệnh php artisan sudo/core đã sinh luôn cho package này, nhưng có một vài trường hợp chỉ muốn tạo lại riêng cho package này thì sẽ chạy các hàm dưới đây:

• Khởi tạo chung theo core
  • Tạo configs php artisan vendor:publish --tag=sudo/core
  • Chỉ tạo configs php artisan vendor:publish --tag=sudo/core/config
  • Chỉ tạo assets php artisan vendor:publish --tag=sudo/core/asset
  • Chỉ tạo views php artisan vendor:publish --tag=sudo/core/view
• Khởi tạo riêng theo package
  • Tạo configs php artisan vendor:publish --tag=sudo/comment
  • Chỉ tạo configs php artisan vendor:publish --tag=sudo/comment/config
  • Chỉ tạo assets php artisan vendor:publish --tag=sudo/comment/asset
  • Chỉ tạo views php artisan vendor:publish --tag=sudo/comment/view

Cấu hình tại Menu

[
	'type' 		=> 'single',
	'name' 		=> 'Bình luận',
	'icon' 		=> 'fas fa-comments',
	'route' 	=> 'admin.comments.index',
	'role'		=> 'comments_index'
],

• Vị trí cấu hình được đặt tại config/SudoMenu.php
• Để có thể hiển thị tại menu, chúng ta có thể đặt đoạn cấu hình trên tại config('SudoMenu.menu')

Cấu hình tại Module

'comments' => [
	'name' 			=> 'Bình luận',
	'permision' 	=> [
		[ 'type' => 'index', 'name' => 'Truy cập' ],
		[ 'type' => 'create', 'name' => 'Thêm' ],
		[ 'type' => 'edit', 'name' => 'Sửa' ],
		[ 'type' => 'restore', 'name' => 'Lấy lại' ],
		[ 'type' => 'delete', 'name' => 'Xóa' ],
	],
],

• Vị trí cấu hình được đặt tại config/SudoModule.php
• Để có thể phân quyền, chúng ta có thể đặt đoạn cấu hình trên tại config('SudoModule.modules')

Cách dùng

Include view dưới đây để có thể nhúng bình luận tại vị trí được sử dụng

@include('Comment::list', [
	'type' => 'posts',
	'type_id' => 1,
	'regulation_link' => '#',
	'no_comment_text' => 'Hãy để lại bình luận của bạn tại đây!'
])

Trong đó

• type: là tên bảng và cũng là tên module
• type_id: là id thuộc bảng
• regulation_link: Đường dẫn đến trang Quy định bình luận
• no_comment_text: Khi không có comments sẽ hiển thị text này

Truy cập config/SudoComment.php (Sau khi publish) để biết thêm các giá trị được hỗ trợ khác.