// Zend_Markup_Parser_BbCode をパーサーとして、
// Zend_Markup_Renderer_Html のインスタンスを生成します。
$bbcode = Zend_Markup::factory('Bbcode');
 
// これは単純な 'foo' マークアップを作成するでしょう
// 第一引数は自身のマークアップ名を定義します。
// 第二引数はマークアップの定数で定義された整数を引数に取ります。
// 第三引数は、マークアップについて、マークアップグループと(この例では)開始ならびに終了マークアップのように
// 他のことを配列にて定義します。
$bbcode->addMarkup(
    'foo',
    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
    array(
        'start' => '-bar-',
        'end'   => '-baz-',
        'group' => 'inline'
    )
);
 
// これは 'my -bar-markup-baz-' と出力されるでしょう。
echo $bbcode->render('my [foo]markup[/foo]');

By adding a callback markup, you can do a lot more then just a simple replace of the markups. For instance, you can change the contents, use the parameters to influence the output etc.

A callback is a class that implements the Zend_Markup_Renderer_TokenInterface interface. An example of a callback class:

class My_Markup_Renderer_Html_Upper
    implements Zend_Markup_Renderer_TokenConverterInterface
{

    public function convert(Zend_Markup_Token $token, $text)
    {
        return '!up!' . strtoupper($text) . '!up!';
    }

}

Now you can add the 'upper' markup, with as callback, an instance of the My_Markup_Renderer_Html_Upper class. A simple example:

// Zend_Markup_Parser_BbCode をパーサーとして、
// Zend_Markup_Renderer_Html のインスタンスを生成します。
$bbcode = Zend_Markup::factory('Bbcode');

// これは単純な 'foo' マークアップを作成するでしょう
// 第一引数は自身のマークアップ名を定義します。
// 第二引数はマークアップ型を定義する整数を引数に取ります。
// The third parameter is an array that defines other things about a
// markup, like the markup's group, and (in this case) a start and end markup.
$bbcode->addMarkup(
    'upper',
    Zend_Markup_Renderer_RendererAbstract::TYPE_CALLBACK,
    array(
        'callback' => new My_Markup_Renderer_Html_Upper(),
        'group'    => 'inline'
    )
);

// これは 'my !up!MARKUP!up!' と出力されるでしょう。
echo $bbcode->render('my [upper]markup[/upper]');