5balloons / laravel-smart-ads
Laravel 广告、横幅、呼出管理器
Requires
- php: ^8.1|^8.2
- livewire/livewire: ^3.0
- spatie/laravel-package-tools: ^1.0.0
Requires (Dev)
- orchestra/testbench: ^7.6
- phpunit/phpunit: ^9.0
README
简单易用的 Laravel 广告、横幅、呼出管理器。
视频演示
https://www.youtube.com/watch?v=Hy_qZTljupQ
安装
您可以通过 composer 安装此软件包
composer require 5balloons/laravel-smart-ads
软件包将自动注册自己。
发布迁移(必需)
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-migrations"
然后运行迁移命令以执行迁移
php artisan migrate
发布资源(必需)
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-assets"
此命令将复制运行广告管理仪表板所需的必要 CSS 和 JS 文件。
发布配置文件(可选)
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-config"
使用方法
广告管理仪表板现在可以通过 /smart-ad-manager
访问
创建广告
您可以通过导航到 smart-ad-manager/ads/create
页面并提供一个有效的广告名称和 HTML 正文来创建一个新的广告。
放置广告
为了放置广告并跟踪点击,您必须在您的页眉中放置以下 JS(通常这会放在您的 blade 布局文件中)
<script src="{{ asset('vendor/smart-ads/js/smart-banner.min.js') }}"></script>
您可以在应用程序中以两种方式放置广告/横幅
(手动放置)
要手动放置广告,您可以复制视图广告页面中的 blade 组件代码并将其放置在 blade 文件中的所需位置。例如,具有 slug your-example-ad 的广告可以按照以下代码放置。
<x-smart-ad-component slug="your-example-ad"/>
(自动放置)
您可以选择在网站上的指定位置自动放置广告,通过提供要放置广告的 CSS 选择器和选择位置(在选择器之前、在选择器之后、在内部选择器等)来放置广告。
跟踪点击
跟踪点击默认启用,为了使其正常工作,您必须在您的 blade 模板文件中包含一个全局元 CSRF 令牌,在 HTML 的 head 元素内。
<meta name="csrf-token" content="{{ csrf_token() }}">
测试
composer test
变更日志
有关最近更改的更多信息,请参阅 CHANGELOG
贡献
有关详细信息,请参阅 CONTRIBUTING
安全
如果您发现任何与安全相关的问题,请通过电子邮件 tushar@5balloons.info 联系,而不是使用问题跟踪器。
致谢
许可
MIT 许可证(MIT)。有关更多信息,请参阅 许可文件