「Footerにリンクを追加したい」の版間の差分
編集の要約なし |
編集の要約なし |
||
1行目: | 1行目: | ||
MediaWikiのフッターはデフォルトで、リンクコンテンツが決まっていますが本サイトではCookieに関する声明を追加したかったので、フッターにリンクを追加できる拡張機能を探していて[https://www.mediawiki.org/wiki/Extension:SimpleFooterLink Extension:SimpleFooterLink]を見つけたので、備忘録として残しておきます。ただし、この拡張機能は定期的にメンテナンスされているわけではないようなので、MediaWikiのversionが上がり仕様が変更になった時、動作不良になることを了承しておく必要があります。 | MediaWikiのフッターはデフォルトで、リンクコンテンツが決まっていますが本サイトではCookieに関する声明を追加したかったので、フッターにリンクを追加できる拡張機能を探していて[https://www.mediawiki.org/wiki/Extension:SimpleFooterLink Extension:SimpleFooterLink]を見つけたので、備忘録として残しておきます。ただし、この拡張機能は定期的にメンテナンスされているわけではないようなので、MediaWikiのversionが上がり仕様が変更になった時、動作不良になることを了承しておく必要があります。 | ||
== インストール == | |||
*[https://www.mediawiki.org/wiki/Extension:SimpleFooterLink/ja MediaWikiサイト]でダウンロードして、ファイルをextensions/フォルダー内のSimpleFooterLinkという名前のディレクトリ内に配置します。 | |||
この拡張機能は、ダウンロードリンクがありません。インフォボックスの中にある[https://github.com/AnnAngela/MediawikiExtension-SimpleFooterLink/ Gitプロジェクトページ]からダウンロードします。 | |||
*以下のコードを LocalSettings.php ファイルの末尾に追加します: | |||
<code>wfLoadExtension( 'SimpleFooterLink' );</code> | |||
== 設定 == | |||
SimpleFooterLinkの生成を変更するオプションのパラメータは非常にシンプルな配列構造です。 LocalSettings.phpで設定することができます。 | |||
<pre> | |||
// Add link to a wiki page at footer link area: | |||
$wgSimpleFooterLinkArray = [ | |||
[ | |||
"name" => "ALink", | |||
"tag" => "a", | |||
"attr" => [ "href" => "link-url" ], | |||
"innerHTML" => "link-text", | |||
] | |||
]; | |||
</pre> | |||
== 設定パラメータ == | |||
{| class="wikitable" | |||
|+ Configuration parameters | |||
|- | |||
! Name | |||
! colspan="3" | Value typing | |||
|- | |||
| rowspan="4" | <code>$wgSimpleFooterLinkArray</code> | |||
| rowspan="4" | Unnamed array, fulfilled with key-value named array described as right<br> | |||
! <code>name</code> | |||
| string | |||
---- | |||
Must be identical, or only the very last one keep and other lost. | |||
|- | |||
! <code>tag</code> | |||
| string | |||
---- | |||
HTML element tagname, in lower case, pass to [https://doc.wikimedia.org/mediawiki-core/master/php/classHtml.html#a92f023b28be16bb69004084d66a8ac38 Html::rawElement] as first parameter - $element. | |||
|- | |||
! <code>attr</code> | |||
| key-value named array | |||
---- | |||
HTML attributes key-value map, pass to [https://doc.wikimedia.org/mediawiki-core/master/php/classHtml.html#a92f023b28be16bb69004084d66a8ac38 Html::rawElement] as second parameter - $attribs, also see [https://doc.wikimedia.org/mediawiki-core/master/php/classHtml.html#a8a59e801c9d0c6f31138bbbf2d17fb5c Html::expandAttributes] for detail.<br>CAUTION: if <code>tag</code> is "a", <code>attr</code> has key "href", then <code>attr.href</code> will be parsed by [https://doc.wikimedia.org/mediawiki-core/master/php/classSkin.html#a04926c6b751e3e752ce12f7c2d360c8c Skin::makeInternalOrExternalUrl] first. | |||
|- | |||
! <code>innerHTML</code> | |||
| string | |||
---- | |||
HTML string '''without''' escaped, pass to [https://doc.wikimedia.org/mediawiki-core/master/php/classHtml.html#a92f023b28be16bb69004084d66a8ac38 Html::rawElement] as third parameter - $contents. | |||
|} | |||
== 動作環境 == | |||
* [https://www.mediawiki.org/wiki/Download/ja MediaWiki ver 1.40.1] | |||
* [https://www.mediawiki.org/wiki/Extension:SimpleFooterLink/ja Extension:SimpleFooterLink] | |||
* [https://www.mediawiki.org/wiki/Skin:Minerva%20Neue Skin:Minerva Neue] | |||
* [https://www.mediawiki.org/wiki/Skin:Vector/2022/ja Skin:ベクター/2022年版] | |||
== 参考資料 == | |||
* [https://www.mediawiki.org/wiki/Extension:SimpleFooterLink/ja Extension:SimpleFooterLink] | |||
[[Category:MediaWikiについての備忘録 ]] | [[Category:MediaWikiについての備忘録 ]] |
2023年11月13日 (月) 15:18時点における版
MediaWikiのフッターはデフォルトで、リンクコンテンツが決まっていますが本サイトではCookieに関する声明を追加したかったので、フッターにリンクを追加できる拡張機能を探していてExtension:SimpleFooterLinkを見つけたので、備忘録として残しておきます。ただし、この拡張機能は定期的にメンテナンスされているわけではないようなので、MediaWikiのversionが上がり仕様が変更になった時、動作不良になることを了承しておく必要があります。
インストール
- MediaWikiサイトでダウンロードして、ファイルをextensions/フォルダー内のSimpleFooterLinkという名前のディレクトリ内に配置します。
この拡張機能は、ダウンロードリンクがありません。インフォボックスの中にあるGitプロジェクトページからダウンロードします。
- 以下のコードを LocalSettings.php ファイルの末尾に追加します:
wfLoadExtension( 'SimpleFooterLink' );
設定
SimpleFooterLinkの生成を変更するオプションのパラメータは非常にシンプルな配列構造です。 LocalSettings.phpで設定することができます。
// Add link to a wiki page at footer link area: $wgSimpleFooterLinkArray = [ [ "name" => "ALink", "tag" => "a", "attr" => [ "href" => "link-url" ], "innerHTML" => "link-text", ] ];
設定パラメータ
Name | Value typing | ||
---|---|---|---|
$wgSimpleFooterLinkArray
|
Unnamed array, fulfilled with key-value named array described as right |
name
|
string
Must be identical, or only the very last one keep and other lost. |
tag
|
string
HTML element tagname, in lower case, pass to Html::rawElement as first parameter - $element. | ||
attr
|
key-value named array
HTML attributes key-value map, pass to Html::rawElement as second parameter - $attribs, also see Html::expandAttributes for detail. | ||
innerHTML
|
string
HTML string without escaped, pass to Html::rawElement as third parameter - $contents. |