fastadmin_materials_official/CULTURE_README.md

企业文化模块升级指南

🎯 概述

将企业文化模块从硬编码方式升级为数据库动态管理，支持后台FastAdmin界面管理，保持现有复杂样式不变。

✅ 功能特性

• ✅ 独立数据表管理：新建专用的企业文化数据表
• ✅ 复杂样式支持：支持normal/reverse卡片布局，单列/双列内容布局
• ✅ 后台管理界面：完整的FastAdmin CRUD管理
• ✅ 多语言支持：支持中文/英文数据管理
• ✅ 灵活内容配置：JSON格式存储复杂内容结构
• ✅ 保持原有样式：完全兼容现有CSS样式

🗂️ 数据表结构

1. 企业文化卡片表 (wwh_culture_card)

字段	类型	说明
title	varchar(100)	卡片标题
subtitle	varchar(100)	英文副标题
image	varchar(255)	卡片图片
card_type	enum	卡片类型：normal/reverse
list_type	enum	列表类型：single/double
content_items	text	内容项目(JSON)
weigh	int	排序权重
status	enum	状态：0=禁用,1=启用
lang	enum	语言：1=中文,2=英文

2. 企业文化横幅表 (wwh_culture_banner)

字段	类型	说明
title	varchar(100)	横幅标题
subtitle	varchar(100)	英文副标题
image	varchar(255)	背景图片
content_type	enum	内容类型：text/grid_single/grid_double
content_data	text	内容数据(JSON)
weigh	int	排序权重
status	enum	状态：0=禁用,1=启用
lang	enum	语言：1=中文,2=英文

🚀 安装步骤

1. 导入数据表

-- 导入数据表结构和示例数据
mysql> source culture_tables.sql

2. 导入后台菜单

-- 导入后台管理菜单
mysql> source culture_menu.sql

3. 清理缓存

# 清理模板缓存
rm -rf runtime/temp/*
# 清理系统缓存  
rm -rf runtime/cache/*

🎛️ 后台管理

访问路径

• 企业文化卡片管理：后台 > WWH模块管理 > 企业文化卡片
• 企业文化横幅管理：后台 > WWH模块管理 > 企业文化横幅

管理功能

• ✅ 卡片增删改查
• ✅ 横幅增删改查
  
• ✅ 排序权重管理
• ✅ 状态启用/禁用
• ✅ 多语言数据管理
• ✅ 图片上传管理

📝 使用说明

卡片内容格式

内容项目按行分隔，例如：

善用资源
服务建设
企业育人
让员工与企业共同成长

横幅内容格式

根据内容类型：

• 纯文本：直接输入文本内容

• 网格布局：每行一个项目，例如：

  敬畏
  感恩
  谦虚
  得体
  

卡片类型说明

• normal：图片在上，内容在下
• reverse：内容在上，图片在下

列表类型说明

• single：单列布局
• double：双列布局（自动左右分列对齐）

🎨 样式特性

响应式布局

• 卡片宽度：285px
• 卡片高度：520px
  
• 自适应间距：gap: 60px 20px

动画效果

• 悬停上升效果：transform: translateY(-5px)
• 图片缩放效果：transform: scale(1.05)
• WOW动画支持

特殊样式处理

• 支持nth-child选择器的特殊高度设置
• 自动处理card-normal和card-reverse的布局切换
• 双列内容的左右对齐显示

🔧 开发说明

文件结构

application/
├── admin/controller/wwh/
│   ├── CultureCard.php      # 卡片管理控制器
│   └── CultureBanner.php    # 横幅管理控制器
├── admin/view/wwh/
│   ├── culture_card/        # 卡片管理视图
│   └── culture_banner/      # 横幅管理视图
└── common/model/
    ├── WwhCultureCard.php   # 卡片模型
    └── WwhCultureBanner.php # 横幅模型

addons/wwh/
├── controller/Column.php    # 前台控制器(已修改)
└── view/materials/
    └── detail_culture.html  # 企业文化页面(已修改)

扩展开发

如需添加新字段：

1. 修改数据表结构
2. 更新模型文件的append属性
3. 修改控制器的表单处理
4. 更新视图模板

⚠️ 注意事项

1. 备份数据：升级前请备份数据库
2. 样式兼容：确保CSS文件完整加载
3. 图片路径：使用cdnurl修饰符处理图片路径
4. JSON格式：内容数据使用JSON格式存储，注意编码
5. 权重排序：权重值越大排序越靠前

🐛 故障排除

常见问题

1. 菜单不显示：检查菜单SQL是否正确导入
2. 图片不显示：检查图片路径和CDN配置
3. 样式错乱：检查CSS文件是否完整加载
4. 数据不显示：检查数据表是否正确创建和填充

调试方法

// 在控制器中调试数据
var_dump($cultureCards);
var_dump($cultureBanners);

📞 技术支持

如遇问题，请检查：

1. 数据表是否正确创建
2. 菜单是否正确导入
   
3. 文件权限是否正确
4. 缓存是否已清理