README

安装

$ composer require jncinet/qihucms-site-ad

使用

数据迁移

$ php artisan migrate

发布资源

$ php artisan vendor:publish --provider="Qihucms\SiteAd\SiteAdServiceProvider"

后台菜单

• 广告套餐：site-ad/packages
• 广告订单：site-ad/ads
• 广告订单记录：site-ad/logs

创建广告方法

在需要添加广告的模型中添加一对一多态关联来获取广告

...
use Qihucms\SiteAd\Models\Adable;
...
class SiteAd extends Model {
    use Adable;
    ...
}

接口

广告套餐列表

• 请求方法 GET
• 请求地址 site-ad/packages
• 返回值

[
    {
        'id': 1,
        'name': "套餐名称",
        'desc': "套餐介绍",
        'count': 1, // 时长｜次数
        'unit': "单位",
        'amount': 1.00, // 价格
        'currency_type': {货币详细信息},
    },
    ...
]

广告套餐详细

• 请求方法 GET
• 请求地址 site-ad/packages/{id=套餐ID}
• 返回值

{
    'id': 1,
    'name': "套餐名称",
    'desc': "套餐介绍",
    'count': 1, // 时长｜次数
    'unit': "单位",
    'amount': 1.00, // 价格
    'currency_type': {货币详细信息},
}

广告订单日志列表

• 请求方法 GET
• 请求地址 site-ad/logs?id=2广告订单ID&limit=15每页条数，选填&page=1页码，选填
• 返回值

{
    "data": [
        {
            'id': 1,
            'site_ad_id': 2, // 广告订单ID
            'user_id': {会员信息},
            'ip': "ip",
            'province': "省",
            'city': "市",
            'district': "区",
            'device': "设备"
            'browse': "浏览器",
            'system': "系统",
            'net_type': "网络",
            'created_at': "2秒前"
        },
        ...
    ],
    "meta": {},
    "links": {},
}

广告订单日志详细

• 请求方法 GET
• 请求地址 site-ad/logs?id=2广告订单ID&limit=15每页条数，选填&page=1页码，选填
• 返回值

{
    'id': 1,
    'site_ad_id': 2, // 广告订单ID
    'user_id': {会员信息},
    'ip': "ip",
    'province': "省",
    'city': "市",
    'district': "区",
    'device': "设备"
    'browse': "浏览器",
    'system': "系统",
    'net_type': "网络",
    'created_at': "2秒前"
}

广告订单日志创建

• 请求方法 POST
• 请求地址 site-ad/logs
• 请求参数：

{
    'site_ad_id': 1, // 广告订单ID
    'province', // 省
    'city', // 市
    'district', // 区
    'device', // 设备
    'browse', // 浏览器
    'system', // 系统
    'net_type' // 网络
}

• 返回值

{
    'id': 1,
    'site_ad_id': 2, // 广告订单ID
    'user_id': {会员信息},
    'ip': "ip",
    'province': "省",
    'city': "市",
    'district': "区",
    'device': "设备"
    'browse': "浏览器",
    'system': "系统",
    'net_type': "网络",
    'created_at': "2秒前"
}

数据库

广告套餐表：site_ad_packages

广告订单表：site_ads

广告订单日志表：site_ad_logs