# LcSlim

**Repository Path**: lczld/LcSlim

## Basic Information

- **Project Name**: LcSlim
- **Description**: typecho、主题
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://www.lcbk.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-13
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LcSlim Typecho 版

本主题由 emlog 版 `lcbk-slim` 移植而来，**功能与视觉保持原样**。

## 安装

1. **下载**：打开[仓库首页](https://gitee.com/lczld/LcSlim)，点右上角「克隆/下载」→「下载 ZIP」，得到 `LcSlim-main.zip`。
2. **解压**：解压后得到一个名为 `LcSlim-main` 的文件夹。
3. **改名（关键步骤，别跳过）**：把文件夹 `LcSlim-main` 重命名为 `LcSlim`。
4. 将 `LcSlim` 目录上传至 Typecho 的 `usr/themes/` 下。
5. 登录后台 → 外观 → 启用 `LcSlim`。
6. 进入「设置外观」配置主题选项（导航、友链、配色等）。

> 建议 PHP 7.4+，实测 PHP 8.0 正常运行。
>
> **改名这一步不能省**：主题设置存放在 `theme:LcSlim`，目录名必须与之一致，
> 否则后台「设置外观」读不到配置。

## 目录结构

```
LcSlim/
├── functions.php            主题配置 themeConfig() + 语言 + 辅助函数
├── header.php / footer.php  头部 / 底部
├── index.php                首页 / 列表页（文章、分类、标签、搜索、日期、作者归档）
├── post.php                 文章详情页
├── page.php                 普通页面
├── page_archive.php         自定义模板：文章归档
├── page_links.php           自定义模板：友情链接（优先读取 LcLinks 插件数据，含离线状态）
├── page_tags.php            自定义模板：标签云
├── 404.php                  404 页面
├── comments.php             评论区（列表 + 表单）
├── inc/
│   ├── search.php           搜索弹窗
│   ├── search-api.php       搜索接口（JSON）
│   ├── auth.php             登录 / 注册弹窗
│   └── license_client.php   授权客户端（原样保留）
├── assets/                  CSS / JS / 图片（与 emlog 版一致）
└── languages/               zh_CN / en_US 语言包
```

## 使用说明

### 自定义页面模板

「文章归档」「友情链接」「标签云」为自定义模板，新建页面时在右侧
「自定义模板」下拉中选择对应项即可：

- `page_archive.php` — 按年月归档全部文章
- `page_links.php` — 展示主题设置中配置的友链
- `page_tags.php` — 展示全部标签云

### 导航配置

主题设置 → 导航菜单，每行一条，格式：

```
显示文字|链接地址
显示文字|链接地址|1     ← 末尾 1 表示新窗口打开
```

**前台登录入口说明**

- 主导航**不再显示「登录」**入口（按需求移除前台登录）。
- 管理员登录后台后，主导航自动追加「**后台**」（指向 `站点地址/admin/`）与「**退出**」两项；访客态不显示。


### 友链配置

**推荐搭配 [LcLinks 插件](https://gitee.com/lczld/LcLinks)**：独立数据表 + 后台「友情链接」管理面板，支持分类、拖拽排序、邮箱头像解析与自定义字段。安装并启用后，「友情链接」页面模板自动读取插件数据，无需额外配置。

**离线（失效）友链**：插件会定期检测站点可达性，`status = offline` 的友链**仍然展示**，但会置灰并显示「离线」徽标（与插件自带 `front.css` 视觉一致）。主题侧样式见 `assets/css/style.css` 的 `.friend-offline` / `.friend-badge-off`。

未安装 LcLinks 时，回退使用主题设置 → 友情链接，每行一条，格式：

```
站点名|站点地址|站点描述
```

### 浏览量

主题设置 → 文章浏览量 选择「开启」后，文章页自动计数并显示。
计数存放于 `typecho_fields` 表（`name = 'views'`），卸载主题不会残留数据库结构变更。

### 授权码

主题设置 → 授权码 填入购买获得的授权码（格式 `LCBK-XXXX-XXXX-XXXX`）。
授权客户端与 emlog 版一致，验证失败不会影响站点正常访问。

### 站长头像上传

主题设置 → 站长头像，可直接上传图片或粘贴图片地址。

- 支持格式：jpg / jpeg / png / gif / webp / svg，单张不超过 2MB
- 上传后保存至 `usr/uploads/avatar/`，并自动填充地址到上方输入框
- 勾选「清除头像，恢复默认」后回退为邮箱对应的 Gravatar 头像
- 生效范围：首页博主头像、站长本人评论的头像
- 访客评论仍使用各自邮箱的 Gravatar 头像

实现方式：`themeConfig()` 将表单设为 `multipart/form-data`，
通过 `themeConfigHandle()` 钩子接管保存并处理 `$_FILES` 上传
（含 `is_uploaded_file` / `getimagesize` 双重校验）。

## 本地验证记录

以下项目已在本地 Typecho 1.3.0 + PHP 8.0.2 实测通过：

- 首页 / 文章页 / 页面 / 归档页 / 友链页 / 标签云页 / 404 页
- 分类、标签、搜索、日期归档、作者归档
- 评论提交（含反垃圾 token）、嵌套回复展示、待审核提示
- 密码保护文章（正确/错误密码、cookie 保持）
- 搜索接口 JSON、登录/注册弹窗渲染
- 深色模式、代码高亮、图片灯箱、复制按钮、回到顶部
- 文章列表日期显示（`$archive->date->format()`，注意 `date()` 是输出方法）
- 站长头像上传 / 清除 / 优先级回退
- 全部 PHP 文件语法检查通过，无 Warning / Notice