Admin: /* MediaWiki:Gadget-vereinform */

2026-07-31T12:01:07Z

MediaWiki:Gadget-vereinform

← Nächstältere Version		Version vom 31. Juli 2026, 14:01 Uhr
Zeile 141:		Zeile 141:


	==MediaWiki:Gadget-vereinform==		==MediaWiki:Gadget-vereinform.js==

	<pre>		<pre>

Admin: /* Technisches */

2026-07-31T12:00:42Z

Technisches

Änderungen zeigen

Admin: /* Was das Gadget macht */

2026-07-31T11:59:27Z

Was das Gadget macht

← Nächstältere Version		Version vom 31. Juli 2026, 13:59 Uhr
Zeile 5:		Zeile 5:
	Es '''speichert nichts und legt keine Seite an'''. Das Formular gibt reinen Wikicode in ein Textfeld aus; man kopiert ihn und fügt ihn selbst auf der gewünschten Seite ein. Dadurch braucht es keine Schreibrechte, kann nichts überschreiben und funktioniert auch auf bereits bestehenden Seiten.		Es '''speichert nichts und legt keine Seite an'''. Das Formular gibt reinen Wikicode in ein Textfeld aus; man kopiert ihn und fügt ihn selbst auf der gewünschten Seite ein. Dadurch braucht es keine Schreibrechte, kann nichts überschreiben und funktioniert auch auf bereits bestehenden Seiten.

	Zusätzlich erzeugt es den passenden Eintrag für die Ortsdatei der Karte und legt ihn als auskommentierten Block mitten in den Wikicode – zum Herauskopieren und anschließenden Löschen.		Zusätzlich erzeugt es den passenden Eintrag für die Ortsdatei der Karte [[WikiMap]] und legt ihn als auskommentierten Block mitten in den Wikicode – zum Herauskopieren und anschließenden Löschen.

	== Voraussetzungen ==		== Voraussetzungen ==

Admin: Die Seite wurde neu angelegt: „== Was das Gadget macht == Das Gadget '''vereinform''' erzeugt das Grundgerüst einer Vereinsseite: Brotkrümel-Navigation, Karteneinbindung, Adress- und Kontaktzeilen samt der Links zu OpenStreetMap, CoMaps und Google Maps. Es '''speichert nichts und legt keine Seite an'''. Das Formular gibt reinen Wikicode in ein Textfeld aus; man kopiert ihn und fügt ihn selbst auf der gewünschten Seite ein. Dadurch braucht es keine Schreibrechte, kann nichts über…“

2026-07-31T11:57:44Z

Die Seite wurde neu angelegt: „== Was das Gadget macht == Das Gadget '''vereinform''' erzeugt das Grundgerüst einer Vereinsseite: Brotkrümel-Navigation, Karteneinbindung, Adress- und Kontaktzeilen samt der Links zu OpenStreetMap, CoMaps und Google Maps. Es '''speichert nichts und legt keine Seite an'''. Das Formular gibt reinen Wikicode in ein Textfeld aus; man kopiert ihn und fügt ihn selbst auf der gewünschten Seite ein. Dadurch braucht es keine Schreibrechte, kann nichts über…“

Neue Seite

== Was das Gadget macht ==

Das Gadget '''vereinform''' erzeugt das Grundgerüst einer Vereinsseite: Brotkrümel-Navigation, Karteneinbindung, Adress- und Kontaktzeilen samt der Links zu OpenStreetMap, CoMaps und Google Maps.

Es '''speichert nichts und legt keine Seite an'''. Das Formular gibt reinen Wikicode in ein Textfeld aus; man kopiert ihn und fügt ihn selbst auf der gewünschten Seite ein. Dadurch braucht es keine Schreibrechte, kann nichts überschreiben und funktioniert auch auf bereits bestehenden Seiten.

Zusätzlich erzeugt es den passenden Eintrag für die Ortsdatei der Karte und legt ihn als auskommentierten Block mitten in den Wikicode – zum Herauskopieren und anschließenden Löschen.

== Voraussetzungen ==

* MediaWiki mit aktivierter '''Extension:Gadgets''' (bei den meisten Installationen Standard).
* Keine weiteren Extensions, keine externen JavaScript-Bibliotheken.
* Das '''WikiMap-Gadget''' samt <code>MediaWiki:WikiMap-Orte.json</code> muss vorhanden sein – sonst erzeugt das Formular zwar den Karten-<code>div</code>, es erscheint aber keine Karte.
* Drei hochgeladene Bilddateien für die Symbole der Kartenlinks:
** <code>Datei:osm.png</code>
** <code>Datei:CoMaps.png</code>
** <code>Datei:GoogleMaps.png</code>
* Auf der Hauptseite sollte der Abschnittsanker existieren, auf den die Navigation zeigt (standardmäßig <code>#Sport</code>).

Fehlen die Bilddateien, funktioniert alles weiter – auf der Seite stehen dann nur rote Dateilinks.

== Installation ==

=== Schritt 1: Gadget-Datei anlegen ===

Den kompletten Code nach <code>MediaWiki:Gadget-vereinform.js</code> kopieren und speichern.

=== Schritt 2: Gadget registrieren ===

In <code>MediaWiki:Gadgets-definition</code> eine Zeile ergänzen:

<pre>
* vereinform[ResourceLoader|default]|vereinform.js
</pre>

<code>default</code> bedeutet: für alle aktiv, auch für nicht angemeldete Benutzer. Das ist hier unbedenklich, weil das Gadget nichts schreibt. Soll es nur angemeldeten Benutzern angeboten werden, <code>default</code> weglassen – dann muss es jeder in seinen Einstellungen selbst aktivieren.

Sind in der Definitionsdatei Abschnitte (Zeilen wie <code>== Werkzeuge ==</code>) vorhanden, gehört die Zeile in einen davon.

=== Schritt 3: Auslöserseite anlegen ===

Eine normale Wiki-Seite mit dem Titel <code>VereinForm</code> anlegen. Das Gadget wird '''ausschließlich''' auf dieser Seite geladen. Optional kann man festlegen, wo genau das Formular erscheint:

<pre>
<div id="verein-form-container"></div>
</pre>

Ohne diesen Ankerpunkt hängt sich das Formular oben in den Seiteninhalt.

=== Schritt 4: Prüfen ===

Seite <code>VereinForm</code> aufrufen und mit Strg+Umschalt+R neu laden (der ResourceLoader hält Gadgets aggressiv im Cache). Das Formular muss sofort sichtbar sein.

== Konfiguration ==

Ganz oben in der Gadget-Datei stehen vier Konstanten. Für eine Übernahme in ein anderes Wiki sind das die einzigen Stellen, die typischerweise angepasst werden:

<pre>
var TRIGGER_PAGE = 'VereinForm'; // Seite, auf der das Formular erscheint
var KATEGORIE = 'Stockschießen'; // Kartenkategorie
var STD_RUBRIK = 'Sport'; // Anker auf der Hauptseite
var STD_OBERSEITE = 'Stockschießen'; // übergeordnete Seite
</pre>

<code>TRIGGER_PAGE</code> muss exakt dem Seitentitel entsprechen, inklusive Groß- und Kleinschreibung; Leerzeichen werden dabei als Unterstriche geschrieben.

<code>KATEGORIE</code> steuert '''zwei''' Dinge gleichzeitig: das Attribut <code>data-filter</code> im Karten-<code>div</code> und das Feld <code>kategorie</code> im erzeugten JSON-Block. Der Wert muss zeichengenau mit einer Kategorie in <code>MediaWiki:WikiMap-Orte.json</code> übereinstimmen – sonst bleibt der Kartenpin unsichtbar.

<code>STD_RUBRIK</code> und <code>STD_OBERSEITE</code> sind nur Vorbelegungen der beiden Navigationsfelder und lassen sich im Formular jederzeit überschreiben. Für eine andere Sparte – etwa Fußball – genügt es also, diese drei Werte zu ändern und das Gadget unter neuem Namen ein zweites Mal anzulegen.

== Bedienung ==

# Seite <code>VereinForm</code> aufrufen.
# Felder ausfüllen. Pflicht sind nur '''Vereinsname''' und '''Koordinaten'''; alles andere ist optional und lässt bei leerem Feld die zugehörige Zeile einfach weg.
# Den Wikicode kopieren (Knopf oder Strg+C) und auf der Vereinsseite einfügen.
# Den auskommentierten JSON-Block aus dem eingefügten Text herausschneiden und in <code>MediaWiki:WikiMap-Orte.json</code> in die Liste <code>orte</code> einfügen. Die beiden Leerzeilen um den Block gleich mit entfernen, sonst bleibt ein Absatzumbruch mitten im Adressblock stehen.

Der '''Vereinsname''' wird an drei Stellen verwendet und muss überall identisch sein: als Seitentitel, als <code>data-aktiv-ort</code> in der Karte und als <code>id</code> in der Ortsdatei.

Bei den drei Kartenlink-Feldern gilt: leer lassen heißt, der Link wird aus den Koordinaten erzeugt. Trägt man etwas ein, wird genau das übernommen – gedacht für gekürzte Links direkt aus den Apps.

== Aufbau der erzeugten Seite ==

<pre>
[[Hauptseite]] > [[Hauptseite#Sport|Sport]] > [[Stockschießen]] <br>
<br>
<div class="wikimap" data-aktiv-ort="Vereinsname" data-filter="Stockschießen"></div>

(auskommentierter Block für WikiMap-Orte.json)

📍 Adresse<br><br>
[[file:osm.png|24px|link=]] OpenStreetMap-Link<br><br>
🧭 Breitengrad, Längengrad<br><br>
[[file:CoMaps.png|24px|link=]] CoMaps-Link<br><br>
[[file:GoogleMaps.png|24px|link=]] Google-Maps-Link<br><br>
📞 Telefonnummer<br><br>
📧 E-Mail-Adresse<br><br>
🌐 Website
</pre>

Die eigentlichen Inhaltsabschnitte – Geschichte, Anlage, Mannschaften, Fotos – werden bewusst '''nicht''' erzeugt und von Hand ergänzt.

== Koordinatenformate ==

Das Eingabefeld erkennt die gängigen Schreibweisen, egal aus welcher App kopiert:

* Dezimalgrad: <code>47.69694, 16.00583</code> oder mit Leerzeichen getrennt
* Dezimalgrad mit deutschem Komma: <code>47,69694 16,00583</code>
* mit Himmelsrichtung: <code>47.69694N 16.00583E</code>
* Grad/Minuten: <code>47°41.816'N 16°00.350'E</code>
* Grad/Minuten/Sekunden: <code>47°41'49.0"N 16°00'21.0"E</code>

Negative Werte sowie <code>S</code> und <code>W</code> werden korrekt als Süd beziehungsweise West gewertet, <code>O</code> gilt wie <code>E</code> als Ost. Wird eine Eingabe nicht erkannt, erscheint über dem Ausgabefeld ein Warnhinweis und die Auto-Links unterbleiben.

Die Ausgabe wird auf sieben Nachkommastellen gerundet – das entspricht etwa einem Zentimeter und ist für jede Kartenanwendung mehr als genau genug.

== Fehlersuche ==

; Formular erscheint nicht
: Fast immer der Cache – Strg+Umschalt+R. Sonst prüfen, ob der Seitentitel exakt <code>TRIGGER_PAGE</code> entspricht und ob die Zeile in <code>MediaWiki:Gadgets-definition</code> im richtigen Format steht (Dateiname ohne das Präfix <code>Gadget-</code>).

; Karte bleibt leer
: Der Ort steht noch nicht in <code>MediaWiki:WikiMap-Orte.json</code>, oder <code>id</code> und <code>data-aktiv-ort</code> weichen voneinander ab – schon ein zusätzliches Leerzeichen genügt.

; Pin fehlt, Karte ist aber da
: Die Kategorie im JSON-Eintrag stimmt nicht mit <code>data-filter</code> überein. Beide Werte kommen aus derselben Konstante, insofern liegt der Fehler meist in einem von Hand nachbearbeiteten JSON-Eintrag.

; Alles steht in einer Zeile
: Die <code><br></code> wurden beim Kopieren verschluckt. Wikitext fügt bei einfachen Zeilenumbrüchen von sich aus keinen Umbruch ein – die Tags sind zwingend nötig.

; JSON-Block wird auf der Seite angezeigt
: Der Kommentar ist unvollständig kopiert worden; es fehlt <code></code>.

== Technisches ==

Reines JavaScript ohne Abhängigkeiten, kein OOUI, kein jQuery, kein <code>mw.Api</code>. Das Gadget liest lediglich <code>wgPageName</code> aus, um zu entscheiden, ob es sich überhaupt einhängt. Auf allen anderen Seiten bricht es sofort ab und kostet damit praktisch nichts.

Das Stylesheet wird vom Skript selbst eingefügt; eine eigene <code>.css</code>-Seite ist nicht erforderlich.

Der Kopieren-Knopf nutzt die Clipboard-API mit <code>document.execCommand</code> als Rückfallebene für ältere Browser. Beides setzt eine gesicherte Verbindung voraus – über <code>http://</code> ohne TLS bleibt das Textfeld nur markiert und muss von Hand kopiert werden.

Vereinform - Versionsgeschichte

Admin: /* MediaWiki:Gadget-vereinform */

Admin: /* Technisches */

Admin: /* Was das Gadget macht */