About Continents And Countries

Displays countries and continents.

Category 1Language Modules
Modules involved in providing multi-language support.
Category 2Markup Generation
Markup modules that are called upon to generate or parse markup (like HTML). Markup modules are most often used on the front-end of a site (rather than admin).
Release StateBeta
Close to stable, but users are advised to be cautious and test thoroughly.*
Authorjustb3a
Module Version0.0.2
Class NameContinentsAndCountries
Compatibility2.6, 2.7
Date AddedSeptember 28, 2015
Last UpdatedOctober 1, 2015
Recommended ByNew recommendations may take up to 1 day to appear.

Instructions

This module's files should be placed in /site/modules/ContinentsAndCountries/
How to install or uninstall modules

README

ProcessWire Continents and Countries

Displays countries and continents and their iso codes.

The "value" for each country is the two-letter country code.

As an added bonus, the country names are displayed in the language of the user (sorted by name ASC) if the appropriate translation was added.

Example

Example

PHP

<?php $countries = $modules->get('ContinentsAndCountries')->findByContinent('eu'); ?>

<select>
  <?php foreach ($countries as $country): ?>
    <option value="<?=$country->code; ?>">
      <?=$country->name; ?>
    </option>
  <?php endforeach; ?>
</select>

Twig

{% set countries = modules.get('ContinentsAndCountries').findByContinent('eu') %}

<select>
  {% for country in countries %}
    <option value="{{country.code}}">
      {{country.name}}
    </option>
  {% endfor %}
</select>

Translations

To translate the continents and countries, you must have the ProcessWire Language Support module installed. This is included with ProcessWire, so all you have to do is click to Modules > Language > Language Support > install.

Once you have Language Support installed, you have to add or edit the desired language by going to Setup > Languages > Add New Language. Enter a title and name for the language and save.

Next, you can add the file for the language (have a look at site/modules/ContinentsAndCountries/translations/ if the translation for your language exists) or translate it manually.

Available Methods (atm)

  • getContinents()
  • getCountries()
  • getByContinent($continent)
    • $continent has to be one of af, as, eu, na, sa, oc, an
    • (Africa, Asia, Europe, North America, South America, Oceania, Antarctica)
  • findBy($table = 'countries', $select = array(), $options = array())

    • for example: findBy('countries', array('name', 'iso'), array(id => 2))
    • returns:

        array (size=1)
            0 => 
                object(stdClass)[1059]
                    public 'name' => string 'Åland-Inseln' (length=13)
                    public 'iso' => string 'ALA' (length=3)

Comments

No comments yet. Be the first to post!

Post a Comment

Your e-mail is kept confidential and not included with your comment. Website is optional.