About Audio Embed Text Formatter

Converts audio file URLs within paragraph tags into HTML5 audio elements.

Category Text Formatters
Textformatter modules that provide run-time formatting for blocks of text (typically used with Text/Textarea fields).
Release StateBeta
Close to stable, but users are advised to be cautious and test thoroughly.*
Authorteppo
Module Version0.1.0
Class NameTextformatterAudioEmbed
Compatibility3.0
Date AddedJuly 23, 2020
Recommended ByNew recommendations may take up to 1 day to appear.

Instructions

This module's files should be placed in /site/modules/TextformatterAudioEmbed/
How to install or uninstall modules

README

Textformatter Audio Embed ProcessWire module

Once enabled, this textformatter looks for audio file URLs and converts those to HTML5 <audio> elements. Works best with RTE (CKEditor) inputs.

Note that URLs need to be the only content within a paragraph tag. You can use an absolute URL or a relative URL, but in the case of relative URLs the path must point to an audio file within /site/assets/files/:

<!-- valid -->
<p>https://www.domain.tld/path/to/file.mp3</p>
<p>/site/assets/files/1/file.mp3</p>

<!-- invalid -->
<p>Dude, where's my https://www.domain.tld/path/to/car.mp3</p>
<p>/some/other/path/file.mp3</p>

Supported audio file formats:

  • .mp3 (audio/mpeg)
  • .ogg (audio/ogg)
  • .wav (audio/wav)