<p>This plugin displays the content of a file in a post. The content of the file<br />
(called a “snippet”) is put in a <code><pre></pre></code> block by default.</p>
<p>It has the following advantages over pasting the content of the file in your post<br />
yourself:</p>
<ul>
<li>When the file is modified, no need to modify the posts referring to it</li>
<li>Indentation is preserved by default (useful to show code snippets)</li>
<li>Can optionally provide a link to the file (no need to copy-paste your snippet)</li>
</ul>
<p>If requested (see the <code>preserveformat</code> parameter), the content of the file<br />
is put in a <code><div></div></code> block, with each line (delimited by<br />
the carriage return) in its own <code><p></p></code> block.</p>
<h4>Usage</h4>
<p>Syntax: <code>[file lang="some_lang" start="a_line_number" end="a_line_number" link="on_or_off" style="some_style_properties" preserveformat="on_or_off"]path/to/your/file[/file]</code></p>
<p>Note: The order of the attributes is mandatory!</p>
<h4>Example: Inlining of a file</h4>
<p>In your post, write <code>[file]path/to/your/file[/file]</code>. That’s it!</p>
<h4>Example: Using a syntax highlighter plugin</h4>
<p>If you write <code>[file lang="cpp"]path/to/your/file[/file]</code> (for instance),<br />
and if the syntax highlighter plugin you use supports<br />
the <code><pre lang="*"></pre></code> syntax (most does), then the content<br />
of your file will be processed by the syntax highlighter plugin as usual.</p>
<h4>Example: Provide a link to the file</h4>
<p>If you write <code>[file link="on"]path/to/your/file[/file]</code>, a link will<br />
be automatically added to the top left of the text area.</p>
<h4>Example: Inline a subset of a file</h4>
<p>If you write <code>[file start="10" end="20"]path/to/your/file[/file]</code>,<br />
only the lines 10 to 20 of the file will be displayed. You can omit the start<br />
(ie. “from beginning to line 20”) or the end (ie. “from line 10 to the end of<br />
the file”) if you want.</p>
<h4>Example: Set the color of the text to red</h4>
<p>In your post, write <code>[file style="color: #FF0000;"]path/to/your/file[/file]</code>.</p>
<h4>Example: Prevent the plugin to process a [file][/file] block</h4>
<p>Just write <code>[file off]your content[/file]</code>.</p>
<p>Note: The ‘off’ attribute must come BEFORE any other ones.</p>


File Inliner

This plugin displays the content of a file in a post.

Joop Laan

<p><strong>Inline Context</strong> is a powerful Block Editor enhancement that lets you create inline expandable notes or clean tooltip-style popovers anywhere in your content. It is ideal for <strong>content-rich websites</strong>, including editorial platforms, research sites, online magazines, documentation hubs, and educational blogs that rely on clear explanation without breaking the reader’s focus.</p>
<p>Instead of sending readers to glossary pages or external links, Inline Context allows you to provide definitions, references, clarifications, and annotations <em>in place</em> — keeping readers engaged and your content structured.</p>
<p>Notes can be <strong>reusable</strong>, categorized, styled, centrally managed, and automatically updated everywhere they appear.</p>
<p><a href="https://wordpress.org/plugins/inline-context/?preview=1" rel="ugc">Check the live preview</a></p>
<h4>Why this is valuable for content-heavy websites</h4>
<p>Websites with substantial text often need:</p>
<ul>
<li>definitions and terminology</li>
<li>source references</li>
<li>background information</li>
<li>contextual inline explanations</li>
<li>mini footnotes without scrolling</li>
<li>inline callouts, tips, or warnings</li>
</ul>
<p>Inline Context delivers all of this with a frictionless, accessible user experience. It helps readers stay focused, reduces navigation fatigue, and improves knowledge retention — especially in long articles or research-based content.</p>
<h4>How it works</h4>
<ol>
<li>Highlight text in the Block Editor.</li>
<li>Click <strong>Inline Context</strong>.</li>
<li>Enter your note content (rich text supported).</li>
<li>Optionally assign a category with custom icon & color.</li>
<li>Publish — your note appears inline or as a tooltip, depending on settings.</li>
</ol>
<p>You can also create <strong>reusable</strong> notes from a dedicated Custom Post Type. Updating a reusable note updates all instances site-wide.</p>
<h3>Key Features</h3>
<h4>Display modes</h4>
<ul>
<li>Inline expansion (reveals a small content panel)</li>
<li>Tooltip popovers (floating contextual bubbles)</li>
<li>Smart tooltip positioning to avoid off-screen display</li>
<li>Direct anchor links (<code>#context-note-xxx</code>) for deep linking</li>
<li>Auto-open on page load when accessed via link</li>
</ul>
<h4>Editor productivity</h4>
<ul>
<li>Reusable notes with global updates</li>
<li>Notes Library with usage tracking (shows where each note is used)</li>
<li>Quick Search inside the editor to insert existing notes</li>
<li>Rich text support via ReactQuill (bold, italic, lists, links)</li>
<li>Clean, integrated Rich Text toolbar button</li>
</ul>
<h4>Categories & icons</h4>
<ul>
<li>Create unlimited categories (Definition, Reference, External Article, Tip, Warning, etc.)</li>
<li>Choose from curated Dashicons or any of 300+ icons</li>
<li>Separate icons for open and closed states</li>
</ul>
<h4>Styling & customization</h4>
<p>Full styling control from <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Inline Context</strong>:</p>
<ul>
<li><strong>NEW in v2.6</strong>: Five pre-configured color presets for one-click professional styling</li>
<li>Choose from Modern Blue, Minimalist Gray, High Contrast, Warm Earth Tones, or Dark Mode</li>
<li>All presets meet WCAG 2.1 AA accessibility standards</li>
<li>Link colors, hover, and focus states</li>
<li>Note padding, spacing, borders, backgrounds, shadows</li>
<li>Tooltip appearance</li>
<li>Chevron/indicator styling</li>
<li>Live interactive preview of all style changes</li>
</ul>
<h4>Accessibility & security</h4>
<ul>
<li>ARIA support, focus lock, Escape key behavior</li>
<li>Keyboard-navigable for both link and note</li>
<li>DOMPurify sanitization of note content</li>
</ul>
<h3>Internationalization</h3>
<p>Inline Context is fully translation-ready.</p>
<h3>Examples & inspiration</h3>
<p>The idea for this plugin originated from a project with Renée Kool — a visual artist working in public art, film, and emerging media. She wanted to create a website where a single link could reveal additional content containing multiple related links. We looked at the Dutch journalism platform De Correspondent, which use subtle inline notes to provide context without interrupting the flow of reading. You can see examples of their inline notes in this article: <a href="https://decorrespondent.nl/15887/hoe-nederland-kampioen-deeltijdwerken-werd/9053b712-3591-0002-29b3-8c7b69eae0c3" rel="nofollow ugc">Hoe Nederland kampioen deeltijdwerken werd</a></p>
<h3>Source code</h3>
<p>Inline Context uses <code>@wordpress/scripts</code> with webpack and npm to build assets.</p>
<p>Full source (including uncompiled JS and CSS) is available at:<br />
<a href="https://github.com/jooplaan/inline-context" rel="nofollow ugc">https://github.com/jooplaan/inline-context</a></p>


Inline Context

Add inline expandable notes or tooltips to provide context, definitions, and references without disrupting the reading flow.

File Inliner vs Inline Context