* @copyright 2011-2016 Boxtal
* @license http://www.gnu.org/licenses/
*/
class Country extends WebService
{
/**
* Protected array with countries relations by ISO codes.
* For example it contains the relation between the Canary Islands and Spain which haven't the same
* ISO code.
* @access protected
* @var array
*/
protected $codes_rel = array(
'NL' => 'A',
'PT' => 'P',
'DE' => 'D',
'IT' => 'I',
'ES' => 'E',
'VI' => 'V',
'GR' => 'G');
/**
* Public variable with categories array. The categories codes are the array keys.
*
* Structure :
* $countries[code] => array(
* ['label'] => data
* ['code'] => data
* )
*
* @access public
* @var array
*/
public $countries = array();
/**
* Public variable with country array which contains main country and possibly the
* iso relations.
*
* Structure :
* $country[x] => array(
* ['label'] => data
* ['code'] => data
* )
*
* @access public
* @var array
*/
public $country = array();
/**
* Function loads all countries.
* @access public
* @return Void
*/
public function getCountries()
{
$this->setOptions(array('action' => 'api/v1/countries'));
$this->doCtrRequest();
}
/**
* Function executes countries request and prepares the $countries array.
* @access private
* @return Void
*/
private function doCtrRequest()
{
$source = parent::doRequest();
/* We make sure there is an XML answer and try to parse it */
if ($source !== false) {
parent::parseResponse($source);
if (count($this->resp_errors_list) == 0) {
/* The XML file is loaded, we now gather the datas */
$countries = $this->xpath->query('/countries/country');
foreach ($countries as $country) {
$code = $this->xpath->query('./code', $country)->item(0)->nodeValue;
$this->countries[$code] = array(
'label' => $this->xpath->query('./label', $country)->item(0)->nodeValue,
'code' => $code);
}
}
}
}
/**
* Getter function for one country. If the country code is placed in $codes_rel array,
* we take also his relations.
* @param $code : String with country code.
* @access public
* @return Void
*/
public function getCountry($code)
{
$this->country = array(0 => $this->countries[$code]);
if (isset($this->codes_rel[$code]) && $this->codes_rel[$code] != '') {
$iso_rel = $this->codes_rel[$code];
$i = 1;
foreach ($this->countries as $c => $country) {
if (preg_match('/' . $iso_rel . '\d/', $c)) {
$this->country[$i] = $country;
$i++;
}
}
}
}
}