WordPress.org

How do I activate the automatic site integration?

On the WDTS Introduction page, check Enable automatic transcript embedding. Some themes do not play nicely with this embedding by default, so you may be asked to enable Inject transcripts at level 100 instead of level 15 on the Misc. Options page.

How do I import my legacy transcripts?

If you were using a theme, such as ComicPress, that supports storing transcripts in the "transcript" post metadata field, you can now import all of those transcripts into What Did They Say?!? and gain improved control over your transcripts. Under the Tools menu is an option called "Import Transcripts." You can import your legacy transcripts from there. Be sure to back up your database first!

How do I add transcript excerpts to search results?

In the appropriate place in your search results Loop, add the following Template Tag:

<?php if (function_exists('the_matching_transcript_excerpts')) {
  the_matching_transcript_excerpts();
} ?>

How do I create my own transcript filters and styles?

There are two ways to do it:

• If the new filters and styles are for one particilar theme, add your filters and styles to that theme's functions.php.
• If the new filters and styles will go on different themes, or you want to distribute them, add them to the wp-content/transcript-filters directory.

If you're using the wp-content/transcript-filters directory, use the following process. This requries some technical knowledge:

• Create a new directory for your filter, using only lowercase characters, the numbers 0-9, dashes, and underscores.
• Inside of this directory place one .php/.inc file and/or one .css file.
• If you're overriding filters, create a new class in the PHP file that extends WDTSDisplayFilters (defined in classes/WDTSDisplayFilters.inc) and override functions as necessary.
• If done correctly, the new filter will be available under the Styles tab.

How does the transcript workflow work?

Transcripts can be in one of two states: queued and approved. Users can interact with them depending upon the permissions given to them:

• Queued transcripts are only visible to the user who submitted the transcript and to users that can approve transcripts.
• Approved transcripts are visible to everyone.
• Users who can submit transcripts can create new queued transcripts and edit their queued transcripts.
• Once a transcript is approved, it can only be edited by users who can approve transcripts.
• Users who can approve transcripts can also directly edit the approved transcripts.
• If a user submits a transcript to the queue, they can delete it before it's approved.
• When approved, the original submitter will be given credit for each approved transcript that's displayed.

Permissions are handed out in two ways and are set under the Capabilities tab.

• Based on role (Subscriber, Administrator, etc.)
• Per user

How do short codes work?

Short codes are the recommended way that you create your transcripts. They eliminate the dependency on particular HTML structures and styles, which means it's trivial to rework how your transcripts look and behave. It also improves security as it's less likely that bad HTML will sneak into your transcripts. Short codes information can be found under the Short Codes Info tab. Each transcript editing area has buttons that allow you to quickly insert the proper short codes into your transcripts.