vqmod for opencart插件制作进阶与技巧

15年的时候，我写过一篇文章《略谈 vqmod for opencart 插件制作过程》，也不知道被哪些人抄袭过去了。不过无所谓了。文章梳理的思路还是在我这里。今天对这篇文章进行进一步补充。

file标签

如果有多个类似文件，我们写很多个吗？其实可以不必要，利用path和逗号解决这个问题。

<file name="catalog/view/theme/*/template/module/latest.tpl">
</file>
<file name="catalog/view/theme/*/template/module/bestseller.tpl">
</file>
<file path="catalog/view/theme/*/template/module/" name="latest.tpl,bestseller.tpl">
</file>

其中，上面的 * 代表任何文件，如果有多个模板可以这么解决。

operation标签

如果一个地方，搜索不到，导致整个XML不起作用怎么办呢？可以定义跳过，不过不要总使用这样的，比如你TPL搜索到了代码，但是C层或者M层搜索不到，那样会导致页面报错。所以C层和M层不建议使用跳过，而V层可以。

<file name="catalog/view/theme/*/template/product/product.tpl">
<operation error="skip">
</operation>
</file>

当然了，如果你要写个注释，比如这个功能干嘛的。你可以这样写：

<file name="catalog/view/theme/*/template/product/product.tpl">
<operation error="skip" info="添加xx功能">
</operation>
</file>

regex

如果你想用正则搜索怎么办呢？有时候普通搜索很难定位，其实vqmod也是支持的啦。

<file name="catalog/view/theme/*/template/product/product.tpl">
<operation error="skip" info="添加xx功能">
<search position="replace" regex="true"><![CDATA[~<div(.*?)class="(.*?)image(.*?)"(.*?)>~]]></search>
</operation>
</file>

正则方面以后会写一期文章，如果你不熟悉，可以用别的替代方法，比如上面提到的文章里提到的index，也可以用下面这个。

offset

这个是用于搜索到的第几行，用于position的参数是after或者before的时候。可以是正数或者负数。如果是after，搜索到的行，往下数一行然后添加代码，就是1。如果你是before，然后往上数两行再添加代码在上面，就是2。

下面搜索这段代码添加作为例子。

<div class="col-sm-12">
<label class="control-label"><?php echo $entry_rating; ?></label>
    <?php echo $entry_bad; ?> 
<input type="radio" name="rating" value="1" />
 
<input type="radio" name="rating" value="2" />
 
<input type="radio" name="rating" value="3" />
 
<input type="radio" name="rating" value="4" />
 
<input type="radio" name="rating" value="5" />
 <?php echo $entry_good; ?></div>
</div>

用XML对这段代码进行添加代码。如下四个示例：

<file name="catalog/view/theme/*/template/product/product.tpl" keep="true">
<operation error="skip">
<search position="after" offset="1"><![CDATA[<input type="radio" name="rating" value="1" />]]></search>
<add><![CDATA[<b>测试1</b>]]></add>
</operation>
<operation error="skip">
<search position="after" offset="-1"><![CDATA[<input type="radio" name="rating" value="2" />]]></search>
<add><![CDATA[<b>测试2</b>]]></add>
</operation>
<operation error="skip">
<search position="before" offset="1"><![CDATA[<input type="radio" name="rating" value="3" />]]></search>
<add><![CDATA[<b>测试4</b>]]></add>
</operation>
<operation error="skip">
<search position="before" offset="-1"><![CDATA[<input type="radio" name="rating" value="4" />]]></search>
<add><![CDATA[<b>测试4</b>]]></add>
</operation>
</file>

你会得到下面的缓存代码：

大家从上面的图片中不难发现，before的时候offset是负数1的时候和直接用after，不用offset没区别，after的时候offset是负数1的时候和直接用before不用offset的也没区别，负数值大的时候，offset是-5，position是after等同于offset=4，position是before。所以其实offset有负数功能，但是也没太大意义。

iafter和ibefore

相比于after和before，前面加个i的区别就是，在搜索到的代码后面或者前面添加。下面给个例子：

【别问我为啥颜色不一样，我有几个编辑器。】

当sql这里要添加代码的时候，比如 telephone = '" . $this->db->escape($data['telephone']) . "',

代码：

<operation info="添加手机号">
<search position="iafter"><![CDATA[city = '" . $this->db->escape($data['city']) . "',]]></search>
<add><![CDATA[ telephone = '" . $this->db->escape($data['telephone']) . "',]]></add>
</operation>

这样的话，就会在搜索到的代码后面，加入add里指定的代码。值得注意的是，平时使用其他的position时，add定义的你怎么换行都没问题，如果是iafter、ibefore和replace的时候，代码的开头最好紧挨着<add><![CDATA[ 写，为啥这样呢，因为这样SQL又是一整行，而且有时候不适合换行。也可能对后面别人开发的插件代码干扰。以后讲讲vqmod的兼容问题。

ibefore这里不举例子了，同理的。搜索的前面加，和搜索的后面加的效果。

输出：

//iafter 的话
city = '" . $this->db->escape($data['city']) . "', telephone = '" . $this->db->escape($data['telephone']) . "',
//ibefore的话
telephone = '" . $this->db->escape($data['telephone']) . "',city = '" . $this->db->escape($data['city']) . "',