更新日志

Ver 1.6.4R

• 修正模板设置数据导入数据文本框误触发自动保存
• 修正新增字段默认值不显示问题
• 【Ver 1.6.1】修正插件导致的编辑文章预览关闭按钮常显问题
• 【Ver 1.6.2】修正部分代码
• 【Ver 1.6.3】修正部分JS
• 【Ver 1.6.4】修正部分CSS

VAM模板选项说明文档

本插件移植于WordPress的Codestar Framework ，在此表示感谢！

本插件部分代码进行加密，用于保护个人开发，无后门，可随意杀毒检测

本插件开发初衷是为EmlogPro生态出浅薄的一份力，让各位开发者搭配本插件开发出更为优秀的模板

为了不留下遗憾，人生总要勇敢一次，抛下一切顾虑，去做你真正想做的事。

前言

• 插件启用，若当前主题支持本插件则会在模板页当前模板卡片脚的最右侧，具体看最下面截图
• 若想左侧栏下方应用商店后显示XXX主题设置，请参考vam_options_config.php内注释说明
• 本插件开发者：Vaimibao-曦颜XY
• 文档修订时间：2024.04.23

支持的字段

• accordion - 折叠块
• backup - 选项设置备份
• border - 边框 (New)
• button_set - 按钮集(New)
• checkbox - 复选框
• code_editor - 代码编辑
• color - 颜色
• content - 内容 (New)
• color_group - 颜色集 (New)
• date - 日期
• dimensions - 尺寸 (New)
• fieldset - 字段集
• group - 字段组
• heading - 标题 (New)
• icon - 图标
• image_select - 图像选择
• link - 链接
• link_color - 超链接颜色 (New)
• notice - 提醒 (New)
• number - 数字文本框
• palette - 色板
• radio - 单选
• repeater - 多重项
• select - 选择（搜索）
• slider - 滑块
• sortable - 排序项
• sorter - 分类块
• spacing - 间距 (New)
• spinner - 调节器
• subheading - 子标题 (New)
• submessage - 小提醒
• switcher - 开关
• tabbed - 选项卡
• text - 单行文本
• textarea - 多行文本
• upload - 图像上传

配置文件书写说明

参考插件目录文档\vam_options.php的注释说明进行书写

1. 文件名：vam_options，不可更改
2. 该文件请放置于您的模板文件夹内，与已有的options.php位置同级
3. 配置文件的唯一ID参数$prefix格式：主题文件夹名 + _options，如Cherish主题解压后文件夹名Cherish + _options即cherish_options。请小写书写
4. 配置里数组icon值为Remixicon图标的class属性值，亦可使用插件自带的Font Awesome V4 class属性值
5. 若您有WordPress主题使用Codestar Framework配置文件的，可平滑复制过来，将CSF、csf字样改为VAM、vam
6. 配置文件目前移植并支持的区块字段基本如上述，您亦可参照Codestar Framework官方文档书写，注意某些字段不支持

插件的配置文件

具体请参考vam_options_config.php内注释说明

• 文件名：vam_options_config，不可更改

设置数据获取函数

• 使用 _vam() 或_vamc()获取
• _vamc()和_vam() 区别在于前者使用缓存方式获取设置数据。如有问题请使用后者。
• _vamc()使用方法与 _vam()一致，下方不多赘述
• 该函数位于vaimi_options/functions/include.php
• 不同的区块取值的结果不一致，例如单行文本框获取的是字符串，排序项(sortable)获取的是数组，可能需要根据子项ID或数组下标进行遍历
• _vam()函数参数第一个是选项ID的值，第二个是该选项如果没查到数据返回的值，第三个是该选项的子项的ID值

/**
 * 获取及设置主题配置参数 - 数据库方式
 * @param $name //选项的ID值
 * @param $default //若未获取到该选项的数据则返回该默认值
 * @param $subname //该选项的子项ID值
 * @return false|mixed
 */
function _vam($name, $default = false, $subname = '')
{
    static $options = null;
    if ($options === null) {
        $options = unserialize(vam_get_options(strtolower(TPL_NAME) . '_options'));
    }

    if (isset($options[$name])) {
        if ($subname) {
            return isset($options[$name][$subname]) ? $options[$name][$subname] : $default;
        } else {
            return $options[$name];
        }
    }
    return $default;
}

function _vamc($name, $default = false, $subname = '')
{
    static $options = null;
    if ($options === null) {
        global $CACHE;
        $options = $CACHE->readCache('vam_opts_'.strtolower(TPL_NAME).'_data');
    }

    if (isset($options[$name])) {
        if ($subname) {
            return isset($options[$name][$subname]) ? $options[$name][$subname] : $default;
        } else {
            return $options[$name];
        }
    }
    return $default;
}

后言

• 如遇本插件相关BUG或本插件问题可联系QQ：1334669076

截图