Nick Halsey

<p>WordPress supports featured images out of the box, allowing images to represent posts in various ways defined by the theme. This plugin adds similar support for audio, allowing musicians, podcasters, and anyone who publishes audio with WordPress to feature audio files on posts and pages in a structured way. Each post and page gets a featured audio metabox where an audio file can be uploaded or selected from the media library.</p>
<p>By default, featured audio is displayed at the top of posts and pages <code>(within the_content)</code>. Developers can change this by adding theme support for <code>featured-audio</code>, via several API functions listed below.</p>
<p>Why use featured audio instead of embeding audio directly into posts? Featured audio organizes the content in a structured way, alowing infinite possibilities to customize the way users experience audio content on your site. The plugin ships with one example of this – the featured audio playlist widget. Add this widget to your sidebar and it’ll automatically display a playlist of all of the audio files featured on posts shown on the current view, on views with more than one post such as the main blog page or a category page. The plugin also supports a recent audio playlist widget, which behaves similarly to a latest posts widget.</p>
<p>For a more comprehensive way to manage <em>music</em> with WordPress, particularly if you need to include sheet music alongisde audio, see the <a href="https://wordpress.org/plugins/sheet-music-library/" rel="ugc">Sheet Music Library</a> plugin.</p>
<h3>Developer API Functions</h3>
<h4>Add Theme Support</h4>
<pre><code>add_theme_support( 'featured-audio' )
</code></pre>
<p>Adding theme support for featured audio tells the plugin not to add the featured audio to the content automatically. Instead, you can add featured audio exactly where you want it with <code>the_featured_content()</code> (see below for details).</p>
<h4>Change Supported Post Types</h4>
<p>By default, the <code>post</code> and <code>page</code> post types are supported. You can use the <code>featured_audio_post_types</code> filter to modify this list. For example:</p>
<pre><code>add_filter( 'featured_audio_post_types', 'prefix_featured_audio_post_types' );
function prefix_featured_audio_post_types( $post_types ) {
    // Add support to the sheet_music post type.
    $post_types[] = 'sheet_music';

    // Overwrite the entire list to remove support on pages.
    $post_types = array( 'post' );

    return $post_types;
}
</code></pre>
<h4>the_featured_audio( $args )</h4>
<p>Display the featured audio, if it exists.</p>
<p>Parameters:</p>
<pre><code>$args                   array   Display options.
$args['id']             int     Post id (optional). Defaults to current post id. 
$args['album_art']      boolean Whether to display the album art for the featured audio cycle. Default: false.
$args['album_art_size'] string  Size to use for the album art picture. Default: thumbnail.
$args['title']          boolean Whether to display the title of the audio attachment. Default: false.
</code></pre>
<h4>get_the_featured_audio( $args )</h4>
<p>Get the featured audio, if it exists, as a string. Has the same arguments as <code>the_featured_audio()</code>.</p>
<h4>get_featured_audio_src( $id )</h4>
<p>Returns the url of the featured audio file, if it exists.</p>
<p>Parameter:</p>
<pre><code>$id int Post id (optional). Defaults to current post id.
</code></pre>
<h4>get_featured_audio_attachment_id( $id )</h4>
<p>Returns the id of the featured audio attachment, if it exists.</p>
<p>Parameter:</p>
<pre><code>$id int Post id (optional). Defaults to current post id.
</code></pre>
<h4>get_the_featured_audio_playlist()</h4>
<p>Get the featured audio playlist, if there are multiple posts with featured audio in the current query. Used by the featured audio playlist widget.</p>
<h4>the_featured_audio_playlist()</h4>
<p>Displays (echoes) <code>get_the_featured_audio_playlist()</code>.</p>


Featured Audio

Add featured audio to your posts and pages, like featured images.

mark asquith

<p>Captivate Sync™ is a WordPress plugin maintained and developed by Captivate, part of the Rebel Base Media family. With our background in Podcast Websites, WordPress development and podcast hosting, hundreds of independent podcasters trust Captivate Sync™ and Captivate to power their podcast brands everyday.</p>
<p>Captivate Sync™ is totally free to use and connects seamlessly to your Captivate podcast hosting account.</p>
<p>Captivate Sync™ helps you to publish and manage your Captivate podcasts directly within your WordPress dashboard. It’s designed to save you hours of time and shave off the manual processes that come with running a podcast, so you can focus your energy on creating your show:</p>
<ul>
<li>Complete integration with Captivate, the world’s only growth-oriented podcast host</li>
<li>Manage and display your podcast episodes inside your WordPress account</li>
<li>Edit, view, share and delete podcast episodes from WordPress and see changes reflected in your Captivate dashboard immediately</li>
<li>Use custom shortcodes and page mapping to decide how and where your episodes display on your website</li>
<li>Easy, enhanced customizations and team settings to make managing a team or multipple podcasts a breeze</li>
<li>Fully compatible with all major WordPress builders and themes</li>
</ul>
<h3>Full Captivate Sync™ features</h3>
<h4>Show and episode-level podcast management</h4>
<ul>
<li>Manage multiple podcasts and podcast episodes without leaving WordPress</li>
<li>Publish, schedule, edit and draft podcast episodes</li>
<li>Automatically insert the fully responsive Captivate podcast player wherever you need it</li>
<li>Use custom page mapping to create bespoke website content that reflects your brand, business or network</li>
<li>Choose whether to hide or display custom links and set bespoke calls to action</li>
<li>Edit or disable your comments section</li>
</ul>
<h4>Easy enhanced customization with shortcodes</h4>
<ul>
<li>Automatically embedding your podcast players has always been easy with Captivate Sync™, but now you have full control over how people listen to your episodes with our Shortcode builder.</li>
<li>Use list view to display a feed-like list of episodes, or use grid view to choose either 2, 3, 4, 5, 6 column layouts to suit your website’s look and feel.</li>
<li>Change your featured image and podcast player position to best suit your brand and theme</li>
<li>Add custom CSS to your shortcodes for consistent branding throughout your podcast website</li>
</ul>
<h4>Customize your team settings</h4>
<ul>
<li>Customize and restrict access to specific podcasts to stop certain users publishing or editing content</li>
<li>Set default authors</li>
</ul>
<h4>Complete integration with Captivate, the world’s only growth-oriented podcast host</h4>
<ul>
<li>Unlimited podcasts and uploads</li>
<li>Distribute your podcast to Apple Podcasts, Google Podcasts, Spotify, Amazon and all other major podcast platforms</li>
<li>Fully responsive, customizable podcast players</li>
<li>Free, built-in podcast websites</li>
<li>Private RSS feeds on any plan</li>
<li>Innovative marketing tools to help you grow and promote your podcast episodes</li>
<li>One-click PDF sponsor kit</li>
<li>…and LOADS more! <a href="https://www.captivate.fm/features/" rel="nofollow ugc">Check out the full feature list</a>.</li>
</ul>
<h4>How to install Captivate Sync™</h4>
<p>Setting up the Captivate Sync<strong>™</strong> plugin is a quick process with just two steps. First, you’ll need to <strong>install</strong> the plugin, then <strong>authenticate</strong> the integration.</p>
<ol>
<li>Install Captivate Sync<strong>™</strong> from the WordPress repository. Then, head to your <em>Plugins</em> tab, find Captivate Sync<strong>™</strong> and click <em>Activate.</em></li>
<li>Head on over to your Captivate dashboard. Click <em>My Account,</em> and then click <em>Reveal API key.</em></li>
<li>Back in WordPress, paste the <em>User ID and API key</em> into the relevant boxes within Captivate Sync™.</li>
</ol>
<p>If you need more guidance, we’ve put together <a href="https://help.captivate.fm/en/articles/2761714-how-to-authenticate-captivate-sync-after-installation" rel="nofollow ugc">full instructions and video steps</a>.</p>
<h4>How to find help</h4>
<p>For help with Captivate Sync™, take a look at the FAQs and step-by-step guides in our <a href="https://help.captivate.fm" rel="nofollow ugc">help section</a>. If you can’t find the answers you need, reach out to us on the <a href="https://wordpress.org/support/plugin/captivatesync-trade/" rel="ugc">support forum</a> or get in touch via the chat feature on the <a href="https://my.captivate.fm/" rel="nofollow ugc">Captivate dashboard</a>.</p>
<h3>Support</h3>
<p>https://help.captivate.fm</p>
<h3>Twitter</h3>
<p>http://twitter.com/captivateaudio</p>


Captivate Sync

Captivate Sync™ is a WordPress plugin maintained and developed by Captivate, part of the Rebel Base Media family. With our background in Podcast Websi …

Featured Audio vs Captivate Sync