A seguir alguns plugins do TWiki/Foswiki, para conhecer outros acesse System→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="TutorialFoswiki" }% irá resultar em:

 

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 %NRIMAGES{topic="PluginsTWiki"}% 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 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, Error: (1) can't find edittopic.gif at TWiki.TWikiDocGraphics"; 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
edit
2
texto 1
dois
indifferent, speechless
02 May 2008 15:49
edit
3
texto 2
três
frown, sad smile
02 May 2008 15:49
edit
4
inicial
quatro
indifferent, speechless
06 May 2008 11:51
edit
5
teste
três
smile
06 May 2008 11:54
edit


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

Outros

O Foswiki conta com uma enorme variedade de plugins, organizados por tags relativas a sua função. Para a buscar por novos plugins, acesse http://foswiki.org/Extensions onde pode-se fazer download e ter informações sobre uso e 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: r1 - 28 Apr 2014, UnknownUser
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