diff --git a/.gitignore b/.gitignore index bc08e4ed4..6a46b1f3c 100755 --- a/.gitignore +++ b/.gitignore @@ -25,7 +25,10 @@ ehthumbs.db Thumbs.db # don't upload private plugins -/priv_* +/priv_*/ + +# don't upload plugins loaded from develop to a release installation +/*_dev/ # Pycharm settings /.idea diff --git a/neato/user_doc.rst b/neato/user_doc.rst index c0a8db5c9..2871982fb 100755 --- a/neato/user_doc.rst +++ b/neato/user_doc.rst @@ -37,6 +37,47 @@ Neato Botvac D7 ja nein Vorwerk VR300 ja ja =============== ============= ========== +Authentifizierung +================= + +Das Plugin unterstützt zwei verschiedene Arten der Authentifizierung mit dem Neato oder Vorwerk Backend: + +a) Authentifizierung über Emailadresse des Nutzerkontos und zugehöriges Passwort. Nutzbar für Neato und alte Vorwerk API + +.. code-block:: html + Neato: + plugin_name: neato + account_email: 'your_neato_account_email' + account_pass: 'your_neato_account_password!' + robot_vendor: 'neato or vorwerk' + +b) Oauth2 Authentifizierung über Emailadresse des Nutzerkontos und Token. Nutzbar nur für Vorwerk mit dem aktuellen MyKobol APP Interface + +.. code-block:: html + + Neato: + plugin_name: neato + account_email: 'your_neato_account_email' + token: 'HEX_ASCII_TOKEN' + robot_vendor: 'vorwerk' + +Der Token kann hier kompfortabel über die Schritt für Schritt Anleitung des Plugin Webinterfaces generiert werden, siehe Vorwerk OAuth2 Tab. + +Wenn eine Nutzung des Webinterfaces nicht möglich ist, kann ein Token auch manuell generiert werden. Hierzu: + +a) Neato plugin aktivieren und Emailadresse des Vorwerk Nutzerkontos konfigurieren. + +b) Plugin Logging auf Level INFO stellen (in logger.yaml oder via Admin Interface) + +c) Plugin Funktion request_oauth2_code ausführen. Hierbei wird ein Code bei Vorwerk angefragt, welcher an die oben angegebene Emaildresse gesendet wird. + +d) Nach Erhalt des Codes die Plugin Funktion request_oauth2_token(code) ausführen, wobei als Argument der per Email erhaltene Code übergeben wird. + +e) Im Logfile nach dem generierten ASCII Token im Hexadezimalformat suchen + +f) Das Hex ASCII Token in der plugin.yaml angeben. + + Unterstützte Plugin Attribute ============================= diff --git a/sonos/plugin.yaml b/sonos/plugin.yaml index 4fca62837..4c4917a7e 100755 --- a/sonos/plugin.yaml +++ b/sonos/plugin.yaml @@ -85,28 +85,6 @@ parameters: de: "(optional) Verlängert die Dauer von Snippet Audio Dateien um einen festen Offset in Sekunden." en: "(optional) Extend snippet duration by a fixed offset specified in seconds" - webif_pagelength: - type: int - default: 0 - valid_list: - - -1 - - 0 - - 25 - - 50 - - 100 - description: - de: 'Anzahl an Items, die standardmäßig in einer Web Interface Tabelle pro Seite angezeigt werden. - 0 = automatisch, -1 = alle' - en: 'Amount of items being listed in a web interface table per page by default. - 0 = automatic, -1 = all' - description_long: - de: 'Anzahl an Items, die standardmäßig in einer Web Interface Tabelle pro Seite angezeigt werden.\n - Bei 0 wird die Tabelle automatisch an die Höhe des Browserfensters angepasst.\n - Bei -1 werden alle Tabelleneinträge auf einer Seite angezeigt.' - en: 'Amount of items being listed in a web interface table per page by default.\n - 0 adjusts the table height automatically based on the height of the browser windows.\n - -1 shows all table entries on one page.' - item_attributes: sonos_uid: type: str