njxzwh/hjsuperview

A simple CMS content helper.

Maintainers

Details

github.com/matnanako/hjsuperview

Source

Issues

Installs: 112

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 3

Forks: 0

Open Issues: 0

v5.2 2022-05-27 02:57 UTC

Requires

MIT 00f94cf0cf5ee9b099483dc9b7e14a3f65bc6904

njxzwhhjsuperview

This package is auto-updated.

Last update: 2024-04-27 07:40:32 UTC

README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

Install

Via Composer

$ composer require "njxzwh/superview @dev"

Usage

SuperView::setConfig($configs);
SuperView::get('soft')->recent();

使用缓存

缓存默认使用全局配置cache_minutes, 如果需要为单独的请求设置缓存时间, 可以使用cache方法, 参数为分钟.

SuperView::get('soft')->cache(10)->recent();

如果需要修改所有的查询都为设置的缓存时间, 可以使用第二个参数, 缓存时间将一直保留, 直到下一次设置cache.

SuperView::get('soft')->cache(10, true)->recent();
SuperView::get('soft')->recent(); //仍然使用上面的缓存时间

SuperView::get('soft')->cache(20)->recent(); //使用新的缓存时间, 并且只在当前调用中

使用分页

所有支持limit参数的方法都可以使用分页

第一个参数用来生成分页的url, 应该与路由格式保持一致. 第二个参数指定当前分页.

SuperView::get('soft')->page('list-{page}.html', $page)->recent();

使用指定分页和自定义的布局, 第二个参数指定分页, 第三个参数指定是否使用简洁模式(默认false), 第四个参数参考Configs下的pagination.

SuperView::get('soft')->page('list-{page}.html', 2, false,
    [
        'layout' => '<ul>{total}{previous}{links}{next}</ul>',
        'total' => '<li class="pipe">共{total}页</li>',
        'previous' => '<li href="{url}">上一页</li>',
        'links' => '<li href="{url}">{page}</li>',
        'link_active' => '<li class="on">{page}</li>',
        'next' => '<li href="{url}">下一页</li>',
        'dots' => '<li">...</li>',
    ])->recent();

返回数据格式:

[
  "count" => "594",
  "list" => [],
  "page" => ""
]

仅分页数据, 不需要返回page和count, 第一个参数设置为false.

SuperView::get('soft')->page(false, 2)->recent();
SuperView::get('soft')->page(false)->recent(); // 默认为第一页, 作用相当于不使用page方法

Configs

[
    'api_base_url' => 'http://api.base.url',
    'cache_minutes' => 120, // 通用缓存时间, 单位: 分 默认120分钟, 如果设置为0则不使用缓存, 但是所有的分类数据依然使用缓存, 如果需要更新分类缓存可以设置refresh_cache.
    'refresh_cache' => 1, // 刷新所有方法的缓存, 1是, 0否, 默认0
    'class_url' => '/{channel}/{classname}/{classid}{page}.html', //支持参数列表
    'info_url' => '/{channel}/{classname}/{classid}/{id}.html', //支持参数列表
    'pagination' => [
        'layout' => '<div class="pages pt-20">{total}{previous}{links}{next}</div>',
        'total' => '<span class="pipe">共{total}页</span>',
        'previous' => '<a href="{url}">上一页</a>',
        'links' => '<a href="{url}">{page}</a>',
        'link_active' => '<a class="on">{page}</a>',
        'next' => '<a href="{url}">下一页</a>',
        'dots' => '<span class="pipe">...</span>',
    ],
]

Api

category 分类模块

1. info($classid)

获取分类信息

参数:

参数名 描述 必填 默认
classid 分类ID 是 null

2. finalChildren($classid, $limit)

获取子终极分类

参数:

参数名 描述 必填 默认
classid 分类ID 是 null
limit 每页数据量,0为不限制 否 0

3. children($classid, $limit)

获取下一级子分类

参数:

参数名 描述 必填 默认
classid 分类ID 是 null
limit 每页数据量,0为不限制 否 0

4. brothers($classid)

获取同级兄弟分类

参数:

参数名 描述 必填 默认
classid 分类ID 是 null

5. breadcrumbs($classid)

获取分类的面包屑

参数:

参数名 描述 必填 默认
classid 分类ID 是 null

6. search($name, $classid)

根据分类名称搜索分类(模糊查询)

参数:

参数名 描述 必填 默认
name 分类名称 是 null
classid 分类ID, 搜索该分类下的分类 否 0

7. classPath($classpath)

通过classpath获取分类信息

参数:

参数名 描述 必填 默认
classpath classpath 是 null

8.finalFather($classid)

通过classid获取顶级分类

参数:

参数名 描述 必填 默认
classid 分类id 是 0

content 内容模块

使用具体的channel名称, 只有不确定channel才使用content(目前只有superTopic方法支持使用content)

1. order($classid, $limit, $order, $database)

排序列表

参数:

参数名 描述 必填 默认
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime
database 数据库 否 database

2. info($id)

获取内容信息

参数:

参数名 描述 必填 默认
id 信息ID 是 null

3. recent($classid, $limit, $isPic)

获取最新内容列表

参数:

参数名 描述 必填 默认
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
isPic 是否只查询带图片的数据, 1是, 0否 否 0

4. good($level, $classid, $limit, $isPic, $order)

获取推荐列表

参数:

参数名 描述 必填 默认
level 置顶等级, 0 - 9(0为不置顶) 否 0
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
isPic 是否只查询带图片的数据, 1是, 0否 否 0
order 排序字段 否 newstime

5. top($level, $classid, $limit, $isPic, $order)

获取置顶列表

参数:

参数名 描述 必填 默认
level 置顶等级, 0 - 9(0为不置顶) 否 0
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
isPic 是否只查询带图片的数据, 1是, 0否 否 0
order 排序字段 否 newstime

6. firsttitle($level, $classid, $limit, $isPic, $order)

获取头条列表

参数:

参数名 描述 必填 默认
level 置顶等级, 0 - 9(0为不置顶) 否 0
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
isPic 是否只查询带图片的数据, 1是, 0否 否 0
order 排序字段 否 newstime

7. superTopic($topicId, $limit)

获取专题信息列表, 如果无法指定channel, 使用该方法获取该专题下的所有channel的内容，否则直接使用topic方法

参数:

参数名 描述 必填 默认
topicId 专题ID 是 null
limit 每页数据量,0为不限制 否 0

8. count($period, $classid)

获取统计数量

参数:

参数名 描述 必填 默认
period 周期,'day','week','month','all' 否 all
classid 分类ID 否 0

9.company($cid)

通过cid查询厂商信息

参数

参数名 描述 必填 默认
cid 厂商id 是 null

10.strategy( $game_id, $limit, $orders)

通过game_id获取攻略列表

参数：

参数名 描述 必填 默认
game_id id 是 0
limit 每页数据量,0为不限制 否 0
order 排序字段 否 lastdotime

11.companyList($limit, $order)

获取厂商列表

参数

参数名 描述 必填 默认
limit 每页数据量,0为不限制 否 0
order 排序字段 否 dnb_num

12.firsttitleInClass($firsttitle, $classidArr, $limit, $order)

查询多个class下的推荐数据

参数：

参数名 描述 必填 默认
firsttitle 推荐等级 是 null
classidArr 分类ID 是 []
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime

13.otherStrategy($id, $game_id, $limit, $order)

通过id不等级和game_id等于获取攻略

参数：

参数名 描述 必填 默认
id strategy 是 null
game_id game_id 是 []
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime

14.tuijian($softid, $classid, $limit)

小编推荐 参数：

参数名 描述 必填 默认
softid 软件id 是 null
classid 分类id 是 null
limit 每页数据量,0为不限制 否 0

15.customList($fields, $limit, $order)

自定义参数请求（多个参数以逗号分隔，多个值以逗号分隔，参数和值数量必须对应）

参数：

参数名 描述 必填 默认
fileds 参数 ['a'=>1, 'b'=>2] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime

16.allGameByIdAndCid($ids, $cid, $order)

dnb 列表 （id not in&operator_id in）

参数：

参数名 描述 必填 默认
ids id [1,2] 是 null
cid cid 否 0
order 排序字段 否 onclick

17.getPl($softid, $checked, $limit)

获取评论

参数：

参数名 描述 必填 默认
softid 软件id 是 null
checked checked 否 0
limit 每页数据量,0为不限制 否 0

18.companyPath($company_path)

通过path获取厂商信息

参数：

参数名 描述 必填 默认
company_path company_path 是 ''

18.otherSoft($softid)

获取其他版本

参数：

参数名 描述 必填 默认
softid 软件id 是 0

19.getAllPl($id, $order)

获取所有评论

参数：

参数名 描述 必填 默认
id 软件id 是 0
order 排序字段 否 saytime

20.customVary($fields, $vary, $limit, $order)

存在不等于的组合查询

参数:

参数名 描述 必填 默认
fields 请求字段 ['a'=>1, 'b'=>[1,2,3] 是 0
vary 不等于 ['a'=>1] 是 0
limit 每页数据量, 需要大于1,0为不限制 是 0
order 排序字段 是 weekip

21.infoTopics($id, $limit)

获取信息所属专题列表

参数:

参数名 描述 必填 默认
id 软件id 是 0
limit 每页数据量, 需要大于1,0为不限制 是 0

22.infoList($field, $value, $limit, $order)

自定义条件获取小程序信息

参数:

参数名 描述 必填 默认
field 字段名 是 ''
value 值 是 0
limit 每页数据量, 需要大于1,0为不限制 是 null
order 排序 否 sum

23.related(id, $limit, $isPic, $order)

相关资讯（目前仅可用于article模型） -- 某资讯下tag词相关的所有资讯（除当前资讯本身）

参数:

参数名 描述 必填 默认
id 资讯id 是 ''
limit 每页数据量, 需要大于1,0为不限制 是 null
isPic 是否图片 否 null
order 排序 否 newstime

24.tag($tag = '',$classid = 0, $limit = 0, $isPic = 0, $order = 'newstime')

tag相关资讯列表(目前仅可用于article模型) --某tag词下的所有资讯

参数:

参数名 描述 必填 默认
tag tag词 是 ''
classid 每页数据量, 需要大于1,0为不限制 是 null
limit 每页数据量, 需要大于1,0为不限制 是 null
isPic 是否图片 否 null
order 排序 否 newstime

zt 专题模块

0. good($showzt, $classid, $limit, $order)

获取推荐专题 参数:

参数名 描述 必填 默认
showzt 推荐专题 否 0
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
order 排序字段 否 addtime

1. index($topicCategoryId, $classid, $limit, $order)

获取专题列表

参数:

参数名 描述 必填 默认
topicCategoryId 专题分类ID 否 0
classid 分类ID 否 0
limit 每页数据量,0为不限制 否 0
order 排序字段 否 addtime

2. info($id, $path)

获取专题信息

参数:

参数名 描述 必填 默认
id 专题ID 是 null
path 专题路径, 例如: /zt/qq 否 ''

3. categories()

获取所有专题分类列表

4. recentInClass($classid, $limit, $order)

ios/安卓屏道页定制专题

参数:

参数名 描述 必填 默认
classid 分类ID 是 0
limit 每页数据量,0为不限制 否 0
order 排序字段 否 addtime

5.listInIdClassId($id, $classid, $limit)

dnb 详情页专题定制方法 （通过软件id和classid获取列表）

参数:

参数名 描述 必填 默认
classid 分类ID 是 0
limit 每页数据量,0为不限制 否 0
id 软件id 是 0

6.matchZt($fields, $limit, $order, $database)

自定义参数请求（参数和值数量必须对应,关联查询）

参数：

参数名 描述 必填 默认
fields 参数 和值 ['name'=>'tom', 'id'=>1] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime
database 数据库 否 database

7.match($fields, $limit, $order, $database)

自定参数请求（不需要关联查询）

参数：

参数名 描述 必填 默认
fields 参数 和值 ['name'=>'tom', 'id'=>1] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime
database 数据库 否 database

8.softByZtid($fields, $order)

通过ztid获取soft和ztinfo信息(关联查询)

参数：

参数名 描述 必填 默认
fields 参数 是 null
order 排序 否 addtime

9.ztCommon（$ids, $limit, $group）

专题详情页评论 (关联查询)

参数：

参数名 描述 必填 默认
ids 参数 数组 是 null
limit 排序 否 null
group 排序 是 null

10.inZtid($ztid)

获取多个ztid数据

参数：

参数名 描述 必填 默认
ztid ztid 是 []

11.getIdByZid($ztid)

ztinfo表通过ztid获取id

参数：

参数名 描述 必填 默认
ztid ztid 是 0

12.ztBetween($min, $max)

zt表 ztid between 2个值之间的列表

参数：

参数名 描述 必填 默认
min 范围 是 0
max 范围 是 0

13.ztaddJoinzt($fields, $limit, $order, $database)

ztadd & zt表关联信息 (参数前缀 定死为zt , ztadd)

参数：

参数名 描述 必填 默认
fields 参数 ['a'=>1,'b'=>2] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime
database 数据库 否 database

14.ztidNotIn($ztids, $limit, $order)

专题表ztid notin

参数：

参数名 描述 必填 默认
ztids ztid [1,2] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime

15.classMatch($fields, $limit, $order = 'classid', $database = 'database')

自定义获取分类

参数:

参数名 描述 必填 默认
fields 参数['a'=>1, 'b'=>2] 是 0
limit 条数 是 0
order 排序 是 classid
database news 是 database

16.listByZtinfoNews($fields, $limit, $order, $database)

news站专用方法（ztinfo表关联news表查询列表）

参数：

参数名 描述 必填 默认
fields ['a'=>1, 'b'=>2] 是 null
limit 每页数据量,0为不限制 否 0
order 排序字段 否 newstime
database 数据库 否 news

17.ztListType()

获取专题所有新分类

tag 模块

1.tag($softid)

软件详情页获取tag词

参数：

参数名 描述 必填 默认
softid softid 是 null

2.tagInfo

通过tagid获取tag信息

参数：

参数名 描述 必填 默认
id tagid 是 null

3.tagRelationSoft

tag词id获取tag关联软件

参数：

参数名 描述 必填 默认
id tagid 是 null
platform 平台1.PC软件 2.安卓软件 3.IOS软件 4.其他软件 0全部 是 0
order 排序 是 lastdotime
limit 条数 是 20

4.tagSoftTag

tag对应关联软件根据最近更新取其他tag词

参数：

参数名 描述 必填 默认
id tagid 是 null

5.countTag

tag各平台个数

参数：

参数名 描述 必填 默认
id tagid 是 null

6. recent

最近更新

参数：

参数名 描述 必填 默认
limit 数量 是 20

other 其他模块

1. sortTdk($classid, $order)

tdk

参数:

参数名 描述 必填 默认
classid 分类ID 否 0
order 排序字段 否 id

utils 工具模块

1. relationWord($softid)

获取软件相关词

参数:

参数名 描述 必填 默认
softid 软件id 否 0

2. renderPage($route, $total, $limit, $page, $simple, $options)

获取专题列表

参数:

参数名 描述 必填 默认
route 分页url规则 是 null
total 数据总量 是 null
limit 每页数据量, 需要大于1,0为不限制 是 null
page 初始分页数 否 1
simple 是否使用简洁模式 否 false
options 数组, 参考Configs下的pagination 否 20

4.plateform($softid = 0, $model = 'download')

获取多端信息（注：soft模型使用download）

参数:

参数名 描述 必填 默认
softid 软件id 是 0
model 模型（表名） 是 download

comment 评论模块

1.comment($id, $limit, $order)

获取评论

参数:

参数名 描述 必填 默认
id 软件id 是 0
order 排序 否 saytime
limit 每页数据量, 需要大于1,0为不限制 是 null

inner 内联模块

1.lists($is_ztid, $classid, $limit, $random)

获取内联信息

参数:

参数名 描述 必填 默认
is_ztid 专题id 是 0
classid classid (允许以逗号分隔的多值) 否 0
limit 每页数据量, 需要大于1,0为不限制 是 null
random 是否随机 否 1

2.footer($group)

首页底部推荐

参数:

参数名 描述 必填 默认
group 分组字段 是 data_type

3.ztFriendLink($ztid)

参数:

参数名 描述 必填 默认
ztid ztid 是 0

4.softInner($is_ztid, $order)

获取内联列表

参数:

参数名 描述 必填 默认
is_ztid $is_ztid 是 0
order 排序 否 sum

5. getHotSearchForClass($classid, $ztid, $limit)

正文内联词

参数:

参数名 描述 必填 默认
classid 分类id 是 0
ztid ztid 否 0
limit 每页数据量, 需要大于1,0为不限制 否 sum

6.friendLink($webid)

友链

参数:

参数名 描述 必填 默认
webid webid 是 0

7.match($fields, $vary, $limit, $order, $rand)

自定义内联表查询

参数:

参数名 描述 必填 默认
fields 请求字段 ['a'=>1, 'b'=>[1,2,3] 是 0
vary 不等于 ['a'=>1] 是 0
limit 每页数据量, 需要大于1,0为不限制 是 0
order 排序字段 是 addtime
rand 是否随机 是 0

Change log

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email huangyukun@njxzwh.com instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.