Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Inhalte aus PHP anlegen, veröffentlichen und ändern

Inhalte auf dem unterstützten Weg anlegen, aktualisieren, verschieben, verbergen und entfernen - createAndPublishObject(), updateAndPublishObject() und die Knotenoperationen -, damit Workflows, Caches und die Suche im…

Download as PDF

Address: https://doc.exponential.earth/learninminutes/exphelp/viewer/help/extension-development/part-8-reference/content-functions-from-php.md

On this page

This page is a translation. Read the English original

Inhalte aus PHP anlegen, veröffentlichen und ändern

Teil 8, Referenz 18. Importer, Integrationen und manche Cronjobs legen Inhalte an oder ändern sie. Tun Sie das immer über die Funktionen des Kernels: Sie erzeugen Versionen, führen die Veröffentlichungsoperation aus (mit ihren Workflows und Triggern), leeren die View-Caches und aktualisieren den Suchindex. Direktes Schreiben in die Inhaltstabellen tut nichts davon und hinterlässt die Website in einem inkonsistenten Zustand.

Anlegen: eZContentFunctions::createAndPublishObject()

static function createAndPublishObject( $params, $notify = true )

kernel/classes/ezcontentfunctions.php. Die Parameter laut ihrer Dokumentation:

SchlüsselBedeutung
parent_node_idwohin das Objekt kommt
class_identifierdie Klasse, über ihren Bezeichner (die ID wird nicht akzeptiert)
creator_iddie Benutzerobjekt-ID des Erstellers; der aktuelle Benutzer, wenn nicht gesetzt
attributesAttributbezeichner => Wert, im Format von fromString() des Datentyps
remote_idoptional: Ihre eigene, stabile ID für das Objekt
section_idoptional
storage_diroptional: ein Verzeichnis für Dateiattribute, die per Dateiname angegeben werden

$notify = false veröffentlicht ohne Benachrichtigungsereignisse. Die Funktion gibt das veröffentlichte eZContentObject zurück oder false.

<?php
$params = array(
    'class_identifier' => 'folder',
    'parent_node_id' => 2,
    'remote_id' => 'myext-import-folder-42',
    'attributes' => array(
        'name' => 'Imported items',
        'short_name' => 'Imported',
    ),
);
$object = eZContentFunctions::createAndPublishObject( $params );
if ( !$object instanceof eZContentObject )
{
    eZDebug::writeError( 'Could not create the folder', __METHOD__ );
}

Werte sind Zeichenketten im fromString()-Format des jeweiligen Datentyps: einfacher Text für ezstring, 1/0 für ezboolean, ein Zeitstempel für Datumsangaben, ein Dateipfad für Bilder und Dateien und das gespeicherte XML für ezxmltext. Lesen Sie im Zweifel fromString() des Datentyps (Die eZDataType-API).

Verwenden Sie remote_id für alles, was Sie importieren: Der nächste Lauf findet das Objekt mit eZContentObject::fetchByRemoteID() und aktualisiert es, statt ein Duplikat anzulegen.

Aktualisieren: updateAndPublishObject()

public static function updateAndPublishObject( eZContentObject $object, array $params, $notify = true )

$params nimmt attributes (nur die zu ändernden) und optional remote_id, section_id und language auf. Die Funktion erzeugt eine neue Version, setzt die Attribute und veröffentlicht sie. Sie gibt true oder false zurück.

<?php
$object = eZContentObject::fetchByRemoteID( 'myext-import-folder-42' );
if ( $object instanceof eZContentObject )
{
    eZContentFunctions::updateAndPublishObject( $object, array( 'attributes' => array( 'short_name' => 'Imports' ) ) );
}

Verschieben, verbergen, entfernen

AufgabeAufruf
Einen Knoten verschiebeneZContentObjectTreeNodeOperations::move( $nodeID, $newParentNodeID )
Einen Teilbaum verbergen oder anzeigeneZContentObjectTreeNode::hideSubTree( $node ), unhideSubTree( $node )
Knoten entfernen (standardmäßig in den Papierkorb)eZContentObjectTreeNode::removeSubtrees( $deleteIDArray, $moveToTrash = true, $infoOnly = false )
Dasselbe über die Operationsschicht (mit Triggern)eZContentOperationCollection::moveNode(), removeNodes(), deleteObject(), changeHideStatus(), updateSection()

removeSubtrees( ..., $infoOnly = true ) meldet nur, was entfernt würde; verwenden Sie es für einen Probelauf.

Als welcher Benutzer

Inhalte werden als der aktuelle Benutzer angelegt. In einem CLI-Skript ist das der anonyme Benutzer, sofern Sie keinen anderen setzen; der anonyme Benutzer darf meist keine Inhalte anlegen. Führen Sie Importe als eigenen Benutzer aus, der genau die Rechte hat, die der Import braucht, und machen Sie diesen Benutzer im Skript zum aktuellen Benutzer, statt einen Administrator zu verwenden:

<?php
$user = eZUser::fetchByName( 'importer' );
if ( $user instanceof eZUser )
{
    eZUser::setCurrentlyLoggedInUser( $user, $user->attribute( 'contentobject_id' ) );
}

Aus einfachen Werten: expContentWriter (6.0.15)

expContentWriter (kernel/classes/contentwriter/expcontentwriter.php) schreibt dasselbe aus den Werten, die ein Mensch oder ein anderes System hat: Rich Text als HTML (umgewandelt vom Eingabeparser des Online Editors, Links und Einbettungen werden Relationen), Dateien als öffentliche http(s)-Adressen (heruntergeladen, nie von einem Serverpfad oder aus einem privaten Netz), jeden anderen Datentyp in seiner Form für fromString().

eZContentFunctionsexpContentWriter
AnlegencreateAndPublishObject( $params, $notify )create( array( 'parentNodeID', 'classIdentifier', 'languageLocale', 'attributes', 'remoteID', 'ownerID', 'sectionID' ) )
ÄndernupdateAndPublishObject( $object, $params, $notify )update( $object, $values, $languageCode )
Entfernen(die Knotenoperationen oben)remove( $object, $moveToTrash = false )
Rich Textdas gespeicherte XMLHTML
Dateienein Serverpfad, mit storage_direine öffentliche http(s)-Adresse, höchstens 50 MB
Unbekanntes Attributignoriertabgewiesen, bevor etwas geschrieben wird
Antwortdas Objekt oder false; true oder falsestatus (published, pending, invalid, failed), message, object, version
Ein Workflow hält die Versionnicht unterschiedenpending
Ohne Benachrichtigung veröffentlichen$notify = falsenicht angeboten

Beide veröffentlichen über die Operation content/publish und überlassen die Rechteprüfung dem Aufrufer. Beispiele: Inhalte aus PHP schreiben mit expContentWriter.

In Transaktionen und Schleifen

createAndPublishObject() verwaltet seine eigene Transaktion. In einer Schleife über viele Elemente:

  • leeren Sie ab und zu den Objekt-Cache im Speicher (eZContentObject::clearCache()), sonst wächst der Speicherverbrauch mit jedem Objekt;
  • geben Sie den Fortschritt mit eZScript::iterate() aus (eZScript und eZCLI);
  • bieten Sie ein --dry-run an, das meldet, was angelegt würde.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x