Home 软件 WPcoder-APK wordpress软件下载主题
Image

WPcoder-APK 主题使用教程

本文档用于介绍 APK WordPress 主题的功能、安装流程和常用配置方法，适合站长和内容运营人员快速上手。

 

1. 主题简介

APK 主题是一个面向应用下载站场景的 WordPress 主题，支持应用信息展示、下载链接管理、分类与标签组织、基础 SEO 配置，以及通过接口批量导入应用数据。

  • 支持应用字段管理：开发者、版本、下载次数、评分、系统要求、截图等。
  • 支持后台常规设置中的 SEO 基本项（描述、关键词、页脚说明）。
  • 支持主题初始化：一键创建默认分类和示例文章。
  • 支持首页区块设置：Hero、右侧广告、置顶区块与自定义列表区块。
  • 支持爬虫导入接口和 API Key 校验机制。
  • 支持文章列表中显示应用相关自定义列，便于后台运营。

2. 安装前准备

  1. 已安装并可正常访问的 WordPress 站点。
  2. 具有管理员权限的后台账号。
  3. 可访问服务器文件目录（FTP、宝塔、宝塔终端、SSH 或本地环境文件管理器）。

推荐环境：PHP 7.4+，MySQL 5.7+，并确保服务器可外网访问（用于下载远程图片）。

安装wordpress数据库表前缀建议用 apk_ ,如下图所示：

3. 主题安装步骤

方式 A：直接放置主题目录（推荐开发环境）

  1. 将主题目录 apk 上传到 wp-content/themes/。
  2. 进入 WordPress 后台：外观 - 主题。
  3. 找到 apk 主题并点击“启用”。

方式 B：后台上传压缩包

  1. 将主题目录打包为 apk.zip。
  2. 后台进入 外观 - 主题 - 安装主题 - 上传主题。
  3. 上传压缩包并启用主题。

4. 首次启用后的基础配置

4.1 固定链接

  1. 进入 设置 - 固定链接。
  2. 建议选择“文章名”或自定义结构，保存一次。

4.2 菜单配置

  1. 进入 外观 - 菜单。
  2. 创建主菜单并勾选“主导航菜单（primary）”。
  3. 保存菜单。

5. 主题初始化（默认数据）

该主题提供后台初始化入口，用于手动创建默认分类和示例文章。当前逻辑为手动触发，不是启用主题后自动执行。

  1. 进入 外观 - 主题初始化。
  2. 点击 手动初始化默认数据 按钮。
  3. 等待页面返回执行报告（新建/已存在/失败数量）。

初始化内容包含：

  • 默认分类：应用(apps)、游戏(games)、工具(tools)（工具为应用子分类）。
  • 示例文章：内置 3 篇示例应用文章，并附带应用信息字段。

可重复点击初始化按钮，系统会按内置 seed key 防重，不会无限重复创建相同示例内容。

6. 首页区块设置

主题支持在后台自由编排首页展示模块，入口为 外观 - 首页区块设置。

6.1 Hero Section

  • 可配置背景图 URL、标题、描述、按钮文本、按钮链接。
  • 按钮文本或链接留空时可视为隐藏按钮。

6.2 首页右侧广告代码

  • 支持粘贴 HTML/JS 广告代码（如图片跳转、iframe、广告平台脚本）。

6.3 首页置顶文章区块

  • 可通过勾选开关控制“推荐(置顶)”区块是否显示。

6.4 自定义内容区块

  • 可新增多个区块，每个区块支持：标题、分类、排序、数量。
  • 排序支持：时间、下载量、评分。
  • 数量范围：1 到 24；系统最多保留 20 个区块。
  1. 配置完成后点击 保存首页区块设置。
  2. 保存后主题会自动刷新首页缓存，前台即可生效。

7. SEO 与页脚信息配置

进入 设置 - 常规，找到主题新增设置区域，可配置：

  • 网站描述（Description）
  • 网站关键词（Keywords）
  • 页脚备案号/提示信息（支持 HTML）

页脚信息可填写备案链接，例如：

<a href="https://beian.miit.gov.cn/#/Integrated/index" target="_blank" rel="noopener">赣ICP备20210013号-1</a>

8. 爬虫 API Key 配置（重要）

为保障导入接口安全，主题支持后台配置 API Key：

  1. 进入 设置 - 常规。
  2. 找到 爬虫 API Key 字段。
  3. 输入你自定义的密钥并保存。

接口请求时需携带 api_key 参数，并与后台值完全一致。

若后台留空，主题会使用内置默认 key。生产环境建议务必设置为强随机密钥。

9. apkpure-crawler-extension 插件使用方法

9.1 插件位置

插件目录位于主题内：wp-content/themes/apk/apkpure-crawler-extension。

9.2 首次配置（必须）

  1. 进入任意 https://apkpure.com/ 页面，右下角会看到 Start APK Crawler 与 Settings 按钮。
  2. 点击 Settings，在弹窗中填写：
  • WordPress Base URL：例如 https://your-domain.com/apk
  • API Key：与 WordPress 后台“设置 – 常规 – 爬虫 API Key”一致
  1. 点击 Save 保存后即可生效。

提示：配置会保存到浏览器扩展存储中，后续打开新页面会继续使用该配置。

9.3 安装扩展（Chrome/Edge）

  1. 打开扩展管理页：chrome://extensions 或 edge://extensions。
  2. 开启“开发者模式”。
  3. 点击“加载已解压的扩展程序”。
  4. 选择目录 apkpure-crawler-extension 完成加载。

9.4 启动抓取

  1. 访问 APKPure 分类页（示例）：https://apkpure.com/cn/communication?page=1&sort=download&ajax=1。 communication 为分类名称，替换其他分类名称即可，抓取其他分类（不懂可联系我们）
  2. 页面右下角会出现 Start APK Crawler 按钮。
  3. 点击后会抓取当前页应用详情并提交到 WordPress。
  4. 提交成功后会自动翻到下一页并继续抓取。

9.5 停止与检查

  • 当某批次提交失败或页面无可抓取应用时，自动翻页会停止。
  • 可在浏览器控制台查看日志与报错信息。
  • 导入结果可在 WordPress 后台 文章 列表中核对。

10. 发布应用内容（手动）

  1. 进入 文章 - 写文章。
  2. 填写标题与正文简介。
  3. 在“应用信息”区域填写自定义字段：
  • Developer（开发者）
  • download（下载链接）
  • downloads（下载次数）
  • icon（图标 URL，可用媒体库按钮选择）
  • Latest Version（最新版本）
  • rating（评分）
  • size（大小）
  • system（系统要求）
  • screenshots（截图 URL，逗号分隔，可多选媒体库）
  1. 选择分类与标签。
  2. 发布文章。

11. 批量导入接口说明（简版）

主题提供 AJAX 接口用于批量导入应用，常见调用路径如下：

/wp-admin/admin-ajax.php?action=submit_apk_data

请求参数（POST）示例：

action=submit_apk_data
api_key=你的密钥
apps=[{"name":"App Name","download":"https://example.com/app.apk"}]

说明：

  • apps 为 JSON 数组字符串。
  • 按 download 字段进行重复校验，重复内容会跳过。
  • 远程图标和截图会尝试下载到媒体库并替换为本地 URL。

12. 常见问题排查

12.1 导入返回 Invalid API key

  • 检查请求中的 api_key 是否与后台“爬虫 API Key”一致。
  • 确认请求是否传到了正确站点和正确主题环境。

12.2 图片未成功入库

  • 确认服务器可访问目标图片 URL。
  • 检查主机防火墙、DNS 或 SSL 证书问题。
  • 确认 wp-content/uploads 目录有写入权限。

12.3 导入超时

  • 减少单次 apps 数量，分批导入。
  • 确认服务器 PHP 超时与网关超时配置。

12.4 插件已加载但没有按钮

  • 确认当前页面域名是 https://apkpure.com/。
  • 确认扩展处于启用状态，并已刷新目标页面。
  • 检查浏览器控制台是否有 content script 报错。

13. 维护建议

  • 修改 API Key 后，同步更新所有采集端配置。
  • 定期备份数据库与上传目录。
  • 升级主题前先在测试环境验证导入流程与页面展示。

14. apkpure_download（Node.js）模块使用教程

14.1 模块位置与作用

Node.js 下载解析服务目录位于：wp-content/themes/apk/apkpure_download/downloader-node。

该服务用于解析 APKPure 页面，返回可下载链接，主要接口：

  • GET /health：健康检查。
  • GET /get-link?url=APKPURE_PAGE_URL：解析下载地址。

14.2 本地快速启动

  1. 进入目录：cd wp-content/themes/apk/apkpure_download/downloader-node
  2. 安装依赖：npm ci --omit=dev
  3. 安装浏览器：npm run install:chrome
  4. 启动服务：npm run start:prod

默认监听 0.0.0.0:3000，可通过环境变量 PORT、HOST、PUPPETEER_EXECUTABLE_PATH 调整。

14.3 Linux 生产部署（PM2）

  1. 安装 Node.js 20+。
  2. 在项目目录执行：npm ci --omit=dev。
  3. 安装并启动 PM2：npm install -g pm2、pm2 start ecosystem.config.js。
  4. 设置开机自启：pm2 save、pm2 startup。

日志查看：pm2 logs downloader-node --lines 100。

14.4 宝塔部署要点

  1. 宝塔安装 Node.js（建议 20.x）与 PM2 管理器。
  2. 上传并解压 dist/downloader-node-web-1.0.0.zip 到网站目录。
  3. 执行：npm ci --omit=dev 与 npm run install:chrome:cache。
  4. 使用 PM2 启动后，在宝塔站点中配置反向代理到 http://127.0.0.1:3000。

若遇到 Puppeteer 报错（缺少系统库或找不到 Chrome），请参考同目录 DEPLOY_BT.md 安装依赖并重启 PM2。

14.5 Docker 部署（可选）

  1. 构建镜像：docker build -t downloader-node:1.0.0 .
  2. 启动容器：docker run -d --name downloader-node -p 3000:3000 --restart unless-stopped downloader-node:1.0.0

14.6 接口调用示例

健康检查：

curl http://127.0.0.1:3000/health

解析 APKPure 页面下载链接：

curl "http://127.0.0.1:3000/get-link?url=https://apkpure.com/cn/app-name/package.name/download"

返回 JSON 中重点字段：

  • success：是否成功。
  • downloadUrl：最终下载链接（优先 CDN 直链）。
  • packageName：识别出的包名。

14.7 与当前主题联动说明（可选）

主题下载解析逻辑位于 download-resolver-module.php，当前默认请求地址为固定域名：

https://apkpure.clbug.com/get-link

若你自建了该 Node 服务，需将此地址改为你的域名（建议经 Nginx 反代并启用 HTTPS），例如：

https://api.your-domain.com/get-link

14. 其他页面展示

管理后台，文章列表

标签

分类页面：

分类页面：

下载页面：

文档版本：1.0更新日期：2026-03-11