Allgemeines zur Top 10-Funktion

Die Top 10-Liste zeigt die Top-Verkäufe im PotatoSystem an. Eingebunden ist die Liste z.B. auf der PotatoSystem-Startseite. Diese Liste ist auch als RSS2.0 und ATOM-Feed erhältlich. Die Top 10-Liste bietet darüber hinaus noch viele weitere Anpassungsmöglichkeiten worauf ich hier eingehen werde.

Top 10-Liste selbst einbauen

Die Liste kann selbst leicht in eine bestehende Seite eingebunden werden (z.B. als per iFrame-Tag in HTML). Die Adresse der Top 10-Liste lautet: http://data.potatosystem.com/process/topten

RSS-Feeds

Die Adresse für Top 10-Liste als RSS2.0 Feed lautet: http://data.potatosystem.com/process/topten?rss

und als ATOM Feed: http://data.potatosystem.com/process/topten?rss&atom

In den Feeds ist der Titel, der Künstler, der Verkaufslink und der Beschreibungstext des Albums bzw. der Datei enthalten. Weiterhin werden Alben besonders markiert. Zusätzlich sind die Cover im Beschreibungsfeld enthalten, sofern ein Cover bei der Registrierung definiert wurde. Die Genre der Alben bzw. der Dateien sind gleichzeitig die Kategorien des Feeds. Man kann so in einem entsprechenden Feed-Reader sich die Liste nach Genre filtern lassen (z.B. Internet Explorer 7).

Anpassungsmöglichkeiten der Liste

Anzahl der Einträge

Gibt man keinen weiteren Parameter an so wird immer die Top 10 Liste angezeigt. Es ist möglich den Parameter top dranzuhängen und anzugeben wieviele Einträge man wünscht. Beispiel: http://data.potatosystem.com/process/topten?top=20 gibt einen die Top 20 Liste zurück. Die größte Liste die zurückgegeben werden kann ist die Top 50 Liste! Der Parameter ist auch bei den RSS-Feeds nutzbar.

Filtern nach Nutzer

Die Liste kann auch nach Nutzern gefiltert werden. Dazu ist die jeweilige Nutzernummer nötig (zu finden wenn man sich im System einloggt gleich auf der Seite nach dem Einloggen oder in der Willkommensmail die nach der Registrierung verschickt worden ist). Der Parameter dazu heißt userNumber. Beispiel: http://data.potatosystem.com/process/topten?userNumber=12345 liefert die Top 10 zurück des Benutzers mit der Nutzernummer 12345. ACHTUNG: Es können nur die Einträge geliefert werden die auch in der normalen Top 50 enthalten sind. Hat der jeweilige Nutzer z.B. keine Artikel die in der Top 50 enthalten sind, so werden auch keine Artikel in der gefilterten Liste angezeigt. Hat der Nutzer z.B. nur 3 Artikel in der Top 50 drin, so werden auch max. 3 Artikel in der gefilterten Liste angezeigt. Der Parameter kann auch in den Feeds verwendet werden.

Anzeigen der Cover

Um auf bestimmten Plätzen die Cover anzuzeigen ist der cover-Parameter anzuhängen. Beispiel: http://data.potatosystem.com/process/topten?cover=1-2-3 zeigt die jeweiligen Cover der Artikel auf Platz 1-3- Ist kein Cover definiert so wird ein Platzhalterbild eingefügt.

Angabe der dargestellten Zeichen

Da manche Titel bzw. Künstlernamen sehr lang sind und nicht in die schmale Liste passen würden, werden die Namen gekürzt dargestellt. Standard ist hier 14 Zeichen. Mit den Parameter tLength kann angegeben werden nach wieviel Zeichen der Text eingekürzt werden soll. Beispiel: http://data.potatosystem.com/process/topten?tLength=20 kürzt den Text nach 20 Zeichen ein.

Angabe der Breite

Ist auf der Seite wo die Top 10 Liste angezeigt werden soll mehr Platz zur Verfügung, so kann die Liste breiter dargestellt werden. Dazu muss der Parameter length eingefügt werden. Wenn nichts angegeben wird, ist die Liste 145 Pixel breit. Beispiel: http://data.potatosystem.com/process/topten?length=200 setzt die Breite der Liste auf 200 Pixel fest. Dieser Parameter sollte mit dem tLength-Parameter kombiniert werden.