Jeans & Development コンピューターのことなどを綴ったメモ (旧：目から鱗 w/SQLite)

Nucleus JPフォーラムでのあるトピックで、一つのプラグインを二つの異なるプラグインとしてインストールできれば、有用であるケースがあることを知った。フォーラムでの結論としては、プラグインのPHPファイル及び下層ディレクトリのファイル名を書き換えてコピーし、クラス名も同じ名で書き換えることで対応できるということになった。

このような対応をした場合、後にプラグインのアップグレードをする時は、コピー元とコピーしたプラグインの両方を変更しなければならない。

masさんがtwitterで、これを解決する方法をつぶやいていたので、少しまとめてここにメモ。

結論としては、NP_Calendar_english.phpを次の内容で作成すれば、それでOK。

<?php

$this->getPlugin('NP_Calendar');
class NP_Calendar_english extends NP_Calendar {
    function getShortName() {
        return 'calendar';
    }
    function install() { }
    function unInstall() { }
}

少し解説。

１）ミソはmasさんのアイデア、『class NP_Calendar_english extends NP_Calendar』。要は、NP_Calendar_englishというクラスが、NP_Calendarと同じ動作をすればよいので、そっくりそのまま継承すればよい。

２）ただし、NP_Calendar_englishクラスの定義の際、NP_Calendarクラスが定義されていないと、fatal errorとなる。そこで必要なのが、『$this->getPlugin('NP_Calendar');』の行。ここで、NP_Calendarオブジェクトを作成している。ちなみに、『$this』はMANAGERオブジェクト。プラグインのPHPファイルは、MANAGER::_loadPlugin()メソッド内で、include()命令により読み込まれているので、『$this』によりMANAGERオブジェクトにアクセス可能。

３）もしプラグインが下層ディレクトリを持っていない場合、上記の１）、２）の実装だけでOKのはず。つまり、

<?php

$this->getPlugin('NP_Calendar');
class NP_Calendar_english extends NP_Calendar {
}

でよい。しかし、下層ディレクトリを持っている場合はこれだけではうまく行かない。今の例だと、日本語版のカレンダープラグインでプラグイン独自の言語ファイルを読み込みもうとするとき、『plugins/calendar_english/』ディレクトリ以下のファイルを利用しようとする。これをごまかすには、getShortName()メソッドをオーバライドして、下層ディレクトリに『plugins/calendar/』が利用されるようにすれば良い。

４）h1028さんのコメントを受けて修正し、install(), uninstall()メソッドをオーバライドして、プラグインのインストール時とアンインストール時に、何も行わないようにした。

補足：上記コードは、もしかしたらPHP4ではうまく働かないかもしれない。その場合は、次のように変更すればうまく行くかも。

<?php

$this->getPlugin('NP_Calendar');
if (!class_exists('NP_Calendar_english')) {
    class NP_Calendar_english extends NP_Calendar {
        function getShortName() {
            return 'calendar';
        }
        function install() { }
        function unInstall() { }
    }
}

（2008-11-18 改定）