Automattic / jetpack

modules/shortcodes/medium.php

<?php
/**
 * Embed support for Medium
 *
 * Supported formats:
 * - Profiles: https://medium.com/@jeherve
 * - Stories: https://medium.com/@jeherve/this-is-a-story-19f582daaf5b
 * - And all the above in shortcode formats:
 * [medium url="https://medium.com/@jeherve/this-is-a-story-19f582daaf5b" width="100%" border="false" collapsed="true"]
 *
 * @package Jetpack
 */

// Faux-oembed support for Medium permalinks.
wp_embed_register_handler( 'medium', '#^https?://medium.com/([a-zA-z0-9-_@]+)#', 'jetpack_embed_medium_oembed' );

/**
 * Callback to modify output of embedded Medium posts.
 *
 * @param array $matches Regex partial matches against the URL passed.
 * @param array $attr    Attributes received in embed response.
 * @param array $url     Requested URL to be embedded.
 */
function jetpack_embed_medium_oembed( $matches, $attr, $url ) {
	$attr        = jetpack_embed_medium_args( $attr );
	$attr['url'] = $url;

	return jetpack_embed_medium_embed_html( $attr );
}

/**
 * Return custom markup to display a Medium profile, collection, or story.
 *
 * @param array $args Attributes received in embed response.
 */
function jetpack_embed_medium_embed_html( $args ) {
	$args = jetpack_embed_medium_args( $args );

	if ( empty( $args['url'] ) ) {
		return;
	}

	$args['type'] = jetpack_embed_medium_get_embed_type( $args['url'] );

	if ( 'collection' === $args['type'] ) {
		return sprintf(
			'<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a>',
			esc_url( $args['url'] ),
			esc_html__( 'View this collection on Medium.com', 'jetpack' )
		);
	}

	wp_enqueue_script(
		'medium-embed',
		'https://static.medium.com/embed.js',
		array(),
		JETPACK__VERSION,
		true
	);

	return sprintf(
		'<a class="m-%1$s" href="%2$s" target="_blank" data-width="%3$s" data-border="%4$s" data-collapsed="%5$s">%6$s</a>',
		esc_attr( $args['type'] ),
		esc_url( $args['url'] ),
		esc_attr( $args['width'] ),
		esc_attr( $args['border'] ),
		esc_attr( $args['collapsed'] ),
		esc_html__( 'View at Medium.com', 'jetpack' )
	);
}

/**
 * Shortcode support that allows passing in URL
 *
 * @param array $atts Shortcode attributes.
 */
function jetpack_embed_medium_shortcode( $atts ) {
	$atts = jetpack_embed_medium_args( $atts );

	if ( ! empty( $atts['url'] ) ) {
		global $wp_embed;
		return $wp_embed->shortcode( $atts, $atts['url'] );
	} else {
		if ( current_user_can( 'edit_posts' ) ) {
			return esc_html__( 'You did not provide a valid Medium URL.', 'jetpack' );
		} else {
			return '<!-- Missing Medium URL -->';
		}
	}
}
add_shortcode( 'medium', 'jetpack_embed_medium_shortcode' );

/**
 * Get embed type (profile, collection, or story) based on Medium URL.
 *
 * @param string $url Medium URL.
 */
function jetpack_embed_medium_get_embed_type( $url ) {
	$url_path = wp_parse_url( $url, PHP_URL_PATH );

The call to wp_parse_url() has too many arguments starting with PHP_URL_PATH.

	if ( preg_match( '/^\/@[\.\w]+$/', $url_path ) ) {
		return 'profile';
	} elseif ( preg_match( '/^\/(?:s)\/(.+)$/', $url_path ) ) {
		return 'collection';
	}

	return 'story';
}

/**
 * Process Medium shortcode attributes.
 *
 * @param array $atts Shortcode attributes.
 */
function jetpack_embed_medium_args( $atts ) {
	return shortcode_atts(
		array(
			'url'       => '',
			'width'     => '400',
			'border'    => true,
			'collapsed' => false,
		),
		$atts,
		'medium'
	);
}