romaninsh/mdcms

Markdown CMS for Agile Toolkit

Markdown CMS

This is a plugin for Agile Toolkit, which will greatly help you to display Markdown content on your pages. To use it, add this to your Frontend.php / init():, _(*1)

$this->add('romaninsh/mdcms/Controller');

then create "content" folder inside your interface folder, _(*2)

frontend
  + page
  + lib
  + public
  + content

Create content/hello.md then open frontend/public/hello in your browser and you should see your markdown there displayed in real-time., _(*3)

Features and Components

This plugin can be integrated in various ways. The integration above is a full integration, but you can also use individual components., _(*4)

• Application Controller - Full-featured integration, one-line use.
• romaninsh/mdcms/Page - Extension to page capable of mixing regular templates with Markdown.
• {markdown} .. {/} - Allows you to embed markdown inside regular ATK template
• {markdown_include}disclaimer{} - Include markdown file. I recommend to start includes with underscore, this way they can't be accessed directly.

Mapping images and URLs

To link to a ATK page using url() wrapper, use {page}my-page{/} inside your Markdown. This will be replaced automatically with a proper URL., _(*5)

To include a link to a public image use ![image], the URL will be converted using locateURL('public', $url) automatically. I recommend that you place your images inside content/images and symlink it into public/images. Using will properly work inside your text editor and on your site., _(*6)

Caching

This add-on has a support for Models. This enables use of transparent caching and / or storing templates in a dedicated storage. For example to store templates in memcache, the following can be used:, _(*7)

$this->add('romaninsh/mdcms/Controller')
    ->setModel('romaninsh/mdcms/Model')
    ->setSource('Memcached');

Resource

The .md files are stored inside 'content' folder by default, but you can add more through adding more extensions through pathfinder. The resource type is content., _(*8)