Dokumentation

Mit unserem Plugin ImageSizer können Bilder auf einer Webseite ganz einfach und unkompliziert skaliert werden. Per Klick auf ein skaliertes Bild wird dieses vergrößert in einer Lightbox dargestellt. So ist es mit unserem Plugin beispielsweise möglich, ohne viel Aufwand, eine kleine Bildergalerie zu erstellen. Ist unser ImageSizer erst einmal in einem Joomla! System installiert wird er in jedem Beitrag aktiv, der kleiner skalierte Bilder aufweist.

In unserem Plugin stehen viele verschiedene Lightboxen mit unterschiedlichem Aussehen zur Verfügung. Seit Joomla! 3 haben wir unserem ImageSizer mehrere responsive Lightboxen hinzugefügt, damit sich die Bilder jeder Bildschirmauflösung und Größe optimal anpassen. Den ImageSizer bieten wir grundsätzlich in zwei Varianten an, kostenpflichtig und kostenlos. Das kostenpflichtige Plugin ist frei von einem Autoren-Link zu uns und bietet eine umfangreichere Auswahl an Lightboxen.

Installation

Laden Sie sich das Plugin auf unserer Webseite herunter. In Ihrem Download-Ordner sollte sich nun eine .zip-Datei befinden. Um das Plugin zu installieren, gehen Sie in den Administrationsbereich Ihrer Joomla! Webseite auf den Reiter System  (Installieren) Erweiterungen. Hier können Sie nun die ImageSizer .zip-Datei hochladen und installieren. Wenn alles funktioniert hat, finden Sie den ImageSizer unter System  (Verwalten) Plugins. Hier müssen Sie das Plugin dann letztendlich noch aktivieren.

Funktionen

Ist der ImageSizer aktiviert, werden alle skalierten Bilder mit einem Klick darauf in einer Lightbox dargestellt. Das Skalieren eines Bildes kann erreicht werden, indem es entweder im Beitrag kleiner gezogen wird, oder, indem das Bild eine feste Höhe oder Breite bekommen hat (width und height).

Einstellungen

Alle nötigen Einstellungen für den ImageSizer wurden bereits vorgenommen, dennoch gibt es einige zusätzliche Anpassungsmöglichkeiten in den Einstellungen. Dafür gehen Sie zu System  (Verwalten) Plugins  ImageSizer.

Basis-Optionen

Lightbox-Skript:
Hier kann man eine passende Lightbox für seine Webseite auswählen. Der ImageSizer bietet eine vielfältige Auswahl an Lightboxen. Dafür wählen Sie einfach eine aus und speichern die Einstellung. Die Bilder erscheinen dann in der ausgewählten Lightbox.

Bilder verkleinern
Das hochgeladene Bild wird direkt beim Upload verkleinert und gespeichert. Dies kann helfen, wenn Sie Bilder in hochauflößenden Formaten hochladen, dass diese direkt auf eine maximale Breite und Höhe minimiert werden.

Maximale Breite und Höhe
Hiermit wird angegeben, auf welche maximale Breite und Höhe das Bild nach dem hochladen gespeichert wird. Voraussetzung hierfür ist die Option "Bilder verkleinern" auf "Ja".

Qualität/Komprimierung (%)
Hier können Sie auswählen, welche Qualität Ihre Bilder haben sollen. In diesem Feld sind nur Werte zwischen 0 und 100 erlaubt.

Thumbs erstellen
An dieser Stelle können Sie einstellen ob Thumbs beim Upload automatisch erstellt werden sollen.
Thumbs sind kleine Bilder, welche für den Klick auf die Lightbox dargestellt werden. Sobald sich die Lightbox öffnet, wird Ihr Bild in Originalgröße angezeigt. Dies schont den Traffic beim ersten Laden Ihrer Webseite.

Thumb-Ordner
Hier können Sie einen Ordner angeben, in welchem alle generierten Thumbs gespeichert werden. Dieser wird separat, außerhalb des Images-Ordner erstellt. Im Joomla! Medienmanager können Sie trotz allem ebenfalls auf diesen Ordner zugreifen.

Thumb Breite/Höhe
Diese Option lässt die Breite und Höhe des zu generierenden Thumbs einstellen.

Bild verkleinert einfügen
Wenn diese Option auf "Ja" steht, werden im Editor die Bilder automatisch auf die Thumb-Größe verkleinert und eingefügt.

Plugin-Event
Dies ist eine Experten-Einstellung. Wir empfehlen diese nicht in Produktivumgebungen zu verändern.
Diese Option bestimmt, wann der ImageSizer aktiv werden soll bzw. in welchem Plugin-Event dieser ausgeführt werden soll.

Generierungsmodus
Dieser Modus konfiguriert, wie der Thumb generiert werden soll.

Lightbox nur über Klassen
Bei "Ja" werden nur Bilder mit der CSS-Klasse "lightbox" für eine Lightboxgenerierung berücksichtigt. Alle anderen Bilder werden ignoriert.

Thumbnails nur über Klassen
Bei "Ja" werden nur Bilder mit der CSS-Klasse "thumb" berücksichtigt.

WebP für Thumbs erstellen
Die Thumbs werden unabhängig von ihrem Ausgangsformat in WebP erstellt. WebP ist ein Bildformat welches die Bilder ohne Qualitätsverluste komprimiert.

WebP generieren
...

In WebP-Format umwandeln
Bei "Ja" werden hochgeladene Bilder automatisch in das WebP-Format umgewandelt und gespeichert.

Thumb-Ordner anzeigen
Hier können Sie den Thumb-Ordner im Medienmanager anzeigen lassen. Ist die Option auf "Nein" kann der Thumb-Ordner nicht im Joomla! Medienmanager angezeigt werden.

Mit TinyPNG optimieren
Hier werden alle Bilder über TinyPNG optimiert.
Hierfür ist eine Registrierung auf TinyPNG notwendig und ein API-Schlüssel. Diesen können Sie im Feld "TinyPNG-Key", welches bei der Auswahl "Ja" erscheint, eintragen.

Plugin-Funktionen

... TODO ...

Bspw: {imagesizer gallery="folder"} etc.

Zusatz-Parameter für Bilder

height - Definiert die Höhe eines Bildes in Pixel.
Beispiel: <img src="/images/bildname.webp" height="250" />

width - Definiert die Breite eines Bildes in Pixel.
Beispiel: <img src="/images/bildname.webp" width="250" />

style - Für CSS-Veränderungen aller Art.
Beispiel: <img src="/images/bildname.webp" style="border: 1px solid #000" />

class - Zur Auswahl von bestimmten Klassen.
Beispiel: <img src="/images/bildname.webp" class="beispiel" />

title - Gibt den Titel eines Bildes an.
Beispiel: <img src="/images/bildname.webp" title="Titel des Bildes" />

alt - Gibt die Beschreibung des Bildes an.
Beispiel: <img src="/images/bildname.webp" alt="Beschreibung des Bildes" />

Klassen-Funktionen

... TODO ...