Files
karatewiki/extensions-custom/KarateMedia/src/KarateMediaHooks.php
T
2026-10-25 08:55:52 +01:00

749 lines
26 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
namespace MediaWiki\Extension\KarateMedia;
use MediaWiki\Content\TextContent;
use MediaWiki\Html\Html;
use MediaWiki\MediaWikiServices;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Title\Title;
class KarateMediaHooks {
public const DASHBOARD_CONFIG_PAGE = 'Karate:Dashboard';
/**
* Falls BeforeInitialize erreicht wird, unangemeldete Besucher ohne Leserecht weiterleiten.
*/
public static function onBeforeInitialize( $title, $unused, $output, $user, $request, $mediaWiki ) {
if ( !$title || $user->isRegistered() || $title->isSpecial( 'Userlogin' ) ) {
return true;
}
$permManager = MediaWikiServices::getInstance()->getPermissionManager();
if ( !$permManager->userCan( 'read', $user, $title ) ) {
$loginPage = SpecialPage::getTitleFor( 'Userlogin' );
$output->redirect( $loginPage->getLocalURL( [ 'returnto' => $title->getPrefixedDBkey() ] ) );
return false;
}
return true;
}
/**
* Registriert das <html5media>-Tag fuer Abwaertskompatibilitaet (z.B. in der Vorschau).
*/
public static function onParserFirstCallInit( $parser ): bool {
$parser->setHook( 'html5media', [ self::class, 'renderHtml5MediaTag' ] );
return true;
}
/**
* Wandelt <html5media>-Tags beim Speichern einer Wiki-Seite automatisch
* in den offiziellen MediaWiki-Standard [[Datei:...|...px]] um.
*/
public static function onParserPreSaveTransformComplete( $parser, string &$text ): void {
if ( stripos( $text, '<html5media' ) === false ) {
return;
}
$converted = preg_replace_callback(
'/<html5media([^>]*)>(.*?)<\/html5media>/is',
static function ( array $m ): string {
$attrString = $m[1];
$inner = trim( $m[2] );
$cleanFile = trim( preg_replace( '/^(file|datei|image|bild)\s*:\s*/i', '', $inner ) );
if ( $cleanFile === '' ) {
return $m[0];
}
$width = null;
$height = null;
if ( preg_match( '/\bwidth\s*=\s*["\']?(\d+)["\']?/i', $attrString, $wm ) ) {
$width = (int)$wm[1];
}
if ( preg_match( '/\bheight\s*=\s*["\']?(\d+)["\']?/i', $attrString, $hm ) ) {
$height = (int)$hm[1];
}
$sizeParam = '';
if ( $width && $height ) {
$sizeParam = "|{$width}x{$height}px";
} elseif ( $width ) {
$sizeParam = "|{$width}px";
} elseif ( $height ) {
$calcWidth = (int)round( $height * 16 / 9 );
$sizeParam = "|{$calcWidth}x{$height}px";
}
return "[[Datei:{$cleanFile}{$sizeParam}]]";
},
$text
);
if ( $converted !== null ) {
$text = $converted;
}
}
/**
* MediaWiki 1.45+ hat "Spezialseiten" (Special:SpecialPages) und "Datei hochladen" (Special:Upload)
* aus dem Standard-TOOLBOX-Block ("Werkzeuge") entfernt. Da das Karate-Wiki eine eigene
* MediaWiki:Sidebar nutzt, fuegen wir beide Links hier wieder fest unter "Werkzeuge" ein.
*/
public static function onSidebarBeforeOutput( $skin, &$sidebar ): void {
if ( !$skin->getUser()->isRegistered() ) {
return;
}
if ( !isset( $sidebar['TOOLBOX'] ) || !is_array( $sidebar['TOOLBOX'] ) ) {
$sidebar['TOOLBOX'] = [];
}
$existingIds = [];
foreach ( $sidebar['TOOLBOX'] as $key => $item ) {
$existingIds[$key] = true;
if ( isset( $item['id'] ) ) {
$existingIds[$item['id']] = true;
}
}
if ( !isset( $existingIds['upload'] ) && !isset( $existingIds['t-upload'] ) ) {
$sidebar['TOOLBOX']['upload'] = [
'id' => 't-upload',
'text' => $skin->msg( 'upload' )->text(),
'href' => SpecialPage::getTitleFor( 'Upload' )->getLocalURL(),
];
}
if ( !isset( $existingIds['specialpages'] ) && !isset( $existingIds['t-specialpages'] ) ) {
$sidebar['TOOLBOX']['specialpages'] = [
'id' => 't-specialpages',
'text' => $skin->msg( 'specialpages' )->text(),
'href' => SpecialPage::getTitleFor( 'Specialpages' )->getLocalURL(),
];
}
}
/**
* Laedt CSS und JS fuer die Video-Steuerung, das moderne Dojo-Theme, das Hauptseiten-Dashboard
* sowie die gestaltete Vereins-Anmeldeseite.
*/
public static function onBeforePageDisplay( $out, $skin ): void {
$out->addModules( [ 'ext.karateMedia' ] );
// 1. Skin als responsive kennzeichnen, damit MediaWiki den Standard-Viewport (width=device-width)
// akzeptiert und das veraltete Desktop-width=1120 unterlaesst:
try {
$skinRefl = new \ReflectionClass( $skin );
if ( $skinRefl->hasProperty( 'options' ) ) {
$optProp = $skinRefl->getProperty( 'options' );
$optProp->setAccessible( true );
$opts = $optProp->getValue( $skin ) ?: [];
$opts['responsive'] = true;
$optProp->setValue( $skin, $opts );
}
} catch ( \Throwable $e ) {
$bindSkin = \Closure::bind( function () {
$this->options['responsive'] = true;
}, $skin, $skin );
if ( $bindSkin ) {
$bindSkin();
}
}
// 2. Etwaige alte oder doppelte Viewport-Tags (insbesondere width=1120) aus mMetatags entfernen
try {
$outRefl = new \ReflectionClass( $out );
if ( $outRefl->hasProperty( 'mMetatags' ) ) {
$metaProp = $outRefl->getProperty( 'mMetatags' );
$metaProp->setAccessible( true );
$tags = $metaProp->getValue( $out ) ?: [];
$cleaned = [];
foreach ( $tags as $t ) {
if ( isset( $t[0] ) && strtolower( $t[0] ) === 'viewport' ) {
continue;
}
$cleaned[] = $t;
}
$metaProp->setValue( $out, $cleaned );
}
} catch ( \Throwable $e ) {
$bindOut = \Closure::bind( function () {
$this->mMetatags = array_values( array_filter(
$this->mMetatags,
static fn( $t ) => !( isset( $t[0] ) && strtolower( $t[0] ) === 'viewport' )
) );
}, $out, $out );
if ( $bindOut ) {
$bindOut();
}
}
// 3. Garantierter, fluessiger mobiler Viewport fuer alle Smartphones & Tablets
$out->addMeta( 'viewport', 'width=device-width, initial-scale=1.0, maximum-scale=5.0' );
// 4. PWA Web App Manifest, App-Icons & Mobile-Fullscreen-Metatags
$pwaHead = implode( "\n", [
'<link rel="manifest" href="/manifest.webmanifest">',
'<link rel="icon" type="image/svg+xml" href="/resources/assets/icon.svg">',
'<link rel="apple-touch-icon" href="/resources/assets/icon.svg">',
'<meta name="theme-color" content="#1a1a1a">',
'<meta name="apple-mobile-web-app-capable" content="yes">',
'<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">',
'<meta name="apple-mobile-web-app-title" content="Karate-Wiki">',
'<meta name="mobile-web-app-capable" content="yes">'
] );
$out->addHeadItem( 'karate-pwa-meta', $pwaHead );
// 5. Client-seitige Absicherung: Falls die Skin nachtraeglich noch width=1120 einfuegt,
// wird dies sofort beim Head-Parsing entfernt, bevor der Browser skaliert:
$inlineGuard = '<script>(function(){' .
'var metas=document.querySelectorAll(\'meta[name="viewport"]\');' .
'if(metas.length>1){' .
'for(var i=0;i<metas.length;i++){' .
'if((metas[i].getAttribute(\'content\')||\'\').indexOf(\'1120\')!==-1){' .
'metas[i].remove();' .
'}' .
'}' .
'}' .
'})();</script>';
$out->addHeadItem( 'karate-viewport-guard', $inlineGuard );
$title = $out->getTitle();
$user = $out->getUser();
// MediaWiki setzt bei fehlendem Leserecht für Gäste intern Special:Badtitle ("Anmeldung erforderlich").
// Wir leiten in diesem Fall sofort per HTTP 302 (und JS-Fallback) auf Spezial:Anmelden weiter:
if ( $title && !$user->isRegistered() && $title->isSpecial( 'Badtitle' ) ) {
$loginPage = SpecialPage::getTitleFor( 'Userlogin' );
$requestedTitle = $out->getRequest()->getVal( 'title', 'Hauptseite' );
$loginUrl = $loginPage->getLocalURL( [ 'returnto' => $requestedTitle ] );
$out->getRequest()->response()->header( 'Location: ' . $loginUrl, true, 302 );
$out->addHeadItem(
'karate-login-redirect',
Html::rawElement( 'script', [], 'window.location.replace(' . json_encode( $loginUrl ) . ');' )
);
return;
}
if ( $title && $title->isSpecial( 'Userlogin' ) ) {
global $wgKarateLoginTitle, $wgKarateLoginSubtitle, $wgKarateLoginNotice, $wgKarateAccessRequestUrl;
$loginTitle = $wgKarateLoginTitle ?? 'Goju-Kai Dojo Heilbronn e.V.';
$loginSubtitle = $wgKarateLoginSubtitle ?? 'Internes Vereins-Wiki & Technik-Videothek';
$loginNotice = $wgKarateLoginNotice ?? (
'Willkommen im Trainings- und Nachschlagewerk unseres Karate-Vereins! ' .
'Hier findest du alle Kata-, Bunkai- und Kihon-Lehrvideos, Prüfungsordnungen sowie unser Dojo-Wissen. ' .
'Der Zugriff ist geschützt und ausschließlich für aktive Vereinsmitglieder freigeschaltet.'
);
$accessUrl = $wgKarateAccessRequestUrl ?? 'https://shop.karate.hn/produkt/zugang-zu-vereinseigenem-karatewiki-20';
$loginLogoUrl = '/resources/assets/logo-light.svg';
$headerCard = Html::rawElement(
'div',
[ 'class' => 'karate-login-hero' ],
Html::rawElement(
'div',
[ 'class' => 'karate-login-brand' ],
Html::element( 'img', [
'src' => $loginLogoUrl,
'alt' => $loginTitle,
'class' => 'karate-login-logo',
] ) .
Html::rawElement(
'div',
[ 'class' => 'karate-login-headings' ],
Html::element( 'h2', [ 'class' => 'karate-login-title' ], $loginTitle ) .
Html::element( 'p', [ 'class' => 'karate-login-subtitle' ], $loginSubtitle )
)
) .
Html::rawElement(
'div',
[ 'class' => 'karate-login-notice' ],
Html::element( 'p', [], $loginNotice ) .
Html::rawElement(
'p',
[ 'class' => 'karate-login-contact' ],
'Vereinsmitglieder ohne Zugangsdaten können diese ' .
Html::element( 'a', [
'href' => $accessUrl,
'target' => '_blank',
'rel' => 'noopener',
], 'hier' ) .
' beantragen.'
)
)
);
$footerLinks = Html::rawElement(
'div',
[ 'class' => 'karate-login-footer-links' ],
Html::element( 'a', [ 'href' => '/index.php?title=Karate:Impressum' ], 'Impressum' ) .
Html::element( 'span', [ 'class' => 'karate-login-sep' ], '·' ) .
Html::element( 'a', [ 'href' => '/index.php?title=Karate:Datenschutz' ], 'Datenschutz' ) .
Html::element( 'span', [ 'class' => 'karate-login-sep' ], '·' ) .
Html::element( 'a', [
'href' => $accessUrl,
'target' => '_blank',
'rel' => 'noopener',
], 'Zugang beantragen' )
);
$out->prependHTML( $headerCard );
$out->addHTML( $footerLinks );
return;
}
// Visuelles Dojo-Dashboard auf der Hauptseite (im Lese-Modus)
$action = $out->getRequest()->getVal( 'action', 'view' );
if ( $title && $user->isRegistered() && $action === 'view' ) {
if ( $title->isMainPage() ) {
$out->prependHTML( self::buildMainPageDashboard() );
} elseif ( $title->getPrefixedText() === self::DASHBOARD_CONFIG_PAGE ) {
$backBanner = Html::rawElement(
'div',
[ 'class' => 'kd-config-preview-notice' ],
Html::rawElement(
'span',
[],
'<strong>Live-Vorschau des Dashboards:</strong> Unten siehst du den Quelltext dieser Seite. ' .
'Klicke oben auf <em>„Bearbeiten“</em>, um Gürtel-Links oder Kacheln anzupassen.'
) .
Html::element(
'a',
[ 'href' => self::pageUrl( 'Hauptseite' ), 'class' => 'kd-edit-dashboard-btn' ],
'← Zurück zur Hauptseite'
)
);
$out->prependHTML( $backBanner . self::buildMainPageDashboard() );
}
}
}
/**
* Standard-Wikitext fuer die editierbare Konfigurationsseite "Karate:Dashboard".
*/
public static function getDefaultDashboardWikitext(): string {
return <<<'WIKITEXT'
<!--
=============================================================================
KONFIGURATION DES DOJO-DASHBOARDS AUF DER HAUPTSEITE
=============================================================================
Du kannst diese Seite ganz normal über "Bearbeiten" anpassen!
1. Abschnitt "== Gürtel ==":
Format: * Kyu-Anzeige | Gürtelname | Ziel-Seite im Wiki | Farb-Klasse
Verfügbare Farb-Klassen:
- belt-9kyu (Weiß-Gelb)
- belt-8kyu (Gelb)
- belt-7kyu (Orange)
- belt-6kyu (Grün)
- belt-5kyu (Blau)
- belt-4kyu (Blau)
- belt-3kyu (Braun)
- belt-2kyu (Braun)
- belt-1kyu (Braun)
- belt-dan (Schwarz)
2. Abschnitte "== Kachel: ... ==":
Überschrift: == Kachel: BADGE | Titel der Kachel | Kurzbeschreibung | Darstellungsart ==
Darstellungsart: "list" (normale Linkliste) oder "pills" (kompakte Kata-Buttons)
Einträge darunter: * Ziel-Seite im Wiki | Angezeigter Text
=============================================================================
-->
== Gürtel ==
* 9. Kyu | Weiß-Gelb | IGKR Prüfungsanforderungen 9. Kyu | belt-9kyu
* 8. Kyu | Gelbgurt | IGKR Prüfungsanforderungen 8. Kyu | belt-8kyu
* 7. Kyu | Orangegurt | IGKR Prüfungsanforderungen 7. Kyu | belt-7kyu
* 6. Kyu | Grüngurt | IGKR Prüfungsanforderungen 6. Kyu | belt-6kyu
* 5. Kyu | Blaugurt I | IGKR Prüfungsanforderungen 5. Kyu | belt-5kyu
* 4. Kyu | Blaugurt II | IGKR Prüfungsanforderungen 4. Kyu | belt-4kyu
* 3. Kyu | Braungurt I | IGKR Prüfungsanforderungen 3. Kyu | belt-3kyu
* 2. Kyu | Braungurt II | IGKR Prüfungsanforderungen 2. Kyu | belt-2kyu
* 1. Kyu | Braungurt III | IGKR Prüfungsanforderungen 1. Kyu | belt-1kyu
== Kachel: EINSTEIGER | Neu im Dojo? Hier starten! | Die wichtigsten Grundlagen für deine ersten Trainingswochen im Goju-Kai Dojo. | list ==
* Obi binden | Gürtel (Obi) richtig binden
* Dojo Rei | Begrüßung & Etikette im Dojo
* Dojokun | Dojokun – Unsere Verhaltensregeln
* Karate Wörterbuch | Karate-Wörterbuch (Japanisch – Deutsch)
* Körperwaffen | Körperwaffen im Goju-Ryu
== Kachel: FORMEN (KATA) | Kata-Videothek | Alle Schüler- und Meister-Katas mit Lehrvideos und Zeitlupen-Steuerung. | pills ==
* Goju-Ryu_Kata | Alle Katas
* Taikyoku Jodan | Taikyoku Jodan
* Taikyoku Chudan | Taikyoku Chudan
* Taikyoku Gedan | Taikyoku Gedan
* Gekisai Dai Ichi | Gekisai Dai Ichi
* Gekisai Dai Ni | Gekisai Dai Ni
* Saifa | Saifa
* Seienchin | Seienchin
* Sanseru | Sanseru
* Seisan | Seisan
* Seipai | Seipai
* Sanchin | Sanchin
* Tensho | Tensho
== Kachel: GRUNDSCHULE | Kihon & Grundtechniken | Stände, Abwehrblöcke, Fauststöße, Fußtritte und Würfe Schritt für Schritt erklärt. | list ==
* Dachi-Waza | Dachi-Waza – Stellungen & Stände
* Uke-Waza | Uke-Waza – Abwehr- & Blocktechniken
* Zuki-Waza | Zuki-Waza – Fauststoßtechniken
* Keri-Waza | Keri-Waza – Fuß- & Tritttechniken
* Uchi-Waza | Uchi-Waza – Schlagtechniken
* Nage-Waza | Nage-Waza – Wurftechniken & Feger
* Kihon-Ido | Kihon-Ido – Grundschule in Bewegung
== Kachel: PARTNER & PRAXIS | Kumite & Selbstverteidigung | Partnerformen, Bunkai-Anwendungen, Hebeltechniken und realistische Abwehr. | list ==
* Kumite | Kumite – Übersicht & Formen
* Yakusoku-Kumite | Yakusoku-Kumite (abgesprochener Kampf)
* Sedeho Kumite | Sedeho Kumite (Zeitlupen-Kumite)
* Selbstverteidigung | Selbstverteidigung (SV-Videos)
* Hebeltechniken | Hebeltechniken & Fixierungen
* Kakie | Kakie – Klebende Hände
== Kachel: ATHLETIK & SPIELE | Fitness, Dehnung & Kinder | Übungen für zu Hause und fürs Dojo: Beweglichkeit, Kraft, Reaktion und Koordination. | list ==
* Dehnung - Koordination - Lockern | Dehnung, Koordination & Lockern (34 Videos)
* Muskelaufbau | Muskelaufbau & Kräftigung
* Schnelligkeit und Reaktionzeit | Schnelligkeit, Agilität & Reaktionszeit
* Partnerübungen mit Pratze | Partnerübungen mit und ohne Pratze
* 5 Tibeter | Die 5 Tibeter & Energieübungen
* Kindertraining | Kindertraining & Karatespiele
== Kachel: DOJO & VIDEOS | Aufzeichnungen & Hintergrund | Mitschnitte aus dem Training, Physik der Karate-Techniken und Geschichte. | list ==
* Letzte Trainings | Video-Mitschnitte der letzten Trainings
* Training beim Sensei | Training beim Sensei
* Technikabläufe physikalisch erkärt | Technikabläufe physikalisch erklärt
* Prüfungsordnung des IGKR | Prüfungsordnung (IGKR & DKV)
* Geschichte des Karate | Geschichte des Goju-Ryu Karate
WIKITEXT;
}
/**
* Liest den Wikitext von "Karate:Dashboard" aus der Datenbank (oder nutzt den Standard-Fallback)
* und parst daraus die Gürtel-Liste und Themen-Kacheln.
*/
private static function loadDashboardConfig(): array {
$rawText = null;
$configTitle = Title::newFromText( self::DASHBOARD_CONFIG_PAGE );
if ( $configTitle && $configTitle->exists() ) {
$rev = MediaWikiServices::getInstance()->getRevisionLookup()->getRevisionByTitle( $configTitle );
if ( $rev ) {
$content = $rev->getContent( SlotRecord::MAIN );
if ( $content instanceof TextContent ) {
$rawText = $content->getText();
}
}
}
if ( $rawText === null || trim( $rawText ) === '' ) {
$rawText = self::getDefaultDashboardWikitext();
}
// Entferne HTML-Kommentare
$cleanText = preg_replace( '/<!--.*?-->/s', '', $rawText );
$lines = preg_split( '/\r?\n/', $cleanText );
$belts = [];
$cards = [];
$currentSection = '';
$currentCard = null;
foreach ( $lines as $line ) {
$line = trim( $line );
if ( $line === '' ) {
continue;
}
if ( preg_match( '/^==+\s*Gürtel\s*==+$/iu', $line ) ) {
if ( $currentCard !== null ) {
$cards[] = $currentCard;
$currentCard = null;
}
$currentSection = 'belts';
continue;
}
if ( preg_match( '/^==+\s*Kachel\s*:\s*(.+?)\s*==+$/iu', $line, $m ) ) {
if ( $currentCard !== null ) {
$cards[] = $currentCard;
}
$parts = array_map( 'trim', explode( '|', $m[1] ) );
$style = strtolower( $parts[3] ?? 'list' );
$currentCard = [
'badge' => $parts[0] ?? 'DOJO',
'title' => $parts[1] ?? 'Thema',
'desc' => $parts[2] ?? '',
'style' => $style === 'pills' ? 'pills' : 'list',
'items' => [],
];
$currentSection = 'card';
continue;
}
if ( strpos( $line, '*' ) === 0 ) {
$itemText = trim( ltrim( $line, '*' ) );
$parts = array_map( 'trim', explode( '|', $itemText ) );
if ( $currentSection === 'belts' && count( $parts ) >= 3 ) {
$targetPage = trim( $parts[2], '[] ' );
$belts[] = [
'kyu' => $parts[0],
'name' => $parts[1],
'page' => $targetPage,
'class' => $parts[3] ?? self::guessBeltClass( $parts[0] ),
];
} elseif ( $currentSection === 'card' && $currentCard !== null && count( $parts ) >= 1 ) {
$targetPage = trim( $parts[0], '[] ' );
$label = $parts[1] ?? $targetPage;
if ( $targetPage !== '' ) {
$currentCard['items'][] = [ $targetPage, $label ];
}
}
}
}
if ( $currentCard !== null ) {
$cards[] = $currentCard;
}
return [
'belts' => $belts,
'cards' => $cards,
];
}
private static function guessBeltClass( string $kyuText ): string {
for ( $i = 1; $i <= 9; $i++ ) {
if ( strpos( $kyuText, (string)$i ) !== false ) {
return "belt-{$i}kyu";
}
}
return 'belt-dan';
}
private static function pageUrl( string $pageName, array $query = [] ): string {
$t = Title::newFromText( $pageName );
if ( $t ) {
return $t->getLocalURL( $query );
}
return '/index.php?title=' . rawurlencode( $pageName );
}
private static function buildMainPageDashboard(): string {
$config = self::loadDashboardConfig();
$belts = $config['belts'];
$cards = $config['cards'];
$beltHtml = '';
foreach ( $belts as $b ) {
$beltHtml .= Html::rawElement(
'a',
[
'href' => self::pageUrl( $b['page'] ),
'class' => 'kd-belt-card ' . $b['class'],
],
Html::element( 'span', [ 'class' => 'kd-belt-stripe' ], '' ) .
Html::rawElement(
'span',
[ 'class' => 'kd-belt-info' ],
Html::element( 'strong', [ 'class' => 'kd-belt-kyu' ], $b['kyu'] ) .
Html::element( 'span', [ 'class' => 'kd-belt-name' ], $b['name'] )
)
);
}
$cardsHtml = '';
foreach ( $cards as $idx => $c ) {
$accentClass = ( $idx % 2 === 0 ) ? 'kd-card-red' : 'kd-card-dark';
$bodyHtml = '';
if ( $c['style'] === 'pills' ) {
$pills = '';
foreach ( $c['items'] as $pIdx => $pair ) {
$pillClass = $pIdx === 0 ? 'kd-kata-pill kd-kata-pill-all' : 'kd-kata-pill';
$pills .= Html::element(
'a',
[ 'href' => self::pageUrl( $pair[0] ), 'class' => $pillClass ],
$pair[1]
);
}
$bodyHtml = Html::rawElement( 'div', [ 'class' => 'kd-kata-grid' ], $pills );
} else {
$li = '';
foreach ( $c['items'] as $pair ) {
$li .= Html::rawElement(
'li',
[],
Html::element( 'a', [ 'href' => self::pageUrl( $pair[0] ) ], $pair[1] )
);
}
$bodyHtml = Html::rawElement( 'ul', [ 'class' => 'kd-card-list' ], $li );
}
$cardsHtml .= Html::rawElement(
'div',
[ 'class' => 'kd-topic-card ' . $accentClass ],
Html::element( 'span', [ 'class' => 'kd-card-badge' ], $c['badge'] ) .
Html::element( 'h3', [ 'class' => 'kd-card-title' ], $c['title'] ) .
Html::element( 'p', [ 'class' => 'kd-card-desc' ], $c['desc'] ) .
$bodyHtml
);
}
$editDashboardUrl = self::pageUrl( self::DASHBOARD_CONFIG_PAGE, [ 'action' => 'edit' ] );
return Html::rawElement(
'div',
[ 'class' => 'kd-dashboard' ],
// 1. Hero-Banner mit Schnellsuche & Bearbeiten-Link
Html::rawElement(
'div',
[ 'class' => 'kd-hero' ],
Html::rawElement(
'div',
[ 'class' => 'kd-hero-top-row' ],
Html::element( 'span', [ 'class' => 'kd-hero-kicker' ], 'GOJU-KAI DOJO HEILBRONN E.V.' ) .
Html::element(
'a',
[
'href' => $editDashboardUrl,
'class' => 'kd-edit-dashboard-btn',
'title' => 'Gürtel-Links und Dashboard-Kacheln im Wiki-Editor anpassen',
],
'✎ Dashboard bearbeiten'
)
) .
Html::rawElement(
'div',
[ 'class' => 'kd-hero-content' ],
Html::element( 'h2', [ 'class' => 'kd-hero-title' ], 'Dojo-Wissen & Technik-Videothek' ) .
Html::element(
'p',
[ 'class' => 'kd-hero-subtitle' ],
'Wähle unten deinen nächsten Gürtelgrad (Kyu), starte mit dem Einsteiger-Guide oder suche direkt nach einer Kata oder Technik:'
) .
Html::rawElement(
'form',
[ 'action' => '/index.php', 'method' => 'get', 'class' => 'kd-hero-search' ],
Html::element( 'input', [ 'type' => 'hidden', 'name' => 'title', 'value' => 'Spezial:Suche' ] ) .
Html::element( 'input', [
'type' => 'search',
'name' => 'search',
'placeholder' => 'Technik, Kata oder Begriff suchen (z. B. Seienchin, Mawashi-Geri, Dojokun) …',
'class' => 'kd-hero-search-input',
] ) .
Html::element( 'button', [ 'type' => 'submit', 'class' => 'kd-hero-search-btn' ], 'Suchen' )
)
)
) .
// 2. Gürtel-Wegweiser (Kyu-Prüfungsanforderungen)
Html::rawElement(
'div',
[ 'class' => 'kd-belt-section' ],
Html::rawElement(
'div',
[ 'class' => 'kd-section-header' ],
Html::element( 'h3', [ 'class' => 'kd-section-title' ], 'Dein Weg zum nächsten Gürtel – Prüfungsprogramm (IGKR)' ) .
Html::rawElement(
'div',
[ 'class' => 'kd-section-links' ],
Html::element( 'a', [ 'href' => self::pageUrl( 'Prüfungsordnung des IGKR' ) ], 'IGKR-Ordnung' ) .
' · ' .
Html::element( 'a', [ 'href' => self::pageUrl( 'Prüfungsordnung des DKV' ) ], 'DKV-Ordnung' ) .
' · ' .
Html::element( 'a', [ 'href' => $editDashboardUrl ], '✎ Gürtel-Links anpassen' )
)
) .
Html::rawElement( 'div', [ 'class' => 'kd-belt-grid' ], $beltHtml )
) .
// 3. Themen-Kacheln
Html::rawElement( 'div', [ 'class' => 'kd-cards-grid' ], $cardsHtml ) .
// 4. Hinweis-Trenner zum klassischen Nachschlagewerk darunter
Html::rawElement(
'div',
[ 'class' => 'kd-classic-divider' ],
Html::element( 'span', [], 'Vollständiges Inhaltsverzeichnis & Hintergrundwissen' )
)
);
}
/**
* Rendert <html5media height="200" width="300">File:Beispiel.mp4</html5media>
*/
public static function renderHtml5MediaTag( ?string $input, array $args, $parser, $frame ): string {
if ( $input === null || trim( $input ) === '' ) {
return Html::element( 'span', [ 'class' => 'error' ], 'KarateMedia: Keine Mediendatei angegeben.' );
}
$rawTarget = trim( $input );
$cleanFileName = preg_replace( '/^(file|datei|image|bild)\s*:\s*/i', '', $rawTarget );
$services = MediaWikiServices::getInstance();
$repoGroup = $services->getRepoGroup();
$title = Title::makeTitleSafe( NS_FILE, $cleanFileName );
$file = $title ? $repoGroup->findFile( $title ) : false;
if ( !$file || !$file->exists() ) {
return Html::element(
'span',
[ 'class' => 'error karate-media-missing' ],
'Video nicht gefunden: ' . $cleanFileName
);
}
$url = $file->getUrl();
$ext = strtolower( pathinfo( $file->getName(), PATHINFO_EXTENSION ) );
$attrs = [
'src' => $url,
'controls' => true,
'preload' => 'metadata',
'playsinline' => true,
'class' => 'karate-video-player',
];
if ( isset( $args['width'] ) && is_numeric( $args['width'] ) ) {
$attrs['width'] = max( 280, (int)$args['width'] );
}
if ( isset( $args['height'] ) && is_numeric( $args['height'] ) ) {
$attrs['height'] = max( 158, (int)$args['height'] );
}
if ( in_array( $ext, [ 'mp3', 'ogg' ], true ) && strpos( $file->getMimeType(), 'audio/' ) === 0 ) {
$attrs['class'] = 'karate-audio-player';
return Html::rawElement( 'div', [ 'class' => 'karate-media-wrapper' ],
Html::element( 'audio', $attrs )
);
}
return self::buildVideoHtml( $attrs );
}
/**
* Erzeugt das HTML fuer den Videoplayer inklusive Karate-Zeitlupen-Leiste.
*/
public static function buildVideoHtml( array $videoAttrs ): string {
$videoTag = Html::element( 'video', $videoAttrs );
$controls = Html::rawElement(
'div',
[ 'class' => 'karate-video-controls', 'title' => 'Abspielgeschwindigkeit fuer Kata/Bunkai-Studium' ],
Html::element( 'span', [ 'class' => 'km-controls-label' ], 'Tempo:' ) .
Html::element( 'button', [ 'type' => 'button', 'class' => 'km-speed-btn active', 'data-speed' => '1' ], '1x' ) .
Html::element( 'button', [ 'type' => 'button', 'class' => 'km-speed-btn', 'data-speed' => '0.5' ], '0.5x' ) .
Html::element( 'button', [ 'type' => 'button', 'class' => 'km-speed-btn', 'data-speed' => '0.25' ], '0.25x' ) .
Html::element( 'button', [ 'type' => 'button', 'class' => 'km-loop-btn', 'data-loop' => '0' ], 'Loop' )
);
return Html::rawElement(
'div',
[ 'class' => 'karate-media-wrapper' ],
$videoTag . $controls
);
}
}