AbahDoku Custom

Menu Sidebar

Mediawiki secara default memiliki menu sidebar yang bisa di costum, di tambah atau di kurangi. Penambahan menu sidebar bisa dilakukan dengan beberapa cara.

1. Melalui MediaWiki:Sidebar
2. Melalui LocalSettings.php

Menambah menu Sidebar melalui MediaWiki:Sidebar

Cara pertama ini dapat dilakukan melalui url berikut :

http://<nama_domain>/index.php/MediaWiki:Sidebar

Contoh :

http://abahdoku.wiki.gd/index.php/MediaWiki:Sidebar

Jika MediaWiki:Sidebar sudah terbuka, pilih Edit source, tambahkan di baris terakhir navigation :

** http://abahdoku.wiki.gd|"MenuTambahan"

Maka hasilnya akan tampak seperti ini :

* navigation
** mainpage|mainpage-description
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help-mediawiki
** http://abahdoku.wiki.gd|MenuTambahan
* SEARCH
* TOOLBOX
* LANGUAGES

Cara pertama ini untuk yang sudah expert menggunakan Mediawiki ada yang melibatkan Java Script yang di custom melalui url berikut :

http://<domain>/index.php?title=MediaWiki:Common.js

Menambah menu Sidebar melalui LocalSettings.php

Cara kedua ini adalah dengan menambah sedikit code pada file LocalSettings.php.

Code yang di tambahkan pada LocalSettings.php adalah :

$wgHooks['SkinBuildSidebar'][] = function ( $skin, &$bar ) {
    // Mendapatkan user context
    $user = RequestContext::getMain()->getUser();

    // Menambahkan menu "AbahDoku Costum"
      $bar['navigation'][] = [
          'text' => 'AbahDoku Custom',
          'href' => '/index.php/AbahDoku_Custom',  // Link ke halaman baru
          'id'   => 'n-abahdoku_custom',  // Optional ID
          'target' => '_self'  // Membuka di tab yang sama
      ];  
    }
    return true;
};

Berikut ini adalah contoh code menu untuk mengakses url external di luar Mediawiki, code dibawah ini hanya akan terlihat jika user sudah melakukan login di Mediawiki, jika user belum melakukan login, menu ini tidak akan terlihat. Menu ini akan membuka tab browser baru jika di klik.

    // Memeriksa apakah pengguna sudah login
    if ( $user->isRegistered() ) {
        $bar['navigation'][] = [
            'text' => 'Aplikasi',
            'href' => 'http://abahdoku.wiki.gd:9080/aplikasi',
            'id'   => 'n-aplikasi',  // Optional ID for styling or JS manipulati$
            'target' => '_blank'   // Opens in a new tab
        ];

jika digabungkan menu AbahDoku Custom dan menu Aplikasi, maka hasilnya akan seperti berikut ini :

$wgHooks['SkinBuildSidebar'][] = function ( $skin, &$bar ) {
    // Mendapatkan user context
    $user = RequestContext::getMain()->getUser();

    // Menambahkan menu "AbahDoku Costum"
        $bar['navigation'][] = [
            'text' => 'AbahDoku Custom',
            'href' => '/index.php/AbahDoku_Custom',  // Link ke halaman baru
            'id'   => 'n-abahdoku_custom',  // Optional ID
            'target' => '_self'  // Membuka di tab yang sama
        ];
    // Memeriksa apakah pengguna sudah login
    if ( $user->isRegistered() ) {
        $bar['navigation'][] = [
            'text' => 'Aplikasi',
            'href' => 'http://abahdoku.wiki.gd:9080/aplikasi',
            'id'   => 'n-aplikasi',  // Optional ID for styling or JS manipulati$
            'target' => '_blank'   // Opens in a new tab
        ];
    }
    return true;
};

Menu Footer

Secara default menu footer pada Mediawiki ada 3 yaitu "Privacy policy", "About AbahDoku" dan "WikiDisclaimers". Namun pada barisan menu footer penulis ingin menambahkan satu menu untuk aplikasi seperti pada menu Sidebar atau menu yang lain yang ingin ditambahkan. Caranya hanya dengan menambahkan kode berikut di akhir file LocalSettings.php adalah :

$wgHooks['SkinAddFooterLinks'][] = function ( Skin $skin, string $key, array &$footerlinks ) {
    // Memeriksa apakah pengguna sudah login
    $user = $skin->getUser();
    if ( $user->isRegistered() && $key === 'places' ) {
        // Menambahkan menu Aplikasi
        $footerlinks['mikhmon'] = Html::rawElement( 'a', [
            'href' => 'http://abahdoku.wiki.gd:9080/aplikasi',
            'target' => '_blank', // Opens in a new tab
            'rel' => 'noreferrer noopener' // not required, but recommended for security reasons
        ], 'Aplikasi' ); // Teks link yang ditampilkan
    }
};

Menambah icon di samping menu

Sebelumnya perlu di siapkan file gambar (icon) dengan ukuran yang kecil kecil sekitar 16 x 16px. Hanya dengan menambah sedikit dari code di atas.

$wgHooks['SkinAddFooterLinks'][] = function ( Skin $skin, string $key, array &$footerlinks ) {
    // Memeriksa apakah pengguna sudah login
    $user = $skin->getUser();
    if ( $user->isRegistered() && $key === 'places' ) {
        // Menambahkan menu Aplikasi dengan icon
        $iconUrl = 'http://abahdoku.wiki.gd/images/c/c3/Aplikasi.png'; // Ganti dengan URL ikon/logo Anda
        $footerlinks['mikhmon'] = Html::rawElement( 'a', [
            'href' => 'http://abahdoku.wiki.gd:9080/aplikasi',
            'target' => '_blank', // Opens in a new tab
            'rel' => 'noreferrer noopener' // not required, but recommended for security reasons
        ], Html::element('img', [
            'src' => $iconUrl,
            'alt' => 'Aplikasi Icon', // Teks alternatif untuk gambar
            'style' => 'width:16px; height:16px; vertical-align:middle; margin-right:4px;' // Sesuaikan ukuran dan posisi
        ]) . 'Aplikasi'); // Teks link yang ditampilkan
    }
};

Halaman Tersembunyi

MediaWiki memiliki fitur yang dapat menyembunyikan halaman dan hanya dapat di akses oleh oleh user yang sudah melewati proses login. Secara dafault MediaWiki tidak memiliki fitur ini, namun dapat di tambahkan dengan mengaktifkan extensions "Lockdown". Secara lengkap fitur ini dapat di tambahkan dengan script berikut pada file LocalSettings.php :

# 1. Buat namespace baru untuk catatan pribadi
define("NS_PRIVATE", 3000);
define("NS_PRIVATE_TALK", 3001);
$wgExtraNamespaces[NS_PRIVATE] = "Private";
$wgExtraNamespaces[NS_PRIVATE_TALK] = "Private_talk";

# 2. Aktifkan ekstensi Lockdown
wfLoadExtension( 'Lockdown' );

# 3. Batasi akses 'read' hanya untuk user login pada namespace Private
$wgNamespacePermissionLockdown[NS_PRIVATE]['read'] = [ 'user' ];

# 5. Whitelist halaman "Main Page" agar bisa diakses walaupun global read dibatasi
$wgWhitelistRead = [
    "Main Page",
    "MediaWiki:Common.css",
    "MediaWiki:Common.js",
    "Special:UserLogin",
    "Special:UserLogout",
];

Penjelasan lebih rinci script di atas adalah : 1. Membuat Namespace Baru untuk Catatan Pribadi