TextformatterRockDown by bernhard

ProcessWire Textformatter for simple WhatsApp style text formatting (*bold*, _italic_, ~strike~, ```mono```

TextformatterRockDown

ProcessWire Textformatter for simple markdown-like text formatting ideal for headlines:

*bold*
_italic_
~strike~
```monospace```
#monospace#

This module does intentionally not support full markdown syntax! It is intended to be used for simple formattings that you usually want to apply to headlines.

Problem


The title field is always available in ProcessWire and it is often used for page headlines. But unfortunately when using such a plain textfield it will not be possible to print some words in bold or italic font.

One solution is to create a CKEditor/TinyMCE field, but it's a lot more tedious to setup. Also it's not easy to make it single-line-only.

Solution


Just apply this textformatter to your field and you'll get quick and easy headlines with bold and italic fonts that will also work with frontend editing.

Backend Editing:

68747470733a2f2f692e696d6775722e636f6d2f734770715a504f2e706e67

Frontend Editing:

68747470733a2f2f692e696d6775722e636f6d2f414333366d65322e706e67

Formatted:

68747470733a2f2f692e696d6775722e636f6d2f4b52556a42337a2e706e67

Usage


Just install the module and add TextformatterRockDown to the field you want to apply it to:

68747470733a2f2f692e696d6775722e636f6d2f41303746656f432e706e67

Then just output the field's value in your template files as usual:

echo $page->title; // plain
echo $page->edit('title'); // fontend editable

Custom tags


You can add custom replacements easily via hook in /site/ready.php

// @something@ --> <span style="color:red;">something</span>
$wire->addHookAfter("TextformatterRockDown::replace", function ($event) {
  $str = $event->arguments(0);
  $start = $event->arguments(1);
  $end = $event->arguments(2);
  $tag = "@"; // set your tag here
  $str = preg_replace(
    "/$start{$tag}(.*?){$tag}$end/",
    "$1<span style=\"color:red;\">$2</span>$3",
    $str
  );
  $event->return = $str;
});

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #554
    In the 554th issue of ProcessWire Weekly we'll check out the latest core updates, introduce a couple of new third party modules, and more. Read on!
    Weekly.pw / 21 December 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 2024
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull