Manual de Gerenciamento de Conteúdo do Portal Modelo 1) Introdução O presente manual destina se à pessoas que farão o gerenciamento de conteúdo e das funcionalidades do Portal Modelo, abordando todos os tipos de conteúdo e ferramentas para disponibilização de serviços. Surgindo dúvidas, elas podem ser enviadas para o email gitec@listas.interlegis.gov.br; lista de discussão do GITEC. 2) O que é o Portal Modelo O Portal Modelo é um produto desenvolvido pelo Interlegis para que as Casas Legislativas possam ter seus próprios portais com uma Taxonomia padrão, funcionalidades como Fórum, Newsletter, Sistema de Ouvidoria, e gerenciamento de conteúdo dando as total autonomia. O produto está disponível para instalação através de um pacote Debian e pode ser instalado pelo comando apt get install portal modelo. Este comando pode ser executado em distribuições Ubuntu Linux 5.10 e 6.04, Kubuntu. Para informações sobre instalação em outras distribuições, ou demais informações, deve se acessar o site http://colab.interlegis.gov.br/wiki/projetoportalmodelo. 3) Características do Gerenciamento de Conteúdo O Portal Modelo foi desenvolvido com o Plone, que é um Sistema de Gerenciamento de Conteúdo. Através do Plone é possível criar, publicar e ajustar as informações de um site às necessidades requeridas, com muita facilidade. Conteúdo é qualquer material (texto, áudio, vídeo, imagem,...) que são adicionados ao portal. E é exibido entre as colunas da direita e da esquerda e abaixo do cabeçalho. Para adicionar qualquer tipo de conteúdo é necessário estar autenticado no Portal e ter permissão de gerente de conteúdo. Quando o gerente estiver autenticado aparecerá uma borda cinza em torno do conteúdo do site, com abas, que encontram se na parte superior do conteúdo. Essas abas possuem as seguintes funcionalidades: Conteúdo (Content): exibe o conteúdo da pasta e opções na parte inferior para copiar, recortar, renomear, excluir, e alterar o estado do conteúdo. Visão (View): mostra como o conteúdo será visualizado pelo usuário. Edição (Edit): exibe o formulário com os dados do tipo de conteúdo em questão para que o
gerente possa alterá los. Propriedades (Properties): traz informações detalhadas sobre o tipo de conteúdo criado, como palavras chaves relacionadas, contribuidores, autores, datas, idioma, direitos autorais e opção para excluir ou não o tipo da navegação. Compartilhamento (Sharing): relaciona as informações a respeito do responsável pelo documento como as permissões, concessões sobre o mesmo. Para cada formulário de cada aba existe o botão de salvar e cancelar. Além destas também são observadas, no canto superior direito, as seguintes abas de ação: Exibição (Display): contém os modos de exibição do conteúdo das pastas. Padrão (Standard View): ordena os documentos em forma de lista, mostrando o autor, a data de última modificação. Sumária (Summary View): ordena os documentos em ordem decrescente de data de criação exibindo seu título, descrição e link com mais informações sobre o conteúdo. Tabular (Tabular View): mostra os itens em forma de tabela, exibindo seu título, autor, tipo e data de última modificação. Visão de Miniaturas (Photo Album View): os itens são exibidos somente com o título como em um álbum de fotografias, se houver imagens na pasta, estas serão exibidas em miniatura. Selecionar um item como visão padrão (Choose Content): mostra a lista de documentos exibíveis para que seja selecionado qual será a visão padrão da pasta. Adicionar novo item (Add Item): são apresentados todos os tipos de conteúdo que podem ser adicionados naquele nível. Estado (State): estado no qual o tipo de conteúdo se encontra. Os estados e as diferenças entre eles serão discutidos mais adiante. Todos os tipos de conteúdo do Portal podem ser copiados para outros níveis da árvore (outras pastas), excluídos ou ter seus estados alterados. 3.1)Estados de Conteúdo Todos os tipos de conteúdo do portal possuem um estado. Os estados são: Esboço público (visible): Todos os usuários podem achar e visualizar os objetos neste estado através da função de busca e podem acessá los diretamente visitando a url do objeto. Não são mostrados na árvore de navegação. São editáveis por seus donos e administradores do site. Privado (private): estado inicial padrão do Portal Modelo. Este pode ser visualizado e editado somente pelo usuário que o criou e pelos administradores. Não aparecerão nos resultados das buscas ou na árvore de navegação. Pendente (pending): conteúdos neste estado foram submetidos a publicação por membros do site. Comportam se como objetos no estado Esboço Público, porém só podem ser alterados pelo administrador. A diferença entre os dois estados é que os objetos pendentes estão aguardando pela revisão; os revisores do site decidem se publicam ou rejeitam os objetos pendentes. Usuários sem poderes de administrador não podem publicar um conteúdo, apenas mandar para revisão. Publicado (published): são visíveis a todos os visitantes do site. Eles aparecem em
resultados de buscas e na árvore de navegação. Itens publicados são editáveis somente pelos administradores. Um conteúdo no estado Esboço Público possui as seguintes ações na aba Estado as opções Tornar Privado, Publicar e Enviar que permitem alterar o estado do conteúdo para Privado, Publicado e enviar para revisão, respectivamente. No estado Privado as opções são Tornar Visível, Publicar e Enviar, que possibilitam alterar o estado para Esboço público, Publicado e enviar para revisão, respectivamente. No estado Pendente as opções são Publicar e Esconder, que possibilitam alterar o estado para Publicado e Privado, respectivamente No estado Publicado as opções são Rejeitar e Tornar Privado, que alteram o estado para Esboço Público e Privado, respectivamente. Observação: Alguns tipos de conteúdo estados personalizados, mas seguem basicamente a idéia apresentada acima. Apenas administradores e revisores podem publicar conteúdos, usuários sem privilégios devem mandá los para a revisão. 3.2) Compartilhamento Para que um membro do Portal possa ser um revisor ou inserir conteúdo, deve se seguir os seguintes passos, após já ter cadastrado o usuário no portal, através do formulário de registro do mesmo. Acessar o Portal como manager; Entrar na pasta a qual se deseja que o membro seja gerente de conteúdo; Clicar na aba Compartilhamento; Na seção Adicionar permissões de compartilhamento para usuários, buscar pelo membro que terá perfil de Administrador, Revisor ou Dono nesta pasta; Ao aparecer o membro, selecioná lo e escolher o perfil que se quer; Clicar no botão Atribuir papéis locais para os usuários selecionados; O perfil de Revisor dará permissão para que o membro revise o conteúdo daquela pasta, não podendo adicionar conteúdo a ela. O perfil de Administrador dará permissão para que o membro seja administrador nesta pasta e possa publicar, revisar e inserir conteúdo. O perfil de Dono, por sua vez, faz com que o membro tenha permissão de adicionar conteúdo e enviá lo para revisão. 4) Tipos de Conteúdo Serão apresentados os tipos de conteúdo disponíveis no Portal Modelo e como adicioná los.
4.1)Pasta Uma pasta pode armazenar qualquer tipo de conteúdo, tais como Arquivos, Documentos, Links, Notícias ou até mesmo outras pastas. Para adicionar uma Pasta é necessário escolher o tipo de conteúdo Pasta (Folder) na caixa Adicionar novo item. Aparecerá um formulário onde deve ser preenchido seu Título e opcionalmente sua Descrição. Para alterar o Título ou a Descrição da pasta é preciso estar dentro da pasta para clicar na aba Edição. Será apresentado um formulário com estes campos para que sejam alterados. Não esquecer de clicar no botão Salvar para que sejam confirmadas as modificações. Na aba Ações é possível renomear, recortar e excluir a pasta e colar algo na pasta. Observação: Os pontos que possuem um quadrinho vermelho do lado do nome são de preenchimento obrigatório, os demais são de preenchimento facultativo. Tanto para criar quanto para editar é necessário clicar no botão Salvar. 4.2)Arquivo É qualquer arquivo que pode ser carregado do seu computador. Ele pode ser qualquer tipo, como um arquivo de texto puro, um documento do Word/OpenOffice, uma tabela do Excel, uma apresentação do PowerPoint, um Acrobat PDF e assim por diante. Para adicionar é necessário selecionar a opção Arquivo (File) na aba Adicionar novo item. No formulário que aparecer, os campos devem ser preenchidos como mencionado anteriormente e o campo arquivo deve ser selecionado a opção Substituir por um novo arquivo e clicar no botão Procurar e selecionar o arquivo desejado. Para editar é necessário clicar na aba Edição e e alterar os campos desejados. No campo arquivo deve ser selecionada a opção Manter o arquivo existente se for desejado manter o arquivo e alterar somente os demais campos. Para alterar o arquivo a opção deve ser Substituir por um novo arquivo e o novo arquivo deve ser escolhido como anteriormente. 4.3)Imagem Imagens são conteúdos gráficos. Imagens podem ser mostradas diretamente no navegador ou disponibilizadas para download. Para adicionar uma imagem, na página principal clique na aba Conteúdo, clique em Imagens, então selecione na aba Adicionar novo item a opção Imagem (Image), e proceder com o preenchimento do formulário de maneira análoga ao do preenchimento do formulário para adicionar um arquivo. Observações: Os arquivos de imagens geralmente possuem extensão gif, jpg, png, tif ou pict. Note que arquivos.pict da Macintosh as vezes não podem ser visualizados pelo browser da plataforma
Microsoft. 4.4)Link São links para URL's, que podem ser de sites da internet ou páginas do próprio portal. Para adicionar, na página principal clique na aba Conteúdo, clique em Utilidades, então selecione a opção Link na aba Adicionar novo item. No formulário exibido os campos Título e URL são obrigatórios. No Campo URL deve ser informada a URL para a página que o link apontará, se for uma página do próprio portal, a URL pode ser relativo, caso o link aponte para uma página de outro site, a URL deve ser absoluta e conter o protocolo (por exemplo http://www.interlegis.gov.br). 4.5)Notícia São notícias, de qualquer tipo, geralmente relacionadas ao portal ou ao objetivo do portal. Para adicionar, na página principal clique na aba Conteúdo, clique em Notícias, então a opção Notícia (News) deve ser selecionada na aba Adicionar novo item. No formulário exibido os campos Título e Corpo do Texto são obrigatórios. Título deve conter o título da notícia, Descrição é uma breve descrição da notícia e Corpo do Texto é o texto da notícia, também é possível adicionar uma imagem para a notícia. 4.6)Página Uma Página geralmente é uma forma de exibir texto. Podem ser escritos de vários formatos: texto puro, HTML ou Texto Estruturado (An Introduction to Structured Text, Structured Text Help). Para adicionar a opção Página (Page) deve ser selecionada na aba Adicionar novo item. 4.7)Janela Possibilita a exibição de uma página externa ao portal em um iframe dentro do portal. Para adicionar, selecione Janela na aba Adicionar novo item. No formulário exibido os campos mais relevantes são: Use base URL? Deve ser marcado para usar uma URL pré definida como base para a URL da página a ser exibida. Para alterar a URL base vá em <URL_do_portal>/portal_windowZ/edit/. URL é a URL da página a ser exibida, pode ser absoluta ou relativa a partir da URL base. Ex: se Use base URL? estiver marcado, e a URL base seja http://sapldemo.interlegis.gov.br/, para exibir a página http://sapldemo.interlegis.gov.br/consultas/mesa_diretora, o campo URL deve ser preenchido apenas com consultas/mesa_diretora (URL relativa). Agora se Use base URL? NÃO estiver marcado, para exibir a mesma página é necessário colocar a URL completa
(absoluta) no campo URL. Ocultar metadados? Oculta informações da página original como autor, ícone, título. Fonte: Mostra a fonte de onde foi retirado o site. Catalogar a página? Se selecionado cataloga os dados do site, como descrição, título, link. Largura da página: Mostra a página na largura especificada. Altura da página: Mostra a página na altura especificada. Exibição da página: Na aba de exibição é possível escolher como será mostrado o site dentro do Plone, como ocultar a coluna da esquerda, da direita ou ocultar as duas. Quando a URL base for alterada todas as janelas que usarem a URL base também serão alteradas para a nova URL base. 4.8)CalendarX É um conteúdo que disponibiliza um calendário que exibe os eventos do portal. Funciona como o calendário da coluna da direita, porém com maiores funcionalidades, por exemplo, selecionar o tipo do evento (social, convenção...) e o modo de visualização (por dia, semana, mês...). Para adicionar, selecione CalendarX na aba Adicionar novo item. Por padrão, na raiz do portal Agenda é um conteúdo do tipo CalendarX. 4.9)Evento Permite a divulgação de eventos. Pode ser uma reunião, palestra e outros. Para adicionar um evento entre na pasta Eventos na raiz do portal e selecione Evento (Event) na aba Adicionar novo item. No formulário existem vários campos relativos ao próprio evento e à sua organização que devem ser preenchidos. Quando um evento é publicado o dia do evento fica em destaque no Calendário que fica na coluna direita do portal e automaticamente aparece na Agenda (CalendarX). 4.10)Enquete (Poll) Este conteúdo possibilita consultar a opinião dos usuários e visitantes do portal. Quando é publicada uma enquete, esta aparece na Caixa de Enquetes. Para adicionar um evento entre na pasta Enquetes na raiz do portal e selecione Enquete (Poll) na aba Adicionar novo item. No formulário o campo Alternativas deve ser preenchido com as possíveis alternativas, um em cada linha sem vírgulas (ou algo do tipo) separando as, no campo Quantidade de Escolhas deve ser explicitado quantas alternativas podem ser escolhidas ao votar. 4.11)Pasta Esperta Uma pasta esperta é na verdade uma página que faz uma pesquisa e exibe o resultado. Por
exemplo, uma pasta esperta configurada para exibir Notícias já publicadas exibe todas as Notícias publicadas do portal, não importando as pastas na qual se encontrem. Para adicionar uma pasta esperta, selecione Pasta Esperta (Smart Folder) na aba Adicionar novo item. No formulário exibido, deve se dar atenção especial para os campos Exibir como Tabela e Colunas da Tabela. Se o primeiro estiver marcado, o resultado da pesquisa será exibido em uma tabela onde cala linha irá corresponder a um item encontrado e as colunas serão os campos indicados no segundo. Para adicionar um campo na tabela, selecione o campo desejado na coluna da esquerda e clique no botão >>, para remover selecione o campo na coluna da direita e <<. Os campos serão exibidos de acordo com a ordem que são adicionados. Após clicar em Salvar, clique na aba Critério. Neste novo formulário encontram se os critérios de busca. Para o nosso exemplo iremos configurar a pasta esperta para buscar apenas notícias que estão no estado privado: Selecione Tipo do Item em Nome do Campo e clique em Add; Na nova caixa que aparecerá selecione Notícia e clique em Salvar; Selecione Estado em Nome do Campo e clique em Add; Na nova caixa que aparecerá selecione privado e clique em Salvar; Agora na aba visão são exibidas todas as notícias privadas do portal. 4.12)Sistema de Fórum Permite que várias pessoas discutam um ou mais assuntos em seus tópicos. 4.12.1)Message Board É como se fosse uma sala de discussão, onde diversos assuntos podem ser debatidos. Para adicionar selecione a opção Message Board na aba Adicionar novo item. Um Message Board contém apenas Fóruns. Por Padrão no portal já vem criado um Message Board na raiz do portal. 4.12.2)Fórum É um assunto abrangente que contém um ou mais tópicos relacionados. Para adicionar basta clicar em Adicionar Fórum dentro de um Message Board. Um Fórum contém apenas Conversações. 4.12.3)Conversação É um tópico específico do fórum que a contém. Para adicionar basta acessar o fórum e clicar em Adicionar uma Conversação.
4.13) Sistema de Boletim Eletrônico É um sistema que permite o envio de e mails sobre Este tipo de conteúdo permite manter pessoas interessados informados sobre Temas do portal via e mail. Um conteúdo desse tipo pode ser enviado para todos os inscritos via e mail. 4.13.1)Tema Um Tema é um assunto ao qual os Boletins a serem enviados estarão relacionados. Para adicionar, acesse a pasta Newsletters na raíz do portal e selecione a opção Tema na aba Adicionar novo item. No formulário alguns campos a serem preenchidos merecem atenção especial: Endereço de email para verificação: é o endereço de e mail para o qual serão enviados alertas e outros avisos do tema. Endereço de email do autor do boletim: é o endereço que ficará no campo remetente do e mail enviado, é o e mail do responsável pelo boletim. Assunto do email de ativação: quando um usuário e inscreve no Tema, ele recebe um e mail para confirmar a sua intenção e ativar a sua inscrição, este campo é o título desse e mail. Modelo do email de ativação: é o corpo de texto do e mail de ativação. Por padrão, já vem com uma mensagem em inglês. Texto de rodapé do boletim: todos os boletins enviados contém esse texto como rodapé Comando para executar lynx e Opções do Lynx: Apesar de não serem obrigatórios, estes dois campos são fundamentais para o correto funcionamento do Tema. lynx é um navegador modo texto que é capaz de transformar páginas HTML em texto puro, caso o lynx esteja instalado no sistema operacional em uso, deixe esses campos em branco, caso contrário preencha os campos com os dados referentes a outro programa que desempenhe papel equivalente. Em Tema podem ser adicionados Boletins e Inscritos. As informações sobre usuários podem ser vistas na aba Informações e sobre os boletins na aba Conteúdo. 4.13.2)Inscrito São os usuários do portal que desejam receber os boletins. Um usuário do portal pode inscrever se em um Tema pela caixa Boletim Eletrônico ou na aba Inscrever se, mostrada quando um tema é exibido. O administrador do portal também pode adicionar um usuário selecionando a opção Inscritos na aba Adicionar novo item. 4.13.3)Boletim tema. Um boletim é um e mail relacionado ao tema que será enviado para todos os inscritos nesse
Para adicionar um boletim, acesse o tema e selecione a opção Boletim na aba Adicionar novo item. Na aba Test é possível visualizar como os usuários verão o boletim e também é possível enviar o boletim para si como forma de teste. Na aba Sent é possível enviar efetivamente o boletim. O boletim será enviado somente se o envio for confirmado nesta aba. 4.14)Arquivos de Áudio São três tipos de conteúdos que possibilitam a disponibilização de arquivos de áudio (MP3) para o usuário, podem conter desde o Hino do Município até gravações das seções da Câmara. 4.14.1)Audio Files São os arquivos de áudio em si, possibilitam ao usuário ouví lo diretamente pelo browser ou fazer o download do arquivo. Para adicionar selecione a opção Audio File na aba Adicionar novo item. Após preencher os campos clique em Próximo, neste novo formulário, estão os dados das tags ID3 que podem ser alterados. Finalmente clique em Salvar. 4.14.2)CD's São como os CD's (discos) e contém vários Audio Files, servem para organização do portal e possibilitam a reprodução de todas as músicas do CD pelo browser como se o usuário estivesse usando algum MP3Player (por exemplo WinAmp). Para adicionar selecione a opção CD na aba Adicionar novo item. No Formulário existem campos a serem preenchidos com dados a respeito do CD, do autor e também é possível adicionar uma imagem para o CD. Dentro de um CD é possível adicionar somente Audio Files. 4.15)Arquivos de Vídeo Disponibiliza arquivos de vídeo para os usuários assistirem diretamente do browser ou baixarem o arquivo. Pode ser usado, por exemplo, para disponibilizar gravações de sessões da Câmara para os usuários. Para adicionar selecione a opção Vídeo na aba Adicionar novo item. Para o preenchimento do formulário proceda de maneira análoga à adição de um Arquivo. O vídeo deve estar nos formatos.rm,.wmv,.mov ou.mpg.
4.16)Ouvidoria O sistema de Ouvidoria possibilita aos usuários do portal enviar solicitações/reclamações/sugestões para, no caso, a Casa Legislativa. 4.16.1)Ombudsman É um gerenciador de solicitações, serve para organizá las, avisar aos responsáveis sobre novas solicitações e possibilita ao usuário que realizou a acompanhar o seu atendimento ou não. Para adicionar a pasta, selecione a opção Ombudsman na aba Adicionar novo item. No formulário existem os campos: Nome do gerenciador: Neste campo deve ser colocado o nome para o gerenciador de solicitações. Tipos de solicitação: é uma tabela com dois campos: Nome curto e Nome, no primeiro deve ser colocado um nome pequeno, sem espaços e caracteres especiais, no segundo pode ser colocado um nome com letras maiúsculas e espaços. Ex: agradecimento e Agradecimento. Para excluir um tipo, basta clicar no X da linha do tipo. Áreas: São as áreas das solicitações (podem ser as comissões da Câmara, por exemplo). A tabela funciona analogamente ao item anterior e os campos são Nome curto, Área, Responsible e Email, nos dois últimos devem ser colocados o responsável por determinada área e o seu e mail para envio de solicitações. Administradores do gerenciador: é uma lista dos Ids de usuários do portal que poderão administrar o gerenciador, e terão permissão para manipular as solicitações. Deve ser colocado um por linha e sem vírgulas, ou qualquer pontuação para separá los. Por padrão no Portal já vem adicionado uma pasta para Ouvidoria, para acessá lo basta clicar em Ouvidoria, no menu de atalho. É necessário editá lo, para isso clique na aba Editar exibida quando a pasta Ouvidoria for acessada. Será exibido um formulário com os mesmos campos descritos acima. 4.16.2)Solicitação (Claim) Quando um usuário comum acessa a pasta Ouvidoria é permitido a esse usuário adicionar solicitações, basta clicar no botão Adicionar Solicitação e preencher os dados no formulário, entre os quais deverá ser selecionado um tipo e uma área de solicitação das definidas na pasta Ouvidoria. Os administradores da Ouvidoria podem resolver/mover/rejeitar solicitações usando o sistema de workflow (estados das solicitações). A lista de sexo, estado e idade já vem preenchidas por padrão no sistema, porém, se o administrador quiser alterar estes dados, é necessário acessar a ferramenta com as listas. Esta ferramenta encontra se clicando no link Preferências, da caixa Preferências. Acessar o link Ombudsman Tool. Será apresentada uma tela com as listas já populadas. Nota: Deve se seguir a formatação das listas, caso não seja seguido o sistema dará erro de
formatação. 4.17) Prestação de Contas No antigo Portal do Interlegis havia uma área para que a Casa fizesse sua prestação de contas publicamente, bem como a inserção e atualização de seus dados. Hoje, com a migração do esmo, esta área foi substituída pelo uso do Portal Modelo. No Portal Modelo há uma pasta chamada Prestação de Contas, onde serão publicados os Relatórios fiscais da Casa. Para adicionar um Relatório de Gestão Fiscal é preciso estar na pasta Prestação de Contas. Clicar no link Adicionar Relatório de Gestão Fiscal. Preencher o formulário indicando o seguinte: Título: Título do Relatório Nome da Casa: Nome da Casa Legislativa Logomarca: Logo da Casa Título do Demonstrativo: Pode ser deixado o que se sugere ou inserir outro nome Período: Semestre, Trimestre, Quadrimestre,... deste demonstrativo Artigo: Artigo do demonstrativo Demonstrativo: Tabela do demonstrativo bem como seus responsáveis. Aqui pode ser copiado conteúdo de uma planilha ou mesmo de um editor de textos Observações: Eventuais observações Ao salvar o formulário será apresentada a maneira como será visto o demonstrativo. 5)Fontes e links interessantes http://www.tchezope.org http://www.plone.org http://www.zope.org http://python.org