PHPackages                             5balloons/laravel-smart-ads - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. 5balloons/laravel-smart-ads

ActiveLibrary[Utility & Helpers](/categories/utility)

5balloons/laravel-smart-ads
===========================

Ad, Banners, Callouts Manager for Laravel

v1.2.9(2y ago)3178.8k↓13.2%37[4 issues](https://github.com/5balloons/laravel-smart-ads/issues)MITBladePHP ^8.1|^8.2

Since Jan 10Pushed 2y ago6 watchersCompare

[ Source](https://github.com/5balloons/laravel-smart-ads)[ Packagist](https://packagist.org/packages/5balloons/laravel-smart-ads)[ Docs](https://github.com/5balloons/laravel-smart-ads)[ RSS](/packages/5balloons-laravel-smart-ads/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (13)Used By (0)

Ad Manager for Laravel
======================

[](#ad-manager-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/2bc4ce58a7862bb3ca0924b482b0548374dd62de074fee478c011afd67493fe5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f3562616c6c6f6f6e732f6c61726176656c2d736d6172742d6164732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/5balloons/laravel-smart-ads)[![Total Downloads](https://camo.githubusercontent.com/bee462ed61b5b0b19068ff2263f9df63fb00510fcf0c34e4f815352e09588189/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f3562616c6c6f6f6e732f6c61726176656c2d736d6172742d6164732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/5balloons/laravel-smart-ads)[![GitHub Actions](https://github.com/5balloons/laravel-smart-ads/actions/workflows/main.yml/badge.svg)](https://github.com/5balloons/laravel-smart-ads/actions/workflows/main.yml/badge.svg)

[![alt text](/art/Laravel%20Smart%20Ads.png?raw=true "Larvel Smart Ads Dashboard")](/art/Laravel%20Smart%20Ads.png?raw=true)

Simple Ad, Banner, Callouts Manager for Laravel.

Video Demo
----------

[](#video-demo)

[](https://www.youtube.com/watch?v=Hy_qZTljupQ)[https://www.youtube.com/watch?v=Hy\_qZTljupQ](https://www.youtube.com/watch?v=Hy_qZTljupQ)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require 5balloons/laravel-smart-ads
```

The package will automatically register itself.

Publishing Migrations (Required)

```
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-migrations"
```

and then run migrate command to run the migrations

```
php artisan migrate
```

Publishing Assets (Required)

```
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-assets"
```

This command will copy the necessary css and js files required to run the ad manager dashboard.

Publishing Config File (Optional)

```
php artisan vendor:publish --provider="_5balloons\LaravelSmartAds\LaravelSmartAdsServiceProvider" --tag="smart-ads-config"
```

Usage
-----

[](#usage)

The ad manager dashboard can now be accessed at `/smart-ad-manager`

[![alt text](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/smart-ads-dashboard.png)](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/smart-ads-dashboard.png)

### Creating Ads

[](#creating-ads)

You can create a new ad by navigating to `smart-ad-manager/ads/create` page and then providing a valid name and HTML body of the Ad.

[![alt text](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/smart-ads-create-new.png)](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/smart-ads-create-new.png)

### Placing Ads

[](#placing-ads)

In order to place the ads and track clicks you must place the following JS in your header (typically this would go in your blade layout file)

```

```

There are two ways in which you can place ads / banners in your application

#### (Manual Placement)

[](#manual-placement)

To manually place an ad you can copy the blade component code from the view ad page and place it at desired location in your blade file. For example an ad with the slug of your-example-ad can be placed with the following code.

```

```

#### (Auto Placement)

[](#auto-placement)

You can choose to auto place at the ads at the desired locations on the website by providing the CSS selector where you are looking to place the ad and choosing the position (Before selector, After selector, inside selector etc. to place the ad)

[![alt text](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/ad-auto-placement.png)](https://raw.githubusercontent.com/5balloons/laravel-smart-ads/main/art/ad-auto-placement.png)

### Tracking Clicks

[](#tracking-clicks)

Tracking clicks is enabled by default and in order for it to work you must include a global meta csrf token in your blade template file, inside the head element of your HTML.

```

```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

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

Credits
-------

[](#credits)

- [Tushar Gugnani](https://github.com/tushargugnani)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity44

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 93.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Recently: every ~63 days

Total

12

Last Release

952d ago

PHP version history (3 changes)v1.0.0PHP ^7.4|^8.0

v1.1.1PHP ^8.0|^8.1|^8.2

v1.2.9PHP ^8.1|^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/beec29b4bc95b2150d260efe5763f21fa95d394005ca1b1e46491fc2d30b32bb?d=identicon)[5balloons](/maintainers/5balloons)

---

Top Contributors

[![tushargugnani](https://avatars.githubusercontent.com/u/5244323?v=4)](https://github.com/tushargugnani "tushargugnani (71 commits)")[![aphoe](https://avatars.githubusercontent.com/u/2249943?v=4)](https://github.com/aphoe "aphoe (3 commits)")[![5balloons](https://avatars.githubusercontent.com/u/33449629?v=4)](https://github.com/5balloons "5balloons (1 commits)")[![strorch](https://avatars.githubusercontent.com/u/23340907?v=4)](https://github.com/strorch "strorch (1 commits)")

---

Tags

ad-managerlaravellaravel-package5balloonslaravel-smart-ads

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/5balloons-laravel-smart-ads/health.svg)

```
[![Health](https://phpackages.com/badges/5balloons-laravel-smart-ads/health.svg)](https://phpackages.com/packages/5balloons-laravel-smart-ads)
```

###  Alternatives

[leandrocfe/filament-apex-charts

Apex Charts integration for Filament PHP.

4861.2M8](/packages/leandrocfe-filament-apex-charts)[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[ralphjsmit/livewire-urls

Get the previous and current url in Livewire.

82270.3k4](/packages/ralphjsmit-livewire-urls)[kirschbaum-development/commentions

A package to allow you to create comments, tag users and more

12369.2k](/packages/kirschbaum-development-commentions)[codebar-ag/laravel-filament-json-field

A Laravel Filament JSON Field integration with CodeMirror support

1124.1k](/packages/codebar-ag-laravel-filament-json-field)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)