PrefBar Hilfe
Einführung Preferences Toolbar benutzen Was ist neu? Button Liste PrefBar FAQ Credits Hilfe/Feedback

Preferences Toolbar benutzen

Dies ist das Prefbar Benutzerhandbuch. Alles das Sie über den Gebrauch der Prefbar wissen müssen steht hier in dieser Datei. Nun, vielleicht nicht alles aber vielleicht fast.

Installiation der PrefBar
Die PrefBar anzeigen
Die PrefBar einstellen

Warum Sie die meisten eingebauten Buttons nicht bearbeiten sollten
Eingebaute Buttons, die Sie bearbeiten können

Importen/Exportieren von Elementen
Bekannte Bugs


Installiation der PrefBar

Die Preferences Toolbar wurde so optimiert das sie ohne Fehler auf SeaMonkey Release 1.0-1.1+ und Firefox Release 1.5-2.0+ funktioniert. Der Gebrauch in zukünftigen SeaMonkey oder Firefox Releases sollte auch funktionieren, wenn die Entwickler von diesen Browsern nichts tiefgreifendes verändern. Die PrefBar wurde nicht auf Netscape Releases getestet, deshalb ist es möglich, dass sie dort nicht funktioniert.

Um die PrefBar zu installieren, klicken Sie auf den "Install Now" Link auf der PrefBar Installationsseite. Sie müssen "JavaScript" und "Software Installation" aktiviert haben, dass dies funktioniert.

Wenn Sie ein Betriebssystem mit Datei-Berechtigungen verwenden (wie alle Unix Varianten), dann stellen Sie sicher, dass Sie Schreibrechte auf das Mozilla Chrome-Verzeichnis besitzen, wenn Sie versuchen die Prefbar zu installieren. Das häufigste Installationsproblem mit der PrefBar ist das Linux Benutzer Mozilla als root installieren und dann versuchen die PrefBar als normaler Benutzer zu installieren. Tun Sie dies nicht. Es wird nicht funktionieren.

Nach der Installation müssen Sie Mozilla neustarten, bevor Sie die PrefBar benutzen können.

Die PrefBar anzeigen

Um die PrefBar anzuzeigen können Sie sie entwender über das Menü "Ansicht->Anzeigen/Verstecken" (bzw. das Menü "Ansicht" in Firefox) oder durch Drücken von F8 aktivieren. Wenn die zweite Methode nicht funktioniert, dann versuchen Sie die erste. Wenn die PrefBar nicht im "Ansicht->Anzeigen/Verstecken" Menü angezeigt wird, dann kann das bedeuten das die Installation nicht erfolgreich war. Beachten Sie die vorige Sektion.

Die PrefBar einstellen

Um die Prefbar anzupassen klicken Sie auf den "Customize" Button ganz rechts oder öffnen Sie den Eigenschaften-Dialog von Mozilla und wählen aus der Erweitert-Kategorie "Preferences Toolbar".

Die Buttons die gerade auf der Toolbar zu sehen sind werden in der rechten Liste und die verfügbaren, nicht auf der Toolbar sichtbaren, Buttons sind in der linken Liste. Um einen existierenden Button zur Toolbar hinzuzufügen wählen Sie ihn in der linken Liste und klicken Sie auf "Hinzufügen ->". Um ein Element von der Toolbar zu entfernen wählen Sie es in der rechten Liste und klicken Sie auf "<- Entfernen". Um ein Element auf der Toolbar an eine andere Position zu setzen wählen Sie es aus und klicken Sie auf "Nach oben" oder "Nach unten". Zum Anlegen eines neuen Elements klicken Sie auf "Neu". Zum Löschen oder Editieren eines existierenden Elements wählen Sie es aus und wählen "Bearbeiten" oder "Löschen".

Seit Version 3.0 ist es auch möglich die Einträge via Drag&Drop zu verschieben.

Wenn Sie existierende Buttons editieren oder neue erstellen werden ihnen folgende Attribute begegnen:

Id
Alles hat eine Id aber sie werden im Hintergrund eingesetzt. Sie müssen sich deshalb keine Gedanken darum machen. Verwenden Sie einfach irgendeine Zeichenfolge. Sie müssen nur darauf achten die Zeichenfolge einzigartig ist. Verwenden Sie eine Zeichenfolge die ihren Button in einem kurzen Wort beschreibt. Wenn ihre Zeichenfolge nicht einzigartig ist und sie exportieren den Button, dann könnte derjenige der ihre Button-Datei erhält Probleme mit existierenden Buttons bekommen.
Label
Dies ist das Label das auf dem Button und im Einstellungs-Dialog erscheint.
Onclick
Für einen Button ist dies der Code der ausgeführt wird wenn jemand auf den Button klickt. Die eingebauten Buttons haben eingebaute Funktionen und dadurch auch kurze onclick Werte. Wenn Sie einen eigenen Button hinzufügen können Sie den Code-Editor ausnutzen und ihren Code mehrzeilig oder mit Kommentaren eingeben.
Prefstring
Dies ist der Name der Eigenschaft der durch das Element verändert wird. Diese sind nirgends exakt dokumentiert. Der beste Weg den Prefstring für ein neues Element herauszufinden ist es, ihn im XUL Sourcecodes der Eigenschaftsseite die diese Eigenschaft normalerweise verändert, zu suchen.
fromPref & topPref
Diese beiden treten nur bei Checkboxen auf. Weil es verschiedene Typen von Eigenschaften gibt (int, bool, string, etc.) und viele von ihnen merkwürdige Werte nutzen setzt die PrefBar diese in den Status "an" und "aus" durch das frompref und topref Attribut um.

Das frompref Attribut ist eine Javascript Ausdruck der, wenn aufgelöst, den Status der Checkbox zurückgibt auf den die Checkbox gesetzt werden soll (z.B. entweder "an" oder "aus"). Die Variable "value" enthält den aktuellen Status der Eigenschaft. Deshalb sind übliche frompref Werte "value" und "!value". (oder "Boolen(value)" und "Boolean(!value) wenn value eine Zahl ist). Denken Sie daran das das Resultat ein boolescher Wert sein muss. Zeichenfolgen-Eigenschaften erfordern normalerweise kompliziertere topref und frompref Werte.

Das topref Attribut ist das Gegenteil des frompref Attributs. Es wird genutzt um den booleschen Checkbox-Status in den entsprechenden Eigenschaftswert zu übersetzen. Wie frompref muss topref ein Javascript Ausdruck sein der den richtigen Eigenschaftswert im richtigen Datenformat erzeugt. Die "value" Variable enthält den "true" oder "false" Wert der Checkbox. Übliche topref Werte sind "value", "!value" und "2*Number(!value)".

Wie bereits erwähnt sind die Eigenschaften nicht sehr gut dokumentiert. Der beste Weg, um herauszufinden welche Eigenschaft auf welchen Wert gesetzt werden müss, ist es im XUL Sourcecode zu suchen.
Get-Funktion & Set-Funktion
Diese beiden treten nur bei Extchecks und Extlists auf. Diese beiden Button-Typen wurden speziell für Skripte entwickelt. Sie setzen keine Eigenschaften sondern rufen Skripte auf wenn der Benutzer die Checkbox/Liste ändert oder wenn Mozilla den aktuellen Status erhalten möchte.

Die Get-Function ist ein Javascript Ausdruck der immer aufgerufen wird wenn die Prefbar aktualisiert werden muss. Hier möchte die PrefBar wissen was der aktuelle Status des Elements ist. Sie müssen die Variable "value" auf den aktuellen Wert setzen.

Die Set-Funktion ist ein Javascript Ausdruck der immer aufgerufen wird wenn der Benutzer den Status des Elements verändert (einen Eintrag in der Liste wählt oder die Checkbox aktiviert/deaktiviert). Der neue Status ist in der Variable "value".
Bezeichnung & Wert
Bei Dropdown-Listen hat jeder Eintrag einen dazugehörigen Wert auf den die Eigenschaft, die durch den Prefstring definiert ist, gesetzt wird, wenn der Listeneintrag ausgewählt ist. Wenn der Wert eines Eintrags "PREFBARDEFAULT" ist, dann wird die Eigenschaft beim Auswählen dieser Option auf den Standardwert zurückgesetzt. Wenn der Wert und das Label leer sind, dann wird dieser Eintrag beim Bestätigen des Dialogfensters ignoriert.
Url
Für einen Link ist dies die URL auf die Sie verwiesen werden wenn Sie auf den Link klicken. Wie ein Lesezeichen nur nicht so leistunsfähig.

Warum Sie die meisten eingebauten Buttons nicht bearbeiten sollten

Auch wenn Sie nun wissen wie man Buttons bearbeitet ist es nicht empfehlenswert dies mit den meisten Eingenschaften der eingebauten Buttons zu tun ohne vorher eine Kopie des Buttons zu erstellen (ein einfacher "Kopie erstellen" Button ist auf meiner Aufgabenliste). Der Grund ist einfach: Sobald Sie eine neue PrefBar Version einrichten und die Buttons aktualisieren wird PrefBar umgehend ihre eingebauten Buttons aktualisieren und Ihre Änderungen sind verloren!

Ausnahmen von dieser Regel sind:

Sie können auch einen Blick auf die Button-Liste werfen um im Detail zu sehen welche Buttons Sie nicht bearbeiten sollten. Wenn diese Buttons wirklich einen Bug haben, dann teilen Sie mir das mit. Sie sollten keinen Grund haben diese Buttons selber zu bearbeiten.

Eingebaute Buttons, die Sie bearbeiten können

Einige Buttons sind ein Spezialfall. Da diese nicht brauchbar sind ohne einige Dinge zu bearbeiten sind einige Teile vom Update ausgeschlossen. Hier möchten ich Sie informieren wie Sie diese Buttons bearbeiten um Sie für sich nutzbar zu machen.

Resize
Hier können Sie Ihre eigenen Bildschirmauflösungen mit dem Bearbeiten-Button eintragen. Das Format ist:

$BREITEx$HÖHE
User Agent
Sie können hier problemlos eigene User Agents einfügen. Seit PrefBar 3.3 gibt es zwei Wege um dies zu tun:
Einfach den User Agent String eintragen
Als Wert für den neuen User Agent können Sie einfach einen User Agent Wert Ihrer Wahl eintragen. Dies ist zum Beispiel der User Agent von Mozilla 1.7.12 der unter Linux läuft:

Mozilla/5.0 (X11; U; Linux i686; de-AT; rv:1.7.12) Gecko/20050923
Nutzen von Javascript Syntax um mehr als nur den User Agent anzugeben
Dies ist ein neues Feature ds mit PrefBar 3.3 gekommen ist. Sie können nun jedes der folgenden mit Javascript festlegen: useragent, appname, appversion und platform. Dies wird es erlauben an noch mehr Browserweichen vorbeizukommen.

Um PrefBar mitzuteilen das Sie Javascript verwenden müssen Sie dem Wert ein "js:" voranstellen.

Zum Beispiel wäre dies die Zeichenfolge die Sie eintragen würden um Internet Explorer auf Windows XP vorzutäuschen:

js:useragent="Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"; appname="Microsoft Internet Explorer"; appversion="4.0 (compatible; MSIE 6.0; Windows NT 5.1)"; platform="Win32";
Proxylist
Eine Proxy Server Liste würde Ihnen nicht helfen wenn es Ihnen nicht erlaubt wäre Ihre Proxies hier einzutragen ;-) Sie können problemlos eigene Proxies nach folgender Syntax eintragen:

$SERVER:$PORT

Importieren/Exportieren von Elementen

Sie können den "Import" und "Export" im Einstellungs-Dialog verwenden um Buttons in "btn"-Dateien zu exportieren und Buttons von diesen Dateien zu importieren. Dies macht es möglich Buttons sehr einfach an andere zu geben und Buttons oder Button-Packete im Internet anzubieten.

Exportieren
Zum Exportieren von Buttons müssen Sie erst die Buttons, die Sie exportieren wollen, in einer der Listen im Einstellungs-Dialog auswählen. Sie können nicht von beiden Listen auf einmal Buttons exportieren. Dann klicken Sie auf den "Export"-Button. Nun werden Sie gefragt wohin Sie die "btn"-Datei speichern wollen. Nach dem Klicken von "Speichern" wird die Datei erstellt.
Importieren
Wenn Sie eine "btn"-Datei bekommen dann können Sie diese einfach mit dem Button "Import" importieren. Nachdem Sie ihn angeklickt haben wird ein Dialog angezeigt in dem sie ihre "btn"-Datei auswählen müsen. Nach einem Klick auf "Öffnen" wird die Datei importiert. Es ist möglich, dass Sie gefragt werden ob sie exitierende Elemente überschreiben wollen wenn eines der Elemente das Sie importieren wollen die gleiche "Id" wie ein bereits existierendes Element auf der PrefBar hat.

Bekannte Bugs