Thumbshots verwenden

Um den Thumbshots Service in die eigene Webseite einzufügen sind nur ein paar einfache Schritte nötig.

1. Thumbshot in eine statische HTML Seite einfügen

Nutzen Sie hierfür bitte das Formular unter:

    http://m-software.de/thumbshots/simple.php

Geben Sie dort den URL ein von dem Sie einen Thumbshot benötigen. Auch URLs wie z.B.
http://www.google.de/search?hl=de&q=thumbshots sind dabei kein Problem. Der Thumbshots Generator
kann von jeder Webseite im Internet ein Vorschaubild erzeugen. Egal ob statisch oder dynamisch.

2. Thumbshot in ein PHP Skrip einfügen

Sie können den Thumbshots Webservice in Ihr PHP Skript einfügen indem Sie folgenden Codeblock verwenden.


function getThumbshotCode ($url, $scale = 6)
{
    $baseurl  = "http://m-software.de/screenshot/Screenshot.png";
    $owidth   = 900;
    $oheight  = 600;
    $url      = urlencode ($url);
    $width    = $owidth / $scale;
    $height   = $oheight / $scale;
    $thumburl = $baseurl . "?url=" . $url . "&scale=" . $scale;
    $code     = "<img src='$thumburl' width='$width' height='$height'/>";
    return $code;
}

echo "Test:<br>";
echo getThumbshotCode("http://www.google.de");

Die Funktion kann belibig verändert, erweitert, angepasst und weitergegeben werden. Bei der Funktion handelt
es sich nur um ein Beispiel. Jedem Programmierer ist selbst überlassen, wie er die Thumbshots einbindet.

3. Wichtiger Hinweis zur Nutzung!

  • Die Nutzung des Thumbshot Webservice von M-Software.de ist und bleibt 100% Kostenlos.
  • Webmaster die den Service auf ihren Webseiten verwenden möchten sind herzlich eingaladen dies zu tun. Einzige Bedingung ist die Anbingung eines Links auf www.m-software.de mit dem Text Thumbshots powered by M-Software.de oder einem Button. Ein paar Beispiele (HTML Code) für den Link gibt weiter unten
  • Webmaster die eine Lizenz der Software für einen eigenen Server erwerben möchten, melden sich bitte unter [email protected].

4. Thumbshot Hinweise und Details

Der URL für die Thumbshots ist:

    http://m-software.de/screenshot/Screenshot.png

Es gibt folgende Parameter die per GET übertragen werden müssen.

url Die Webseite von der ein Thumbshot erstellt werden soll. Pflichtfeld
scale Skalierung des Thumbshots zwischen 2 und 10 Optional (default=6)
width Die Breite des Thumbshots. Der Wert darf zwischen 75 und 450 sein. Optional (default=150)
height Die Höhe des Thumbshots. Der Wert darf zwischen 50 und 300 sein. Optional (default=100)
Bei dem Parameter URL ist noch darauf zu achen, dass der Wert URL-kodiert ist. Details
zu der PHP Funktion string urlencode(string str)
gibt es unter http://de3.php.net/urlencode.

Beispiel:

http://m-software.de/screenshot/Screenshot.png?url=http://m-software.de/

Hinweis: Wenn es mal bei einer Webseite nicht funktioniert und das Bild leer bleibt, kann es daran liegen, dass die Webseite nicht innerhalb der Timeout Zeit aufgerufen werden konnte. In dem Fall bricht der Prozess ab. Allerdings werden defekte Thumbshots in der Nacht automatisch gelöscht und am nächsten Tag wird der Thumbshot automatisch neu erstellt.
Die Timeout Zeit wird dann erreicht, wenn eine Webseite eine zu lange Ladezeit hat oder wenn der Thumbshots Service überlastet ist. Dies passiert aber nur, wenn sehr viele Thumbshots gleichzeitig generiert werden sollen, die sich noch nicht im Cache befinden. Ist ein Thumbshot einmal generiert, bleibt er eine definierte Vorhaltezeit im Cache. Diese Vorhaltezeit ist variabel. Momentan ist der Wert auf 60
Tage eingestellt.

Um derartige Probleme zu vermeiden, ist es möglich eine Liste mit URLs an [email protected] zu senden. Ich werde diese Liste dann sequenziell in einem Skript abarbeiten ohne dass der Service überlastet wird. In diesem Skript werden bis 10 Thumbshots pro Minute generiert.

Weiterführende Themen:

  1. Thumbshots Technik
  2. Thumbshots Architektur
  3. Thumbshots