Download the PHP package agp/base-utils without Composer
On this page you can find all versions of the php package agp/base-utils. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download agp/base-utils
More information about agp/base-utils
Files in agp/base-utils
Package base-utils
Short Description Package com classes base para utilizar em todos os projetos.
License MIT
Informations about the package base-utils
Base Utils
Introdução
Pacote para Laravel de funções úteis e classes base.
Contém:
- Classe GEOIP: Retorna a localização através do dado IP.
- Classe Utils: Possui as funções genéricas utilizadas nos projetos.
- Models: Contém as classes BaseEntity, BaseRepository, BaseObserver, BaseService.
- BaseObserver: Contém o registro de logs de adição, alteração e remoção da entidade e gerencia o disparo de webhook.
- Traits: Contém as Trais utilizadas nos projetos.
- Service Worker Padrão.
- Manifest Padrão.
- Serviço de notificação via Push.
Instalação
Verifique as dependencias desse pacote.
Para o bom funcionamento deste projeto é essencial seguir a estrutura de arquivos AGP, projeto modular em laravel.
Execute no projeto que deseja instalar o pacote:
Manifest
Introdução
O manifest.json é um arquivo JSON que informa ao navegador sobre o seu site no dispositivo móvel ou desktop do usuário. Ter um manifest é exigido pelo Chrome para mostrar o prompt Adicionar à tela inicial.
Quando o usuário instala ou adiciona seu aplicativo da web à tela inicial ou adiciona a um inicializador de aplicativos, o manifest.json fornece ao navegador para que possa tratar o nome, ícones, etc. do seu site.
O arquivo manifest.json contém detalhes do nome do aplicativo do seu site, ícones que ele deve usar, o start_url no qual ele deve iniciar quando iniciado e muitos outros detalhes.
Instalação
Primeiro você precisa verificar a existência, caso contrário criar:
-
Necessário esses três parâmetros abaixo no config.php
- Necessário também esse parâmetro abaixo no login.php
Após todas as variáveis verificadas ou inseridas você pode começar a instalar o pacote em seu projeto:
Ao completar a instalação você precisa fazer com que o seu projeto utilize-o.
Para isso bastar adicionar no topo do seu <head>
do app.blade.php
a tag link, como no exemplo a baixo:
Você pode confirmar e pronto, um manifest padrão é copiado para o diretório public
do seu projeto.
Customização
Adicional
Recomendamos também que você inclua as tags HTML listadas abaixo em seu app.blade.php
Service Worker
Introdução
Um service worker é um tipo especial de worker baseado em eventos. Na prática, ele é um arquivo JavaScript que pode controlar as páginas do site ao qual ele está associado, interceptando e modificando requisições e a navegação em si.
O service worker armazena os recursos necessários no cache do navegador e quando o usuário visitar o aplicativo novamente, o service worker verifica o cache e retorna com o resultado antes mesmo de verificar a rede.
Ele gerencia as notificações por push e ajuda a criar o aplicativo web offline usando a API de cache do navegador.
Instalação
Primeiro você precisa verificar a existência, caso contrário criar:
- Necessário esses quatros parâmetros abaixo no config.php
Após todas as variáveis verificadas ou inseridas você pode começar a instalar o pacote em seu projeto:
Esse comando copia os arquivos de
media
ejs
para oresources
do seu projeto.
É necessário também instalar os arquivos de estilos e js.
No seu projeto você precisa adicionar a linha de código em seu webpack.mix.js
que está presente na raiz do projeto.
Depois basta executar
Customização
Em resources/js do seu projeto foi criado um arquivo service-workers.js, nele possui uma variavel chamada assets
(arquivos) e routes
(rotas) iram ficar armazenados no cache do navegador.
Custumizando a view offline
Um arquivo de configuração é criado, basta trocar a view padrão!
Utilização do push
Para utilizar a notificação via push você precisa ter feito o passo anterior(Instalação do ServiceWorker).
Ativação
View de Ativição de mensagens, onde pode ser adicionado como por exemplo no _quick-pane.blade.php
View com os modais de ajuda para o usuario;
Exemplo para notificar
Você consegue notificar os usuarios que possuem uma inscrição, basta criar uma classe de notificação laravel;
Após criar a classe de notificação você precisa adicionar os metodos do push como no exemplo a baixo.
O pacote remove a subinscrição dos dispositivo que não retornar resposta de sucesso.
Observações:
E pronto, agora só depende de você. Crie notificações execelente! 😉
por Richard Pereira Cardoso
Git do projeto
Fórum de discução
Copyright
AGP @ 2020
All versions of base-utils with dependencies
agp/log Version ^1.0
agp/webhook Version ^1.0
agp/login Version ^1.0
tremby/laravel-git-version Version ^1.2
minishlink/web-push Version ^6.0