Kā MediaWiki navigācijas izvēlnei pievienot "drukāšanas versiju".

MediaWiki navigācijas izvēlnes uzlabošana

MediaWiki navigācijas izvēlnes pielāgošana var ievērojami uzlabot lietotāja pieredzi, nodrošinot pieejamākus un funkcionālākus rīkus. Ja izmantojat MediaWiki 1.39 ar Timeless motīvu, jums var būt grūti pievienot īpašas opcijas, piemēram, "Drukājama versija". Šis uzdevums nav vienkāršs sānjoslas izvēlnes unikālo konfigurāciju dēļ.

Viens no izplatītākajiem administratoru mērķiem ir nodrošināt lietotājiem ātru veidu, kā piekļūt drukājamām lapām. Šī funkcija ir būtiska vidēm, kurās bieži tiek izmantotas atsauces uz bezsaistes vai drukātiem materiāliem, piemēram, akadēmiskajiem vai korporatīvajiem wiki. Tomēr daudzi uzskata, ka process ir mazāk intuitīvs, nekā gaidīts. 🖨️

Šajā rokasgrāmatā mēs izpētīsim, kā iekļaut saiti “Drukājama versija” navigācijas izvēlnē, īpaši sadaļā “Nejauši izvēlēta lapa”. Lai izmantotu MediaWiki:Sānjoslu modifikācijām, ir rūpīgi jāizprot tās sintakse un darbība Timeless motīvā.

Ja esat iestrēdzis vai rodas problēmas, neuztraucieties! Šīs rokasgrāmatas beigās jūs ne tikai zināt, kā ieviest izmaiņas, bet arī gūsit ieskatu MediaWiki sānjoslas darbībā. Iedziļināsimies šajā praktiskajā uzlabojumā. 🌟

Kā pielāgot MediaWiki navigācijas izvēlni

Iepriekš sniegtie skripti ir vērsti uz MediaWiki navigācijas izvēlnes uzlabošanu, pievienojot opciju "Drukājama versija" zem saites "Izlases lapa". Šo modifikāciju var panākt, izmantojot aizmugursistēmas pielāgošanu, izmantojot āķus vai priekšgala skriptēšanu ar JavaScript. Piemēram, PHP skripts izmanto $wgHooks masīvs un "SkinBuildSidebar" āķis, lai dinamiski ievietotu jaunu navigācijas vienumu. Šī pieeja nodrošina, ka papildinājums nemanāmi integrējas esošajā sānjoslas struktūrā, pielāgojoties dažādiem apvalkiem, piemēram, Timeless tēmai. 🖥️

Priekšgala JavaScript risinājums nodrošina dinamiskāku alternatīvu, mērķējot uz navigācijas izvēlni pēc tam, kad DOM ir pilnībā ielādēts. Izmantojot tādas komandas kā document.createElement un pievienojot jaunizveidotos saraksta vienumus navigācijas izvēlnei, šī metode neprasa mainīt aizmugursistēmas kodu. Piemēram, universitātes wiki varētu ātri izvietot funkciju "Drukājama versija" studentiem, kuri piekļūst kursa materiāliem, nodrošinot minimālus traucējumus tiešsaistes vietnē. Šī elastība padara to ideāli piemērotu situācijām, kad aizmugursistēmas piekļuve ir ierobežota vai nav pieejama. 📄

Vēl viens svarīgs sniegto skriptu aspekts ir to modularitāte un koncentrēšanās uz labāko praksi. PHP skripts ietver kļūdu apstrādi, lai nodrošinātu, ka tas darbojas tikai MediaWiki ietvaros. Līdzīgi JavaScript loģika pārbauda navigācijas izvēlnes esamību pirms tās modificēšanas, tādējādi samazinot izpildlaika kļūdu risku. Piemēram, korporatīvajā wiki ir ļoti svarīgi nodrošināt uzticamību, jo sānjosla bieži vien ir centrālais navigācijas centrs darbiniekiem, kas piekļūst projekta dokumentiem vai pārskatiem.

Vienības testi papildina skriptus, pārbaudot, vai dažādos scenārijos ir pareizi pievienota saite "Drukājama versija". Simulējot MediaWiki vidi, izmantojot imitācijas objektus, šie testi nodrošina, ka risinājums darbojas dažādās konfigurācijās. Šis testēšanas process ir īpaši vērtīgs izstrādātājiem, kuri pārvalda vairākus wiki, jo tas nodrošina aizsardzību pret izvietošanas problēmām. Galu galā, izmantojot PHP aizmugursistēmas āķus, priekšgala JavaScript vai robustu vienību testēšanu, skripti piedāvā daudzpusīgas metodes MediaWiki navigācijas uzlabošanai ar optimālu veiktspēju un uzticamību. 🌟

<?php
// Load MediaWiki's core files
if ( !defined( 'MEDIAWIKI' ) ) {
    die( 'This script must be run from within MediaWiki.' );
}

// Hook into the Sidebar generation
$wgHooks['SkinBuildSidebar'][] = function ( &$sidebar, $skin ) {
    // Add the "Printable version" link below "Random page"
    $sidebar['navigation'][] = [
        'text' => 'Printable version',
        'href' => $skin->msg( 'printable' )->inContentLanguage()->text(),
        'id' => 'n-printable-version'
    ];
    return true;
};

// Save this script in a custom extension or LocalSettings.php
?>

* navigation
 mainpage|mainpage-description
 recentchanges-url|recentchanges
 randompage-url|randompage
 printable-version|Printable version
* SEARCH
* TOOLBOX
// Save changes in the MediaWiki:Sidebar special page.
// Ensure "printable-version" message key is properly defined.

document.addEventListener('DOMContentLoaded', function () {
    const navList = document.querySelector('.mw-portlet-navigation ul');
    if (navList) {
        const printableItem = document.createElement('li');
        printableItem.id = 'n-printable-version';
        const link = document.createElement('a');
        link.href = window.location.href + '?printable=yes';
        link.textContent = 'Printable version';
        printableItem.appendChild(link);
        navList.appendChild(printableItem);
    }
});

use PHPUnit\Framework\TestCase;

class SidebarTest extends TestCase {
    public function testPrintableVersionLinkExists() {
        $sidebar = []; // Simulate Sidebar data structure
        $skinMock = $this->createMock(Skin::class);
        $callback = $GLOBALS['wgHooks']['SkinBuildSidebar'][0];
        $this->assertTrue($callback($sidebar, $skinMock));
        $this->assertArrayHasKey('Printable version', $sidebar['navigation']);
    }
}
// Run using PHPUnit to ensure robust testing.

MediaWiki uzlabošana ar papildu pielāgojumiem

Pielāgotu funkciju pievienošana MediaWiki instancei var būt ne tikai vienkāršas navigācijas izvēlnes modifikācijas. Piemēram, administratori bieži meklē veidus, kā uzlabot funkcionalitāti konkrētām lietotāju vajadzībām, piemēram, integrējot eksportēšanas opcijas vai pielāgojot izkārtojumus, pamatojoties uz lietotāju lomām. Šie uzlabojumi, tostarp "Drukājamas versijas" pievienošana, ir ļoti svarīgi, lai padarītu wiki dinamiskākus un lietotājam draudzīgākus. Jaunu saišu integrācija MediaWiki sānjosla var pielāgot, lai atbilstu unikālajām universitātes portāla vai uzņēmuma iekšējās dokumentācijas prasībām.

Viena no jomām, ko vērts izpētīt, ir tikko pievienoto izvēlnes opciju lokalizācija. Piemēram, nodrošinot, ka etiķete “Drukājama versija” tiek dinamiski tulkota, pamatojoties uz lietotāja valodas preferencēm, tiek pievienots iekļaušanas slānis. Izmantojot MediaWiki iebūvētās lokalizācijas metodes, piemēram, $skin->msg(), ļauj izstrādātājiem pielāgot savus pielāgojumus MediaWiki globālajiem standartiem. Tas ir īpaši noderīgi daudznacionālās organizācijās, kur darbinieki vai līdzstrādnieki piekļūst wiki vairākās valodās. 🌍

Vēl viens svarīgs apsvērums ir mijiedarbība starp pielāgojumiem un atlasīto MediaWiki motīvu. The Mūžīga tēmaPiemēram, tiek izmantota unikāla struktūra, kuras dēļ visas izmaiņas ir rūpīgi jāpārbauda, ​​lai nodrošinātu saderību. Piemēram, vizuāli pamanāmam navigācijas elementam, piemēram, “Drukājama versija”, var būt nepieciešami papildu CSS pielāgojumi, lai saglabātu tā izskatu dažādās ierīcēs. Šīs niansētās modifikācijas nodrošina, ka interfeiss paliek intuitīvs un profesionāls neatkarīgi no lietotāja ierīces vai ekrāna izmēra. 📱