The Phoca MD Fields plugin introduces native Markdown support into Joomla CMS by utilizing the core Custom Fields system. Instead of wrestling with complex WYSIWYG HTML structures, content creators can author documentation, blog posts, and articles using lightweight, human-readable Markdown syntax.
Upon saving, the backend compiler automatically converts the Markdown text into optimized HTML and injects it straight into Joomla's native content fields.
Why Choose Phoca MD?
Phoca MD provides a flexible, dual-purpose approach to content management, adapting perfectly to different editing requirements:
- The Native Markdown Workflow: You work exclusively inside the Markdown field. You do not need to worry about styling, broken HTML tags, or accidental editor formatting shifts. The plugin handles the translation to HTML automatically behind the scenes.
- The Markdown Import Utility: In its simplest scenario, Phoca MD can be utilized as a pure data import tool. If you have documentation written externally in Markdown, you can simply paste it into the Phoca MD field, hit save, and then delete the raw Markdown source. The compiled HTML remains intact within the standard Joomla editor, allowing you to instantly transition back to a traditional WYSIWYG workflow.
Technical Advantages
- Zero Frontend Overhead: The Markdown-to-HTML compilation is executed entirely on the backend during the article saving procedure. Website visitors load standard, pre-rendered HTML, resulting in absolute peak frontend performance.
- Native Joomla Compatibility: Converted articles behave precisely like any core Joomla content. They fully support native categories, tags, standard routing, pagination, and access control levels (ACL). They are Joomla articles.
- Core Search Indexing: Because the data is saved as standard HTML into Joomla’s native introtext and fulltext database schema fields, your content is immediately 100% discoverable by Joomla Smart Search and third-party indexers.
1. Installation
Phoca MD installs via the standard Joomla extension deployment framework:
- Download the plugin archive package (plg_fields_phocamd.zip).
- Navigate to your Joomla Administrator panel.
- Go to System > Install > Extensions.
- Upload or drag and drop the plg_fields_phocamd.zip file. Joomla will verify and complete the installation.
2. Enabling the Plugin
By default, newly installed plugins are disabled. To activate it:
- Go to System > Manage > Plugins.
- Search for Phoca MD using the filter bar.
- Locate Fields - Phoca MD.
- Enable the plugin.
3. Creating the Custom Field
To map the Markdown editor into your article editing workspace, create a dedicated custom field:
- Navigate to Content > Fields.
- Set the top-left context filter to Articles.
- Click the New button in the top toolbar.
- Title: Define a label (e.g., Markdown Content or Raw Documentation).
- Type: Select Phoca MD from the dropdown options.
- Click Save & Close.
4. Usage & Special Configurations
When you open or create a Joomla article, navigate to the Fields tab to locate your new Markdown text area. Once you start typing within the Phoca MD interface, the native Joomla WYSIWYG editor will dim and lock automatically. This safety mechanism prevents asynchronous editing anomalies and ensures your source text remains the single source of truth.
Splitting Content: Introtext vs. Fulltext
Joomla separates article teasers from the main body copy using an explicit layout break. To replicate this core behavior within Markdown, use the ===more=== separator string on an isolated line:
This initial block constitutes the teaser text. It will render on category blogs.
===more===
This subsequent section forms the main body payload, accessible only on the single article view.
Escaping the Separator: If you must mention the text literal ===more=== within your prose (such as in a technical example) without triggering a layout split, escape it by prefixing a backslash: \===more===. The plugin strips the backslash and processes the string as literal text.
Dynamic Title Mapping
Phoca MD includes an advanced option to bridge Markdown metadata with standard Joomla fields. Inside the plugin configuration parameters, you can enable a feature that automatically intercepts the primary Markdown heading (e.g., # Your Document Title) and maps it directly to the native Joomla article Title field upon saving. This eliminates duplicate data entry and enforces semantic heading structures.