` — "Publicado" ou "Rascunho". |
| Data de publicação | `data_publicacao` | `
` — já vem em `DD/MM/YYYY às HH24:MI`. |
| Ações | `data: null` | Botão Facebook, botão galeria, botão editar/excluir. |
Código real das ações:
```javascript
render: function (data) {
return `
`
+ createSingleButton(data.id, `https://www.facebook.com/sharer/sharer.php?u=${window.location.origin}/sessoes/${data.slug}`, true, 'fa fa-facebook text-primary', 'Compartilhar no facebook', '_blank')
+ createGaleryButton(`editar/sessoes/${data.id}#galeria`, data.galeria, data.edit)
+ createBTN(data.id, `editar/sessoes/${data.id}`, data.edit, data.delete)
+ `
`;
}
```
| Botão | Destino | Condição |
|---|---|---|
| Compartilhar no Facebook | `https://www.facebook.com/sharer/sharer.php?u={origin}/sessoes/{slug}` (nova aba) | sempre |
| Galeria | `editar/sessoes/{id}#galeria` (abre a aba de galeria) | desabilitado se `data.galeria` for falso; oculto se `data.edit` for falso |
| Editar / Excluir | `editar/sessoes/{id}` | conforme `data.edit` / `data.delete` |
A listagem também expõe **exportação Excel e PDF** (botões padrão de
`runDatatables`), com as colunas visíveis exceto a de ações.
### 3.3 Formulário (create e edit)
`v6/resources/views/prefecture/contents/sessoes/form.blade.php`:
| Campo | Componente | Observações |
|---|---|---|
| `category_slug` | hidden | Fixo `sessoes`. |
| `category_contents_id` | hidden | Id da categoria raiz. |
| `title` | `components.inputs.input` | Obrigatório, `maxlen` 150. |
| `publication_date` | `components.inputs.date` | Máscara `br-data-tempo`, formato `d/m/Y H:i`, valor inicial = agora. |
| `text` | `components.inputs.textarea` | Editor Summernote, obrigatório. |
| `link` | `components.inputs.input` | Rótulo "Video (Youtube)"; aceita URL completa ou apenas o ID (`Exemplo: https://www.youtube.com/watch?v=YbJOTdZBX1g ou YbJOTdZBX1g`); `maxlen` 2999. |
| Imagem principal | `components.inputs.image` | Alimenta `archive_highlight`. |
| `galery` | `components.inputs.checkbox` | "Ativar Galeria". |
| `status` | `components.inputs.checkbox` | "Publicar" — desmarcado = rascunho. |
Comportamento do vídeo no CMS: o campo `link` é gravado na tabela `links` pelo
`store`/`update`, sempre passes por `normalizeVideoLink()`
(`v6/app/Helpers/functions.php:683`) e `sanitizeLink()`
(`v6/app/Http/Controllers/Prefecture/ContentController.php:595`).
### 3.4 Aba de galeria
Quando `contents.galery == 1`, o `form.blade.php` acrescenta a aba "Galeria" e
inclui `prefecture.contents.components.galerias.index`. Na edição,
`v6/resources/views/prefecture/contents/sessoes/edit.blade.php` inicializa a
galeria por JavaScript:
```javascript
chargeGallery({{ $content->id }}, 'contents_id');
setupGallery({{ $content->id }}, 'content');
```
e abre a aba correspondente quando a URL traz a hash:
```javascript
var locHash = location.hash;
if (locHash != '') {
var locHash = '#myTab a[href="' + locHash + '"]';
$(locHash).tab('show');
}
```
É esse pequeno script que faz o botão de galeria da listagem (âncora
`#galeria`) cair na aba correta.
## 4. JavaScript e assets
| Arquivo | Papel |
|---|---|
| `v6/public/assets/js/custom/contents/sessoes/datatables.js` | Colunas e ações da listagem do CMS. |
| `v6/public/assets/js/custom/utilities/table.js` | `runDatatables`, `createBTN`, `createSingleButton`, `createGaleryButton`, `createDeleteAllButton`; monta o AJAX em `/cms/datatable/{url}` (linha 183). |
| `v6/public/assets/js/custom/utilities/deleteAll.js` | Envio do formulário de exclusão em lote. |
| `v6/public/assets/js/custom/utilities/helpers/add_archive.js` | Upload de arquivos (destaque/galeria). |
| `v6/public/assets/js/custom/utilities/helpers/preview.js` | Pré-visualização do conteúdo. |
| `v6/public/assets/js/custom/utilities/helpers/select-image.js` | Seleção de imagem para o editor. |
| `v6/public/assets/js/custom/utilities/helpers/editor-de-imagem.js` | Editor de imagem. |
| `v6/public/assets/js/modulos/cropper-min.js` | Recorte de imagem. |
| `v6/public/assets/js/custom/utilities/richtext/summernote.js` | Inicialização do Summernote. |
**Arquivo referenciado e ausente:**
`v6/resources/views/prefecture/contents/sessoes/form.blade.php` carrega
`assets/js/custom/contents/sessoes/edit.js`, mas o diretório
`v6/public/assets/js/custom/contents/sessoes/` contém **apenas**
`datatables.js`. O `404` no console não quebra a tela, mas a lógica de
pré-visualização específica de sessões não é carregada.
## 5. Diferenças entre layouts do portal
| Aspecto | modelo1 | modelo2 | modelo3 | modelo4 | modelo5 | modelo6 |
|---|---|---|---|---|---|---|
| Link do card | `conteudo.portal.show` | `conteudo.portal.show` | `sessoes.show` | `sessoes.show` | `sessoes.show` | `sessoes.show` |
| Breadcrumb | `Breadcrumbs::render` | `Breadcrumbs::render` | `Breadcrumbs::view` | `Breadcrumbs::view` | `Breadcrumbs::view` | `Breadcrumbs::view` |
| Condição de exibição | — | — | `getStatusDisplayNews()['displayNews'] == 0` | idem | — | — |
| Miniatura | `archives->where('highlight',1)` com fallback fixo | idem | `getArchiveContentHighlightOrThumbnail(1,1)` | idem | idem | idem |
| Paginação | `$sessions->links()` | idem | `links('vendor.pagination.modelo3')` | `$sessions->links()` | `$sessions->links()` | — |
Duas consequências relevantes:
1. **Duas URLs públicas** para a mesma sessão, dependendo do tema.
2. **O `modelo3` e o `modelo4` escondem a lista de sessões** quando a
configuração `noticias` (`getStatusDisplayNews()`) estiver desligada — um
Acoplamento indevido entre o módulo de Sessões e o de Notícias.
## 6. Acessibilidade e pontos de atenção de UX
| Ponto | Situação |
|---|---|
| Idioma | Todo o texto do módulo (títulos, botões, mensagens) está em português; não há i18n no Blade das sessões. |
| Data | Formatada em pt-BR no portal (`d.m.Y` na listagem, `d/m/Y às H:i` no detalhe) e em `DD/MM/YYYY às HH24:MI` na view do CMS. |
| Responsividade | Cards em colunas `col-lg-6`/`col-md-3` (modelo1, 2, 5) e `col-md-3` (modelo3); o `modelo4` usa `col-10 col-md-6`. |
| Galeria | Depende de `lightGallery` (scripts incluídos no partial), com lightbox e legenda desabilitada (`getCaptionFromTitleOrAlt: false`). |
| Vídeo | iframe responsivo 16:9; URLs de Instagram/YouTube Shorts podem não se comportar bem no ratio fixo. |
| Sem imagem | Fallback `storage/img/exemplos/sem-imagem.png` nos cards do portal e `storage/img/exemplos/sem-imagem-min.png` na imagem de destaque do CMS. |