ds-npr-api.php

<?php
/**
 * Plugin Name: NPR Story API
 * Description: A collection of tools for reusing content from NPR.org, now maintained and updated by NPR member station developers
 * Version: 1.9.7
 * Author: Open Public Media
 * License: GPLv2
*/
/*
	Copyright 2012 NPR Digital Services

	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License, version 2, as
	published by the Free Software Foundation.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
*/

define( 'NPR_STORY_ID_META_KEY', 'npr_story_id' );
define( 'NPR_API_LINK_META_KEY', 'npr_api_link' );
define( 'NPR_HTML_LINK_META_KEY', 'npr_html_link' );
define( 'NPR_SHORT_LINK_META_KEY', 'npr_short_link' );
define( 'NPR_STORY_CONTENT_META_KEY', get_option( 'ds_npr_api_mapping_body', 'npr_story_content' ) );
define( 'NPR_BYLINE_META_KEY', get_option( 'ds_npr_api_mapping_media_credit', 'npr_byline' ) );
define( 'NPR_BYLINE_LINK_META_KEY', 'npr_byline_link' );
define( 'NPR_MULTI_BYLINE_META_KEY', 'npr_multi_byline' );
define( 'NPR_IMAGE_GALLERY_META_KEY', 'npr_image_gallery' );
define( 'NPR_HTML_ASSETS_META_KEY', 'npr_html_assets' );
define( 'NPR_AUDIO_META_KEY', 'npr_audio' );
define( 'NPR_AUDIO_M3U_META_KEY', 'npr_audio_m3u' );
define( 'NPR_PUB_DATE_META_KEY', 'npr_pub_date' );
define( 'NPR_STORY_DATE_MEATA_KEY', 'npr_story_date' );
define( 'NPR_LAST_MODIFIED_DATE_KEY', 'npr_last_modified_date' );
define( 'NPR_RETRIEVED_STORY_META_KEY', 'npr_retrieved_story' );

define( 'NPR_IMAGE_CREDIT_META_KEY', get_option( 'ds_npr_api_mapping_media_credit', 'npr_image_credit' ) );
define( 'NPR_IMAGE_AGENCY_META_KEY', get_option( 'ds_npr_api_mapping_media_agency', 'npr_image_agency' ) );
define( 'NPR_IMAGE_CAPTION_META_KEY', 'npr_image_caption' );

define( 'NPR_STORY_HAS_LAYOUT_META_KEY', 'npr_has_layout' );
define( 'NPR_STORY_HAS_VIDEO_META_KEY', 'npr_has_video' );

define( 'NPR_PUSH_STORY_ERROR', 'npr_push_story_error' );

define( 'NPR_MAX_QUERIES', 10 );

define( 'NPR_POST_TYPE', 'npr_story_post' );

define( 'NPRSTORY_PLUGIN_URL', plugin_dir_url(__FILE__) );

// Load files
define( 'NPRSTORY_PLUGIN_DIR', plugin_dir_path(__FILE__) );
require_once( NPRSTORY_PLUGIN_DIR . 'settings.php' );
require_once( NPRSTORY_PLUGIN_DIR . 'classes/NPRAPIWordpress.php' );
require_once( NPRSTORY_PLUGIN_DIR . 'get_stories.php' );
require_once( NPRSTORY_PLUGIN_DIR . 'meta-boxes.php' );
require_once( NPRSTORY_PLUGIN_DIR . 'push_story.php' );

//add the cron to get stories
register_activation_hook( NPRSTORY_PLUGIN_DIR . 'ds-npr-api.php', 'nprstory_activation' );
add_action( 'npr_ds_hourly_cron', [ 'DS_NPR_API', 'nprstory_cron_pull' ] );
register_deactivation_hook( NPRSTORY_PLUGIN_DIR . 'ds-npr-api.php', 'nprstory_deactivation' );

function nprstory_activation() {
	global $wpdb;
	if ( function_exists( 'is_multisite' ) && is_multisite() ) {
		// check if it is a network activation - if so, run the activation function for each blog id
		$old_blog = $wpdb->blogid;
		// Get all blog ids
		$blogids = $wpdb->get_col( $wpdb->prepare( "SELECT blog_id FROM %s", $wpdb->blogs ) );
		foreach ( $blogids as $blog_id ) {
			switch_to_blog( $blog_id );
			nprstory_activate();
		}
		switch_to_blog( $old_blog );
	} else {
		nprstory_activate();
	}
}

function nprstory_activate() {
	update_option( 'dp_npr_query_multi_cron_interval', 60 );
	if ( !wp_next_scheduled( 'npr_ds_hourly_cron' ) ) {
		nprstory_error_log( 'turning on cron event for NPR Story API plugin' );
		wp_schedule_event( time(), 'hourly', 'npr_ds_hourly_cron' );
	}

	$num = get_option( 'ds_npr_num' );
	if ( empty( $num ) ) {
		update_option( 'ds_npr_num', 5 );
	}

	$def_url = 'https://api.npr.org';
	$pull_url = get_option( 'ds_npr_api_pull_url' );
	if ( empty( $pull_url ) ) {
		update_option( 'ds_npr_api_pull_url', $def_url );
	}
}

function nprstory_deactivation() {
	global $wpdb;
	if ( function_exists( 'is_multisite' ) && is_multisite() ) {
		// check if it is a network activation - if so, run the activation function for each blog id
		$old_blog = $wpdb->blogid;
		// Get all blog ids
		$blogids = $wpdb->get_col( $wpdb->prepare( "SELECT blog_id FROM %s", $wpdb->blogs ) );
		foreach ( $blogids as $blog_id ) {
			switch_to_blog( $blog_id );
			nprstory_deactivate();
		}
		switch_to_blog( $old_blog );
	} else {
		nprstory_deactivate();
	}
}

function nprstory_deactivate() {
	wp_clear_scheduled_hook( 'npr_ds_hourly_cron' );
	$num = get_option( 'ds_npr_num' );
	if ( !empty( $num ) ) {
		delete_option( 'ds_npr_num' );
	}

	$push_url = get_option( 'ds_npr_api_push_url' );
	if ( !empty( $push_url ) ) {
		delete_option( 'ds_npr_api_push_url' );
	}
}


function nprstory_show_message( $message, $errormsg = false ) {
	if ( $errormsg ) {
		echo '<div id="message" class="error">';
	} else {
		echo '<div id="message" class="updated fade">';
	}
	echo nprstory_esc_html( "<p><strong>$message</strong></p></div>" );
}

add_action( 'init', 'nprstory_create_post_type' );

function nprstory_create_post_type() {
	register_post_type( NPR_POST_TYPE, [
		'labels' => [
			'name' => __( 'NPR Stories' ),
			'singular_name' => __( 'NPR Story' )
		],
		'public' => true,
		'has_archive' => true,
		'menu_position' => 5,
		'supports' => [ 'title', 'editor', 'thumbnail', 'custom-fields' ]
	]);
}

/**
 * Register the meta box and enqueue its scripts
 *
 * If the API Push URL option is not set, instead register a prompt to set it.
 *
 * @link https://github.com/npr/nprapi-wordpress/issues/51
 */
function nprstory_add_meta_boxes() {
	$screen = get_current_screen();
	$push_post_type = get_option( 'ds_npr_push_post_type' ) ?: 'post';
	$push_url = get_option( 'ds_npr_api_push_url' );
	if ( $screen->id == $push_post_type ) {
		if ( !empty( $push_url ) ) {
			global $post;
			add_meta_box(
				'ds_npr_document_meta',
				'NPR Story API',
				'nprstory_publish_meta_box',
				$push_post_type, 'side'
			);
			add_action( 'admin_enqueue_scripts', 'nprstory_publish_meta_box_assets' );
		} else {
			global $post;
			add_meta_box(
				'ds_npr_document_meta',
				'NPR Story API',
				'nprstory_publish_meta_box_prompt',
				$push_post_type, 'side'
			);
		}
	}
}
add_action( 'add_meta_boxes', 'nprstory_add_meta_boxes' );

/**
 * Function to only enable error_logging if WP_DEBUG is true
 *
 * This should only be used for error_log in development environments
 * If the thing being logged is a fatal error, use error_log so it will always be logged
 */
function nprstory_error_log( $thing ) {
	if ( WP_DEBUG ) {
		error_log( $thing ); //debug use
	}
}

/**
 * Function to help with escaping HTML, especially for admin screens
 */
function nprstory_esc_html( $string ) {
	return html_entity_decode( esc_html( $string ), ENT_QUOTES );
}

function nprstory_add_header_meta() {
	global $wp_query;
	if ( !is_home() && !is_404() &&
		( get_post_type() === get_option( 'ds_npr_pull_post_type' ) || get_post_type() === get_option( 'ds_npr_push_post_type' ) )
	) {
		$id = $wp_query->queried_object_id;
		$npr_story_id = get_post_meta( $id, 'npr_story_id', 1 );
		if ( !empty( $npr_story_id ) ) {
			$has_audio = ( preg_match( '/\[audio/', $wp_query->post->post_content ) ? 1 : 0 );
			$word_count = str_word_count( strip_tags( $wp_query->post->post_content ) );
			$byline = '';
			$npr_retrieved_story = get_post_meta( $id, 'npr_retrieved_story', 1 );
			if ( $npr_retrieved_story == 1 ) {
				$byline = get_post_meta( $id, 'npr_byline', 1 );
				if ( function_exists( 'rel_canonical' ) ) {
					remove_action( 'wp_head', 'rel_canonical' );
				}
				$original_url = get_post_meta( $id, NPR_HTML_LINK_META_KEY, 1 );
				echo '<link rel="canonical" href="' . esc_url( $original_url ) . '" />' . "\n";
			} elseif ( function_exists( 'get_coauthors' ) ) {
				$byline = coauthors( ', ', ', ', '', '', false );
			} else {
				$byline = get_the_author_meta( 'display_name', $wp_query->post->post_author );
			}
			$head_categories = get_the_category( $id );
			$head_tags = wp_get_post_tags( $id );
			$keywords = [];
			foreach( $head_categories as $hcat ) :
				$keywords[] = $hcat->name;
			endforeach;
			foreach( $head_tags as $htag ) :
				$keywords[] = $htag->name;
			endforeach;
			$primary_cat = get_post_meta( $id, 'epc_primary_category', true );
			if ( empty( $primary_cat ) ) {
				$primary_cat = $keywords[0];
			} ?>
		<meta name="datePublished" content="<?php echo get_the_date( 'c', $id ); ?>" />
		<meta name="story_id" content="<?php echo $npr_story_id; ?>" />
		<meta name="has_audio" content="<?php echo $has_audio; ?>" />
		<meta name="org_id" content="<?php echo get_option( 'ds_npr_api_org_id' ); ?>" />
		<meta name="category" content="<?php echo $primary_cat; ?>" />
		<meta name="author" content="<?php echo $byline; ?>" />
		<meta name="programs" content="none" />
		<meta name="wordCount" content="<?php echo $word_count; ?>" />
		<meta name="keywords" content="<?php echo implode( ',', $keywords ); ?>" />
<?php
		}
	}
}
add_action( 'wp_head', 'nprstory_add_header_meta', 9 );

add_action('admin_notices', 'nprstory_cds_plugin_admin_notice');

function nprstory_cds_plugin_admin_notice() {
	global $pagenow;
	$display = false;
	// Only show this message on the admin dashboard and if asked for
	if ( $pagenow === 'index.php' ) {
		$display = true;
	} elseif ( !empty( $_GET['page'] ) ) {
		if ( str_contains( $_GET['page'], 'npr-' ) || str_contains( $_GET['page'], 'npr_' ) ) {
			$display = true;
		}
	} elseif ( !empty( $_GET['post_type'] ) ) {
		if ( str_contains( $_GET['post_type'], 'npr-' ) || str_contains( $_GET['post_type'], 'npr_' ) ) {
			$display = true;
		}
	}
	if ( $display ) { ?>
		<div class="notice notice-warning is-dismissible">
			<h2><?php _e( 'The NPR Story API plugin is going away!', 'ds_npr_api' ); ?></h2>
			<p><?php _e( 'In the coming months, the NPR Story API will be sunset in favor of the <a href="https://npr.github.io/content-distribution-service/">NPR Content Distribution Service (CDS)</a>. The same great content, but with greater flexibility, a more modern architecture, and richer media support.', 'ds_npr_api' ); ?></p>
			<p><?php _e( 'While the Story API will continue to function for some time, we encourage you to try out the <a href="https://wordpress.org/plugins/npr-content-distribution-service/">new NPR CDS Plugin</a>. Be sure to file a ticket in <a href="https://studio.npr.org/">NPR Studio</a> to get your authorization token and station information.', 'ds_npr_api' ); ?></p>
		</div>
<?php
	}
}