PHPとHTMLを使用したサイト制作で、ワードプレスのショートコードのようなものを使用する方法

Question

前提・実現したいこと

ワードプレスを使用せずPHP（CakePHPを使用予定）とHTMLでサイト制作する際に、
ワードプレスの「ショートコード」のような機能を使用する方法はありますか。

タグをテンプレート化し、中身を自由に変更できるようにしたいです。

実現したいこと

入力する内容

[test]りんご[/test]
[test]ばなな[/test]
[test]いちご[/test]

出力結果

<div class="test">りんご</div>
<div class="test">ばなな</div>
<div class="test">いちご</div>

Answer 1

CakePHPの事はあんまり知らないのですが、
CMSの自作の様な事をしたいという前提で回答しますと。

基本

[test]りんご[/test]
[test]ばなな[/test]
[test]いちご[/test]

を入力フォームに入力させて（or HTMLとしてサーバに保存して）

<div class="test">りんご</div>
<div class="test">ばなな</div>
<div class="test">いちご</div>

を出力したいのであれば、

<?php

//再現がめんどくさいので文字列を直接書いていますが、実際にはDBなりHTMLなりから取得して下さい
$post = "[test]りんご[/test]
[test]ばなな[/test]
[test]いちご[/test]";/


$input_tags = ["[test]","[/test]"];
$output_tags = ["<div class='test'>",'</div>'];

echo str_replace($input_tags,$output_tags,$post);

という感じにすれば↓の様な出力になります。

<div class='test'>りんご</div>
<div class='test'>ばなな</div>
<div class='test'>いちご</div>

実際に使うには

もちろん、上記のコードでは[test]と[/test]のみの決め打ちになっており、対応するタグを増やそうとした場合にはコードの追加が必要になります。
これだけだと使いにくいので、

$input_tags = ["[test]","[/test]"];
$output_tags = ["<div class='test'>",'</div>'];

の組み合わせをDBに保存してそこから取得するなどするなどすれば、対応タグを増やすことが出来ます。

よくある機能

よくあるCMSの独自タグだと、これに加えてタグにパラメータを与えたり出来ます

• [test id=1]リンゴ[/test]→おいしくて甘いリンゴ：ふじ
• [test id=2]リンゴ[/test]→小ぶりで真っ赤なリンゴ：紅玉

みたいな感じす。

これを仕様とした場合は、単純なstr_replace()だけだと難しいので、preg_match()等の正規表現を使ってidの値を抜き出してDB処理をするなどの工夫が必要になってきます。

が、まずは単純な置き換えから作ってみるのが良いかと思いますよ。

Answer 2

フレームワークには大体テンプレートエンジンで画面表示を担当させているのでそれっぽいのはあるのですけど、独自のルールとなると自身で変換用のヘルパー作って当てることになると思います。

例にあげられているWordPressも裏では変換用ヘルパーが動作して出力用のhtmlに変換されてると思います。
つまり、テンプレートエンジンのようなものを自作するような難易度ということです。

ただ、コンテンツを作る仕組みが初期から全て提供されているWordPressと、そういう仕組を自前で作るフレームワークでは全く方向性が違う基盤となるので「同じような機能」を探るのはあまり意味がないと思います。