JS Ultimate Photos Dokumentation

Inhaltsverzeichnis:

Allgemein
Systemvoraussetzungen / Kompatibilität
Installation
Konfiguration Modul
Konfiguration Plugin Konfiguration Komponente

Allgemein:

Die JS Ultimate Photos Erweiterungen bestehen aus einer Kombination von Modul und Plugin und ermöglichen eine äußerst flexible und performante Anzeige von Bildern aus der Community Erweiterung Jomsocial an einer Modulposition.

Für die Anzeige der Bilder gibt es folgende Auswahlmöglichkeiten, die auch untereinander kombiniert werden können

Gruppenkategorien
Gruppen
Alben

Darüber hinaus kann ausgewählt werden ob nur Bilder aus Gruppen oder nur Bildern von Benutzern oder aber Bilder aus beiden Bereichen angezeigt werden. Die Privatsphäreneinstellungen können auf Wunsch auch berücksichtigt werden (Privat oder Öffentlich).

Systemvoraussetzungen / Kompatibilität

Joomla 2.5
PHP 5.2.17 oder 5.3.x
MySQL 5.x oder höher
Jomsocial 2.4 oder 2.6

Installation

Die Installation erfolgt über den Joomla Installer (Erweiterungen => Erweiterungen), das Modul und das Plugin sind zwingend erforderlich. Die Komponente ist optional und muss nur installiert werden, wenn bereits Fotos in Jomsocial vorhanden sind, die zur Anzeige im Modul optimiert werden müssen.

Update

Sie können die neuen Versionen der Komponente, des Moduls oder des Plugins einfach mit dem Joomla Installer über die alte Version installieren. Die Dateien werden automatisch aktualisiert und die Konfigurationseinstellungen bleiben erhalten. Sie müssen die alte Version NICHT deinstallieren.

Konfiguration Modul

Basisoptionen

Kategorien
Hier können Sie die Gruppenkategorie(n) auswählen aus denen die Bilder angezeigt werden sollen. Mehrfachauswahl ist möglich

Typ:
Hier können Sie auswählen ob die Bilder aller Alben angezeigt werden sollen oder ob nur Bilder aus Benutzeralben oder nur Bilder aus Gruppenalben angezeigt werden sollen.

Gruppen
Hier können Sie auswählen aus welchen Gruppenalben die Bilder angezeigt werden sollen. Mehrfachauswahl möglich

Alben
Hier können Sie auswählen aus welchen Benutzeralben die Bilder angezeigt werden sollen. Mehrfachauswahl möglich.

Private Bilder
Hier können Sie auswählen ob Sie private Bilder anzeigen wollen oder nicht. Private Bilder sind alle Bilder deren Privatsphäreneinstellungen nicht auf „Öffentlich" gesetzt sind.

Layout

Anzahl Bilder
Hier können Sie festlegen, wie viele Bilder im Modul angezeigt werden sollen

Reihenfolge
Hier können Sie die Reihenfolge der Bildanzeige im Modul festlegen. Zur Auswahl stehen „Zugriff", „Datum" und „Zufällig"

Bildanzeige
Hier können Sie auswählen ob nach Klick auf die Bilder ein Funktion ausgeführt wird oder nicht. Sie können auswählen ob Sie die Bilder in „Jomsocial" aufrufen wollen, ob die Bilder in einem „Modal" Fenster angezeigt werden oder ob Sie keine Verlinkung der Bilder wünschen.

Tooltip
Hier können Sie auswählen ob ein Tooltip angezeigt werden soll, wenn Sie den Mauszeiger auf das Bild bewegen. Der Tooltip wird im Jomsocial typischen Style angezeigt und enthält neben dem Bildnamen noch den Autor des Bildes

Aufrufe anzeigen
Hier können Sie auswählen, ob die Anzahl der Aufrufe unterhalb des Fotos angezeigt werden soll.

Autor anzeigen
Hier können Sie auswählen, ob der Autor des Bildes (Uploader) unterhalb des Fotos angezeigt werden soll.

„Alle anzeigen" – Link
Hier können Sie auswählen, ob ein Link zu den Fotos innerhalb von Jomsocial unterhalb des Fotos angezeigt werden soll

Style

Breite
Hier können Sie die Breite der Bilder bei der Anzeige im Modul festlegen. ACHTUNG: Wenn der Wert hier von der Angabe „Breite" im Plugin abweicht werden die Fotos im Modul skaliert! Das kann zu Qualitätseinbußen führen und verbraucht mehr Serverleistung.

Innenabstand
Hier können Sie einen Innenabstand des Bildes zum Rand des Moduls festlegen. Standard ist 0

Hintergrundfarbe
Hier können Sie eine Hintergrundfarbe für das Modul festlegen. Standard ist transparent

Rahmen
Hier können Sie einen Rahmen für das Bild festlegen. Standard ist medium none

Konfiguration Plugin

Breite
Hier können Sie festlegen in welcher Breite die Bilder beim Upload oder bei der Umwandlung mit der Komponente erstellt werden sollen. Es muss entweder die Breite oder die Höhe eingegeben werden. Wenn beide Eingabefelder befüllt sind greift die Breite vorrangig . So ist gewährleistet, dass es zu keinen Bildverzerrungen kommt.

Höhe
Hier können Sie festlegen in welcher Höhe die Bilder beim Upload oder bei der Umwandlung mit der Komponente erstellt werden sollen. Es muss entweder die Breite oder die Höhe eingegeben werden. Wenn beide Eingabefelder befüllt sind greift die Breite vorrangig . So ist gewährleistet, dass es zu keinen Bildverzerrungen kommt.

Qualität
Hier können Sie festlegen in welcher Qualität die Bilder beim Upload oder bei der Umwandlung mit der Komponente erstellt werden sollen.

Log
Hier können Sie festlegen ob für die Erstellung der Bilder eine Logdatei erzeugt werden soll. Mit Hilfe dieser Logdatei können Sie etwaige Fehler bei der Erstellung der Bilder leichter rausfinden. Die Logdatei finden Sie in dem Verzeichnis, dass Sie in der Joomla Konfiguration festgelegt haben. Die Logdatei folgt folgender Namenskonvention: com_jup.YYYY-MM-TT.php

HINWEIS: Bei Seiten mit einem großen Bildaufkommen ist zu empfehlen das loggen zu deaktivieren bzw. nur zur Fehlersuche zu nutzen, da die Größe der Logfiles sonst sehr schnell sehr stark anwachsen kann.

Konfiguration Komponente

Die Komponente kann optional installiert werden und ist dafür da, um Vorschaubilder in der gewünschten Größe aus den bereits vorhandenen Fotos in Jomsocial zu erstellen, diese zu löschen (um sie ggf. danach mit anderen Abmessungen erneut zu erstellen) und zu prüfen ob für alle Vorschaubilder auch Bilder in Jomsocial existieren und umgekehrt.

Vorschaubilder erzeugen
Hier können Sie festlegen bei welchem Bild die Erstellung starten (Start) und enden (Ziel) soll. Unter „Limit" legen Sie fest, wie viele Bilder bei einem Schritt verarbeitet werden sollen. Je mehr Bilder Sie wählen umso länger dauert die Verarbeitung je Schritt und umso höher ist die Wahrscheinlichkeit, dass es zu einem Serverfehler wegen fehlender Ressourcen kommt. Wenn Fehler auftreten, sollten Sie zuerst das Limit reduzieren, dies behebt häufig das Problem.

HINWEIS: Bei einer großen Anzahl an Fotos kann dieser Vorgang mehrere Minuten dauern. Die Dauer dieses Vorgangs ist auch abhängig von der Rechenleistung Ihres Servers oder Hosting Pakets. Während die Bilderstellung läuft dürfen Sie die Seite nicht verlassen!

Vorschaubilder löschen
Ein Klick auf diesen Button löscht ALLE vorhandenen Vorschaubilder für JS Ultimate Photos. Die Bilder können jederzeit über den Button „Vorschaubilder erzeugen" erneut erstellt werden.

HINWEIS: Es werden KEINE Bilder in Jomsocial selbst gelöscht!

Bilder prüfen
Diese Funktion ist experimentell und listet alle Bilder aus Jomsocial der Jomsocial Datenbank auf, bei denen das Pendant im Dateisystem fehlt. Abweichungen werden als Delta dargestellt und Datenbankeinträgen können gelöscht werden, wenn die Bilder dazu fehlen.