phpBB.de

BBClone mini-howto deutsch

Als erstes die aktuellste BBClone Version direkt von
http://bbclone.de/ herunterladen und entpacken. (Win32 Benutzer:
Winzip für *.zip und Winrar für *.tar.gz) Je nach Zugriffsart können dann die
Dateien an ihren Bestimmungsort kopiert oder per FTP Klient auf den Webspace
übertragen werden. Der Klient sollte dabei unbedingt binären und nicht ASCII
Transfer durchführen, andernfalls kann es zu unberechenbaren Verhalten des
Skriptes kommen. Das liegt daran das Teile davon auf UNIX artige Zeilenumbrüche
angewiesen sind

Eine weitere Voraussetzung für das Funktionieren von BBClone ist ein Webserver,
der PHP unterstützt sowie Leserechte für alle Dateien und Verzeichnisse von
BBClone. Mit dem Befehl "chmod" (FTP Klienten wie SmartFTP oder WS-FTP für
Win32 unterstützen dieses Feature) können diese bei Bedarf geändert werden. Die
Dateien im var/ Verzeichnis (außer ".htaccess) müssen für den Server
beschreibbar sein. Um sie beschreibbar zu machen, wenden Sie am besten
"chmod 666" an.

Sind alle Voraussetzungen erfüllt, kann in die Seiten, welche die Besucher
zählen sollen, folgender Code eingefügt werden. Ein geeigneter Ort für den Code
ist am Ende der Seite. Falls die Seite kein HTML enthält, sollten die PHP
Anfangs-/Endtags vom folgenden Beispiel weggelassen werden.

<?php
define("_BBCLONE_DIR", "bbclone/");
define("COUNTER", _BBCLONE_DIR."mark_page.php");
if (is_readable(COUNTER)) include_once(COUNTER);
?>

(an den kopf jeder datei im root einfügen, deren aufrufe gezählt werden sollen, z.b. index.php, portal, members, login, etc.)
Es ist auch möglich, den Code in mehrere Sektionen ihres Webangebotes
einzufügen, BBClone kann dann eine Statistik anzeigen, wie sich die Besuche auf
ihre Bereiche verteilen

Achtung! Diese Seite muß für den Server als php Datei erkennbar sein. Möchten
sie den Code in eine HTML Datei einfügen, so muß diese nach *.php umbenannt
werden. Das Code Snippet kann auch zum Überprüfen der Funktionalität (beim
Analysieren von Problemen) in eine separate Datei abgespeichert werden, die
natürlich wiederum eine *.php Endung haben sollte.

Der Test:
Nach einer erfolgreichen Installation läßt sich der gegenwärtige
Counterstatus im Quelltext des HTML Outputs der Seite wiederfinden, in
welche das Code Snippet eingefügt worden ist. Somit braucht man sich
nur mit seinem Webbrowser den Quelltext der Seite anzeigen lassen.
Hier noch eine kurze Einführung zu allen möglichen Meldungen:

<!-- BBClone v xxxx OK: counter file is working -->


Wie die Meldung schon sagt, ist BBClone in der Lage, Benutzerdaten zu sammeln.
Bitte beachten Sie, daß das Aktualisieren der Statistik immer noch fehlschlagen
könnte, sie werden es dann an einer weiteren Meldung erkennen.

<!-- BBClone v xxxx OK: access file is working -->


Diese Meldung taucht gewöhnlich mit der Obigen auf und bedeutet, daß BBClone
gerade erfolgreich Ihre Statistik aktualisiert hat.

<!-- BBClone v xxx KO: file xxx is read-only -->


Die Datei "xxx" ist für den Server nicht beschreibbar, jedoch ist dies
notwendig, um die Statistik aktualisieren zu können. Durch Anwenden von
"chmod 666" sollte dieses Problem behoben werden können.

<!-- BBClone v xxx KO: file xxx is inaccessible -->


Die Datei "xxx" an der angegebenen Stelle ist für den Server nicht zugänglich.
Sie müssen deren Attribute mittels "chmod 644" oder, falls sie sich im "var/"
Verzeichnis befindet, "chmod 666" verändern.

<!-- BBClone Error: _BBCLONE_DIR is undefined -->


Eine Datei wurde direkt aufgerufen, die jedoch nicht als Standalone Datei
gedacht war, weswegen diese die Ausführung verweigert, bis sie ordentlich durch
das Code Snippet initialisiert wurde.

Es gibt einige bekannte Einschränkungen:


PHP auf Solaris:

PHP 4.3.0 und anscheinend auch 4.2.3 leiden unter Solaris an einer
Fehlfunktion, die es unmöglich macht, relative Pfade zu verwenden. Die
empfohlende Lösung besteht darin, auf mindestens 4.3.1 zu aktualisieren, wo
dieser Fehler behoben wurde. Falls dies nicht möglich ist, müssen alle Passagen
mit relativen Pfaden zu Dateien von realpath() eingeschlossen werden.


PHP mit obskuren Dateisystemen:

Generell werden Teile des Skriptes nicht auf Netzwerk Dateisystemen
funktionieren.

BBClone innerhalb einer Funktion oder Klasse inkludieren

BBClone funktioniert nicht, wenn es innerhalb einer Funktion inkludiert wird.
Da ein inkludiertes Dokument den globalen Bereich seines Elterndokumentes erbt,
würden nur die Variablen der Funktion zur Verfügung stehen und das
Funktionieren BBClones vereiteln.

Inklusion und vom Elterndokument verschickte Header

BBClone sollte das letztmögliche sein, was in die Seite, die Sie erfassen
wollen, inkludiert wird. Wenn sie es früher einfügen, wird moglicherweise ein
anderes Skript beim Versenden von Headern oder durchführen eines Redirects
scheitern, da bereits schon Output zum Klienten geschickt wurde (Kommentare im
HTML Output). Falls sie die Inklusion an einer bestimmten Stelle durchführen
müssen, so folgen Sie bitte den Anweisungen in config.php zum Verwendung von
$BBC_NO_STRING.


Probleme mit kaputten Bildern

Manche Windows FTP Klienten möchten von *.png Bildern nichts wissen. Wenn
jedoch der Klient standardmäßig für unbekannte Dateitypen den ASCII
Übertragungsmodus verwendet, wird dieser die Bilddateien beschädigen. Als
Problemlösung sollten Sie dem FTP Klienten mitteilen, ihm unbekannte Dateien
als Binary zu übertragen


Zählen auf Servern mit deaktivierten Umgebungsvariablen

BBClone wird mit deaktivierten REMOTE_ADDR nicht funktionieren. Überhaupt ist
es unmöglich, irgendein Statistikprogramm laufen zu lassen, wenn diese Variable
nicht vorhanden ist. Daher gibt es dafür auch keinen lösungsvorschlaf.


Sollten irgendwelche Probleme auftauchen, so zögern Sie nicht unser BBClone
Forum auf http://forum.bbclone.de aufzusuchen

Das BBClone Team

###############################################
##   Hack Title:   Adding link in ACP
##   Hack Version:   1.0.0
##   Author:     Kipper
##   Description:   This hack adds a new link into your ACP which can link to anywhere you wish.
##   Compatibility:   2.0.6
##
##   Installation Level: Easy
##   Installation Time:  3 minutes
##   Files To Edit: 3
##      admin/index.php
##      language/lang_english/lang_admin.php
##      templates/subSilver/admin/index_navigate.tpl
##
##   History:
##      4th Jan 04:1.0.0:First Release - All in working order
##
##   Authors Notes:
##   Where you find NEW_LINK_NAME please change to the name you wish the link to be named. (Extra NOTE: Use '_' to seperate the words, and keep the same on every appearance)
##   Where you find NEW_LINK_HERE please change to the URL you wish the link to link to. (Extra NOTE: Use '_' to seperate the words, and keep the same on every appearance)
##
##
##   Support:      http://www.phpbbsupport.co.uk
##   Copyright:      ©2004 Adding link in ACP 1.0.0 - Kipper
##
###############################################
##
###############################################
##   This program is free software; you can redistribute it and/or
##   modify it under the terms of the GNU General Public License
##   as published by the Free Software Foundation; either version 2
##   of the License, or (at your option) any later version.
##
##   This program is distributed in the hope that it will be useful,
##   but WITHOUT ANY WARRANTY; without even the implied warranty of
##   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
##   GNU General Public License for more details.
##
##   http://www.gnu.org/copyleft/gpl.html
###############################################
#
#-----[ OPEN ]------------------------------------------
#
admin/index.php
#
#-----[ FIND ]------------------------------------------
#
      "U_ADMIN_INDEX" => append_sid("index.$phpEx?pane=right"),
#
#-----[ ADD, AFTER ]------------------------------------------
#
      "U_NEW_LINK_NAME" => append_sid("NEW_LINK_HERE"), 
#
#-----[ FIND ]--------------------------
#
      "L_PREVIEW_FORUM" => $lang['Preview_forum']) 
#
#-----[ REPLACE WITH ]--------------------------
#
      "L_PREVIEW_FORUM" => $lang['Preview_forum'],
#
#-----[ ADD, AFTER ]--------------------------
#
      "L_NEW_LINK_NAME" => $lang['NEW_LINK_NAME'])
#
#-----[ OPEN ]--------------------------
#
language/lang_english/lang_admin.php
#
#-----[ FIND ]--------------------------
#
$lang['Preview_forum'] = 'Preview Forum';
#
#-----[ ADD, AFTER ]--------------------------
#
$lang['NEW_LINK_NAME'] = 'NEW_LINK_NAME';
#
#-----[ OPEN ]--------------------------
#
templates/subSilver/admin/index_navigate.tpl 
#
#-----[ FIND ]--------------------------
#
<tr>

<td class="row1"><a href="{U_FORUM_INDEX}" target="main" class="genmed">{L_PREVIEW_FORUM}</a></td>

</tr> 
#
#-----[ ADD, AFTER ]--------------------------
#
<tr>

<td class="row1"><a href="{U_NEW_LINK_NAME}" target="main" class="genmed">{L_NEW_LINK_NAME}</a></td>

</tr>
#
#-----[ SAVE & CLOSE ALL FILES ]--------------------------
#
#End of Hack

Top 15 Visited Pages
Forum -> Portal 13464 21.71%
Forum -> Viewtopic 5098 8.22%
Forum 4873 7.86%
Viewtopic 3552 5.73%
Forum -> Viewforum 2996 4.83%
Forum -> Login 2883 4.65%
Forum -> Antirobot Pic 2800 4.51%
Main Site 2682 4.32%
Viewforum 2423 3.91%
Forum -> Posting 2197 3.54%
Login 2071 3.34%
Forum -> Profile 1944 3.13%
Forum -> Intro 1935 3.12%
Privmsg 1921 3.10%
Posting 1487 2.40%

// As default BBClone is writing a comment into the HTML source to indicate its
// current state. This output, however, may negatively affect some forums or
// content management systems. In case you are confronted with a blank page, a
// couple of "headers already sent by" messages or parts of your site not
// included in the statistics, you can set this option to suppress the output
// and make your scripts working again.
// Syntax:
// $BBC_NO_STRING = ""; => Show BBClone's comment in HTML source (default)
// $BBC_NO_STRING = 1; => Turn off BBClone's comments in HTML source
$BBC_NO_STRING = 1;