jetpack / modules / shortcodes.php

shortcodes.php in Jetpack – WP Security, Backup, Speed, & Growth 12.5, at modules/shortcodes.php

204 lines 6.1 KB

Raw Download Zip

1	<?php
2	/**
3	* Module Name: Shortcode Embeds
4	* Module Description: Shortcodes are WordPress-specific markup that let you add media from popular sites. This feature is no longer necessary as the editor now handles media embeds rather gracefully.
5	* Sort Order: 3
6	* First Introduced: 1.1
7	* Major Changes In: 1.2
8	* Requires Connection: No
9	* Auto Activate: No
10	* Module Tags: Photos and Videos, Social, Writing, Appearance
11	* Feature: Writing
12	* Additional Search Queries: shortcodes, shortcode, embeds, media, bandcamp, dailymotion, facebook, flickr, google calendars, google maps, polldaddy, recipe, recipes, scribd, slideshare, slideshow, slideshows, soundcloud, ted, twitter, vimeo, vine, youtube
13	*
14	* @package automattic/jetpack
15	*/
16
17	/**
18	* Transforms the $atts array into a string that the old functions expected
19	*
20	* The old way was:
21	* [shortcode a=1&b=2&c=3] or [shortcode=1]
22	* This is parsed as array( a => '1&b=2&c=3' ) and array( 0 => '=1' ), which is useless
23	*
24	* @param array $params Array of old shortcode parameters.
25	* @param bool $old_format_support true if [shortcode=foo] format is possible.
26	*
27	* @return string $params
28	*/
29	function shortcode_new_to_old_params( $params, $old_format_support = false ) {
30	$str = '';
31
32	if ( $old_format_support && isset( $params[0] ) ) {
33	$str = ltrim( $params[0], '=' );
34	} elseif ( is_array( $params ) ) {
35	foreach ( array_keys( $params ) as $key ) {
36	if ( ! is_numeric( $key ) ) {
37	$str = $key . '=' . $params[ $key ];
38	}
39	}
40	}
41
42	return str_replace( array( '&', '&' ), '&', $str );
43	}
44
45	/**
46	* Load all available Jetpack shortcode files.
47	*/
48	function jetpack_load_shortcodes() {
49	$shortcode_includes = array();
50
51	foreach ( Jetpack::glob_php( __DIR__ . '/shortcodes' ) as $file ) {
52	$filename = substr( basename( $file ), 0, -4 );
53
54	$shortcode_includes[ $filename ] = $file;
55	}
56
57	/**
58	* This filter allows other plugins to override which shortcodes Jetpack loads.
59	*
60	* Fires as part of the `plugins_loaded` WP hook, so modifying code needs to be in a plugin, not in a theme's functions.php.
61	*
62	* @module shortcodes
63	*
64	* @since 2.2.1
65	* @since 4.2.0 Added filename without extension as array key.
66	*
67	* @param array $shortcode_includes An array of which shortcodes to include.
68	*/
69	$shortcode_includes = apply_filters( 'jetpack_shortcodes_to_include', $shortcode_includes );
70
71	foreach ( $shortcode_includes as $include ) {
72	include_once $include;
73	}
74	}
75
76	/**
77	* Runs preg_replace so that replacements don't happen within open tags.
78	* Parameters are the same as preg_replace, with an added optional search param for improved performance
79	*
80	* @param string $pattern Pattern to search for.
81	* @param string $replacement String to replace.
82	* @param string $content Post content.
83	* @param string $search String to search for.
84	*
85	* @return string $content Replaced post content.
86	*/
87	function jetpack_preg_replace_outside_tags( $pattern, $replacement, $content, $search = null ) {
88	if ( $search && false === strpos( $content, $search ) ) {
89	return $content;
90	}
91
92	$textarr = wp_html_split( $content );
93	unset( $content );
94	foreach ( $textarr as &$element ) {
95	if ( '' === $element \|\| '<' === $element[0] ) {
96	continue;
97	}
98	$element = preg_replace( $pattern, $replacement, $element );
99	}
100
101	return implode( $textarr );
102	}
103
104	/**
105	* Runs preg_replace_callback so that replacements don't happen within open tags.
106	* Parameters are the same as preg_replace, with an added optional search param for improved performance.
107	*
108	* @param string $pattern Pattern to search for.
109	* @param string $callback Callback returning the replacement string.
110	* @param string $content Post content.
111	* @param string $search String to search for.
112	*
113	* @return string $content Replaced post content.
114	*/
115	function jetpack_preg_replace_callback_outside_tags( $pattern, $callback, $content, $search = null ) {
116	if ( $search && false === strpos( $content, $search ) ) {
117	return $content;
118	}
119
120	$textarr = wp_html_split( $content );
121	unset( $content );
122	foreach ( $textarr as &$element ) {
123	if ( '' === $element \|\| '<' === $element[0] ) {
124	continue;
125	}
126	$element = preg_replace_callback( $pattern, $callback, $element );
127	}
128
129	return implode( $textarr );
130	}
131
132	if ( ! function_exists( 'jetpack_shortcode_get_wpvideo_id' ) ) {
133	/**
134	* Get VideoPress ID from wpvideo shortcode attributes.
135	*
136	* @param array $atts Shortcode attributes.
137	*
138	* @return string\|int $id VideoPress ID.
139	*/
140	function jetpack_shortcode_get_wpvideo_id( $atts ) {
141	if ( isset( $atts[0] ) ) {
142	return $atts[0];
143	} else {
144	return 0;
145	}
146	}
147	}
148
149	if ( ! function_exists( 'jetpack_shortcode_get_videopress_id' ) ) {
150	/**
151	* Get VideoPress ID from videopress shortcode attributes.
152	*
153	* @param array $atts Shortcode attributes.
154	* @return int $id VideoPress ID.
155	*/
156	function jetpack_shortcode_get_videopress_id( $atts ) {
157	if ( isset( $atts[0] ) ) {
158	return $atts[0];
159	} else {
160	return 0;
161	}
162	}
163	}
164
165	/**
166	* Common element attributes parsing and sanitizing for src, width and height.
167	*
168	* @since 4.5.0
169	*
170	* @param array $attrs With original values.
171	*
172	* @return array $attrs With sanitized values.
173	*/
174	function wpcom_shortcodereverse_parseattr( $attrs ) {
175	$defaults = array(
176	'src' => false,
177	'width' => false,
178	'height' => false,
179	);
180
181	$attrs = shortcode_atts( $defaults, $attrs );
182
183	$attrs['src'] = wp_strip_all_tags( $attrs['src'] ); // For sanity.
184	$attrs['width'] = ( is_numeric( $attrs['width'] ) ) ? abs( (int) $attrs['width'] ) : $defaults['width'];
185	$attrs['height'] = ( is_numeric( $attrs['height'] ) ) ? abs( (int) $attrs['height'] ) : $defaults['height'];
186
187	return $attrs;
188	}
189
190	/**
191	* When an embed service goes away, we can use this handler
192	* to output a link for history's sake.
193	*
194	* @param array $matches Regex partial matches against the URL passed.
195	* @param array $attr Attributes received in embed response.
196	* @param string $url Requested URL to be embedded.
197	* @return string Link to output.
198	*/
199	function jetpack_deprecated_embed_handler( $matches, $attr, $url ) {
200	return sprintf( '<a href="%s">%s</a>', esc_url( $url ), esc_html( esc_url( $url ) ) );
201	}
202
203	jetpack_load_shortcodes();
204