Vorlage:Infobox Modul: Unterschied zwischen den Versionen

Aus FHEMWiki
(Schablone neu erstellt; noch nicht zur generellen Nutzung "freigegeben")
 
(.)
 
(24 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<onlyinclude>
<onlyinclude>
{| class="float-right infobox toccolours" style="margin: 0 0 1em 1em; float:right" width="300"
{| class="float-right infobox toccolours" style="margin: 0 0 1em 1em; float:right" width="300"
! colspan="2" style="background-color:#EFEFFF" | {{#if: {{{Name|}}}|{{{Name}}}|{{PAGENAME}} }}
! colspan="2" style="background-color:#EFEFFF" | {{#if: {{{ModCmdRef|}}}|{{{ModCmdRef}}}|{{PAGENAME}} }}
<!-- auskommentiert ...
...-->
|- style="background-color:#FFFFFF"
! colspan="2" | Die Vorlage ist noch in Entwicklung.<br />Bitte noch nicht benutzen!
|- style="background-color:#EFEFFF"
|- style="background-color:#EFEFFF"
! colspan="2" | Zweck / Funktion
! colspan="2" | Zweck / Funktion
Zeile 13: Zeile 9:
! colspan="2" | Allgemein
! colspan="2" | Allgemein
|- bgcolor="#FFFFFF"
|- bgcolor="#FFFFFF"
| Typ || {{{ModType}}}
<!-- | Typ || {{{ModType}}} .................................. -->
<!-- auskommentiert ...
<!-- Vordefinierte Modultypen / "AutoKategorie" .............. -->
|- bgcolor="#FFFFFF"
| Typ
| Kategorie || {{{ModCategory}}}  
| {{#switch:
...-->
{{{ModType}}}          <!--
-->| cmd = Befehl        [[Kategorie:FHEM Befehl]]          <!--
-->| u = Utilities      [[Kategorie:FHEM Utilities]]        <!--
-->| contrib = [https://svn.fhem.de/trac/browser/trunk/fhem/contrib Contrib]  [[Kategorie:Modul (Contrib)]]      <!--
-->| d = Gerätemodul    [[Kategorie:Gerätemodul]]          <!--
-->| h = Hilfsmodul      [[Kategorie:Hilfsmodul]]          <!--
-->| x = Inoffiziell    [[Kategorie:Modul (Inoffiziell)]]  <!--
-->| #default = undefiniert }}
<!--          Ende Modultypen / "AutoKategorie" ............. -->
|- style="background-color:#EFEFFF"
|- style="background-color:#EFEFFF"
! colspan="2" | Details
! colspan="2" | Details
|- bgcolor="#FFFFFF"
|- bgcolor="#FFFFFF"
| Dokumentation || [http://fhem.de/commandref.html#{{PAGENAME}} EN] / [http://fhem.de/commandref_DE.html#{{PAGENAME}} DE]
<!--          Dokumentation  ................................ -->
| Dokumentation  
| {{#switch:
{{{ModType}}}          <!--
-->| x|u = {{#if: {{{ModFTopic|}}}          |    <!-- ModFTopic gesetzt, dann
--> {{Link2Forum|Topic={{{ModFTopic}}}}}  |    <!-- Link auf Forentopic generieren
--> siehe Forum }}                        |   <!-- nicht gesetzt; default text
--> contrib = {{#if: {{{ModFTopic|}}}    |    <!--
--> {{Link2Forum|Topic={{{ModFTopic}}}}}  |    <!--
--> siehe Forum  }}                      |  <!--
--> cmd|d|h =  {{#if: {{{ModCmdRef|}}}  <!--
ModName=y -->| {{Link2CmdRef|Anker={{{ModCmdRef}}}|Label=EN}} / {{Link2CmdRef|Anker={{{ModCmdRef}}}|Label=DE|Lang=de}} <!--
ModName=p -->| {{Link2CmdRef|Anker={{PAGENAME}}|Label=EN}} / {{Link2CmdRef|Anker={{PAGENAME}}|Label=DE|Lang=de}} <!-- endif 'Modulname angegeben'
-->}}{{#if: {{{ModFTopic|}}} | <br>{{Link2Forum|Topic={{{ModFTopic}}}}}|}}        |                          <!-- end_if CmdRef angegeben
-->| #default = ModUndef }}
<!--          ForumArea ..................................... -->
|- bgcolor="#FFFFFF"
|- bgcolor="#FFFFFF"
| ModTechName || {{{ModTechName}}}
{{#if: {{{ModForumArea|}}} |
{{!}} Support (Forum) {{!!}} {{Link2Forum|Area={{{ModForumArea|}}}}}
}}
<!--          Modul - technischer Name (nn_naMe.pm) ......... -->
|- bgcolor="#FFFFFF"
|- bgcolor="#FFFFFF"
| Ersteller || {{{ModOwner}}}
| Modulname || {{{ModTechName}}}
<!--          Ersteller (Maintainer) ........................ -->
|- bgcolor="#FFFFFF"
| [http://fhem.de/MAINTAINER.txt Ersteller] || {{{ModOwner}}}
<!-- commandref disclaimer -->
|- style="background-color:#7FFFD4"
| colspan="2" | '''Wichtig''': sofern vorhanden, gilt im Zweifel '''immer''' die (englische) Beschreibung in der ''{{Link2CmdRef|Anker=#|Label=commandref}}''!
|}
|}
</onlyinclude>
</onlyinclude>


<noinclude>
<noinclude>
'''Dokumentation'''
__NOTOC__


== Dokumentation ==
Benutzung dieser Vorlage: <nowiki>{{Infobox Modul|...}}</nowiki>
Benutzung dieser Vorlage: <nowiki>{{Infobox Modul|...}}</nowiki>


Diese Vorlage dient zur Zusammenfassung von Schlüsseldaten zu einem Modul und sollte auf der Beschreibungsseite des Moduls verwendet werden.
Diese Vorlage dient zur Zusammenfassung von Schlüsseldaten zu einem Modul und sollte auf der Beschreibungsseite des Moduls verwendet werden.


''Die Vorlage ist derzeit noch in der Entwicklung, bitte noch nicht in größerem Ausmaß (außer über evtl. eigene Tests hinaus) benutzen.''
=== Aufrufparameter ===
;ModPurpose
:Kurzbeschreibung der Funktion / des Zwecks dieses Moduls
;ModType
:Modultyp, ausgehend von der Einteilung in der commandref: <br />'''cmd'''="fhem commands" (FHEM-Befehle) <br />'''contrib'''="Contrib" Inoffizielles Modul, das aus dem Contrib-Unterverzeichnis des FHEM-Repositories geladen werden muss; externer Link auf das Verzeichnis wird automatisch generiert. <br />'''d'''="devices" (Geräte) <br />'''h'''="helper modules" (Hilfs(Erweiterungs-)module) <br />'''u'''="Utilities" (Sammlung von Hilfsfunktionen für bestimmte Einsatzbereiche) <br />'''x'''="experimentell" (Inoffiziell; noch nicht Teil des Standard-FHEM, aber auch nicht im "contrib" Unterverzeichnis bei sourceforge abgelegt; derartige Module sind in der Regel über den zugehörigen Diskussionsfaden im [forum.fhem.de FHEM Forum] zu beziehen).  <br />Abhängig vom gewählten Modultyp wird ein Kategorieeintrag für ''FHEM Befehl'', ''FHEM Utilities'', ''Gerätemodul'', ''Hilfsmodul'', ''Modul (Contrib)'' oder ''Modul (Inoffiziell)'' erzeugt.
{{Randnotiz|RNTyp=y|RNText=Entspricht der Seitentitel nicht dem Modulnamen, müssen die folgenden zusätzlichen Maßnahmen ergriffen werden:
* An den Beginn der Modul-Seite '''muss''' die Anweisung <nowiki>{{SEITENTITEL:naMeInRichtigerSchreibweise}}</nowiki> eingefügt werden
* Der Parameter ''ModCmdRef=naMeInRichtigerSchreibweise'' '''muss''' für die ''Infobox Modul'' spezifiziert werden.
}}
;ModCmdRef
:optionaler Parameter (für die Bestimmung des Wertes für die Zeile ''Dokumentation''). Falls nicht angegeben, wird aus dem Seitentitel ein Link auf den entsprechenden Abschnitt der commandref generiert. Weicht der Seitentitel von der Bezeichnung des Abschnitts in der commandref ab (z.&nbsp;B., weil der Modulname "eigentlich" mit einem Kleinbuchstaben beginnt), kann hier der Name in der korrekten Schreibweise spezifiziert werden. <br>Für ModType=''x'' und ''contrib'' wird kein Link auf die commandref erzeugt (da der entsprechende Abschnitt noch nicht existieren dürfte), sondern ein schlichter Verweis auf das FHEM Forum. Wenn Parameter '''''ModFTopic''''' spezifiziert ist, wird ein Link auf diesen Forenthread generiert. <br>Ist '''''ModFTopic''''' für "offizielle" Module spezifiziert, wird zusätzlich der Link auf den entsprechenden Forenthread generiert.
;ModFTopic
:optionaler Parameter. Forendiskussion zu diesem Modul; numerischer Wert, der zu einem Verweis auf den ersten Beitrag des Diskussionsfadens (Threads, Topics) führt.
{{Randnotiz|RNTyp=y|RNText=Beispiel für das ''ModOwner''-Feld:
:<code>Peter/ph1959de (<nowiki>{{Link2FU|73|Forum}}/[[Benutzer Diskussion:ph1959de|Wiki]]</nowiki>)</code>
sieht dann so aus:
:Peter/ph1959de ({{Link2FU|73|Forum}}/[[Benutzer Diskussion:ph1959de|Wiki]])
}}
; ModForumArea
: Name des Forenbereichs, in dem Supportanfragen zu dem Modul gestellt werden können bzw. sollen. Die Liste der Zuordnung von Modul zu Forenbereich ist in der [http://fhem.de/MAINTAINER.txt Liste der Maintainer] enthalten. Der Text wird automatisch in einen Link auf den Forenbereich umgesetzt.
;ModTechName
:Technischer Name des Moduls (also z.&nbsp;B. <code>01_FHEMWEB.pm</code>; siehe [http://fhem.de/MAINTAINER.txt Liste der Maintainer])
;ModOwner
:Name des Modulerstellers bzw. -betreuers (siehe [http://fhem.de/MAINTAINER.txt Liste der Maintainer])
 
=== Felder der Infobox ===
;Titelzeile
:Im Regelfall Seitenname=Modulname=Titelzeile. <br>Stimmt der Modulname nicht mit dem Seitentitel überein, muss der Parameter ''ModCmdRef'' angegeben sein und wird hier verwendet.
;Zweck / Funktion
:Dieses Feld wird direkt aus dem Wert des Parameters ''ModPurpose'' gefüllt.
;Typ
:Modultyp, abgeleitet aus dem Parameter ''ModType''.
;Dokumentation
:Verweis auf die Dokumentation zu diesem Modul; das besteht
:*bei "offiziellen" Modulen aus den automatisch generierten Links auf den entsprechenden Abschnitt der commandref und, optional/zusätzlich, wenn der Parameter ''ModFTopic'' angegeben ist, einem Link auf den spezifizierten Forenthread
:*bei "inoffiziellen" oder "contrib" Modulen aus einem Link auf einen Forenthread (sofern ''ModFTopic'' angegeben ist) oder dem schlichten Hinweis auf das Forum.
;Support (Forum)
:Ein Link auf den Forenbereich, in dem Fragen und Fehlerberichte zu diesem Modul eingestellt werden sollen, das jedoch nur, wenn ''ModForumArea'' angegeben ist.
;Modulname
:Der "technische" Name des Moduls, also z.B. ''01_FHEMWEB.pm''
;Ersteller
:Der Name (Forum/Wiki/...) des Modulverantwortlichen.


== Kopiervorlage ==
=== Kopiervorlage ===
Die folgende Schablone sollte an den Anfang der Zielseite kopiert und ausgefüllt werden.
Die folgende (generelle) Schablone wird an den Anfang der Zielseite kopiert und ausgefüllt. Weitere, modultypspezifische Beispiele, sind weiter unten aufgeführt.
<pre style="width:50%;">{{Infobox Modul
<pre style="width:50%;">
{{Infobox Modul
|ModPurpose=
|ModPurpose=
|ModType=
|ModType=[cmd|contrib|d|h|x]
<!-- |ModCategory= (noch?) nicht verwendet -->
|ModCmdRef=  
<!-- |ModCmdRef=   wird automatisch generiert -->
|ModForumArea=
|ModFTopic=
|ModTechName=
|ModTechName=
|ModOwner=
|ModOwner=
Zeile 50: Zeile 122:
</pre>
</pre>


== Beispiel(e) ==
== Weitere kopierfähige Beispiele ==
Infobox für das Modul [[LightScene]]
=== Modultyp "cmd", "d" oder "h" ===
<!-- <br clear=all>  Testarea  Typ d                          -->
{{Infobox Modul
{{Infobox Modul
|ModPurpose=Speichern und wiederherstellen des Zustands von einer Gruppe von Geräten
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModType=Hilfsmodul
|ModType=d
<!-- |ModCategory=?? -->
|ModForumArea=Forenbereich
<!-- |ModCmdRef=http://fhem.de/commandref.html#LightScene -->
|ModTechName=77_Device.pm
|ModTechName=31_LightScene.pm
|ModOwner=Modulersteller
|ModOwner=justme1968
}}
}}
 
Infobox - mögliche Werte für die Felder bei einem Geräte-(Device-)Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ''ModCmdRef'' angegeben werden.
Infobox - mögliche Werte für die Felder:
<pre style="width:50%;"><nowiki>
{{Infobox Modul
{{Infobox Modul
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModType=Hilfsmodul|Gerät|Kommando
|ModType=d
<!-- |ModCategory=?? -->
|ModForumArea=Forenbereich
<!-- |ModCmdRef=http://fhem.de/commandref.html#LightScene -->
|ModTechName=77_Device.pm
|ModTechName=Dateiname der Implementierung (xx_ModulName.pl)
|ModOwner=Modulersteller
|ModOwner=Modulersteller
}}
}}
[[Kategorie:Vorlage:]]
</nowiki></pre>
 
<br clear=all>
=== Modultyp "x" oder "contrib" ===
<!--    Testarea  Typ contrib                          -->
{{Infobox Modul
|ModPurpose=Ein Modul des Typs "contrib"
|ModType=contrib
|ModFTopic=12345
|ModCmdRef=ContribModul
|ModForumArea=Contrib
|ModTechName=66_Contrib.pm
|ModOwner=Contrib-Owner
}}
Infobox - mögliche/empfohlene Werte für die Felder bei einem inoffiziellen Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ''ModCmdRef'' angegeben werden.
<pre style="width:50%;"><nowiki>
{{Infobox Modul
|ModPurpose=Ein Modul des Typs "contrib"
|ModType=contrib
|ModFTopic=12345
|ModCmdRef=ContribModul
|ModForumArea=Contrib
|ModTechName=66_Contrib.pm
|ModOwner=Contrib-Owner
}}
</nowiki></pre>
 
=== Komplette Liste möglicher Parameter ===
Die folgende Kopiervorlage enthält alle Schlüsselworte ohne Angabe von Werten:
 
<pre style="width:550px;"><nowiki>
{{SEITENTITEL:...}}  <!-- Nur angeben, wenn wirklich erforderlich! -->
 
{{Infobox Modul
|ModPurpose=...
|ModType=...
|ModCmdRef=...
|ModFTopic=...
|ModForumArea=...
|ModTechName=...
|ModOwner=...
}}
</nowiki></pre>
 
<templatedata>
{
"params": {
"ModCmdRef": {
"label": "Modulname",
"description": "Sofern der Modulname vom Seitennamen abweicht (bspw. Groß-/Kleinschreibung) kann hier der korrekte Modulname angegeben werden, so wie er in der Commandref zu finden ist. Falls nicht angegeben wird der Wiki-Seitentitel als Modulname verwendet",
"type": "string"
},
"ModPurpose": {
"label": "Kurzbeschreibung",
"description": "Eine kurze Beschreibung der Funktion / Zweck des Moduls.",
"type": "string",
"required": true,
"suggested": true
},
"ModType": {
"label": "Modul-Typ",
"description": "Typ des Moduls (einzelner Wert), ausgehend von der Einteilung in der commandref: (\"d\" => Gerätemodul, \"h\" => Hilfsmodul, \"cmd\" => Befehlsmodul, \"u\" => Utilities, \"contrib\" => Inoffizielles Modul im contrib-Verzeichnis, \"x\" => experimentelles Modul)",
"example": "d",
"required": true,
"suggested": true
},
"ModFTopic": {
"label": "Forumsbeitrag",
"description": "Die Topic-ID zu einer Diskussion im Forum um weitere Informationen zu erhalten. Hierbei nur die Topic-ID aus dem Link angeben",
"type": "number"
},
"ModForumArea": {
"label": "Forumsbereich",
"description": "Der Name des Forumsbereich, in dem Fragen zu diesem Modul diskutiert werden sollten.",
"type": "string",
"required": true
},
"ModTechName": {
"label": "Dateiname",
"description": "Der vollständige Dateiname des Moduls",
"example": "01_FHEMWEB.pm",
"type": "string",
"required": true,
"suggested": true
},
"ModOwner": {
"label": "Modulersteller",
"description": "Name des Moulerstellers bzw. -betreuers",
"type": "content"
}
},
"description": "Eine Infobox um die wichtigsten Daten zu einem FHEM-Modul darzustellen."
}
</templatedata>
 
== Vorschlag für die Struktur/Gliederung einer Modulseite  ==
Eine Seite, die die Vorlage ''Infobox Modul'' verwendet, sollte sich an der folgenden Gliederung orientieren (wobei der Schwerpunkt auf Anwendungsbeispiele gelegt werden sollte; Zweck ist es nicht, die commandref zu kopieren oder zu ersetzen):
<pre><nowiki>
{{Infobox Modul
...
}}
[[Modulname]] ist ... und macht ... (allgemeine Beschreibung, etwas mehr,
als unter "ModPurpose" angegeben)
 
== Voraussetzungen ==
Um Modul xyz benutzen zu können, muss außerdem ...
 
== Anwendung ==
=== Define ===
 
=== Attribute ===
 
== Anwendungsbeispiele ==
 
== Links ==
 
[[Kategorie:xyz]]
<!-- (Modulkategorie wird automatisch gesetzt) -->
</nowiki></pre>
 
Die Vorlage ''Infobox Modul'' wird derzeit verwendet auf den [[Special:Linkliste/Vorlage:Infobox Modul|hier]] gelisteten Seiten.
 
[[Kategorie:Vorlage]]
 
</noinclude>
</noinclude>

Aktuelle Version vom 19. Februar 2020, 14:55 Uhr

Infobox Modul
Zweck / Funktion
{{{ModPurpose}}}
Allgemein
Typ undefiniert
Details
Dokumentation ModUndef
Modulname {{{ModTechName}}}
Ersteller {{{ModOwner}}}
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!



Dokumentation

Benutzung dieser Vorlage: {{Infobox Modul|...}}

Diese Vorlage dient zur Zusammenfassung von Schlüsseldaten zu einem Modul und sollte auf der Beschreibungsseite des Moduls verwendet werden.

Aufrufparameter

ModPurpose
Kurzbeschreibung der Funktion / des Zwecks dieses Moduls
ModType
Modultyp, ausgehend von der Einteilung in der commandref:
cmd="fhem commands" (FHEM-Befehle)
contrib="Contrib" Inoffizielles Modul, das aus dem Contrib-Unterverzeichnis des FHEM-Repositories geladen werden muss; externer Link auf das Verzeichnis wird automatisch generiert.
d="devices" (Geräte)
h="helper modules" (Hilfs(Erweiterungs-)module)
u="Utilities" (Sammlung von Hilfsfunktionen für bestimmte Einsatzbereiche)
x="experimentell" (Inoffiziell; noch nicht Teil des Standard-FHEM, aber auch nicht im "contrib" Unterverzeichnis bei sourceforge abgelegt; derartige Module sind in der Regel über den zugehörigen Diskussionsfaden im [forum.fhem.de FHEM Forum] zu beziehen).
Abhängig vom gewählten Modultyp wird ein Kategorieeintrag für FHEM Befehl, FHEM Utilities, Gerätemodul, Hilfsmodul, Modul (Contrib) oder Modul (Inoffiziell) erzeugt.
Emblem-question-yellow.svgEntspricht der Seitentitel nicht dem Modulnamen, müssen die folgenden zusätzlichen Maßnahmen ergriffen werden:
  • An den Beginn der Modul-Seite muss die Anweisung {{SEITENTITEL:naMeInRichtigerSchreibweise}} eingefügt werden
  • Der Parameter ModCmdRef=naMeInRichtigerSchreibweise muss für die Infobox Modul spezifiziert werden.
ModCmdRef
optionaler Parameter (für die Bestimmung des Wertes für die Zeile Dokumentation). Falls nicht angegeben, wird aus dem Seitentitel ein Link auf den entsprechenden Abschnitt der commandref generiert. Weicht der Seitentitel von der Bezeichnung des Abschnitts in der commandref ab (z. B., weil der Modulname "eigentlich" mit einem Kleinbuchstaben beginnt), kann hier der Name in der korrekten Schreibweise spezifiziert werden.
Für ModType=x und contrib wird kein Link auf die commandref erzeugt (da der entsprechende Abschnitt noch nicht existieren dürfte), sondern ein schlichter Verweis auf das FHEM Forum. Wenn Parameter ModFTopic spezifiziert ist, wird ein Link auf diesen Forenthread generiert.
Ist ModFTopic für "offizielle" Module spezifiziert, wird zusätzlich der Link auf den entsprechenden Forenthread generiert.
ModFTopic
optionaler Parameter. Forendiskussion zu diesem Modul; numerischer Wert, der zu einem Verweis auf den ersten Beitrag des Diskussionsfadens (Threads, Topics) führt.
Emblem-question-yellow.svgBeispiel für das ModOwner-Feld:
Peter/ph1959de ({{Link2FU|73|Forum}}/[[Benutzer Diskussion:ph1959de|Wiki]])

sieht dann so aus:

Peter/ph1959de (Forum /Wiki)
ModForumArea
Name des Forenbereichs, in dem Supportanfragen zu dem Modul gestellt werden können bzw. sollen. Die Liste der Zuordnung von Modul zu Forenbereich ist in der Liste der Maintainer enthalten. Der Text wird automatisch in einen Link auf den Forenbereich umgesetzt.
ModTechName
Technischer Name des Moduls (also z. B. 01_FHEMWEB.pm; siehe Liste der Maintainer)
ModOwner
Name des Modulerstellers bzw. -betreuers (siehe Liste der Maintainer)

Felder der Infobox

Titelzeile
Im Regelfall Seitenname=Modulname=Titelzeile.
Stimmt der Modulname nicht mit dem Seitentitel überein, muss der Parameter ModCmdRef angegeben sein und wird hier verwendet.
Zweck / Funktion
Dieses Feld wird direkt aus dem Wert des Parameters ModPurpose gefüllt.
Typ
Modultyp, abgeleitet aus dem Parameter ModType.
Dokumentation
Verweis auf die Dokumentation zu diesem Modul; das besteht
  • bei "offiziellen" Modulen aus den automatisch generierten Links auf den entsprechenden Abschnitt der commandref und, optional/zusätzlich, wenn der Parameter ModFTopic angegeben ist, einem Link auf den spezifizierten Forenthread
  • bei "inoffiziellen" oder "contrib" Modulen aus einem Link auf einen Forenthread (sofern ModFTopic angegeben ist) oder dem schlichten Hinweis auf das Forum.
Support (Forum)
Ein Link auf den Forenbereich, in dem Fragen und Fehlerberichte zu diesem Modul eingestellt werden sollen, das jedoch nur, wenn ModForumArea angegeben ist.
Modulname
Der "technische" Name des Moduls, also z.B. 01_FHEMWEB.pm
Ersteller
Der Name (Forum/Wiki/...) des Modulverantwortlichen.

Kopiervorlage

Die folgende (generelle) Schablone wird an den Anfang der Zielseite kopiert und ausgefüllt. Weitere, modultypspezifische Beispiele, sind weiter unten aufgeführt. 

{{Infobox Modul
|ModPurpose=
|ModType=[cmd|contrib|d|h|x]
|ModCmdRef= 
|ModForumArea=
|ModFTopic=
|ModTechName=
|ModOwner=
}}

Weitere kopierfähige Beispiele

Modultyp "cmd", "d" oder "h"

Infobox Modul
Zweck / Funktion
Sinn und Zweck dieses Moduls (ein Satz)
Allgemein
Typ Gerätemodul
Details
Dokumentation Modul EN / Modul DE
Support (Forum) Forenbereich
Modulname 77_Device.pm
Ersteller Modulersteller
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Infobox - mögliche Werte für die Felder bei einem Geräte-(Device-)Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ModCmdRef angegeben werden. 

{{Infobox Modul
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModType=d
|ModForumArea=Forenbereich
|ModTechName=77_Device.pm
|ModOwner=Modulersteller
}}


Modultyp "x" oder "contrib"

ContribModul
Zweck / Funktion
Ein Modul des Typs "contrib"
Allgemein
Typ Contrib
Details
Dokumentation Thema
Support (Forum) Contrib
Modulname 66_Contrib.pm
Ersteller Contrib-Owner
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Infobox - mögliche/empfohlene Werte für die Felder bei einem inoffiziellen Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ModCmdRef angegeben werden. 

{{Infobox Modul
|ModPurpose=Ein Modul des Typs "contrib"
|ModType=contrib
|ModFTopic=12345
|ModCmdRef=ContribModul
|ModForumArea=Contrib
|ModTechName=66_Contrib.pm
|ModOwner=Contrib-Owner
}}

Komplette Liste möglicher Parameter

Die folgende Kopiervorlage enthält alle Schlüsselworte ohne Angabe von Werten: 

{{SEITENTITEL:...}}  <!-- Nur angeben, wenn wirklich erforderlich! -->

{{Infobox Modul
|ModPurpose=...
|ModType=...
|ModCmdRef=...
|ModFTopic=...
|ModForumArea=...
|ModTechName=...
|ModOwner=...
}}

Eine Infobox um die wichtigsten Daten zu einem FHEM-Modul darzustellen.

Vorlagenparameter

ParameterBeschreibungTypStatus
ModulnameModCmdRef

Sofern der Modulname vom Seitennamen abweicht (bspw. Groß-/Kleinschreibung) kann hier der korrekte Modulname angegeben werden, so wie er in der Commandref zu finden ist. Falls nicht angegeben wird der Wiki-Seitentitel als Modulname verwendet

Zeichenfolgeoptional
KurzbeschreibungModPurpose

Eine kurze Beschreibung der Funktion / Zweck des Moduls.

Zeichenfolgeerforderlich
Modul-TypModType

Typ des Moduls (einzelner Wert), ausgehend von der Einteilung in der commandref: ("d" => Gerätemodul, "h" => Hilfsmodul, "cmd" => Befehlsmodul, "u" => Utilities, "contrib" => Inoffizielles Modul im contrib-Verzeichnis, "x" => experimentelles Modul)

Beispiel
d
Unbekannterforderlich
ForumsbeitragModFTopic

Die Topic-ID zu einer Diskussion im Forum um weitere Informationen zu erhalten. Hierbei nur die Topic-ID aus dem Link angeben

Nummeroptional
ForumsbereichModForumArea

Der Name des Forumsbereich, in dem Fragen zu diesem Modul diskutiert werden sollten.

Zeichenfolgeerforderlich
DateinameModTechName

Der vollständige Dateiname des Moduls

Beispiel
01_FHEMWEB.pm
Zeichenfolgeerforderlich
ModulerstellerModOwner

Name des Moulerstellers bzw. -betreuers

Inhaltoptional

Vorschlag für die Struktur/Gliederung einer Modulseite

Eine Seite, die die Vorlage Infobox Modul verwendet, sollte sich an der folgenden Gliederung orientieren (wobei der Schwerpunkt auf Anwendungsbeispiele gelegt werden sollte; Zweck ist es nicht, die commandref zu kopieren oder zu ersetzen): 

{{Infobox Modul
...
}}
[[Modulname]] ist ... und macht ... (allgemeine Beschreibung, etwas mehr, 
als unter "ModPurpose" angegeben)

== Voraussetzungen ==
Um Modul xyz benutzen zu können, muss außerdem ...

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:xyz]] 
<!-- (Modulkategorie wird automatisch gesetzt) -->

Die Vorlage Infobox Modul wird derzeit verwendet auf den hier gelisteten Seiten.


Abgerufen von „http://wiki.fhem.de/w/index.php?title=Vorlage:Infobox_Modul&oldid=32816“