Skip to main content

Show an episode’s transcription status, and request one, from your add-on

Premium Intermediate Transcription Service

Your add-on’s admin screen has a tile for an episode’s transcript, as Podcast Workflow’s Episode Workbench does: read where it stands with benecaster_transcription_status(), link to the transcript, and offer to request one with benecaster_request_episode_transcription(). Requesting spends the podcaster’s money with their provider, so do it only on their click, with the cost shown first.

Code

<?php
if ( ! function_exists( 'benecaster_transcription_status' ) ) {
    return; // Transcription Service is not active: hide the tile.
}

$status = benecaster_transcription_status( $episode_id ); // Base audio. null: not an episode.
if ( null === $status ) {
    return;
}

$label = match ( $status['status'] ) {
    'none'                  => __( 'Not started', 'my-addon' ),
    'pending', 'processing' => __( 'Processing', 'my-addon' ),
    'complete'              => __( 'Complete', 'my-addon' ),
    'failed'                => __( 'Failed', 'my-addon' ),
    default                 => '',
};
// $status['updated_at'] is UTC: wp_date( 'j M Y H:i', strtotime( $status['updated_at'] . ' UTC' ) ).
// 'complete' → link "View transcript" to $status['editor_url'] (empty while Transcription is off for the show).
// $status['can_request'] → offer "Request transcription"; on the podcaster's confirmed click:

if ( current_user_can( 'manage_options' ) && $status['can_request'] ) {
    $result = benecaster_request_episode_transcription( $episode_id );
    if ( is_wp_error( $result ) ) {
        my_addon_notice( $result->get_error_message() ); // e.g. no provider connected.
    }
}

View on GitHub →

Need this built rather than just documented? See our services →