Changes between Initial Version and Version 1 of WF/SelecaodeCidade

Timestamp:

07/24/07 15:01:43 (17 years ago)

Author:

trac

Comment:

--

WF/SelecaodeCidade

@@ +1 @@
+== 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).