当前位置： 首页 > news >正文

【教程】Typecho Joe主题开启并修复壁纸相册不显示问题

news 2025/8/20 8:19:22

转载请注明出处：小锋学长生活大爆炸[xfxuezhang.cn]

背景说明

        Joe主题本身支持“壁纸”功能，其实就是相册。当时还在网上找了好久相册部署的开源项目，太傻了。

        但是网上教程很少，一没说如何开启壁纸功能，二没说开启后为何不显示图片，三没说如何显示自定义图片。

        通过层层深扒源码，我已经成功修复并实现了上述问题。所以，这个重任还是由我来吧。接下来将是非常详细的图文教程，小白有手就行。

开启壁纸

        进入后台，创建独立页面

        

        标题随便填，最关键的是模板要选“壁纸”

        直接发布页面即可

        发布后点上面这个提示进去页面

比如我的：https://xfxuezhang.cn/index.php/tuji.html

        此时你会看到一直在转圈圈，你也不知道如何去添加图片

修复显示

        SSH进入服务器后台，进到Joe主题下面的public目录。这个路径都是一样的，直接复制即可

cd /var/www/html/usr/themes/Joe/public/

        打开route.php，直接替换里面的两个函数

vim route.php

function _getWallpaperType($self)  改成

/* 获取壁纸分类 已测试 √ */
function _getWallpaperType($self)
{header('Content-Type: application/json');$self->response->setStatus(200);$json = file_get_contents("http://cdn.apc.360.cn/index.php?c=WallPaper&a=getAllCategoriesV2&from=360chrome");$res = json_decode($json, TRUE);if ($res['errno'] == 0) {$self->response->throwJson(["code" => 1,"data" => $res['data']]);} else {$self->response->throwJson(["code" => 0,"data" => null]);}
}

function _getWallpaperList($self)  改成

/* 获取壁纸列表 已测试 √ */
function _getWallpaperList($self)
{header('Content-Type: application/json');$self->response->setStatus(200);$cid = $self->request->cid;$start = $self->request->start;$count = $self->request->count;$json = file_get_contents("http://wallpaper.apc.360.cn/index.php?c=WallPaper&a=getAppsByCategory&cid={$cid}&start={$start}&count={$count}&from=360chrome");$res = json_decode($json, TRUE);if ($res['errno'] == 0) {// 数据总数$total = $res['total'];$self->response->throwJson(["code" => 1,"data" => $res['data'],"total" => $total]);} else {$self->response->throwJson(["code" => 0,"data" => null]);}}

        保存后刷新页面，就可以惊喜的发现能成功显示360壁纸了

自定义图片

        那如何让它显示我们自己的图片呢？Joe显示壁纸的代码是固定的，所以我们只需要按照360壁纸的接口来设计我们的服务api就行。

壁纸分类接口

        先看壁纸分类，360接口示例：

http://cdn.apc.360.cn/index.php?c=WallPaper&a=getAllCategoriesV2&from=360chrome

        实际有用的

{"errno": "0","total": "1","data": [{"id": "1","name": "xxx"}]
}

        如果你有服务程序开着，那么就返回这种类型的数据就行。我不想单独再开个监听服务程序，所以后面会讲我的简单方法。

壁纸图片接口

        对于根据分类获取图片的360接口：

http://wallpaper.apc.360.cn/index.php?c=WallPaper&a=getAppsByCategory&cid={$cid}&start={$start}&count={$count}&from=360chrome

        实际有用的：

{"errno": "0","total": "1884","data": [{"id": "1","url": "http://xfxuezhang.cn/mypics/1/0366_PT1814-2_7E8DB7C0.jpg"},]
}

        同样的， 如果你有服务程序开着，那么就返回这种类型的数据就行。我不想单独再开个监听服务程序，所以后面会讲我的简单方法。

替换自己的图片

        超级简单的方法。直接在网站目录下创建一个文件夹，里面每个子目录就是一个分类，子目录名是cid，分类信息用image_types.json保存，图片信息用image_details_{cid}.json保存，而generate.py可以根据子目录自动生成image_details_{cid}.json。

        举个栗子，我创建了mypics目录

mkdir /var/www/html/mypics

        目录结构：

        子目录1中的内容：

image_types.json：

{"errno": "0","total": "1","data": [{"id": "1","name": "涂料印花"}]
}

generate.py：

import os
import json# 指定图片存放的目录
pics_directory = "./"# 遍历pics_directory目录下的子目录
for cid in os.listdir(pics_directory):if not os.path.isdir(cid):continueprint(f">> 正在处理：{cid}")# 构建JSON文件路径json_file_path = os.path.join(pics_directory, cid, f"image_details_{cid}.json")output_file = os.path.join(pics_directory, f"image_details_{cid}.json")# 获取子目录下的所有图片文件image_files = os.listdir(os.path.join(pics_directory, cid))# 构建JSON数据json_data = {"errno": "0","total": str(len(image_files)),"data": [{"id": str(i + 1), "url": f"https://xfxuezhang.cn/mypics/{cid}/{image}"}for i, image in enumerate(image_files)]}# 将JSON数据写入文件 with open(output_file, 'w') as json_file:json.dump(json_data, json_file, indent=2)print(f"Generated {output_file}")

执行generate.py生成image_details_1.json：

python generate.py

image_details_1.json：

{"errno": "0","total": "2","data": [{"id": "1","url": "http://xfxuezhang.cn/mypics/1/0366_PT1814-2_7E8DB7C0.jpg"},{"id": "3","url": "http://xfxuezhang.cn/mypics/1/0366_PT1814-2_7E8DB7C0.jpg"},]
}

        最主要的！还要去修改route.php中的两个函数！

function _getWallpaperType($self)  改为

/* 获取壁纸分类 已测试 √ */
function _getWallpaperType($self)
{// 允许所有域的跨域请求header("Access-Control-Allow-Origin: *");header("Access-Control-Allow-Methods: GET, POST, OPTIONS");header("Access-Control-Allow-Headers: Content-Type");header("Access-Control-Max-Age: 86400");header('Content-Type: application/json');$self->response->setStatus(200);// $json = file_get_contents("http://cdn.apc.360.cn/index.php?c=WallPaper&a=getAllCategoriesV2&from=360chrome");$json = file_get_contents("http://xfxuezhang.cn/mypics/image_types.json");$res = json_decode($json, TRUE);if ($res['errno'] == 0) {$self->response->throwJson(["code" => 1,"data" => $res['data']]);} else {$self->response->throwJson(["code" => 0,"data" => null]);}
}

function _getWallpaperList($self)  改为

/* 获取壁纸列表 已测试 √ */
function _getWallpaperList($self)
{// 允许所有域的跨域请求header("Access-Control-Allow-Origin: *");header("Access-Control-Allow-Methods: GET, POST, OPTIONS");header("Access-Control-Allow-Headers: Content-Type");header("Access-Control-Max-Age: 86400");header('Content-Type: application/json');$self->response->setStatus(200);$cid = $self->request->cid;$start = $self->request->start;$count = $self->request->count;// $json = file_get_contents("http://wallpaper.apc.360.cn/index.php?c=WallPaper&a=getAppsByCategory&cid={$cid}&start={$start}&count={$count}&from=360chrome");$json = file_get_contents("http://xfxuezhang.cn/mypics/image_details_{$cid}.json");$res = json_decode($json, TRUE);if ($res['errno'] == 0) {// 数据总数$total = $res['total'];// 对数据进行分割$startIndex = $start;$endIndex = $startIndex + $count;$slicedData = array_slice($res['data'], $startIndex, $count);$self->response->throwJson(["code" => 1,"data" => $slicedData,"total" => $total]);} else {$self->response->throwJson(["code" => 0,"data" => null]);}}

        改完保存后，去刷新壁纸页面，就可以看到已经顺便变成我们自己的图了

后续修改

        之后要调整内容，就只需要在mypics目录下放个子目录，然后手动将这个子目录信息写到image_types.json，然后直接执行generate.py就可以了。

进阶加速方法

        图片会占用大量内存，如果资金充足可以买一个CDN。另一种方法是加上缓存。对于Typecho可以用这个插件：

GitHub - gogobody/TpCache: 一个 typecho 缓存插件

        注意需要开启php-redis，比如我的是php8.1版本：

sudo apt install php8.1-redis

        然后安装redis：

sudo apt install redis-server -y

        然后就是常规插件的开启方法，大家都会的。可以参考我的设置：

http://www.lryc.cn/news/274102.html

相关文章：

  • MR混合现实情景实训教学系统在法律专业课堂上的应用
  • 车载 Android之 核心服务 - CarPropertyService 的VehicleHAL
  • 年底了，准备跳槽的可以看看...
  • Bagging算法_随机森林Random_Forest
  • 物理与网络安全
  • torch.meshgrid和np.meshgrid的区别
  • 【PostgreSQL】约束-唯一约束
  • 学习使用js/jquery获取指定class名称的三种方式
  • latex数学公式
  • frp配置内网穿透访问家里的nas
  • C语言-蓝桥杯2023年第十四届省赛真题-砍树
  • python识别验证码+灰度图片base64转换图片
  • TF-IDF（Term Frequency-Inverse Document Frequency）算法 简介
  • 企业怎么打造私域转化闭环?
  • 基于等保合规和滑动标尺模型的云安全建设方法
  • MySQL数据库期末知识点总结（复习版）
  • 流行的Jmeter+Ant+Jenkins接口自动化测试框架在网络上走红
  • MySQL 数据页损坏处理思路
  • 面试 Vue 框架八股文十问十答第二期
  • 【Python学习】2024PyCharm插件推荐
  • 剑指offer题解合集——Week2day6
  • 算法训练第五十二天|300. 最长递增子序列、674. 最长连续递增序列、718. 最长重复子数组
  • HTTP基础知识总结
  • 创意与技术的结晶：AI魔法绘图与中文描述的完美结合
  • Python：int(value, base=10)
  • Vue之调用store的action(包含getter调用)
  • 蟹目标检测数据集VOC格式400张
  • PyTorch中常用的工具（4）Visdom
  • Linux(ubuntu)下git / github/gitee使用
  • 回归预测 | MATLAB实OOA-LSTM基于鱼鹰优化算法优化长短期记忆网络的多输入单输出数据回归预测模型 （多指标，多图）