agenciafmd/admix-banners

There is no license information available for the latest version (1.0.0) of this package.

Banners - AgĂȘncia F&MD

1.0.0 2019-09-10 11:59 UTC

This package is auto-updated.

Last update: 2024-03-28 02:49:32 UTC


README

Área Administrativa

Downloads Licença

  • Banners responsivos descomplicados

Instalação

composer require agenciafmd/admix-banners:dev-master

Execute a migração

php artisan migrate

O jeito mais prático para customizar os banners, é publicar:

config/upload-configs.php
database/faker/banners/*

Para isso, usaremos.

php artisan vendor:publish --tag=admix-banners:minimal

Para uma customização mais forte, execute:

php artisan vendor:publish --tag=admix-banners:seeders

Não esqueça

  • de trocar os banners em database/faker/banners para que o projeto fique belo
  • de adicionar o BannersTableSeeder::class em database/seeders/DatabaseSeeder.php
  • de executar o composer dumpautoload

Uso

Chame o componente <x-banner />

A configuração padrão é

<x-banner quantity=4
          location='home'
          :random=false
          template='agenciafmd/banners::components.home'
/>

Se for preciso alguma customização da listagem dos banners, crie o blade do component no namespace do frontend

Configurações

Caso seja necessário alguma modificação, publique o arquivo de config com o comando:

php artisan vendor:publish --tag=admix-banners:configs

Para mais de um local, adicione mais um item no locations em admix-banners.php e configure os tamanhos em upload-configs.php

Ex.

<?php

return [
    'name' => 'Banners',
    'icon' => 'icon fe-monitor',
    'sort' => 20,
    'default_sort' => [
        '-is_active',
        '-star',
        '-published_at',
        'name',
    ],
    'locations' => [
        'home' => [
            'name' => 'Home',
            'html' => true,
            'meta' => [
                [
                    'label' => 'tipo',
                    'name' => 'type',
                    'options' => [
                        'Plantas Baixas',
                        'Implantações',
                    ],
                ],
                [
                    'label' => 'título',
                    'name' => 'title',
                ],
                [
                    'label' => 'subtítulo',
                    'name' => 'subtitle',
                ],
            ],
        ],
        ...
    ],
];

Para mais um formato, adicione mais um item no banner

<?php

return [
    'banner' => [
        'home' => [
            'desktop' => [
                'label' => 'desktop',
                'sources' => [
                    [
                        'conversion' => 'desktop',
                        'media' => '(min-width: 1600px)',
                        'width' => 1920 * 2,
                        'height' => 850 * 2,
                    ],
                ],
            ],
            'notebook' => [
                'label' => 'notebook',
                'sources' => [
                    [
                        'conversion' => 'notebook',
                        'media' => '(min-width: 1024px)',
                        'width' => 1366 * 2,
                        'height' => 605 * 2,
                    ],
                ],
            ],
            'mobile' => [
                'label' => 'mobile',
                'sources' => [
                    [
                        'conversion' => 'mobile',
                        'media' => '(max-width: 1023px)',
                        'width' => 375 * 2,
                        'height' => 600 * 2,
                    ],
                ],
            ],
        ],
        ...
    ],
];