ACMS 內(nèi)容管理系統(tǒng)插件

ACMS（Advanced Content Management System）是基于 Webman 框架開發(fā)的內(nèi)容管理系統(tǒng)插件，支持文章、分類、標簽、評論等功能，適用于技術(shù)博客、資訊站點等內(nèi)容型網(wǎng)站。

概述

ACMS 提供了一套完整的內(nèi)容管理解決方案，集成 Webman Admin 和 Webman User，支持權(quán)限管理、菜單配置及前后臺功能，適用于快速搭建內(nèi)容型網(wǎng)站。

主要功能

• 文章管理：支持發(fā)布、編輯、刪除、置頂、推薦及狀態(tài)切換。
• 分類管理：支持多級分類，包含 SEO 字段配置。
• 標簽管理：支持標簽增刪改查及文章標簽關聯(lián)。
• 評論管理：支持評論審核、回復、刪除及點贊功能。
• 前臺展示：提供文章列表、詳情、分類、標簽、搜索及評論功能（需登錄）。
• 后臺管理：基于 Webman Admin，集成權(quán)限與菜單管理。

安裝步驟

環(huán)境要求

• 已安裝 Webman 框架。
• 已配置數(shù)據(jù)庫。
• 已安裝 Webman Admin 和 Webman User 插件。
• 安裝以下擴展（用于 Blade 模板和分頁）：

  composer require psr/container webman/blade jasongrimes/paginator

安裝流程

直接在admin插件中心安裝即可。這是最簡單和方便的?。ㄍ扑]）

下面是手動安裝的方法：

1. 解壓插件
   將 plugin/acms.zip 解壓到 plugin/acms/ 目錄，或直接將源碼放入 plugin/acms/。

2. 導入數(shù)據(jù)庫
   執(zhí)行以下命令創(chuàng)建數(shù)據(jù)表和初始數(shù)據(jù)：

   php webman app-plugin:install acms

   或手動執(zhí)行 plugin/acms/install.sql。

3. 注冊路由
   插件自帶路由文件 plugin/acms/config/route.php，Webman 會自動加載。

4. 注冊菜單（可選）
   插件自帶菜單配置 plugin/acms/config/menu.php，安裝時自動導入后臺菜單。

5. 訪問系統(tǒng)

   • 后臺地址：/app/admin/acms/article/index
   • 前臺地址：/app/acms

目錄結(jié)構(gòu)

plugin/acms/
├── install.sql           // 數(shù)據(jù)庫結(jié)構(gòu)及初始數(shù)據(jù)
├── readme.md            // 插件說明文檔
├── api/                // API 相關代碼
├── app/                // 控制器、模型、服務等
├── config/             // 路由、菜單等配置
├── public/             // 靜態(tài)資源
├── view/               // Blade 模板視圖

路由說明

前臺路由（前綴：/app/acms）

• 文章列表：/app/acms
• 文章詳情：/app/acms/article/{id}
• 分類頁：/app/acms/category/{id}
• 標簽頁：/app/acms/tag/{id}
• 搜索頁：/app/acms/search
• 評論提交：/app/acms/comment/add

后臺路由（前綴：/app/admin/acms）

• 文章管理：/app/admin/acms/article/index
• 分類管理：/app/admin/acms/category/index
• 標簽管理：/app/admin/acms/tag/index
• 評論管理：/app/admin/acms/comment/index

常見問題

0. 如果未安裝user模塊，會報錯，那就先去安裝用戶模塊 http://wtbis.cn/app/view/user 選擇下載然后解壓到plugin/目錄，與admin同級，然后手動安裝用戶模塊，需要composer require webman/console ，手動安裝：php webman app-plugin:install user，

1. 后臺菜單或頁面 404

   • 確保 plugin/acms/config/menu.php 和 plugin/acms/config/route.php 路徑正確，均為 /app/admin/acms/xxx。
   • 清理 Webman 緩存：刪除 runtime/ 目錄下的緩存文件。
   • 確認數(shù)據(jù)庫表和初始數(shù)據(jù)已正確導入。

2. 路由沖突或無效

   • 檢查 config/route.php 是否存在同名路由沖突。
   • 確保插件目錄名為 acms，并與路由、菜單配置一致。

3. 數(shù)據(jù)庫連接失敗

   • 檢查 config/database.php 數(shù)據(jù)庫配置，確保與實際環(huán)境一致。

4. MySQL 8.0 以下版本兼容性

   • 在 install.sql 中，將 utf8mb4_0900_ai_ci 替換為 utf8mb4_general_ci。

5. CSRF 保護

   • 使用 csrf_token 和 csrf_field。
   • 已新增 autoload.php 和 functions.php，提供簡化的自定義函數(shù)替代。

6. 分頁支持

   • 確保已安裝分頁擴展：

     composer require jasongrimes/paginator

二次開發(fā)建議

• 擴展性：控制器、模型、視圖遵循 Webman 規(guī)范，可直接擴展。
• 菜單與權(quán)限：可通過修改 config/menu.php 自定義菜單和權(quán)限。
• 前端頁面：在 view/ 目錄下自定義 Blade 模板。
• 性能優(yōu)化：支持批量查詢，優(yōu)化多數(shù)據(jù)查詢性能。
• 功能增強：
  • 新增文章 ID 關聯(lián)功能，便于內(nèi)容聚合。
  • 支持多級分類和菜單，動態(tài)渲染層級。

貢獻與反饋

歡迎提交 Issue 或 PR，提供建議或報告問題。
github: https://github.com/dbx192/acms

作者與協(xié)議

• 作者：ouyangyi
• 開源協(xié)議：MIT