jetpack / modules / shortcodes.php

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

197 lines 5.8 KB

Raw Download Zip

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