include 文件引入标签

更新时间：2020-06-19 16:12:37 作者：米拓建站

## 概述：
在模板文件中通过`include`标签可引入模板中其他模板文件或系统里的其他模板文件。

【说明】
- 模板中的其他模板文件：即当前模板文件夹下的模板文件；
- 系统里的其他模板文件：可引入的系统其他模板文件路径请参考下方的“file参数特殊路径”。

## 使用范围：
所有模板文件页面。
## 类型：
功能标签，引入其他模板文件的功能标签。
## 语法：

<include file="模板文件路径" page="页面名称"/>
    //例如：<include file="head.php" page="index"/>，代表引入当前模板文件夹下的head.php文件
    //例如：<include file="ajax/product.php"/>，代表引入当前模板文件夹下的路径为ajax/ajax.php的文件

【说明】include标签中对应的参数及选项值可参考下面的“参数说明”；
## 标签原理：

`include`是一个功能标签，模板前台渲染时，系统会把include标签替换成`file`参数中对应的模板文件代码。
  
### include标签：

**index.php代码：**

aaaaaa
    <include file="head.php" page="index"/>
    bbbbbb

**head.php代码：**

<p>ccccc</p>

**前台index.php模板输出代码：**

aaaaaa
    <p>ccccc</p>
    bbbbbb

## 参数说明：

include标签，可通过传入不同的参数值，来调用对应的模板文件，以下为include标签参数和参数值：

|参数名|是否必填|默认值|说明|
|:----    |:-------    |:---|:---|
|file|是 |null|要引入的模板文件路径,当前模板文件夹中其他模板文件（可省略文件后缀名）或模板文件夹之外的文件（请参考下面的【file参数特殊路径】）|
|page|否 |null|说明当前模板是哪个页面，填当前页面的名称（只有调用模板下的head.php时才需要填，供head.php里的met_meta标签上的page参数值$met_page调用，$met_page等于此处page参数的值，具体请参考文档【[met_meta标签](https://doc.metinfo.cn/mb/mbtag/114.html "met_meta标签")】）|

### file参数特殊路径：

引入系统里的其他模板文件时，只能通过以下特殊字符开头来调用相应的模板文件路径，不支持调用系统其他目录下的模板文件

//特殊字符开头字符对应的实际路径
     ui_ajax：public/ui/v2/module/ajax/（可调用网站根目录public/web/templates/ajax/下的文件）
	 
     ui_v2/module/shop/shop_option_ui.php //ui_v2调用商城模块文件下app/app/shop/web/templates/met/module/shop_option.php

**例如：**

<include file='ui_ajax/message'/> //调用public/web/templates/ajax/message.php文件（此文件可在模板文件message_index.php中调用）
    <include file='ui_v2/module/shop/shop_option_ui.php'/> //这个比较特殊，调用文件实际路径为网站根目录下app/app/shop/web/templates/met/module/shop_option.php

## 示例：
### 内容列表页调用模板公共的头部和底部文件
**场景案例：**文章模块列表页（`news.php`）头部和底部区块共用当前模板的头部（`head.php`）和底部（`foot.php`）区块。

**模板代码**：
`news.php：`

<include file="head.php" page="news"/>//调用当前模板文件夹下的head.php，page参数值为模板文件名news
    <p>文章列表页自定义的内容</p>
    <include file="foot.php"/>//调用当前模板文件夹下的foot.php

**head.php：**

<met_meta page="$met_page" />//页面开头标签（固定格式），前台输出后渲染成包含html文件开头的代码，包含了html、head、meta、link、style、script、body等标签代码，以‘<body>’结尾，具体请参考文档【met_meta标签】
    <p>头部区块的内容，此内容编写在head.php中</p>

`foot.php：`

<p>底部区块的内容，此内容编写在foot.php中</p>
    <met_foot />//页面结尾标签，（固定格式）前台输出后渲染成包含html文件开头的代码，包含了script、body、html等标签代码，以‘</html>’结尾，具体请参考文档【met_foot标签】

【注意】
- `met_meta`标签：https://doc.metinfo.cn/mb/mbtag/114.html
- `met_foot`标签：https://doc.metinfo.cn/mb/mbtag/115.html
- 实际编写时请去掉注释文字。

**模板文件news.php前台对应页面输出HTML：**

...//met_meta输出的代码请查看文档【met_meta标签】
    <body>
    <p>头部区块的内容，此内容编写在head.php中</p>
    <p>文章列表页自定义的内容</p>
    <p>底部区块的内容，此内容编写在foot.php中</p>
    </body>
    ...//met_foot输出的代码请查看文档【met_foot标签】

### 如何调用系统默认列表页模板文件
**场景案例：**文章模块列表页（`news.php`）内容列表区块代码可自定义样式或直接调用系统默认的样式文件（`即网站根目录下public/web/templates/ajax/news.php文件`）。

**模板代码：**
`news.php：`

//内容列表部分代码
    <ul class="met-pager-ajax">//内容列表用ul、li标签的格式，可根据自己需求修改;列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
        <include file='ui_ajax/news/'>//调用系统默认的文章模块列表页内容列表文件（即网站根目录下public/web/templates/ajax/news.php文件）
    </ul>

【注意】实际编写时请去掉注释文字。

**前台页面输出HTML：**

<ul class="met-pager-ajax">
      ...//内容列表部分输出的代码请参考文档【tag 文章内容列表】中示例https://doc.metinfo.cn/mb/mbtag/67.html
    </ul>
    
### 产品详情页如何调用系统默认商城模块文件
**场景案例：**开启商城模块后，产品详情页（shop_showproduct.php）如何调用包含商品规格、优惠券及加入购物车等功能的模板文件。

**模板代码：**

//模板中间内容的代码
    ...//产品轮播图部分代码，请自行定义
    <include file='ui_v2/module/shop/shop_option_ui.php'/> //调用商城应用中包含商品规格、优惠券及加入购物车等功能的模板，调用文件实际路径为网站根目录下app/app/shop/web/templates/met/module/shop_option.php

【注意】实际编写时请去掉注释文字。

**前台页面输出HTML：**

//模板中间内容的代码
    ...//产品轮播图部分代码，请自行定义
    <div class="shop-product-intro grey-500">
        // 商品价格
        <div class="p-20 bg-grey-100 red-600 price">
            <span class="font-size-18">￥</span>
            <span id="price" class="font-size-30" data-price="999.00">999.00</span>
        </div>
        // 商品优惠券，没有设置优惠券就不会显示出来
        <div class="shoppro-discount row" hidden="">
            <label class="col-sm-3">优惠</label>
            <div class="shoppro-discount-body col-sm-9">
                <div class="shoppro-discount-list inline-block" data-state="0"></div>
                <div class="shoppro-discount-list inline-block" data-state="1"></div>
                <a href="../shop/discount.php?lang=cn#state_1" target="_blank" class="btn btn-default btn-outline btn-xs" title="链接关键词">查看更多优惠券</a>
            </div>
        </div>
        // 商品优惠券领取时的弹框，没有设置优惠券就不会显示出来
        <div class="modal modal-fade-in-scale-up modal-danger" id="discount-received-modal" aria-hidden="true" aria-labelledby="discount-received-modal" role="dialog" tabindex="-1">
            <button type="button" class="close font-size-40" style="position:fixed;top: 0;right: 20px;" data-dismiss="modal" aria-label="Close">
                <span aria-hidden="true">×</span>
            </button>
            <div class="modal-dialog modal-center modal-sm">
                <div class="modal-content">
                    <div class="pricing-list border-none text-xs-left m-b-0">
                        <div class="pricing-header radius0">
                            <div class="pricing-title p-x-30 p-t-30 p-b-0 font-size-20 font-weight-300"></div>
                            <div class="pricing-price p-y-10 p-x-30 font-size-50 font-weight-300">
                                <span class="pricing-currency font-size-30">￥</span>
                                <span class="pricing-amount"></span>
                            </div>
                            <div class="pricing-tips p-x-30 p-b-30">
                                <p class="m-b-0 pricing-par">
                                    订单满 ￥ <strong class="font-size-16"></strong>
                                    可以使用
                                </p>
                                <p class="m-b-0 pricing-time">
                                    有效期：
                                    <span></span>
                                </p>
                                <p class="m-b-0 pricing-inst">
                                    使用说明：
                                    <span></span>
                                </p>
                            </div>
                        </div>
                        <div class="pricing-footer p-30 text-xs-center bg-blue-grey-100 radius0">
                            <a class="btn btn-lg btn-squared ladda-button" href="javascript:;" data-id="" data-timeout="200" data-style="slide-right" data-plugin="ladda" title="链接关键词">
                                <span class="ladda-label"> <i class="icon wb-arrow-right" aria-hidden="true"></i> <font class="btn-text"></font>
                                </span>
                            </a>
                        </div>
                    </div>
                    <div class="discount-received-success p-x-20 p-y-30 bg-white" style="display:none;">
                        <div class="row m-0"> <i class="icon pe-cash pull-xs-left font-size-60" aria-hidden="true"></i>
                            <div class="row pull-xs-left m-l-20 m-r-50">
                                <h4 class="media-heading font-size-16"></h4>
                                <p class="font-size-20 green-800 m-b-0">领取成功！</p>
                            </div>
                        </div>
                        <div class="m-t-20 discount-received-success-btn">
                            <a class="btn btn-default btn-squared font-size-16" href="../shop/discount.php?lang=cn#state_1" target="_blank" title="链接关键词">查看更多优惠券</a>
                            <a class="btn btn-danger btn-squared m-l-10 font-size-16 btn-use" href="javascript:;" title="链接关键词">立即使用</a>
                        </div>
                    </div>
                </div>
            </div>
        </div>
        // 商城js变量，供商城应用js调用
        <script>
    var discount_json_url = '../shop/discount.php?lang=cn&a=domydiscount',
        discount_listjson_url = '../shop/discount.php?lang=cn&a=dodiscount_list',
        discount_receive_url = '../shop/discount.php?lang=cn&a=doreceive',
        discount_getdisinto_url='../shop/discount.php?lang=cn&a=dogetdisinto';
    </script>
        // 商品规格列表
        <div class="shop-product-para">
            <div class="row m-t-15">
                <label class="form-control-label col-sm-3">颜色</label>
                <div class="selectpara-list col-sm-9">
                    <a href="javascript:;" title="红" data-id="1" class="selectpara text-truncate btn btn-squared btn-outline btn-default m-r-10 btn-danger">红</a>
                    <a href="javascript:;" title="黑" data-id="2" class="selectpara text-truncate btn btn-squared btn-outline btn-default m-r-10">黑</a>
                    <a href="javascript:;" title="白" data-id="3" class="selectpara text-truncate btn btn-squared btn-outline btn-default m-r-10">白</a>
                </div>
            </div>
        </div>
        <div class="row m-t-15">
            <label class="form-control-label col-sm-3">数量</label>
            <div class="col-sm-9">
                <div class="w-150 inline-block m-r-10">
                    <div class="input-group bootstrap-touchspin">
                        <span class="input-group-btn input-group-prepend">
                            <button class="btn btn-default bootstrap-touchspin-down" type="button">-</button>
                        </span>
                        <span class="input-group-addon bootstrap-touchspin-prefix" style="display: none;"></span>
                        <input type="text" class="form-control text-xs-center" data-min="1" data-max="1997" data-plugin="touchSpin" name="buynum" id="buynum" autocomplete="off" value="1" style="display: block;">
                        <span class="input-group-addon bootstrap-touchspin-postfix" style="display: none;"></span>
                        <span class="input-group-btn input-group-append">
                            <button class="btn btn-default bootstrap-touchspin-up" type="button">+</button>
                        </span>
                    </div>
                </div>
                <div class="m-t-5 stock-purchase">
                    <div class="inline-block m-r-10">
                        库存
                        <span id="stock-num" data-stock="1997">998</span>
                        件
                    </div>
                </div>
            </div>
        </div>
        // 加入购物车、加入收藏的按钮
        <div class="m-t-20 clearfix cart-favorite">
            <a href="http://localhost/metv7_1/member/login.php?lang=cn" data-pid="8" class="btn btn-squared btn-lg
                        btn-warning
                    pull-sm-right product-favorite" title="链接关键词">
                <i class="icon
                                fa-heart-o
                            m-r-5"></i>
                <span>加入收藏</span>
            </a>
            <a href="../shop/cart.php?lang=cn&a=dotocart&pid=8" class="btn btn-lg btn-squared btn-danger m-r-20 product-tocart" title="链接关键词">
                <i class="icon fa-cart-plus m-r-5 font-size-20" aria-hidden="true"></i>
                加入购物车
            </a>
        </div>
    </div>
    //商品规格的js变量，供商城应用js调用
    <script>
    var stockjson = [{"id":"1","pid":"8","price":"999","stock":"998","sales":"1","para_img":"..\/?","lang":"cn","gprice":"999","paralist":[{"spec_id":"1","value_id":["1"]}]},{"id":"2","pid":"8","price":"999","stock":"999","sales":"0","para_img":"..\/?","lang":"cn","gprice":"999","paralist":[{"spec_id":"1","value_id":["2"]}]},{"id":"3","pid":"8","price":"999","stock":"0","sales":"0","para_img":"..\/?","lang":"cn","gprice":"999","paralist":[{"spec_id":"1","value_id":["3"]}]}];
    </script>