WordPress Plugin
[ documentation ]

Getting Started

Installing and Using the WordPress bundle is simple. All it takes is three simple steps:

  1. Upload the plugin to your WordPress site and activate it (go to this step)
  2. Configure (go to this step)
  3. Add players via shortcodes (go to this step)

1. Upload & Activate

Click, Click, done.

In your WordPress admin panel, go to Plugins / Add New

Click "Upload Plugin", "choose file", and find and select the zip file beHeardWP.zip

Activate the player in Settings / Be Heard! Podcast Player by clicking "Activate"

2. Configure

set smart defaults, override later (if needed)

Configure the player in Settings / Be Heard! Podcast Player

3. Create Shortcodes

Add players to your pages

Here's a bare-minimum Be Heard! shortcode:

[bhplayer name="Awesome Sauce 21" src="http://path-to-your-episode-file.mps"]

Both name and src are required parameters. Without either of these no player will show.

Otherwise, there are a number of optional shortcode parameters that can be used to override player defaults (set above in step 2).

podcast                 # name of podcast (unlikely ever needed to override default)
color                   # player background color
btnShare                # share button toggle
btnDownload             # download button toggle
btnSpeed                # playback rate button toggle
btnSkip                 # forward/backward (10 seconds) buttons' toggle
shareURL                # the url used for share button (defaults to page player is on)
headingShareIcons       # heading above share icons (in share modal)
headingShareURL         # heading above share url (in share modal)
shareOnTwitter          # twitter share button toggle
shareOnFacebook         # facebook share button toggle
shareOnGPlus            # google+ share button toggle
shareOnPinterest        # pinterest share button toggle
ctaEndToggle            # call to action (cta) at end of episode toggle
ctaEndTriggerSecLeft    # when to trigger the end of play CTA (in seconds of episode left)
ctaEndHeading           # end of play CTA heading
ctaEndLinkText          # end of play CTA link text
ctaEndLinkURL           # end of play CTA link url
ctaEndLinkOpenNew       # end of play CTA link open in new window toggle
ctaEndCustomHTML        # end of play CTA custom HTML (will override any above CTA content settings)

Here's an example shortcode using all the available parameters (note: new lines for each parameter used here for easy reading, yours shouldn't have new lines):

[ bhplayer
    color="#000000"
    btnShare="true"
    btnDownload="false"
    btnSpeed="true"
    btnSkip="true"
    shareURL="http://site.com/special-episode-link"
    headingShareIcons="Please Share!"
    headingShareURL="Copy & Paste"
    shareOnTwitter="true"
    shareOnFacebook="true"
    shareOnGPlus="false"
    shareOnPinterest="false"
    ctaEndToggle="true"
    ctaEndTriggerSecLeft="37"
    ctaEndHeading="Thanks for Listening!"
    ctaEndLinkText="Visit us on Twitter"
    ctaEndLinkURL="http://twitter.com/handle"
    ctaEndLinkOpenNew="true"
    ctaEndCustomHTML="<h1>Sweet!</h1><h2>You've just finished an episode</h2><p>Want to stay in touch? <a>Go Here to Join our Email List.</a></p>"
]

To complete the example, that same shortcode above would look like this in your WordPress editor:

[bhplayer color="#000000" btnShare="true" btnDownload="false" btnSpeed="true" btnSkip="true" shareURL="http://site.com/special-episode-link" headingShareIcons="Please Share!" headingShareURL="Copy & Paste" shareOnTwitter="true" shareOnFacebook="true" shareOnGPlus="false" shareOnPinterest="false" ctaEndToggle="true" ctaEndTriggerSecLeft="37" ctaEndHeading="Thanks for Listening!" ctaEndLinkText="Visit us on Twitter" ctaEndLinkURL="http://twitter.com/handle" ctaEndLinkOpenNew="true" ctaEndCustomHTML="<h1>Sweet!</h1><h2>You've just finished an episode</h2><p>Want to stay in touch? <a>Go Here to Join our Email List.</a></p>"]

In practice, you should never have a need for such a long Be Heard! shortcode. Defaults for all of these (except name and src) are set in the defaults and you shouldn't ever have to override all the defaults.