Fluxo de aprovação

Quando a edição é uma atividade de equipe, a publicação deve incluir um segundo par de olhos. O fluxo de aprovação do Chinaski (desligado por padrão, ativado em Settings → Workflow) faz os editores submeterem trabalho para revisão em vez de publicar diretamente; um admin aprova, o que publica ao vivo, ou devolve com uma nota. Esta página explica o ciclo de revisão para páginas e posts.

Ativando

Em Settings → Workflow:

Marque Require approval before editors can publish.
Opcionalmente defina um review notification email: o endereço que recebe uma nota cada vez que algo é submetido (com o nome de quem submeteu, o título e um link direto de edição).

Admins são isentos por definição: eles sempre publicam como eles mesmos.

A vida de uma página ou post em revisão

O editor escreve. Cada item começa como rascunho com o editor e a pré-visualização de sempre.
Submit for review. Quando um editor clica em Publish (com aprovação exigida), ou pressiona o botão Submit for Review, o item vai para Pending review. Ele ainda não está no ar no site, e a mensagem flash diz exatamente o que aconteceu: “Your changes have been submitted for admin review before publishing.” Qualquer item rejeitado anteriormente pode ser resubmetido após edições.
O admin decide. Na tela de edição o admin vê os botões Approve e Reject (exibidos apenas onde se aplicam):
- Approve publica o item de verdade: o badge de revisão fica verde (Approved), o conteúdo vai ao ar e o site é reconstruído automaticamente. Para posts, uma data de primeira publicação é carimbada no momento da aprovação. Um agendamento futuro desatualizado anexado ao item é limpo para que não fique pairando depois.
- Reject devolve o item ao autor como Returned, com uma razão opcional. Ele permanece não publicado e aparece na tela de edição do autor como rejeitado, pronto para ser revisado e resubmetido.
Todos são avisados. O criador recebe um e-mail de qualquer forma (“approved” ou “returned for revision” com a razão), desde que a conta dele tenha um endereço de e-mail (tratado pela configuração SMTP da notificação). Cada submit/approve/reject é registrado no audit log com quem, o quê e qual item.

O que os editores vivenciam

Não há nada para instalar: o botão Publish em si se torna “submit for review”; o editor vê a confirmação de submissão imediatamente.
O “publish now” editorial a partir do calendário ou uma publicação em lote se comporta da mesma maneira (submissão para revisão); os editores nunca contornam o portão.
Operações em lote respeitam a regra também: selecionar várias páginas e clicar em publicar submete cada página pendente/rejeitada para revisão (e admins ainda simplesmente publicam).
A caixa Status do editor mostra o chip do fluxo de trabalho ao lado do badge live/draft: Draft · Pending review · Approved · Returned; assim, de relance, você sabe onde um item está.
A proteção de “already pending review”: um item não pode ser submetido duas vezes; admins aprovam uma vez e o badge se estabiliza. Resubmissão de um item rejeitado é, claro, permitida após edições.

O que os revisores recebem

O link de edição direto no e-mail de submissão: clique para abrir o item.
Os controles de Preview usuais (histórico, rascunhos) se aplicam antes de aprovar.
Approve = entrar no ar: o botão publica e despacha a reconstrução do site em uma ação, então “approved” significa que os leitores podem ver.
Reject recebe o título mais uma razão opcional (que é enviada por e-mail e registrada) e devolve o item.

Quem revisa quem

Admins revisam tudo: há uma única camada de decisão (sem papéis de revisor intermediários).
Itens em revisão não ficam na fila de outra pessoa: qualquer admin vê o item pendente nas listas normais de páginas/posts e no calendário de conteúdo, então “quem está esperando?” é respondido pelas telas padrão de conteúdo, não por um painel separado.
Agendamentos: um editor submetendo um item que tinha uma data de publicação futura mantém esse plano intacto, mas se um Approve chega depois que o horário de publicação agendado foi limpo durante a revisão, a aprovação publica imediatamente (o código limpa qualquer agendamento desatualizado para que a aprovação não anexe um horário futuro surpresa).

As letras miúdas

O interruptor se aplica a páginas e posts; blocos, snippets e outros estruturais têm as próprias regras de publicação (são menos visíveis na face do site). Versões de documentos têm um pipeline de revisão separado e independente no módulo Documents.
O fluxo de trabalho protege contra publicação acidental ou não autorizada, não censura: admins mantêm capacidade total de publicação direta, e cada decisão é registrada no audit log de qualquer forma.
E-mails de notificação de revisor são opcionais; o fluxo de trabalho funciona sem eles (o admin vê itens pendentes nas listas; “submitted for review” aparece no audit log).
Se você aprova uma página que foi submetida enquanto uma data de publicação futura ainda estava definida, a publicação acontece na aprovação: a data futura é limpa em vez de ficar para trás.

A versão curta

Vire o interruptor, e “publish” para editores se torna “submit for review”, admins aprovam (publicar + reconstruir em um passo) ou rejeitam com uma nota, o audit log registra ambas as direções, e ninguém precisa confiar apenas nas boas intenções.