== 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).