Skip to content

SuperTylerX/wordpress-to-uniapp

Repository files navigation

项目介绍

本项目以 WordPress RestFul API为基础,实现了一款对接WordPress网站的UniApp,可被编译为 Android APP、iOS APP、微信小程序 和 H5手机网站。项目借鉴了 jianbo 开发的 微信小程序开源版 的部分设计,在UniApp的加持下,使用Vue 3的语法进行了完全重构,因此可以被编译到更多的平台,实现一套代码,多端运行。本套程序额外增加了对 WordPress原生用户系统登录的支持,增加了可扩展性,支持进行二次开发对接任意的WordPress主题。

平台兼容性

Uni-APP JSCore UniApp X 快应用 H5
× ×
微信小程序 QQ小程序 抖音小程序 百度小程序 支付宝小程序

项目依赖

本套程序需要在 WordPress 集成的 Restful API 的基础上,额外增加自定义API,因此需要额外安装两款 WordPress插件。

  • rest-api-to-miniprogram-enhence

下载地址:https://github.com/SuperTylerX/rest-api-to-miniprogram-enhanced

这款插件是在 jianbo 开发的 rest-api-to-miniprogram 插件基础上进行了二次开发,增加了更多自定义API支持。

  • JWT Authentication for WP-API

下载地址:https://cn.wordpress.org/plugins/jwt-authentication-for-wp-rest-api (也可以从WordPress插件市场内直接下载)

这款插件实现了WordPress JWT 登录,为原生用户登录做支持。

注意:安装完需要对配置文件进行额外设置,具体操作步骤请阅读官方指导,或者搜寻相关配置指引。

开发

  1. 安装
pnpm install
  1. 运行
  • H5开发环境
pnpm run dev:h5

运行成功后,浏览器打开http://localhost:5173/即可预览。

  • 微信小程序开发环境
pnpm run dev:mp-weixin

运行成功后,使用微信开发者工具,选择mp-weixin目录并打开(路径:dist/dev/mp-weixin),即可预览。

其他小程序平台同理。

  • APP开发环境
pnpm run dev:app-plus

运行成功后,使用HBuilderX导入 dist\dev\app 运行,选择运行到手机或模拟器即可预览。

多环境打包

  • H5打包
pnpm run build:h5

打包完成后,将dist目录下的build文件夹内的文件上传到服务器即可。

  • 微信小程序打包
pnpm run build:mp-weixin

打包完成后,使用微信开发者工具,选择mp-weixin目录并打开,目录路径:dist/build/mp-weixin,在微信开发者工具中点击上传即可。

  • APP打包
pnpm run build:app-plus

打包完成后,使用HBuilderX导入 dist\build\app ,使用云打包进行打包。

代码检查修复

# eslint 检查
pnpm run lint:fix
# tsc 检查
pnpm run type:check

Demo

cover
微信小程序 QQ小程序 百度小程序 头条小程序
支付宝小程序 H5 安卓APP

交流反馈群

cover

TODO

  • 增加文章管理
  • 增加订阅关注功能
  • 暗黑主题色适配
  • 小程序特殊能力适配
  • 文章发布管理
  • Q&A

特别感谢