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

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

概述

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

主要功能

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

安裝步驟

環(huán)境要求

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

  composer require psr/container webman/blade jasongrimes/paginator

安裝流程

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

下面是手動(dòng)安裝的方法：

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

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

   php webman app-plugin:install acms

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

3. 注冊(cè)路由
   插件自帶路由文件 plugin/acms/config/route.php，Webman 會(huì)自動(dòng)加載。

4. 注冊(cè)菜單（可選）
   插件自帶菜單配置 plugin/acms/config/menu.php，安裝時(shí)自動(dòng)導(dǎo)入后臺(tái)菜單。

5. 訪問(wèn)系統(tǒng)

   • 后臺(tái)地址：/app/admin/acms/article/index
   • 前臺(tái)地址：/app/acms

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

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

路由說(shuō)明

前臺(tái)路由（前綴：/app/acms）

• 文章列表：/app/acms
• 文章詳情：/app/acms/article/{id}
• 分類(lèi)頁(yè)：/app/acms/category/{id}
• 標(biāo)簽頁(yè)：/app/acms/tag/{id}
• 搜索頁(yè)：/app/acms/search
• 評(píng)論提交：/app/acms/comment/add

后臺(tái)路由（前綴：/app/admin/acms）

• 文章管理：/app/admin/acms/article/index
• 分類(lèi)管理：/app/admin/acms/category/index
• 標(biāo)簽管理：/app/admin/acms/tag/index
• 評(píng)論管理：/app/admin/acms/comment/index

常見(jiàn)問(wèn)題

0. 如果未安裝user模塊，會(huì)報(bào)錯(cuò)，那就先去安裝用戶(hù)模塊 http://wtbis.cn/app/view/user 選擇下載然后解壓到plugin/目錄，與admin同級(jí)，然后手動(dòng)安裝用戶(hù)模塊，需要composer require webman/console ，手動(dòng)安裝：php webman app-plugin:install user，

1. 后臺(tái)菜單或頁(yè)面 404

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

2. 路由沖突或無(wú)效

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

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

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

4. MySQL 8.0 以下版本兼容性

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

5. CSRF 保護(hù)

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

6. 分頁(yè)支持

   • 確保已安裝分頁(yè)擴(kuò)展：

     composer require jasongrimes/paginator

二次開(kāi)發(fā)建議

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

貢獻(xiàn)與反饋

歡迎提交 Issue 或 PR，提供建議或報(bào)告問(wèn)題。
github: https://github.com/dbx192/acms

作者與協(xié)議

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