Mit dieser Komponente können Anwender Präferenzen festlegen auf welche programmatisch reagiert werden kann. Zudem kann eine Oberfläche zur Pflege dieser Präferenzen abgerufen werden. Die Integration dieser Oberfläche obliegt allerdings den entsprechenden Zieloberflächen. Die Präferenzen werden pro Anwender in der neuen Entity ComponentPreference gespeichert und können immer (unabhängig der Rechtekonfiguration) abgerufen werden.

Programmatischer Zugriff

Die nachfolgenden Methoden stehen für einen programmatischen Zugriff zur Verfügung und können im Manager von Component/Preference gefunden werden.

use Brandbox\Framework\Component\Preference;

$content = $this
	->staticController(Preference\Manager::class)
	->getPreferenceContent('[Identifikator der Präferenz]')
;

// $content enthält ggf. einen Standardwert des Entities, null oder den durch den Anwender festgelegten Wert

use Brandbox\Framework\Component\Preference;

$this
	->staticController(Preference\Manager::class)
	->setPreferenceContent('[Identifikator der Präferenz]', '[Inhalt der Präferenz]')
;

Integration der Pflegeoberfläche

Um dem Anwender die Pflege seiner Präferenzen zu ermöglichen, muss die genutzte Oberfläche eine Integration von Component/Preference durchführen. Hierzu wird über den nachfolgenden Code die Pflegemaske von Component/Preference abgerufen welche dann in der integrierenden Oberfläche platziert werden kann.

use Brandbox\Framework\Component\Preference;

$container = $this
	->staticController(Preference\Manager::class)
	->getPreferenceContainer(...$flags)
;

// $container enthält eine Instanz des FrameworkContainer aus dem framework-styleguide mit einer Toolbar und einem Formular
// $flags ist ein Array aus Strings mit frei-wählbaren Kennzeichen welche in den Events zur Verfügung stehen

Verfügbare Events

Rechtekonfiguration

Für diese Komponente gibt es keine notwendige Rollen- oder Rechtekonfiguration. Die Präfernenzentabelle mit allen Datensätzen kann nur durch Administratoren eingesehen werden. Jeder Anwender kann jederzeit seine Präferenzen speichern und lesen.