Installation

Install the PolillaStudio.Blank plugin through the OctoberCMS backend or attach to your project. Once installed, all filters are immediately available in your Twig templates.

Available Filters

blank Filter

Automatically adds target="_blank" attribute to all links in HTML content.

Usage:

{{ content | md | blank }}

Example:

<!-- Input -->
{{ "Visit [our website](https://example.com) for more info" | md | blank }}

<!-- Output -->
<p>Visit <a href="https://example.com" target="_blank">our website</a> for more info</p>

md_line Filter

Processes Markdown content without wrapping it in paragraph tags, ideal for inline content.

Usage:

{{ content | md_line }}

Example:

<!-- Input -->
{{ "**Bold text** with *italic*" | md_line }}

<!-- Output -->
<strong>Bold text</strong> with <em>italic</em>

json_decode Filter

Converts JSON strings to PHP arrays for use in Twig templates.

Usage:

{{ jsonString | json_decode }}

Example:

<!-- Input -->
{% set data = '{"name": "John", "age": 30}' | json_decode %}
{{ data.name }} is {{ data.age }} years old

<!-- Output -->
John is 30 years old

mdclass Filter

Extends Markdown with custom CSS class injection using [text | class] syntax.

Usage:

{{ content | mdclass }}

Example:

<!-- Input -->
{{ "This is [highlighted text | highlight] in a paragraph" | mdclass }}

<!-- Output -->
<p>This is <span class="highlight">highlighted text</span> in a paragraph</p>

Advanced Example:

<!-- Input -->
{{ "**Bold text** with [custom styling | accent-text] and normal text" | mdclass }}

<!-- Output -->
<p><strong>Bold text</strong> with <span class="accent-text">custom styling</span> and normal text</p>

Filter Combinations

Filters can be chained together for powerful content processing:

{{ content | mdclass | blank }}

This will process custom classes first, then add target="_blank" to any generated links.

Best Practices

• Use md_line for headings, buttons, and inline content
• Apply blank after md or mdclass for proper link processing
• Sanitize user input before using json_decode
• Use semantic CSS class names with mdclass for maintainable styling

Questions or bug reports

- We are happy to help!

Send us an email to hello@polilla.studio and we'll reply you as soon as we can.

Or you can visit GitHub Issues Page to report any issues with plugin.