Z-Blog PHP 的 LinksManage插件作用实操

书香斋主  2026-07-01 16:31:51  阅读 10 次 评论 0 条
摘要:

 关于 Z-Blog PHP 的 LinksManage(链接模块管理)1.2.3插件,其模块模板加载优先级和自定义方法说明如下:     

    一、完整模板加载优先级(从高到低,越高越优先匹配)

    插件加载逻辑:先找模块专属主题模板 → 再找插件 usr 自定义通用模板 → 最后加载插件内置默认模板    

    1.最高优先级:主题目录下的专用模板 template/lm-module-模块文件名.php(最高优先级,推荐自定义方式)    

 关于 Z-Blog PHP 的 LinksManage(链接模块管理)1.2.3插件,其模块模板加载优先级和自定义方法说明如下:     

    一、完整模板加载优先级(从高到低,越高越优先匹配)

    插件加载逻辑:先找模块专属主题模板 → 再找插件 usr 自定义通用模板 → 最后加载插件内置默认模板    

    1.最高优先级:主题目录下的专用模板 template/lm-module-模块文件名.php(最高优先级,推荐自定义方式)    

    例如导航栏模块叫 navbar,对应模板:themes/你的主题名/template/lm-module-navbar.php 。只要该文件存在,当前 {module:navbar} 模块会优先渲染此模板,完全覆盖插件自带所有模板,官方推荐主题作者使用。插件说明中"主题作者可设置 lm-module-navbar 模板对当前模块进行自定义",指的就是放这里。    

    2.次优先级:插件 usr 目录下的自定义通用模板(不推荐) zb_users/plugin/LinksManage/usr/li.html 全站所有链接模块统一共用一套模板,不区分模块文件名;插件标注「不推荐」,因为会全局统一样式,无法给不同链接模块做差异化布局。    

    3.最低优先级:插件内置默认模板 zb_users/plugin/LinksManage/var/li.html 插件原始底层模板,无任何自定义文件时才会加载,编译标识为 lm-module-defend。

   ⚠️ 注意:Z-Blog 模板系统编译后实际用的是 .php文件,你在主题目录下放的也应该是 .php后缀(内容是 HTML + Z-Blog 模板标签),不是 .html。插件文档写 .html是指源码参照文件,最终主题目录要存为 .php。     

 二、如何让自定义模板生效(操作步骤) 

    以导航栏(navbar)模块 为例: 

    1.打开你当前启用的主题目录: zb_users/theme/<主题id>/template/

    2.新建文件 lm-module-navbar.php,写入参照 zb_users/plugin/LinksManage/var/li.html修改后的结构,例如最简示例:

         {foreach $module.All AS $link}

            {$link.Name}

        {/foreach}    

    3.回到 Z-Blog 后台首页 → 点击「清空缓存并重新编译模板」(或停用再启用主题)。 

    4.刷新前台页面,LinksManage 会优先调用你主题目录下的 lm-module-navbar.php,不再用插件默认模板。

    三、补充说明

    如果模块类型是自建的其他名称(如在 LinksManage 里建了名为 footerlink的模块且设为 navbar 类型),仍用 lm-module-navbar.php;若插件支持按模块 filename 区分,具体以插件实际注册的模板名为准,但绝大多数情况就是 lm-module-<模块metas里的type值>.php。

本文地址:http://www.sxzcn.com/4317.html
免责声明:本文为原创文章,版权归 书香斋主 所有,欢迎分享本文,转载请保留出处!
NEXT:已经是最新一篇了

评论已关闭!