CMS模板修改教程

从浏览器页面往回找代码:前端模板、路由、后端控制器的对应关系,含分类页修改示例与全部页面对照清单。

你在浏览器看到的任何一个前台页面,都是三层文件配合出来的,往回找代码就四步,整体关系如下:

浏览器里的页面(如分类页,网址为 /category/动作片)
    ↓ 页面长什么样,由前端文件决定
前端文件 views/projectz/category.jade,改页面外观/文案,大多数改动到这一步就够了
    ↓ 页面上的数据(视频列表等)从哪来,顺藤摸瓜往后找
路由 routes/index.js,只是一张网址到控制器的登记表,一般不需要改
    ↓ 登记表告诉你这个网址交给了哪个函数处理
控制器 controller/cms.js,改数据:每页提取几个、排序、筛选条件、传哪些字段

提示:改样子找前端文件;改数据(个数/排序/字段)找后端控制器;路由基本不动,它只是帮你查网址归谁管。

举例:修改分类页

第一步:找到前端文件

浏览器打开你的域名/category/动作片,看到的就是分类页,它的前端文件是views/projectz/category.jade,改页面HTML、文案都在这里,文件开头大致为:

extends cmslayout
each movie in movies

其中cmslayout是全站共用母版(顶栏/底栏都在cmslayout.jade里),each movie in movies循环画出视频卡片,movies就是后端传来的视频列表。

页面上一共显示几个视频、按什么排序,前端说了不算,继续往后找movies是谁传的。

第二步:查路由找到控制器

在routes/index.js里搜索/category,可以找到这一行:

router.get('/category/:category', checkopen, Cmscontroller.getcategory);

它告诉你/category/动作片这个网址交给了controller/cms.js里的getcategory函数处理,看完这行路由本身不用动。

第三步:修改控制器

在controller/cms.js里搜索exports.getcategory,找到这个函数,内容大致为:

exports.getcategory = async function (req, res) {
  // 查分类、查视频列表、分页(内容省略)...
  const videoPerPage = hasAds ? 34 : 36;
  res.render('projectz/category', {
    movies: lists,
    page: page,
    pages: totalPages,
  });
};

其中videoPerPage就是每页提取几个视频,改这里即可;改排序、筛选条件、增减传给页面的字段,也都在这个函数里。最后res.render('projectz/category', {...})又指回第一步的前端文件,数据就这样传给了页面。

全部页面对照

前端文件都在views/projectz/目录,控制器都在controller/cms.js,改哪个页面就用编辑器在控制器文件里搜对应的函数名。

  • 首页:index.jade,网址为/,控制器搜exports.index2
  • 分类页:category.jade,网址为/category/分类名,控制器搜exports.getcategory
  • 视频播放页:play.jade,网址为/play/视频id,控制器搜exports.play
  • 视频详情页:cmsmovie.jade,网址为/movie/视频id,控制器搜exports.getmovie
  • 最新更新:new.jade,网址为/news,控制器搜exports.news
  • 搜索页:search.jade,网址为/search?q=关键词,控制器搜exports.getsearch
  • 标签页:tag.jade,网址为/tag/标签名,控制器搜exports.getmoviesbytag
  • 短视频信息流:shortvideos.jade,网址为/shortvideos,控制器搜exports.getshortvideos
  • 发现页:discover.jade,网址为/discover,控制器搜exports.discover
  • 图集分类:ocategory.jade,网址为/ocategory/id,控制器搜exports.ocategory
  • 图集列表:images.jade,网址为/imageslist,控制器搜exports.getimages
  • 图集详情:image.jade,网址为/image/id,控制器搜exports.getimage
  • 专辑详情:album.jade,网址为/album/id,控制器搜exports.getalbum
  • 音频列表:audios.jade,网址为/audioslist,控制器搜exports.getaudioslist
  • 登录页:cmslogin.jade,网址为/login,控制器搜exports.login,表单提交搜exports.postlogin
  • 个人中心:user.jade,网址为/user/用户名,控制器搜exports.getuser
  • 编辑资料:edituser.jade,网址为/user/id/edit,控制器搜exports.getedituser,表单提交搜exports.postedituser
  • 我的收藏:favlist.jade,网址为/favlist/用户名,控制器搜exports.getuserfavlist
  • 用户上传:userupload.jade,网址为/userupload,控制器搜exports.userupload,表单提交搜exports.postuserupload
  • 开通VIP:buyvip.jade,网址为/buyvip,控制器搜exports.buyvip,表单提交搜exports.postbuyvip
  • 购买积分:buyscore.jade,网址为/buyscore,控制器搜exports.buyscore,表单提交搜exports.postbuyscore
  • 商品/支付确认:item.jade,网址为/item/id,控制器搜exports.getitem,表单提交搜exports.postitem
  • 邀请返利:invites.jade,网址为/invites/id,控制器搜exports.invites
  • 支付成功提示:success.jade,网址为/pay/success,控制器搜exports.paySuccess
  • 404页:404.jade,无固定网址,各处出错时由res.render('projectz/404')渲染

公共文件

  • cmslayout.jade:全站母版,顶栏、底栏、全局JS都在这里,每个页面的第一行都是extends cmslayout,改导航栏/页脚就改它。
  • videocard.jade:视频卡片组件,首页、分类、搜索等列表页共用,改封面卡片样式就改它。
  • 全站样式在public/css/projectx.css。

改不出来可把代码复制给AI

提示:改动前先备份原文件,复制一份改名为.bak,改坏了直接换回来;让AI只给需要改的那一段,不要让它重写整个文件,方便对照哪里变了。

用上面的方法找到相关文件后,可以直接把整段相关代码复制给AI(如Claude),并附上三样东西效果最好:页面网址(如/category/动作片)、文件路径(如views/projectz/category.jade或controller/cms.js里的某个函数)、想要的效果(如每页显示24个视频)。

AI会给出改好的代码,复制回来替换对应文件里的原函数即可。