PHPackages                             agp/base-utils - 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. agp/base-utils

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

agp/base-utils
==============

Package com classes base para utilizar em todos os projetos.

1.1.3(3y ago)06711MITPHPPHP &gt;=7.3

Since Sep 25Pushed 3y ago1 watchersCompare

[ Source](https://github.com/agp-tec/package-base-utils)[ Packagist](https://packagist.org/packages/agp/base-utils)[ RSS](/packages/agp-base-utils/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (5)Versions (51)Used By (1)

[![](https://camo.githubusercontent.com/6e08546390c1e468fbee0f5c7ad8bcb0259b69b6180a1d18c3db23d587443cb9/68747470733a2f2f6465706c6f792e6167617065736f6c75636f65732e636f6d2e62722f6d656469612f6c6f676f732f4147502f6c6f676f2d626c75652e737667)](https://camo.githubusercontent.com/6e08546390c1e468fbee0f5c7ad8bcb0259b69b6180a1d18c3db23d587443cb9/68747470733a2f2f6465706c6f792e6167617065736f6c75636f65732e636f6d2e62722f6d656469612f6c6f676f732f4147502f6c6f676f2d626c75652e737667)

Base Utils
==========

[](#base-utils)

### Introdução

[](#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
----------

[](#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:

```
$ composer require agp/base-utils
```

```
$ php artisan config:cache
```

---

Manifest
--------

[](#manifest)

### Introdução

[](#introdução-1)

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

[](#instalação-1)

Primeiro você precisa verificar a existência, caso contrário criar:

- Necessário esses três parâmetros abaixo no config.php

    ```
    'api_client_token' => env('API_CLIENT_TOKEN', null),
    'id_app' => env('ID_APP', '1'),
    'api_agpadmin' => env('API_AGPADMIN'),
    'device_cookie' => env('LOGIN_DEVICE_COOKIE', 'device'),
    ```
- Necessário também esse parâmetro abaixo no login.php

    ```
    'device_cookie' => env('LOGIN_DEVICE_COOKIE', 'device'),
    ```

Após todas as variáveis verificadas ou inseridas você pode começar a instalar o pacote em seu projeto:

```
$ php artisan install:service-js
```

Ao completar a instalação você precisa fazer com que o seu projeto utilize-o.

Para isso bastar adicionar no topo do seu `` 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

[](#customização)

```
    "start_url": "/", // Uma string que representa o URL de início do aplicativo da web.
    "description": "Um projeto AGP", // Uma string na qual os desenvolvedores podem explicar o que o aplicativo faz.
    "background_color": "#FFFFFF", // Define uma cor de fundo de espaço reservado para a página do aplicativo a ser exibida antes que seu stylesheet seja carregado.
    "theme_color": "#FFFFFF", // Uma string que define a cor padrão do tema para o aplicativo.
    "display": "standalone", // Uma string que determina o modo de exibição preferido dos desenvolvedores para o site.
```

[ Ver mais opções ](https://developer.mozilla.org/en-US/docs/Web/Manifest#members)

### Adicional

[](#adicional)

Recomendamos também que você inclua as tags HTML listadas abaixo em seu `app.blade.php`

```
