ILIAS  release_8 Revision v8.24
ilADTLocation Class Reference
+ Inheritance diagram for ilADTLocation:
+ Collaboration diagram for ilADTLocation:

Public Member Functions

 reset ()
 Init property defaults. More...
 
 setLongitude (float $a_value=null)
 
 getLongitude ()
 
 setLatitude (?float $a_value=null)
 
 getLatitude ()
 
 getZoom ()
 
 setZoom ($a_value)
 
 equals (ilADT $a_adt)
 Check if given ADT equals self. More...
 
 isLarger (ilADT $a_adt)
 Check if given ADT is larger than self. More...
 
 isSmaller (ilADT $a_adt)
 Check if given ADT is smaller than self. More...
 
 isNull ()
 Is currently null. More...
 
 isValid ()
 
 translateErrorCode (string $a_code)
 @inheritcoc More...
 
 getCheckSum ()
 Get unique checksum. More...
 
 exportStdClass ()
 Export value as stdClass. More...
 
 importStdClass (?stdClass $a_std)
 Import value from stdClass. More...
 
- Public Member Functions inherited from ilADT
 __construct (ilADTDefinition $a_def)
 
 getType ()
 Get type (from class/instance) More...
 
 reset ()
 Init property defaults. More...
 
 getCopyOfDefinition ()
 Get copy of definition. More...
 
 equals (ilADT $a_adt)
 Check if given ADT equals self. More...
 
 isLarger (ilADT $a_adt)
 Check if given ADT is larger than self. More...
 
 isLargerOrEqual (ilADT $a_adt)
 
 isSmaller (ilADT $a_adt)
 Check if given ADT is smaller than self. More...
 
 isSmallerOrEqual (ilADT $a_adt)
 Check if given ADT is smaller or equal than self. More...
 
 isInbetween (ilADT $a_adt_from, ilADT $a_adt_to)
 Check if self is inbetween given ADTs (exclusive) More...
 
 isInbetweenOrEqual (ilADT $a_adt_from, ilADT $a_adt_to)
 Check if self is inbetween given ADTs (inclusive) More...
 
 isNull ()
 Is currently null. More...
 
 isValid ()
 
 getValidationErrors ()
 Get all validation error codes. More...
 
 translateErrorCode (string $a_code)
 Translate error-code to human-readable message. More...
 
 getCheckSum ()
 Get unique checksum. More...
 
 exportStdClass ()
 Export value as stdClass. More...
 
 importStdClass (?stdClass $a_std)
 Import value from stdClass. More...
 

Data Fields

const ADT_VALIDATION_ERROR_LONGITUDE = "loc1"
 
const ADT_VALIDATION_ERROR_LATITUDE = "loc2"
 
- Data Fields inherited from ilADT
const ADT_VALIDATION_ERROR_NULL_NOT_ALLOWED = "adt1"
 
const ADT_VALIDATION_ERROR_MAX_LENGTH = "adt2"
 
const ADT_VALIDATION_ERROR_MAX_SIZE = "adt3"
 
const ADT_VALIDATION_ERROR_MIN = "adt4"
 
const ADT_VALIDATION_ERROR_MAX = "adt5"
 
const ADT_VALIDATION_DATE = "adt6"
 
const ADT_VALIDATION_ERROR_INVALID_NODE = 'adt7'
 

Protected Member Functions

 isValidDefinition (ilADTDefinition $a_def)
 Check if definition is valid for ADT. More...
 
- Protected Member Functions inherited from ilADT
 isValidDefinition (ilADTDefinition $a_def)
 Check if definition is valid for ADT. More...
 
 setDefinition (ilADTDefinition $a_def)
 Set definition. More...
 
 getDefinition ()
 Get definition. More...
 
 addValidationError (string $a_error_code)
 

Protected Attributes

float $longitude
 
float $latitude
 
int $zoom
 
- Protected Attributes inherited from ilADT
ilADTDefinition $definition
 
ilLanguage $lng
 
array $validation_errors = []
 

Detailed Description

Definition at line 5 of file class.ilADTLocation.php.

Member Function Documentation

◆ equals()

ilADTLocation::equals ( ilADT  $a_adt)

Check if given ADT equals self.

Parameters
ilADT$a_adt
Returns
bool|null

Reimplemented from ilADT.

Definition at line 65 of file class.ilADTLocation.php.

65 : ?bool
66 {
67 if ($this->getDefinition()->isComparableTo($a_adt)) {
68 return ($this->getLongitude() == $a_adt->getLongitude() &&
69 $this->getLatitude() == $a_adt->getLatitude());
70 }
71 return null;
72 }
getDefinition()
Get definition.
Definition: class.ilADT.php:92

References ilADT\getDefinition(), and getLongitude().

+ Here is the call graph for this function:

◆ exportStdClass()

ilADTLocation::exportStdClass ( )

Export value as stdClass.

Returns
stdClass | null

Reimplemented from ilADT.

Definition at line 143 of file class.ilADTLocation.php.

143 : ?stdClass
144 {
145 if (!$this->isNull()) {
146 $obj = new stdClass();
147 $obj->lat = $this->getLatitude();
148 $obj->long = $this->getLongitude();
149 $obj->zoom = $this->getZoom();
150 return $obj;
151 }
152 return null;
153 }
isNull()
Is currently null.

References getLatitude(), getLongitude(), getZoom(), and isNull().

+ Here is the call graph for this function:

◆ getCheckSum()

ilADTLocation::getCheckSum ( )

Get unique checksum.

Returns
string | null

Reimplemented from ilADT.

Definition at line 133 of file class.ilADTLocation.php.

133 : ?string
134 {
135 if (!$this->isNull()) {
136 return md5($this->getLongitude() .
137 "#" . $this->getLatitude() .
138 "#" . $this->getZoom());
139 }
140 return null;
141 }

References getLatitude(), getLongitude(), getZoom(), and isNull().

+ Here is the call graph for this function:

◆ getLatitude()

ilADTLocation::getLatitude ( )

Definition at line 48 of file class.ilADTLocation.php.

48 : ?float
49 {
50 return $this->latitude;
51 }

References $latitude.

Referenced by exportStdClass(), getCheckSum(), isNull(), and isValid().

+ Here is the caller graph for this function:

◆ getLongitude()

ilADTLocation::getLongitude ( )

Definition at line 38 of file class.ilADTLocation.php.

38 : ?float
39 {
40 return $this->longitude;
41 }

References $longitude.

Referenced by equals(), exportStdClass(), getCheckSum(), isNull(), and isValid().

+ Here is the caller graph for this function:

◆ getZoom()

ilADTLocation::getZoom ( )

Definition at line 53 of file class.ilADTLocation.php.

53 : ?int
54 {
55 return $this->zoom;
56 }

References $zoom.

Referenced by exportStdClass(), and getCheckSum().

+ Here is the caller graph for this function:

◆ importStdClass()

ilADTLocation::importStdClass ( ?stdClass  $a_std)

Import value from stdClass.

Parameters
stdClass  |  null$a_std

Reimplemented from ilADT.

Definition at line 155 of file class.ilADTLocation.php.

155 : void
156 {
157 if (is_object($a_std)) {
158 $this->setLatitude($a_std->lat);
159 $this->setLongitude($a_std->long);
160 $this->setZoom($a_std->zoom);
161 }
162 }
setLongitude(float $a_value=null)
setLatitude(?float $a_value=null)

References setLatitude(), setLongitude(), and setZoom().

+ Here is the call graph for this function:

◆ isLarger()

ilADTLocation::isLarger ( ilADT  $a_adt)

Check if given ADT is larger than self.

Parameters
ilADT$a_adt
Returns
bool

Reimplemented from ilADT.

Definition at line 74 of file class.ilADTLocation.php.

74 : ?bool
75 {
76 return null;
77 }

◆ isNull()

ilADTLocation::isNull ( )

Is currently null.

Returns
bool | null

Reimplemented from ilADT.

Definition at line 86 of file class.ilADTLocation.php.

86 : bool
87 {
88 return $this->getLongitude() === null && $this->getLatitude() === null;
89 }

References getLatitude(), and getLongitude().

Referenced by exportStdClass(), and getCheckSum().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isSmaller()

ilADTLocation::isSmaller ( ilADT  $a_adt)

Check if given ADT is smaller than self.

Parameters
ilADT$a_adt
Returns
bool | null

Reimplemented from ilADT.

Definition at line 79 of file class.ilADTLocation.php.

79 : ?bool
80 {
81 return null;
82 }

◆ isValid()

ilADTLocation::isValid ( )

Reimplemented from ilADT.

Definition at line 93 of file class.ilADTLocation.php.

93 : bool
94 {
95 $valid = parent::isValid();
96 $long = $this->getLongitude();
97 $lat = $this->getLatitude();
98 if ($long !== null && $lat !== null) {
99 // 0 - (+-)180
100 if ($long < -180 || $long > 180) {
101 $this->addValidationError(self::ADT_VALIDATION_ERROR_LONGITUDE);
102 $valid = false;
103 }
104 // 0 - (+-)90
105 if ($lat < -90 || $lat > 90) {
106 $this->addValidationError(self::ADT_VALIDATION_ERROR_LATITUDE);
107 $valid = false;
108 }
109 }
110 return $valid;
111 }
addValidationError(string $a_error_code)
$valid

References $valid, ilADT\addValidationError(), getLatitude(), and getLongitude().

+ Here is the call graph for this function:

◆ isValidDefinition()

ilADTLocation::isValidDefinition ( ilADTDefinition  $a_def)
protected

Check if definition is valid for ADT.

Parameters
ilADTDefinition$a_def
Returns
bool

Reimplemented from ilADT.

Definition at line 16 of file class.ilADTLocation.php.

16 : bool
17 {
18 return $a_def instanceof ilADTLocationDefinition;
19 }

◆ reset()

ilADTLocation::reset ( )

Init property defaults.

Reimplemented from ilADT.

Definition at line 23 of file class.ilADTLocation.php.

23 : void
24 {
25 parent::reset();
26 $this->setZoom(9);
27 $this->setLatitude();
28 $this->setLongitude();
29 }

References setLatitude(), setLongitude(), and setZoom().

+ Here is the call graph for this function:

◆ setLatitude()

ilADTLocation::setLatitude ( ?float  $a_value = null)

Definition at line 43 of file class.ilADTLocation.php.

43 : void
44 {
45 $this->latitude = $a_value;
46 }

Referenced by importStdClass(), and reset().

+ Here is the caller graph for this function:

◆ setLongitude()

ilADTLocation::setLongitude ( float  $a_value = null)

Definition at line 33 of file class.ilADTLocation.php.

33 : void
34 {
35 $this->longitude = $a_value;
36 }

Referenced by importStdClass(), and reset().

+ Here is the caller graph for this function:

◆ setZoom()

ilADTLocation::setZoom (   $a_value)

Definition at line 58 of file class.ilADTLocation.php.

58 : void
59 {
60 $this->zoom = max(1, abs((int) $a_value));
61 }

Referenced by importStdClass(), and reset().

+ Here is the caller graph for this function:

◆ translateErrorCode()

ilADTLocation::translateErrorCode ( string  $a_code)

@inheritcoc

Reimplemented from ilADT.

Definition at line 119 of file class.ilADTLocation.php.

119 : string
120 {
121 switch ($a_code) {
123 return $this->lng->txt("adt_error_longitude");
124
126 return $this->lng->txt("adt_error_latitude");
127
128 default:
129 return parent::translateErrorCode($a_code);
130 }
131 }
const ADT_VALIDATION_ERROR_LONGITUDE
const ADT_VALIDATION_ERROR_LATITUDE

References ADT_VALIDATION_ERROR_LATITUDE, ADT_VALIDATION_ERROR_LONGITUDE, and ILIAS\Repository\lng().

+ Here is the call graph for this function:

Field Documentation

◆ $latitude

float ilADTLocation::$latitude
protected

Definition at line 8 of file class.ilADTLocation.php.

Referenced by getLatitude().

◆ $longitude

float ilADTLocation::$longitude
protected

Definition at line 7 of file class.ilADTLocation.php.

Referenced by getLongitude().

◆ $zoom

int ilADTLocation::$zoom
protected

Definition at line 9 of file class.ilADTLocation.php.

Referenced by getZoom().

◆ ADT_VALIDATION_ERROR_LATITUDE

const ilADTLocation::ADT_VALIDATION_ERROR_LATITUDE = "loc2"

Definition at line 12 of file class.ilADTLocation.php.

Referenced by translateErrorCode().

◆ ADT_VALIDATION_ERROR_LONGITUDE

const ilADTLocation::ADT_VALIDATION_ERROR_LONGITUDE = "loc1"

Definition at line 11 of file class.ilADTLocation.php.

Referenced by translateErrorCode().


The documentation for this class was generated from the following file: