# WordPress时间线插件

**Repository Path**: tinsur/WP-Timeline

## Basic Information

- **Project Name**: WordPress时间线插件
- **Description**: 一款WordPress独立时间线插件，采用专属独立数据表存储数据，完全隔离系统文章数据，安全整洁、不冗余。支持后台可视化发布、编辑、排序时间线内容，可自由设置日期与富文本描述。前端搭载高级质感时间线模板，全端自适应，滚动丝滑流畅，自带卡片阴影、动态 hover 动画效果，极简轻奢，适合展示企业历程、个人履历、大事记、成长记录等场景，零代码即可快速搭建专业级时间线页面。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: wordpress-plugins

**Tags**: WordPress

## README

# WP Timeline

一款独立、规范、高性能、UI高级美观的WordPress时间线专属插件。

## 功能特性

- ✅ **独立运行** - 不依赖任何第三方插件/主题，兼容 WordPress 6.0及以上版本
- ✅ **独立数据表** - 使用专属数据表存储时间线数据，与WP原生数据表完全隔离
- ✅ **后台管理** - 完整的CRUD操作，支持富文本编辑、状态管理、排序权重
- ✅ **精美展示** - 简约大气的时间线布局，支持响应式设计
- ✅ **短代码调用** - 一行短代码即可在任意页面展示时间线
- ✅ **安全防护** - 完整的权限控制、SQL防注入、XSS过滤

## 安装方式

### 手动安装

1. 下载插件压缩包
2. 上传到 `wp-content/plugins/` 目录
3. 在WordPress后台「插件」页面启用插件

### Git安装

```bash
cd wp-content/plugins/
git clone https://gitee.com/tinsur/WP-Timeline.git
```

## 使用方法

### 1. 后台管理

在WordPress后台左侧菜单栏找到「时间线管理」：

- **时间线列表** - 查看所有时间线，支持按状态筛选
- **新增时间线** - 创建新的时间线条目
- **插件设置** - 配置排序方式、动画开关、配色等

### 2. 前台展示

在任意文章或页面中插入短代码：

```
[wp_timeline]
```

或在主题文件中使用PHP代码：

```php
<?php echo do_shortcode('[wp_timeline]'); ?>
```

## 短代码参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `order_by` | 排序方式：`date`(日期) 或 `sort`(权重) | 按设置页配置 |
| `limit` | 显示条数，0表示全部 | 0 |

示例：

```
[wp_timeline order_by="date" limit="10"]
```

## 数据库结构

插件自动创建 `wp_timeline_list` 数据表：

| 字段 | 类型 | 说明 |
|------|------|------|
| id | bigint | 主键自增 |
| timeline_date | date | 时间线日期 |
| timeline_content | longtext | 时间线内容（富文本） |
| sort | int | 排序权重 |
| status | varchar | 状态（publish/draft） |
| create_time | datetime | 创建时间 |
| update_time | datetime | 更新时间 |

## 设置选项

在「插件设置」页面可配置：

- **排序方式** - 按日期或按权重排序
- **动画效果** - 开启/关闭滚动渐入动画
- **主色调** - 时间线节点颜色
- **次色调** - 卡片悬浮效果颜色
- **卸载清理** - 删除插件时是否清理数据

## 技术栈

- PHP 7.4+
- WordPress 6.0+
- JavaScript (ES6+)
- CSS3

## 开发规范

- ✅ 遵循WordPress官方编码标准
- ✅ 模块化代码结构
- ✅ 完整的安全防护
- ✅ 中文注释

## 许可证

GPL-2.0-or-later

## 来源

[Tinsur.cn](https://tinsur.cn)