Version 2 (modified by cassiomaes, 17 years ago) (diff) |
---|
Plugin: wf_select_city_init
Descrição: Insere código que referencia arquivos de javascript responsáveis pela funcionalidade.
Parâmetros: <nenhum>
Exemplo:
{wf_select_city_init}
Observação: antes de utilizar "wf_select_city" (seja uma ou mais vezes), deve-se fazer uma única chamada ao plugin "wf_select_city_init".
Plugin: wf_select_city
Descrição: Este plugin insere duas combo boxes que permitem ao usuário selecionar uma cidade do Brasil. A primeira combo é utilizada para fazer a seleção de um Estado. Uma vez feita esta seleção, é feita uma chamada Ajax que carrega as cidades daquele Estado na segunda combo. E, é nesta segunda combo que o usuário efetivamente seleciona a cidade.
Parâmetros:
name: o nome que a combo de seleção de cidade irá receber.
value: o ID da cidade que aparecerá inicialmente selecionada.
state_name: o nome da combo de seleção de Estado.
state_value: o ID do Estado inicialmente selecionado.
Parâmetro obrigatório:
name
Valor padrão:
value: 1 (ID da cidade de Curitiba)
state_name: _estado_ + <valor_randômico> + _ + <valor_randômico>
state_value: 1 (ID do Estado do Paraná)
Exemplo de utilização:
{wf_select_city name="cidade"}
O exemplo acima cria as duas combos para a seleção de cidade. Neste exemplo, devido aos valores padrão, o Estado selecionado será o Paraná e a cidade será Curitiba.
{wf_select_city name="cidade" state_value=4}
O exemplo acima cria as duas combos para a seleção de cidade. Na combo do Estado estará selecionado São Paulo e, na combo de cidade, a primeira cidade (por ordem alfabética) do Estado de São Paulo.
Observação: se for passado o id da cidade no value, não é necessário passar o state_value (ele será carregado automaticamente).