Apesar da conta admin estar devidamente configurada, é aconselhável adicionar o seu WikiName ao AdminGroup.
Ok! O Foswiki está pronto para uso.
Instalando Extensões (Plugins)
Você pode (e deve) instalar extensões do Foswiki pelo gestor de pacotes do Debian, mas, para buscar, é mais fácil usar esta página: http://foswiki.org/Extensions
Caso queira é possível instalar as extensões manualmente. A página da extensão contem documentação sobre uso e instalação. Basicamente você adiciona os executáveis em .../lib/Foswiki/Plugins/ e a documentação em .../data/System/.
Extensões interessantes:
O e-mail de notificação de modificação das páginas é lançado pelo script mailnotify.
Entre no diretório raiz da instalação do Foswiki e execute:
perl -I bin tools/mailnotify Neste momento você enviará notificações de todas as modificações feitas desde a última execução deste script para todos os inscritos em todas as webs.
Esse script aceita argumentos pela linha de comando para modificar sua forma de trabalho e filtrar webs.
Formas de cadastro no WebNotify
Pode-se cadastrar usuários, grupos ou simplesmente e-mails no WebNotify, cada um como item de uma lista. É possível informar ao Foswiki sobre quais tópicos desejamos ser notificados, incluindo ou excluindo tópicos com ajuda do coringa *. Com os simbolos ! e ? informamos a necessidade do envio do conteúdo completo dos tópicos marcados.
Interfaces personalizadas para funcionalidades do Foswiki
Veja CommandAndCGIScripts para conhecer os scripts da instalação padrão.
O importante é apontar o script corretamente e entregar cada parâmetro, seja via GET ou POST.
Use a macro SCRIPTURL para garantir o apontamento correto:
%SCRIPTURL{script}% Se algo mudar no path do seu serviço, esta macro fará seu link ou form continuar funcionando.
Muitos scripts precisam rodar no contexto de um tópico. Podemos informar o tópico para esses casos adicionando Web/Tópico após o SCRIPTURL, ou enviamos o tópico via GET ou POST.
Exemplos:
Para adicionar o botão que gera PDF do tópico visitado, crie o tópico MinhaTemplate com o seguinte conteúdo:
%TMPL:INCLUDE{"view"}%
%TMPL:DEF{"top:toolbarbuttons"}%
<span><a href="%SCRIPTURL{genpdf}%/%WEB%/%TOPIC%?t=%GMTIME{$epoch}%" \
rel="nofollow" title="Baixar versão PDF deste tópico" accesskey="p">\
<span class="foswikiAccessKey">P</span>DF</a></span>
%TMPL:P{"activatable_edit_or_create"}%%TMPL:P{"activatable_attach"}%%TMPL:END%
…e adicione a seguinte variável em Main.SitePreferences:
* Set VIEW_TEMPLATE = Minha
O bloco top:toolbarbuttons já existia e é parte da template padrão incluída em MinhaTemplate.
Redefinimos este bloco para colocar o botão "PDF" ao lado do "Edit" e "Attach" no topo da página.
Criando Tópicos Automaticamente
O Foswiki já lhe provê facilidades para criação de tópicos a partir de WikiWords sem tópicos.
O interessante é poder criar nomes dinamicamente e até saltar a fase de edição dependendo da necessidade, para isso use os conhecimentos do tópico anterior.
Podemos criar tópicos automaticamente de três formas: pedindo que o usuário informe um nome, usando auto incremento ou sufixando o valor de uma variável como a GMTIME.
Pedindo que o usuário informe o nome:
Crie um tópico a partir da submissão de um form, como vimos anteriormente. O usuário deverá adicionar o nome do novo tópico no campo de texto.
Via auto-incremento:
Referencie um tópico finalizado com AUTOINC<n> para o script edit ou save e estes criarão um novo tópico onde AUTOINC<n> será substituído pelo primeiro número inteiro positivo não usado.
Exemplo:
[[%SCRIPTURL{edit}%/Web/TópicoAUTOINC0][Novo Tópico]]Sufixando o valor de uma variável de valor dinâmico:[[%SCRIPTURL{edit}%/Web/Noticia%GMTIME{$year$mo$day}%][Nova Notícia]]
Expressões Regulares
A orientação se baseia no material de Aurélio Jargas:
http://guia-er.sourceforge.net
Use o form abaixo para testar suas expressões:
Criando WikiApplications
Já dissemos o que são WikiApplications no Tutorial Foswiki, então acompanhe a prática que se baseará no conhecimento dos tópicos anteriores.
Ajax
Já existem várias extensões para usos variados de Ajax no Foswiki.
O Foswiki pode gerar qualquer gênero de informação textual, então se quiser criar sua própria busca baseada em Ajax, seria uma boa idéia gerar a resposta em JSON. Veja um exemplo de tópico que pode gerar respostas formatadas para buscas variadas: