wiki:WF/SelecaodeCidade

Version 3 (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).