Inhalte im Code anlegen und aktualisieren #

Diese Seite ist für Anwendungsentwickler, die Inhalte aus Code schreiben: Importe, Synchronisierungen, Formulare, die Objekte anlegen, Migrationen. eZContentFunctions des Kernels (kernel/classes/ezcontentfunctions.php) legt in einem Aufruf an und veröffentlicht, mit derselben Operation (und denselben Triggern) wie der Editor.

Inhalt #

1. Anlegen und veröffentlichen
2. Aktualisieren
3. Werte für jeden Datentyp
4. Idempotente Importe mit Remote-IDs
5. Verschieben, verbergen, entfernen
6. Große Operationen

Anlegen und veröffentlichen #

$object = eZContentFunctions::createAndPublishObject( array(
    'creator_id'       => $userID,
    'class_identifier' => 'article',
    'parent_node_id'   => $parentNodeID,
    'remote_id'        => 'feed-item-' . $externalID,
    'attributes'       => array(
        'title' => 'A new article',
        'intro' => $introXml,
        'body'  => $bodyXml ) ) );

if ( !$object instanceof eZContentObject )
    throw new RuntimeException( 'Could not create the article' );

Attributwerte werden in ihrer fromString()-Form angegeben. Das Veröffentlichen führt die Operation content/publish aus, also laufen auch die Workflows an ihren Triggern, und Caches sowie der Suchindex werden aktualisiert.

Aktualisieren #

eZContentFunctions::updateAndPublishObject( $object, array(
    'attributes' => array( 'title' => 'A better title' ) ) );

Eine neue Version wird angelegt und veröffentlicht; die vorherige wird archiviert, wie bei einer Bearbeitung durch die Redaktion.

Werte für jeden Datentyp #

Das genaue Format steht jeweils in fromString() der Datentyp-Klasse in kernel/classes/datatypes/<name>/; lesen Sie es, bevor Sie einen Datentyp zum ersten Mal importieren.

Idempotente Importe mit Remote-IDs #

Geben Sie importierten Objekten eine Remote-ID, die aus der ID der Quelle gebildet wird. Aktualisieren Sie beim nächsten Lauf, statt neu anzulegen:

$remoteID = 'feed-item-' . $externalID;
$existing = eZContentObject::fetchByRemoteID( $remoteID );
if ( $existing )
    eZContentFunctions::updateAndPublishObject( $existing, array( 'attributes' => $attributes ) );
else
    eZContentFunctions::createAndPublishObject( array( 'remote_id' => $remoteID ) + $params );

Ein zweimal ausgeführter Import darf keine Duplikate anlegen.

Verschieben, verbergen, entfernen #

Verwenden Sie die Operationen des Kernels statt SQL: eZContentObjectTreeNodeOperations::move(), eZContentOperationCollection zum Verbergen und Einblenden, eZContentObjectTreeNode::removeSubtrees() zum Entfernen (in den Papierkorb oder nicht). Sie halten URL-Aliasse, Caches und den Suchindex korrekt.

Große Operationen #

Tausende Objekte gehören in einen Hintergrundprozess: einen Befehl, der aus Cron läuft, einen Job der Warteschlange (Warteschlangen mit expqueue) oder die Inhalts-Jobs des Kernels für das Entfernen, Kopieren und Verschieben großer Teilbäume (Inhalts-Jobs). Committen Sie in Stapeln, leeren Sie zwischen den Stapeln mit eZContentObject::clearCache() und protokollieren Sie den Fortschritt.

Verwandte Seiten #

• Die Content-API in PHP
• CLI-Skripte mit eZScript
• Workflows, Trigger und Ereignisse
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.