ludwigheymbeeck/laravel-advert

Advertising helper for laravel - based on adumskis/laravel-advert

Laravel Advert

Simple package that helps add advert to Laravel 5 websites. What is more it allows to see every advert clicks and views count for some statistics., _(*1)

CHANGES

changed in order to facilitate multi-to-multi ads for eyesmart by PlanetVA, _(*2)

Installation

First require package with composer:, _(*3)

$ composer require ludwigheymbeeck/laravel-advert dev-master

Then add service provider to config/app.php:, _(*4)

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

Facede to aliases:, _(*5)

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

And last is to publish config, migrations and view:, _(*6)

$ php artisan vendor:publish
$ php artisan migrate

AdvertCategory model

Simple Eloquent model with variables: - type - (string) used for getting advert in specific category - width - (int) size in pixel to resize advert - height - (int) same as width, _(*7)

If width or height is set to 0 then advert image will be resized with [aspectRatio][1] method., _(*8)

Advert model

Eloquent model, variables: - alt - (string) alt parrameter tag - url - (string) url address where advert should redirect on click - image_url - (string) url addres of advert image - image_path - (string) path to image (from base path) - views - (int) count of views - clicks - (int) count of clicks - active - (bool) advert state - advert_category_id - (int) advert category model id - viewed_at - (timestamp) datetime of last advert view, _(*9)

Advert model has make method that helps to create new record in database also handles image resize and storing stuff. Method requires array with advert variables values and UploadedFile object. Simple example:, _(*10)

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

It will return Advert object, _(*11)

Usage in view

    {{ AdvMng::getHTML('type')

It will take the that with lowest viewed_at parameter. getHTML method allow add second (bool) parameter and if it's true then it will not check if advert was already taken., _(*12)

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

ToDo

• Add limit to advert views/clicks