MediaWiki ナビゲーション メニューに「印刷可能バージョン」を追加する方法

MediaWiki ナビゲーションに「印刷可能なバージョン」オプションを追加する

PHP を使用して MediaWiki サイドバー構成を変更するサーバー側スクリプト。

<?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
?>

新しいリンクを追加するための MediaWiki サイドバー構成の使用

Timeless テーマの MediaWiki:Sidebar ページを手動で編集する方法。

* 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.

動的フロントエンドJavaScriptソリューション

JavaScript を使用して「印刷可能なバージョン」オプションを動的に追加するクライアント側スクリプト。

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);
    }
});

サイドバー変更の単体テスト

バックエンドでの「印刷可能なバージョン」の統合を検証するための PHP 単体テスト。

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 のカスタマイズに関するよくある質問

1. MediaWiki サイドバーを編集するにはどうすればよいですか?
2. MediaWiki:Sidebar ページを変更することでサイドバーを編集できます。次のようなコマンドを使用します * navigation そして option|label 新しいリンクを定義します。
3. 「Timeless」テーマとは何ですか? それはカスタマイズにどのような影響を与えますか?
4. Timeless テーマは、レスポンシブ デザインを備えた最新の MediaWiki スキンです。サイドバーの変更などのカスタマイズでは、正しく表示されることを確認するために追加のテストが必要になる場合があります。
5. 新しいサイドバー オプションのローカライズを追加することはできますか?
6. はい、使用できます $skin->msg() メニュー項目のローカライズされたラベルを取得し、多言語 Wiki との互換性を確保します。
7. バックエンドコードを変更せずに新しい機能を追加できますか?
8. はい、フロントエンド JavaScript ソリューションを使用するのと同様です document.createElement() バックエンドを変更せずにリンクや機能を動的に追加できます。
9. 新しいサイドバー機能をテストするにはどうすればよいですか?
10. PHP 単体テストまたは PHPUnit などのテスト フレームワークを使用して、サイドバーの変更をシミュレートし、期待どおりに動作することを確認します。

MediaWiki ナビゲーションを洗練する

MediaWiki ナビゲーションに「印刷可能なバージョン」オプションを追加すると、Wiki の使いやすさと構成が向上します。ここで詳しく説明するアプローチでは、PHP スクリプトから JavaScript まで、すべての管理者がカスタマイズにアクセスでき、効果的です。

ローカライズとテーマの互換性を優先することで、Wiki はさまざまな視聴者にとって信頼できるリソースになります。これらの機能強化により、機能が向上するだけでなく、よく管理されアクセスしやすいプラットフォームを反映して、ユーザーフレンドリーなエクスペリエンスも提供されます。 🌟