本文最后更新于 16 天前，其中的信息可能已经有所发展或是发生改变。
自202305-玲娜贝儿鳄鱼池版本后发布的主题包，引入了大量自定义字段。
所有自定义字段，在魔方后台设置。其中，默认值带*标记的，是魔方自带字段可配置的变量。
由于魔方的一定特性，此模板需要独占两个菜单项目来确保自动获取产品分类可用。需要在“用户中心导航”妥善配置，特性会在下方额外描述。
写在最前
重要常见问题：
社区版用户密码一直提示错误
社区版支持登录加密模板，必须在后台让财务系统知道登录时加密了。
侧边栏不显示
参阅：https://blog.yang1120.com/archives/289
实例用量不显示
参阅：https://www.runyun.cc/details/someone_yang/1416
隐藏主题作者信息
参阅：https://www.runyun.cc/details/someone_yang/1403
自定义字段在哪里设置
参阅：https://www.runyun.cc/details/someone_yang/1404
其他主题常见问题因篇幅问题不罗列在这里，请移步参阅润云数据门户：https://www.runyun.cc/details/someone_yang/1503
可能由我或者其他用户贡献处理方案，在润云数据门户。您可搜索了解。也可以加入氧化小店售后服务群交流。
true/false的填写
因为智简魔方财务系统传给前端的自定义字段值全部为字符串，不能直接作为布尔值使用。标记有true/false填写建议的选项，建议从 true（是）和 false（否）两个英文中选择一个填入。填写其他任意内容或留空，一律按默认值处理。
全局标识
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_clientname | 向用户展示的控制台别名。如果没有设置，则取后台设置的系统名。 | 润云魔方控制台 (*系统名称) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_teamname | 向用户展示的团队名，用于显示在app bar之类。如果没有设置，则取后台设置的系统名。 | 氧化科创 润云数据 (*系统名称) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_document_url | 文档中心 URL，如果不设置，相关的按钮将不会显示。 | https://d.runyun.cc/ (null) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_qqgroup_url | 用户QQ群一键加群链接。如果不设置，相关的按钮将不会显示。 | https://jq.qq.com/ (null) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_qqgroup_number | 用户QQ群号。 | 58****38 | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_footermsg | 尾部卡片信息。 | (C) 氧化科创 润云数据(玲行云端) 2015-2023. All rights reserved. | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_hidecopy | 隐藏尾部“氧MDUI版权声明”。 只允许一手授权所有人（在氧化小店拥有氧MDUI产品授权的用户）隐藏作者信息；二次分发获取的主题不允许隐藏作者信息，否则属于违规分发，将导致分发者与被分发者均禁止接收后续主题更新。 | 如果要隐藏版权信息：设置为 true | 202405毛替 |
| yangmdui_enable_darkview | 测试功能：启用暗色模式支持 | true (false) | 社区版20240730 |
便利服务
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_listpdactived | 总是为跳转到产品列表的链接加上“已激活”筛选参数。 | true/false(false) | 202306-可琦安曲奇饼 |
样式客制化
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_color_primary | MDUI主色 | (indigo) | 社区版20240724 |
| yangmdui_color_accent | MDUI强调色 | (indigo) | 社区版20240724 |
| yangmdui_bootstrap_support | 测试功能：启用脚本将 Bootstrap 样式转换为 MDUI 样式（目前仅渲染一次） | true (false) | 社区版20240724 |
| yangmdui_enable_darkview | 测试功能：启用暗色模式支持 | true (false) | 社区版20240730 |
| yangmdui_bodybg | 全局背景图（相对或绝对地址） | 社区版20240829 | |
| yangmdui_drawer_class | 侧边栏额外类。 （需要侧边栏背景色，可以尝试添加 mdui-color-white） | 社区版20240829 | |
| yangmdui_custom_logout_sidebar | 自定义未登录用户侧边栏。默认不启用，默认只显示注册和登录。 | 社区版20241018 | |
| yangmdui_card_radius | 强制覆盖全局 MDUI 卡片圆角。需要带单位。 | 2px （默认大小） | 社区版20241018 |
| yangmdui_btn_radius | 强制覆盖全局 MDUI 普通按钮圆角。需要带单位。 | 2px （默认大小） | 社区版20241018 |
| yangmdui_btn_icon_radius | 强制覆盖全局 MDUI 图标按钮圆角。需要带单位。（修改普通按钮圆角后建议同时设置此项） | 36px （默认大小） | 社区版20241018 |
| yangmdui_color_primary_custom | 强制覆盖全局 MDUI 主题色，支持任意颜色。 要使此项生效，设置yangmdui_color_primary值为yangmdui | #FFFF00 以及其他支持的值 | 社区版20241018 |
| yangmdui_color_accent_custom | 强制覆盖全局 MDUI 强调色，支持任意颜色。 要使此项生效，设置yangmdui_color_accent值为yangmdui | #FFFF00 以及其他支持的值 | 社区版20241018 |
主页新人卡片
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_welcomecard | 启用新人欢迎卡片。 | true/false(false) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_wcc_displaypro | 新人优惠码开关。 | true/false(false) | 202306-可琦安曲奇饼 |
| yangmdui_wcc_prodesc | 新人优惠码释义。 | 无门槛5元 | 202306-可琦安曲奇饼 |
| yangmdui_wcc_procontent | 新人优惠码内容。 | 202306-可琦安曲奇饼 | |
| yangmdui_wcc_desc | 新人卡片说明文本。 | 使用方法：购置实例时，填入“优惠码”。 | 202306-可琦安曲奇饼 |
| yangmdui_wcc_smdesc | 新人卡片说明文本，灰色小字。 | 202306-可琦安曲奇饼 |
用户中心主页推介计划报表
计划发布一个插件，自动生成推介计划排名，从而替代这片内容。
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_afftable | 用户中心主页的推介计划报表展示开关。为 true 时展示报表。 | true(null) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_aff_name_{1-10} | 推介计划受益人名称，共10位用户名。 | 氧化某人(null) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_aff_money_{1-10} | 推介计划收益金额，对应上一则每一位用户。 | ￥114(null) | 202305-玲娜贝儿鳄鱼池 |
| yang_aff_rank_addid | 启用氧化主题推介排名插件自动生成推介排名（神人榜）。 需要安装 Wood秋木 氧化主题推介排名插件。 | 早期版本填写插件id； 202409xx后填 true | 社区版20240820 |
一言模块
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_enable_hitokoto | 启用底部一言。 | true/false(false) | 202305-玲娜贝儿鳄鱼池 |
| yangmdui_hitokoto_serviceurl | 一言api地址，支持兼容hitokoto的一切api。启用一言情况下，没有定义此变量，则使用官方地址。 | https://v1.hitokoto.cn/(https://v1.hitokoto.cn/) | 202305-玲娜贝儿鳄鱼池 |
用户中心公告（新弹窗公告）
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_clientarea_notice_enable | 启用用户中心弹窗公告。 | true/false(false) | 社区版20240925 |
| yangmdui_clientarea_notice_title | 公告标题 | (欢迎回来) | 社区版20240925 |
| yangmdui_clientarea_notice_content | 公告内容 | (欢迎您登录用户中心，您可以现在开始管理您的账户资产和相关实例资源。) | 社区版20240925 |
| yangmdui_clientarea_notice_allowignore | 是否允许用户不再显示相同公告 | true/false(false) | 社区版20240925 |
购物车公告（新弹窗公告）
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_cart_notice_enable | 启用购物车弹窗公告。 | true/false(false) | 社区版20240925 |
| yangmdui_cart_notice_cardtitle | 公告标题（不同于顶栏公告） | (重要提示) | 社区版20240925 |
| yangmdui_cart_notice_content | 公告内容 | (请合法合规使用本站产品提供互联网业务。) | 社区版20240925 |
| yangmdui_cart_notice_allowignore | 是否允许用户不再显示相同公告 | true/false(false) | 社区版20240925 |
购物车
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_cart_stock | 展示库存信息。（未登录状态下是否展示库存售空？） | true/false(true) | 202403预览版：兔子 |
| yangmdui_stock_showdetails | 展示具体的库存信息，精确数字。 | true/false(true) | 202403预览版：兔子 |
| yangmdui_logout_hide_price | 向未登录用户限制查看产品可用区，限制读取库存和价格。 | true/false(false) | 202403预览版：兔子 |
| yangmdui_hidetrial | 隐藏试用信息，并禁用前端试用选项。 | true/false(false) | 202405毛替 |
| yangmdui_cart_notice | 购物车公告内容。填写后会自动启用公告卡片。 | 社区版20240816 | |
| yangmdui_cart_notice_title | 购物车公告标题。 | (最新公告) | 社区版20240816 |
| yangmdui_cart_notice_subtitle | 购物车公告副标题。不填写则隐藏副标题。无默认值。 | 社区版20240816 | |
| yangmdui_show_trialprice | 在产品卡片显示产品试用价格 | true/false(false) | 社区版20250404 |
| yangmdui_show_trialprice_non | 尽管不允许试用，也显示“该产品不支持试用”（用于一些情况对齐卡片） | true/false(false) | 社区版20250404 |
| yangmdui_show_bates | 显示优惠报价 | true/false(false) | 社区版20250404 |
| yangmdui_show_productinfo | 在产品卡片上显示分组id，产品id，分类名 | true/false(false) | 社区版20250404 |
| yangmdui_show_productinfo_batesonly | 仅在存在优惠时，显示分组id，产品id，分类名 | true/false(false) | 社区版20250404 |
财务模块
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_billing_payment | 财务处理渠道服务商。应该是您的收款服务商名称。留空不在相应位置显示。 | 202403预览版：兔子 | |
| yangmdui_billing_payee | 财务收款方。应该是您的团队名称。留空不在相应位置显示。 | 202403预览版：兔子 |
登录注册
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_login_message | 自定义登录卡片标题。留空则显示“登录到控制台名称”。 | 202403预览版：白猫 |
实例管理
| 字段名 | 使用释义 | 建议值(默认值) | 启用版本 |
|---|---|---|---|
| yangmdui_hideteststatus | 隐藏产品内页状态信息，对于没有设计获取实例状态的模块有帮助。 | true/false(false) | 202406烤烤烤 |
