プラグインの作成¶

プラグインコントローラ¶

ContactManager プラグインのコントローラーは、 /app/Plugin/ContactManager/Controller/ に設置されます。 主にやりたい事は contacts の管理ですので、このプラグインには ContactsController が必要です。

そこで ContactsController を /app/Plugin/ContactManager/Controller に設置し、 このように書きます。

// app/Plugin/ContactManager/Controller/ContactsController.php の中で

class ContactsController extends ContactManagerAppController {
    public $uses = array('ContactManager.Contact');

    public function index() {
        // ...
    }
}

これまで行ってきたものにアクセスしたい場合、 /contact_manager/contacts にアクセスします。 Contact モデルをまだ定義してないので、 “Missing Model” エラーがでるはずです。

プラグインモデル¶

プラグインのモデルは /app/Plugin/ContactManager/Model に設置されます。 プラグインの ContactsController は既に定義してあるので、そのモデルを作成します。

// /app/Plugin/ContactManager/Model/Contact.php の中で

class Contact extends ContactManagerAppModel {
}

/contact_manager/contacts に（contacts テーブルがある状態で） 今アクセスすると、“Missing View” エラーが発生します。 次にこれを作ります。

例えば:

// /app/Plugin/ContactManager/Model/Contact.php の中で

class Contact extends ContactManagerAppModel {
    public $hasMany = array('ContactManager.AltName');
}

プラグインの接頭語との連携の無い配列キーを参照したいなら、代わりのシンタックスを使います。

// /app/Plugin/ContactManager/Model/Contact.php の中で

class Contact extends ContactManagerAppModel {
    public $hasMany = array(
        'AltName' => array(
            'className' => 'ContactManager.AltName'
        )
    );
}

プラグインビュー¶

ビューは通常のアプリケーション内での動作として振る舞います。 /app/Plugin/[PluginName]/View/ フォルダー内に設置するだけです。 ContactManager プラグインでは、ContactsController::index() アクションのビューが必要になるので、 このような内容になります。

<!-- /app/Plugin/ContactManager/View/Contacts/index.ctp: -->
<h1>Contacts</h1>
<p>Following is a sortable list of your contacts</p>
<!-- A sortable list of contacts would go here....-->

/app/View/Plugin/ContactManager/Contacts/index.ctp

プラグインアセット¶

プラグインのウェブアセット（php ファイルではない）は、 プラグインの ’webroot’ ディレクトリを通して受け取られます。

app/Plugin/ContactManager/webroot/
                                    css/
                                    js/
                                    img/
                                    flash/
                                    pdf/

通常の webroot と同じようにどのディレクトリにどんなファイルでも置くことができます。

ただ、プラグインの静的アセットや画像や JavaScript または CSS は、 ディスパチャーを 経由しますが、非常に効率が悪くなることを覚えておいてください。 ですので、本番環境では それらにシンボリックリンクを張っておくことを強くおすすめします。 例えばこのようにします。

ln -s app/Plugin/YourPlugin/webroot/css/yourplugin.css app/webroot/css/yourplugin.css

<?php echo $this->Html->css("ContactManager.style"); ?>

コンポーネント、ヘルパーとビヘイビア¶

コンポーネント、ヘルパーやビヘイビアを持つプラグインは、通常の CakePHP アプリケーションの ようなものです。 コンポーネントだけ、または、ヘルパーやビヘイビアだけを含むプラグインも 作る事が可能で、 他のプロジェクトで簡単に使えるような、再利用できるコンポーネントを作る すばらしい方法にもなり得ます。

このようなコンポーネントを作る事は、実際、通常のアプリケーションとして作る事と同じであり、 特別な命名規則もありません。

プラグインの内部や外部からコンポーネントを参照する方法は、 コンポーネント名の前にプラグイン名を付けるだけです。 例えば、

// 'ContactManager' プラグインのコンポーネントとして定義

class ExampleComponent extends Component {
}

// あなたのコントローラで下記のように呼び出す

public $components = array('ContactManager.Example');

同じテクニックはヘルパーとビヘイビアにも使えます。

// Declare use of AppHelper for your Plugin's Helper

App::uses('AppHelper', 'View/Helper');

プラグインの拡張¶

この例は、プラグインを作るための一つの良い開始方法であって、他にも色んな方法があります。 通常のルールでは、つまりアプリケーションでできることは、プラグインでもできます。

まずは、’Vendor’ にサードパーティのライブラリを設置し、 cake console に新しい shell を追加します。 さらに、利用者が自動で出来る、プラグインの機能をテストするためのテストケースを 作成する事を忘れないでください。

ContactManager の例だと、ContactsController 内に add/remove/edit/delete アクションを作り、 Contact モデルに validation を作成し、contact 管理機能を追加します。 プラグインの改良の仕方もあなた次第で決めれます。 コミュニティ内でコード共有を忘れないので ください。 その誰もが、あなたの素晴らしい、再利用可能なコンポーネントの恩恵を受けることができます！

プラグイン Tips¶

一度、プラグインを /app/Plugin にインストールすると、 /plugin_name/controller_name/action というURLでアクセスできます。 ContactManager の例だと、ContactsController には /contact_manager/contacts でアクセスできます。

CakePHP アプリケーションで動作するプラグインの最後の tips です。

• [Plugin]AppController と [Plugin]AppModel が無ければ、 プラグインコントローラにアクセスしようとすると、 missing Controller エラーになります。

• プラグインのレイアウトは定義可能で、app/Plugin/[Plugin]/View/Layouts に含まれます。 一方でプラグインは、デフォルトは /app/View/Layouts フォルダからレイアウトを利用します。

• コントローラ内で $this->requestAction('/plugin_name/controller_name/action'); と書くと 内部プラグインとコミュニケーションができます。

• requestAction を使う際は、コントローラ名とモデル名がユニークであることを確認してください。 そうしないと、”redefined class ...” エラーが発生します。

• 拡張子であなたのプラグインへのルーティングを追加するとき、アプリケーションのルーティングを 上書きせずに、必ず Router::setExtensions() を使用してください。

プラグインの公開¶

あなたのプラグインを plugins.cakephp.org に追加できますし、 awesome-cakephp list に申し込みできます。

また、composer.json ファイルを作成し、あなたのプラグインを packagist.org に公開してみたくありませんか。 これは Composer を通して簡単にあなたのプラグインが使用できる方法です。

パッケージ名にセマンティックな意味のある名前を選んでください。これは、理想を言えば、 "cakephp" をフレームワークとして依存関係を設定するべきです。 ベンダー名は、通常あなたの GitHub ユーザー名になります。 CakePHP 名前空間 (cakephp) を 使用しない でください。 これは、CakePHP 自身のプラグインのために予約されています。 小文字と区切り文字のダッシュを使用することが決まりです。

もし、あなたの GitHub アカウントが "FooBar" で "Logging" プラグインを作成する場合、 foo-bar/cakephp-logging と名付けるといいでしょう。 そして、CakePHP 自身の "Localized" プラグンは、 cakephp/localized で見つけられます。