********************************************************************************************************************************

	Bildergallerie (c) sysop
	http://www.mn-portal.at

	Dieses Sripit darf in Sinne der GPL frei verwendet werden
	Naehere Informationen siehe license.txt im doc Verzeichnis


********************************************************************************************************************************

****
 A *	INSTALLATION
****

Alle Dateien und Verzeichnisse hochladen, die Verzeichnisse base (inkl. der Unterverzeichnisse) und vars muessen Schreibrechte
haben.
Ueber die Datei mygalupload_c.php lassen sich diverse Einstellungen vornehmen, vor allem sollte das Passwort im Parameter
$config[1] geaendert werden. Mehr dazu unter Punkt D.

Ueber die Datei login.php wird das Passwort abgefragt und in der Gallerie der Zugang zu den Adminscripten frei gegeben.

********************************************************************************************************************************


****
 B *	EINBAU IN DIE EIGENE WEBSEITE
****

Das Script laesst sich problemlos in die eigene Webseite einbauen b.z.w um das Galleriescript herum liesse sich eine Webseite
erstellen.
Die index.php gibt einen Ansatz, indem per switch eine alternativ Seite aufgerufen werden kann. eine Mininavigation ist
enthalten.

Der Code:

	/** 		NAVI ANFANG
	 *
	 * 			Eine Mini-Navigation die auch einfach geloescht werden kann
	 *
	**/
	/*
	echo '<br><center><a href="index.php?goto=0">Gallerie</a>&nbsp;&nbsp;&nbsp;';
	echo '<a href="index.php?goto=1">Seite 1</a>&nbsp;&nbsp;&nbsp;';
	echo '<a href="index.php?goto=2">Seite 2</a>&nbsp;&nbsp;&nbsp;';
	echo '<a href="index.php?goto=3">Seite 3</a></center><br><br>';
	*/

Durch entfernen der Remzeilen um die echo Befehle ( das /* vor dem ersten echo und das */ nach dem letzten echo) kann eine kleine
Navigation als Hilfestellung eingeschalten werden.
Naeheres zur switch Anweisung kann auf der seite http://www.php.net/manual/de/index.php entnommen werden.

********************************************************************************************************************************


****
 C *	ZUSATZ MOEGLICHKEITEN
****

-------------
mygalbox.php
-------------

Das Script mygalbox.php erlaubt es eine Uebersicht fuer die Webseite zu generieren. dabei koennen mehrere Parameter das Aussehen
steuern. die Parameter apic und rpic erlauben Anzahl Bilder und Zeilenanzahl zu steuern. Ein Aufruf z.B. von:

	mygalbox.php?apic=18&rpic=3

zeigt 18 Bilder (apic) auf 3 Zeilen (rpic) Verteilt (also 6 Bilder je Zeile).

Der Aufruf:

	mygalbox.php?zufall=1

Erstellt ein Zufallsbild aus der Gallerie.



-----------
viewpic.php
-----------

Dem Script liegt ein Bildbetrachter bei, der auch Externe Bilder behandeln kann. ein Aufruf per Link sieht ca so aus:

	<a name="#" onclick="window.open('viewpic.php?bild=URL_ZUM_BILD', 'bildchen','width=100,height=100,top=40,left=40,scrollbars=1')">Bild extern</a>

Ein Demolink ist in der index.php enthalten und kann problemlos durch loeschen der Zeile entfernt werden.

Die Anzeige des Popups passt sich dabei automatisch der Bildgroesse an.
Die Datei viewpic.php kann Bilder in ihrer Originalgroesse belassen oder, wenn sie eine gewisse Groesse ueberschreiten, auch auf
eine Maximalgroesse resizen. Dazu wird die PHP-Funktion getimagesize() verwendet. Um die notwendigen Bildinformationen zu erhalten
ist es notwendig Lesezugriff auf die Bilder zu erhalten. Je nach PHP-Konfiguration kommt es dabei manchmal zu Problemen. Das
Script versucht diese Probleme selbständig zu beheben, indem eine alternative Lesemoeglichkeit getestet wird wenn der erste Versuch
scheitert.

Jeder Browser kocht sein eigenes Süppchen wenn es um die Berechnung des Viewpoints (angezeiter Bereich) geht. Diese Information
ist aber wichtig, um die Popupgroesse zu berechnen. Zu jedem Browser kann ein Parameter zur Erweiterung in Hoehe und Breite an-
gelegt werden.

********************************************************************************************************************************


****
 D *	KONFIGURATION (mygalupload_c.php)
****

Wichtige Parameter:

Jedem Parameter ist eine Rem-Information hinterlegt, die im Wesentlichen die Fuktion erklaeren sollte.

--------------------------------------------------------------------------------------------------------------------------------
$rename_file_by_date = 0; // Werte 0 oder 1

Erlaubt dem Uploader den Dateinamen auf einen Datumsnamen zu aendern. Dabei wird der neue Dateiname nach folgendem Schema
erstellt:

	SekundeMinuteStundeTagMonatJahr.Typ

So koennen gleiche Bilder Mehrfach hochgeladen werden. Steht der Parameter auf 0 (default) wird der Originalname der Bilddatei
beibehalten. Ein Ueberschreiben einer bestehenden Datei ist nicht moeglich, die Datei muss ueber die Administration zuvor ge-
loescht werden.


--------------------------------------------------------------------------------------------------------------------------------
$ifnothumb_usepic = 1; // Wert 1 oder 0

Um Thumbnails (Vorschau-Bilder) vom Script erstellen zu lassen, ist es Notwendig, dass PHP ueber die notwendigen Libaries verfügt.
Nicht jeder Provider stellt diese Dateien zur Verfuegung (PHP-GD-Bibliotheken). Das Script verwendet bei Misserfolg die original
Bilddatei zum Anzeigen. Allerdings wird der Seitenaufbau dann langsamer, da die Bilder in vollet Groesse geladen werden muessen.
Steht der Parameter auf 0 wird bei einem Misserfolg das Bild nicht in die Gallerie aufgenommen.


--------------------------------------------------------------------------------------------------------------------------------
$ugalmax_perpage = 9; // bilder je seite usergallerie
$ugal_rows = 3; // bilder auf xx zeilen verteilen

Die Anzeige der Vorschaubilder ist komplett variabel. $ugalmax_perpage stellt ein, wieviele Bilder insgesamt je Seite angezeigt
werden sollen, $ugal_rows bestimmt auf wieviele zeilen die Bilder verteilt werden. Man sollte darauf achten, dass die Division:

	$ugalmax_perpage / $ugal_rows (also hier 9/3 = 3 Bilder je Zeile)

eine ganze Zahl ergibt, damit das Script eine Ordentliche Anzahl an Bildern je Zeile errechnen kann.


--------------------------------------------------------------------------------------------------------------------------------
$galbox_standalone = 1;

Das Script kann als Stand-alone Version eingesetzt werden oder in eine Webseite integriert werden. Als Stand-alone muss ein
HTML-Header gesendet werden um W3c konform zu bleiben. Dieser Parameter steuert ob so ein Header gesendet werden soll oder nicht.
Ueber den Header werden auch Stylesheet angaben gemacht, entfaellt der Header, werden die Style Angaben der Webseite verwendet.

Welche Styleangaben das Aussehen der Gallerie steuern, kann man dem styles Verzeichnis entnehmen.


--------------------------------------------------------------------------------------------------------------------------------
$thumb_quality = 90; // sollte zwischen 90 und 100 liegen um probleme mit der qualität zu vermeiden
$max_t_height = 150;  // maximale hoehe thumbnail
$max_t_width = 150;  // maximale breite thumbnail

Regeln die Erstellung der Thumbnails (kleine Vorschaubilder). Die Bilder werden in der entsprechenden Maximalhoehe/Breite auto-
matisch beim Upload erstellt. Um Platz zu sparen kann die Qualität der Thumbnails verringert werden, wodurch die Bilder natürlich
kleiner werden.


********************************************************************************************************************************


****
 E *	FEATURES
****

* Kein SQL
* Kategorieen Verwaltung
* vollkommen Variable Anzeige Bilder je Zeile auf x Zeilen verteilt
* Upload mit automatischer Thumbnail (Vorschaubild) Erstellung
* Datei-Groessenbegrenzung beim Upload
* Erlaubte Dateiendungen Abfrage.
* Wahlweise Umbenennen der Bilddatei oder beibehalten des Originalnamens (Kein Überschreiben bestehender Dateien möglich)
* Zusatz Info-Text je Bild
* Verschiedene Slideshows (JS-Slider und Einzelbild-Bildwechsler)
* Slider der xx aktuellsten Bilder (js muss aktiviert sein)
* Zufallsbild aus der Gallerie in Homepage integrierbar
* Uebersichtstabelle per Link Steuerbar
* Bildbetrachter kann auch fuer externe Bilder verwendet werden.
* Mehrere alternative Leseversuche der Bildinformationen von externen Bildern.
* Groessenverhältnis externer Bilder bleibt erhalten.
* Resize der Bildanzeige auf eine Maximalgrösse.
* Komfortables Löschen ganzer Kategorieen oder einzelner Bilder.
* Style-Anpassung

im Teststadium

* Mehrere Gallerieen moeglich
* Ansteuerung der verschiedenen Gallerieen per $_GET
