chapter4 カスタマイズについて†

ここでは、設定変更による動作の切り替えとデザインのカスタマイズについて開設します。カスタマイズの方法をマスターして、Pukiwikiを好みのスタイルで使いましょう。

↑

4-1 設定ファイルによる各種カスタマイズ†

Pukiwikiを設置して使い慣れてくると、各機能の動作を細かく変更したくなります。基本的な動作の有効・無効などを切り替えるのであれば、設定ファイルを変更するだけです。

↑

設定ファイルの構成について†

pukiwikiの設定ファイルは、複数に分かれた構成ファイルとなってます。pukiwikiの全体的な設定を行うために変更するファイルpukiwiki.ini.phpです。
アクセスされるwebブラウザごとの設定内容はdefalut.ini.phpとkeitai.ini.phpに分けて保存されています。置換文字列のルール指定はrules.ini.phpとして用意されてます。

↑

読み取り専用にしたい [2025.03.17更新]†

Pukiwikiで作成したサイト2全体を読み取り専用で公開したい場合には、pukiwiki.ini.php内のpkwk_readonlyを1にします。
様々な情報をPukiwikiにまとめた上でページ更新を停止した状態で公開したい場合に有効です。
読み取り専用を有効にすると、ナビゲーション部分に用意されている[編集]と[凍結]リンクが非表示になります。
また、URLでダイレクトに編集画面にアクセスしてもエラー表示となり、編集は一切不可能となります。
なお、ページ単位で更新機能を無効化する場合は凍結機能を利用しましょう。

// PKWK_READONLY - Prohibits editing and maintain via WWW
//   NOTE: Counter-related functions will work now (counter, attach count, etc)
if (! defined('PKWK_READONLY'))
   	define('PKWK_READONLY', 0); // 0 or 1　ここで1にすると有効になります。
↑

画像をページ内で展開しないようにしたい[2025.03.18更新]†

一般的に解放しているPukiwikiでは、悪意のあるユーザーに不適切な画像のURLを貼り付けられ、望まない画像がページに表示されてしまい困る場合があります。
対処するのには、画像URLを画像としてページに表示する機能を無効にしてしまうのが手軽な方法です。

画像URLのページ内表示を無効化するには、pukiwiki.ini.phpにあるPKWK_DISABLE_INLINE_IMAGE_FROM_URLを1に変更します。

これで、ページ内に記載された画像URLはURLのリンクとして表示されます。URLリンクとして表示されてしまうため、不適切な画像へのアクセスを完全に遮断することにはなりませんが、ページ内に表示されてしまうことは防げます。

// PKWK_DISABLE_INLINE_IMAGE_FROM_URI - Disallow using inline-image-tag for URIs
//   Inline-image-tag for URIs may allow leakage of Wiki readers' information
//   (in short, 'Web bug') or external malicious CGI (looks like an image's URL)
//   attack to Wiki readers, but easy way to show images.
if (! defined('PKWK_DISABLE_INLINE_IMAGE_FROM_URI')) 
   	define('PKWK_DISABLE_INLINE_IMAGE_FROM_URI', 0);←ここを1にする。
↑

サイト名などを変更したい[2025.03.19更新]†

設置したPukiwikiのページタイトルやフッタ部表示されるサイト運営者やサイトURLを変更するには、pukiwiki.ini.php内の変数を変更します。
このうちスクリプトURLを指定する変数$scriptは、初期状態でコメントアウトで無効にされていす。
標準的にはURLが自動的にサーバーの設定より生成されますが、設置したWebサーバーによってはURLが内部で上手く生成されない場合があるので、直接指定するために用意されている項目です。
例えば、自宅サーバーでブロードバンドルーター越しにpukiwikiを設置している場合、インターネット側からアクセスに対応する必要があります。
ダイナミックDNSなどを利用し、ドメイン名を取得した上でそのドメイン名でアクセスできるようにURLを記入しましょう。

/////////////////////////////////////////////////
// Title of your Wikisite (Name this)
// Also used as RSS feed's channel name etc
$page_title = 'PukiWiki';

// Specify PukiWiki URL (default: auto)
//$script = 'http://example.com/pukiwiki/';

// Shorten $script: Cut its file name (default: not cut)
//$script_directory_index = 'index.php';

// Site admin's name (CHANGE THIS)
$modifier = 'Web Collaboration by PukiWiki';

// Site admin's Web page (CHANGE THIS)
$modifierlink = 'https://URL';
↑

特別なページの名前を変更したい†

↑

TrackBackに対応したい†

↑

検索エンジンになるべく掛からないようにしたい[2025.03.19更新]†

Pukiwikiに含まれるすべてのページに対して検索エンジンの検索対象から外したい場合は、HTMLのMETAタグにrobotsの名前でnofollow,noindexを指定します。
スキンファイル直接カスタマイズする方法もありましが、$nofollow変数を変更することで簡単にMETAタグを追加することができます。

/////////////////////////////////////////////////
// Always output "nofollow,noindex" attribute

$nofollow = 0; // 1 = Try hiding from search engines ←ここを1にする。

/////////////////////////////////////////////////

ただし、METAタグによる検索対象からの除外は検索エンジンごとの対応によりますので、必ず検索サイトから検索対象として除外されることを保障されるものではありません。
なお、ページごとにnofollowを指定したい場合には$nofollowプラグインを記述した上で、該当ページを凍結してください。

↑

リンク参照先URLを調べたい†

pukiwikiの任意のページに対して外部のサイトからリンクされていることを調べたい場合は、リンク元の保存機能を有効にします。
リンク元保存機能を有効にするには、pukiwiki.ini.phpの＄referer変数を1にします。

$referer = 0;←ここを1にする。

↑

ページ名は自動リンクにしたい†

pukiwikiには自動リンク機能があります。
ページ名をwikinameで記述すれば、自動的にページリンクとなりましが、BracketNameのときも自動的にリンクするには$autolink変数を0以上にします。

$autolink変数にはページ内で自動的にリンクするページ名の最小バイト数を指定します。
日本語文字は1文字2バイトで構成されているので、$autolinkを2にするとページ内を2バイト単位（日本語で1文字分）でページを検索し、
ページ名が該当する場合にはリンクに変換されます。
あまり小さい数字にすると短い名前のページが必要以上に自動リンクになってしまう場合もあるので、ある程度大きい数値、8程度から試してみることをおすすめします。

$autolink = 0; // Bytes, 0 = OFF (try 8)

↑

ページ凍結機能をつかえなくしたい†

ページ凍結機能を無効にするには、$function_freeze変数を0にします。
ページ凍結機能を無効にするとナビゲーション部にある[凍結/凍結解除]のリンクが非表示になります。

$function_freeze = 1;←ここを変更する。

↑

ページ更新時のタイムスタンプを変更しない機能を無効にしたい†

↑

ページ名一覧で日本語インデックスを使いたい†

↑

更新ページ名一覧に表示するページ数を変えたい[2025.03.21更新]†

更新ページ一覧に表示するページ名件数を変更するには、$maxshowの数値を変更します。

$maxs

↑

削除ページ名一覧に表示するページ数を変えたい†

↑

特定のページだけ編集不可能にしたい†

編集不可能なページを指定するには、$cantedit配列にページ名を加えます。
初期状態でじは更新一覧ページ名、削除一覧ページ名が登録されています。
基本的には、pukiwikiのシステムで特殊なページとして取り扱うべきページのみが登録されています。
任意のページを追加した場合、webブラウザから更新できなくなるので注意してください。

$cantedit = array( $whatsnew, $whatsdeleted );

↑

日時の表示方式を変更したい†

pukiwiki内部で使用されている日付や時刻の表示形式を指定する文字列は、それぞれ$date_format,$time_formatとして指定されてます。
各アルファベットの意味は、PHPのdate関数で指定できる設定値です。
ここで指定されてる日時の書式は、ページの最終更新日時の表示や最終更新ページ名一覧での日時表示部分で適用されます。
$date_format = 'Y-m-d';

$time_format = 'H:i:s';

↑

RSSフィードの表示件数を変更したい†

↑

バックアップを残したくない†

↑

ページバックアップのタイミングを変更したい†

↑

ページを削除したらバックアップも削除したい†

↑

ページ更新のタイミングでコマンドを実行したい†

↑

Proxyサーバを通した環境で設置したい†

↑

ページ更新内容をメールで受け取りたい [2025.03.19更新]†

ページ更新の内容をメールで受け取りたい場合は、$notifyを1に変更します。初期状態では、差分のみをメールで送信する$notify_diff_onlyが1に設定されています。
$notify_diff_onlyを0にすると、更新時のページの内容がそのままメールで届きます。
メール通知機能を動作させるためには、SMTPサーバーの指定や送信先のメールアドレスを正しく設定する必要があります。
SMTPサーバーがPOP before SMTP形式の認証を必要とする場合はpopサーバを設定し、ユーザー名、パスワードを併せて指定する必要があります。
pop用のパスワードを設定ファイル内に記述する必要があるので、設定ファイルのパーツミッション設定には十分注意を払う必要があります。
メール通知機能はarticleプラグイン内にも独自で設定値を持っているのでarticleプラグインからの書き込みについてメールで更新通知を受けたい場合はarticle.inc.phpの内容を変更してください。

// Mail related settings
// Send mail per update of pages
$notify = 0;
// Send diff only
$notify_diff_only = 1;
// SMTP server (Windows only. Usually specified at php.ini)
$smtp_server = 'localhost';
// Mail recipient (To:) and sender (From:)
$notify_to   = 'to@example.com';	// To:
$notify_from = 'from@example.com';	// From:
// Subject: ($page = Page name wll be replaced)
$notify_subject = '[PukiWiki] $page';
// Mail header
// NOTE: Multiple items must be divided by "\r\n", not "\n".
$notify_header = '';
/////////////////////////////////////////////////
// Mail: POP / APOP Before SMTP
// Do POP/APOP authentication before send mail
$smtp_auth = 0;
$pop_server = 'localhost';
$pop_port   = 110;
$pop_userid = '';
$pop_passwd = '';
// Use APOP instead of POP (If server uses)
//   Default = Auto (Use APOP if possible)
//   1       = Always use APOP
//   0       = Always use POP
// $pop_auth_use_apop = 1;
↑

隠しページを作りたい†

↑

自動テンプレート機能を設定したい†

↑

見出しアンカーリンクをなくしたい†

↑

ページ内の改行をそのまま表示したい†

↑

ユーザーエージェントごとに動作を変更したい†

↑

複数行対応プラグインを使いたい†

↑

ひな形とするページの一覧を無効化したい†

↑

検索語のハイライトを無効化したい†

↑

ページ名一覧のインデックスを解除したい†

↑

リスト表示のマージンを調整したい†

↑

編集フォームのサイズを変更したい†

↑

水平線の表示状態を変更したい†

↑

関連するページリンクを消したい†

↑

関連するページリンク一覧の表示を変更したい†

↑

脚注のタイトル表示文字数を増やす†

↑

脚注のアンカータグの形式を変更する†

↑

脚注ブロックの区切り表示を変更したい†

↑

ページリンクのタイトルにある更新後の経過時間を消したい†

↑

ページリンクのタイトル表示を消したい[2025.03.19更新]†

wikinameやbracketnameとして表示されるリンク部分にマウスカーソルを合わせしばらく待つと表示される。
ページ名などのタイトル要素を消すには$link_compactに0を設定します。
リンクタイトル要素を非表示にすることでページのデータ量を小さくすることができるので、携帯電話向けなどの表示としては有効です。

■defalut.ini.php
$link_compact = 0;

↑

ユーザー定義の書式を追加†

↑

フェイスマークを使用不可にしたい[2025.03.21更新]†

ページ内の書式として使用できるフェイスマークを使用不可にしたい場合には$usefcemarkを0に指定します。
文中にフェイスマーク用の書式を無意識に使用してしまい、思うように表示されず困っているような人は、
フェイスマーク自体を使用不可にしてしまうことで回避することができます。

フェイスマークの書式ひとつひとつについて有効、無効を変更したい場合は書式設定している部分を変更します。

$usefacemark = 1;←ここを変更する。

↑

ファイスマークルールを増やしたい†

↑

日時の閲覧時間置換ルールを無効にしたい†

↑

日時の閲覧時置換ルールを変更したい†

↑

更新時置換文字列を変更したい†

↑

英語対応変更したい†

↑

他言語に対応させたい†

日本語、英語以外の言語に対応させたい場合委、言語設定を変更した上で言語指定ファイルを自前で用意する必要があります。
言語指定ファイルは配布パッケージにja.Lng.phpとen.Lng.phpが含まれています。それ以外の言語に対応させる場合には、任意で言語コード識別文字を定義し、識別文字.Lng.phpというファイルで言語指定ファイルを用意してください。
例えば、韓国語に対応する場合、新たにkr.Lng.phpと用意した上でLANGをkrに設定しておきます。
kr.Lng.phpは韓国語に対応した文字コードで作成し、各単語の設定も韓国語に切り替えておきます。

↑

タイムゾーンを追加したい†

Pukiwikiの対応するタイムゾーンを追加するにはpukiwiki.inc.php内のタイムゾーン判定部分に記述を追加します。言語指定LANGに対応させる形を取っているので、case文に新たに追加した言語指定に対応する記述を追加しましょう。

/////////////////////////////////////////////////
// Local time setting

switch (LANG) { // or specifiy one
case 'ja':
	 define('ZONE', 'JST');
	 define('ZONETIME', 9 * 3600); // JST = GMT + 9
	 break;
default  :
	 define('ZONE', 'GMT');
	 define('ZONETIME', 0);
	 break;
}
/////////////////////////////////////////////////
↑

オリジナルはここまで†

how = 500;←ここを変更する。

↑

調整中†

↑

調整中†

↑

設定ファイルの構成†

PukiWikiの設定ファイルは、複数に分かれた構成となっています。PukiWikiの全体的な設定を行うために変更するファイルは pukiWiki.ini.php です。
アクセスされるWebブラウザごとの設定内容はdefault.phpとkeitai.phpに分けて保存されます。置換文字列のルールは、rulrs.ini.phpとして用意されいます。
また、言語指定ごとに用意されてるメッセージを含む設定ファイルとして、それぞれja.lng.phpとen.lng.phpがあります。
日本語向けにja、英語向けにenとして設定されています。

↑

ユーザーエージェントごとに動作を変更したい†

↑

PukiWikiでアップロードファイルの容量を増やす方法について†

pukiwiki の設定 [#n91639c5]
pukiwiki側で添付ファイルサイズの上限を変更するには、attachプラグインを直接書き換えないといけません。
attachプラグインは、

pukiwikiフォルダ/plugin/attach.inc.phpです。このファイルの
// max file size for upload on PHP(PHP default 2MB)
ini_set("upload_max_filesize","2M");

となっている行を

// max file size for upload on PHP(PHP default 2MB)
ini_set("upload_max_filesize","50M");

に変更します。さらに

// max file size for upload on script of PukiWiki(default 1MB)
define("MAX_FILESIZE",1000000);

となっている行を

// max file size for upload on script of PukiWiki(default 1MB)
define("MAX_FILESIZE",50000000);

に変更します。

一番上のディレクトリにphp.iniがあるのでその

memory_limit = 8M ; Maximum amount of memory a script may consume (8MB)

となっている行を

memory_limit = 80M ; Maximum amount of memory a script may consume (8MB)

に変更します。さらに

   ; Maximum allowed size for uploaded files. upload_max_filesize = 2M
   ; Maximum size of POST data that PHP will accept. post_max_size = 8M

となっている行を

   ; Maximum allowed size for uploaded iles. upload_max_filesize = 50M
   ; Maximum size of POST data that PHP will accept. post_max_size = 80M

に変更します。これで終わりです。

↑

GoogleAnalyticsトラッキングコードの挿入†

Googleのアクセス分析サービスGoogleAnalyticsのトラッキングコードの挿入
skinフォルダの中にある「pukiwiki.skin.php」をテキストエディタで開き90行目付近の

?php echo $head_tag ?>
/head>
/head>の前にトラッキングコードを挿入。

挿入後

?php echo $head_tag ?>
!-- GoogleAnalytics? Start -->
script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', '************', 'auto');
ga('send', 'pageview');
/script>
!-- GoogleAnalytics? End -->
/head>
ga('create', '************', 'auto'); の************はそれぞれのトラッキングID
↑

自動リンクを無効にする方法†

「pukiwiki.ini.php」をテキストエディタで開き、173行目からの

$nowikiname = 0;を1へ変更

$nowikiname = 0;

ページ下部のLinks・添付ファイルを表示しない

「default.ini.php」をテキストエディタで開き56・60行目の
$attach_link = 0;　★←1を0にする
$related_link = 0;　★←1を0にする
とリンクが無効になります。

↑

テキストエリアサイズをリサイズしたい†

ローカルのメモ用にPukiWikiを使っているのだけど、編集画面のテキストエリアをもう少し広い画面で見たい！と常々思っていたので調べてみました。
まずテキストエリアの大きさは、 default.ini.php で設定できる。

$cols = 100;
$rows = 30;

を変更すればサイズを変更できます。

↑

投稿・編集者の制限†

Wikiを自分ひとりで書く場合の設定（もしくは、Passを知っている人だけが新規、編集可）
「pukiwiki.ini.php」をテキストエディタで開き240行目付に「'ユーザー名' => 'パスワード', // Cleartext」を追加。
※暗号化してる場合は「'ユーザー名' => '{x-php-md5}パスワード', // PHP md5() '」

$auth_users = array(
'ユーザー名' => 'パスワード', // Cleartext　←★この行追加
'foo' => 'foo_passwd', // Cleartext
'bar' => '{x-php-md5}', // PHP md5() 'bar_passwd'
'hoge' => '{SMD5}OzJo/boHwM4q5R+g7LCOx2xGMkFKRVEx', // LDAP SMD5 'hoge_passwd'

);

次に270行目付近に「'/^.*$/' => 'ユーザー名', // 」を追加。

$edit_auth = 1;
$edit_auth_pages = array(
'#BarDiary#' => 'bar',
'#HogeHoge#' => 'hoge',
'#(NETABARE|NetaBare)#' => 'foo,bar,hoge',
'/^.*$/' => 'ユーザー名', // 　←★この行追加
);

これで新規や編集時にパスを求められるようになります。

↑

Pukiwikiのパスワード設定†

パスワードとして「password」を設定する場合・・・

Pukiwiki を設置している場所で

http://*****/index.php?cmd=md5

と入力．

Phrase の部分にパスワード「password」を入力 [#v0b3751c]

PHP md5() を設定して，Compute を押す．

下記のように計算結果が出力されるので，それをコピーする．

{x-php-md5}5f4dcc3b5aa765d61d8327deb882cf99

pukiwiki をインストールしたディレクトリの pukiwiki.ini.php を vi などで開く．

$adminpass をサーチし，現在の設定をコメントアウト．

$adminpass = '{x-php-md5}5f4dcc3b5aa765d61d8327deb882cf99';

と入力．

以上でパスワード設定完了です。そのまんまのパスワードにしておかいようにしてください。

↑

ファイル添付時のパスワード認証を行わないようにしたい。†

pukiwikiはXSS脆弱性対策としてデフォルトでファイルを添付する際に管理者権限が必要みたいです。
どうすればいいかは以下のURLに載っていました。

attach.inc.phpファイルの一部を書き換えます。
PLUGIN_ATTACH_UPLOAD_ADMIN_ONLYをTRUE→FALSE に書き換えます。

↑

ヘッダーのページURLを短くする方法†

デフォルトのページURL（header　の標題の下にあるURL)は、エンコードされて表示されるため、非常に長くなってしまいます。ページを編集していて、横スライドバーが消えずに『え？』と思っていろいろ見てみたら原因は、この長いページURLでした。cssをいじったりしてみましたがうまくいかなかったのですが、本家は、\#topicpath のようなディレクトリの階層表示になっているので『おっこれは良い』とマニュアルなどを再確認したらすでにプラグインされていました。pukiwiki/skin/pukiwiki.skin.php の20行目あたりを以下の様に変更します。 if (!

defined('SKIN_DEFAULT_DISABLE_TOPICPATH'))
define('SKIN_DEFAULT_DISABLE_TOPICPATH',0); // 1, 0
↑

ページタイトルの階層をそれぞれリンクにする。†

pluginフォルダの中の「topicpath.inc.php」をテキストエディタで開く
22行目を

define('PLUGIN_TOPICPATH_THIS_PAGE_DISPLAY', 1);　★←1を0へ変更

30行目を

function plugin_topicpath_convert()
{
return '<div>' . plugin_topicpath_inline() . ' /</div>';　★</div>の前に「 /」を追加。

}

skinフォルダの「pukiwiki.skin.php」をテキストエディタで開き101行目の

h1 class="title"><?php echo $page ?></h1>

を

h1 class="title"><?php
if ($vars["cmd"] == "read") {

if($vars["page"] != "FrontPage"){
echo ('<span class="smalltitle">');
require_once(PLUGIN_DIR.'topicpath.inc.php');
echo plugin_topicpath_convert();
if ( preg_match('/\//',$title) == TRUE ) {
}
echo ('</span>');
echo preg_replace('/.*\//','',$title);
}else{
echo $page_title;
}

} else {

echo $title;
} ?></h1>

へ置き換え。

skinフォルダの「pukiwiki.css.php」をテキストエディタで開き適当な行にスタイルを追加。

.smalltitle { font-size:60%; }

↑

ページ下部のLinks・添付ファイルを表示しない方法†

2通りの方法があります。
１：
「default.ini.php」をテキストエディタで開き56・60行目の

$attach_link = 0;　★←1を0にする
$related_link = 0;　★←1を0にする

を変更すれば表示しなくなります。
２：
skinフォルダの中にある「pukiwiki.skin.php」をテキストエディタで開き

118行目付近にある

a href="<?php echo $link['reload'] ?>"><span class="small"><?php echo $link['reload'] ?></span></a>
の先頭に「<!--」最後に「-->」をつけてコメントアウトして非表示にする。削除してしまっても構わない

?php if(SKIN_DEFAULT_DISABLE_TOPICPATH) { ?>

!-- <a href="<?php echo $link['reload'] ?>"><span class="small"><?php echo $link['reload'] ?></span></a> -->

?php } else { ?>

span class="small"

↑

パスワードを変更したい†

$adminpass = '{x-php-md5}暗号化したパスワードを入れる';

↑

ページタイトルの変更（ブラウザのタイトル）†

デフォルトの設定だとページのタイトルが「ページ名 - サイト名」になっているが「サイト名 - ページ名」へ変更する。
skinフォルダの中にある「pukiwiki.skin.php」をテキストエディタで開き78行目の項目を入れ替える。

変更前<title><?php echo $title ?> - <?php echo $page_title ?></title>

変更後<title><?php echo $page_title ?> - <?php echo $title ?></title>

↑

ページ内にある表の左寄せ†

skinフォルダの中にある「pukiwiki.css.php」をテキストエディタで開き170行目付近にある.style_tableにmargin-left:0px;を追加
編集ファイルcssファイルから以下の内容を変更する。

.style_table {
padding:0px;
border:0px;
margin:auto;
margin-left:0px; ←★この行追加
text-align:left;
color:inherit;
background-color:#ccd5dd;
}

200行目付近にある
div.ie5 {text-align:center; }
を
div.ie5 { text-align:left; }
に書き換えて完了です。

↑

ロゴ画像変更・サイズ変更†

Pukiwikiフォルダの中のimageフォルダの中の「pukiwiki.png」がロゴ画像のデータpukiwiki.pngを変更したい画像へ差し替えればOK

デフォルトだとサイズが80x80なので変更後の画像のサイズへ変更
skinフォルダの中にある「pukiwiki.skin.php」をテキストエディタで開き
97行目からのwidth="80" height="80を変更
ついでに代替テキストalt="[PukiWiki]とタイトル title="[PukiWiki]も変更

a href="<?php echo $link['top'] ?>"><img id="logo" src="<?php echo IMAGE_DIR .
$image['logo'] ?>" width="80" height="80" alt="[PukiWiki]" title="[PukiWiki]" /></a>
↑

4-2 アクセス制限の設定†

編集や閲覧ごとにページ単位でユーザーごとにアクセス制限を行うことができます。

↑

アクセス制限を行いたい†

まず、ユーザー設定は、&auth_uers配列にユーザー名、パスワードという形で定義します。
パスワードには、平文のパスワードから各種の暗号済みパスワード文字列まで使用することができます。

$auth_users = array(
	// Username => password
	'foo'	=> 'foo_passwd', // Cleartext
	'bar'	=> '{x-php-md5}', // PHP md5() 'bar_passwd'
	'hoge'	=> '{SMD5}',      // LDAP SMD5 'hoge_passwd'
	);

認証方式は、ページ名単位の設定とコンテンツ単位での設定の2種類から洗濯することができます。
$auth_method_typeにpagenameを設定した場合はページ単位での認証となり、
contentsを指定した場合はページ内に認証有効記述の有無を判断した上で認証の有無が決まります。

それぞれの認証方式の違いはいくつかありますが、大きな違いとしてはページ名単位での設定はアクセス制限対象を事前に設定ファイル内で定義する必要があり、
コンテンツ単位では認証有効化の単語さえわかっていればユーザーが自由にページに対す手の認証の有無を切り替えることができます。

↑

ページを削除したらバックアップも削除したい†

ページを削除したタイミングでそのページのバックアップデータも含めて削除してしまいたい場合は、$del_backupを1にします。
ただし、意図しないページ削除からページを修復することができなくなるので、ページ削除時のバックアップ同時削除は、あまり有効化しないほうがいいでしょう。

$do_backup = 1;

↑

単語検索と認証ページ†

単語検索を行う際に、認証の掛かっているページを検索対象とするかしないかの設定するには、
$Serach_authで指定することができます。

$Serach_authを1に変更すると認証の掛かっているページは、認証が済んでるユーザー以外には検索対象として表示されない状態になります。

// Search auth
// 0: Disabled (Search read-prohibited page contents)
// 1: Enabled  (Search only permitted pages for the user)
$search_auth = 0; ←ここを変更する。
↑

4-3 ユーザーインターフェイスの変更†

↑

4-4　スキンを自前でカスタマイズする†

配布されているスキンで満足できない、あるいは自分でどうしてもスキンを作成したいという場合には、スキンを自作するしかありません。

↑

独自のスキンにしたい†

スキンを自作するためには、よりPHPやHTML、CSSの知識を持っていなければなりませんが、少しずつ改造してゆくとこで知識を習得し、技術として身についていくことでしょう。
スキンの配色はCSSで行うことができます。標準のスキンに対応するCSSファイルはSkinディレクトリに含まれるPukiwiki.css.phpです。

pukiwiki.css.phpは、ファイルの拡張子が示すとおりPHPで実装されてます。CSSファイルなのにPHPで実装されてるのは、印刷時のCSSの切り替えや各種の動的な判定を行うためです。
CSSを変更するだけであれば、PHPとして実装されている部分には特に触れる必要がありません。
背景色や文書全体の文字色を一律で変更するためにはCSS内のbody.tdとして定義されている箇所を変更します。

?php

if (! defined('PKWK_OPTIMISE'))

	define('PKWK_OPTIMISE', 0);

if (! defined('PKWK_READONLY'))

	define('PKWK_READONLY', 0); // 0 or 1

if (! defined('PKWK_SAFE_MODE'))

	define('PKWK_SAFE_MODE', 0);

if (! defined('PKWK_DISABLE_INLINE_IMAGE_FROM_URI'))

	define('PKWK_DISABLE_INLINE_IMAGE_FROM_URI', 0);

define('PKWK_QUERY_STRING_MAX', 2000); // Bytes, 0 = OFF

define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 1); // 1 = Disabled

define('LANG', 'ja');

define('UI_LANG', LANG); // 'en' for Internationalized wikisite

define('DATA_DIR', DATA_HOME . 'wiki/' ); // Latest wiki texts
define('DIFF_DIR', DATA_HOME . 'diff/' ); // Latest diffs
define('BACKUP_DIR', DATA_HOME . 'backup/' ); // Backups
define('CACHE_DIR', DATA_HOME . 'cache/' ); // Some sort of caches
define('UPLOAD_DIR', DATA_HOME . 'attach/' ); // Attached files and logs
define('COUNTER_DIR', DATA_HOME . 'counter/' ); // Counter plugin's counts
define('PLUGIN_DIR', DATA_HOME . 'plugin/' ); // Plugin directory

define('SKIN_DIR', 'skin/');

define('IMAGE_DIR', 'image/');

$page_title = 'PukiWiki';

$modifier = 'anonymous';

$modifierlink = 'http://pukiwiki.example.com/';

$defaultpage = 'FrontPage'; // Top / Default page
$whatsnew = 'RecentChanges'; // Modified page list
$whatsdeleted = 'RecentDeleted'; // Removeed page list
$interwiki = 'InterWikiName'; // Set InterWiki definition here
$aliaspage = 'AutoAliasName'; // Set AutoAlias definition here
$menubar = 'MenuBar'; // Menu
$rightbar_name = 'RightBar'; // RightBar

define('PKWK_ALLOW_JAVASCRIPT', 1);

$nowikiname = 0;

$autoalias = 0; // Bytes, 0 = OFF (try 8)

$autoalias_max_words = 50; // pairs

$notimeupdate = 1;

$pagereading_enable = 0;

$pagereading_kanji2kana_converter = 'none';

$pagereading_kanji2kana_encoding = 'EUC'; // Default for Unix

$pagereading_chasen_path = '/usr/local/bin/chasen';

$pagereading_kakasi_path = '/usr/local/bin/kakasi';

$pagereading_config_page = ':config/PageReading';

$pagereading_config_dict = ':config/PageReading/dict';

$ldap_user_account = 0; // (0: Disabled, 1: Enabled)

$auth_provider_user_prefix_default = 'default:';
$auth_provider_user_prefix_ldap = 'ldap:';
$auth_provider_user_prefix_external = 'external:';
$auth_provider_user_prefix_saml = 'saml:';

$auth_users = array(

	// Username => password
	'foo'	=> 'foo_passwd', // Cleartext
	'bar'	=> '{x-php-md5}f53ae779077e987718cc285b14dfbe86', // PHP md5() 'bar_passwd'
	'hoge'	=> '{SMD5}OzJo/boHwM4q5R+g7LCOx2xGMkFKRVEx',      // LDAP SMD5 'hoge_passwd'

);

$auth_groups = array(

	// Groupname => group members(users)
	'valid-user' => '', // Reserved 'valid-user' group contains all authenticated users
	'groupfoobar'	=> 'foo,bar',

);

$auth_method_type = 'pagename'; // By Page name

$read_auth = 0;

$read_auth_pages = array(

	// Regex		   Groupname or Username
	'#PageForAllValidUsers#'	=> 'valid-user',
	'#HogeHoge#'		=> 'hoge',
	'#(NETABARE|NetaBare)#'	=> 'foo,bar,hoge',

);

$edit_auth = 0;

$edit_auth_pages = array(

	// Regex		   Username
	'#BarDiary#'		=> 'bar',
	'#HogeHoge#'		=> 'hoge',
	'#(NETABARE|NetaBare)#'	=> 'foo,bar,hoge',

);

$search_auth = 0;

$no_autoticketlinkname = 0;
$ticket_link_sites = array(
/*

	array(
		'key' => 'phpbug',
		'type' => 'redmine', // type: redmine, jira or git
		'title' => 'PHP :: Bug #$1',
		'base_url' => 'https://bugs.php.net/bug.php?id=',
	),
	array(
		'key' => 'asfjira',
		'type' => 'jira',
		'title' => 'ASF JIRA [$1]',
		'base_url' => 'https://issues.apache.org/jira/browse/',
	),
	array(
		'key' => 'pukiwiki-commit',
		'type' => 'git',
		'title' => 'PukiWiki revision $1',
		'base_url' => 'https://ja.osdn.net/projects/pukiwiki/scm/git/pukiwiki/commits/',
	),
*/
);

/*
$ticket_jira_default_site = array(

	'title' => 'My JIRA - $1',
	'base_url' => 'https://issues.example.com/jira/browse/',

);

$external_link_cushion_page = 0;
$external_link_cushion = array(

	// Wait N seconds before jumping to an external site
	'wait_seconds' => 5,
	// Internal site domain list
	'internal_domains' => array(
		'localhost',
		// '*.example.com',
	),
	// Don't show extenal link icons on these domains
	'silent_external_domains' => array(
		'pukiwiki.osdn.jp',
		'pukiwiki.example.com',
	),

);

$topicpath_title = 1;

$html_meta_referrer_policy = '';

$http_response_custom_headers = array(

	// 'Strict-Transport-Security: max-age=86400',
	// 'X-Content-Type-Options: nosniff',

);

$maxshow_deleted = 200;

$lastmod = 0;

$rss_max = 15;

$del_backup = 0;

$cycle = 3; // Wait N hours between backup (0 = no wait)
$maxage = 120; // Stock latest N backups

define('PKWK_SPLITTER', '>>>>>>>>>>');

define('PKWK_UPDATE_EXEC', '');

$use_proxy = 0;

$proxy_host = 'proxy.example.com';
$proxy_port = 8080;

$need_proxy_auth = 0;
$proxy_auth_user = 'username';
$proxy_auth_pass = 'password';

$no_proxy = array(

	'localhost',	// localhost
	'127.0.0.0/8',	// loopback

);

$notify = 0;

$notify_diff_only = 1;

$smtp_server = 'localhost';

$notify_to = 'to@example.com'; // To:
$notify_from = 'from@example.com'; // From:

$notify_subject = '[PukiWiki] $page';

$notify_header = '';

$smtp_auth = 0;

$pop_server = 'localhost';
$pop_port = 110;
$pop_userid = '';
$pop_passwd = '';

$non_list = '^\:';

$search_non_list = 1;

$page_redirect_rules = array(

	//'#^FromProject($|(/(.+)$))#' => 'ToProject$1',
	//'#^FromProject($|(/(.+)$))#' => function($matches) { return 'ToProject' . $matches[1]; },

);

$auto_template_func = 1;
$auto_template_rules = array(

	'((.+)\/([^\/]+))' => '\2/template'

);

$fixed_heading_anchor = 1;

$preformat_ltrim = 1;

$line_break = 0;

$usedatetime = 1;

$logging_updates = 0;
$logging_updates_log_dir = '/var/log/pukiwiki';

$page_uri_handler = null; // default

}}

トップ   一覧 検索 最終更新   ヘルプ   最終更新のRSS