WordPress 区块主题与 Preact 前端通过 REST API 解耦
Block-Theme-Portfolio — WordPress 作品集模板
作者 ShaneMuir
一个将 WordPress 区块主题作为内容后台、Preact 单页应用作为前端的个人作品集示例项目。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 2
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
前端包含 Three.js 首屏、IDE 风格界面、滚动动画与光标效果
前端使用 Preact、Preact Signals、Vite、TypeScript 与 CSS Modules
后端为区块主题,内容通过 WordPress 区块编辑器撰写
README 给出前端 Vercel/Netlify、后端托管 WordPress 的部署建议
模板详细介绍
Block-Theme-Portfolio 是一个个人作品集站点示例,采用前后端分离结构:WordPress 区块主题负责内容编辑,Preact 单页应用负责前台展示,两者通过 WordPress REST API(/wp-json/wp/v2/*)通信。
前端位于 frontend/ 目录,使用 Preact、Preact Signals、Three.js、Vite、TypeScript 与 CSS Modules,包含 Three.js 首屏、IDE 风格设计、滚动动画和光标效果。后端位于 backend/theme/,是一个 WordPress 区块主题,内容通过区块编辑器撰写。README 建议前端部署到 Vercel 或 Netlify,后端使用 Cloudways 或 Flywheel 等托管 WordPress 环境。
使用前需要分别启动前端与后端:前端安装依赖后运行开发服务器,后端需将主题复制到 wp-content/themes/ 并激活,同时创建 introduction 与 block-showcase 两个页面,再通过 frontend/.env 中的 VITE_WP_API_URL 指向 WordPress 站点。仓库未提供可直接运行的完整部署脚本,演示站点为 Vercel 上的静态前端。
适合你的项目吗?
适用场景
- 搭建以 WordPress 为内容后台的个人作品集站点
- 学习区块主题与前端框架通过 REST API 分离的实践
- 作为 Preact + Three.js 前端与 WordPress 后端组合的参考项目
适合人群
- 熟悉 WordPress 主题与前端构建工具的开发者
- 需要自行托管前后端并配置 API 地址的个人项目
- 想参考区块主题与 Preact 分离架构的开发者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
前端:进入 frontend/ 执行 npm install 与 npm run dev,默认地址 http://localhost:5173
- 2
后端:将 backend/theme/ 复制到 wp-content/themes/block-theme-portfolio/ 并激活主题
- 3
在 WordPress 中创建 introduction 与 block-showcase 页面
- 4
在 frontend/.env 中设置 VITE_WP_API_URL 指向 WordPress 站点地址
- 5
README 建议前端部署到 Vercel 或 Netlify,后端使用托管 WordPress 环境
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 使用前必须自行搭建并运行一个 WordPress 站点(PHP + MySQL),前端无法脱离该后端独立展示内容。
- 后端需手动将主题目录复制到 WordPress 的 wp-content/themes/ 下并激活,仓库未提供自动部署脚本。
- 必须在 WordPress 中手动创建 introduction 与 block-showcase 两个页面,否则前端对应内容无法正常显示。
- 需在 frontend/.env 中配置 VITE_WP_API_URL 指向自己的 WordPress 站点地址,否则前端无法获取数据。
- README 建议后端使用 Cloudways 或 Flywheel 等托管 WordPress 服务,可能产生第三方付费费用。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
Set up a WordPress install
README 原文
Copy `backend/theme/` to `wp-content/themes/block-theme-portfolio/`
README 原文
Create pages: `introduction`, `block-showcase`
README 原文
VITE_WP_API_URL=https://your-wordpress-site.com
README 原文
https://github.com/ShaneMuir/Block-Theme-Portfolio/blob/main/LICENSEhttps://github.com/ShaneMuir/Block-Theme-Portfolio/blob/main/README.mdBackend | Cloudways / Flywheel | Managed WordPress, PHP + MySQL
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 80 / 100
- 技术栈
- WordPress
- 网站类型
- 作品集
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-08-17
- 截图检查日期
- 2026-10-01
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 WordPress。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: 57fda097da9b961f3ee14b0f20cc858bef7740b7c5c2ee8c89675132c196da87
2026-10-01T03:00:22.433Z
来源文件 / 仓库# Block Theme Portfolio A personal portfolio site demonstrating WordPress Block Themes with a decoupled Preact frontend. ## Architecture ``` ┌─────────────────┐ REST API ┌─────────────────────┐ │ WordPress │ ◄──────────────────────── │ Preact Frontend │ │ Block Theme │ /wp-json/wp/v2/* │ (Vite + Three.js) │ │ (CMS) │ │ Static CDN │ └─────────────────┘ └─────────────────────┘ ``` - **Frontend** (`frontend/`) — Preact SPA with Three.js hero, IDE-themed design, scroll animations, cursor effects - **Backend** (`backend/theme/`) — WordPress Block Theme for content authoring via the Block Editor ## Quick Start ### Frontend ```bash cd frontend npm install npm run dev # → http://localhost:5173 ``` ### Backend 1. Set up a WordPress install 2. Copy `backend/theme/` to `wp-content/themes/block-theme-portfolio/` 3. Activate the theme 4. Create pages: `introduction`, `block-showcase` ### Connect Create `frontend/.env`: ``` VITE_WP_API_URL=https://your-wordpress-site.com ``` ## Hosting | Layer | Recommended Host | Why | |----------|------------------------|----------------------------------| | Frontend | Vercel / Netlify | Free, edge CDN, git deploy | | Backend | Cloudways / Flywheel | Managed WordPress, PHP + MySQL | ## Tech Stack - **Frontend**: Preact, Preact Signals, Three.js, Vite, TypeScript, CSS Modules - **Backend**: WordPress 6.4+, Block Theme, REST API - **Testing**: Vitest, fast-check, Testing Library
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

joshuatz-wp-theme
Custom Wordpress Theme for Portfolio Site
WordPress · 作品集

c2x
c2x is a simple WordPress PortFolio theme
WordPress · 作品集

asadazam-portfolio-theme
Custom WordPress theme with CPTs, ACF in PHP, async-loaded fonts, and a performance-first architecture. Powers…
WordPress · 作品集

Stratify-WP-Theme
Versatile agency and portfolio theme built for creative professionals and digital brands.
WordPress · 作品集

nexgen-tech-wp-theme
A dark tech agency WordPress theme built with Tailwind CSS+GSAP animations
WordPress · 作品集

al-folio
al-folio 是一个面向学者与研究人员的 Jekyll 作品集主题,设计简洁、响应式,适合搭建个人学术主页。
Jekyll · 作品集
