01. Wir beginnen

In diesem Handbuch werden wir beginnen, indem wir ein Block-Modul erstellen, das eine Liste von Links zu Inhalten (beispielsweise Blog-Einträge oder Diskussionen in Foren, die vor einer Woche erstellt wurden) erstellt. Das komplette Handbuch wird zeigen, wie man den Inhalt eines Blocks erstellt, Links erstellt und Informationen von nodes in Drupal bezieht.

Beginne Dein Modul, indem Du ein Verzeichnis in Deiner Drupal-Installation unter dem Pfad sites/all/modules/onthisdate anlegst. Es kann sein, dass Du das Verzeichnis sites/all/modules zuerst anlegen musst (falls es nicht schon vorher angelegt wurde). Erstelle eine PHP Datei mit untenstehendem Inhalt und speicher sie als onthisdate.module im gerade erstellten Verzeichnis sites/all/modules/onthisdate. Seit Drupal 6.x ist sites/all/modules der bevorzugte (und empfohlene) Ort für Nicht-Kern-Module (so wie sites/all/themes für Nicht-Kern-Themes), da so alle seitenspezifischen Dateien in das sites Verzeichnis gelegt werden. Dies macht es um ein Vielfaches einfacher, die Kern-Dateien und Module zu aktualisieren; ohne dass Deine Anpassungen verloren gehen. Die Modulnamen (und hook-Deklarationen) müssen übrigens kleingeschrieben werden!

Das Modul ist noch nicht einsatzbereit, da es auch noch nicht aktiviert wurde. Die Aktivierung des Moduls werden wir später im Handbuch vornehmen.

Programmierrichtlinien (coding standards)

Wie in den Coding standards beschrieben, entferne den ?> Tag in der Moduldatei und benutze die Langversion des PHP-Starttags (<?php). (Die Beispiele im Handbuch zeigen den schliessenden Tag nur wegen der Formatierung!) Der Text $Id$ hilft bei der Nachverfolgung der Revisionen und des Datums der Datei, solltest Du sie in das CVS von Drupal übergeben.

Alle Funktionen in Deinem Modul, die von Drupal verwendet werden sollen, werden {Modulname}_{hook} genannt, wobei "hook" ein vorderfinierter Suffix ist. Drupal ruft diese Funktionen auf, um spezifische Daten zu bekommen. Die Verwendung dieser Namen bedeutet also, dass Drupal "weiss", wo es nach den Daten schauen muss. Hooks werden später im Handbuch behandelt.