Markdown extension for phpBB

Markdown extension for phpBB.

Build Status Latest Stable Version Code Quality Translation Progress License

Allows you to write Markdown text in posts, signature or private messages and it will be converted as HTML. It can be used instead of or alongside BBCodes.

It uses the plugins Litedown, PipeTables and TaskLists from the s9e/TextFormatter library.

Features

  • Use Markdown in posts, personal messages and signatures
  • Can be used instead of or alongside text formatted with BBCode
  • Configuration to enable/disable the use of Markdown globally in the ACP
  • Configuration to enable/disable the use of Markdown per user in the UCP
  • Set per user group permissions to use Markdown
  • Set per forum permissions to use Markdown
  • Posting option to disable Markdown only in the current message
  • Add help page to explain users how write messages in Markdown
  • Add indentation when pressing the Tab key inside Markdown code blocks

Preview

Board features Post settings Private message settings Signature settings Post group permissions Profile group permissions Private messages group permissions Forum permissions User posting defaults Markdown post Markdown private message Markdown signature Posting editor option Task list

(Click to view in full size)

Requirements

  • PHP 7.1.3 or greater
  • phpBB 3.3 or greater

Support

If you like or found my work useful and want to show some appretiation, you can consider donating.

Installation

  • Download the latest release
  • Decompress the *.zip or *.tar.gz file
  • Copy the files and directories inside {PHPBB_ROOT}/ext/alfredoramos/markdown/
  • Go to your Administration Control Panel > Customize > Manage extensions
  • Click on Enable and confirm

Configuration

Administrator

To enable or disable globally:

  • Go to your Administration Control Panel > Board features > Allow Markdown
  • Click on Submit

To change forum permissions:

  • Go to your Administration Control Panel > Permissions > Forum permissions
  • Select the forums and click on Submit
  • Select the users or groups and click on Edit permissions
  • Select the users or groups and click on Advanced Permissions
  • Go to Content and enable the Can use Markdown permission
  • Click on Apply all permissions

To change user group permissions:

  • Go to your Administration Control Panel > Permissions > Group permissions
  • Select the group and click on Submit
  • Click on Advanced permissions
  • Go to Post and Private messages and enable the Can use Markdown permission
  • Click on Apply all permissions

User

To change default posting settings:

  • Go to your User Control Panel > Board preferences > Posting defaults
  • Enable the option Enable Markdown by default
  • Click on Submit

To disable Markdown only in the current message (post, signature or private message):

  • Go down to the posting editor options
  • Check the option Disable Markdown
  • Click on Preview or Submit

Uninstallation

  • Go to your Administration Control Panel > Customize > Manage extensions
  • Click on Disable and confirm
  • Go back to Manage extensions > Markdown > Delete data and confirm

Upgrade

  • Go to your Administration Control Panel > Customize > Manage extensions
  • Click on Disable and confirm
  • Delete all the files inside {PHPBB_ROOT}/ext/alfredoramos/markdown/
  • Download the new version
  • Upload the new files inside {PHPBB_ROOT}/ext/alfredoramos/markdown/
  • Enable the extension again