logo
0
0
WeChat Login
fix: resolve missing frontend assets and update setup script

CMS - 基于 Laravel 12 + Filament 4 的通用内容管理系统

类似 PbootCMS/WordPress 的通用 CMS 全栈实现。

技术栈

框架版本
Laravel Framework12.x
Filament4.x
PHP8.2+
数据库SQLite

快速开始

# 1. 安装 PHP 依赖
composer install

# 2. 一键初始化(自动安装依赖、编译前端资源、创建 .env、生成密钥、创建 SQLite、迁移并填充数据)
composer run-script setup

说明setup 脚本会自动完成以下步骤:

  • 安装 Composer 和 NPM 依赖
  • 编译前端资源(Vite + Tailwind CSS)
  • .env.example 复制创建 .env 文件(如果不存在)
  • 生成 APP_KEY
  • 创建 database/database.sqlite
  • 执行数据库迁移并填充种子数据
  • 创建 storage 软链接

之后直接访问 /admin 即可使用(账号:admin@admin.com / password

如需自定义配置(数据库、邮件等),可编辑 .env 文件。默认使用 SQLite,无需额外配置数据库。

管理员账号

  • 后台路径:/admin
  • 邮箱:admin@admin.com
  • 密码:password

后台功能

内容管理

Resource功能
✅ 分类管理名称/Slug/描述/图标/排序/启用
✅ 产品管理分类/名称/富文本/封面/SEO管理/发布/推荐/启用
✅ 轮播图管理类型/标题/图片/链接/排序/启用
✅ 菜单管理名称/URL/父级/排序(支持多级)
✅ 友情链接名称/URL/Logo/描述/排序/启用
✅ 留言管理内容/只读列表/标记已读/批量标记已读

系统设置

功能说明
✅ 公司信息名称/联系方式/地址/微信号/QQ/简介
✅ 站点设置标题/Logo/Favicon/ICP/统计代码/主题切换

前台页面

页面路由说明
首页/轮播图/推荐产品/最新产品/分类导航
产品列表/products分页展示所有已发布产品
分类产品/category/{slug}按分类筛选产品
产品详情/product/{slug}产品完整信息/SEO
关于我们/about公司信息展示
留言板/guestbook留言提交/留言展示

模板变量

详细模板变量速查表请查看 templates/default/模板变量速查.md

常用变量一览

  • $site_title - 站点标题
  • $site_description - 站点描述
  • $company_name / $company_phone / $company_email / $company_address - 公司信息
  • $menus - 导航菜单(支持多级 $menu->children
  • $banners - 轮播图
  • $categories - 产品分类
  • $products - 产品列表(分页)
  • $product - 产品详情
  • $friend_links - 友情链接
  • $guestbooks - 留言列表

模板路径

前台模板位于 resources/views/themes/default/

目录结构

app/
├── Filament/
│   ├── Pages/
│   │   └── SiteSettingsPage.php     # 站点设置页
│   └── Resources/                   # Filament 资源
│       ├── BannerResource.php       # 轮播图
│       ├── CategoryResource.php     # 分类
│       ├── CompanyInfoResource.php  # 公司信息
│       ├── FriendLinkResource.php   # 友情链接
│       ├── GuestbookResource.php    # 留言
│       ├── MenuItemResource.php     # 菜单
│       └── ProductResource.php      # 产品
├── Http/Controllers/
│   └── FrontendController.php       # 前台控制器
├── Models/                          # 数据模型
└── Providers/
    └── AdminPanelProvider.php       # Filament 面板配置

resources/views/themes/default/
├── layouts/main.blade.php           # 主布局
├── index.blade.php                  # 首页
├── products.blade.php               # 产品列表
├── product_detail.blade.php         # 产品详情
├── about.blade.php                  # 关于我们
├── guestbook.blade.php              # 留言板
└── partials/
    └── guestbook_form.blade.php     # 留言表单

templates/default/
└── 模板变量速查.md                  # 模板变量速查表