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"}