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
Importen/Exportieren von Elementen
Bekannte Bugs
Installiation der PrefBar
Die Preferences Toolbar wurde so optimiert das sie ohne Fehler auf Mozilla-Builds 1.5-1.7 und Firefox Release 0.8 funktioniert. Der Gebrauch in zukünftigen Mozilla 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 das 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". - Label & Value
-
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 "" 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 diese Liste einen Eintrag weniger haben wie normalerweise möglich.
Wenn Sie weniger als 6 Einträge in einer Liste haben stellen Sie sicher das die leeren Einträge die letzten Einträge sind. Andernfalls machen die Listen sonderbare Dinge. - 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.
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
- Der Kill Flash Button scheint Frames nicht sehr zu mögen. Ich werde dieses Problem später lösen müssen.
- Einige der Einstellungen scheinen nicht mit Firefox zu funktionieren. Ich bin mir nicht sicher was zu diesen Problemen führt aber wir werden den Code in eine Firefox und eine Mozilla-Version trennen müssen, wenn das Problem nicht gelöst werden kann.
- Die Bereiche "Preferences Toolbar benutzen" und "Credits" sind noch nicht übersetzt. Dies wird in der nächsten Version der Fall sein