05. Erstellen des Blockinhalts
Nun müssen wir den Inhalt für unseren Block erstellen. Hier wird ein einfacher Weg aufgezeigt, um auf die Datenbank zuzugreifen.
Unser Ziel ist es, eine Liste mit Inhalten (die als "nodes" in der Datenbank gespeichert sind und vor einer Woche erstellt wurden) zu erhalten. Speziell wollen wir den Inhalt, der an dem Tag vor einer Woche zwischen Mitternacht und 23:59 Uhr wurde, haben. Sobald eine Node das erstellt wird, wird die Erstellzeit in die Datenbank eingetragen. Wir verwenden das entsprechende Feld in der Tabelle '{node}', um unsere Daten zu finden.
Zuerst müssen wir die Zeit für Mitternacht vor einer Woche und für 23.59 Uhr am selben Tag berechnen (in Sekunden seit Zeitbeginn; siehe http://www.php.net/manual/en/function.time.php für mehr Informationen zum Format). Dieser Teil des Quelltextes ist unabhängig von Drupal; siehe die PHP Seite (http://php.net/) für mehr Details.
<?php
/**
* Generate HTML for the onthisdate block
* @param op the operation from the URL
* @param delta offset
* @returns block HTML
*/
function onthisdate_block($op='list', $delta=0) {
// listing of blocks, such as on the admin/block page
if ($op == "list") {
$block[0]["info"] = t('On This Date');
return $block;
} else if ($op == 'view') {
// our block content
// Get today's date
$today = getdate();
// calculate midnight one week ago
$start_time = mktime(0, 0, 0,
$today['mon'], ($today['mday'] - 7), $today['year']);
// we want items that occur only on the day in question, so
// calculate 1 day
$end_time = $start_time + 86400;
// 60 * 60 * 24 = 86400 seconds in a day
...
}
}
?>Der nächste Schritt ist die SQL Anweisung, mit der der Inhalt aus der Datenbank geladen wird. Wir nehmen den Inhalt aus der Tabelle '{node}', die die zentrale Tabelle für Inhalte in Drupal ist. Alle möglichen Typen von Inhalt können mit dieser Abfrage geladen werden: Blogeinträge, Posts in Foren, etc. Für dieses Handbuch reicht dies vollkommen. In einem echten Modul würdest Du die SQL Anweisung so abändern, dass nur bestimmte Inhaltstypen abgefragt werden (indem die Spalte 'type' zum 'WHERE' Teil hinzugefügt wird).
Hinweis: der Tabellenname ist in geschweifte Klammern eingeschlossen: {node}. Dies ist notwendig damit Dein Modul Tabellenpräfixes unterstützt. Mehr Informationen dazu kannst Du auf der Seite Table Prefix (and sharing tables across instances) im Handbuch von Drupal finden.
Wir verwenden die Funktion db_query() um die Einträge (z.B. die Zeilen der Tabelle) mit unserer SQL Abfrage zu erhalten:
<?php
$query = "SELECT nid, title, created FROM " .
"{node} WHERE created >= '%d' " .
" AND created <= '%d'";
$queryResult = db_query($query, $start_time, $end_time);
?>Drupal verwendet Hilfsfunktionen um Abfragen auf Datenbanken auszuführen. Das bedeutet, das Du (meistens) SQL Anweisungen schreiben kannst, ohne Dir über die Verbindungen im Hintergrund Gedanken machen zu müssen.
Wir verwenden db_fetch_object() um die einzelnen Einträge zu betrachten:
<?php
// content variable that will be returned for display
$block_content = '';
while ($links = db_fetch_object($queryResult)) {
$block_content .= l($links->title, 'node/'. $links->nid) .'<br />';
}
// check to see if there was any content before setting up
// the block
if ($block_content == '') {
/* No content from a week ago. If we return nothing, the block
* doesn't show, which is what we want. */
return;
}
// set up the block
$block['subject'] = 'On This Date';
$block['content'] = $block_content;
return $block;
}
?>Beachte, dass die aktuelle URL in die Funktion l() eingebunden ist. l() generiert <a href="link"> Links, in den die URL auf die URL der Installation angepasst wird. Je nachdem, ob clean-urls aktiviert sind oder nicht, werden so URLs wie <a rel="nofollow" href="/node/2">http://(sitename)/node/2</a> oder <a rel="nofollow" href="/?q=node/2">http://(sitename)/?q=node/2</a> erzeugt.
Wir geben ebenfalls ein Array zurück, in dem die Element 'subject' und 'content' enthalten sind. Dies erwartet Drupal von einer Block Funktion. Solltest Du diese beiden Parameter nicht zurückgeben, wird der Block nicht richtig angezeigt.
Du wirst auch feststellen, dass es eine schlechte Angewohnheit ist, Inhalt und Layout zu kombinieren. Wenn Du ein Modul schreibst, das von anderen Leuten verwendet werden soll, möchtest Du sicherlich einen einfachen Weg zur Verfügung stellen, das Layout des Inhalts zu verändern (auch für Nicht-Entwickler). Eine einfache Möglichkeit dies zu tun, wäre beispielsweise ein Klassenattribut für den erzeugten Link, oder den HTML-Quelltext mit einem zusätzlichen <div (inklusive einer speziellen CSS-Klasse) zu umgeben. Wir ignorieren diese Hinweis fürs Erste, jedoch solltest Du unbedingt darauf achten, wenn Du "richtige" Module schreibst.
Wenn wir das jetzt alles zusammenfügen, sieht unsere Block Funktion derzeit so aus:
<?php
function onthisdate_block($op='list', $delta=0) {
// listing of blocks, such as on the admin/block page
if ($op == "list") {
$block[0]["info"] = t("On This Date");
return $block;
} else if ($op == 'view') {
// our block content
// content variable that will be returned for display
$block_content = '';
// Get today's date
$today = getdate();
// calculate midnight one week ago
$start_time = mktime(0, 0, 0,$today['mon'],
($today['mday'] - 7), $today['year']);
// we want items that occur only on the day in question, so
//calculate 1 day
$end_time = $start_time + 86400;
// 60 * 60 * 24 = 86400 seconds in a day
$query = "SELECT nid, title, created FROM " .
"{node} WHERE created >= '%d' " .
" AND created <= '%d'";
$queryResult = db_query($query, $start_time, $end_time);
while ($links = db_fetch_object($queryResult)) {
$block_content .= l($links->title, 'node/'.$links->nid) . '<br />';
}
// check to see if there was any content before setting up the block
if ($block_content == '') {
// no content from a week ago, return nothing.
return;
}
// set up the block
$block['subject'] = 'On This Date';
$block['content'] = $block_content;
return $block;
}
}
?>Unser Modul ist jetzt einsatzbereit - wir können es installieren, aktivieren und testen.
Siehe auch
- Anmelden oder Registrieren um Kommentare zu schreiben
Neue Kommentare
vor 2 Tagen 10 Stunden
vor 3 Tagen 5 Stunden
vor 3 Tagen 8 Stunden
vor 3 Tagen 11 Stunden
vor 4 Tagen 12 Stunden
vor 4 Tagen 12 Stunden
vor 5 Tagen 14 Stunden
vor 5 Tagen 19 Stunden
vor 6 Tagen 9 Stunden
vor 6 Tagen 13 Stunden