【免费下载链接】GrootMadeThe official connected dashboard plugin for installs, updates, collections, and site assets.项目地址https://gitcode.com/gh_mirrors/connect32/GrootMade点击查看免费下载GrootMade 是 WordPress 官方的资产连接面板插件用于插件、主题与模板套件的发现、安装、更新与集合管理。本文带你用.env文件完成 GrootMade 白标定制只需改一个配置文件就能替换品牌名称、Logo、命名空间和后台菜单标题打造属于你自己的 WordPress 插件。为什么 GrootMade 适合白标定制 ️很多代理商和开发者在分发 WordPress 插件时都希望去掉原厂品牌、换上自己的 Logo 与名称。GrootMade 把这个需求做成了配置驱动品牌、身份、命名空间全部来自.env文件不需要手改几十个源码文件构建时由 Vite 插件自动注入到plugin.php头部注释、PHP 常量和前端配置中支持 Light / Dark 双主题 Logo以及WHITELABEL一键隐藏平台方信息 核心思路.env是唯一事实来源构建过程负责搬运。认识 .envGrootMade 白标的控制中心仓库中提供了现成的环境模板 .env.example以及稳定版配置 .env.stable 和测试版配置 .env.beta。白标定制时只需复制一份再修改。变量按用途分为三大类1️⃣ 插件身份Identity变量作用示例SLUG插件唯一标识REST 路由与发布包文件名都依赖它grootmadeNAME插件显示名称写入plugin.php的 Plugin NameGrootMadeDESCRIPTION插件描述—AUTHOR_NAME/AUTHOR_URL作者信息—URI插件主页地址—NAMESPACEPHP 命名空间前缀构建时自动改写源码GrootmadeTEXTDOMAIN翻译文本域自动注入所有 i18n 函数grootmade2️⃣ 后台界面与品牌Branding变量作用ADMIN_MENU_TITLEWordPress 后台侧边栏菜单标题ADMIN_PAGE_TITLE面板页面标题LOGO_LIGHT/LOGO_DARK亮色 / 暗色模式下的 Logo 地址BANNER_URL_HIGH/BANNER_URL_LOW插件目录横幅图ICON_URL插件图标3️⃣ 白标开关与接口Engine变量说明WHITELABEL1开启白标模式隐藏平台方链接0关闭ENGINE_URL/MAIN_SITE后端 API 地址与主站地址⚠️ 注意NAMESPACE和TEXTDOMAIN是必填项缺失时构建会直接报错见 src/vite/wp-react/plugins/wp.ts。.env 是如何生效的构建注入机制GrootMade 通过一个自定义 Vite 插件 WPEnvProcess 在每次构建/启动时自动完成四件事注入 PHP 常量— 按 vite.config.ts 中的常量清单把SLUG、ADMIN_MENU_TITLE、ENGINE_URL等值写入 includes/src/Constants.php后台菜单标题正是读取这里的Constants::ADMIN_MENU_TITLE见 includes/src/Admin.php改写 PHP 命名空间与文本域— 自动替换includes/src下所有 PHP 文件的namespace声明和 i18n 函数的 textdomain重写主文件头部— 更新 plugin.php 的 Plugin Name、Version、Author 等头部注释生成前端配置— 把LOGO_LIGHT、LOGO_DARK、WHITELABEL、NAME等写入 src/settings.json前端通过 src/config/site.ts 读取用于侧边栏 Logo 与品牌名见 src/components/sidebar/Sidebar.tsx此外还有两个配套脚本scripts/namespace.js — 根据NAMESPACE同步更新 composer.json 的 PSR-4 自动加载映射scripts/release.js — 用SLUG打包dist/{SLUG}.zip发布包并生成info.json白标开关的处理逻辑在 src/vite/wp-react/plugins/wp.tsWHITELABEL1时whitelabel: true且provider置空前端所有指向平台方的定价/官网入口随之隐藏。开发模式下该插件还会监听.env文件变化改动后约 5 秒自动重新注入见 src/vite/wp-react/plugins/wp.ts调试非常方便。白标定制分步指南从克隆到发布 第一步获取源码并复制环境模板git clone https://gitcode.com/gh_mirrors/connect32/GrootMade wp-content/plugins/grootmade cd wp-content/plugins/grootmade cp .env.example .env环境模板参考.env.example第二步修改插件身份编辑.env替换为你的品牌信息SLUGmy-dashboard NAMEMyDashboard DESCRIPTIONYour all-in-one dashboard for managing site assets. NAMESPACEMyDashboard TEXTDOMAINmy-dashboard ADMIN_MENU_TITLEMyDashboard ADMIN_PAGE_TITLEMyDashboard AUTHOR_NAMEYour Studio⚠️SLUG会同时影响 REST API 路径/wp-json/{SLUG}/v1/见 src/lib/api-route.ts和发布包文件名发布前不要随意更改否则会破坏前端 API 调用。第三步替换 Logo 与品牌图LOGO_LIGHThttps://your-cdn.com/logo-light.svg LOGO_DARKhttps://your-cdn.com/logo-dark.svg BANNER_URL_HIGHhttps://your-cdn.com/banner-high.jpg BANNER_URL_LOWhttps://your-cdn.com/banner-low.jpg ICON_URLhttps://your-cdn.com/icon.pngLogo 会同时出现在面板顶栏与侧边栏亮/暗模式各取一份建议准备两份。第四步决定是否开启白标模式# 隐藏 GrootMade 平台方链接纯自有品牌 WHITELABEL1第五步安装依赖并构建npm install composer install npm run build构建完成后检查三个产物确认注入成功文件应看到的变化plugin.phpPlugin Name / Author 变成你的品牌includes/src/Constants.php各常量值来自.envsrc/settings.jsonname、logo、whitelabel已更新第六步打包发布npm run dist会生成dist/{SLUG}.zip与info.json即可上传到任意 WordPress 站点安装流程见 INSTALL.md。常见坑与排查清单 ️现象原因与解决构建报NAMESPACE and TEXTDOMAIN must be defined.env漏写这两个必填变量后台菜单名没变只改了ADMIN_MENU_TITLE未重新构建常量未注入Constants.php前端 Logo 不显示检查LOGO_LIGHT/LOGO_DARK是否为可公开访问的地址且已重新构建生成settings.jsonAPI 404SLUG改动后前端请求路径与后端路由不一致二者必须一致多语言失效TEXTDOMAIN需与翻译文件.po中的文本域一致参考 scripts/po2json.js 提示.env的修改只影响构建结果修改后请重新执行npm run build或npm start再部署。总结GrootMade 的白标定制流程可以概括为一句话改一个.env跑一次构建。通过NAME、LOGO_LIGHT/LOGO_DARK、NAMESPACE完成品牌替换用WHITELABEL1隐藏平台方信息再用npm run dist打包分发。整个机制由 WPEnvProcess 自动完成注入无需手工修改源码是 WordPress 插件二次分发场景下非常实用的配置化方案。赞分享【免费下载链接】GrootMadeThe official connected dashboard plugin for installs, updates, collections, and site assets.项目地址https://gitcode.com/gh_mirrors/connect32/GrootMade点击查看免费下载相关推荐Atlas CMMS 白标定制完整指南自定义 Logo、品牌主题色与订阅计划配置详解Atlas CMMS 白标定制完整指南自定义 Logo、品牌主题色与订阅计划配置详解 Atlas CMMS 是一款开源、可自托管的企业级维护管理CMMS系从克隆到上线Claude Code Templates 如何把开发流程压缩一半从克隆到上线Claude Code Templates 如何把开发流程压缩一半 Claude Code Templates 是一个用于配置和监控 Claude开发工具AI 应用人工智能AI Agent如何为Best-README-Template添加自定义logo和品牌元素完整指南如何为Best README Template添加自定义logo和品牌元素完整指南 Best README Template是一个出色的README模板项目上一篇用 Quarto CLI 打造自定义 RevealJS 演示文稿格式扩展从 quarto create extension 到发布与安装下一篇Sandcastle 源码拆完才发现超时、流式输出、中止三件套我们全写错了创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考