We have just released the Location Lists Joomla plugin, allowing Joomla! site users to add custom fields to their sites utilising the Geodata Solutions web service.

Instructions:

  1. Download the component
  2. Install using the Joomla installer
  3. Activate the plugin in the Plugin manager
  4. Add a new custom field in the usual manner: instructions
  5. Configuration
    • Lists required: here you can choose which list set type you'd like to appear
      • Country only: no dynamic elements - for simply choosing a country
      • Country - State: User selects a country, then states dropdown is populated with states from selected country
      • Country - State - City: User selects a country, then from the states populated, then finally cities in that state
      • State - City (Single country): For the selection of states and cities from only one country
      • State (Single country): For the selection of states from one country
    • Country ordering: Choose whether to have countries ordered by alphabetical, by population (descending) or randomly
    • Country filters: You can choose to filter countries based on minimum population, or explicitly selecting countries to either include or exclude
      • If choosing population, you must enter a numerical value on the country population field
      • If choosing include or exclude values, you must type in the two-letter country code for each country separated by a hyphen into the filtered countries field. For instance, for Mexico, China and Russia, you would enter 'mx-cn-rs'.
    • Preselected country: You can choose to preselect a country based on the user's IP address (IP 4 only) or by designating a country. By default, no country is preselected.
      • Add the country code to Preselect country field if the Choose country option is selected
    • Group by continent: ordering : You have the option to group countries based on their continent. By default, there is no grouping, but you can choose to order by population (descending), choose the top item or have them randomly ordered
    • State ordering: Choose whether to have states ordered by alphabetical, by population (descending) or randomly
    • State filters: You can choose to filter states based on minimum population
      • If choosing population, you must enter a numerical value on the state population field
    • City ordering: Choose whether to have cities ordered by alphabetical, by population (descending) or randomly
    • City filters: You can choose to filter cities based on minimum population (US Only)
      • If choosing population, you must enter a numerical value on the city population field
  6. Save your changes and test your dropdown lists

Notes & Troubleshooting

User Access Control: If you use the plugin for user fields, please ensure you set the appropriate create and edit own permissions in the fields setup, otherwise you might find users can make new selections from the dropdowns, but values are not updated.

User profile output: We regret that the output for fields in the profile view mode is a little screwy. We use a pipe-separated format for storing location data. Unlike com_content and com_categories, custom fields in com_users ignore the template overrides of the custom field. We're looking for a fix for this

We're new here: As this plugin has only just been released, there's likely to be some bugs in certain situations. We appreciate your feedback and bug reports

Review us: Leave a rating and review on the JED for us