A seguir alguns plugins do TWiki, para conhecer outros acesse TWiki.InstalledPlugins?.

CommentPlugin

Este plugin insere uma caixa de edição para postagem rápida de comentários nos tópicos nos quais estão escritos. Ou seja, não há necessidade de ir para o modo de edição para adicionar conteúdos na página.

Sintaxe básica: %COMMENT%

Nome Descrição Padrão
type Nome do template usado bellow
target Nome do tópico para adicionar o comentário. O padrão é o tópico corrente tópico corrente
location Expressão regular que especifica a localização do comentário no tópico alvo  
mode Apenas para compatibilidade com versões antigas, sincroniza com type off
nonotify Configurado como "on", desabilita a notificação de alterações no tópico alvo off
noform Configurado como "on", desabilita os formulário automático do bloco de comentário. Em caso de uso desse atributo deve-se lembrar de inserir as tags <form>. off
button Texto do botão Adicionar

Posicionamento

Em relação a tag COMMENT: o mais comum é posicionar em relação a tag. Pode-se usar os parâmetros bellow e above (abaixo e a cima, respectivamente). Ex: %COMMENT{type="bellow"}%

Em relação a uma âncora do TWiki: %COMMENT{type="above" target="Main.PersonalRemarks#InsertHere" }%

Em relação a primeira ocorrência de um texto da página: %COMMENT{type="above" location="Texto Qualquer"}%

Templates

top Comentário com assinatura e data no início do tópico (a âncora é ignorada)
bottom Comentário com assinatura e data no final do tópico (a âncora é ignorada)
above Comentário com assinatura e data adicionado antes da âncora ou tag
below Comentário com assinatura e data adicionado depois da âncora ou tag
belowthreadmode Comentário com assinatura e data adicionado recursivamente depois da caixa de cometários
threadmode Comentário em modo thread do Wiki, assinado e datado
tableprepend Comentário com assinatura e data, formatado em uma linha de tabela HTML, adicionado abaixo de uma âncora (a qual deve está em uma tag <table>)
tableappend Comentário com assinatura e data, adicionado acima de uma âncora (a qual deve está em uma tag <table>)
action Action adicionado na tabela de ações diretamente acima da caixa de comentários (requer TWiki:Plugins/ActionTrackerPlugin)
table Adicionando no final das linhas da tabela
toctalk Adiciona o TOC ao final
bookmark Cria uma lista de bookmarks
return Posta em um tópico diferente e retorna

Exemplo de caixa de comentário

A tag %COMMENT{type="below" button="Enviar" target="TutorialTWiki" }% irá resultar em:

 

Image Gallery Plugin

Este plugin possibilita a criação de uma galeria com as imagens anexadas ao tópico.

A galeria cria miniaturas das imagens para:

  • ampliação das imagens;
  • navegação pelas imagens: próximo, anterior, primeiro, último e voltar (up);
  • ordenação das imagens com a adição da numeração no seu comentário: <número><espaço>-<espaço><comentários>;
  • fácil gerenciamento das imagens clicando-se sobre o ponto vermelho localizado no seu título;

Além disso é possível customização da aparência da galeria usando-se CSS e HTML, veja mais informações em http://twiki.org/cgi-bin/view/Plugins/CommentPlugin.

Sintaxe

Duas tags da sintaxe básica:

  • %IMAGEGALLERY{...}%: renderiza a galeria de imagens
  • %NRIMAGES%: retorna o número de imagens anexadas na (lista de) tópicos

Argumento Descrição
topic lista separada por vírgula dos tópicos nos quais estão as imagens que devem ser mostradas (padrão: tópico corrente)
limit número máximo de imagens a serem mostradas (padrão: 0, ou seja, sem limite).
size tamanho das miniaturas da galeria, pode ser tiny, small, medium, large, huge (padrão: medium)
columns número de colunas de miniaturas mostradas em cada linhas da galeria (padrão: 4)
docrels flag para habilitar ou desabilitar a relação de documentos entre as imagens; possíveis valores são on, off, 0, 1 (padrão: on)
maxwidth largura máxima da imagem mostrada (padrão: 640)
maxheight comprimento máximo de uma imagem (padrão: 480)
minwidth largura mínima da imagem mostrada (padrão 0)
minheight comprimento mínimo da imagem mostrada (padrão: 0)
format formato html da imagem (padrão: )
titles Torna o título das imagens on ou off (padrão: on)
title formato html do título da imagem; "off" esconderá o título das imagens (padrão: $comment ($imgnr/$nrimgs) $reddot)
thumbtitle formato html do título das miniaturas; "off" esconderá os títulos (padrão: $comment $reddot)
sort configura a ordem inicial das imagens, pode ser name, date, size ou comment (padrão:date)
reverse inverte a ordem inicial das imagens, pode ser on ou off (padrão:off)

Exemplo

Tags:

Temos %NRIMAGES{topic="PluginsTWiki"}% imagens na galeria:
%IMAGEGALLERY{columns="3" size="small" topic="PluginsTWiki"}%

Resultado:

Temos 5 imagens na galeria:

Comunicóloga Firefox Firefox 2 Logo TWiki Exemplo de edição de tabela com EDITTABLEPLUGIN

Saiba mais sobre esse plugin, instalação e variáveis em http://twiki.org/cgi-bin/view/Plugins/ImageGalleryPlugin.

Edit Table Plugin

este plugin é útil para edição de tabelas sem a necessidade de se editar todo o tópico. O seu uso torna ainda mais fácil o uso de tabelas TWiki, além de permitir a aplicação de drop down, radio, campo de texto, etc.

Para formatação da tabela pesquise pelo TablePlugin em TWiki.org.

Sintaxe

Sintaxe básica: %EDITTABLE{}%

  • header, especifica o cabeçalho da nova tabela. Usado para iniciar a tabela com o uso do botão (sem cabeçalho);
  • format, formato das colunas durante a edição da tabela. Uma célula pode ser um campo de entrada de texto, ou um dos tipos a seguir:
    • Campo de entrada de texto (1 linha): text, <tamanho>, <valor inicial>
    • Área de entrada de texto: textarea, <linhas>x<colunas>, <valor inicial>
    • Caixa Drop Down: select, <tamanho>, <opção 1>, <opção 2>, etc, apenas um item pode ser selecionado;
    • Botões Radio: radio, <tamanho*>, <opção 1>, <opção 2>, etc, o tamanho indica o número de botões por linha no modo de edição;
    • Checkboxes: checkbox, <tamanho*>, <opção 1>, <opção 2>, etc, o tamanho indica o número de checkboxs por linha no modo de edição;
    • Etiqueta fixa: label, 0, <label texto>
    • Número de linhas: row, <offset>
    • Data: date, <tamanho>, <valor inicial>, <data no formato DHTML>, "text, 16"for all cells   * =changerows
    • Linhas podem ser adicionadas e removidas se configurado para "on";
    • Linhas podem ser adicionadas e não podem ser removidas se configurado para "add";
    • Linhas não podem ser adicionadas ou removidas se configurado para "off";
  • quietsave mostra o botão de Save (salvar) se "on", o esconde se "off";
  • include, outros tópicos definindo os parâmetros do EDITTABLE. O primeiro %EDITTABLE% do tópico será usado. Isso é usado quando se tem muitos tópicos com o mesmo formato de tabel e se quer atualizar o formato em um só lugar;
  • helptopic, nome do tópico contendo o texto de ajuda mostrado abaixo da tabela quando se edita a tabela. As variáveis %STARTINCLUDE% e %STOPINCLUDE% podem ser usados no tópico para especificar o que é mostrado;
  • O padrão é sem texto de ajuda;
  • headerislabel, as células de cabeçalho da tabela é mostrado apenas para leitura se "on"; as células de cabeçalho poderão ser editadas ser "off" ou "0". O padrão é "on";
  • editbutton configura o botão de edição, por exemplo, "Editar tabela"; pode-se considerar uma imagem botão com texto alternativo "alt", como "Editar tabela, http://colivre.coop.br/pub/TWiki/TWikiDocGraphics/edittopic.gif"; pode-se esconder o botão no fim da tabela com "hide" (Nota: O botão é automaticamente escondido se um botão edite estiver presente na célula;

Exemplo

Tag:

%EDITTABLE{ format="| row, -1 | text, 20, inicial | select, 1, um, dois, três, quatro | radio, 3,:-),:-I,:-( | label, 0, %SERVERTIME{"$day $mon $year $hour:$min"}% |" changerows="on" }%

Número Campo de Texto Drop down Mood Timestamp

Resultado:

Número Campo de Texto Drop down Mood Timestamp
1 inicial um smile 02 May 2008 15:48
2 texto 1 dois indifferent 02 May 2008 15:49
3 texto 2 três frown 02 May 2008 15:49
4 inicial quatro indifferent 06 May 2008 11:51
5 teste três smile 06 May 2008 11:54


A seguir um exemplo de edição de tabela com o EDITABLE que demonstra a utilização do date:

EditTablePluginCalendarExample.gif

Outros

O TWiki conta com uma enorme variedade de plugins, organizados por tag relativas a sua função. Para a busca por novos plugins, acesse o menu lateral do site TWiki.org. Na web destinadas aos plugins, pode-se fazer os download e ter informações sobre a instalação.

Com os inúmeros plugins pode-se trabalhar com agenda de eventos, formatação de tabelas, operações matemáticas e de tratamento de strings, desenvolvimento, autenticação, etc.

Topic revision: r12 - 06 May 2008 - 14:54:38 - CintiaCinquini
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki-Colivre? Send feedback