PHPackages                             michelmelo/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 &amp; Helpers](/categories/utility)
4. /
5. michelmelo/laravel-smart-ads

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

michelmelo/laravel-smart-ads
============================

Ad, Banners, Callouts Manager for Laravel

1.0.0(1y ago)01MITBladePHP ^8.1|^8.2|^8.3

Since Jan 10Pushed 1y ago1 watchersCompare

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

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

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

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

[![Latest Version on Packagist](https://camo.githubusercontent.com/15f76bd03970720b826c4f775b88238df0072b9e2273240531e549c30fe9ac1c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696368656c6d656c6f2f6c61726176656c2d736d6172742d6164732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/michelmelo/laravel-smart-ads)[![Total Downloads](https://camo.githubusercontent.com/92f4998f9fe545fb936a42b0b351eb9f5649312c14f6fb99d1f62ed2a3871b5e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696368656c6d656c6f2f6c61726176656c2d736d6172742d6164732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/michelmelo/laravel-smart-ads)[![GitHub Actions](https://github.com/michelmelo/laravel-smart-ads/actions/workflows/main.yml/badge.svg)](https://github.com/michelmelo/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.

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

[](#installation)

You can install the package via composer:

```
composer require michelmelo/laravel-smart-ads
```

The package will automatically register itself.

Publishing Migrations (Required)

```
php artisan vendor:publish --provider="MichelMelo\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="MichelMelo\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="MichelMelo\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/michelmelo/laravel-smart-ads/main/art/smart-ads-dashboard.png)](https://raw.githubusercontent.com/michelmelo/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/michelmelo/laravel-smart-ads/main/art/smart-ads-create-new.png)](https://raw.githubusercontent.com/michelmelo/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/michelmelo/laravel-smart-ads/main/art/ad-auto-placement.png)](https://raw.githubusercontent.com/michelmelo/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

28

—

LowBetter than 54% of packages

Maintenance41

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

487d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0d756073dec37ac9abd3c7edd0cf00b94f2d2de0055531eba5472392b1fd4da2?d=identicon)[michelmelo](/maintainers/michelmelo)

---

Top Contributors

[![michelmelo](https://avatars.githubusercontent.com/u/159223?v=4)](https://github.com/michelmelo "michelmelo (1 commits)")

---

Tags

laravel-smart-adsmichelmelo

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/michelmelo-laravel-smart-ads/health.svg)](https://phpackages.com/packages/michelmelo-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)[5balloons/laravel-smart-ads

Ad, Banners, Callouts Manager for Laravel

3178.8k](/packages/5balloons-laravel-smart-ads)[codebar-ag/laravel-filament-json-field

A Laravel Filament JSON Field integration with CodeMirror support

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

PHPackages © 2026

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