Schlüsselpunkte

• Entit?ten in Drupal sind eine leistungsstarke M?glichkeit, Daten zu organisieren, und k?nnen so angepasst werden, dass eine bestimmte Art von Informationen dargestellt wird. Dieses Tutorial zeigt, wie ein benutzerdefiniertes Entit?tstyp namens Projekt erstellt wird, das Attribute wie Titel, Beschreibung und Frist enth?lt.
• Um einen neuen Entit?tstyp zu erstellen, muss seine Schema -Definition deklariert werden, die eine Datenbanktabelle mit Entit?tsdaten generiert. Dieses Tutorial enth?lt ein Code -Beispiel zum Erstellen einer "Demo_Projects" -Tabelle mit vier Spalten (ID, Name, Beschreibung und Deadline).
• Entit?t -API -Modul muss auf Ihrer Website aktiviert und als Abh?ngigkeit von benutzerdefinierten Modulen festgelegt werden, die viele Funktionen für Entit?tsverarbeitungsfunktionen bieten, die Drupal -Kern fehlen. Dies beinhaltet das Erstellen neuer Entit?ten, das Speichern in der Datenbank und das Anzeigen.
• In diesem Tutorial wird auch erl?utert, wie die Methode "BuildContent () der Standard -Entit?tsapicontroller -Klasse überschreibt, um Ihre Entit?t anzuzeigen, und wie Sie eine Entit?tsliste über die Funktion entity_view () Helfer erstellen. Der zweite Teil des Tutorials führt das Erstellen einer Seite vor, um einzelne Projekteinheiten anzuzeigen, sie über die Benutzeroberfl?che auf Feldzust?nde zu bringen und sie den Ansichten für Abfragen und Listenanzeigen auszusetzen.

Drupal -Entit?ten sind eine gro?artige M?glichkeit, Daten zu organisieren. Wenn Sie mit Knoten, Klassifizierungsbegriffen, Kommentaren oder Benutzern vertraut sind, sollten Sie auch wissen, dass diese seit Drupal 7 Entit?ten sind. Ein weiterer wichtiger Aspekt an ihnen ist, dass sie über die Feld -API auf dem Feld geraten k?nnen. In diesem Tutorial werde ich Ihnen zeigen, wie Sie Ihren eigenen benutzerdefinierten Entit?tstyp definieren und damit beginnen. Warum m?chte jemand dies tun, anstatt Knoten zu verwenden? Denn w?hrend sie gro?artig sind, k?nnen Knoten manchmal überm??ig komplex sein. M?glicherweise ben?tigen Sie nicht viele Funktionen, wie z. B. überarbeitungen oder Kommentare.

In diesem Tutorial werden wir unseren eigenen benutzerdefinierten Entit?tstyp mit dem Namen "Projekt" definieren, um unsere einfachen Informationen zum Projekt (Titel, Beschreibung und Deadline) darzustellen. Wir werden dann ein wenig über die Verwendung dieser Art von Entit?t lernen.

Um weiter zu lernen, gehe ich davon aus, dass Sie wissen, wie man ein grundlegendes benutzerdefiniertes Modul schreibt (mein Modul hei?t Demo). Hier finden Sie hervorragende Tutorials zu diesem Thema. Schreiben Sie weiterhin die .Info -Datei und erstellen Sie eine leere .module- und .install -Datei. Ich habe auch ein Git -Repository eingerichtet, in dem Sie den gesamten Quellcode für dieses Tutorial erhalten k?nnen (ein Zweig für jeden Abschnitt, zwei Abschnitte werden ver?ffentlicht).

Zus?tzlich müssen Sie das Entity -API -Auftragsmodul auf Ihrer Website aktivieren und als Abh?ngigkeit für das benutzerdefinierte Modul festlegen. Das Entit?t -API -Modul ist im Umgang mit Entit?ten sehr leistungsf?hig, da es viele der Funktionen bietet, die dem Drupal -Kern fehlt.

Definieren Sie unseren eigenen Drupal -Entit?tstyp

Erstellen eines neuen Entit?tstyps zuerst erfordert die Definition der Schema -Definition. Das hei?t, schreiben Sie Code, mit dem die Entit?tsdatenbanktabelle generiert wird. In meiner Demo.install -Datei habe ich den folgenden Code:

/**
 * Implements hook_schema().
 */
function demo_schema() {

  $schema = array();

  $schema['demo_projects'] = array(
    'description' => 'The base table for the Project entity',
    'fields' => array(
      'id' => array(
        'description' => 'Primary key of the Project entity',
        'type' => 'serial',
        'unsigned' => TRUE,
        'not null' => TRUE,
      ),
      'name' => array(
        'description' => 'Project name.',
        'type' => 'varchar',
        'length' => 255,
        'not null' => FALSE,
      ),
      'description' => array(
        'description' => 'Project description.',
        'type' => 'text',
        'size' => 'big',
        'not null' => FALSE,
        'default' => NULL
      ),
      'deadline' => array(
        'description' => 'Project deadline.',
        'type' => 'int',
        'length' => 11,
        'not null' => FALSE,
      ),
    ),
    'primary key' => array('id'),
  );

  return $schema;
}

Dies ist eine einfache Implementierung von Hook_schema (). Es ist keine gro?e Sache.

Als n?chstes müssen wir Hook_entity_info () implementieren. Wir k?nnen viele Optionen in diesem Haken angeben, aber hier sind die grundlegendsten und erforderlichen Optionen (dies befindet sich in der Demo.Module -Datei):

/**
 * Implements hook_entity_info().
 */
function demo_entity_info() {

  $info = array();

  $info['project'] = array(
    'label' => t('Project'),
    'base table' => 'demo_projects',
    'entity keys' => array(
      'id' => 'id',
      'label' => 'name',
    ),
    'module' => 'demo',
    'entity class' => 'Entity',
    'controller class' => 'ProjectEntityController',
  );

  return $info;
}

Mit diesem Haken geben wir einen neuen Schlüssel im $ Info -Array zurück, der den Namen der Entit?tsmaschine darstellt. In diesem Array geben wir Optionen an (wir werden in diesem Tutorial weitere Optionen hinzufügen). Jetzt halten wir uns an die Verwendung von Tags (den lesbaren Namen des Entit?tstyps), die Basistabelle, die Entit?tsdaten speichert, die Entit?tsschlüssel, die als Attribute der Entit?tskennung fungieren, und des Moduls, das angibt, welches Modul den Entit?tstyp definiert. Der letzte ist nicht obligatorisch, wird aber empfohlen.

Auf diese Weise registrieren wir unseren eigenen grundlegenden Entit?tstyp mit Drupal. Aktivieren Sie das Modul zum ersten Mal, um zu testen, ob es funktioniert, und überprüfen Sie, ob die Tabelle in der Datenbank erstellt wurde. Füllen Sie es dann mit ein paar Zeilen, damit etwas zu verwenden ist:

INSERT INTO `demo_projects` (`id`, `name`, `description`, `deadline`)
VALUES
    (1, 'Summer House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501105),
    (2, 'Winter House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501132);

Verwenden Sie schlie?lich Hook_Menu (), um einen Pfad (für alle Pfade nur zum Testen) mit Drupal zu registrieren und Folgendes in seine Rückruffunktion einzufügen:

$projects = entity_load('project', array(1, 2));
dpm($projects);
return 'Some string';

Erstens verwenden wir die Funktion entity_load (), um Projektentit?ten mit den IDs 1 und 2 zu laden, und dann verwenden wir die Devel DPM () -Funktion Bildschirm überlegen. Vergessen Sie nicht, dass die Rückruffunktion der Seite etwas zurückgeben muss, sonst wird sie nicht erstellt.

Wenn Sie nun zu dieser Seite navigieren, werden Daten für 2 Entit?ten in der Datenbank in Krumo angezeigt.

Alternativ k?nnen Sie die EntityFieldQuery -Klasse verwenden, um neue Entit?ten basierend auf einer gewünschten Eigenschaft abzufragen (nicht nur ID). Weitere Informationen darüber, wie dies funktioniert, k?nnen Sie sich dieses SitePoint -Tutorial ansehen, mit denen Sie loslegen k?nnen.

Entit?tsklassen und Controller

Leider bietet der Drupal -Kern nicht zu viele Helferfunktionen, um Entit?ten zu verarbeiten (entity_load () ist fast eindeutig). Das Entit?t -API -Modul füllt diese Lücke jedoch.

Um seine Funktionalit?t zu verwenden, müssen wir die zuvor deklarierten Entit?tsinformationen ?ndern und die PHP -Klasse angeben, mit der die Entit?t verarbeitet werden kann. Jetzt werden wir dem Projekt Array, der in der Implementierung von Hook_entity_Info () getippt wurde, zwei weitere Schlüssel hinzufügen:

Der oben erw?hnte Code enth?lt bereits 'entity class' => 'Entity', 'controller class' => 'ProjectEntityController',

EntityAPICONTROLLER -Klasse (befindet sich im Modul entity.controller.inc) bietet einige angemessene Standardwerte für Verarbeitungsentit?ten. Es erweitert die Standard -Drupal -Kern -DrupaldeFaultEntityController -Klasse und ist für (unter anderem), die CRUD -Operationen durchführen, verantwortlich.

Beide Klassen k?nnen in Ihrem benutzerdefinierten Modul erweitert werden, um die Funktionalit?t anzupassen (z. B. Abfragen, Laden oder Anzeigen von Entit?ten). Wir werden sehen, wie das sp?ter geht.

Aber zuerst m?chte ich Ihnen zeigen, wie Sie eine neue Entit?t retten k?nnen. Derzeit gibt es 2 Datens?tze in meiner Datenbank mit IDS 1 und 2. Ich m?chte den Code, den wir in der obigen Testseite geschrieben haben, anpassen, um eine neue Entit?t mit ID 3 ohne sie zu erstellen. Es k?nnte so aussehen:

/**
 * Implements hook_schema().
 */
function demo_schema() {

  $schema = array();

  $schema['demo_projects'] = array(
    'description' => 'The base table for the Project entity',
    'fields' => array(
      'id' => array(
        'description' => 'Primary key of the Project entity',
        'type' => 'serial',
        'unsigned' => TRUE,
        'not null' => TRUE,
      ),
      'name' => array(
        'description' => 'Project name.',
        'type' => 'varchar',
        'length' => 255,
        'not null' => FALSE,
      ),
      'description' => array(
        'description' => 'Project description.',
        'type' => 'text',
        'size' => 'big',
        'not null' => FALSE,
        'default' => NULL
      ),
      'deadline' => array(
        'description' => 'Project deadline.',
        'type' => 'int',
        'length' => 11,
        'not null' => FALSE,
      ),
    ),
    'primary key' => array('id'),
  );

  return $schema;
}

Wie Sie sehen, versuchen wir jetzt, 3 Projektentit?ten zu laden und zu überprüfen, ob die dritte Entit?t existiert. Wenn es nicht vorhanden ist, verwenden wir die von der Entity -API bereitgestellte Helferfunktion entity_create (), setzen Sie die Eigenschaft auf einen zuf?lligen Wert und verwenden Sie dann die SAVE () -Methode auf der Entit?t, um in der Datenbank zu bestehen. Diese Methode wird von der Entity -Klasse bereitgestellt, und ihre Aufgabe besteht darin, die oben definierte Save () -Methode in der oben definierten Controller -Klasse aufzurufen. Diese Methode führt die Logik aus, die erforderlich ist, um die Entit?t zu bestehen. Aber all dies geschieht hinter den Kulissen, wir müssen uns keine Sorgen machen.

Wenn Sie die Seite neu laden, sollten Sie nur die 2 Projekteinheiten zurückgeben. Wenn Sie jedoch beim zweiten Mal 3 haben sollten.

decken Sie die Entit?tsklasse

ab

Das Letzte, was ich Ihnen in diesem Teil dieses Tutorials zeigen m?chte, ist, wie Sie Ihre Entit?t anzeigen. Dazu bleiben wir an der Seiten -Rückruffunktion, die wir verwendet haben, und machen sie eine echte Liste.

Zun?chst müssen wir die Methode "BuildContent () der Standard -Entit?tsapicontroller -Klasse überschreiben. Der Grund dafür ist, dass der Controller keine Annahmen über unsere Daten treffen kann. Daher müssen wir einige Informationen darüber angeben, wie sie angezeigt werden. Lassen Sie uns zun?chst die Controller -Klasse deklarieren, die die vorherige Klasse erweitert:

/**
 * Implements hook_entity_info().
 */
function demo_entity_info() {

  $info = array();

  $info['project'] = array(
    'label' => t('Project'),
    'base table' => 'demo_projects',
    'entity keys' => array(
      'id' => 'id',
      'label' => 'name',
    ),
    'module' => 'demo',
    'entity class' => 'Entity',
    'controller class' => 'ProjectEntityController',
  );

  return $info;
}

Ich habe den Klassennamen ProjectEntityController ausgew?hlt. Vergiss nicht.

In dieser Klasse k?nnen wir den Methodennamen aus der Originalklasse kopieren und damit zurückgeben, was seine übergeordnete Klasse zurückgibt:

In dieser Klasse k?nnen wir den Methodennamen aus der Originalklasse kopieren und damit zurückgeben, was seine übergeordnete Klasse zurückgibt. Wir haben dem Array im Grunde zwei neue Elemente hinzugefügt. Der erste wickelt die Beschreibung mit <div> ein und das zweite gibt das formatierte Datum zwischen Absatzetiketten aus. Dies ist das grundlegende Drupal -Thema. Wenn Sie nicht verstehen, was hier los ist, überprüfen Sie es bitte. Sie werden jedoch den fehlenden Projektnamen bemerken. Drupal rendert es automatisch, da wir es als Tag in der von Hook_entity_info () implementierten Entit?tstaste angeben. Der letzte Schritt ist, zu unserer Seiten -Rückruffunktion zu gehen und unsere Entit?t anzuzeigen. Ein schneller Weg (nur zu Demonstrationszwecken):

INSERT INTO `demo_projects` (`id`, `name`, `description`, `deadline`)
VALUES
    (1, 'Summer House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501105),
    (2, 'Winter House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501132);

Wie zuvor laden wir die Entit?t zuerst mit der entsprechenden ID. Wir führen sie dann über die Funktion entity_view () Helfer aus, die schlie?lich die von uns überschriebene BuildContent () -Methode aufruft. Diese Funktion gibt eine Liste der gerenderten Arrays für jede Entit?t zurück. Wir rendern jeweils und speichern das Ergebnis im $ Output -Array, verkettet es dann und geben es zurück.

Sie k?nnen die Seite aktualisieren und sollten eine Liste aller von Ihnen geladenen Entit?ten sehen. Stellen Sie sicher, dass der Cache so gel?scht wird, damit die ?nderungen sichtbar sind.

Schlussfolgerung

In diesem Tutorial lernen wir über Entit?ten in Drupal, indem wir unsere eigenen Entit?tstypen im Code definieren. Wir haben gelernt, wie man Schema -Definitionen für die Daten schreibt, die sie repr?sentieren, und wie sie sie bei Drupal registrieren k?nnen. Anschlie?end sehen wir die Kraft, das Entit?t-API-Beitragsmodul zu verwenden, um Entit?ten auf objektorientierte Weise zu verarbeiten.

Im zweiten Teil dieses Tutorials werden wir drei Hauptaspekte betrachten. Erstens erstellen wir einige Seiten, um einzelne Projekteinheiten anzuzeigen und die Verwaltungsschnittstelle für die Verwaltung von Projekten zu starten. Zweitens werden wir es über die Benutzeroberfl?che auf dem Feld machen. Drittens werden wir es den Ansichten aussetzen, damit wir einige geeignete Abfragen und Listenanzeigen durchführen k?nnen. bleiben Sie dran!

FAQs zum Aufbau kundenspezifischer Einheiten in Drupal

Was sind die Voraussetzungen für die Erstellung einer Drupal -benutzerdefinierten Einheit?

Bevor Sie anfangen, Drupal -benutzerdefinierte Entit?ten zu erstellen, müssen Sie ein grundlegendes Verst?ndnis der Entit?t -API von Drupal haben. Sie sollten auch mit den Konzepten von PHP und objektorientierter Programmierung vertraut sein. Darüber hinaus sollten Sie eine Drupal -Entwicklungsumgebung einrichten sollen. Dies beinhaltet die Installation und Konfiguration von Drupal auf einem lokalen Computer oder Server.

Wie erstelle ich eine benutzerdefinierte Inhaltseinheit mit einem Bündel in Drupal?

Erstellen einer benutzerdefinierten Inhaltseinheit mit einem Bundle in Drupal umfasst mehrere Schritte. Zun?chst müssen Sie Ihre Entit?t und seine Eigenschaften in einem benutzerdefinierten Modul definieren. Dann müssen Sie ein Formular erstellen, um Ihre Entit?t hinzuzufügen und zu bearbeiten. Danach müssen Sie die Route für den Betrieb des Unternehmens definieren. Schlie?lich müssen Sie einen Ansichtserbauer erstellen, um Ihre Entit?t anzuzeigen.

Was ist der Unterschied zwischen Content -Entit?t und Konfigurationsentit?t in Drupal?

In Drupal sind Content -Entit?ten Inhaltsfragmente, die von Benutzern erstellt, bearbeitet und gel?scht werden k?nnen. Beispiele sind Knoten, Benutzer und Kommentare. Andererseits ist eine Konfigurationsentit?t ein Konfigurationsfragment, das in einer Datenbank gespeichert ist und in Code exportiert werden kann. Beispiele sind Ansichten, Bildstile und Benutzerrollen.

Wie erstellt man Contententity -Typ in Drupal 8?

Erstellen eines Inhaltsentit?tstyps in Drupal 8 beinhaltet die Definition Ihrer Entit?t und deren Eigenschaften in einem benutzerdefinierten Modul. Sie müssen au?erdem ein Formular erstellen, um Ihre Entit?t hinzuzufügen und zu bearbeiten, die Route für Entit?tsvorg?nge zu definieren und einen Ansichtsbauer zu erstellen, um Ihre Entit?t anzuzeigen.

Kann ich mit dem Entit?t -API -Modul benutzerdefinierte Entit?ten in Drupal erstellen?

Ja, Sie k?nnen mithilfe des Entity -API -Moduls benutzerdefinierte Entit?ten in Drupal erstellen. Dieses Modul bietet eine einheitliche M?glichkeit, Entit?ten und deren Eigenschaften zu bew?ltigen. Es bietet auch APIs für die Durchführung von Vorg?ngen bei Unternehmen wie Erstellung, Lesen, Aktualisierung und L?schen.

Was sind die Vorteile der Schaffung von Drupal -Unternehmen?

Erstellen von Drupal -benutzerdefinierten Entit?ten k?nnen Sie Ihre eigenen Datenstrukturen und Gesch?ftslogik definieren. Dies kann Ihre Website effizienter und überschaubarer machen. Mit benutzerdefinierten Entit?ten k?nnen Sie auch die Entit?ts -API von Drupal nutzen, die leistungsstarke Werkzeuge für den Umgang mit Einheiten bietet.

Wie füge ich Felder zu benutzerdefinierten Einheiten in Drupal hinzu?

Um benutzerdefinierte Entit?ten in Drupal Felder hinzuzufügen, müssen Sie die Feld API verwenden. Dies beinhaltet die Definition Ihrer Felder in der Basisfelddefinitionsmethode des Entit?t. Sie k?nnen das Feld UI auch verwenden, um Entit?ten über die Drupal -Verwaltungsschnittstelle Felder hinzuzufügen.

Wie kann man benutzerdefinierte Entit?ten in Drupal anzeigen?

Um eine benutzerdefinierte Entit?t in Drupal anzuzeigen, müssen Sie einen Ansichtsbauer für Ihre Entit?t erstellen. Dies beinhaltet die Definition einer Klasse, die die EntityViewBuilder -Klasse erweitert und die Ansichtsmethode implementiert. Sie k?nnen das View -Modul auch verwenden, um benutzerdefinierte Ansichten von Entit?ten zu erstellen.

Wie erstelle ich ein Formular zum Hinzufügen und Bearbeiten von benutzerdefinierten Entit?ten in Drupal?

Um ein Formular in Drupal zum Hinzufügen und Bearbeiten benutzerdefinierter Entit?ten zu erstellen, müssen Sie eine Formklasse für Ihre Entit?t definieren. Dies beinhaltet die Erweiterung der Entityform -Klasse und die Implementierung von Formular, validieren und einreichen Methoden.

Wie l?sche ich eine benutzerdefinierte Entit?t in Drupal?

Um eine benutzerdefinierte Entit?t in Drupal zu l?schen, müssen Sie die L?schenmethode der Entit?t -API verwenden. Dies beinhaltet das Laden Ihrer Entit?t, das Aufrufen der L?schmethode und das Speichern Ihrer Entit?t. Sie k?nnen auch die Deletemultip -Methode der Entit?t -API verwenden, um mehrere Entit?ten gleichzeitig zu l?schen.

Das obige ist der detaillierte Inhalt vonErstellen Sie Ihre eigenen benutzerdefinierten Einheiten in Drupal - Setup. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!