kevinandClaude Fable 5
b600eac21c
- Add Favicon field to SiteSetting model with FaviconIsURL() helper - Implement favicon upload and management in site settings page - Support both external URL and local file upload for favicon - Add favicon display in page header with automatic URL detection - Add i18n translations for favicon settings (EN/ZH) - Update middleware and helpers to pass favicon data to templates - Include migration script for existing databases Users can now customize their site's favicon from /admin/settings/site by either providing an external URL or uploading a local image file (recommended formats: .ico, .png, .svg, 16x16 or 32x32 pixels). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
88 lines
2.9 KiB
Markdown
88 lines
2.9 KiB
Markdown
# Favicon 设置功能更新
|
||
|
||
## 概述
|
||
在站点设置页面 (`/admin/settings/site`) 添加了 Favicon（网站图标）设置功能。
|
||
|
||
## 更改的文件
|
||
|
||
### 1. 数据库模型 (models/site_setting.go)
|
||
- 添加了 `Favicon` 字段到 `SiteSetting` 结构体
|
||
- 添加了 `FaviconIsURL()` 方法来判断 Favicon 是外链还是本地文件
|
||
|
||
### 2. 处理器 (handlers/settings.go)
|
||
- `SiteSettingsPage`: 添加 `SiteFaviconIsURL` 到模板数据
|
||
- `SiteSettingsSave`: 添加 Favicon 上传和保存逻辑，支持：
|
||
- 外链 URL 设置
|
||
- 本地文件上传（.ico, .png, .svg）
|
||
- 清除当前 Favicon
|
||
|
||
### 3. 模板 (templates/admin/settings_site.html)
|
||
- 添加 Favicon 设置表单区域
|
||
- 显示当前 Favicon 预览
|
||
- 支持 URL 输入和文件上传
|
||
- 添加清除 Favicon 的复选框
|
||
|
||
### 4. 国际化 (i18n/i18n.go)
|
||
添加了以下翻译键：
|
||
- `settings_favicon`: Favicon / 网站图标（Favicon）
|
||
- `settings_favicon_url`: Favicon URL (external link) / Favicon 链接（外链地址）
|
||
- `settings_favicon_current`: Current favicon / 当前 Favicon
|
||
- `settings_favicon_hint`: 格式提示
|
||
- `settings_favicon_clear`: Remove current favicon / 移除当前 Favicon
|
||
|
||
### 5. 中间件 (middleware/auth.go)
|
||
- 在 `SetUserContext` 中添加 `site_favicon` 和 `site_favicon_is_url` 到上下文
|
||
|
||
### 6. 辅助函数 (handlers/helpers.go)
|
||
- 在 `DefaultData` 中添加 `SiteFavicon` 和 `SiteFaviconIsURL` 到模板数据
|
||
|
||
### 7. 页面模板 (templates/layouts/base.html)
|
||
- 在 `<head>` 中添加 Favicon 的 `<link>` 标签
|
||
- 根据设置自动使用外链或本地文件
|
||
|
||
## 数据库迁移
|
||
|
||
如果数据库已存在，需要手动添加 `favicon` 字段：
|
||
|
||
```sql
|
||
ALTER TABLE site_settings ADD COLUMN favicon VARCHAR(512) DEFAULT '';
|
||
```
|
||
|
||
或者运行提供的迁移脚本：
|
||
```bash
|
||
sqlite3 data/blog.db < scripts/add_favicon_field.sql
|
||
```
|
||
|
||
**注意**: GORM 的 `AutoMigrate` 会在下次启动时自动添加新字段，无需手动执行 SQL。
|
||
|
||
## 使用说明
|
||
|
||
1. 访问 `/admin/settings/site` 页面
|
||
2. 在 "网站图标（Favicon）" 部分：
|
||
- 方式一：输入外链 URL（如 CDN 链接）
|
||
- 方式二：上传本地图片文件（推荐 .ico, .png 或 .svg 格式，32x32 或 16x16 像素）
|
||
3. 点击 "保存" 按钮
|
||
4. Favicon 将自动应用到网站所有页面
|
||
|
||
## 文件存储
|
||
|
||
- 上传的 Favicon 文件保存在 `{storage_path}/logos/` 目录下
|
||
- 文件名固定为 `favicon.{ext}`（如 favicon.ico, favicon.png）
|
||
- 每次上传新文件时会自动删除旧文件
|
||
|
||
## 技术细节
|
||
|
||
### 支持的格式
|
||
- ICO (.ico) - 传统格式，兼容性最好
|
||
- PNG (.png) - 现代浏览器支持
|
||
- SVG (.svg) - 矢量格式，适合高分辨率显示
|
||
|
||
### 优先级
|
||
1. 如果同时设置了 URL 和上传文件，URL 优先
|
||
2. 如果勾选 "移除当前 Favicon"，会删除现有设置
|
||
|
||
### 缓存
|
||
- Favicon 设置存储在数据库中
|
||
- 通过 `models.RefreshConfigCache()` 刷新内存缓存
|
||
- 更改后立即生效，无需重启服务
|