Quelltext von Seite Block-plugin ansehen

==Beschreibung==

'''Autor:''' Michael Schneider

Diese Plugin blockt bestimmte Sendungen anhand von Suchbegriffen in [[EPG|der elektronischen Programmvorschau]].

===Status===
Letztes Update 04/2012


Das block-plugin ist ein fork des verwaisten [[taste-plugin]] von LordJaxom. Grundlage bildete ein CVS checkout des taste plugins im Januar 2010 sowie [http://www.vdr-portal.de/board/thread.php?threadid=90293 patches] von tomg und mapovi.

Als Weiterentwicklung des taste-plugin dient das block-plugin zunächst einmal ebenso dazu Sendungen anhand ihres EPG-Titels beim Umschalten zu sperren, was zum Beispiel aus Gründen des Niveaus notwendig sein kann. Das block-plugin kann darüber hinaus auch permanent mit dem aktuellen EPG-Titel abgleichen, es bietet zusätzliche whitelist-Funktionalität und ermöglicht die Einrichtung einer optionalen konfigurierbaren [[:Kategorie:Kindersicherung|Kindersicherung]] (inklusive Berücksichtigen der rating-Information aus dem DVB stream sowie Verhindern des Abspielens von Aufnahmen mit gesperrtem Titel). Ferner werden auch Sender ohne oder mit leerem EPG berücksichtigt. Außerdem sind die Probleme des taste-plugins mit Budget/non-FF output Konfigurationen sowie mit dem Freischalten per ‚Ok’-Taste behoben.

Statt einer gesperrten Sendung wird ein schwarzer Bildschirm ohne Ton angezeigt und es erscheint eine entsprechende Meldung im OSD (Standard: 2 Sekunden lang). Während der Anzeige dieser Meldung kann der Benutzer per ‚Ok’ das Programm freischalten und die Sendung trotz Sperre schauen, er kann mit (Channel) Up/Down das Programm weiterzappen oder er macht nichts. In diesem Fall schaltet der VDR nach Anzeige der Meldung selbständig auf ein anderes Programm und zwar regulär in Richtung des letzten Umschaltens (z.B. 55->54[gesperrt]->53 bzw. umgekehrt). Sollte dies nicht möglich sein fällt das Plugin auf den zuvor geschauten Kanal zurück.

Bei Einrichtung als Kindersicherung werden verschiedene Einstellungen automatisch gesetzt und gegen Veränderung gesperrt oder eingeschränkt (Detektionsmethode, Freischalten, Editieren/Löschen von Einträgen, Whitelist etc.).

==Bilder==

Die Bilder stammen aus der aus der Version 0.1.0. Aktuelle Änderungen bitte immer in HISTORY und README oder im [http://www.vdr-portal.de/board/thread.php?threadid=95956 VDR-Portal] nachlesen.

<gallery>
block-plugin-02.jpg|Aktuelle Sendung ist gesperrt
block-plugin-03.jpg|Setup (mit aktivierter Kindersicherung)
block-plugin-00.jpg
block-plugin-01.jpg
</gallery>

==Bedienung==

'''Sendungen sperren'''

Sendungen lassen sich im Hauptmenü des VDR unter ‚Sendung (ent)sperren’ in die blacklist des block-plugins aufnehmen. Der aktuelle EPG-Titel ist damit in die Mustererkennung des Plugins aufgenommen und wird fortan gesperrt.


'''Sendungen freigeben / editieren / manuell hinzufügen'''

Seit Version 0.0.4 dient auch der Hauptmenüeintrag zur permanenten Freigabe. Soll eine gesperrte Sendung wieder permanent freigegeben werden, reicht es diese per {{Button neutral|OK}} zunächst temporär freizugeben und dann einfach im Hauptmenü wieder 'Sendung (ent)sperren' anzuwählen. Der Titel ist dann wieder entsperrt.

Für diese und die weiteren Funktionen kann ansonsten der Einstellungsdialog des block-plugins im VDR aufgerufen werden. Unterhalb der Konfigurationsparameter befindet sich die Liste gesperrter Sendungen, deren Einträge per Farbtaste verändert werden können: 
* {{Button rot|Editieren}} Es erscheint ein Untermenü, in dem der Benutzer den Titel verändern kann sowie ein Schalter zum Ignorieren von Groß-/Kleinschreibung und es gibt die Möglichkeit den Eintrag als regulären Ausdruck zu markieren.
* {{Button grün|Neu}} Legt ‚Neuer Eintrag’ an. Dieser lässt sich danach durch das Editieren anpassen.
* {{Button gelb|Löschen}} Nach Bestätigung wird der aktuelle Eintrag gelöscht.
* {{Button blau|+/-}} Schaltet den aktuellen Eintrag auf freigegeben (+) oder gesperrt (-)


Die Trefferliste kann auch manuell per Editor bearbeitet werden (siehe Konfiguration).

==Konfiguration==

'''Manuelles Editieren der Regelliste'''

Die Trefferliste des plugins befindet sich seit Version 0.1.0 in der folgenden Datei (Trefferlisten älterer Versionen des taste- oder block-plugns werden automatisch erkannt, importiert und die neue Datei angelegt):

<pre>$VDRCONFIG/plugins/block/block.conf</pre>

Frühere Versionen nutzten den Pfad $VDRCONFIG/plugins/block.conf bzw taste.conf. Beim ersten Start mit einer Version des block plugins >=0.1.0 werden der neue Pfad und die Datei automatisch angelegt. Dabei werden alte Versionen der Liste des taste-plugins oder des block-plugins berücksichtigt und auf deren Grundlage die neue Datei erzeugt. Währenddessen werden doppelte Einträge (ignoriert Groß/Klein) entfernt und alle Einträge als gesperrt markiert. Die zu Grunde liegende alte Trefferliste wird außerdem als Backup im gleichen Pfad unter dem Namen block.conf.safe-pre0.1.0 abgelegt.

Die Trefferliste lässt sich mit jedem linuxkonformen Editor bearbeiten. Eine Zeile besteht aus vier Einträgen:


X:Y:Z:Muster


X: 0 = Muster ist kein regulärer Ausdruck; 1 = Muster ist regulärer Ausdruck

Y: 0 = Groß-/Kleinschreibung interpretieren; 1 = Groß-/Kleinschreibung ignorieren

Z: + = Muster bezeichnet freigegebene Sendung(en); - = Muster bezeichnet gesperrte Sendung(en)

Muster: EPG-Titel bzw. Teil des EPG-Titels (Schlagwort) der Sendung oder regulärer Ausdruck


'''Umstieg vom taste-plugin auf das block-plugin'''

Seit Version 0.1.0 des block plugins werden ältere Trefferlisten des taste oder des block-plugins automatisch importiert. 

'''Kindersicherung (experimentell) '''

Für die Einrichtung einer Kindersicherung sind verschiedene Einstellungen notwendig, die sich jedoch in $VDRCONFIG/setup.conf mit einer Einstellung automatisch setzen lassen. Es ist notwendig das laufende Programm permanent auf gesperrte Titel zu untersuchen das Freischalten per ‚Ok’ und im Hauptmenü zu verhindern sowie das Löschen und Whitelisten von Einträgen zu verhindern und das Anlegen neuer Einträge und das Editieren einzuschränken. Durch Hinzufügen der Zeile

<pre>block.ParentalGuidance=1</pre>

in $VDRCONFIG/setup.conf werden die aktuellen Werte dieser Einstellungen überschrieben und die entsprechenden Funktionen gesperrt. Damit die Zeile in der setup.conf angenommen wird, muss der VDR während des Editierens gestoppt sein. Um die Kindersicherung wieder abzuschalten kann die Zeile einfach gelöscht werden, oder block.ParentalGuidance=0 gesetzt werden (beides ebenfalls bei gestopptem VDR).

Um beispielsweise alle Sendungen per se zu sperren (alle!) und nur noch whitelist-Regeln freizuschalten, kann man zum Beispiel folgenden regulären Ausdruck (muss für diesen Eintrag natürlich aktiviert sein) Regel definieren: [.]*

Seit Version 0.1.2 werden auch Altersfreibeinformationen aus dem DVB-Stream berücksichtigt (ab vdr 1.7.11). Dabei werden per se alle Sendungen mit einem rating von 0 oder ohne rating gesperrt. Ferner werden Sendungen automatisch freigegeben, die ein unterhalb der im plugin setup angegebenen Grenze liegendes rating haben. Da die meisten Sender und somit die meisten Sendungen keine ordentlichen Informationen mitsenden (rating immer 0) berücksichtigt block nur Werte ab 1. Dies führt automatisch dazu, dass bei Angabe eines Wertes bei 'Alterfreigabe (DVB)' fast alle Sendungen gesperrt sind. Dazu gehören dann auch Kindersendungen, die korrekterweise keine Altersbeschränkung haben und es werden nur Sendungen automatisch freigegeben, deren rating innerhalb der im setup angegebenen Grenze liegt.


Aber Vorsicht: Bei aktiviertem Kindersicherungsmodus gibt es dann keine direkte Möglichkeit nachträglich whitelist-Einträge hinzuzufügen.


{{Box Hinweis|
Diese Form der Kindersicherung möchte und kann die Eltern in ihrer Aufsichtspflicht nicht ersetzen. Der Autor des block-plugins übernimmt daher keinerlei Verantwortung für die Funktion als Kindersicherung.
}}

==Einstellungen==

''Hauptmenüeintrag verstecken'' - ‚Sendung sperren’ im Hauptmenü des VDR wird angezeigt oder nicht

''Wartezeit bis Umschalten [s]'' - Dauer der Meldung im OSD, bei Detektion einer gesperrten Sendung und Gelegenheit zur Benutzerinteraktion (maximal 10 s)

''Detektionsmethode'' - ‚Beim Umschalten’ ist die Methode, wie sie bereits vom taste-plugin bekannt ist. Es wird nur beim Umschalten mit der Sperrliste abgeglichen. Bei der Methode ‚Kanal EPG’ wird dagegen permanent der aktuelle EPG-Titel untersucht, so dass auch bei Beginn einer gesperrten Sendung auf dem aktuellen Kanal die Blockfunktion greift.

''Ok entsperrt temporär'' - Legt fest, ob der Benutzer bei einer Sperrmeldung im OSD das gesperrte Programm mit ‚Ok’ temporär (bis zum nächsten Umschalten) freischalten kann oder nicht.

''Unschärfepriorität'' - Durch die Kombination von whitelist- und blacklist-Einträgen kann es vorkommen, dass widersprüchliche Treffer in der Liste gefunden werden. In diesem Fall fällt das plugin auf den Wert der Option 'Unschärfepriorität' zurück.

''Altersfreigabe (DVB)'' - Altersangabe für die Freigabe von Sendungen, die eine verlässliche rating-Angabe im DVB-stream enthalten (ab block 0.1.2 sowie vdr 1.7.11) für automatisches Freigeben von Sendungen. 0 = deaktiviert.

==Funktionsweise==

Die Entscheidungfindung, ob ein Eintrag als gesperrt oder nicht gesperrt erachtet wird läuft wie folgt:

1. Sammeln aller zutreffenden Regeln in der Liste

2. Ist keine zutreffende Regel vorhanden wird der Titel als freigegeben bewertet.

3. Sind alle zutreffenden Regeln blacklist ODER whitelist Einträge wird anhand dessen bewertet.

4. Werden widersprüchliche Regeln gefunden, fällt das Plugin auf den im Setup eingestellten Wert der Option 'Unschärfepriorität' zurück.

5. Stimmt ein Treffer exakt mit dem aktuellen EPG-Titel überein, so genießt dieser Treffer höchste Priorität und es wird anhand dieses Treffers bewertet.

So ist es möglich auch bei umfassenden regulären Ausdrücken oder bei häufiger zutreffenden Teilausdrücken (Beispiel: 'Richter' ist blacklistet 'Der Richter und sein Henker' soll aber whitelistet sein.), trotzdem bequem und schnell über das Hauptmenü eine fälschlich miteinbezogene Sendung freizugeben ohne die umfassendere oder unscharfe Regel zu verändern oder zu löschen.

Zur Vermeidung von Duplikaten wird bei Ignorieren von Groß/Kleinschreibung nach einem exakten Treffer in der Liste gesucht, und gegebenenfalls lediglich dessen Attribut white/blacklist sowie eventuell das Attribut Groß/Kleinschreibung umgeschaltet. 

==Probleme==

Die Sperrfunktionen des block-plugins wie auch des taste-plugins reagieren auf den aktuell im VDR gemeldeten EPG-Titel der laufenden Sendung. Sind diese EPG-Informationen nicht korrekt, weil zum Beispiel der Sender seine EPG-Daten nicht synchron aktualisiert, beeinflusst dies natürlich auch die Sperrfunktion. Bitte besonders bei Nutzung als Kindersicherung beachten. Ferner kann bei Nutzung der Kindersicherung die Information aus dem EPG eine andere sein als die Information aus dem DVB-stream. Letzterer hat in diesem Fall Priorität.

==Git Versionen==
 git clone git://projects.vdr-developer.org/vdr-plugin-block.git

==Aktuelle Version==
[http://projects.vdr-developer.org/attachments/download/913/vdr-plugin-block-0.1.2.tgz 0.1.2]

==Links==
# [http://projects.vdr-developer.org/projects/show/plg-block Homepage des Plugins]
# [http://www.vdr-portal.de/board/thread.php?threadid=95956 Thread im VDR-Portal]
[[Kategorie:Plugins]]
[[Kategorie:Kindersicherung]]