Plugin Diapo (de)

Galerie / Diashow per SPIP-Tag <diapoXX> einfügen

Durch dieses Plugin wird die Möglichkeit geschaffen, mit dem SPIP-Tag <diapoXX> eine Galerie/Diashow einzufügen, wobei die Bilder hierfür dem Artikel XX entstammen.

Das Ziel :

Als ich für eine Website eine Fotogalerie benötigte, probierte ich verschiedene Möglichkeiten aus, zum Beispiel ein eigens geschriebenes Skelett.
Letztendlich habe ich mich dann aber für ein „Modell“ (zum Begriff Modell siehe hier) entschieden, um die größtmögliche Flexibilität zu erreichen.

Beispielseiten :
Pays Bourgogne-Nivernaise (Version 1 des Plugins)
aktueller ist diese Testseite

Das Plugin erlaubt eine persönliche Anpassung in Design und Funktionalität.

Installation

Es genügt, den hier herunterzuladenden ZIP-Ordner in das Verzeichnis /plugins (muss nötigenfalls erstellt werden) der betreffenden Website per ftp hochzuladen. Danach ist das Plugin zu aktivieren (im Redaktionssystem : Konfiguration – Plugin-Verwaltung).

Anwendung

Der SPIP-Tag <diapoXX> eine fügt eine Galerie/Diashow ein. Die Bilder hierfür können in einem beliebigen Artikel XX hochgeladen sein.
Es ist möglich, mehrere Galerien/Shows pro Seite einzufügen.

Die Art der Anzeige kann voreingestellt werden :
-  <diapoXX|diapo> (entspricht <diapoXX>) für eine Diashow
-  <diapoXX|pause> für eine Diashow auf „Pause“
-  <diapoXX|left> für eine Galerie mit Vorschaubildern links
-  <diapoXX|right> für eine Galerie mit Vorschaubildern rechts
-  <diapoXX|center> für eine Galerie mit Vorschaubildern oben.

Je nachdem, welche Option man auswählt, wird die Breite des angezeigten Bildes verschieden berechnet : standardmäßig eine kleinere Anzeige („petite image“) für |left und |right, eine größere („grande image“) für die übrigen Fälle.

Das Plugin arbeitet mit dem JavaScript-Framework JQuery. Dies benutzt AJAX-Anwendungen für die pagination und das Laden der Bilder.
Notfalls funktioniert das Plugin aber auch ohne Javascript.

Anpassungen

Verschiedene Anpassungs-Parameter können in der Datei mes_fonctions.php definiert werden :

-  Geschwindigkeit der Diashow (in Millisekunden ; Standardwert 8000ms) :

//temps de pause 5 secondes :
$GLOBALS['diapo_temps']=5000;

-  Anzahl der Vorschaubilder pro „pagination“ (Standardwert 8) :

//10 vignettes par page :
$GLOBALS['diapo_vignettes']=10;

-  Die maximale Breite des großen Bildes (in Pixeln ; Standardwert 500) :

//largeur de la grande image  560px maxi :
$GLOBALS['diapo_grand']=560;

-  Die maximale Breite des kleinen Bildes (in Pixeln) :

$GLOBALS['diapo_petit']=350;

Das Stylesheet (diapo.css.html) versieht die Bilder mit einem 2 px breiten Rand, so dass sie 4 px mehr Platz beanspruchen.

-  Die Größe (Höhe und Breite) der Vorschaubilder (falls nicht definiert, wird die Größe automatisch berechnet, so dass die Vorschaubilder in einer Zeile über das angezeigte Bild passen) :

//largeur et hauteur maxi des vignettes 80px :
$GLOBALS['diapo_vignette']=80;

Für die Bilder (große und kleine Anzeige) gibt es standardmäßig keine Höhenbeschränkung.
Falls dennoch eine Höhenbeschränkung vorgenommen werden soll :

$GLOBALS['diapo_grand_h']=4000;
$GLOBALS['diapo_petit_h']=300;

Die Vorschaubilder hingegen werden in Breite und Höhe reduziert.
Änderung der Höhenreduzierung der Vorschaubilder :

$GLOBALS['diapo_vignette_h']=50;


Wer sich sein eigenes Modell erstellen will, das von
/plugins/diapo/modeles/diapo.html
abweicht, kann dies unter
/squelettes/modeles/diapo.html ablegen, das Standardmodell wird dann ignoriert.
Achtung : Beim Erstellen eines eigenen Modells unbedingt die Kommentare im Standardmodell beachten ! Es gibt ein paar Tricks, die beachtet werden müssen (gekennzeichnet mit „attention bidouille“).

Aber auch schon durch die bloße Veränderung des Stylesheets und der pagination* kann einiges erreicht werden.


(* Wenn ein eigenes Modell der pagination unter /squelettes/modeles/pagination.html gespeichert wird, wird /dist/modeles/pagination.html ignoriert)


Zusatz des Übersetzers :

Ach ja : falls das plugin nicht wie gewünscht funktioniert...

Das häufigste Problem, das im französischen Forum zu diesem Artikel angesprochen wird, ist das Fehlen des Tags #INSERT_HEAD in den Artikel-, Meldungs- und Rubrikskeletten (oder in der Datei inc-head). Der Tag gehört in Großbuchstaben zwischen <head> und </head>.

Und es lohnt sich, sowohl mit SPIP als auch mit dem PLugin (Version SVN stable) up to date zu bleiben, sonst kann es zu Problemen kommen. Insbesondere sollte SPIP nicht älter sein als SPIP 1.9.2.

Voilà.

Discussion

Une discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom