3. Usando o Plone

O Plone usa os padrões e técnicas dos browsers atuais, assim é recomendado o uso da versão mais recente de um browser. Estas instruções abordam a configuração default para o Plone e podem não estar iguais ao site que você está visualizando, dependendo da forma como foi customizado.

Cadastrar-se a um Site

Cadastrar-se a um site Plone faz com que você tenha privilégios de Membro (Member) para adicionar conteúdo, tais como imagens, documentos e assim por diante. Os seus privilégios dependem de como o site foi configurado.

Para se cadastrar ao site, selecione o link join (cadastre-se) no canto superior direito da página inicial.

Isto apresentará o formulário de cadastro, para você completar. Se este é o primeiro formulário Plone que você vê você deve notar algumas coisas: um quadrado vermelho próximo ao título de um campo de entrada de dados significa que este campo é obrigatório. Quando você clica em um campo, uma janela de ajuda aparecerá no lado esquerdo. Você pode navegar através dos campos do formulário clicando neles.

Há vários campos no formulário de cadastro:

• Full Name: Seu nome.
• Username: O nome de usuário que você vai utilizar, a maioria das pessoas escolhem um valor alfanumérico sem espaços, como "bob" ou "jane97".
• E-mail: Um endereço de e-mail válido é exigido. De maneira que se você perder sua senha ela pode ser enviada para você. Você será capaz de alterar este e-mail mais tarde editando suas preferências.
• Password e Confirm Password: A senha que você quer usar; deve ter mais que 5 caracteres e pode conter letras, números e o caracter underscore(_). Senhas são sensíveis ao contexto.
• Mail Password?: Cheque esta caixa se você quer que sua senha seja enviada para o e-mail que você forneceu.

Depois que você competar este formulário, clique em register para enviar as informações. Então, clique no link log in para acessar o site imediatamente.

Log in

Se você já tem um nome de usuário e senha, você pode logar-se no site digitando-os nos campos da caixa de log in na coluna da esquerda e clicar no link log in. Os cookies devem estar habilitados no momento do log in no site.

Esqueceu a senha?

Se você esqueceu sua senha ela pode ser enviada para o endereço de e-mail que você forneceu ao se cadastrar. Você pode pedir que sua senha seja enviada para vpcê clicando no link Forgot your password? que está na coluna da esquerda do site. Se você não especificou um e-mail válido quando você se cadastrou, você precisará contatar o administrador do seu site.

Deslogar-se

Depois que você estiver logado no site, no canto superior direito aparecerá um link log out. É bom você clicar em log out sempre que você terminar de usar o Plone.

Pasta Member

Cada membro tem uma pasta onde eles podem criar e armazenar conteúdo. Eles estão localizados na pasta Members e contém uma página inicial padrão chamada index_html. Para ver a sua pasta membro, clique no link my folder na barra pessoal no canto superior direito do site.

Configuração das Preferências dos Usuários

No canto superior direito há também o link my preferences que abre o formulário Personalize. Este formulário permite que você configure as preferências que alteram a maneira de como você interage com o site.

• E-Mail - Este é o endereço de e-mail associado com seu estado (membership) e é usado em vários lugares no site. O mais importante é que se você perder ou esquecer sua senha, este é o endereço para onde o sistema vai enviá-la.
• Content editor - Quando editar um conteúdo complexo, você pode receber a ajuda de um editor. Se o administrador do seu site disponibilizar um, você pode selecioná-lo aqui. Ele então será usado quando você clicar na aba de edição de um objeto. Padrão: None
• Listed status - Esta propriedade especifica se seu perfil será mostrado na aba Members e quando alguém buscar pelos membros. Padrão: Listed
• Form Help - Cada campo do formulário tem uma janela associada que oferece ajuda. Isto é muito útil para os novatos no sistema, assim eles podem ser ajudados a como usar os campos do formulário quando eles estão preencendo-os. Usuários que não querem ajuda podem desselecioná-la. Padrão: Yes
• Display Names - Os objetos têm uma propriedade Name que é usada para sua representação interna do conteúdo do objeto. O Name também é mostrado no endereço do objeto (também chamado URL). Por default se parece como: News_Item.2002-11-16.4102 mas você pode deixá-lo mais simpres como november_news alterando o valor Name. Padrão: Yes

  Observe: Quando você alterar o valor nome do objeto, tudo que referenciar o antigo nome não será mais válido e resultará em erros de que a página não pode ser exibida. É melhor não mudar o valor nome depois que você der um submit no objeto ou lincá-lo de outro lugar.

• Look - Algumas pessoas gostam de modificar a aparência do Plone e looks e themes são oferecidas para permitir isto. Selecione a aparência que você preferir para seu site Plone. Padrão: Plone Default
• Portrait - Em grandes empresas e nos sites da comunidade é útil para ver as fotos de outros membros. O campo retrato permite que você coloque uma foto de 75 pixels de largura e 100 pixels de altura. (Se você colocou uma foto que é de tamanho diferente, ela vai ser redimensionada para 75 x 100).

Depois que você modificou a seu gosto as suas preferências, clique em save para salvá-las.

Adicionando e editando conteúdo

Como membro do site, você tem uma pasta na seção members onde você pode armazenar seu conteúdo. Ao invés de detalhar como adicionar e editar os diferentes tipos de conteúdos disponíveis, vamos abordar, em detalhes, como adicionar um tipo de conteúdo, um Document. Todos os tipos de conteúdo são adicionados e editados de uma maneira muito parecida, assim a maioria das vezes os passos aqui serão repetidos.

O que é um Documento?

Um documento é uma página de conteúdo, geralmente é um repositório próprio de texto. Documentos podem ser escritos de vários formatos diferentes, texto puro, HTML ou Texto Estruturado. Um exemplo de documento é a página incial padrão do site Plone.

Adicionando um Documento

Para adicionar um documento, você vai precisar estar no modo Contents View (Visualização do Conteúdo); o link está disponível na parte esquerda da página. Este modo mostra a você a lista de objetos na pasta e deixa você editá-los. Se você não está vendo o link Switch to Contents View, você não tem permissão para adicionar ou editar conteúdo neste local.

Depois que você estiver no Contents View, você notará que tem uma caixa com drop down no canto superior direito do painel central próximp ao botão "add new item". Ele mostra a lista de tipos de conteúdo que você pode adicionar nesta pasta. Selecione Document desta lista, então clique add new item. Depois que um documento foi adicionado você verá imediatamente a página de edição para aquele documento.

Editando um Documento

O documento pode ser editado diretamente no browser, usando o formulário apresentado. Um fator para ser observado são as abas de destaque de edição, no topo da página. As mensagens aparecem no topo da página, como mostrado abaixo.

Há quatro campos para um documento:

• Name: Este identificador fará parte do endereço na web do documento. Deve ser pequeno, descritivo e não conter underscores ou os dois casos. Por exemplo, "audit-report-2003". Se você não colocar um nome, o Plone criará um para você.
• Title: Este item será mostrado no topo da página, nos breadcrumbs, na interface de busca, no título do browser e assim por diante. Este campo é obrigatório.
• Description: Uma pequena descrição sobre o documento, geralmente não mais que 20 palavras para introduzir o documento e oferecer uma descrição para documentar o documento.
• Body Text: Este campo contém o corpo do documento. O formato para o conteúdo é configurado usando os radio buttons abaixo do campo. Eles são:

  Structured Text: é a configuração padrão. Texto estruturado é um formato para produzir texto puro e HTML sem que o usuário tenha que aprender ou digitar HTML. As referências para Texto Estruturado estão disponíveis nestes links:

  An Introduction to Structured Text

  Structured Text Help

  HTML: qualquer HTML pode ser usado.

  Plain text: é um texto comum sem marcação.

Se você possui um arquivo com o documento no seu computador, você pode carregá-lo ao invés de colocar algo no campo body text. Use o botão upload no final da página. O conteúdo de um arquivo carregado substituirá qualquer conteúdo no campo body.

Depois que você terminar de editar o seu documento, clique no botão save. Você voltará a aba view onde você pode ver como o documento será renderizado. Para editá-lo novamente, clique na aba edit.

Se você não digitou dados corretos no formulário de edição, quando você salvar o documento será retornada a página de edição e seus erros estarão destacados. Neste momento suas alterações ainda não foram salvas - você deve corrigir os erros e clicar em save novamente.

Atribuindo propriedades a um documento

Qualquer objeto pode ter propriedades atribuídas a ele. Estas propriedades são também conhecidas como metadata e oferecem informações tais como palavras-chaves (keywords), autoria e informação sobre os contribuidores. O formulário de propriedades tem vários campos que são comuns a todos os tipos de objetos:

• Allow discussion: Esta propriedade dixa este documento ser discutido pelos usuários que tem privilégios para isto. Se deixar como default, será usada a política do site.
• Keywords: Keywords são a maneira de atribuir metadados a um objeto. Use control+click para selecionar várias palavras-chave da lista.
• Effective Date e Expiration Date: A data efetiva é o primeiro dia que o objeto deve estar disponível e a data de expiração é o último dia. Buscas e navegação somente mostram objetos dentro desta escala de datas. Se os items forem deixados em branco faz com que um objeto seja disponibilizado infinitamente.
• Format: É o MIME-type do objeto. Se você não sabe o que é isto, deixe como está.
• Language: A linguagem na qual o item está escrito.
• Copyright: Informação de autoria do objeto.
• Contributors: Os nomes das pessoas que contribuiram para o objeto. Cada nome de cada pessoa deve estar em linhas separadas.

Publicando seu documento

Os Documentos são criados no estado visible, que significa que as pessoas podem acessá-los, mas eles não serão mostrados na árvore de navegação. Documentos visíveis são disponíveis através de buscas e acessando diretamente suas URLs.

Quando você esteiver satisfeito com seu documento você vai precisar publicá-lo. Para fazer isto, selecione a aba state. Esta página dará acesso para o processo de publicação.

• Effective Date: permite você especificar uma data de efetivação para este conteúdo. Até esta data chegar, o conteúdo não será publicado. Até que esta data ocorra, o conteúdo não será publicado. Se esta data não for especificada, então não terá efeito e o documento será publicado...
• Expiration Date: permite você especificar uma data para este conteúdo expirar. Despois desta data o conteúdo não será mais publicado. Se esta data não for especificada, então não terá efeito e o documento será publicado.
• Comments: oferece uma interface para adicionar comentários a este processo de publicação. Estes comentários podem ser lidos pelos revisores do seu conteúdo no processo de publicação. Igualmente se o revisor rejeitar seu conteúdo, eles serão capazes de colocarem comentários aqui assim você saberá porque seu conteúdo foi rejeitado.
• Change state: Estes são os estados nos quais os documentos podem ser salvos. Os conteúdos de publicação e revisão serão abordados com mais detalhes no Capítulo 4 deste livro, mas agora você saberá como publicar seu conteúdo, assim selecione Submit e então clique save.

Seu conteúdo estará agora no estado pending. Um revisor irá revisar seu conteúdo e decidirá se o publicará como está, vai editá-lo e publicá-lo, ou rejeitá-lo.

Adicionando e editando outras formas de conteúdo

Há vários tipos diferentes de objetos que vêm por default em um site Plone. Adicionar e editar estes tipos de objetos são processos similares aos descritos acima para os documentos.

Image

Imagens são pedaços gráficos de conteúdo. Este tipo de conteúdo geralmente termina com uma extensão como: gif, jpg, png, tif ou pict. Imagens podem ser mostradas dentro do CMS do Plone sem ter que fazer download delas para o computador se o tipo da imagem (extensão) é visível no browser do usuário.

Quando você adiciona uma imagem, o id do objeto é mudado para ser o arquivo da imagem. Assim se você carregar uma imagem chamada photo.gif, ela estará acessível no Plone como photo.gif. Quando adicionamos ou carregamos uma nova imagem podemos selecionar a imagem do seu sistema de arquivo usando o botão browse e selecionando o arquivo.

Note que arquivos.pict da Macintosh as vezes não podem ser visualizados pelo browser da plataforma Microsoft.

File

Um arquivo é qualquer arquivo que pode ser carregado do seu sistema de arquivos. Ele pode ser qualquer tipo de item como um arquivo de texto puro, um documento do Word, uma tabela do Excel, uma apresentação do PowerPoint, um Acrobat PDF e assim por diante. Quando você adicionar um arquivo, o id será mudado para ser o nome do arquivo. Assim se você carregar um arquivo chamado book.pdf, ele ficará acessível no Plone como book.pdf.

Link

Os objetos Link são, de um modo geral, para os usuários compartilharem URL's. Estas URL's podem ser fontes da internet ou fontes locais. Os links podem conter metadados como qualquer outro objeto de conteúdo. Por favor observe que se você estiver lincando uma fonte da internet, você deve introduzir seu link com o protocolo adequado (por exemplo http://) de outra forma seu link possivelmente estará incorreto.

Topic

Os tópicos habilitam os usuários a criarem coleções de recursos buscando no repositório de informação central. Uma coleção é definida pela aba critério. O critério especificado vai determinar todos os conteúdos do objeto que são catalogados pelo sistema. Você pode buscar vários aspectos diferentes do sistema: por localização física, hora de criação, estado de revisão, e muitas outras formas. Os tópicos somente linkam a outros recursos; eles não mantêm recursos físicos dentro deles como uma Pasta (Folder).

Por padrão somente usuários com a função Manager têm permissão para criar tópicos.

Folder

Os repositórios são os mais simples e poderosos mecanismos para organizar conteúdo. Uma pasta é um repositório que pode hospedar qualquer tipo de objeto de conteúdo, tais como Files (Arquivos), Documents (Documentos), ou qualquer tipo de objeto de conteúdo. Por padrão todos os tipos de conteúdo podem ser adicionados em um Folder.

News Item

Itens Notícias são geralmente usados em websites. Ao serem publicadas as Notícias são mostradas em ordem cronológica reversa na News tab e na seção de Notícias.

Discussão de conteúdo

Qualquer conteúdo no Plone pode ser discutido. O proprietário do conteúdo (conhecido como a pessoa que criou o conteúdo) coloca o mesmo em discussão clicando na aba Properties do objeto e checando Allow. O radio button default é a plítica para o objeto de conteúdo que foi configurada pelo Administrador do Site.

Se a discussão estiver habilitada, quando o conteúdo for visualizado a discussão será mostrada e os usuários terão permissão para participar.

Buscando conteúdo

Há duas formas de buscar conteúdo no Plone. No topo do site Plone há uma caixa de busca que oferece uma maneira fácil de fazer buscas simples por palavras-chaves. Você pode procurar os resultados da busca usando a funcionalidade Advanced search. Está acessível clicando na aba search no topo da página.

No formulário Advanced search você será capaz de buscar o conteúdo por vários atributos, incluindo: title, keywords, description, review state, creation date, content type e até mesmo author.

Neste capítulo abordamos alguns dos elementos básicos como adição e publicação de conteúdo, busca e alteração da sua instância Plone par adequá-la a suas necessidades. Mesmo que cada site Plone seja diferente, cada um terá estes elementos básicos.

Próximo: O Sistema de Workflow Anterior: Como Instalar o Plone