Überblick

KoschtIT Image Gallery ist ein PHP-Skript zur einfachen Darstellung von Bildern im Webbrowser. Dabei ist das Aussehen der Galerien vielfältig anpassbar und es ist auch möglich mehrere davon in einem HTML Dokument anzuzeigen. Vorraussetzung für die Benutzung ist nur PHP5 mit GD2 Unterstützung. Bilder werden nicht in einem extra Fenster geöffnet, sondern öffnen sich direkt im HTML Dokument, wobei der Hintergrund abgedunkelt wird. Beim Bewegen der Maus zu den Rändern des Fensters werden Vorschaubilder auf das nächste/vorhergehende Bild in einer Galerie generiert. Und seit der Version 1.5 können für jedes Bild durch den Administrator bequem Bilderkommentare geschrieben werden. Die Galerie kann sowohl per Tastatur als auch per Maus bedient werden.
Die Steuerung mit der Maus erfolgt anders, als vielleicht bei anderen Galerien - deshalb hier eine kleine Hilfe:

Maussteuerung

Demo

Um euch sofort einen ersten Eindruck zu verschaffen gibt es hier eine kleine Demo. Man kann sowohl einzelne Bilder anzeigen, als auch Bilderfolgen zu einer Galerie zusammenfassen.

Einzelne Bilder

Galerien

Wie kann ich es benutzen

Einfügen der Tags

1.
In den Headerbereich ( zwichen <head> und </head> ) der Website muss folgendes rein: 
<?php include_once("...../ki_include.php"); ?>
Ihr müsst den richtigen Pfad zur ki_include.php angeben, damit es funktioniert. Es spielt dabei keine Rolle wohin auf dem Server ihr das Script entpackt habt. Bitte beachtet auch, dass die betreffende Seite ein PHP Seite (z.B. *.php) sein muss.

2.
An die Stelle wo euer Bild/Galerie angezeigt werden muss fügt ihr diesen Tag ein. Unter id könnt ihr angeben, welchen Galerieordner ihr anzeigen wollt.
Bitte nur den Namen des Ordners angeben und nicht etwa den Pfad. Diesen Tag könnt ihr mehrmals für jeweils unterschiedliche Ordner einfügen. 
<div class="koschtitgallery" id="..."></div>

Erstellen der Ordner und Hochladen der Bilder

Nachdem ihr das Skript heruntergeladen und irgendwo auf eurem Webspace entpackt habt, findet ihr da drin den Ordner ki_galleries. In diesem Ordner könnt ihr neue Ordner anlegen für eure Galerien.
Jede Galerie muss seinen eigenen Ordner haben. Sind die Ordner erstellt müsst ihr nur noch eure Bilder hochladen und ihr seid fertig. Am einfachsten geht das alles übrigens per FTP.

Anpassen der Galerien

1.
Alle Konfigurationsdateien zum Skript findet Ihr im ki_config Ordner. Darin sollte sich auf jedenfall die ki_setup.php befinden. In dieser Datei ist das Aussehen für Galerien ohne eigener Konfigurationsdatei hinterlegt und noch dazu die wichtigsten Einstellparameter.
Hier ein Beispiel der ki_setup.php: 
<?php
// ---------- default values for galleries without own config file --------------------------------------------

$fr_width = 600; // width of the gallery
$fr_height = 150; // height of the gallery
$fr_color = "#000000"; // background color of the gallery ( "none" for no background )

$thumbs = 4; // maximal number of thumbs that are shown at the same time
$th_per_line = 4; // thumbs per line
$th_lines = "auto"; // "auto" or a number of thumb lines

$th_width = 120;	// "auto" or the maximal width of the thumbs ( pixels )
$th_height = 90; // "auto" or the maximal height of the thumbs ( pixels )
$th_bord_size = 1; // thumbs border size ( 0...X in pixels )
$th_bord_color = "#ffffff";	// thumbs border color ( hex )

$show_text = 1;	// 1 = show navigation control / 0 = don't show navigation control
$text_underline = 0; // 1 = links underlined / 0 = links not underlined
$text_size = 11; // text size of navigation links ( pixels )
$text_color = "#ffffff"; // text color of navigation links ( hex )
$text_font = "Tahoma, Verdana, Arial, Helvetica, sans-serif"; // text font face of navigation links
$text_continue = "next"; // string for "next" thumb page link
$text_return = "back"; // string for "previous" thumb page link

$diashow = 1; // 1 = display slideshow link / 0 = don't display slideshow link
$diashow_text = "Slideshow"; // string for "slideshow" link

// ---------- main lookout settings that are applied to ALL galleries -------------------------------------------

$pic_order = 0;	// 0 = newest pictures first / 1 = newest pictures last / 2 = alphabetical order

$th_to_square = 0; // 1 = square thumbs / 0 = normal thumbs
$th_2sq_crop_vert = "middle"; // show "middle" / "top" / "bottom" part of the picture if $th_to_sqaure enabled
$th_2sq_crop_hori = "center"; // show "center" / "left" / "right" part of the picture if $th_to_sqaure enabled

$bord_color = "#000000"; // border color of shown pictures ( hex )
$bord_size = 8;	// border size of shown pictures ( 0...X in pixels )

$fade_alpha = 7; // opacity of the shade ( 0...10 / 10 = full opacity )
$fade_color = "#000000"; // shade color ( hex )

$preview_pics = 8; // number of preview pictures ( 0...9 )
$preview_pics_space = 50; // space size between preview pictures ( pixels )
$preview_bord_color = "#000000"; // border color of the preview picture ( hex )
$preview_bord_size = 1;	// border size of preview pictures ( 0...X in pixels )

$comments = 1; // 1 = comments enabled / 0 = comments disabled
$comm_auto = 0;	// 1 = auto comments as defined in $comm_auto_string / 0 = custom comments
$comm_auto_string = "KoschtIT Image Gallery - Picture %x of %X"; // string for auto comments / "%x" = picture number / "%X" = number of all pictures
$comm_text_size = 12; // comments font size ( pixels )
$comm_text_color = "#ffffff"; // comments font color ( hex )
$comm_text_font = "Tahoma, Verdana, Arial, Helvetica, sans-serif"; // comments font face
$comm_text_align = "right";	// comments text align "left" / "center" / or "right"

$tooltips = 1; // 1 = enable tooltips / 0 = disable tooltips
$tooltips_color = "#ffffff"; // tooltips font color

$diashow_time = 5000; // display time for each picture during slideshow ( ms )

$thumbs_to_disk = 1; // 1 = thumbs are saved on the server / 0 = thumbs are generated "on the fly"
$oversize_allowed = 0; // 0 = pictured are reduced if they don't fit browser window / 1 = full size pictures
$shade_while_loading = 0; // 1 = shade website while initializing gallery / 0 = usual website loading
$load_img = "ki_loading.gif"; // file name of the loading animation picture ( must be in "ki_base" folder )		
$show_warnings = 1; // 1 = show server warnings / 0 = don't show server warnings

$admin = "kkokus"; // admin username - needed for adding custom comments to the pictures
$pw = "coriolan"; // admin password - needed for adding custom comments to the pictures

// -----------------------  DO NOT EDIT ANYTHING FURTHER THIS POINT  -----------------------------------------------------

$supported = array("jpg","png","gif");
if($show_text == 1)$fr_height-=($text_size+12);
?>
2.
Zusätzlich könnt ihr jede Galerie noch individuell im Aussehen ändern. Dies ist optional. Dafür müsst ihr für die jeweilige Galerie eine Datei galeriename_ki_setup.php im ki_config Ordner erstellen. Existiert so eine Datei nicht wird standartmäßig auf die ki_setup.php zurückgegriffen. So könnte eine individuelle Konfigurationsdatei aussehen: 
<?php
$fr_width = 165; // width of the gallery
$fr_height = 124; // height of the gallery
$fr_color = "#000000"; // background color of the gallery ( "none" for no background )

$thumbs = 1; // maximal number of thumbs that are shown at the same time
$th_per_line = 1; // thumbs per line
$th_lines = "auto"; // "auto" or a number of thumb lines

$th_width = 150; // "auto" or the maximal width of the thumbs ( pixels )
$th_height = 113; // "auto" or the maximal height of the thumbs ( pixels )
$th_bord_size = 0; // thumbs border size ( 0...X in pixels )
$th_bord_color = "#ffffff";	// thumbs border color ( hex )

$show_text = 0;	// 1 = show navigation control / 0 = don't show navigation control
$text_underline = 0; // 1 = links underlined / 0 = links not underlined
$text_size = 11; // text size of navigation links ( pixels )
$text_color = "#ffffff"; // text color of navigation links ( hex )
$text_font = "Tahoma, Verdana, Arial, Helvetica, sans-serif"; // text font face of navigation links
$text_continue = "next"; // string for "next" thumb page link
$text_return = "back"; // string for "previous" thumb page link

$diashow = 1; // 1 = display slideshow link / 0 = don't display slideshow link
$diashow_text = "Slideshow"; // string for "slideshow" link

// -----------------------  DO NOT EDIT ANYTHING FURTHER THIS POINT  -----------------------------------------------------

if($show_text == 1)$fr_height-=($text_size+12);
?>

Tastatureingaben

Um den Bedienkomfort für den Betrachter zu erhöhen, kann man zur Navigation beim Betrachten von Galerien auch die Tastatur verwenden. Folgende Tasten können benutzt werden:

Bild-runter oder Ende
... vorheriges Bild anzeigen
Bild-hoch oder Pos1
... nächstes Bild anzeigen
Cursortasten
... betrachten von übergroßen Bildern
Pause/Untbr
... Pause/Fortsetzen der Diashow
Esc
... Schließen des Bildes

Bilderkommentare

Zu jedem Bild kann der Administrator mit Hilfe seines Benutzernamens und seines Passworts bequem Bilderkommentare hinzufügen.
Um dies zu machen muss er die Seite mit der jeweilligen Galerie mit dem Adressanhang "?admin=benutzername" aufrufen. Zum Beispiel wäre das für diese Seite "http://koschtit.tabere.net?admin=benutzername" . Natürlich müsst ihr benutzername mit den echten Benutzernamen aus der ki_setup.php ersetzen. Nach der Eingabe des Passworts in das dafür vorgesehene Feld könnt ihr bei jedem Bild Kommentare dazuschreiben. Diese werden nach drücken der Entertaste automatisch gespeichert. Eine Datenbank muss dafür nicht vorhanden sein. Bitte beachtet auch die FAQ Frage 4 für weitere Informationen.

Herunterladen

KoschtIT Image Gallery v1.73b

Changelog

Den Changelog zu früheren Relaeses findet ihr in der changelog.txt im Skriptarchiv.

FAQ

Da ich regelmäßig Fragen zum Skript erhalte - hier eine kleine Liste "häufiger Fragen":


1. Wieso sind meine Thumbs abgeschnitten und das Skript funktioniert nicht im Internet Explorer?
Dieses Problem tritt auf, wenn ihr einen anderen DOCTYPE verwendet als das Skript. Das Skript benötigt folgenden DOCTYPE: 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
Versucht eure Website für diesen DOCTYPE ( oder wenigstens auf XHTML Transitional ) umzuschreiben. Auf anderen Browsern als dem Internet Explorer tritt dieser Fehler nicht auf.


2. Ich habe das Skript eingebunden, ich sehe aber keine Vorschaubilder?
Hast du die Bilder in das richtige Verzeichnis hochgeladen? Diese müssen im Ordner mit dem selben Namen wie bei $dir_name = "ordnername"; eigetragen sein. Weiterhin muss der relative Pfad zu diesem Ordner bei $pic_dir = "./koschtitdir/"; eingetragen sein. Stimmt das alles und ihr seht trotzdem keine Bilder, so könnte es sein, dass euer PHP keine Schreibrechte bekommt. Das einzige was ihr dann machen könnt ist $thumbs_to_disk = 1; auf 0 zu setzen. Dann wird nicht versucht die Thumbs auf dem Webserver zu speichern.


3. Alle Pfade stimmen - ich sehe aber trotzdem keine Vorschaubilder!
Es empfiehlt sich allgemein keine Sonderzeichen oder Leerzeichen in den Bilderdateien zu benutzen. Vermeide Zeichen wie "+" oder "%" und "?". Bitte möglichst nur Buchstaben und Ziffern verwenden. Möglicherweise ist eine der Bilderdateien beschädigt.

4. Wo kann ich mich einloggen um Bilderkommentare zu schreiben?
Ruft die Seite mit der Galerie mit den zusätlichen Parameter "?admin=user" (oder &admin=user) in der Webadresse auf. Ersetzt aber user mit dem Benutzernamen der in der ki_setup.php eingetragen ist. Bitte beachtet, dass ihr erst dann eigene Bilderkommentare schreiben könnte, wenn in der ki_setup.php der Parameter $comm_auto auf 0 gesetzt ist.


5. Hilfe!? Meine Kommentare werden nicht gespeichert!
Wahrscheinlich hat PHP keine Schreibrechte auf eurem Webserver. In diesem Fall müsst ihr Kommentare manuell hinzufügen. Dazu müsst ihr im Ordner der jeweiligen Galerie einen Ordner "thumbs" erstellen. Dort könnt ihr ".txt" - Datein erstellen, die genauso heißen müssen, wie die Bilder zu denen der Kommentar gehört. Zum Beispiel für "bild.jpg" wäre das "bild.txt". Schreibt dort den Kommentar herein und stellt sicher, dass $comments = 1. Funktioniert es danach immernoch nicht, könnte es sein, dass Ihr nicht PHP 5 verwendet.


6. Auf welchen Browsern läuft das Skript?
Ich habe das Skript auf folgenden Browsern erfolgreich getestet:
- Firefox 2, 3
- Internet Explorer 6, 7
- Opera 8, 9
- Safari 3 ( Windows )


7. Bei mir wird nicht die ganze Seite abgedunkelt?!
Höchstwahrscheinlich verwendest du Frames oder iFrames auf deiner Seite. Für solche Seiten ist das Skript nicht ausgelegt. Man kann übrigens jede Seite auch ohne Verwendung dieser ( veralterten ) Tags aufbauen. Informiere dich einfach über AJAX und DHTML.

8. Wie kann ich die Galerie in meine Website einbauen, die ich über "domain.com?site=gallery" aufrufe?
Hier ein kleines Codegerüst, was evtl. eine Hilfe sein kann. 
<?php
$gallery = 0;
if(isset($_GET['site'])){ if($_GET['site'] == "gallery"){ $gallery = 1;	} }
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
...
<?php
if($gallery == 1)include_once("ki_headertags.php");
?>
</head>
<body>
...
<?php
if($gallery == 1){ 
$dir_name = "demo";
include("ki_kitgallery.php");
}
?>
...
<?php
if($gallery == 1)include_once("ki_maintags.php");
?>
</body>
</html>


9. Wie kann ich ein einzelnes Bild einfügen, so wie in der Demo oben?
Erstelle für das jeweillige Bild "quasi" eine eigene Galerie und lege dafür eine individuelle Konfigurationsdatei an. Wenn du jetzt in dieser die Navigationslinks abschaltest und $thumbs auf 1 stellst erhälst du das gewünschte Resultat. Möglicherweise musst du noch die Größe des Thumbs anpassen.

Kontakt / Betatest

Falls ihr noch irgendwelche Fragen habt, so nutzt bitte die Kommentarfunktion.
Seid ihr der Meinung es wäre besser die Frage persönlich an mich zu richten, so schreibt bitte an kkokus[a_t]web[do_t]de . Für Verbesserungsvorschläge und Kritik habe ich immer ein offenes Ohr.
Außerdem werden zur Zeit auch umbedingt noch Betatester gesucht, die neue Skriptversionen vor der Veröffentlichung auf Fehler testen können. Falls Ihr daran Interesse habt, so schreibt mir bitte eine kurze Mail.

Kommentare

Kommentar hinzufügen

Name   E-Mail Icq http://
Kommentarüberschrift
Kommentar
Comments
Hallo, gibts die möglichkeit die Kommentare in 2 Zeilen darzustellen? habs schon porbiert, aber bekomms nicht hin über das input text feld :(

>> Nein. Das Skript unterstützt zur Zeit nur einzeilige Kommentare.
vom 24.07.2008 geschrieben von sven sven[a_t]tu-es[do_t]com


Fehlermeldung
Habe Dateien entpackt und auf Server geladen. PHP-page index.php mit den entspr. Zeilen erstellt und ins root. Sonst alles incl. Struktur übernommen. Bekomme immer Fehlermeldung: Warning KoschtIT Image Gallery didn´t find any gallery to display. Um zu testen, glaubte ich, die Original dateien usw. einfach zu übernehemen. Falsch? Gibt es nicht einen Beispelaufruf-datei?

Danke, Wolfgang.

>> Innerhalb des runtergeladenes Script-Archivs befindet sich auch eine Beispielgalerie "sample". Ihr könnt euch diese anschauen wenn ihr id="sample" setzt.
vom 18.07.2008 geschrieben von Wolfgang fleischerw[a_t]htp-tel[do_t]de


In die Homepage einbauen?!
Wenn ich meine photos.php aufrufe sehe ich die gallery so, wie ich es mir vorstelle! Binde ich diese photos.php jetzt in meine index.php per include ein stellt er diese leider nicht richtig da!

Danke im vorraus!
vom 23.06.2008 geschrieben von Jan JanSchmerbitz[a_t]web[do_t]de http://allin4oneting.al.funpic.de/allinweb/photos.php ICQ: 111042556


Keine Bilder
Hallo. Thumbs werden geladen, beim Klick darauf entsteht nur eine graue Fläche an Stelle des Bildes!? Einstellungsfehler? Firefox und IE das selbe... Danke
vom 17.06.2008 geschrieben von Tom tom[a_t]morin[do_t]ch


Wohin mit dem ganzen PHP
Hallo
Ist es korrekt, wenn ich die heruntergeladenen Dateien von KoschtIT 1.72 im Hauptordenr meiner Webspace deponiere?

>> Ja.
vom 15.06.2008 geschrieben von tom tom[a_t]morin[do_t]ch


Fehlermeldung
Hallo,
ersteinmal vielen Dank das Skript gefällt mir sehr gut. Ich erhalte aber eine Fehlermeldung ählich wie Dito vor mir.

Warning: Invalid argument supplied for foreach() in /home/boot/public_html/ki_koschtit.php on line 103

Testweise habe ich versucht den Fehler zu beseitigen durch deaktiviern von $comments=0 und $comm_auto=0 , leider hat dies nichts gebracht. Kannst du mir da helfen?

Zeile 103 in der besagten Datei sieht folgendermaßen aus:
foreach(glob($sfolder."/thumbs/*.*") as $sf)

Danke
Gerd

>> Fehlermeldungen solcher Art können eigentlich nur aus einem Grund auftreten. Euer PHP hat keine Schreibrechte oder es ist euch irgendwie anders verboten per PHP Dateien und/oder Ordner anzulegen. Mit einer solchen Situation kann das Skript natürlich nicht besonders gut zurecht kommen. Bitte wendet euch an euren Hoster. Ihr könnt auch testweise versuchen die Thumbs "on the fly" zu generieren. Bitte liest euch dazu FAQ Frage 2 durch ...
vom 13.06.2008 geschrieben von Gerd


bildernamen in comment speichern
hi eine frage kann man automatisch den bildernamen mitspeichern auf die txt datei


>> Nein. So etwas ist zur Zeit nicht möglich ...
vom 09.06.2008 geschrieben von Johann jo.g[a_t]aon[do_t]at


Edit
Okay, ich habe in der setup.php die Kommentare aktiviert --> daher wohl das Problem, aber wenn ich jetzt Kommentare einfügen will...welche Datei muss welche Rechte besitzen?

lg
Dito

>> Am besten du gibst dem ganzen Skriptordner Schreibrechte. Um eigene Kommentare einzufügen muss $comments = 1 und $comm_auto = 0 sein. Dann kannst du über http://vorschau.juhadaily.de/gallerie/index.php?admin=user mit dem richtigen Usernamen und dem jeweiligem Passwort Kommentare einfügen.
vom 21.05.2008 geschrieben von Dito


Mehr Kommentare nächste Seite oder letzte Seite