Das “REST API Module” ist im Standard-Umfang der Gallery enthalten und bietet eine komfortable Möglichkeit, von außen mit der Gallery zu kommunizieren. Funktionen für das “Entgegennehmen” von hochgeladenen Dateien existieren bereits, so dass meine Aufgabe nun darin bestand, einen für mich nutzbaren Client zu schreiben, der die von mir benötigte Funktion des galleryadd-Skripts ablösen sollte.

Also schrieb ich in PHP ein Upload-Skript: gallery3-upload-1.00.txt (muss in .php umbenannt werden)

Es besteht aus zwei Funktionen, die zusammen arbeiten. Darunter befinden sich die Site-spezifische Konfiguration und der eigentliche Aufruf.

$galleryHost = "gallery.site";            // Gallery-URL
$galleryPort = 80;                        // HTTP-Port
$apiKey      = "xxx";                     // API-Key eines Gallery-Users
$itemID      = 1;                         // Album-ItemID

$importDir   = "/data/upload";    // Quell-Verzeichnis
$archiveDir  = "/data/archive";   // Archiv-Verzeichnis (optional)

processFiles($galleryHost, $galleryPort, $itemID,
        $apiKey, $importDir, $archiveDir);

Das Skript setzt voraus, dass die Gallery sich im Stammverzeichnis des Servers befindet und nicht als Unterordner (z.B. “/gallery/”). Falls jemand diese Erweiterung benötigt, möge er/sie sich bitte melden.

Die Album-ItemID habe ich kurzerhand direkt in der MySQL-Datenbank in der Tabelle “items” nachgesehen (Filter auf Datensätze mit “type” = “album”). Den API-Key kann man in der Administrationsoberfläche den User-Details entnehmen. Wichtig ist, dass der User des verwendeten API-Keys auch entsprechende Schreibrechte auf das Album besitzt.

Das Skript überträgt alle Dateien aus dem Ordner $importDir, es findet keine Filterung auf Dateitypen statt. Die Angabe von $archiveDir ist optional. Statt die hochgeladenen Bilder aus dem Ordner zu löschen, lege ich sie lieber in einem separaten Archiv ab. Ist diese Form des Backups nicht gewünscht, kann man $archiveDir auf NULL setzen. ACHTUNG: In diesem Fall muss man sich selbst darum kümmern, die abgearbeiteten Dateien aus dem $importDir zu entfernen!

Man kann diese PHP-Datei durch require/include zwar innerhalb einer anderen PHP-Anwendung verwenden, ich rufe sie stattdessen jedoch direkt über die Kommandozeile oder über einen Cronjob auf.

Kommandozeile:

/usr/bin/php /pfad/zum/skript/gallery3-upload.php

Cronjob (alle 10 Minuten):

*/10 * * * *    /usr/bin/php /skriptpfad/gallery3-upload.php > /dev/null 2>&1

Feedback ist herzlich willkommen.

Offensichtlich kann man als User seine kompletten Account-Daten paketieren lassen, um sie danach herunter zu laden. Dies bringt mehrere Vorteile mit sich. Zum Einen erhält man ganz bequem einen Überblick darüber, welche Informationen man eigentlich überhaupt mit anderen Usern teilt. Zum Anderen ist es ein bequemer Weg, einen Export aus Facebook durchzuführen, um die Daten anderweitig zu verwenden.

Zu den herunterladbaren Daten gehören u.a. Profilinformationen, Pinnwandeinträge, hochgeladene Fotos und Videos, Notizen, Freundeslisten, Nachrichten zu- und abgesagte Veranstaltungen und auch hinterlassene Kommentare.

Die Funktion zum Download findet man innerhalb der “Kontoeinstellungen“. Beim Punkt “Lade deine Informationen herunter” muss rechts daneben “mehr dazu” angewählt werden.

Der Bildschirminhalt wechselt dann und bietet dann die Schaltfläche “Herunterladen”. Es wird noch ein kurzer Hinweis gezeigt und nach einer weiteren Bestätigung beginnt im Hintergrund auf den Facebook-Servern das Einsammeln und Packen aller Account-Daten. Dies kann einige Zeit dauern (bei mir ca. 2,5 Stunden), daher sendet Facebook bei Fertigstellung eine E-Mail an den Account-Inhaber. Darin befindet sich ein Link, der endlich zur Download-Seite auf facebook.com führt. Nach Eingabe des eigenen Passworts wird die Schaltfläche “Jetzt herunterladen” sichtbar und der Download kann beginnen.

Das Ergebnis ist eine ZIP-Datei, die quasi eine vollständige Mini-Homepage beinhaltet. Hat man sie lokal ausgepackt, kann man die Datei “index.html” mit einem Webbrowser öffnen und bekommt dann alle Profil-Infos in verschiedene Sektionen unterteilt zu sehen. Ganz schick gemacht, wie ich finde.

Es ist derzeit bei Facebook nur möglich, alle Informationen als Ganzes herunter zu laden. Wer nur gelegentlich ein Backup seiner hochgeladenen Facebook-Bilder anfertigen möchte, kann alternativ auch http://facebook-backup.de/ verwenden. Das geht wesentlich schneller und ignoriert alle anderen zur Verfügung stehenden Daten.