# 标签调用

## 配置信息

```php
inject('setting')->config($item);
```
- $item 配置项

### 获取当前语言配置

```php
inject('setting')->langs($fileName = 'system', $field = '');
```

- $fileName 语言包文件名称，目前包含2个：`system`， `web`
- $field 字段名称

::: warning 注意事项
网站里面不允许直接出现文字，所有文字的调取，都要通过语言配置
:::

## 说明页

标签：
```php
inject('block')->block($slug = '', $item = '', $key = '');
```

- $slug 说明页别名 `必填`
- $item 字段名称  `可选`
- $key 如果调取的字段为图片，填写0,1,2数字 `可选`

示例：
```php
// 获取说明页内容
{!! inject('block')->block('about', 'content') !!}

// 获取说明页第一张图片
{!! inject('block')->block('about', 'imgs', 0) !!}

// 获取说明页所有字段信息
{{ inject('block')->block('about') }}

// 返回值
return [
    'name': '',         // 名称
    'slug': '',         // 别名
    'description': [
        'title': '',    // 标题
        'imgs': '',     // 多图
        'extend': '',   // 摘要
        'content': ''   // 内容
    ],
    'created_at': '',   // 创建时间
    'updated_at': ''    // 更新时间
];
```

## 广告
标签：
```php
// 获取对应id广告信息
inject('ad')->ad($id);

// 获取对应id单个广告图片信息
inject('ad')->single($id, $noNum = 0, $field = '');
```
- $id 广告图片id `必填`
- $noNum 对应id广告中相应索引图片信息 `必填`
- $field 字段名称 `必填`

示例：
```php
// 对应id广告信息
{{ inject('ad')->ad(1) }}

// 广告中的单个图片信息
{{ inject('ad')->single(1, 0, 'img') }}

// 返回值
return [
    'img': '',           // 图片
    'url'： '',          // 链接地址
    'title': '',         // 标题
    'summary': '',       // 描述
    'order': ''          // 按升序排列
];
```

## 友情链接
标签：
```php
// 获取友情链接列表信息
inject('list')->link(int $status = 0);  // int 0 所有，1 文字，2图片
```

## 导航
```php
inject('nav')->nav()
```

## 栏目
标签：
```php
inject('category')->cate($table = 'product', $id = 0);
```
- $table 表名称 `可选`
  - `product` 产品分类
  - `news` 新闻分类
  - `case` 案例分类
  - `album` 相册分类
  - `job` 招聘分类
  - `video` 视频分类
  - `download` 下载分类
  - `page` 概况分类
- $id - 分类ID，`0` 表示顶级 `可选`

示例：
```php
// 调用产品三个分类
{{ inject('category')->cate()->take(3) }}

// 调用产品分类ID为1的所有子分类
{{ inject('category')->cate('product', 1) }}
```
返回值：

```
return [
    'cname': '',         // 标题
    'linkurl': '',       // 链接URL
    'flag': '',          // 状态
    'description': [
        'img': ''        // 图片
    ],
    'created_at': '',   // 创建时间
    'updated_at': ''    // 更新时间
];
```

## 概况管理
标签：
```php{5}
// 当前单页所有信息
$page;

// 获取当前单页详细内容
contentTag($page->description->content);
```
::: tip 提示
contentTag 给详细内容添加锚点，增加网站内链，适用于内容里面所有详细内容
:::

示例：
```php
// 获取当前单页所有信息
{{ $page }}

// 获取当前单页详细内容
{!! contentTag($page->description->content) !!}

// 返回值
return [
    'pid': '',                  // 分类ID
    'slug'： '',                // 别名
    'linkurl': '',              // 外部链接
    'flag': '',                 // 状态，1 发布，0 不发布
    'description': [
        'title': '',            // 标题
        'summary': '',          // 摘要
        'content': '',          // 详细内容
        'seo_title': '',        // SEO标题
        'seo_keywords': '',     // SEO关键词
        'seo_description': ''   // SEO描述
    ],
    'created_at': '',           // 创建时间
    'updated_at': ''            // 更新时间
];
```

## 内容
标签：
```php
inject('list')->lists($table = 'product', $pid = 0, $num = 20, $isPage = 1, $attribute = '', $order = 'orders', $sort = 'DESC');
```
- $table 表名称 `可选`
  - `product` 产品列表
  - `news` 新闻列表
  - `case` 案例列表
  - `album` 相册列表
  - `job` 招聘列表
  - `video` 视频列表
  - `download` 下载列表
  - `page` 概况列表
- $pid 分类ID，`0` 表示所有列表 `可选`
- $num 调取数量，如果 `$isPage` 为 `1`，表示分页数量 `可选`
- $isPage `1` 分页，`0` 不分页 `可选`
- $attribute 属性 `可选`
  - `recom` 推荐
  - `top` 置顶
  - `headline` 头条
- $order 按照指定字段排序，默认是 `orders` 字段 `可选`
- $sort `ASC` 降序排列，`DESC` 升序排列 `可选`

示例：
```php
// 获取所有产品列表，按10条分页
{{ inject('list')->lists('product', 0, 10) }}

// 获取前10条产品信息
{{ inject('list')->lists('product', 0, 10, 0) }}

// 获取所有推荐的前三条产品
{{ inject('list')->lists('product', 0, 3, 0, 'recom-1') }}

// 获取分类ID为1，以及其所有子分类下的产品，按10条分页，并按照创建时间降序排列
{{ inject('list')->lists('product', 1, 10, 1, '', 'created_at', 'ASC') }}
```
返回值：
```php
return [
    'total': '',                         // 总条数
    'per_page': '',                      // 每页显示多少
    'current_page': '',                  // 总共多少页
    'last_page': '',                     // 最后一页是第几页
    'next_page_url': '',                 // 下一页地址
    'prev_page_url': '',                 // 上一页地址
    'data': [
        'id': '',                        // ID
        'slug': '',                      // 别名
        'pid': '',                       // 所属分类ID
        'manufacturer_id': '',           // 品牌ID
        'recom': '',                     // 1为推荐
        'headline': '',                  // 1为置顶
        'top': '',                       // 1为头条
        'hits': '',                      // 浏览量
        'orders': '',                    // 排序
        'linkurl': '',                   // 外部链接
        'flag': '',                      // 状态，1为发布
        'created_at': '',                // 创建时间
        'updated_at': '',                // 更新时间
        'cates': [
            'id': '',                    // 所属分类ID
            'slug': '',                  // 所属分类别名
            'cname': '',                 // 所属分类名称
            'parent_id': '',             // 所属分类父ID
            'linkurl': '',               // 所属分类外部链接
            'flag': '',                  // 所属分类状态，1为发布
            'orders': '',                // 所属分类排序
            'created_at': '',            // 所属分类创建时间
            'slug': ''                   // 所属分类更新时间
        ],
        'description': [
            'id': '',                    // 描述ID
            'lang': '',                  // 语言版本
            'imgs': '',                  // 多图
            'title': '',                 // 名称
            'summary': '',               // 描述
            'content': '',               // 详细内容
            'seo_title': '',             // SEO标题
            'seo_keywords': '',          // SEO关键词
            'seo_description': ''        // SEO描述
        ]
    ]
]
```

## 图文管理
标签：
```php
// 获取对应图文管理信息
inject('photoGroup')->list($id);
```
- $id 图文分类id `必填`

示例：
```php
@foreach (inject('photoGroup')->list(1) as $value)
    {{ $value->description->title }}
    {!! $value->description->content !!}
    <img src="{{ $value->description->present()->images(0) }}">
@endforeach
```

示例：
```php
// 对应id图文信息
{{ inject('photoGroup')->list(1) }}

// 返回值
return [
    'pid': '',                  // 分类ID
    'url'： '',                 // 链接
    'flag': '',                 // 状态，1 发布，0 不发布
    'orders': '',               // 按升序排列
    'description': [
        'title': '',            // 主标题
        'f_title': '',          // 副标题
        'text1': '',            // 文字1
        'text2': '',            // 文字2
        'text3': '',            // 文字3
        'summary': '',          // 摘要
        'imgs': '',             // 多图
        'content': ''           // 内容
    ],
    'created_at': '',           // 创建时间
    'updated_at': ''            // 更新时间
];
```

## 产品列表属性
示例：
```php
@foreach ($products as $value)
    @foreach ($value->attrs as $val)
      <p>{{ $val->attr->title }}: {{ $val->text }}</p>
    @endforeach
@endforeach
```