Giter VIP home page Giter VIP logo

laravel-advert's Introduction

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.

Installation

First require package with composer:

$ composer require adumskis/laravel-advert dev-master

Then add service provider to config/app.php:

Laravel 5.5 uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider

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

Facade to aliases:

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

Publish config:

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=config

Publish Advert view:

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=views

Lastly publish the migrations if you want to edit them and migrate

$ php artisan vendor:publish --provider="Adumskis\LaravelAdvert\AdvertServiceProvider" --tag=migrations
$ 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

If width or height is set to 0 then advert image will be resized with [aspectRatio][1] method.

Advert model

Eloquent model, variables:

  • alt - (string) alt parameter 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

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:

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

It will return Advert object

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.

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

Advert image storage

    'default_file_system' => 'public',

To use the inbuilt ability of laravels multiple filesystems change this to another public facing service provider such as s3.

ToDo/Ideas

  • Add limit to advert views/clicks
  • Advert Campaigns
  • Advert Cost per click and cost per view?
  • Video Adverts.
  • Time of day adverts
  • Multiple adverts per campaign
  • Multiple images / videos per advert.
  • Follow Ad galley guide and create different size ads for different regions of the page.

laravel-advert's People

Contributors

adumskis avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

laravel-advert's Issues

S3 Image Upload

Hey Adumskis,

I am going to use this package in my upcoming project, just wondering if S3 uploading would be something you would be in you main package.

Cheers

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.