AGENT SKILL

plugin-cms

Tạo, sửa, kiểm thử và đóng gói plugin Laravel CMS với manifest, lifecycle, routes, admin console, widget, schema, hook, shortcode, asset, migration và permission; tách đúng trang quản lý trong admin menu khỏi trang cấu hình trong khu vực Plugins.

License 许可
MIT
最近更新
2026-09-04
Stars
★ 0
Forks
0

01 前言 Front Matter

name
plugin-cms
license
MIT
metadata
{ "version": "2.2.0" }
description
Tạo, sửa, kiểm thử và đóng gói plugin Laravel CMS với manifest, lifecycle, routes, admin console, widget, schema, hook, shortcode, asset, migration và permission; tách đúng trang quản lý trong admin menu khỏi trang cấu hình trong khu vực Plugins.

02 资源文件 9

03 SKILL.md 正文

CMS Plugin Builder

Mở rộng C:\xampp\htdocs\cms bằng plugin tự chứa trong plugins/{slug}. Giữ logic/chức năng trong plugin, không sửa core/theme chỉ để phục vụ một plugin.

Workflow

  1. Đọc lifecycle-structure.md để xác định scope, slug, cấu trúc và lifecycle.
  2. Đọc manifest-routes.md trước khi viết manifest/routes/permission.
  3. Nếu có widget, đọc widgets-settings.md; nếu có admin lớn, đọc admin-console.md.
  4. Đọc data-migrations.md cho dữ liệu riêng và frontend-hooks-shortcodes.md cho frontend, hook hoặc shortcode. Nếu plugin có bất kỳ giao diện nào, bắt buộc đọc localization.md.
  5. Đọc assets-package.md, rồi chạy validation.md trước khi handoff.

Non-Negotiable

  • Bắt buộc có plugins/{slug}/plugin.json; plugin active mới đăng ký route/view/widget/hook/asset.
  • Dùng registry/manifest cho menu, permission và route; không sửa sidebar/core auth chỉ để vá điều hướng của một plugin.
  • admin_menu chỉ mở trang nghiệp vụ/quản lý độc lập trong admin panel; trang này không dùng admin.plugins._sidebar.
  • settings_route là lối vào cấu hình chi tiết từ nút Cấu hình và sidebar Danh sách plugin; sidebar này chỉ xuất hiện trong khu vực cấu hình plugin và không mở route nghiệp vụ.
  • Không tạo tab nội bộ nối trang quản lý với trang cấu hình. Giữ hai luồng điều hướng độc lập.
  • Giữ widget fields trong settings_schema; console cấu hình chỉ giữ plugin-wide settings và resource cấu hình, còn CRUD/workflow nghiệp vụ nằm ở trang quản lý.
  • Deactivate không xóa data; migration/update phải bảo toàn dữ liệu.
  • Plugin self-contained dùng plugin-assets/{slug}, không phụ thuộc theme cụ thể.
  • Plugin có giao diện frontend hoặc admin phải tự chứa ít nhất hai locale vi và en; vi là mặc định và fallback. Không đặt chuỗi nghiệp vụ của plugin trong bộ dịch theme. Chỉ bổ sung locale khác khi theme/yêu cầu cụ thể cần đến.
  • Giữ locale qua GET, POST, validation và redirect; không chấp nhận giao diện chỉ dịch menu hoặc tiêu đề trong khi nội dung còn hard-code.
  • Escape dữ liệu, CSRF form, giới hạn query, prefix CSS/JS và chống boot trùng.
  • Đóng ZIP không chứa cache, vendor, node_modules, path máy dev hoặc theme cũ.

Handoff

Báo path/plugin state, admin route, widget/shortcode/hook, migration, asset, lệnh kiểm tra và ZIP nếu có.

04 同仓库更多 Skills