5balloons/laravel-smart-ads

Laravel 广告、横幅、呼出管理器

v1.2.9 2023-10-10 05:02 UTC

This package is auto-updated.

Last update: 2024-09-30 01:38:06 UTC


README

Latest Version on Packagist Total Downloads GitHub Actions

alt text

简单易用的 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 访问

alt text

创建广告

您可以通过导航到 smart-ad-manager/ads/create 页面并提供一个有效的广告名称和 HTML 正文来创建一个新的广告。

alt text

放置广告

为了放置广告并跟踪点击,您必须在您的页眉中放置以下 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 选择器和选择位置(在选择器之前、在选择器之后、在内部选择器等)来放置广告。

alt text

跟踪点击

跟踪点击默认启用,为了使其正常工作,您必须在您的 blade 模板文件中包含一个全局元 CSRF 令牌,在 HTML 的 head 元素内。

<meta name="csrf-token" content="{{ csrf_token() }}">

测试

composer test

变更日志

有关最近更改的更多信息,请参阅 CHANGELOG

贡献

有关详细信息,请参阅 CONTRIBUTING

安全

如果您发现任何与安全相关的问题,请通过电子邮件 tushar@5balloons.info 联系,而不是使用问题跟踪器。

致谢

许可

MIT 许可证(MIT)。有关更多信息,请参阅 许可文件