tahiryasin/yii-shortcode

yii-shortcode

Yii-shortcode is a component for the Yii PHP framework that provides ability to create WordPress like shortcodes., _(*1)

Usage

Setup

Download the latest release from Yii extensions., _(*2)

Unzip the component under protected/components and add the following to your application config:, _(*3)

return array(
  'components' => array(
    'shortcode' => array(
        'class' => 'application.components.ShortCode',
     ),
  ...
  ...
  ),
);

protected/config/main.php, _(*4)

Registring Shortcodes

You can register as many shortcodes as you want in base controller or in any custom controller:, _(*5)

public function beforeAction($action)
  {
      Yii::app()->shortcode->add_shortcode('gallery', array($this, 'gallery_callback'));
      Yii::app()->shortcode->add_shortcode('caption', array($this, 'caption_callback'));
      return $action;
  }

protected/components/Controller.php, _(*6)

function gallery_callback($atts)
  {
      return "<div id='gallery'>Gallery #{$atts['id']}</div>";
  }  
function caption_callback($atts, $content)
  {
      return '<span class="caption">' . $content . '</span>';
  }  

protected/controllers/SiteController.php, _(*7)

Rendering ShortCode

$content = 'My Gallery: [gallery id="123"]';
echo Yii::app()->shortcode->parse($content);

The output would be: My Gallery: <div id="gallery">Gallery #123</div>, _(*8)

$content= 'Hi, check out this caption: [caption]My Caption[/caption]';
echo Yii::app()->shortcode->parse($content);

The output would be: Hi, check out this caption: <span class="caption">My Caption</span>, _(*9)

protected/views/site/index.php, _(*10)