I love the frozen FOOD.
実際にプラグインを作り始めるときの手順(?)、第一歩(?)的なお話です。
shortcodeを使ったとても簡単なプラグインを1つ作成するのが、ここでの目標です。
実際に仕事などで運用しているサイトで、本記事で紹介する内容を試さないでくださいね。まずはサンプルサイトなど、サイト自体が動作しなくなってもあまり問題ないところでお試しください。
例によって当たり前ですが、損害等が出ても、私は保障しかねます。
プラグインを作成するにあたり、下記のことについて説明していきます。
wordpressのプラグインは、下記のディレクトリに配置することがルールになってます。
php言語で、プラグインを作成していきます。
が、1つお約束事項がでてきます。phpで機能を定義したファイルの冒頭に、定型文字を入れる必要があります。
<?php /* Plugin Name: マーカーサンプルプラグイン Plugin URI: https://www.nemuizo.com/ Description: 指定した文字をボールドにする Version: 0.1 Author: gonzo/Gem-one Author URI: http://www.gem-one.com/ */
wordpressは、この情報をひろって、これがプラグインだということを理解しますので、入れとかないといけません。
尚、ここで記載した内容は、wordpressの管理画面で表示されます。
では実際にプラグインを作成していきます。
が、あまり難しいのだと作成するプラグインの機能説明記事になってしまうので、今回は、簡単なものをつくります。
wordpressの記事中で
あい[mark]うえ[/mark]お
とすると、
あいうえお
と表示されるプラグインとします。
markSampleのディレクトリに、mark.phpという名前で下記のソースを保存します。
<?php /* Plugin Name: マーカーサンプルプラグイン Plugin URI: https://www.nemuizo.com/ Description: 指定した文字をボールドにする Version: 0.1 Author: gonzo/Gem-one Author URI: http://www.gem-one.com/ */ add_shortcode('mark', 'gemone_mark'); /*この名前は、このブログの中で完全にユニークに!*/ function gemone_mark( $atts, $content = null ) { return '<strong>'.$content.'</strong>'; } ?>
ソースを先ほどのディレクトリに保存したら、管理者でwordpressにログインし、プラグインの一覧をみてみてください。
プラグインを保存しただけでは動作しません。「有効化」(活性化)しない限り、wordpress上で動作はしません。
では、早速プラグインを有効化(活性化)してみましょう。
先ほどの「マーカーサンプルプラグイン」の下に「有効化」という文字が見えますよね。そこをクリックしてみてください。
もし、下記のようなメッセージが冒頭にでてくるようであれば、再度、プラグインのソース mark.php を確認してください。ソース、打ち間違えてると思いますよ。
記事を新規作成して、
あい[mark]うえ[/mark]お
と入力してみてください。
プレビュー表示をしてみましょう。
いかがでしょうか?
あいうえお
って出てきましたでしょうか?
インストールしたプラグインを停止する場合の説明です。
有効化と同様、まずはプラグインのリスト表示をします。
先ほど有効化した、markSampleを停止させてみます。
プラグイン作成の大きな枠組み理解いただけたでしょうか?
今回は、ボールドにするだけの簡単な例で恐縮ですけども(笑)
今回は、shortcodeを使った例ですが、
など、アイデア次第で色んなことができますよ。
ご参考になれば!
Gem-one(ジェムワン) 権蔵
Gem-one代表.システム開発業ブランドGem-one adIT、音楽レッスン事業 Gem-one Music設立。ビリヤード・スケジュールサイト すけどんも絶賛運用中。
■ブログ
ちょろっとお時間頂戴