Überblick
Präfixe sind eine Möglichkeit, deine Metadatentypen weiter zu kategorisieren. Diese Präfixe können dann im Metadaten-Editor gefiltert, sortiert und geändert werden. Außerdem bieten sie eine Möglichkeit, virtuelle eigene Felder zu definieren, die in einem Theme, das die Metadata Utilities-Funktionalitäten eingebunden hat, als einzelne Felder angezeigt werden können.
Präfixe anlegen
Du kannst deine Präfixe in den Addon-Einstellungen unter der Registerkarte „Präfixe“ definieren. Hier ist es außerdem möglich, sie für die Anzeige im Theme zu konfigurieren. Willst du nur Präfixe zum Filtern im Metadaten-Editor haben, brauchst du dich nur um das Feld „Präfix“ kümmern. Alle anderen dienen der Anzeige im Theme. Diese haben folgende Funktion:
- Position: Gibt die Reihenfolge vor, in der die virtuellen Felder im Theme angezeigt werden. Die Reihenfolge wird allerdings primär vom Feldtyp und der Reihenfolge vorgegeben, in der diese im Theme integriert sind. Das Feld Position gibt also die Reihenfolge je Feldtyp vor. Werte ohne Präfix werden je Feldtyp jeweils als Position 1 angezeigt.
- Präfix: Der eigentliche Prefix, nach dem getrennt wird. Hast du beispielsweise einen Präfix „[Perspektive] “ und ein Schlagwort „[Perspektive] First Person“, wird dieses im Metadaten Editor und im Theme als „First Person“ angezeigt. Ein weiteres Schlagwort „[Perspektive] Third Person“ wird dann dem gleichen virtuellen Feld als „Third Person“ zugeordnet. Leerzeichen zwischen Präfix und dem Rest des Namens sind Teil des Präfixes.
- Icon: Gibt ein Icon an, das für diesen Präfix im Theme vor dem Feldnamen angezeigt wird. Hier kannst du z.B. Emoji, aber auch Werte aus der „IcoFont“ verwenden. Diese müssen aber als wirkliches Zeichen kopiert werden und werden derzeit leider nicht so in den Einstellungen dargestellt. Außerdem beinhaltet die von Playnite verwendete Version der Font leider nicht alle Zeichen.
- Name: Unter diesem Namen werden die Werte des Präfixes im Theme dargestellt.
- Typ: Gibt den Feldtyp an, für den der Präfix gilt. Du kannst die selben Präfixe für mehrere Feldtypen verwenden. In den Comboboxen werden sie allerdings dennoch nur einmal angezeigt und gefiltert wird auch typ-übergreifend.
Integration ins Theme
Metadata Utilities bietet Controls an, mit denen sich im Theme alle Feldtypen anzeigen lassen, die auch im Metadaten-Editor unterstützt werden. Diese müssen vom jeweiligen Theme unterstützt werden, damit sie funktionieren. Eine Beschreibung für Theme-Autoren habe ich hier zusammengestellt. Die Controls ersetzen dabei die eigentliche Anzeige dieser Felder und bieten einige Zusatzfunktionen.
- Aufteilen der Werte nach Präfixen in virtuelle Felder: Wie schon erwähnt, werden die Präfixe in den Controls wie einzelne Felder behandelt und angezeigt. So werden beispielsweise aus einer ellenlangen Liste von Tags verschiedenster Art mehrere aussagekräftige Felder.
- Editieren der Werte direkt im Theme: Über die Checkboxen „Hinzufügen-Button anzeigen“ und „Löschen-Button anzeigen“ auf der Präfix-Seite in den Addon-Einstellungen oben lassen sich Buttons zum Hinzufügen und Entfernen von Werten im Theme aktivieren. Die Box „Löschen bestätigen“ blendet zudem bei Klick auf den Löschen-Button zu einem Wert die Abfrage ein, ob man den Wert wirklich löschen will.
- Ausblenden einzelner Werte: In der Whitelist in den Addon-Einstellungen lässt sich über die Checkbox „In den Details verstecken“ der jeweilige Wert im Theme ausblenden. So kann man beispielsweise die Anzeige von Tags verhindern, die von Addons wie Duplicate Hider nur zur Steuerung ihrer Funktionen benötigt werden.