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:
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" }%
Resultado:
A seguir um exemplo de edição de tabela com o EDITABLE que demonstra a utilização do date:
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.