axllent/silverstripe-gfmarkdown

GitHub Flavored Markdown editing & rendering using Parsedown

Installs: 4 759

Dependents: 0

Suggesters: 0

Security: 0

Stars: 6

Watchers: 4

Forks: 5

Open Issues: 0

Type:silverstripe-vendormodule

2.2.7 2023-06-02 10:21 UTC

This package is auto-updated.

Last update: 2024-10-02 01:58:30 UTC


README

This module adds a field and a data type that allows for Markdown editing in the CMS using the Github Flavoured Markdown parser Parsedown to render the html.

It includes the Ace editor for CMS editing.

Requirements

  • Silverstripe ^4.0 || ^5.0

Installation

composer require axllent/silverstripe-gfmarkdown

Usage

Use the Markdown data type as your fields data type, and the MarkdownEditor field in the CMS for editing.

Example:

<?php

use Axllent\Gfmarkdown\Forms\MarkdownEditor;

class MyPage extends Page
{
    public static $db = array(
        'MarkdownContent' => 'Markdown'
    );

    public function getCMSFields()
    {
        $fields = parent::getCMSFields();

        // If you want the Ace markdown editor in the CMS
        $fields->addFieldToTab('Root.Main',
            MarkdownEditor::create('MarkdownContent')
                ->setTheme('github')            // set theme
                ->setRows(20)                   // set number of rows in CMS
                ->setWrap(false)                // disable word wrapping
                ->setHighlightActiveLine(true)  // enable line highlighting
        );

        return $fields;
    }
}

Silverstripe Template:

<div class="content">
    $MarkdownContent  <!-- Will show as rendered html -->
</div>