Using Speaker Stack WordPress Plugin (Beta)

Last updated: June 15, 2019

Download the Beta

The latest release is 1.0-Beta-3. Download the .zip file, then install the plugin.

Note: this is beta software. Be thoughtful about where you use it. If something seems wrong, disable the plugin and leave feedback at the bottom of this page.

Download Plugin (Version 1.0 - Beta)

Not sure how to install? Use the instructions for uploading or using FTP in this article.

If you’ve used a previous version of Speaker Stack beta, you’ll need to recreate your presentations starting with 1.0-Beta. It takes much less time and effort now. Deactivate and remove the old plugin and add this one.

Creating a Presentation

These instructions are intended to guide you through the most important flows.

1. Install and activate the Speaker Stack Presentations plugin.

2. Go to Settings > Permalinks and click Save Changes. This flushes your permalink rules, which is sometimes needed by WordPress to properly show URLs.

3. Before uploading files, you will need a ConvertAPI key. If you do not have a ConvertAPI account, sign up for a free one. Once logged in, visit your dashboard to copy your “Secret”. Then, add this constant to your wp-config.php file, replacing YOUR_SECRET_HERE with your account Secret.

define( 'SPEAKER_STACK_CONVERTAPI_SECRET', 'YOUR_SECRET_HERE' );

If you do not complete this step, the above message will display in the Preview area for your presentations. Your files will not convert until this is complete.

If you’re unsure of this step, check out this tutorial or ask your nearest web/dev/WordPress person and ask for help.

4. Add a new presentation (Presentations > Add New) and upload your presentation file (PDF (preferred), Powerpoint, or Keynote).

This example shows downloading your own presentation’s file from SlideShare for upload to Speaker Stack.

Click the “Add File” under the Presentation File section to upload.

5. Go ahead and click Save Draft or Publish to get the conversion process started. Once the page reloads, the conversion process will begin automatically. Do not close this window until the conversion process is complete. This can take 5-10 minutes for larger PDF files with high-quality graphics.

6. You can configure your presentation while the file is converting or when it’s done. Note: The number and complexity of options is much lower in the newest beta thanks to feedback and testing.

  • Canonical Sharing URL: this overrides the link in the social sharing feature, seen when you click the “Share” icon under the presentation. You can use a redirect here to track link clicks, but there’s even more speaker-specific magic here—see step 8 for more!
  • File Download URL: this sets the download link shown under the presentation. This will default to your uploaded file hosted on your server or CDN.
  • Javascript Code: this script will run any time the presentation is loaded, no matter where. This is the place to put tracker and analytics codes.
  • Thumbnail Navigation: this activates thumbnail navigation below your presentation.

7. Your preview will automatically appear once conversion is complete.

You can now embed this presentation elsewhere using either the built-in shortcode (for use on self-hosted WordPress sites) or the HTML embed code (for use everywhere else).  The Embed Code is located in the bottom right while editing the presentation.

8. Pro Tip: add a post or page (or any other type of content) in which you can embed your presentation—this is one of the big benefits of Speaker Stack! Add more information about your presentation, add a transcript, add more information about you and your business, or add more relevant resources.

For instance, your post could have a video fo your talk and the Speaker Stack presentation side-by-side, with an overview of the presentation below.

 

Then, click Publish. The link to this post or page can be your new “Canonical Sharing URL”. Paste the link back into the Canonical Sharing URL field in your presentation and Update.

Reminders

The embedded presentation template attempts to strip out CSS to prevent styling conflicts. However, it will load any Javascript that you’ve included in your WordPress frontend: through your theme, plugins, or manual code. This enables you to use your own analytics or retargeting tools no matter where your presentation is shown, including in Twitter cards.

If you’d like to activate Twitter Card support, test a canonical URL (a link with a presentation embedded) on Twitter’s Card Validator. Request approval for whitelisting.

Current Limitations + Workarounds

PDF upload functionality is being slow—it will be fixed soon. Instead, export your presentations as images through PowerPoint or Keynote, or use an online conversion tool:

Requests have been loud and clear for uploading not only PDF, but PowerPoint and Keynote files. This is planned.

The most recent beta now takes PDF, Keynote, and PowerPoint files only. You no longer need to convert your file to images.

The auto-sizing for Twitter cards doesn’t do well with 4:3 presentations yet. That will be fixed soon as well.

Responsive embed sizing has been improved across the board.

Twitter card support will not work on canonical URLs when the presentation shortcode is nested within other shortcodes.

Feedback






Scroll to Top