Skip to content

Commit

Permalink
mailsend: added minimal user_doc.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
aschwith committed Sep 20, 2023
1 parent 08cb5b7 commit 1ec32e6
Show file tree
Hide file tree
Showing 3 changed files with 100 additions and 39 deletions.
37 changes: 0 additions & 37 deletions mailsend/README.md

This file was deleted.

4 changes: 2 additions & 2 deletions mailsend/plugin.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ parameters:
type: str
default: ''
description:
de: 'Absender-Adresse der eMails ([email protected])'
de: 'Absenderadresse der eMails ([email protected])'
en: 'Sender address of the emails ([email protected])'

username:
Expand Down Expand Up @@ -83,7 +83,7 @@ plugin_functions:
type: str
description:
de: "Empfänger der eMail ([email protected])"
en: "Receipient of email ([email protected])"
en: "Recipient of email ([email protected])"
subject:
type: foo
description:
Expand Down
98 changes: 98 additions & 0 deletions mailsend/user_doc.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
.. index:: Plugins; sample
.. index:: sample

======
sample
======

Hier sollte eine allgemeine Beschreibung stehen, wozu das Plugin gut ist (was es tut).

.. image:: webif/static/img/plugin_logo.png
:alt: plugin logo
:width: 300px
:height: 300px
:scale: 50 %
:align: left


Anforderungen
=============

Anforderungen des Plugins auflisten. Werden spezielle Soft- oder Hardwarekomponenten benötigt?


Notwendige Software
-------------------

* die
* benötigte
* Software
* auflisten

Dies beinhaltet Python- und SmartHomeNG-Module

Unterstützte Geräte
-------------------

* die
* unterstütze
* Hardware
* auflisten

|
Konfiguration
=============

Die Plugin Parameter und die Informationen zur Item-spezifischen Konfiguration des Plugins sind
unter :doc:`/plugins_doc/config/sample` beschrieben.

plugin.yaml
-----------

Bitte die Dokumentation lesen, die aus den Metadaten der plugin.yaml erzeugt wurde.


items.yaml
----------

Bitte die Dokumentation lesen, die aus den Metadaten der plugin.yaml erzeugt wurde.


logic.yaml
----------

Bitte die Dokumentation lesen, die aus den Metadaten der plugin.yaml erzeugt wurde.


Funktionen
----------

Bitte die Dokumentation lesen, die aus den Metadaten der plugin.yaml erzeugt wurde.

|
Beispiele
=========

Hier können ausführlichere Beispiele und Anwendungsfälle beschrieben werden. (Sonst ist der Abschnitt zu löschen)

|
Web Interface
=============

Die Datei ``dev/sample_plugin/webif/templates/index.html`` sollte als Grundlage für Webinterfaces genutzt werden. Um Tabelleninhalte nach Spalten filtern und sortieren zu können, muss der entsprechende Code Block mit Referenz auf die relevante Table ID eingefügt werden (siehe Doku).

SmartHomeNG liefert eine Reihe Komponenten von Drittherstellern mit, die für die Gestaltung des Webinterfaces genutzt werden können. Erweiterungen dieser Komponenten usw. finden sich im Ordner ``/modules/http/webif/gstatic``.

Wenn das Plugin darüber hinaus noch Komponenten benötigt, werden diese im Ordner ``webif/static`` des Plugins abgelegt.

|
Version History
===============

In diesem Abschnitt kann die Versionshistorie dokumentiert werden, falls der Plugin Autor dieses möchte. Diese Abschnitt
ist optional.

0 comments on commit 1ec32e6

Please sign in to comment.