* Embed support for Medium
* - 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 automattic/jetpack
if ( ! defined( 'ABSPATH' ) ) {
// 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 );
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'] ) ) {
$args['type'] = jetpack_embed_medium_get_embed_type( $args['url'] );
if ( 'collection' === $args['type'] ) {
'<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a>',
esc_html__( 'View this collection on Medium.com', 'jetpack' )
'https://static.medium.com/embed.js',
'<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_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'] ) ) {
return $wp_embed->shortcode( $atts, $atts['url'] );
} elseif ( current_user_can( 'edit_posts' ) ) {
return esc_html__( 'You did not provide a valid Medium URL.', 'jetpack' );
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 );
if ( preg_match( '/^\/@[\.\w]+$/', $url_path ) ) {
} elseif ( preg_match( '/^\/(?:s)\/(.+)$/', $url_path ) ) {
* Process Medium shortcode attributes.
* @param array $atts Shortcode attributes.
function jetpack_embed_medium_args( $atts ) {