Skip to content

Latest commit

 

History

History
115 lines (82 loc) · 3 KB

configuracao.md

File metadata and controls

115 lines (82 loc) · 3 KB
Raw

Tema do Laravel para projetos USPdev

Início > Instalação e configuração

Ao criar uma nova aplicação, considere o uso do Starter. Nesse projeto, as principais bibliotecas USPDeve já estão instaladas e configuradas.

Caso prefira o caminho mais longo, siga os passos abaixo. Esse caminho proporcionará um melhor entendimento desse tema e das demais bibliotecas USPDev que você for utilizar.

  1. Se você vai iniciar uma nova aplicação, instale o laravel primeiro.
composer create-project --prefer-dist laravel/laravel minha_aplicacao
  1. Se você já tem uma aplicação laravel ou com a nova aplicação que você criou instale o tema usando o composer.
composer require uspdev/laravel-usp-theme
  1. Publique o arquivo de configuração.
php artisan vendor:publish --provider="Uspdev\UspTheme\ServiceProvider" --tag=config
  1. Configure o composer.json para publicar os assets automaticamente. Para isso acrescente a linha abaixo na seção scripts->post-autoload-dump.
"scripts": {
    "post-autoload-dump": [
        ...
        "@php artisan vendor:publish --provider=\"Uspdev\\UspTheme\\ServiceProvider\" --tag=assets --force"
        ...
    ],
}
  1. Execute o comando abaixo para publicar os assets.
composer dump -o
  1. Edite o arquivo .gitignore e acrescente a linha abaixo.
public/vendor
  1. Configure o .env.example e o .env. Note que todas as configurações são opcionais.
# LARAVEL-USP-THEME
# https://github.com/uspdev/laravel-usp-theme

# O laravel-usp-theme permite que seja criado links
# para outras aplicações da unidade
#USP_THEME_SISTEMAS_1='{"text":"Pessoas","url":"http://localhost/pessoas"}'
#USP_THEME_SISTEMAS_2='{"text":"LDAP","url":"http://localhost/ldap"}'

# Escolha o skin a ser utilizado (default=uspdev)
#USP_THEME_SKIN=
  1. Edite ou crie o seu arquivo resources/views/layouts/app.blade.php para estender o laravel-usp-theme. Veja um exemplo.
@extends('laravel-usp-theme::master')

{{-- Blocos do laravel-usp-theme --}}
{{-- Ative ou desative cada bloco --}}

{{-- Target:card-header; class:card-header-sticky --}}
@include('laravel-usp-theme::blocos.sticky')

{{-- Target: button, a; class: btn-spinner, spinner --}}
@include('laravel-usp-theme::blocos.spinner')

{{-- Target: table; class: datatable-simples --}}
@include('laravel-usp-theme::blocos.datatable-simples')

{{-- Fim de blocos do laravel-usp-theme --}}

@section('title')
  @parent 
@endsection

@section('styles')
  @parent
  <style>
    /*seus estilos*/
  </style>
@endsection

@section('javascripts_bottom')
  @parent
  <script>
    // Seu código .js
  </script>
@endsection
  1. Em suas views, estenda o seu layout base.
@extends('layouts.app')

@section('content')
  Seu html que será inserido no meio do layout
@endsection
  1. Configure o menu da aplicação. Ele está em config/laravel-usp-theme.php. Veja a documentação aqui.