= Calendário =

Este plugin tem por finalidade inserir, facilmente, um calendário para seleção de datas em uma página. Este calendário é baseado em DHTML e Javascript. Na realidade não se trata de um único plugin e sim dois. Um deles tem por finalidade, apenas, escrever o código que referencia os arquivos Javascript e o arquivo de folha de estilos do calendário.

== Plugin: wf_calendar_init ==

'''Descrição:''' insere código que regerencia arquivos js e css.

'''Parâmetros:''' <nenhum>

'''Exemplo de utilização:''' {wf_calendar_init}

== Plugin: wf_calendar ==

'''Descrição:''' insere o calendário

'''Parâmetros:'''

  name : o nome do campo (pertencente ao formulário) que irá receber o valor da data (funciona somente para o caso 1).

  default : inicializa outros parâmetros obrigatórios com valores pré-estabelecidos (indica que funcionará no caso 1).

  value : o valor inicial para o calendário, e.g. "25/11/1994' (funciona somente para o caso 1).

  inputField : o ID do campo que conterá a data selecionada.

  displayArea : ID de um DIV, SPAN ou outro elemento que irá mostrar a data selecionada. Geralmente útil quando o campo do formulário que irá armazenar a data é oculto ("hidden").

  button : ID do "gatilho" do calendário. É o ID de um elemento, geralmente um botão ou uma imagem, que irá mostrar o calendário quando clicado.

  eventName : nome do evento que deve acontecer para mostrar o calendário. O nome do evento não deve conter o prefixo "on", ou seja, ao invés de "onclick" deve utilizar "click" (exemplo).

  ifFormat : o formato da data armazenada no campo referenciado pelo ID do inputFiled.

  daFormat : o formato da data exibida no elemento referenciado pelo ID do displayArea.

  singleClick : indica se o calendário deve funcionar em modo "clique simples" ou "duplo clique".

  flat : caso se queira um calendário "plano" (incorporado à página) deve-se passar o ID do elemento que irá conter o calendário. Caso contrário, deve-se passar o valor null.

'''Valores padrões:'''

  inputField: / valor do parâmetro "name" caso seja passado o parâmetro "default" com valor "true".

  button: / valor do parâmetro "name" com o sufixo "-trigger" caso seja passado o parâmetro "default" com valor "true".

  eventName : "click"

  ifFormat : "%d/%m/%Y"

  daFormat : "%d/%m/%Y"

  singleClick : true

  flat :

'''Parâmetros obrigatórios (caso 1):'''

  name

  default

'''Parâmetros obrigatórios (caso 2):'''

  flat

  inputField

  displayArea

  button

'''Parâmetros opcionais:'''

  eventName

  ifFormat

  daFormat

  singleClick

Existem também outros parâmetros pouco usados. Quaisquer dúvidas, basta falar com um dos desenvolvedores. Em 90% dos casos, a utilização do caso 1 já resolve o problema do desenvolvedor.

'''Exemplos de utilização:'''

Caso 1:

{{{
{wf_calendar default=true name="data_inicio"}
}}}

outro exemplo

{{{
{wf_calendar default=true name="data_inicio" value=$data}
}}}

Caso 2:

{{{
{wf_calendar flat=null inputField="campo_if" button="botao" displayArea="campo_da"}
}}}

Para o caso 2, além do comando chamando o plugin, deve-se adicionar, manualmente, o código HTML para cada elemento referenciado pelos IDs. Por exemplo, deveríamos criar os seguintes elementos:

{{{
<input type="hidden" name="campo_if" id="campo_if">

<input type="text" name="campo_da" id="campo_da">

<button id="botao">
}}}

Para o caso 1, apenas a chamada do plugin já cria todo o código necessário. Lembrando que para qualquer um dos dois casos, deve-se preceder uma ou mais chamadas de "wf_calendar" por apenas UMA chamada a "wf_calendar_init".

Exemplo do calendário criado por: {wf_calendar default=true name="data_inicio"}

[[Image(plugin_calendario.jpg)]]