netbeans plugin for wordpress
DESCRIPTION
TRANSCRIPT
NetBeans Plugin for WordPress
for members of WordBench Fukuoka@junichi_11
はじめに
● WordPress用のプラグインはまだ十分な機能
はないので、期待してインストールされた方には
申し訳ないです
● こんなのあればいいのにと思いましたら、
@junichi_11宛にリプライ飛ばしてもらえると、
出来る限りやってみます
NetBeansのインストール
● 公式サイトからNetBeans7.3をダウンロード
http://netbeans.org/downloads/index.html
● 7.2以前のものでは動作しません
● 全部入っていても、PHPだけでもOK(のはず?)
WordPressプラグイン
● ソースコード(github)https://github.com/junichi11/netbeans-wordpress-plugin
● ライセンス (NetBeans本体と同じ)
Common Development and Distribution License (CDDL) v1.0 and GNU
General Public License (GPL) v2
● 更新情報はREADME.mdを参照
WordPressプラグインのインストール1
● Plugin Portalからダウンロード
http://plugins.netbeans.org/plugin/46542/php-wordpress-blog-cms
● ファイル名:てんてんぷるぷる.nbm
● NetBeansからは直接インストールできません
● NetBeans 8.0 or NetBeans 7.3.1で登録予定
(今でも登録することは可能ですが、ビルドバー
ジョンに依存するので、インストールできない言
語があるためです。)
WordPressプラグインのインストール2
● ツール > オプション > プラグイン > ダウンロー
ド済み > プラグインの追加 > nbmファイルを選
択
● 新規WordPressプロジェクトの作成
● Badge Iconの表示
● 重要なファイルフォルダ
● コードテンプレート
● Zip圧縮アクション(ThemeとPluginのみ)
● デバッグステータスの表示と変更
プラグインの機能1
● themesとpluginsへのショートカット
● filterとactionの関数に関するコード補完
● filterとactionの関数に関するハイパーリンク
● 新規テーマ作成アクション(Underscore)
● テンプレートファイル
プラグインの機能2
● コード補完ファイルリフレッシュアクション
(filterとactionに関する補完ファイルをカスタマ
イズした時の機能です。まだ詳しい説明をどこ
にも書いていません)
プラグインの機能3
● WordPressサイトからのDL&展開
(日本語環境であればデフォルトで、日本語サイ
トのlatest.zip)
● ローカルファイルの展開
(デフォルトは何も設定されていません)
● これらのパスはオプションの設定で指定できま
す
新規WordPressプロジェクトの作成
● ツール > オプション > PHP > WordPress
オプションの設定
1. プロジェクトを選択(ファイル > 新規プロジェクト
> PHP > PHPアプリケーション)
2. 名前と場所(プロジェクト名などを設定する)
3. 実行構成(実行方法など)
4. PHPフレームワーク
(WordPress PHP Web Blog/CMS)
新規WordPressプロジェクトの作成
新規プロジェクトの作成
● URLなのかローカルファイルなのか選択
(ローカルファイルの方が展開は速いです)
● Set format to project
(プロジェクトプロパティにフォーマットを設定)
● create wp-config.php
(右側の設定内容のファイルを作成)
● 終了を押下
新規プロジェクトの作成
● プロジェクトの右上にアイコンが表示されます
● javascriptエディタのバグによりエラーアイコン
が表示されています(バグレポート済:未解決)
Badge Iconの表示
● wp-config.phpは重要なファイルに入っていま
す
重要なファイルフォルダ
themes,pluginsショートカット
● オプション > エディタ > コード・テンプレート
プラグインで用意したテンプレートを挿入できます
● wpgpl (GPLライセンス表記)
● wpph (プラグインヘッダ)
● 使い方は wpgpl[Tab] , wpph[Tab]
コードテンプレート
● themes, pluginsの中のフォルダをzip圧縮
● zip化したいノードで右クリック
> WordPress Zip compress
● 圧縮場所はthemes/, plugin/直下
e.g. themes/myplugin.zip
● NetBeans本体にもZip化する機能があるので、
場所を指定したい場合はそちらをどうぞ
Zip圧縮アクション
● wp-config.php内のDEBUG値をステータス
バー(画面の右下)に表示
● クリックすることで変更可能
デバッグステータスの表示と変更
● add_filter('name', 'function_name');
● remove_filter(),add_action(),
remove_action()
第1,2引数の補完候補を表示します
公式サイトのドキュメントをxmlにしているので、そ
こに載っているもの以外は表示されません
filter, actionに関するコード補完
● add_filter('[Ctrl + Space]', 'w[Ctrl + Space]');
● 上記のように、クォーテーション内で補完を実行
● 先頭を少しタイプすると候補が絞られます
● 引数が配列の場合は補完不可能です
filter, actionに関するコード補完
filter, actionに関するコード補完
● フィルタ名と同名の関数があればそこに移動
● Ctrlを押したままフィルタ名をクリック
● 関数名も同様
filter, actionに関するパイパーリンク
● Underscoresのテーマを作成します
● プロジェクト右クリック > WordPress > Create
Theme(_s)
新規テーマ作成アクション(Underscores)
● 公開されているテンプレートをさがしましたが、
見つけたのがこれだけでした
● 人によって違うと思うので、zipファイルを指定で
きるような機能にしようと思います
新規テーマ作成アクション
なぜUnderscores?
● 新規ファイルの作成時に、WordPress用のテン
プレートファイルを選択することができます
● 新規 > その他 > WordPress
テンプレートファイル
テンプレートファイル
● プロジェクト 右クリック > WordPress > Code
Completion Refresh
● 通常は何も起きません
● nbprojectフォルダに指定した形式と名前のxml
ファイルがあるとコード補完時にそちらを読み込
みます
コード補完リフレッシュアクション
● code-completion-action.xml<codecompletion>
<actions><action category="">
<name>hoge_moge</name><description>hogemoge</description>
</action></actions>
</codecompletion>https://gist.github.com/junichi11/5107917#file-code_completion_action-xml
コード補完リフレッシュアクション
● code-completion-filter.xml<codecompletion>
<filters><filter category="">
<name>hoge_moge</name><description>hogemoge</description>
</filter></filters>
</codecompletion>https://gist.github.com/junichi11/5107917#file-code_completion_filter-xml
コード補完リフレッシュアクション
● プロジェクトを開くときに入っていれば、このアク
ションを実行する必要はありません
● gistにデフォルトのテンプレートを置いておきま
す
● xmlでactions,actionなどを使うのではなくて、
entries, entryにすべきでしたが、そのままなの
でいつか変更するかもしれません
コード補完リフレッシュアクション
コード補完リフレッシュアクション
● ハイパーリンクの機能はNetBeansの一般的な
機能なので活用すると便利です
● 関数や変数の宣言に移動することができます
● 方法は同じで
● キャレット位置の関数等の宣言へ移動は
Tips ハイパーリンクについて
Ctrl + クリック
Ctrl + B
● PHPDocを書くことによりIDEが型を認識します
● 補完候補を出したい場合はPHPDocを書きま
しょう
● function宣言のすぐ上の行で/**とタイプしてエン
ターを押せば自動的に@paramなどが作成され
ます
Tips コード補完について
● @global
● @property
● @var
● @return
これらのタグを使うことにより、更に補完が効くよう
になります
Tips コード補完について
/** * hoge * @global $wpdb wpdb */function hoge() { global $wpdb; //$wpdb->[Ctrl + Space]}
Tips コード補完について
@global
関数外の変数に対して補完候補をだすには次の
ようなコメントを書きましょう
/* @var $wpdb wpdb */$wpdb->[Ctrl + Space]
Tips コード補完について
@var
クラスのフィールドを補完/** * @property $Post Post */class Foo {
public function foo(){$this->Post->[Ctrl + Space]
}}
Tips コード補完について
@property
戻り値に対する補完/** * @return Post */public function bar() {}MyClass::bar()->[Ctrl + Space]
Tips コード補完について
@return
● このコミュニティは何?
公式でサポートされてないものをプラグインやド
キュメントを作ってサポートしようじゃないかとい
う集まりです
● 興味があれば下記を参照してください
http://nbphpcouncil.org/
非公式のコミュニティの紹介
NetBeans PHP Community Council
● 今はYii Frameworkのサポートをしています
● 公式でなかなかサポートしてくれない機能等を
サポートするように動いてくれるはずなので、こ
のフレームワークのサポート頼むー、PHPに関
するこんな機能がほしい!などがあれば投げて
みましょう
NetBeans PHP Community Council
● バグを発見した場合は、NetBeansのbugzillaで
はなく、github issueまたは@junichi_11までお
願いします
● 要望等も同じです
最後に
@junichi_11
Thanks for Reading!
ねこび〜ん by カネウチカズコ is licensed under a Creative Commons 表示-継承 2.1 日本 License.