ivanamat/cakephp3-markdown

CakePHP 3.x - Markdown

CakePHP 3.x - Markdown

Installation

Composer

You can install this plugin into your CakePHP application using composer., _(*1)

The recommended way to install composer packages is:, _(*2)

composer require ivanamat/cakephp3-markdown

Git submodule

git submodule add git@github.com:ivanamat/cakephp3-markdown.git plugins/Markdown
git submodule init
git submodule update

Load

Component

Load component in the initialize() function, _(*3)

    class MyController extends AppController {

        public function initialize() {
            parent::initialize();

            $this->loadComponent('Markdown.Markdown');
        }

    }

...or load the component in the array of components., _(*4)

    class MyController extends AppController {

        public $components = [
            'Markdown' => [
                'className' => 'Markdown.Markdown'
            ]
        ];

    }

Helper

Load helper in the initialize() function from your View, _(*5)

    class AppView extends View {

        public function initialize() {
            parent::initialize();

            $this->loadHelper('Markdown.Markdown');
        }

    }

Easy to use

Controller

Example: Read .md file on the controller, parse and pass html code to view., _(*6)

    # MyController

    $md = file_get_contents('../README.md', true);
    $html = $this->Markdown->parse($md);
    $this->set(compact('html'));

Helper

Example: Parse Markdown data on the view., _(*7)

    # MyController

    $md = '`This` string `is an example` of **Markdown** code';
    $this->set(compact('md'));

    

    <?php echo $this->Markdown->parse($md); ?>

About CakePHP 3.x - Markdown

CakePHP 3.x - Markdown uses the Parsedown third-party library.
You can download Parsedown from official website: http://parsedown.org/., _(*8)

Author

Iván Amat on GitHub
www.ivanamat.es, _(*9)