	/*******************************************
	*       UploadPic, ein MOD fr phpBB       *
	*       ----------------------------       *
	*                                          *
	*   date       : 08/2005 - 03/2007         *
	*   (C)/author : B.Funke                   *
	*   URL        : http://forum.beehave.de   *
	*                                          *
	********************************************/


UploadPic erlaubt Usern eines phpBB-Forums, Bilder auf den Webspace des Forums
hochzuladen, um diese im Forum zu verwenden.
Vielen Benutzern steht kein Webspace zur Verfgung, viele wissen auch nicht,
wie man ein FTP-Programm verwendet, so da diesen Usern nur die Mglichkeit
bleibt, bereits im Internet vorhandene Bilder (deren dauerhafte Verfgbarkeit
nicht garantiert werden kann) im Forum zu verwenden.
Hier setzt UploadPic ein ...



Die Admin
---------

UploadPic

Dieses Panel erlaubt einen berblick ber alle User, die Bilder hochgeladen
haben. Es werden die Anzahl der Bilder und der verbrauchte Speicherplatz
angezeigt.
Der Link "Alle unbenutzten Bilder lschen" lscht alle Bilddateien, die in
keiner Nachricht des Forums (oder als Avatar oder in einer PN) verwendet
werden, um Speicherplatz zu sparen.
Die Funktion "Alle alten Bilder aus PN lschen" lscht alle Bilder aus
privaten Nachrichten, die Ablaufdauer fr Bilder in PN berschritten haben.
In der Konfiguration kann angegeben werden, da die "letzten x Uploads"
auf dieser Seite angegeben werden (wenn dieser Wert auf 0 gesetzt wird,
werden keine Dateien angezeigt).

UploadPic config

Dieser Link ffnet eine Seite mit Einstellungen zu UploadPic. Smtliche
Optionen werden in der Datenbank gespeichert.

UploadPic groups

ffnet eine Auswahlliste mit allen Gruppen. Nach Auswahl einer Gruppe kann
fr alle Benutzer dieser Gruppe die Erlaubnis zum Upload gesetzt (oder
entzogen) werden.
Hinweis: Diese Darstellung dient der besseren Kontrolle der Berechtigungen
fr Mitglieder einer Gruppe. Die Berechtigungen werden aus Sicherheitsgrnden
aber immer nur pro Mitglied, nicht aber pro Gruppe gespeichert, es erfolgt
keine automatische Zuteilung von Berechtigungen durch Gruppenzugehrigkeit.

UploadPic aktuell

Diese Seite zeigt die zuletzt hochgeladenen Bilder. Die Anzahl der hier
anzuzeigenen Bilder kann in der Konfiguration eingestellt werden.
Neben den Bildern werden Informationen ber die Gebrauch des Bilder, die
Gre und den User, der das Bild hochgeladen hat, angezeigt - es kann
ausgwhlt werden, ob das Bild gelscht werden soll (wenn es nicht in
Gebrauch ist) oder ob man es "zensieren" mchte.
Diese Funktion kann benutzt werden, um ungewollte oder unpassende Bilder
loszuwerden, ohne die Nachricht editieren oder sich durch die Datenbank
graben zu mssen. Es wird auch kein hliches "nicht gefunden"-Icon
angezeigt, sondern ein selbst festgelegtes Bild. Das Originalbild wird
von diesem berschrieben.
Die "zensiert"-Bilder knnen im Bildverzeichnis des jeweiligen Templates,
z.B. templates/subSilver/images/lang_german, gendert werden. Es gibt 3
Bilder, eins fr jedes Format: gif/jpg/png. Es sollte darauf geachtet
werden, da die Bilder nicht grer als die maximal erlaubte Avatar-
Gre sind, wenn man Remote-Avatare erlaubt, da mit UploadPic hochgeladene
Bilder in dem Fall u.U. auch als Avatare genutzt werden knnen und so
beim Austausch durch zu groe "zensiert"-Bilder das Layout zerstren
knnten.
Hinweis: Wenn keine "zensiert"-Bilder erscheinen sollen, knnen diese
einfach vom Webspace gelscht werden, in diesem Fall werden hochgeladene
Bilder, die "zensiert" werden sollen, einfach gelscht.

UploadPic users

Mit diesem Panel kann die Erlaubnis zum Upload fr mehrere User gleichzeitig
gesetzt werden, damit bei Foren mit sehr vielen Usern nicht jedes
Benutzerprofil einzeln aufgerufen werden mu.
Ein Klick auf einen Benutzernamen ffnet die Detailansicht des Benutzers,
nicht verwendete Bilder sind mit einem "Lschen"-Link gekennzeichnet, ein
Klick auf den Bildernamen zeigt das jeweilige Bild an.



UploadPic erlaubt das Einfgen eines hochgeladenen Bildes entweder ber das
BBCode-[img]-Tag (sichtbar direkt in der Nachricht), bei vorliegender
Installation des left/right-MODs auch mit entsprechender Ausrichtung, oder
ber das [url]-Tag (oder beides, einzustellen in der Konfiguration).
Wenn den Usern erlaubt wird Bilder hochzuladen, die das Layout des Forums
sprengen wrden, empfiehlt es sich, nur das [url]-Tag zuzulassen. Dabei wird
in der Nachricht ein Textlink eingefgt, der bei Klick ein neues Fenster mit
dem Bild ffnet.
Falls beim Upload Probleme auftreten, sollte versucht werden, die erlaubten
Bild-Abmessungen zu verringern. Manche Provider erlauben nur geringe
Speicherlast fr PHP-Skripte, so da das Erzeugen groer Bilder in einer
Fehlermeldung resultiert.

UploadPic kann benutzt werden, um auch fr andere Eingabefelder BBCode
einzufgen. Um das zu bewerkstelligen, mu UploadPic mit der Variable
"inputname" aufgerufen werden, wenn das Textfeld, in das der Code eingefgt
werden soll, anders heit als "message" (Standard-Textarea in der posting.php
von phpBB). Auf diese Weise kann UploadPic z.B. mit dem MOD "Quick Reply"
verwendet werden.
Der einzufgende Code und weitere Informationen zur Nutzung der Variable
findet sich in den FAQ, Punkt III. 5.:
http://www.beehave.de/forum/viewtopic.php?t=521

UploadPic kann auch fr die "Knowledge Base" benutzt werden. Den Code, der
die entsprechenden Knowledge Base-Dateien ndert, ist in den FAQ, Punkt
III. 7. zu finden:
http://www.beehave.de/forum/viewtopic.php?t=521

UploadPic kann auch fr "easyCMS" benutzt werden. Den Code, der ntigen
Dateien ndert, ist in den FAQ, Punkt III. 11. zu finden:
http://www.beehave.de/forum/viewtopic.php?t=521

UploadPic kann auch fr das "Lexicon" MOD benutzt werden. Den Code, der
ntigen Dateien ndert, ist in den FAQ, Punkt III. 12. zu finden:
http://www.beehave.de/forum/viewtopic.php?t=521

Darber hinaus kann und werde ich fr fremde MODs KEINEN Support leisten
noch fr den Einbau des Codes in fremde MODs Verantwortung bernehmen.




Hinweise zur Installation:

Die beigefgten und zu ndernden .tpl-Dateien sind fr jedes verwendete
Template zu ndern/hochzuladen. Da in der Standardinstallation "subSilver"
enthalten ist, wurde dieses Template diesem MOD zugrunde gelegt. (Auch wenn
ich subSilver selbst garnicht verwende :)
Da es unmglich ist, alle mglichen Templates zu kennen, kann ich fr
Probleme mit anderen Templates als subSilver keinen Support leisten.

Im Ordern "translations" finden sich die nderungen fr die jeweiligen
Sprachdateien. Soll eine andere Sprache als Englisch verwendet werden, mu
nach dem Ausfhren von "uploadpic.txt" (im Hauptverzeichnis des Archivs)
noch die entsprechende Datei aus dem "translations"-Ordner ausgefhrt werden.
Die in diesem Ordner vorhandenen Dateien ndern NUR DIE SPRACHDATEIEN,
fr die Installation von UploadPic mu die Datei /uploadpic.txt ausgefhrt
werden.
Wenn jemand UploadPic in seine Sprache bersetzt hat und seine Arbeit anderen
zugute kommen lassen mchte, kann er/sie mir die Dateien zukommen lassen,
damit sie im nchsten Update mitgeliefert werden knnen.

Das Verzeichnis fr die Userbilder (default: "/userpix") mu auf "CHMOD 777"
gesetzt werden, damit smtliche Skripte Schreibzugriff erhalten. Das Install-
Skript bernimmt diese nderung - je nach Server-Konfiguration kann es aber
sein, da die Schreibrechte manuell gesetzt werden mssen.
Die nderung wird am besten mit einem FTP-Programm vorgenommen, nhere
Informationen dazu in den FAQ:
http://www.beehave.de/forum/viewtopic.php?t=521, Kapitel II. 3.

Wichtig:
Nach dem Hochladen/ndern der Dateien mu einmalig die Datei
/install/install_uploadpic.php aufgerufen und im Anschluss daran das install-
Verzeichnis gelscht werden.

Um die Erlaubnis zum Upload standardmig auf "ja" zu setzen, mu die Datei
install_uploadpic.php VOR dem Ausfhren gendert werden. ndere die Zeile:
	$sql[] = 'ALTER TABLE ' . USERS_TABLE . ' ADD user_allow_uploadpic TINYINT NOT NULL DEFAULT 0';
in:
	$sql[] = 'ALTER TABLE ' . USERS_TABLE . ' ADD user_allow_uploadpic TINYINT NOT NULL DEFAULT 1';

oder, wenn du PostgreSQL benutzt, ndere die Zeilen:
	$sql[] = 'ALTER TABLE ' . USERS_TABLE . ' ALTER COLUMN user_allow_uploadpic SET DEFAULT 0';
	$sql[] = 'UPDATE TABLE ' . USERS_TABLE . ' SET user_allow_uploadpic = 0 WHERE user_allow_uploadpic IS NULL';
in:
	$sql[] = 'ALTER TABLE ' . USERS_TABLE . ' ALTER COLUMN user_allow_uploadpic SET DEFAULT 1';
	$sql[] = 'UPDATE TABLE ' . USERS_TABLE . ' SET user_allow_uploadpic = 1 WHERE user_allow_uploadpic IS NULL';

Wenn das userpix-Verzeichnis anders heissen soll, mu "userpix" in der folgende
Zeile gendert werden:
$str_updirname = 'userpix';
(wenn das Verzeichnis woanders abgelegt werden soll, kann ein Pfad eingegeben
werden, z.B. 'images/userpix')



Hinweise zur Sicherheit:

Dieses MOD wird so, wie es ist, zur Verfgung gestellt. Auch wenn smtliche
Funktionen und Sicherheits-Checks des MODs ausfhrlich getestet wurden,
bernehme ich keinerlei Verantwortung fr jedwede Folgen (erwnscht oder
unerwnscht), die aus der Benutzung und/oder Installation dieses MODs
resultieren, die Verwendung erfolgt auf eigene Gefahr.

Wenn der Server, auf dem das Forum luft, das Auflisten von Verzeichnissen
im Browser erlaubt, empfehle ich die Verwendung einer index.htm-Datei im
UploadPic-Verzeichnis, damit niemand den Verzeichnisinhalt dadurch
einsehen kann, da die Verzeichnis-URL im Browser aufgerufen wird.
Zu diesem Zweck kann einfach die "index.htm"-Datei aus dem Verzeichnis
"images" in das UploadPic-Verzeichnis kopiert werden.

UploadPic darf frei kopiert und verwendet werden, solange alle mitgelieferten
Dateien unverndert bleiben. Fr alle weiteren (rechtlichen) Hinweise gilt fr
dieses MOD die GNU GENERAL PUBLIC LICENSE.


Noch einmal: UploadPic kann dazu benutzt werden, den Webspace des Forums mit
Mll anzufllen und den Traffic der Site zu steigern. Wenn nicht ausreichend
Speicherplatz zur Verfgung steht, sollte die Erlaubnis zum Upload nur
bekannten und vertrauenswrdigen Usern gestattet werden, um nicht irgenwann
keinen Webspace mehr zu haben, nur weil ein User meint, er msse seine
komplette Fotosammlung ins Forum hochladen.
Die Option "Upload fr Gste erlauben" sollte mit uerster Vorsicht
genossen werden !


Was ich ebenfalls NICHT empfehle, ist die nderung des Wertes
"uploadpic_delete" auf "false", vor allem in Verbindung mit dem Wert
"uploadpic_uniqfn = true":
uploadpic_delete bestimmt, ob ein hochgeladenes Bild nach dem Upload gelscht
wird, wenn der User "zurck" oder "Abbruch" anklickt (das Bild also doch
nicht verwenden will), um Speicherplatz zu sparen. Wenn ein Admin natrlich
wissen will, wie oft welcher User welches Bild hochgeladen hat, um es dann
doch nicht zu verwenden, kann er den Wert ruhig auf "false" setzen.
uploadpic_uniqfn legt fest, ob bei jedem Upload berprft wird, ob ein Bild
mit diesem Namen schon existiert. Es wird an den vom User angegebenen
Bildnamen die Kombination "_NR" angehngt, wobei "NR" eine Zahl ist, die
hochgezhlt wird. Dieses Feature soll verhindern, da ein User zu
verschiedenen Zeiten Bilder hochldt, die alle denselben Namen haben und sich
so berschreiben wrden.


Des weiteren ist es keine gute Idee, die erlaubten Dateitypen zu erweitern.
Ohne die Verwendung eines (nicht implementierten) externen Programms kann PHP
z.B. keine tif- oder bmp-Dateien verwenden. Nicht-Bilddateien sollten
grundstzlich nicht angegeben werden (abgesehen davon, da diese Fehler im
Skript hervorrufen wrden).



Hinweise zum Support:

Fr Vorschlge zu UploadPic, Hinweise auf Fehler / Probleme oder
Dankesbekundungen :) kann mein Forum benutzt werden:
http://www.beehave.de/forum/viewforum.php?f=17

Bevor jedoch Fragen gestellt werden oder generelle Probleme beim  Einbau von
MODs auftreten, empfehle ich die Lektre der entsprechenden Artikel auf
phpbb.de/phpbb.com.
Anfragen, die in dieser Dokumentation und/oder den FAQ in meinem Forum
(http://www.beehave.de/forum/viewtopic.php?t=521) schon behandelt wurden
oder allgemeine Probleme im Umgang mit PHP/FTP/SQL etc. betreffen, werden
von mir NICHT bearbeitet, sonst kme ich zu nichts anderem mehr ;)

Fr eine generelle Hilfe zum Installieren von MODs unter phpBB, s. hier:
http://www.phpbb.de/doku/kb/artikel.php?artikel=18
fr eine Anleitung zu phpMyAdmin s. hier:
http://www.phpbb.de/doku/kb/artikel.php?artikel=pma_faq


UploadPic existiert seit etwa einem Jahr und wurde kontinuierlich weiter
entwickelt. Aus den vielen Zuschriften mit Problemen und Vorschlgen habe
ich die Software gebaut, die du jetzt siehst. Tatsache ist, da ich selbst
nur etwa 20% der Funktionen nutze, die UploadPic mittlerweile hat :)
Wenn du meine Arbeit untersttzen willst, kannst du dafr folgenden PayPal-
Account benutzen: paypal@beehave.de



Viel Spa, BF
