Hiho,
wollte gerade die aktuelle Version 1.3 downloaden. Der Download scheint aber irgendwie... verbuggt zu […]
Schön, dass das nun endlich so einfach geht. Bisher musste man noch selbst das ganze an eine Funktion […]
Mit der Funktion api_edit() können Inhalte bearbeitet werden.
Die API muss zwingend verfügbar gemacht werden indem sie eingebunden wird. Wie das geht erfahren Sie hier.
Die grundlegende Syntax lautet folgenermaßen.
<?php
api_edit(
$data, # Inhalt
$file, # Datei
'edit', # Aktion
$container_id, # Container ID
$article_id, # Artikel ID
$publish, # Publikationseinstellung (1=ja; 0=nein)
$username, # API-Username
$password # API-Passwort
);
?>
$data muss ein Array sein. Es enthält die Felder und den entsprechenden Wert.
Beispiel:
Dieses Beispiel zeigt wie man die Felder title und textfeld befüllen würde.
<?php
$data['title'] = mysql_real_escape_string('Titel meines Artikels');
$data['textfeld'] = mysql_real_escape_string('Ich bin der Text.');
?>
Wenn $data leergelassen wird, wird kein Feld befüllt.
Wir empfehlen dringend die Daten mit der Funktion mysql_real_escape_string() zu sichern bevor sie ins System geschrieben werden.
$file muss ebenfalls ein Array sein und nur befüllt werden, wenn man eine Datei hochladen will.
Beispiel:
Das Feld uploadfeld wird mit dem Inhalt der hochgeladenen Datei datei befüllt.
<?php
$file['uploadfeld'] = $_FILES['datei'];
?>
Die Aktion muss den Wert edit enthalten. Dies ist erforderlich, weil die Funktion api_edit() auch zur Erstellung von Inhalten verwendet werden kann. Dann wäre als Wert news erforderlich.
$container_id muss die Container-ID angeben in die der Inhalt gespeichert werden soll.
$article_id ist die ID des Artikels in dem das Feld bearbeitet werden soll.
$publish regelt, ob der erzeugte Inhalt sofort publiziert wird oder erst noch publiziert werden muss.
$username und $passwort sind die Zugangsdaten eines Backend-Benutzers. Der Artikel bekommt diesen Benutzer als Ersteller zugewiesen. Wir empfehlen einen eigenen Benutzer für API-Operationen anzulegen. So kann später sehr einfach nachvollzogen werden wie der Artikel entstanden ist. Es sind auch verschiedene API-Benutzer möglich.
