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.
- Se você vai iniciar uma nova aplicação, instale o laravel primeiro.
composer create-project --prefer-dist laravel/laravel minha_aplicacao
- 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
- Publique o arquivo de configuração.
php artisan vendor:publish --provider="Uspdev\UspTheme\ServiceProvider" --tag=config
- Configure o
composer.json
para publicar os assets automaticamente. Para isso acrescente a linha abaixo na seçãoscripts
->post-autoload-dump
.
"scripts": {
"post-autoload-dump": [
...
"@php artisan vendor:publish --provider=\"Uspdev\\UspTheme\\ServiceProvider\" --tag=assets --force"
...
],
}
- Execute o comando abaixo para publicar os assets.
composer dump -o
- Edite o arquivo
.gitignore
e acrescente a linha abaixo.
public/vendor
- 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=
- 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
- Em suas views, estenda o seu layout base.
@extends('layouts.app')
@section('content')
Seu html que será inserido no meio do layout
@endsection
- Configure o menu da aplicação. Ele está em
config/laravel-usp-theme.php
. Veja a documentação aqui.