ColorRating als Modul (Snippet)

ColorRating, ist ein auf jQuery und PHP basierendes "Ajax 5 Sterne" Bewertungs-Script von Jack Moore, dem Entwickler des ColorBox Scriptes. ColorRating bringt seine eigene SQLite Datenbank mit und erfordert keinerlei Administration. Weiterhin verfügt es über eine IP-Sperre so dass pro IP-Adresse nur einmal abgestimmt werden kann.

Die Idee war ein Bewertungsscript zu haben, welches in nahezu allen WB Modulen einsetzbar ist - und das so einfach wie möglich. Herausgekommen ist dabei das ColorRating Modul (Snippet) und ein Droplet.

Das Modul setzt wie immer mindesten WebsiteBaker 2.8 und  jQuery 1.3.2 voraus welches im Head des Templates, so wie schon in früheren Tutorials beschrieben, eingebunden ist. Ihr Hostingpaket sollte weiterhin SQLite unterstützen.

Nach dem Download installieren Sie das Modul wie gewohnt im WebsiteBaker Backend über Erweiterungen > Module. Im Modul-Ordner ColorRating gibt es einen Ordner "database". Dieser Ordner muss beschreibbar sein. Sollte das Script nicht funktionieren müssen Sie diesen Ordner per FTP auf 777 setzen.

Danach gehen Sie auf Admin-Tools > Droplets und wählen "Hinzufügen Droplet".

Droplet-Code

$return_value = true;
if(function_exists('rating_form'))
{
    ob_start();
    rating_form($table);
    $rating_content = ob_get_contents();
    ob_end_clean();
    $return_value = $rating_content;
}

return $return_value;

Wenn Sie nun auf "speichern" klicken haben Sie es schon geschafft und ColorRating ist einsetzbar. An der Stelle wo nun das Bewertungs-Script erscheinen soll brauchen Sie nur noch den Droplet-Aufruf einzutragen. Dies kann per Hand erfolgen oder im FCK Editor über den Button Droplet.

Das Droplet wird wie folgt aufgerufen:

[ [ColorRating?table= ein eindeutiger Name] ]

Wie schon erwähnt speichert das Script die Bewertungen in eine eigene SQLite Datenbank. Damit Sie das Script mehrmals, auf verschiedenen Seiten, einsetzen können bekommt jeder Scriptaufruf seine eigene Tabelle in dieser Datenbank. Deshalb müssen Sie im Dropletaufruf nach dem "?table= " einen eindeutigen Namen angeben. Rufen Sie das Script auf einer anderen Seite mit einem Table-Namen auf der schon vorhanden ist, bekommen Sie das Ergebnis dieser Bewertung zu sehen. So ist es z.B. möglich eine Übersichtsseite aller Bewertungen zu zeigen auf der dann auch noch einmal das Gewünschte bewertet werden kann.

Das fertige Ergebnis sollte dann so wie hier aussehen und funktionieren.

zurück