LHlab Wiki

MediaWiki Buy Me a Coffee Integration

Mit Buy Me a Coffee kannst du dein MediaWiki ganz einfach um eine Spenden- oder Unterstützungsfunktion erweitern. Dieser Artikel zeigt, wie du den „☕ Buy Me a Coffee“-Link im MediaWiki platzieren kannst – im MinervaNeue-Skin über den integrierten Donate-Button, als Icon neben dem MediaWiki-Logo im Footer oder als zusätzlichen Link im Copyright-Bereich.

Buy me a coffee

Einführung

Das Hinzufügen eines „Buy Me a Coffee“-Buttons ist eine einfache Möglichkeit, Besucherinnen und Besucher deines Wikis zur Unterstützung einzuladen.  

Ob du dein Wiki als Open-Source-Projekt, Wissenssammlung oder private Dokumentationsplattform betreibst – mit einem kleinen Spendenlink lässt sich deine Arbeit wertschätzen und langfristig finanzieren.

Im Folgenden findest du verschiedene Varianten, wie du den Button oder Link in dein MediaWiki einbauen kannst. Einen Account kannst du unter www.buymeacoffee.com erstellen.

Der mobile Skin „MinervaNeue“ bringt eine eingebaute Spenden-Funktion mit.  

Aktiviere sie in deiner LocalSettings.php: 

$wgMinervaDonateLink = [ 'base' => true ];

Danach legst du zwei Systemnachrichten an:

MediaWiki:Sitesupport-url  
https://buymeacoffee.com/DEINNAME  
MediaWiki:Sitesupport  
☕ Unterstütze dieses Wiki

Nun erscheint der Link automatisch im mobilen Menü des MinervaNeue-Skins.
Optional kannst du zusätzlich den Banner aktivieren: 

$wgMinervaDonateBanner = [ 'base' => true ];

Wenn du im Footer ein eigenes Symbol, z. B. das Buy-Me-a-Coffee-Logo, anzeigen möchtest, ergänze deine LocalSettings.php um:

# Buy Me a Coffee footer icon
$wgFooterIcons['poweredby-bmac'] = [
  'buymeacoffee' => [
  "src" => "$wgResourceBasePath/images/bmc-button.png",
  "url" => "https://buymeacoffee.com/DEINNAME",
  "alt" => "Buy Me a Coffee",
  "height" => "31",
  "width"  => "88",
  ]
];

Das Bild (z. B. 88 × 31 px) lädst du vorher in dein Wiki nach /images/ hoch.  Die Buttons kannst du auf der Webseite herunterladen:

Der Button erscheint dann direkt neben dem „Powered by MediaWiki“-Logo im Footer.

Für einen einfachen Textlink genügt eine Bearbeitung der Systemnachricht MediaWiki:Copyright-footer:

Unterstütze dieses Wiki mit ☕ [https://buymeacoffee.com/DEINNAME Buy Me a Coffee!]

Der Link wird automatisch im unteren Seitenbereich eingeblendet.

4. Variante: Button rechts neben der Suchleiste (Vector 2022)

Erstelle oder bearbeite die Seite MediaWiki:Common.js und füge ganz unten hinzu:

// --- Buy Me a Coffee Button near the search bar (Vector 2022) ---
mw.loader.using('mediawiki.util').then(function () {
  const link = $('<a>', {
    href: 'https://buymeacoffee.com/DEINNAME',
    id: 'bmac-search-btn',
    target: '_blank',
    title: 'Unterstütze dieses Wiki ☕'
  }).append(
    $('<img>', {
      src: mw.config.get('wgServer') + mw.config.get('wgScriptPath') + '/images/bmac-button-88x31.png',
      alt: 'Buy Me a Coffee',
      height: 24
    })
  );

  // In Vector 2022: Target is the search element
  const searchPort = document.querySelector('.vector-header-end');
  if (searchPort) searchPort.appendChild(link[0]);
});

Das fügt rechts neben der Suchleiste dein Button-Bild ein. Du kannst das Icon vorher in dein Wiki hochladen (z. B. /images/bmac-button-88x31.png). Erstelle oder bearbeite die Seite MediaWiki:Common.css und füge hinzu:

/* --- Buy Me a Coffee button beside search bar --- */
#bmac-search-btn img {
  vertical-align: middle;
  margin-left: 12px;
  border-radius: 6px;
  box-shadow: 0 1px 3px rgba(0,0,0,0.2);
  transition: transform 0.2s ease, box-shadow 0.2s ease;
}
#bmac-search-btn img:hover {
  transform: scale(1.05);
  box-shadow: 0 2px 6px rgba(0,0,0,0.3);
}

Das sorgt für einen sauberen, modernen Button-Look — unaufdringlich, aber präsent.

Tipps

  • Den Text kannst du natürlich frei anpassen, z. B. „☕ Kaffee für den Autor“ oder „Projekt unterstützen“.  
  • Falls du Vector 2022 verwendest, kannst du zusätzlich über MediaWiki:Sidebar einen Menüpunkt „Spenden“ hinzufügen.
    * support
** sitesupport-url|☕ Unterstütze LHlab
  • Nach Änderungen: einmal eine Seite mit „?action=purge“ aufrufen, damit Caches aktualisiert werden.

Siehe auch

Abgerufen von „https://lhlab.wiki/index.php?title=MediaWiki_Buy_Me_a_Coffee_Integration&oldid=10222“