Leitfaden zur Erstellung benutzerdefinierter Schaltflächen für Google Toolbar 4 für Internet Explorer

Inhaltsverzeichnis

Einführung

Was ist eine benutzerdefinierte Schaltfläche?

Eine benutzerdefinierte Schaltfläche ist eine Schaltfläche, die Sie zur Google Toolbar hinzufügen können. Diese Schaltfläche kann über benutzerdefinierte Navigations-, Such-, Sende- und Aktualisierungsfunktionen verfügen. Darüber hinaus kann eine benutzerdefinierte Schaltfläche die Suchmaschine beinahe jeder Website verwenden, nicht nur die Google-Suchmaschine.

Beim Klicken auf eine Suchschaltfläche werden folgende Aufgaben ausgeführt:

• Navigieren des Browsers zu einer Website, ähnlich wie ein Lesezeichen
• Navigiert den Browser zu einer Website und sucht in der Suchmaschine dieser Website nach dem Text, den der Nutzer in das Suchfeld der Toolbar eingegeben hat. Beispielsweise würde eine Wikipedia-Schaltfläche wikipedia.org öffnen und dort nach dem Begriff suchen, den Sie eingegeben haben. (Je nach dem Gebietsschema der Toolbar wird bei gebietsschema-spezifischen Websites die Seite für Ihr Gebiet geöffnet.)
• Senden des markierten Browser-Texts an einen Service, um eine neue E-Mail, einen neuen Blog-Eintrag oder eine Textnachricht zu verfassen.
• Aktualisieren des Symbols und der Tooltipps sowie der Dropdownliste von Symbolen und Zeichenfolgen der Schaltfläche über einen RSS-Feed

Eine benutzerdefinierte Schaltfläche kann über die folgenden Funktionen der Benutzeroberfläche verfügen:

• Ein Symbol, das die Website repräsentiert, auf die die Schaltfläche zugreift, oder die Aktion, die durch die Schaltfläche ausgeführt wird (<icon>). Dieses Symbol kann über einen RSS-Feed aktualisiert werden (<feed>)
• Eine Dropdown-Liste mit Symbolen und Zeichenfolgen, auf die Sie zugreifen können, indem Sie auf die Schaltfläche mit dem Pfeil nach unten klicken. Diese Liste kann über einen RSS-Feed aktualisiert werden, wie z. B. Schlagzeilen aus einem News-Feed (<feed>)
• Eine Tooltipp-Beschreibung, die kurz angezeigt wird, wenn der Mauszeiger auf die Schaltfläche zeigt (<description>)
• Ein Titel, der optional neben der Schaltfläche angezeigt werden kann (<title>)

Zusätzlich zu Eigenschaften für die oben genannten Funktionen der Benutzeroberfläche kann eine benutzerdefinierte Schaltfläche über die folgenden Eigenschaften (in einer XML-Datei gespeichert) verfügen, die die oben genannten Aufgaben erfüllen.

• Eine Website-URL, zu der der Browser navigiert wird, wenn das Suchfeld leer ist und die Schaltfläche betätigt wird (<site>)
• Eine Such-URL, die auf eine Website verweist, zu der der Browser navigiert wird und die durchsucht wird, wenn die Schaltfläche betätigt wird und ein Suchbegriff in das Suchfeld eingegeben wurde (<search>)
• Eine Sende-URL, die auf eine Website verweist, zu der der Browser navigiert wird und an die der markierte Text gesendet wird (<send>)
• Eine Aktualisierungs-URL, unter der auf Aktualisierungen für die Schaltfläche zugegriffen werden kann (<update>)

Die folgende Toolbar zeigt Beispiele von benutzerdefinierten Schaltflächen für Slashdot, Wikipedia und BBC (hervorgehoben). Die Schaltfläche "BBC" ist ein News-Feed mit einer Dropdown-Liste mit Schlagzeilen (erkennbar durch die Schaltfläche mit dem Pfeil nach unten).

Hinzufügen einer benutzerdefinierten Schaltfläche

So fügen Sie benutzerdefinierte Schaltflächen zur Google Toolbar hinzu und verwalten diese:

• Die einfachste und häufigste Methode, eine benutzerdefinierte Schaltfläche hinzuzufügen (zu installieren), besteht darin, direkt auf der Website des Publishers auf eine Schaltfläche zu klicken und zu bestätigen, dass Sie die Schaltfläche hinzufügen möchten. Eine Liste solcher Schaltflächen finden Sie in der Schaltflächen-Galerie von Google Toolbar. Der Publisher verwendet eine spezielle Befehls-URL, die eine Bestätigung durch den Nutzer erfordert. Wenn der Nutzer die Google Toolbar nicht installiert hat, öffnet die Befehls-URL die Toolbar-Downloadseite.
• Die zweite Methode ist das automatische Erstellen und Hinzufügen einer benutzerdefinierten Schaltfläche, bei der ein Nutzer mit der rechten Maustaste auf ein Such-Texteingabefeld klickt.
• Die dritte Methode ist das Bearbeiten einer benutzerdefinierten Schaltfläche mithilfe des erweiterten Editors der Google Toolbar, den Sie öffnen können, indem Sie auf "Einstellungen" > "Optionen" > "Benutzerdefinierte Schaltflächen" (Registerkarte) > "Bearbeiten" > "Den erweiterten Editor verwenden" klicken.
• Die vierte Methode ist das manuelle Erstellen und Installieren einer benutzerdefinierten Schaltfläche.
• Die fünfte Methode, die von einem IT-Administrator verwendet werden kann, funktioniert wie folgt: Benutzerdefinierte Schaltflächen können auf Windows-Computern veröffentlicht werden, indem mit einer XML-Datei eine Gruppenrichtlinien-Zeichenfolge auf eine URL angewendet wird, oder indem ein Wrapping für das Installationsprogramm erfolgt, sodass im Windows-Dateisystem im Bereich "Anwendungsdaten" für "All Users" eine Datei geschrieben wird.

Erstellen von benutzerdefinierten Schaltflächen

Automatisches Erstellen und Hinzufügen einer benutzerdefinierten Suchschaltfläche

1. Öffnen Sie Internet Explorer und rufen Sie die Suchseite auf, für die Sie eine Suchschaltfläche erstellen möchten.
   Beispiel: www.wikipedia.org

2. Klicken Sie mit der rechten Maustaste auf das Suchfeld der Seite, die Sie verwenden möchten, und klicken Sie auf "Hinzufügen".

Ergebnis: Die benutzerdefinierte Schaltfläche wird installiert und kann sofort verwendet werden.

Im Hintergrund erstellt dieser Vorgang eine XML-Datei für die benutzerdefinierte Schaltfläche mit einem Symbol und speichert diese unter einem Hash-Namen in folgendem Verzeichnis:

C:\Documents and Settings\larry\Local Settings\Application Data\Google\Custom Buttons\

Dieser Ansatz hat gegenüber dem manuellen Erstellen einer benutzerdefinierten Schaltfläche den Vorteil, dass er geeignet ist für Websites, die komplexe POST-Anfragen oder Umleitungen verwenden, die die Ermittlung des url-template erschweren.

XML-Datei einer benutzerdefinierten Schaltfläche

Die Eigenschaften und die Funktion einer benutzerdefinierten Schaltfläche sind in einer XML-Datei definiert, die über ein <custombuttons>-Element verfügt, dessen Namespace "http://toolbar.google.com/custombuttons/" lautet und ein geschachteltes Element <button> aufweist. Die einfachste benutzerdefinierte Schaltfläche verwendet <site>, wodurch ein Link zu einer Website definiert wird. Durch den folgenden XML-Code wird eine Schaltfläche erstellt, die bei Betätigung die Website http://www.wikipedia.org im aktuellen Browserfenster öffnet.

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">

  <button>
    <site>http://www.wikipedia.org</site>
  </button>
</custombuttons>

HINWEIS: Sie können Zeilenwechsel und Leerzeichen in URL-Zeichenfolgen in der XML-Datei verwenden; diese werden beim Interpretieren der Datei durch die Toolbar entfernt. Das bedeutet: Wenn Ihre URL Leerzeichen erfordert (diese also nicht entfernt werden sollen), müssen diese durch "%20" ersetzt werden (falls Ihr Browser dies nicht bereits durchgeführt hat). In vielen der folgenden Beispiele ist die URL in zwei Zeilen eingegeben, die durch einen Zeilenwechsel in der Mitte der URL getrennt sind. Dies funktioniert problemlos.

HINWEIS: In den Beispielen dieses Leitfadens ändert sich nur der Teil des XML-Code innerhalb des Elements <button>.

Manuelles Erstellen und Installieren einer benutzerdefinierten Schaltfläche

So installieren Sie eine benutzerdefinierte Schaltfläche in der Google Toolbar:

1. Erstellen Sie eine XML-Datei für die Schaltfläche, wie im vorherigen Abschnitt (und den folgenden Abschnitten) beschrieben.
2. Speichern Sie die XML-Datei für die Schaltfläche unter:

   C:\Documents and Settings\username\Local Settings\Application Data\Google\Custom Buttons\filename.xml

   wobei username Ihr Windows-Anmeldename und filename der Dateiname ist, den die XML-Datei haben soll.

   In unserem Wikipedia-Beispiel speichern Sie die XML-Datei für die Schaltfläche für den Anmeldenamen "Larry" unter:

   C:\Documents and Settings\larry\Local Settings\Application Data\Google\Custom Buttons\wikipedia.xml

3. Öffnen Sie dann ein neues Internet Explorer-Fenster mit installierter Google Toolbar 4.0. Eine neue Schaltfläche wird als Fragezeichen angezeigt, wie im folgenden Screenshot dargestellt. Klicken Sie auf das Fragezeichen, um Wikipedia zu öffnen.

   

Hinzufügen eines Titels und eines Tooltipps zu einer Schaltfläche

Wie im Folgenden dargestellt, können Sie <title> verwenden, um einer Schaltfläche einen Titel zuzuordnen. Der Titel kann rechts neben einer Schaltfläche angezeigt werden (Einstellungen > Optionen > Mehr > Schaltflächentext > Gesamter Text) und identifiziert die Schaltfläche in der Liste der benutzerdefinierten Schaltflächen (Einstellungen > Optionen > Benutzerdefinierte Schaltflächen). Wenn Ihre Schaltfläche über eine Suchfunktion verfügt, sollte der Titel für keine andere benutzerdefinierte Suchschaltfläche verwendet werden, da er auch als Name der Schaltfläche im Suchfeld der Google Toolbar fungiert. (Beispielsweise kann der Nutzer das Suchfeld mit "Alt + G" aufrufen, auf die Pfeiltaste nach unten klicken, um das Menü der Suchmaschine zu öffnen und "w" in das Suchfeld eingeben, um die Suchmaschine "wikipedia" auszuwählen).

Verwenden Sie <description>, um einen Tooltipp hinzuzufügen.

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <site>http://www.wikipedia.org</site>

    <title>Wikipedia</title>
    <description>The Free Encyclopedia</description>
  </button>
</custombuttons>

Benutzerdefinierte Suchschaltfläche

Mithilfe der Google Toolbar können Sie eine Schaltfläche erstellen, mit der Sie die Suchmaschine beinahe jeder Website nach dem Text suchen lassen können, den Sie in das Suchfeld der Toolbar eingeben. Die nächsten beiden Beispiele enthalten eine Schaltfläche, mit der Sie wikipedia.org mithilfe der Wikipedia-Suchmaschine durchsuchen können, und eine weitere Schaltfläche, mit der Sie das Internet mithilfe der Google-Suchmaschine durchsuchen können.

Fügen Sie dazu ein Suchelement in Form des Codes <search> url-template </search> zur XML-Datei der Schaltfläche hinzu. Geben Sie eine Suchanfrage-URL an, indem Sie die Variable {query} verwenden, wie in den folgenden Beispielen demonstriert. Es sind sowohl GET- als auch POST-Anfragen möglich (durch das Attribut method spezifiziert) – GET ist die Standardeinstellung. Die URL muss auf http: oder https: basieren; javascript: ist nicht zulässig. Drei Zeichen in der URL-Vorlage müssen escaped sein: kleiner als (<), größer als (>) und das kaufmännische Und-Zeichen (&).

HINWEIS: Ein <search>-Element muss eine Variable {query} enthalten, damit die Schaltfläche angezeigt werden kann.

Benutzerdefinierte Schaltfläche für die Wikipedia-Suche

Wenn Sie beispielsweise eine Schaltfläche erstellen möchten, um mithilfe der Wikipedia-Suchmaschine eine Suche auf wikipedia.com durchzuführen, sollten Sie mit einer ganz einfachen Wikipedia-Suchanfrage nach einem einzelnen Begriff beginnen, zum Beispiel "dog": http://en.wikipedia.org/wiki/Special:Search?search=dog&fulltext=Search. Wenn Sie stattdessen nach dem Begriff suchen möchten, den der Nutzer in das Suchfeld der Toolbar eingibt, ersetzen Sie "dog" durch "{query}" und escapen Sie das kaufmännische Und-Zeichen (&) wie folgt:

<search>http://en.wikipedia.org/wiki/Special:Search?search={query}&amp;fulltext=Search</search>

Wenn wir dieses Suchelement zu unserer bisherigen Schaltfläche hinzufügen, erhalten wir:

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <site>http://www.wikipedia.org</site>

    <title>Wikipedia</title>
    <description>The Free Encyclopedia</description>
    <search>http://en.wikipedia.org/wiki/Special:Search?search={query}&amp;fulltext=Search</search>

  </button>
</custombuttons>

Beachten Sie, dass das kaufmännische Und-Zeichen (&) in der URL escaped wurde und nun "&" lautet. Für Zeichenfolgen in XML-Dateien müssen das kaufmännische Und-Zeichen (&) und die Zeichen "kleiner als" (<) und "größer als" (>) escaped werden.

Benutzerdefinierte Schaltfläche für die Google-Suche

Wenn Sie eine Schaltfläche erstellen möchten, um das Internet mithilfe der Google-Suchmaschine zu durchsuchen, sollten Sie mit einer ganz einfachen Google-Suchanfrage nach einem einzelnen Begriff beginnen, zum Beispiel "dog": http://www.google.com/search?q=dog. Ersetzen Sie nun "dog" wie nachfolgend gezeigt durch "{query}":

<search>http://www.google.com/search?q={query}</search>

Beispiel:

Slashdot-Suche

<search>http://slashdot.org/search.pl?query={query}</search>

Suchvorgang als POST senden

Zum Senden von Suchvorgängen als POST anstelle von GET fügen Sie ein Attribut method="post" in das Suchelement ein. Alle Zeichen nach dem letzten Fragezeichen "?" werden als www-URL-codierte Formular-Post-Daten gesendet. Es ist möglich, dass eine Website formularcodierte Daten anstelle von URL-codierten Daten verwendet. Dies wird derzeit jedoch nicht unterstützt. Es ist ebenfalls möglich, CGI-Parameter und Post-Daten gleichzeitig zu senden. Verwenden Sie dazu zwei Fragezeichen "?".

Suche über The Onion

Dieses Beispiel verwendet eine Post-Methode zum Senden von Post-Daten (markiert):

<search method="post">http://www.theonion.com/content/search/node
        ?edit%5Bkeys%5D={query}</search>

Aktualisieren einer benutzerdefinierten Schaltfläche

Die Download-URL, die Sie zum Hosten der XML-Datei für die Schaltfläche verwenden, ist die eindeutige ID für die Aktualisierung der Schaltfläche. Wenn ein zweiter Versuch vorgenommen wird, eine Schaltfläche von derselben URL herunterzuladen, schlägt die Toolbar vor, die alte Schaltfläche zu aktualisieren. Es wird keine neue Schaltfläche hinzugefügt.

Von den fünf Möglichkeiten, eine Schaltfläche hinzuzufügen, ist bei der ersten und letzten Möglichkeit automatisch klar, woher Aktualisierungen für die Schaltfläche stammen sollen. Jeder Wert <update>, der in die XML-Datei eingefügt wird, wird ignoriert. Bei den anderen drei Möglichkeiten können Sie das Element <update> in der XML-Datei festlegen, um anzugeben, wo nach Aktualisierungen für die Schaltfläche gesucht werden soll.

<update>http://buttons.com/updated_button.xml</update>

Schaltflächenoptionen

Eine Schaltfläche kann mithilfe des Tags <option> eine lokal definierte Optionszeichenfolge festlegen, die der Nutzer problemlos über das Dialogfeld "Einstellungen" der Toolbar bearbeiten kann. Dies ist beispielsweise hilfreich, wenn für eine Wetter-Schaltfläche eine Postleitzahl oder für eine Börsenkurs-Schaltfläche ein Börsenkursticker-Symbol angegeben werden soll. Beispiel:

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <title>Weather</title>
    <option>

      <title>Zip code</title>
      <description>Enter a US zip code.  For example, 94043 is Mountain View, CA</description>
      <default>94043</default>
    </option>

    <site>http://www.google.com/search?q=weather+{option1}</site>
  </button>
</custombuttons>

Der Optionstitel ist erforderlich. Der Standardwert und die Beschreibung sind optional. Verwenden Sie die Variable {option1} innerhalb einer Spezifikation in einer URL-Vorlage, um den Text des Nutzers einzufügen.

Derzeit findet keine Überprüfung des eingegebenen Codes und keine Bereinigung von Leerräumen statt. Die Variable {option1} codiert alle Eingaben des Nutzers mithilfe einer UTF-8- und CGI-Parameter-Escapesequenz, so wie dies auch ein Textbearbeitungsfeld in einem Formular durchführen würde.

Einbinden der aktuellen URL

Neben dem Senden der Suchanfrage haben Sie auch drei Möglichkeiten, die aktuelle URL, die vom Browser angezeigt wird, anzugeben: {url} mit Codierung, {url.noescape} ohne Codierung oder {url.host} nur die Website.

In diesem Beispiel wird {url.noescape} verwendet, um die aktuelle URL an archive.org zu senden, um nach einer älteren Version der aktuellen Seite zu suchen. Für archive.org wird eine URL ohne Escape-Code benötigt:

<site>http://web.archive.org/web/*/{url.noescape}*</site>

Das folgende Beispiel führt dieselbe Suche auf archive.org durch, verwendet aber {url}:

<site method="post">http://www.archive.org/searchresults.php?search={url}&amp;mediatype=mediatype&amp;Submit=Submit</site>

Wenn Sie die Google-Suchmaschine verwenden möchten, um auf der aktuellen Website zu suchen, verwenden Sie {url.host}. Dies ist eine leistungsstarke Verknüpfung, die von der Google-Startseite aus nicht verwendet werden kann.

<search>http://www.google.com/search?q=site:{url.host}+{query}</search>

Einbinden des Google-Domain-Suffix

Die Google Toolbar verfügt über eine Variable {domain}, mit der die Domain bestimmt wird, zum Beispiel com oder co.uk. Die Such-Domain finden Sie in der Google Toolbar unter "Einstellungen" > "Optionen" > Registerkarte "Suche" > "Google-Website verwenden". Die Such-Domain ist die Zeichenfolge nach dem Begriff "google.".

Sie sollten die Variable {domain} verwenden und die Domain-Zeichenfolge nicht hart codieren. Eine Google-Suche sollte also die folgende Form aufweisen:

<search>http://www.google.{domain}/search?q={query}</search>

Senden eines vom Nutzer ausgewählten Textes

Sie können auch zulassen, dass eine benutzerdefinierte Schaltfläche einen Abschnitt Klartext sendet, der durch den Nutzer auf der Webseite markiert wurde. Dies könnte hilfreich sein für einen Übersetzungsdienst oder auch für eine Blogging- oder Messaging-Anwendung. Ein kleines Textsymbol wird neben der benutzerdefinierten Schaltfläche angezeigt, sobald Text markiert wurde.

Für diesen Vorgang ist das Element <send> erforderlich. Das URL-Ziel des Vorgangs <send> muss nicht dem Ziel von <search> entsprechen. Das Tag <send> sollte die Variable {selection} enthalten, die als einfacher Text auflöst wird, der derzeit im Browser ausgewählt ist.

<send>http://www.google.com/search?hl=en&amp;lr=&amp;q=define%3A+{selection}</send>

Benutzerdefinierte Schaltflächen, die einen "Senden"-Vorgang ermöglichen, sind auch über das Kontextmenü des Browsers verfügbar, wenn Text markiert ist (Aufrufen des Kontextmenüs mit der rechten Maustaste).

Vorhandensein einer Variable prüfen

Während der Weiterentwicklung der Toolbar werden möglicherweise weitere URL-Variablen implementiert. Damit sowohl Aufwärts- als auch Abwärtskompatibilität mit diesen neuen Variablen gewährleistet werden kann, ist die Syntax {a?b:c} in allen Parsern, die benutzerdefinierte Schaltflächen verarbeiten können, mit der folgenden Semantik verfügbar:

{param_to_be_tested?use this text if the param is implemented:use this text if not}

Einfach ausgedrückt: Diese Syntax ermöglicht es dem Autor einer fortgeschrittenen benutzerdefinierten Schaltfläche, eine neue Funktion gefahrlos zu verwenden, und Aufwärts- und Abwärtskompatibilität mit alten Parsern zu gewährleisten, die diese neue Funktion noch nicht kennen. Nehmen wir beispielsweise an, dass die Variable {locale} gerade erst eingeführt wurde. Eine URL-Vorlage wie im folgenden Beispiel könnte verwendet werden, um sicherzugehen, dass die Variable keine Auswirkung auf ältere Toolbars hat:

<site>http://google.com/{locale??hl={locale}}</site>

Wenn die Toolbar die Variable {locale} unterstützt, würde dieser Code erweitert zu:

<site>http://google.com/?hl=en</site>

Wenn keine Unterstützung erfolgt, würde der Code wie folgt lauten.

<site>http://google.com/</site>

Sie können Ausdrücke {a?b:c} bis zu 10 Ebenen tief verschachteln, solange diese Verschachtelung nach dem "?" stattfindet. Folgender Code ist zulässig:

<site>http://google.com/{locale??hl={domain?{domain}:{query}}}</site>

Achten Sie auch darauf, dass jedes Mal, wenn ein Escapezeichen verwendet wird, das nicht erkannt wird, der Parser dieses durch eine leere Zeichenfolge ersetzt. So würde "Hall{blah}o Welt" als "Hallo Welt" angezeigt werden. Wenn eine ungerade Anzahl geschweifte Klammern "{" oder "}" enthalten ist oder ein anderer Parserproblem auftritt, wird die gesamte URL auf eine leere Zeichenfolge zurückgesetzt.

Erstellen markanter Symbole

Die meisten Symbole, die als bevorzugte Symbole verwendet werden, können auch als Symbole für benutzerdefinierte Schaltflächen verwendet werden. Dazu zählen BMP-, ICO-, GIF- und JPEG-Bilder mit der Größe 16x16. Diese Bilder müssen nur mithilfe Base64-Codierung als ASCII-Text codiert werden. Es gibt im Internet mehrere Websites, die diese Codierung für Sie durchführen, beispielsweise diese. Klicken Sie auf dieser Website auf die Schaltfläche "Browse..." ("Durchsuchen...") und wählen Sie die Datei aus, die codiert werden soll. Starten Sie die Codierung durch Klick auf die Schaltfläche "Convert the source data" ("Quelldaten umwandeln"). Javascript und PHP verfügen ebenfalls über einzeilige Befehle zur Base64-Codierung.

Hier sehen Sie ein Google Mail-Symbol in Base64; verwenden Sie das Element <icon>:

    <icon mode="base64" type="image/x-icon">
AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAQAQAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA4ONr/ODja/6en+f+np/n/p6f5/6en+f+np/n/p6f5
/6en+f+np/n/p6f5/6en+f+np/n/p6f5/zg42v84ONr/ODja/zg42v/i4v//////////////////
/////////////////////////////////////+Li//84ONr/ODja/zg42v84ONr/p6f5/+Li////
/////////////////////////////////////////+Li//+np/n/ODja/zg42v84ONr/ODja/+Li
//+np/n/4uL/////////////gYHy/4GB8v///////////+Li//+np/n/4uL//zg42v84ONr/ODja
/zg42v//////4uL//6en+f+2tv//gYHy/1pa6f9aWun/gYHy/7a2//+np/n/4uL///////84ONr/
ODja/zg42v84ONr///////////+2tv//gYHy/1pa6f84ONr/ODja/1pa6f+BgfL/trb/////////
////ODja/zg42v84ONr/ODja////////////gYHy/1pa6f84ONr/trb//7a2//84ONr/Wlrp/4GB
8v///////////zg42v84ONr/ODja/zg42v//////gYHy/1pa6f84ONr/trb/////////////trb/
/zg42v9aWun/gYHy//////84ONr/ODja/zg42v84ONr/gYHy/1pa6f84ONr/trb/////////////
//////////+2tv//ODja/1pa6f+BgfL/ODja/zg42v84ONr/ODja/zg42v84ONr/trb/////////
/////////////////////////7a2//84ONr/ODja/zg42v84ONr/ODja/zg42v84ONr/gYHy/6en
+f+np/n/p6f5/6en+f+np/n/p6f5/6en+f+np/n/gYHy/zg42v84ONr/ODja/wAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAA//8AAP//AAD//wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAD//wAA//8AAA==
    </icon>

Symbole für benutzerdefinierte Schaltflächen können größer als 16x16 sein, aber die Toolbar verkleinert sie auf 16x16. Somit sind die Bilder nicht nur größer als nötig, sie sehen auch nicht annähernd so gut aus, als wenn Sie sie mit einem leistungsstarken Bildbearbeitungsprogramm verkleinert hätten.

Symbole sehen am besten aus, wenn sie mit 24-Bit Farbe (RGB) und 8-Bit Alpha erstellt und als RGBA-Symbole im XP-Stil gespeichert werden. PNG-Dateien werden nicht direkt unterstützt, da Windows keine native Unterstützung von PNG-Dateien bietet, ohne dass eine Verknüpfung zu zusätzlichen Dateien erfolgt.

Es muss ein Alpha-Kanal verwendet werden, da nicht alle Nutzer das gleiche Grau, Silber oder Beige als Hintergrundfarbe für ihre Toolbar verwenden, das Ihre Toolbar verwendet. Windows XP-Nutzer können ihr Farbschema anpassen. Darunter fällt auch der Hintergrund der Toolbar. Sie können dieses Problem umgehen, indem Sie ein viereckiges Symbol erstellen, das keine transparenten Teile hat; leider sehen solche Symbole weniger interessant aus. Einfarbige Alpha-Kanäle, wie zum Beispiel GIF-Bilder, verfügen über Außenkanten, die im Vergleich zu einem korrekt mit Alphablending erstelltem Symbol, wie zum Beispiel den Symbolen der Google Toolbar und von Internet Explorer, grobkörnig erscheinen.

Automatisches Aktualisieren von Symbolen und Tooltipps

Eine der interessanteren Funktionen einer benutzerdefinierten Schaltfläche ist die Aktualisierung des eigenen Symbols und der Tooltipps über einen Remote-Server in bestimmten Zeitabständen. Für diese Aktualisierung wird ein RSS-Feed verwendet. Dadurch kann eine Schaltfläche als Benachrichtigungsdienst oder als Status-Symbol verwendet werden (beispielsweise für Wetter oder andere Dinge). Eine Schaltfläche kann auch über ein Dropdown-Menü mit individuellen Elementen mit Text oder Symbolen verfügen. Jedes Menüelement kann über eine eigene dynamische URL verfügen, die geöffnet wird, wenn das Element angeklickt wird. Beispiele hierzu finden Sie im nächsten Abschnitt.

Hinzufügen eines RSS-Feeds

RSS-Feeds verwenden das Element <feed>. Hier ein Beispiel für einen CNN-News-Feed:

<feed refresh-interval="1800">http://rss.cnn.com/rss/cnn_topstories.rss</feed>

Das Protokoll für diese Aktualisierungs-Feeds ist entweder Atom 1.0, Atom 0.3, RSS 2.0 oder RSS 1.0. Standard-Feeds sollten normalerweise funktionieren.

Verwenden eines Feeds zum Aktualisieren des Symbols bzw. der Tooltipps einer Schaltfläche

Wenn Sie das Symbol auf der Toolbar oder die Beschreibung des Tooltipps über einen Feed aktualisieren möchten, ist es erforderlich, eine Toolbar-spezifische Erweiterung zu RSS oder ATOM hinzuzufügen, indem Sie einen Namespace verwenden. Hier ein Beispiel einer Mood Ring ("Stimmungsring")-Schaltfläche, die ihre Informationen aus einem Feed erhält:

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <title>Mood ring</title>
    <description>Your virtual mood ring</description>

    <site>http://www.google.com/search?q=mood+ring</site>
    <feed menu="false" refresh-interval="900">
          http://www.example.com/custombuttons/samples/feeds/mood</feed>
  </button>
</custombuttons>

Beachten Sie: Der Code spezifiziert menu="false", um anzugeben, dass dieser Feed nur verwendet wird, um das Symbol und den Tooltipp zu aktualisieren, nicht jedoch zum Ausfüllen eines Dropdown-Menüs mit Unterelementen.

Wenn dieser Code auf einem tatsächlichen Server eingerichtet werden würde, würde die Feed-Ausgabe wie folgt aussehen:

<?xml version='1.0'?>
<feed xmlns='http://www.w3.org/2005/Atom' 
    xmlns:gtb='http://toolbar.google.com/custombuttons/'>
<id>http://www.example.com/custombuttons/samples/feeds/mood</id>

<title>Mood</title>
<link href='http://www.google.com/search?q=+ring' />
<link rel='self' 
    href='http://www.example.com/custombuttons/samples/feeds/mood' />
<gtb:description>Bluegreen:
Inner emotions charged, somewhat relaxed</gtb:description>
<gtb:icon mode="base64" type="image/x-icon">
AAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAwAAAAMAA
AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAQAQAAAAAAAAAAAAAAAAA
AAAAAAAAAAAGAAAAHAAAAEAAAABhAAAAcwAAAHQAAABpAAAAVQAAAD4AAAApAAAAGAAAAAoAAAAD
AAAAAQAAAAAAAAAAAAAAESZIXl4zdJvAXbHS8m3C3f9LnrrLFUtsmwILEX4AAABzAAAAYQAAAEcA
AAAqAAAAEwAAAAcAAAACAAAAACs9RTNOjrDtW6nS/53u/f+n/P//hej//2bP/P9Fq93wHGaNrxEv
O4kAAAB6AAAAXwAAADwAAAAfAAAADAAAAANihaWST6XK/0h/kcAdKCyWKTtAgVJ/kIhytNKse873
9E+w6v9RuN39SXuJpgQHCIoAAAB2AAAAUQAAACsAAAAPb6nU7mK65v9jqs76KkNPqAUICJoAAACE
AAAAaxUgJWBkrMiwsvv+//D+/v+y1NniIj1FnAAAAIgAAABcAAAALHS74PV1zPn/c835/1Oezv9N
iq7vNVRjrxUiJ5kBAgORAQICh3uLjZz3+vr1+f///4PL5/wvVmusAAAAigAAAFNyu+TPdtL8/0Cp
7v8ng8X/CFOH/ytpjv86gJ//R46z+Th6jsovVmCsd56pxNf2/f9TuPH/W7fs/ypGV6UAAAByf77Y
r02y7P9Zwfb/puH3/y+AtP8jZ5f/KWKH/0p7hP+ZrVr/zcUt/9vMKf/bzSz/tsBP/3OzrP9kl7Pp
AAAAgHGdpThatuT/0fn+//b///+V0uv/NICu/4mvfP/czjL/3M0v/9rMKP/dzzT/3c83/9vNLf/b
zS//nrWA/gAAAIMAMzMFbrrd2d/+///5////t+n6/4q6nf/czzX/3tA+/97QPf/czjP/3dA7/97R
Qv/czjD/3M4z/9DHLPoAAAB/AAAAAWShtUix5+//5v7+/5Hf7//Bvjn/3M0v/9/SSP/g1FL/39RR
/+DVWv/e0kf/3tFA/9zNL//bzCj/AAAAbwAAAAAAAAADcq7Fmpzo8f9rsL3/2ssl/93POf/f0kj/
49pu/+ffhP/q45b/49pp/97SSv/czS//yb0q4wAAAE8AAAAAAAAAAF54hhNrq77BXpCj/7+7Of/c
zjH/3tFH/+bdeP/w7cv/9PLa/+zlnf/g1VP/1so5/mBfJHsAAAArAAAAAAAAAAAAAAABa5GgIHWs
t/dymG3/3tE//9/UUv/o4Ij/9PHT//v67P/v6a3/08xY/3uMX6UAAAAuAAAAEAAAAAAAAAAAAAAA
AAAAAAKSvb9YSoWa+WyagP+wv2X/4NRO/+ngfv/m4Zf/rLeB+lpubIkAAAAlAAAADgAAAAMAAAAA
AAAAAAAAAAAAAAAAAAAAAoqvuDxkkp2gYo+c51mHkv9lk5v/Y4eNtlBfaEgAAAAWAAAACQAAAAIA
AAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAwAAAAMAA
AADgAAAA8AEAAA==
</gtb:icon>

</feed>

Das obige Beispiel ist ein Atom 1.0-Feed, in dem der Namespace der benutzerdefinierten Schaltflächen von Google angegeben wird als:

xmlns:gtb='http://toolbar.google.com/custombuttons/'

Falls Sie einen anderen Tooltipp als den ursprünglich zur Schaltfläche gehörenden Tooltipp verwenden möchten, geben Sie Folgendes ein:

<gtb:description> new-description </gtb:description>

Falls Sie ein anderes Symbol als das ursprünglich zur Schaltfläche gehörende Symbol verwenden möchten, geben Sie Folgendes ein:

<gtb:icon> icon-base64-code </gtb:icon>

Das PHP-Skript, das hinter diesem komplexen "Stimmungs"-Analysesystem steckt, sieht wie folgt aus:

<?php

header('Content-type: text/xml');

switch(rand(1, 7)) {
  case 1:
    $icon = "amber.ico";
    $desc = "Amber:\nNervous, on edge, uncertain";
    break;

  case 2:
    $icon = "black.ico";
    $desc = "Black:\nTense, stressed, working too hard";
    break;

  case 3:
    $icon = "blue.ico";
    $desc = "Blue:\nComfortable, breeze, at rest, loveable";
    break;

  case 4:
    $icon = "bluegreen.ico";
    $desc = "Bluegreen:\nHeightened inner emotional state, moderately relaxed";
    break;

  case 5:
    $icon = "gray.ico";
    $desc = "Gray:\nAnxious, ill at ease, strained";
    break;

  case 6:
    $icon = "green.ico";
    $desc = "Green:\nSteady, stable, no emotional turmoil";
    brea;

  case 7:
    $icon = "purple.ico";
    $desc = "Dark Blue:\nImpassioned, delighted, whiff of romance";
    break;
}

$icon = base64_encode(file_get_contents($icon));

echo "<?xml version='1.0'?>";
echo "\n<feed xmlns='http://www.w3.org/2005/Atom' xmlns:gtb='http://toolbar.google.com/custombuttons/'>";
echo "\n<id>http://www.example.com/custombuttons/samples/feeds/mood</id>";
echo "\n<title>Mood</title>";
echo "\n<link href='http://www.google.com/search?q=$mood+ring' />";
echo "\n<link rel='self' href='http://www.example.com/custombuttons/samples/feeds/mood' />";
echo "\n<gtb:description>$desc</gtb:description>";
echo "\n<gtb:icon mode='base64' type='image/x-icon'>$icon</gtb:icon>";
echo "\n</feed>";

?>

Diese Symbole sollten sich in dem Ordner befinden, in dem sich auch das Skript befindet.

Verwenden eines Feeds zum Aktualisieren der Symbole für die Schaltfläche und das Dropdown-Menü

Sie können auch benutzerdefinierte server-basierte Symbole zu den einzelnen Elementen im Dropdown-Menü des Feeds hinzufügen. Hier ein Beispiel einer Wetter-Schaltfläche, die über einen Feed mit einem Dropdown-Menü verfügt (Standardeinstellung), aber auch refresh-menuitem="false" spezifiziert, um das Menüelement "Aktualisieren" auszublenden, wenn eine erfolgreiche Verbindung mit dem Server hergestellt wurde. Dadurch wird das Menü übersichtlicher.

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <title>Weather 94043</title>
    <description>Weather updates for Mountain View, CA</description>

    <site>http://www.google.com/search?q=weather+94043&num=1</site>
    <feed refresh-interval="3600" refresh-menuitem="false">
        http://www.example.com/custombuttons/samples/feeds/weather?zip=94043</feed>
  </button>

</custombuttons>

Im Folgenden sehen Sie ein Beispiel für den Wetter-Feed, mit einem benutzerdefinierten Symbol neben jedem Menüelement im Dropdown-Menü (der Großteil der Base64-Einträge für die Symbole wurde der Übersichtlichkeit zuliebe entfernt). Laut dem obigen Beispiel würde dies angezeigt werden unter: http://www.example.com/custombuttons/samples/feeds/weather/?zip=94043

<?xml version='1.0'?>
<feed xmlns='http://www.w3.org/2005/Atom' 
    xmlns:gtb='http://toolbar.google.com/custombuttons/'>
<id>http://www.example.com/custombuttons/samples/feeds/weather</id>

<title>Weather Mountain View, CA</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<link rel='self'
    href='http://www.example.com/custombuttons/samples/feeds/weather' />
<gtb:description>Mountain View, CA
63F Mostly Cloudy
Humidity: 48%
Wind: NW at 8 mph</gtb:description>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAEuc/Pz8/Fik/Ii00k9daZGPivLy8tbW1k2R0uvr6wZj3HSq0f/QMMfHx7a2
tj2F0fu0EePj4yx81neUp4J/eKanphJq3IJtOGB3iI3C5BFt5B5XnWis7H2346jO5/6+IWKo8923
... and so on...
</gtb:icon>

<entry>
<title>Today: Mostly Cloudy 65 | 50</title>

<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/0</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAEuc/Pz8/Fik/Ii00k9daZGPivLy8tbW1k2R0uvr6wZj3HSq0f/QMMfHx7a2
tj2F0fu0EePj4yx81neUp4J/eKanphJq3IJtOGB3iI3C5BFt5B5XnWis7H2346jO5/6+IWKo8923
... and so on...
</entry>

<entry>
<title>Thu:  66 | 51</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/1</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoAPcAAAAAAP///4WOwPT1+tDT3unr8sHG1ff5/6Wy0mZ8rGqAr3mJrJakxa+zvHSK
tcDBw1R2slBql110njBXjztmqS9OfjtekTZWhGeJuoqctklLTgJYyQJQtQ9hzhRr3BZlzBVRoS1S
... and so on...
</gtb:icon>

</entry>

<entry>
<title>Fri:  67 | 51</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/2</id>
<gtb:icon mode='base64' type='image/x-icon'>

R0lGODlhKAAoANUAAObm52ms7k2Q0Uuc/Fmk+v2zDoS01HOp0avP5tvb26CPXQZj3DqG14yLh05Y
Yf/IKv/VN3mCiMPDw6SkpCt82GhxePz8/JG+2pd5NRZu3hBq3fb29rCAFrm5uSN549OWE4WltqHI
... and so on...
</gtb:icon>
</entry>
<entry>
<title>Sat:  67 | 50</title>
<link href='http://www.google.com/search?q=weather+94043/' />

<id>http://www.example.com/custombuttons/samples/feeds/weather/3</id>

<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAObm52ms7k2Q0Uuc/Fmk+v2zDoS01HOp0avP5tvb26CPXQZj3DqG14yLh05Y
Yf/IKv/VN3mCiMPDw6SkpCt82GhxePz8/JG+2pd5NRZu3hBq3fb29rCAFrm5uSN549OWE4WltqHI
... and so on...
</gtb:icon>
</entry>
</feed>

Der PHP-Code, der dies durchführt, verwendet das -Antwortformat für Wettervorhersagen.

<?php

// Script to convert Google xml weather interface to custom buttons AtomFeed 1.0
// Sample input at http://www.google.com/ig/api?weather=94043
// To see sample output, run this script with ?zip=94043

$zip = $_GET['zip'];

header('Content-type: text/xml');

// http://www.google.com/ig/api?weather=94043
$dom= domxml_open_file("http://www.google.com/ig/api?weather=$zip");

$xpath = xpath_new_context($dom);
// $params = $dom->documentElement->firstChild->getElementsByTagName('param');

$temp = $xpath->xpath_eval('//city/@data');
$city = $temp->nodeset[0]->value;

$icons = $xpath->xpath_eval('//current_conditions/icon/@data');
$icon_url = $icons->nodeset[0]->value;
$icon = base64_encode(file_get_contents("http://www.google.com$icon_url"));

$conditions = $xpath->xpath_eval('//current_conditions/condition/@data');
$condition = $conditions->nodeset[0]->value;

$temp = $xpath->xpath_eval('//current_conditions/temp_f/@data');
$tempf = $temp->nodeset[0]->value;

$temp = $xpath->xpath_eval('//current_conditions/humidity/@data');
$humidity = $temp->nodeset[0]->value;

$temp = $xpath->xpath_eval('//current_conditions/wind_condition/@data');
$wind = $temp->nodeset[0]->value;

echo "<?xml version='1.0'?>";
echo "\n<feed xmlns='http://www.w3.org/2005/Atom' ";
echo     "xmlns:gtb='http://toolbar.google.com/custombuttons/'>";
echo "\n<id>http://www.example.com/custombuttons/samples/feeds/weather</id>";
echo "\n<title>Weather $city</title>";
echo "\n<link href='http://www.google.com/search?q=weather+$zip/' />";
echo "\n<link rel='self' href='http://www.example.com/custombuttons/";
echo     "samples/feeds/weather' />";
echo "\n<gtb:description>$city\n$tempfF $condition\n$humidity\n$wind";
echo   "</gtb:description>";
echo "\n<gtb:icon mode='base64' type='image/x-icon'>$icon</gtb:icon>";

$days = $xpath->xpath_eval('//forecast_conditions/day_of_week/@data');
$conditions = $xpath->xpath_eval('//forecast_conditions/condition/@data');
$icons = $xpath->xpath_eval('//forecast_conditions/icon/@data');
$highs = $xpath->xpath_eval('//forecast_conditions/high/@data');
$lows = $xpath->xpath_eval('//forecast_conditions/low/@data');

for ($i = 0; $i < count($conditions->nodeset); $i++) {
  $day_of_week = $days->nodeset[$i]->value;
  $condition = $conditions->nodeset[$i]->value;
  $high = $highs->nodeset[$i]->value;
  $low = $lows->nodeset[$i]->value;
  echo "\n<entry>";
  echo "\n<title>$day_of_week: $condition $high | $low</title>";
  echo "\n<link href='http://www.google.com/search?q=weather+$zip/' />";
  echo "\n<id>http://www.example.com/custombuttons/samples/feeds/weather/$i</id>";
  $icon_url = $icons->nodeset[$i]->value;
  $icon = base64_encode(file_get_contents("http://www.google.com$icon_url"));
  echo "\n<gtb:icon mode='base64' type='image/x-icon'>$icon</gtb:icon>";
  echo "\n</entry>";
}

echo "\n</feed>";

?>

Sie können denselben Namespace 'http://toolbar.google.com/custombuttons/' und dieselben Beschreibungs- oder Icon-Tags in RSS 1.0, RSS 2.0, Atom 1.0 und Atom 0.3-Feeds auch für die Toolbar-Feeds verwenden.

Mehrere Sprachen

Eine benutzerdefinierte Schaltfläche kann alternative URLs, Symbole und Text für spezifische Toolbar-Gebietsschemata verwenden. Die beiden Methoden, dies durchzuführen, sind unten dargestellt; die erste Methode wird empfohlen.

Verwendung eines lokalen Attributs

Die empfohlene Methode ist die Erstellung einer Liste von XML-Tags, von denen jedes ein Attribut locale="iso-name" verwendet, wobei iso-name für das gewünschte Gebietsschema verwendet wird. Hier ein Beispiel einer Schaltfläche mit alternativen französischen und spanischen URLs und Beschreibungen:

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
  <button>
    <title>Wikipedia</title>
    <site>http://www.wikipedia.org</site>

    <site locale="fr">http://fr.wikipedia.org</site>
    <site locale="es">http://es.wikipedia.org</site>
    <description>The Free Encyclopedia</description>

    <description locale="fr">L'encyclopdie libre</description>
    <description locale="es">La enciclopedia libre</description>
  </button>
</custombuttons>

Wenn das Gebietsschema der aktuell in der Toolbar eingestellten Sprache nicht direkt im XML-Tag gefunden wird, wird das erste Tag in der obigen Liste als Standardwert verwendet.

Verwendung der Variable {locale}

Alternativ dazu können Sie die Variable {locale} in einer URL eingebettet verwenden. Beispiel: http://{locale}/wikipedia.org. Diese Methode ist hervorragend geeignet, wenn die Gebietsschemata, die die Variable überprüft, exakt den verschiedenen verfügbaren Websites entsprechen (wie zum Beispiel bei Google.com). Allerdings ist dies für die meisten Nutzer nicht der Fall. Es kann möglicherweise eine Website für ein bestimmtes Gebietsschema vorhanden sein, das die Google Toolbar noch nicht unterstützt. Zum Beispiel gibt es zum Zeitpunkt der Drucklegung zwar eine polnische Version von Wikipedia (http://pl.wikipedia.org), aber Polnisch (pl) ist kein natives Toolbar-Gebietsschema. Daher können polnische Nutzer nicht auf diese Website zugreifen. Umgekehrt ist die Toolbar für das Gebietsschema "Brasilianisches Portugiesisch (pt-BR)" verfügbar, jedoch verfügt Wikipedia über keine Website für dieses Gebietsschema. Sie können auch Anweisungen mit dem Attribut locale und Anweisungen mit der Variable {locale} kombinieren, wenn Sie dies wünschen. Auch in diesem Fall wird das erste Attribut als Standardwert verwendet.

Tabelle der ISO-Gebietsschemata

Folgende Gebietsschemata werden derzeit von der Toolbar unterstützt:

ISO-Gebietsschema	Sprache
en	Englisch
da	Dänisch
de	Deutsch
es	Spanisch
fi	Finnisch
fr	Französisch
it	Italienisch
ja	Japanisch
ko	Koreanisch
nl	Niederländisch
no	Norwegisch
pt-BR	Brasilianisches Portugiesisch
ru	Russisch
sv	Schwedisch
zh-CN	Chinesisch (vereinfacht)
zh-TW	Chinesisch (traditionell)

Hosten einer benutzerdefinierten Schaltfläche

Wo sollten Sie Ihre Schaltfläche hosten?

Die Download-URL, die Sie zum Hosten der XML-Datei für die Schaltfläche verwenden, ist wichtig, da diese URL die eindeutige ID für die Aktualisierung der Schaltfläche ist. Wenn ein zweiter Versuch vorgenommen wird, eine Schaltfläche von derselben URL herunterzuladen, schlägt die Toolbar vor, die alte Schaltfläche zu aktualisieren. Es wird keine neue Schaltfläche hinzugefügt. Weitere Informationen finden Sie unter Aktualisieren einer benutzerdefinierten Schaltfläche.

Hinzufügen Ihrer Schaltfläche zur Schaltflächen-Galerie von Google

Fügen Sie Ihre Schaltfläche zur Schaltflächen-Galerie von Google hinzu; so können Sie der Welt Ihre neue Schaltfläche präsentieren. Ihre XML-Datei muss bereits gehostet sein (die Schaltflächen-Galerie enthält einen Direktlink zu der Datei) und die Schaltfläche muss unseren redaktionellen Richtlinien entsprechen.

Wenn Sie eine Schaltfläche für eine Website einreichen, deren Eigentümer Sie sind, sollten Sie Ihre XML-Datei auf derselben Domain hosten, auf der sich auch Ihre Website befindet. Schaltflächen in der Schaltflächen-Galerie von Google sind als "offiziell" gekennzeichnet, wenn sie auf derselben Domain gehostet sind, auf die sich die Schaltfläche bezieht. Dadurch ist es für Nutzer einfacher, die offizielle Schaltfläche für Ihre Website zu finden.

Wenn Sie diese Schritte durchgeführt haben, füllen Sie das Übermittlungsformular für die Schaltflächen-Galerie aus, um Google Informationen über Ihre Schaltfläche mitzuteilen.

Erstellen eines Links zu Ihrer Schaltfläche auf Ihrer Website

Sie können Ihre Schaltfläche auf Ihrer eigenen Website verfügbar machen, indem Sie einen Installationslink erstellen. Wenn ein Nutzer der Google Toolbar 4 auf den Link klickt, wird er aufgefordert, die Schaltfläche zu installieren. Wenn der Nutzer über keine kompatible Version der Toolbar verfügt, öffnet der Link stattdessen die Google Toolbar-Downloadseite.

Ein Entwickler kann einen Installationslink erstellen, indem er die folgende URL-Syntax verwendet:

http://toolbar.google.com/buttons/add?url=url

wobei url auf die XML-Datei der benutzerdefinierten Schaltfläche verweist. Hier als Beispiel ein Link, der eine Schaltfläche "Slashdot.com" installieren würde:

<a href="http://toolbar.google.com/buttons/add?url=http://www.slashdot.org/slashdot_button.xml">Add</a>

Das Label dieses Links ist "Add" ("Hinzufügen"). Wenn ein Nutzer auf den Link klickt, wird die Schaltfläche "Slashdot.com" in seiner Google Toolbar installiert.

Die obige Google-URL ist im Wesentlichen eine Aufforderung an die Toolbar, eine benutzerdefinierte Schaltfläche zu installieren. Wenn der Nutzer über keine kompatible Version der Toolbar verfügt, wird er aufgefordert, diese zu installieren. Sobald die Google Toolbar installiert wurde, wird die benutzerdefinierte Schaltfläche automatisch hinzugefügt.

Verwalten Ihres Feed-Traffics

Internet-Traffic kann bei Feeds ein Problem darstellen. Eine Schaltfläche sollte ihren Feed nicht auf einen Server mit geringer Bandbreite verweisen, wenn Sie Grund zu der Annahme haben, dass der Feed häufig abgefragt werden wird und somit hohen Traffic erzeugen wird. Der Server kann durch häufige Anfragen überlastet werden.

Die benutzerdefinierte Schaltfläche verfügt über ein eigenes Attribut Aktualisierungsintervall für Feeds. Die Toolbar berücksichtigt die Ablaufzeit "Expires", die der Server im HTTP-Header angibt. Diese Einstellung hat Vorrang vor dem Aktualisierungsintervall der Schaltfläche. Wenn Ihr Server überlastet ist, könnten Sie die Ablaufzeit "Expires" erhöhen, um die Belastung zu reduzieren. Wenn beispielsweise die Einstellung einer Schaltfläche besagt, dass sie stündlich aktualisiert werden soll, kann die Ablaufzeit "Expires" auf eine tägliche Aktualisierung festgelegt werden, wodurch der Traffic erheblich reduziert werden würde (auch wenn dadurch die Aktualität der Schaltfläche gemindert werden könnte).

Hier ein Beispiel eines PHP-Skripts, um die Ablaufzeit Expires auf eine Woche in der Zukunft zu setzen:

<?php
$expires = gmdate("D, d M Y H:i:s", time() + 3600 * 24 * 7) . " GMT";
Header("Expires: " . $expires);
?>

Beispiel einer HTTP-Antwort des Servers:

HTTP/1.1 200 OK
Date: Thu, 05 Jan 2006 23:39:54 GMT
Server: Apache/2.0.47 (Red Hat Linux)
Accept-Ranges: bytes
X-Powered-By: PHP/4.3.2
Expires: Thu, 12 Jan 2006 23:39:54 GMT
Transfer-Encoding: chunked
Content-Type: text/html

Referenz

XML-Referenz

Die XML-Datei einer benutzerdefinierten Schaltfläche verfügt über die folgende Struktur:

<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">

  <button>
    <!-- XML elements -->
  </button>
</custombuttons>

Die folgenden XML-Elemente können in einem Element <button> verwendet werden. Jedes Element (außer <update>) kann mehr als einmal verwendet werden, solange jedes Element einem anderen Gebietsschema zugeordnet ist.

<title> Text </title>

Der Titel der benutzerdefinierten Schaltfläche, der in der Liste der benutzerdefinierten Schaltfläche ("Einstellungen" > "Optionen" > "Benutzerdefinierte Schaltflächen") oder optional neben der Schaltfläche angezeigt wird. Dieser Wert sollte eindeutig sein, da er gleichzeitig als Standard-Schlüsselwort fungiert, wenn er als Suchtyp verwendet wird.

Dieses Element unterstützt dasselbe Attribut locale wie <search> im Folgenden.

Siehe Beispiel <title> .

<description> Tooltipp </description>

Der Tooltipp-Text der benutzerdefinierten Suche, der angezeigt wird, wenn der Mauszeiger über einer Schaltfläche platziert wird. Dies ist auch die Beschreibung, die angezeigt wird, nachdem die Schaltfläche von einer Website heruntergeladen wurde.

Dieses Element unterstützt dasselbe Attribut locale wie <search> im Folgenden.

Siehe Beispiel <description> .

<site> URL </site>

Optionale URL, zu der navigiert wird, wenn kein neuer Text in das Suchfeld eingegeben wurde. Das Protokoll ist aus Sicherheitsgründen auf http: und https: beschränkt. Die folgenden Variablen innerhalb dieser URL werden erweitert: {domain}, {url}, {url.noescape}, {url.host} und {locale}.

Das Element <site> unterstützt dieselben Attribute method und locale wie <search> im Folgenden.

Siehe Beispiel <site> .

<search> URL-Vorlage </search>

Die URL, zu der der Browser navigiert wird und die durchsucht wird, wenn die Schaltfläche betätigt wird und ein "neuer" Suchbegriff in das Suchfeld eingegeben wurde. ("Neu" bedeutet, dass sich ein Suchbegriff im Suchfeld befindet, nach dem noch nicht gesucht wurde.) Die URL muss auf http: oder https: basieren; javascript: ist nicht zulässig. Die Variable {query} muss in der Suchvorlage enthalten sein (und ist in anderen URL-Vorlagen nicht zulässig). Dieses Element ist optional und kann weggelassen werden, wenn diese Schaltfläche nicht in der Liste der Suchschaltflächen enthalten sein soll.

Das Suchelement kann diese Attribute angeben:

method="post"|"get"

Als Standardwert ist "get" festgelegt. Verwenden Sie "post", um URL-codierte Formulardaten als POST anstelle von GET zu senden. Als Codierungsmethode muss Anwendungs-/x-www-Formular-URL-codiert angegeben sein. Wenn ein Suchvorgang durchgeführt wird, wird der Text hinter dem letzten Fragezeichen "?" in Form von Post-Daten versendet.

locale="en"|"da"|"de"|"es"|"fi"|"fr"|"it"|"ja"|"ko"|"nl"|"no"|"pt-BR"|"ru"|"sv"|"zh-CN"|"zh-TW"

Gibt ein Gebietsschema an, für das dieses Element eine alternative URL zur Verfügung stellen kann. Geben Sie die ISO-Bezeichnung des Gebietsschemas an, beispielsweise locale="fr". In der Regel werden hier mehrere Elemente angegeben, von denen jedes sein eigenes Gebietsschema-Attribut und eine alternative URL enthält. (Wenn dieses Attribut mit anderen XML-Elementen verwendet wird, kann es ein anderes Symbol oder anderen Text angeben.) Siehe Beispiele für Gebietsschemata und Tabelle der ISO-Gebietsschemata

Siehe Beispiel <search> .

<send> URL-Vorlage </send>

Die optionale URL, zu der der Browser navigiert wird, wenn kein Suchbegriff in das Suchfeld eingegeben wurde und der Nutzer einen Text im Browser-Fenster markiert hat. Die Variable {selection} muss in der Sendevorlage enthalten sein (und ist in anderen URLs nicht zulässig).

Das Element <send> unterstützt dieselben Attribute method, charset und locale wie <search> above.

Siehe Beispiel <send> .

<icon> Base64-Codierung </icon>

Die tatsächlichen Bits einer im Windows-Stil gehaltenen ICO-Datei, idealerweise ein 16x16 großes 32-Bit-RGBA-Bild im XP-Stil. Dieses wird von vielen Websites als ihr bevorzugtes Symbol in der Datei "favicon.ico" verwendet. Da dies ein binärer Wert ist, muss er Base64-codiert sein. Wenn kein Symbol vorhanden ist, wird ein Standardwert verwendet. 16x16 große mit Alphablending erstellte ICO-Bilder im XP-Stil sind das bevorzugte Format, aber auch reguläre ICO-, JPG-, BMP- und GIF-Bilder jeder Größe können verwendet werden und werden auf 16x16 verkleinert. Das XP RGBA-Symbol kann auf allen Betriebssystemen verwendet werden, die von der Google Toolbar unterstützt werden. Es muss also keine alternative Version mit 256 oder 16 Farben erstellt werden. PNG wird nicht unterstützt.

Die Attribute mode und type sind optional, können aber die Bearbeitung in einem XML-Editor vereinfachen, der sie interpretieren kann:

mode="base64"

Die Codierung des Symbols.

type="image/x-icon"

Der Typ des Bilds.

Dieses Element unterstützt dasselbe Attribut locale wie das oben gezeigte <search>.

Siehe Beispiel <icon> .

<feed> URL </feed>

Geben Sie eine URL zu einer RSS 2.0- oder Atom-Feed- 0.3/1.0-XML-Datei an. Dieses Element fügt die Funktion hinzu, ein Dropdown-Menü zu öffnen, das Titel, Beschreibungen und Links eines RSS-Feeds enthält, ähnlich wie Firefox RSS-Lesezeichen, die automatisch und ohne Aktion des Nutzers aktualisiert werden. Dieses Element ist optional und wird von den meisten benutzerdefinierten Suchen nicht verwendet. Die Variablen {domain} und {locale} können auch im Feed verwendet werden.

Dieses Element verwendet folgende Attribute:

menu="true"|"false"

Setzen Sie dieses Attribut auf "false", damit das Dropdown-Menü des Feeds nicht angezeigt wird. Der Standardwert ist "true".

refresh-interval="secs"

Zeitraum in Sekunden, bevor der Feed erneut geladen wird. Der Standardwert ist 3600 (1 Stunde). Die Toolbar wird maximal eine Aktualisierung pro Minute durchführen, auch wenn der angegebene Wert kleiner als 60 ist.

refresh-onclick="true"|"false"

Setzen Sie dieses Attribut auf "true", um jedes Mal eine Aktualisierung durchzuführen, wenn der Nutzer die Schaltfläche betätigt. Der Standardwert ist "false".

google-service="true"|"false"

Setzen Sie dieses Attribut auf "true", wenn es sich hierbei um einen Service eines Google-Kontos handelt, das heißt, der Service ist nur verfügbar, wenn der Nutzer sich in Google angemeldet hat. Eine Aktualisierung erfolgt, wenn eine Anmeldung erkannt wird; eine Abmeldung löscht die Menüelemente.

Dieses Element unterstützt dasselbe Attribut locale wie das oben gezeigte <search>.

Siehe Beispiel <feed> .

<feed-icon> Base 64-Codierung </feed-icon>

Ein alternatives Symbol, das angezeigt wird, wenn der Feed über neue Elemente verfügt (dasselbe Format wie <icon>). Wenn ein Nutzer auf eine Schaltfläche klickt, wird bis zum nächsten Feed statt des alternativen Symbols wieder das normale Symbol verwendet. Ein Feed-Server kann ein Symbol direkt in der Atom Feed- oder RSS 2.0-Antwort festlegen. In diesem Fall erhalten <feed-icon> oder <icon> zweite Priorität.

Dieses Element unterstützt dasselbe Attribut locale wie das oben gezeigte <search>.

(Es wird kein Beispiel für <feed-icon> angefügt; es ähnelt jedoch dem Beispiel für <icon>.)

<feed-description> Tooltipp </feed-description>

Eine alternative Beschreibung, die im Tooltipp angezeigt wird, wenn der Feed über neue Elemente verfügt. Wenn ein Nutzer auf eine Schaltfläche klickt, wird bis zum nächsten Feed statt der alternativen Beschreibung wieder die normale Beschreibung verwendet.

Dieses Element unterstützt dasselbe Attribut locale wie das oben gezeigte <search>.

(Es wird kein Beispiel für <feed-description> angefügt; es ähnelt aber dem Beispiel für <description>.)

<update> URL </update>

Die URL, von der diese Schaltflächendefinition heruntergeladen wurde, und von der die Aktualisierungsschaltfläche eine Ersatz-XML-Datei erhält, wenn der Nutzer auf den Aktualisierungslink (Einstellungen > Optionen > Benutzerdefinierte Schaltflächen > Schaltfläche auswählen > Bearbeiten > Neueste Version herunterladen) klickt. Diese URL wird mit der tatsächlichen URL überschrieben, von der die Schaltfläche heruntergeladen wurde, falls die Schaltfläche durch Webinstallation installiert wurde, die nicht von google.com stammt. Dies ist das einzige Element der benutzerdefinierten Schaltfläche, das über kein lokales Attribut verfügen kann.

Siehe <update> example.

<option> Unterelemente </option>

Gibt eine lokal definierte Optionszeichenfolge an, die der Nutzer problemlos über das Dialogfeld "Einstellungen" der Toolbar ändern kann. Der Wert wird in der Variablen {option1} wiedergegeben. Dieses Element kann über drei Unterelemente verfügen, von denen das erste erforderlich ist.

<title>

Der Name der Option. Dieser Name wird im Dialogfeld "Einstellungen" der Toolbar angezeigt. Dieses Unterelement ist erforderlich.

<description>

Eine Beschreibung dieser Option. Diese Beschreibung wird für den Nutzer angezeigt. Jede Option kann mehrere Beschreibungen aufweisen. Dieses Unterelement ist optional.

<default>

Der Standardwert des Tags {option1}. Dieser Wert wird verwendet, wenn der Nutzer keinen Wert eingibt. Dieses Unterelement ist optional.

Siehe Beispiel <option> .