PHPackages uspdev/laravel-usp-theme - 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 & Helpers](/categories/utility) 4. / 5. uspdev/laravel-usp-theme ActiveLibrary[Utility & Helpers](/categories/utility) uspdev/laravel-usp-theme ======================== usp theme for laravel 2.8.27(1mo ago)116.0k—0%20[6 issues](https://github.com/uspdev/laravel-usp-theme/issues)GPL-2.0-or-laterBlade Since May 17Pushed 1mo ago4 watchersCompare [ Source](https://github.com/uspdev/laravel-usp-theme)[ Packagist](https://packagist.org/packages/uspdev/laravel-usp-theme)[ RSS](/packages/uspdev-laravel-usp-theme/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (89)Used By (0) Tema do Laravel para projetos USPdev ==================================== [](#tema-do-laravel-para-projetos-uspdev) Desenvolver um sistema web é uma atividade que envolve diversas camadas de complexidade e é natural termos mais habilidade ou gosto por apenas uma ou algumas dessas camadas. Esse pacote laravel é um template com alguns estilos da USP e é direcionado para aqueles(as) que preferem se debruçar no desenvolvimento do backend com laravel sem se preocupar muito com frontend. Evita também que fiquemos copiando código do template de um projeto para o outro. Foi inspirado no [adminLte para laravel](https://github.com/jeroennoten/Laravel-AdminLTE)e está aberto a contribuições e melhorias dos devs da USP. Inicialmente desenvolvido por [@marcelomodesto](https://github.com/marcelomodesto) do IME-USP. [![theme image](docs/tela-principal.png)](docs/tela-principal.png) Funcionalidades --------------- [](#funcionalidades) Estão disponíveis no template: - Uma barra com o logo da USP que não aparece no tamanho **sm** (mobile); - Uma faixa com as informações de usuário/login/logout alinhado à direita; - Uma barra de menus e sub-menus totalmente configurável; - Possibilidade de oferecer [**link**](docs/outros-sistemas.md) para outras aplicações da Unidade; - Personalização do tema por meio de [**skins**](docs/skins.md); - Mensagens flash pré definidas (à partir da v2.6.0); - Blocos (à partir da versão 2.7.0) O tema possui as seguintes bibliotecas incorporadas: - bootstrap (v4.6.0) - jquery (v3.6.0) - jqueryUI (v1.12.1) - datepicker, etc. - fontawesome (v5.15.3) - datatables (v1.10.23) - [responsive plugin](https://datatables.net/extensions/responsive/) (v2.2.7) - [HTML5 export buttons](https://datatables.net/extensions/buttons/examples/html5/simple.html) (v1.6.5) - [Fixed header plugin](https://datatables.net/extensions/fixedheader/) (v3.3.2) - jquery [select2](https://github.com/select2/select2) (v4.0.13) - jquery mask (v1.14.16) As bibliotecas js são carregadas a partir de CDN. Requisitos ---------- [](#requisitos) Este tema foi testado no Laravel 8.x e 11.x mas deve funcionar em outras versões. Documentação ------------ [](#documentação) - [Instalação e configuração básica](docs/configuracao.md) - [Configuração do menu](docs/opcoes-menu.md) - [Menu ativo](docs/menu-ativo.md) - [Link para outros sistemas](docs/outros-sistemas.md) - [Seções](docs/secoes.md) - [Menu dinâmico](docs/menu-dinamico.md) - [Skins](docs/skins.md) - [Blocos](docs/blocos.md) - [Issues](docs/issues.md) Integração com cadastros-auxiliares ----------------------------------- [](#integração-com-cadastros-auxiliares) O tema pode exibir mensagens vindas do sistema [uspdev/cadastros-auxiliares](https://github.com/uspdev/cadastros-auxiliares)no topo das páginas. Esta integração nativa do tema cobre somente mensagens. Os endpoints de programas (`/api/pos/programas`) são consumidos via biblioteca `uspdev/cadastros-auxiliares-client`. No fluxo atual do tema: - o navegador faz polling no endpoint local do tema: `/_usp-theme/cadastros-auxiliares/mensagens`; - o backend do tema consulta este webservice no endpoint derivado de `CADASTROS_AUXILIARES_URL` (`/api/mensagens`); - `CADASTROS_AUXILIARES_PASSWORD` é enviada apenas no backend (não fica exposta no browser). Configure no `.env` da aplicação que usa este tema: ``` CADASTROS_AUXILIARES_URL=https://seu-app CADASTROS_AUXILIARES_MENSAGENS_INTEGRACAO=false CADASTROS_AUXILIARES_PASSWORD= CADASTROS_AUXILIARES_SISTEMA_NAME= CADASTROS_AUXILIARES_MENSAGENS_LIMITE=5 CADASTROS_AUXILIARES_MENSAGENS_TIMEOUT=5 CADASTROS_AUXILIARES_MENSAGENS_REFRESH=30 ``` Significado: - `CADASTROS_AUXILIARES_MENSAGENS_INTEGRACAO`: habilita/desabilita a integração. - quando a variável não existir, estiver vazia ou for `false`, a integração fica desabilitada. - `CADASTROS_AUXILIARES_URL`: URL base do serviço cadastros-auxiliares (ex.: `https://seu-app`). - `CADASTROS_AUXILIARES_PASSWORD`: senha obrigatória para proteger o endpoint de mensagens em chamadas externas. - em integrações com `laravel-usp-theme`, a senha é usada no backend do tema (proxy local), sem exposição no navegador. - `CADASTROS_AUXILIARES_SISTEMA_NAME`: nome do sistema consumidor para aplicar o filtro por sistema (ex.: `cadastros-auxiliares`, `ponto`). - `CADASTROS_AUXILIARES_MENSAGENS_LIMITE`: quantidade máxima de mensagens consumidas. - `CADASTROS_AUXILIARES_MENSAGENS_TIMEOUT`: tempo em segundos para cada mensagem desaparecer automaticamente. - `CADASTROS_AUXILIARES_MENSAGENS_REFRESH`: intervalo (em segundos) para atualizar somente a área de mensagens sem recarregar a página. Comportamento: - O filtro por sistema só funciona quando `CADASTROS_AUXILIARES_SISTEMA_NAME` estiver configurada com o nome do sistema USPdev (ex.: `CADASTROS_AUXILIARES_SISTEMA_NAME=ponto` para o sistema `uspdev/ponto`). - Se `CADASTROS_AUXILIARES_MENSAGENS_TIMEOUT` estiver vazio ou `0`, as mensagens ficam visíveis até o usuário clicar em fechar. - A área de mensagens é atualizada periodicamente sem `F5`, conforme `CADASTROS_AUXILIARES_MENSAGENS_REFRESH`. - Cada mensagem exibida possui botão de fechar (`×`). - O polling no frontend é feito contra endpoint local do tema, evitando envio de credenciais para o cliente. - Em caso de falha no endpoint, o comportamento é silencioso (não quebra a página). - Mesmo com `config/laravel-usp-theme.php` antigo publicado na aplicação consumidora, os defaults novos desta integração são mesclados pelo pacote. Changelog --------- [](#changelog) 02/03/2026 - release 2.8.24 - integração opcional com `uspdev/cadastros-auxiliares` para exibição de mensagens no topo das páginas. - suporte às variáveis `CADASTROS_AUXILIARES_MENSAGENS_*`. - mensagens com botão de fechar (`×`) e auto-ocultação baseada em `CADASTROS_AUXILIARES_MENSAGENS_TIMEOUT`. - comportamento silencioso em falha de consulta ao endpoint. 03/07/2025 - release 2.8.15 - adicionado variável $dtSlot ao datatable-simples - $dtSlot recebe uma view blade renderizada - exibe conteúdo da view na parte superior da tabela, a frente da contagem de registros 25/4/2023 - release 2.8 - removido responsive padrão do datatables (issue #114) - modificado datatable-simples para ativar plugins por meio de classes - removido datatable-simples-paginado, incorporado no datatable-simples 31/03/2023 - release 2.7 - incluído a opção de blocos que adicionam funcionalidades ao projeto. Ajuste o `layouts.app` da sua aplicação. 30/11/2022 - release 2.6.1 - alterado o config para expor `container` e `key => laravel-tools`. Ajuste o `config` da sua aplicação. 28/10/2022 - release 2.6.0 - [\#92](https://github.com/uspdev/laravel-usp-theme/issues/92) - Incluídas mensagens flash pré definidas (desativadas por padrão no `config`) - [Treinamento Laravel](https://uspdev.github.io/laravel#31-mensagens-flash) 3/12/2021 - refatorado a documentação - refatorado `src/UspTheme.php` - construção do menu 15/06/2021 - Incluído menu dinâmico 04/03/2021 - Incluido js e css para Datatables HTML5 export buttons 26/10/2020 - Incluido submenu divider, submenu header e alinhamento direito do submenu (#47) 28/08/2020 - Layout responsivo com suporte mobile: ajustes no menu - Organizando js e css - Exemplo das bibliotecas js carregadas 31/08/2020 - Acrescentado menu para outras aplicações 15/11/2020 - versão 2 - nova funcionalidade: skins - pasta views reorganizada - dashboard\_url renomeado para app\_url ### Health Score 56 — FairBetter than 98% of packages Maintenance79 Regular maintenance activity Popularity34 Limited adoption so far Community25 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~29 days Total 86 Last Release 45d ago Major Versions 1.0.21 → 2.0.02020-11-16 ### Community Maintainers ![](https://www.gravatar.com/avatar/8a59480189a3ba1aa8355cb434880695569433f5d1c9e375e8238d5ff1a56beb?d=identicon)[uspdev](/maintainers/uspdev) --- Top Contributors [![masakik](https://avatars.githubusercontent.com/u/986915?v=4)](https://github.com/masakik "masakik (128 commits)")[![thiagogomesverissimo](https://avatars.githubusercontent.com/u/908508?v=4)](https://github.com/thiagogomesverissimo "thiagogomesverissimo (65 commits)")[![alecostaweb](https://avatars.githubusercontent.com/u/10613364?v=4)](https://github.com/alecostaweb "alecostaweb (31 commits)")[![Marcelo-k-USP](https://avatars.githubusercontent.com/u/178427075?v=4)](https://github.com/Marcelo-k-USP "Marcelo-k-USP (8 commits)")[![fgmusp](https://avatars.githubusercontent.com/u/55391794?v=4)](https://github.com/fgmusp "fgmusp (5 commits)")[![JhonathaNunes](https://avatars.githubusercontent.com/u/33481861?v=4)](https://github.com/JhonathaNunes "JhonathaNunes (5 commits)")[![st-ricardof](https://avatars.githubusercontent.com/u/69400501?v=4)](https://github.com/st-ricardof "st-ricardof (3 commits)")[![sybgroff](https://avatars.githubusercontent.com/u/14276537?v=4)](https://github.com/sybgroff "sybgroff (3 commits)")[![drafaeltr](https://avatars.githubusercontent.com/u/94188540?v=4)](https://github.com/drafaeltr "drafaeltr (3 commits)")[![leandroramos](https://avatars.githubusercontent.com/u/3253741?v=4)](https://github.com/leandroramos "leandroramos (3 commits)")[![antonioacampos](https://avatars.githubusercontent.com/u/129632162?v=4)](https://github.com/antonioacampos "antonioacampos (2 commits)")[![ezanon](https://avatars.githubusercontent.com/u/18400416?v=4)](https://github.com/ezanon "ezanon (2 commits)")[![lfloro](https://avatars.githubusercontent.com/u/42417410?v=4)](https://github.com/lfloro "lfloro (2 commits)")[![marcelosf](https://avatars.githubusercontent.com/u/8659907?v=4)](https://github.com/marcelosf "marcelosf (2 commits)")[![fabiosantanarp](https://avatars.githubusercontent.com/u/82349567?v=4)](https://github.com/fabiosantanarp "fabiosantanarp (1 commits)")[![dpicon83](https://avatars.githubusercontent.com/u/42186450?v=4)](https://github.com/dpicon83 "dpicon83 (1 commits)")[![girol](https://avatars.githubusercontent.com/u/1793685?v=4)](https://github.com/girol "girol (1 commits)")[![fabio-usp](https://avatars.githubusercontent.com/u/55460390?v=4)](https://github.com/fabio-usp "fabio-usp (1 commits)")[![tadeumesquita](https://avatars.githubusercontent.com/u/475006?v=4)](https://github.com/tadeumesquita "tadeumesquita (1 commits)")[![marcelomodesto](https://avatars.githubusercontent.com/u/25309746?v=4)](https://github.com/marcelomodesto "marcelomodesto (1 commits)") --- Tags hacktoberfest ### Embed Badge ![Health badge](/badges/uspdev-laravel-usp-theme/health.svg) ``` [![Health](https://phpackages.com/badges/uspdev-laravel-usp-theme/health.svg)](https://phpackages.com/packages/uspdev-laravel-usp-theme) ``` ### Alternatives [sensorsdata/sa-sdk-php PHP SDK for Sensors Analytics 32343.4k2](/packages/sensorsdata-sa-sdk-php)[phamda/phamda Auto-curried function library 1922.8k](/packages/phamda-phamda) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)