Zu Handbuch PHP-API

Golem_Api_Theme_List – Liste der Themen-Kategorien holen

Mit der Klasse Golem_Api_Theme_List laden Sie die Liste der Themen-Kategorien auf Golem.de.

Einbindung

require_once '[Installationsort/]Golem/Request.php';
require_once '[Installationsort/]Golem/Api/Theme/List.php';

Verwendung

Um ein neues Objekt der Klasse Golem_Api_Theme_List zu erzeugen, übergeben Sie dem Konstruktor lediglich Ihren Entwicklerschlüssel:

$request = new Golem_Api_Theme_List($developerKey);
Beispiel 1: Objektinitialisierung

Die eigentliche Abfrage erfolgt mit der Methode fetch(). War sie erfolgreich, erhalten Sie mit der getThemes()-Methode die Liste der Kategorien als Array. Jeder Eintrag des Arrays enthält die Daten einer Kategorie in Form eines assoziation Arrays.

$request->fetch();

$themes = $request->getThemes();
Beispiel 2: Abfrage starten und Daten holen

Fehlerbehandlung

Wenn während der Abfrage ein Fehler auftritt, wird eine Exception geworfen, die Sie mit try-catch auffangen können.

try {

 $request->fetch();

 $themes = $request->getThemes();

} catch(Exception $e) {

 $error = $e->getErrorCode();

}
Beispiel 3: Fehler abfangen

Verfügbare Kategoriedaten

Für jede Kategorie werden folgende Eigenschaften mitgeliefert:

Name Bedeutung
name Die Bezeichnung der Themen-Kategorie
shortname Der Kurzname der Themen-Kategorie, wird auch als Identifier der Themen-Kategorie benutzt.
url Die URL der Übersichtsseite der Themen-Kategorie.

Vollständiges Beispiel

<?php

require_once 'Golem/Request.php';
require_once 'Golem/Api/Theme/List.php';

$developerKey = '<ENTWICKLERSCHLÜSSEL>';
$themes     = array();
$error        = '';

$request = new Golem_Api_Theme_List($developerKey);

try {

 $request->fetch();

 $themes = $request->getThemes();

} catch( Exception $e ) {

 $error = $e->getErrorCode();

}

?>

<html>
 <head>
  <title>List of theme categories example</title>
 </head>
 <body>
  <?php echo $error; ?>
  <ul>
   <?php

   foreach($themes as $theme) {

    echo '<li>';
    echo $theme['name'];
    echo '</li>';

   }

   ?>
  </ul>
 </body>
</html>



Zu Handbuch PHP-API