akeller's world » Anleitung

Anpassung von Semantic Scuttle (Tutorial Teil 2)

Andreas — Sat, 09 Aug 2008 16:38:33 +0000

Nachdem wir im ersten Teil Semantic Scuttle auf unserem Webserver installiert haben, wollen wir nun ein paar Anpassungen vornehmen.

Cleanurls

Klickst du in der Navigationsleiste von Semantic Scuttle auf populäre Tags siehst du, daß als Internetadresse http://domain.xxx/populartags.php/ aufgerufen wird.

Dies sieht nicht besonders schön aus und Semantic Scuttle bietet die Möglichkeit das zu verändern. Als Resultat sollte dann beim Aufruf der poulären Tags http://domain.xxx/populartags/ in der Adressenleiste stehen. Diese Funktion wird mittels einer Datei .htaccess realisiert. ACHTUNG: Nicht jeder Webserver unterstützt dies.

Öffne wieder die Datei “config.inc.php” und setze $cleanurls auf true
$cleanurls = true;
Speicher die Datei und teste ob die Einstellung funktioniert. Sollte alles funktionieren bist du schon fertig und kannst die nächsten Punkte überspringen.
Geht es bei dir nicht, dann öffne die Datei .htaccess (im Root der Installation, ggf. mußt du in deinem FTP-Programm “zeige versteckte Dateien” aktivieren um die Datei zu finden). In Zeile 29 und 30 findest du:
RewriteRule ^([^/]+)/?(.*) $1.php?query=$2 [L,QSA] #option 1 #RewriteRule ^([^/]+)/?(.*) $1.php/$2 [L] #option 2
Füge in Zeile 29 ein # ein und entferne es aus Zeile 30:
#RewriteRule ^([^/]+)/?(.*) $1.php?query=$2 [L,QSA] #option 1 RewriteRule ^([^/]+)/?(.*) $1.php/$2 [L] #option 2
Speicher die Datei und teste ob es jetzt funktioniert.
Sollte es immer noch nicht klappen, dann öffne die Datei “constants.inc.php” und kommentiere die Zeile 21 bis 23 oder löschen den ganzen Block:
// Correct bug with PATH_INFO (maybe for Apache 1) // if(strlen($_SERVER["PATH_INFO"]) // $_SERVER["PATH_INFO"] = $_SERVER["ORIG_PATH_INFO"]; //}
Speicher die Datei und versuche es erneut.

Sollten bei dir die Cleanurls nicht laufen wollen, dann kannst du mir hier einen Kommentar hinterlassen und ich werde versuchen eine Lösung zu finden. Bitte prüfe aber vorher, ob dein Webserver überhaupt .htaccess unterstützt.

Valid XHTML 1.1?

Ruf einmal in deinem Lieblingsbrowser den W3-Validator auf und gib die Adresse deiner Semantic Scuttle Installation ein. Das Ergebnis sind 28 Errors und 19 Warnings, das ist schwer verbesserungswürdig, falls wir von den Suchmaschinen geliebt werden wollen.

Falls du den Fehler: “cannot generate system identifier for general entity “PHPSESSID”.” bekommst, öffne die Datei “index.php” und füge in Zeile 21 vor
require_once('header.inc.php');
folgendes ein:
ini_set('arg_separator.output','&');
Öffne die Datei /templates/bookmarks.tpl.php und suche:
echo '';
Füge vor src=”http://…. ein alt=”" ein:
und verändere die & in screener.php?sdx=1024&sdy=768&w=90&h=68&url='.$address.'" und am Schluß fehlt noch ein /: $address.'" />';


Beim erneuten Überprüfen zeigt der Validator nur noch einen Fehler an.
Line 28, Column 150: document type does not allow element "input" ...Diesen konnte ich bisher auch noch nicht beseitigen, werde aber die Lösung nachreichen, sobald ich sie gefunden habe.
Anderer Thumbnail-Dienst
Da wir gerade in der Datei /templates/bookmarks.tpl.php schon an der richtigen Stelle waren.
echo '
http://www.artviper.net/screenshots/screener.php?sdx=1024&sdy=768&w=90&h=68&url='.$address.'">';

 Hier wird der Dienst für die Generierung der Thumbnails bestimmt. Möchte man den voreingestellten Dienst von artviper.net benutzen sollte man folgendes beachten:

Der Dienst ist nur für nicht-kommerziellen Seiten kostenlos, du solltest aber auf den Dienst verlinken.
Für kommerzielle Projekte kann hier eine Lizenz erwerben.

Von Zeit zu Zeit dauert die Erstellung von Thumbnails mit artviper sehr lange, aus diesem Grund bin ich auf die Suche nach einen alternativen Dienst gegangen.

Websnapr.com
Schneller und zuverlässiger Dienst, keine Registrierung nötig, Premium-Dienst verfügbar. Nachteil: Thumbnail trägt den Text “by Websnapr.com
M-Software.de
Auch für die kommerzielle Nutzung kostenlos, keine Registrierung nötig.

 Einschränkungen bezüglich Content z.B. keine Pornographie.

 Nachteil: Erstellung der Thumbnails dauern etwas.
Seekxl Snapr.de
Kostenlos, ein Backlink ist verpflichtend ein Backlink ist nicht verpflichtend. Ist man registriert kann man das Vorschaubild austauschen falls das Thumbnail noch nicht generiert ist, dann ist jedoch ein Backlink zum Dienst nötig.
Mr-Thumb.de
Kostenlos, Erstellung der Thumbnails könnte etwas schneller gehen. 
www.webseitentuning.de
Kostenlos, leider sehr langsam.
livethumb.de
Kostenlos, Wasserzeichen; “preview by liveThumb” falls ein Backlink nicht oder nicht richtig eingebunden ist. Relativ schnell und zuverlässig
picoshot.com
Kostenlos und schnell, hat aber manchmal Probleme bei der Erzeugung von Thumbnails.
www.shrinktheweb.com
Kostenlos für 250.000 Abrufe monatlich, Pro-Features gegen Bezahlung. Registrierung nötig. Schnell und zuverlässig. Besonderheit: Kann mit dem ‘http://’ im Aufruf nichts anfangen. Lösung:

$n_address = substr($address, 7);

und Aufruf mit: Url=’.$n_address.’

capture.heartrails.com/
Falls du Japanisch verstehst, dann ist dieser Service vielleicht etwas für dich.

 
Alle Thumbnail-Dienste möchten gerne einen Backlink (Rückverlinkung auf ihren Dienst) haben oder verlangen diesen sogar explizit. Ich denke, das ist schon OK, wirklich kostenlos ist doch eigentlich nichts. Deshalb werden wir und gleich damit beschäftigen, wo wir diesen Link am besten einbauen.
Vielleicht hast du ja noch einen Tip bzgl. Thumbnail-Dienst?
Die Templates
Die Anzeige unserer Semantic Scuttle Installation wird mittels verschiedener Dateien realisiert, einige davon sind:

Kopf (header): /templates/top.tpl.php
Hier bietet es sich an ein paar Meta-Tags einzufügen
Fuß (footer): /templates/bottom.tpl.php
Im Fuß könnte man den Backlink zum Thumbnail-Dienst unterbringen.
“Über”-Seite: /templates/about.tpl.php
Für ein Impressum würde sich diese Seite ganz gut machen.

Über die Veränderung des Styles werde ich vielleicht bald etwas schreiben.
Bug: Tags umbenennen
In Semantic Scuttle Version 0.89 gibt es einen kleinen Bug, das Umbenennen von Tags funktioniert nicht. Die Lösung stammt von Andreas Glaeser.
Öffne die Datei “tagrename.php” und füge in Zeile 23 nach "require_once('header.inc.php');" folgendes ein:
$tagservice = & ServiceFactory :: getServiceInstance('TagService');
Danach öffne die Datei “/services/tagservice.php” ab Zeile 69 findest du die Funktion “renameTag” füge dieser Funktion ein “return true;” hinzu, sollte dann so aussehen:
    function renameTag($uId, $oldName, $newName) {

	$query = 'UPDATE `'. $this->getTableName() .'`';

	$query.= ' SET tag="'.$newName.'"';

	$query.= ' WHERE tag="'.$oldName.'"';

	$query.= ' AND uId="'.$uId.'"';

	$this->db->sql_query($query);

    return true;

    }
Jetzt sollte die Umbenennung von Tags auch in deiner Installation funktionieren.
Dies war nun der zweite Teil des Tutorials, falls er dir gefallen oder geholfen hat gib mir doch bitte ein kurzes Feedback durch einen Kommentar. Falls ich den Eindruck habe mit meinen Beiträgen auch jemanden zu erreichen, werde ich mich dann an den nächsten Teil machen.



Installation von Semantic Scuttle 0.89
Andreas — Sun, 03 Aug 2008 13:07:04 +0000


Semantic Scuttle ist ein Opensource Social Bookmark System und eine Weiterentwicklung von Scuttle. Einige bekannte Betreiber verwenden Scuttle, z.B. Alltagz.
Wie man Semantic Scuttle installiert und anpasst möchte ich hier in einem kleinen Tutorial beschreiben.

Für die Installation benötigst du einen Webserver mit PHP und MySQL. Es scheinen auch andere Datenbanken möglich, dies habe ich jedoch nicht ausprobiert.
Installation

Download Semantic Scuttle von Sourceforge.net, zur Zeit ist die aktuellste Version 0.89.
Entpacke das Zip-File und lade die Files auf deinen Webserver.
Importiere die Datei „tables.sql“ in deine Datenbank. Am einfachsten geht das mit phpMyAdmin.
Benenne die Datei “config.inc.php.example” um in “config.inc.php” und öffne sie in einem Editor. Diese Datei enthält alle grundlegenden Einstellungen des Systems.

Einstellungen in der “config.inc.php”
Grundlegende Einstellungen
$sitename           = 'SemanticScuttle';
Hier gibst du den Namen deiner Seite an, diese wird dann im Kopfbereich angezeigt.
$welcomeMessage     = 'Welcome to SemanticScuttle! More than a social
bookmarking tool.';
Dies ist die Willkommen-Nachricht, sie wird über den Bookmarks angezeigt.
$root               = NULL;
Wenn hier NULL steht wird versucht die Rootadresse der Webseite automatisch zu ermitteln. Falls sich die Installation in einem Unterverzeichnis befindet, dann gib hier die Adresse an, z.B. “www.meinewebseite.xx/semanticscuttle/”.
$locale             = 'en_GB';
Hier kann die Sprache der Seite eingestellt werden, für Deutsch verwende ‘de_DE’
$usecache           = false;
Das Cachesystem ein oder ausschalten, fürs erste lassen wir hier false
$dir_cache          = dirname(__FILE__) .'/cache/';
Pfadangabe fürs Cachesystem, dort werden die gecachten Dateien gespeichert.
$cleanurls          = false;
Hier kann die Verwendung “schöner urls” gewählt werden, fürs erste lassen wir diese Funktion deaktiviert also false
Datenbank
$dbtype = 'mysql4';
Hier kann der Treiber für die verwendete Datenbank gewählt werden, für mysql lassen wir es auf mysql4
$dbhost = '127.0.0.1';
$dbport = '3306';
In über 99% aller Fälle brauchst du hier nichts zu ändern.
$dbuser = 'username';
$dbpass = 'password';
Hier gibst du den Benutzername und das Passwort für die Anmeldung deiner Datenbank an.
$dbname = 'scuttle';
Hier mußt du den Namen deiner Datenbank eintragen.
$tableprefix = 'sc_';
Der Prefix der Tabellen in der Datenbank. Hast du die Datei “tables.sql” in deine Datenbank importiert, dann ist die Einstellung ’sc_’ OK.
Benutzer
$adminemail         = 'admin@example.org';
Diese Emailadresse wird verwendet, falls ein User sein Passwort vergessen hat und ein neues anfragt.
$admin_users = array('admin');
Bisher haben wir noch keine User aber hier solltest du schon einmal deinen Login-Namen angeben. Falls es mehrere Administratoren gibt, dann verwende
array(’name1′, ‘name2′, ‘name3′);
$reservedusers      = array('all', 'watchlist');
Hier kannst du angeben welche Benutzernamen es nicht geben darf
Antispam
Für die Registrierung gibt es eine einfache Antispam-Frage, hier kannst du sie einstellen.
$antispamQuestion = 'name of this application (no Caps)';
Die Frage, z.B. =’Wieviel ergibt 2 plus 3′;
$antispamAnswer = 'semanticscuttle';
Die Antwort, z.B =’5′;
Den weiteren Bereich der Datei lassen wir fürs erste wie er ist, wir wollen doch schnell unser System zum laufen bringen.  

Speicher die Datei “config.inc.php” und lade sie auf deinen Webserver.
Rufe in deinem Webbrowser die Seite auf. Hat alles geklappt siehst du:



	


Startseite von Semantic Scuttle
Als User registrieren
Jetzt solltest du dich als User registrieren. Klicke dazu auf den Link “registrieren” rechts oben.


	


Benutzerregistrierung
Fülle das Formular aus und klicke auf den Button registrieren. Du kommst wieder auf die Startseite und bist jetzt als User angemeldet.


	


Startseite mir angemeldeten Benutzer
Bookmark hinzufügen
Als nächstes wollen wir ein Bookmark hinzufügen, dazu klicke auf den Link “Favorit hinzufügen”.


	


Favorit hinzufügen
Unter Bookmarklet findest du zwei nützliche Links, diese kannst du auf die Lesezeichen-Symbolleiste deines Browsers ziehen. Besonders die zweite Version (Pop-up) finde ich sehr nützlich. Klickst du das Bookmarklet wenn du auf einer Seite bist öffnet sich ein Pop-up (Achtung: ggf. Blocker deaktivieren) und du kannst die Seite sehr komfortabel zu seinen Online-Bookmarks hinzufügen.


	


Popup Favorit hinzufügen
Unter Importieren hast du die Möglichkeit bestehende Bookmarks zu importieren.
Nachdem du auf den Button “Favorit hinzufügen” geklickt hast kommst du wieder auf die Startseite:


	


Semantic Scuttle mit dem ersten Bookmark
Du hast gesehen, wie einfach es ist Semantic Scuttle zu installieren. In den nächsten Tagen geht es dann weiter mit einem Artikel über weitere Anpassungen von Semantic Scuttle.

Weiter geht es mit dem zweiten Teil: Anpassung von Semantic Scuttle