Hooks and Filters

Filters

wpdjot_pre_convert

Modify Djot content before conversion to HTML.

add_filter('wpdjot_pre_convert', function(string $djot): string {
    // Modify $djot before conversion
    return $djot;
});

wpdjot_post_convert

Modify HTML after conversion from Djot.

add_filter('wpdjot_post_convert', function(string $html): string {
    // Modify $html after conversion
    return $html;
});

wpdjot_converter

Customize the Djot converter instance. Useful for adding custom render handlers.

add_filter('wpdjot_converter', function(\Djot\DjotConverter $converter, string $context): \Djot\DjotConverter {
    // $context is 'article' or 'comment'
    // Add custom render handlers, modify settings, etc.
    return $converter;
}, 10, 2);

wpdjot_converter_{post_type}

Post-type specific converter customization (e.g., wpdjot_converter_post, wpdjot_converter_page).

add_filter('wpdjot_converter_page', function(\Djot\DjotConverter $converter, string $context): \Djot\DjotConverter {
    // Custom handling for pages only
    return $converter;
}, 10, 2);

wpdjot_htmlpurifier_config

Customize HTMLPurifier configuration for comment sanitization. Only applies when HTMLPurifier is installed.

add_filter('wpdjot_htmlpurifier_config', function(\HTMLPurifier_Config $config): \HTMLPurifier_Config {
    // Allow additional HTML elements/attributes
    $config->set('HTML.Allowed', 'p,br,strong,em,a[href|title|rel],iframe[src|width|height],...');
    return $config;
});

wpdjot_allowed_html

Customize allowed HTML tags for wp_kses sanitization (fallback when HTMLPurifier is not installed).

add_filter('wpdjot_allowed_html', function(array $allowed): array {
    // Allow iframes for embedded content
    $allowed['iframe'] = [
        'src' => true,
        'width' => true,
        'height' => true,
        'frameborder' => true,
        'allowfullscreen' => true,
    ];
    return $allowed;
});

wpdjot_load_mermaid

Whether the Mermaid library is enqueued for the current request (only evaluated when the Mermaid setting is enabled - the filter cannot turn Mermaid on). By default it loads only when a post in the main query mentions mermaid in its source; return true to force-load it for content rendered outside the main query (widgets, page builders).

add_filter('wpdjot_load_mermaid', fn (bool $needed): bool => $needed || is_page('diagrams'));

Examples

Add Custom CSS Class to All Code Blocks

add_filter('wpdjot_post_convert', function(string $html): string {
    return str_replace('<pre><code', '<pre class="my-code"><code', $html);
});

Replace Custom Shortcodes Before Conversion

add_filter('wpdjot_pre_convert', function(string $djot): string {
    // Replace {{date}} with current date
    return str_replace('{{date}}', date('Y-m-d'), $djot);
});

Add Wrapper Div for Styling

add_filter('wpdjot_post_convert', function(string $html): string {
    return '<div class="djot-wrapper">' . $html . '</div>';
});