README

这是一个简单的软件包，可以帮助向Laravel 5网站添加广告。此外，它还允许查看每个广告的点击和查看次数以进行统计。

安装

首先使用composer要求软件包

$ composer require adumskis/laravel-advert dev-master

然后向config/app.php中添加服务提供者

Laravel 5.5使用软件包自动发现，因此不需要手动添加ServiceProvider

'providers' => [
    ...
    Adumskis\LaravelAdvert\AdvertServiceProvider::class,
],

外观到别名

'aliases' => [
    ...
    'AdvMng'    => Adumskis\LaravelAdvert\AdvertFacade::class,
],

发布配置

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=config

发布广告视图

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=views

最后，如果您想编辑迁移，请发布迁移并迁移

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=migrations
$ php artisan migrate

AdvertCategory模型

简单的Eloquent模型，包含变量

• type - (字符串) 用于获取特定类别的广告
• width - (整数) 以像素为单位的尺寸，用于调整广告大小
• height - (整数) 与width相同

如果width或height设置为0，则广告图片将使用[aspectRatio][1]方法调整大小。

Advert模型

Eloquent模型，变量

• alt - (字符串) alt参数标签
• url - (字符串) 广告点击时应重定向的网址
• image_url - (字符串) 广告图片的网址
• image_path - (字符串) 图像路径（从基本路径）
• views - (整数) 查看次数
• clicks - (整数) 点击次数
• active - (布尔值) 广告状态
• advert_category_id - (整数) 广告类别模型ID
• viewed_at - (时间戳) 最后一次查看广告的日期和时间

Advert模型有一个make方法，它可以帮助在数据库中创建新记录，同时处理图像调整大小和存储。此方法需要包含广告变量值的数组和UploadedFile对象。简单示例

Advert::make(
    $request->only(['alt', 'url', 'active']), 
    $request->file('image')
);

它将返回Advert对象

在视图中的使用

    {{ AdvMng::getHTML('type') }}

它将获取带有最低viewed_at参数的那个。getHTML方法允许添加第二个（布尔值）参数，如果它是true，则不会检查广告是否已经被获取。

    {{ AdvMng::getHTML('type', true) }}

广告图片存储

    'default_file_system' => 'public',

要使用laravels的内置多个文件系统的功能，将其更改为其他面向公众的服务提供者，如s3。

待办事项/想法

• 对广告的查看次数/点击次数添加限制
• 广告活动
• 广告的每次点击费用和每次查看费用？
• 视频广告。
• 一天中的广告时间
• 每个活动多个广告
• 每个广告多个图片/视频。
• 遵循Ad galley指南，为页面的不同区域创建不同尺寸的广告。