* @copyright 2011-2017 Boxtal
* @license http://www.gnu.org/licenses/
*/
namespace Emc;
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) {
# Add here new country xml properties to handle.
$__prop = array('code', 'label', 'is_ue', 'states');
$this -> countries = array();
foreach ($this->xpath->query('/countries/country') as $country) {
$c = (object) array();
# Process the random country xml properties.
foreach ($__prop as $_v) {
$c -> {$_v} = $this->xpath->query('./' . $_v, $country)->item(0)->nodeValue;
}
# Process some more specific properties.
$c->states = array();
foreach ($this->xpath->query('./states/state', $country) as $state) {
$c -> states[] = (object) array(
'code' => $this->xpath->query('./code', $state)->item(0)->nodeValue,
'label' => $this->xpath->query('./label', $state)->item(0)->nodeValue
);
}
# Add the country object to the collection.
$this->countries[$c->code] = $c;
}
}
}
}
/**
* 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)
{
if (isset($this->countries[$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++;
}
}
}
} else {
$this->country = array();
}
}
}