Commit Graph

178 Commits

Author SHA1 Message Date
John Blackbourn b13e73d05c Docs: Document more parameters and properties using typed array notation.
See #41756

Built from https://develop.svn.wordpress.org/trunk@42875


git-svn-id: http://core.svn.wordpress.org/trunk@42705 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2018-03-25 18:10:32 +00:00
Sergey Biryukov b026fde152 Docs: Remove `@static` notations from property DocBlocks in `wp-admin/*` and `wp-includes/*` classes.
This tag has been used in the past, but should no longer be used. Just using the `static` keyword in code is enough for PhpDocumentor on PHP5+ to recognize static variables and methods, and PhpDocumentor will mark them as static.

Props birgire.
See #42803.
Built from https://develop.svn.wordpress.org/trunk@42747


git-svn-id: http://core.svn.wordpress.org/trunk@42577 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2018-02-25 20:32:30 +00:00
Sergey Biryukov 08227812a0 Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes.
This tag has been used in the past, but should no longer be used. Just using the `static` keyword in code is enough for PhpDocumentor on PHP5+ to recognize static variables and methods, and PhpDocumentor will mark them as static.

Props birgire.
See #42803.
Built from https://develop.svn.wordpress.org/trunk@42746


git-svn-id: http://core.svn.wordpress.org/trunk@42576 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2018-02-25 20:22:30 +00:00
Gary Pendergast aaf99e6913 Code is Poetry.
WordPress' code just... wasn't.
This is now dealt with.

Props jrf, pento, netweb, GaryJ, jdgrimes, westonruter, Greg Sherwood from PHPCS, and everyone who's ever contributed to WPCS and PHPCS.
Fixes #41057.


Built from https://develop.svn.wordpress.org/trunk@42343


git-svn-id: http://core.svn.wordpress.org/trunk@42172 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-11-30 23:11:00 +00:00
John Blackbourn 67c973f95e Docs: Correct parameter type documentation for various `__call()` methods.
See #42505

Built from https://develop.svn.wordpress.org/trunk@42151


git-svn-id: http://core.svn.wordpress.org/trunk@41982 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-11-10 22:56:47 +00:00
John Blackbourn 3dda9e9257 Embeds: Add oEmbed support for someecards.com.
Props someecards

Fixes #40792

Built from https://develop.svn.wordpress.org/trunk@41681


git-svn-id: http://core.svn.wordpress.org/trunk@41515 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-10-02 19:10:49 +00:00
John Blackbourn 7859e22ad5 Embeds: Switch the collegehumor.com oEmbed endpoint to HTTPS, as it redirects there by default now.
See #28507

Built from https://develop.svn.wordpress.org/trunk@41680


git-svn-id: http://core.svn.wordpress.org/trunk@41514 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-10-02 19:06:46 +00:00
John Blackbourn 2e3581c3ad Embeds: Alignment following [41615].
See #38181

Built from https://develop.svn.wordpress.org/trunk@41676


git-svn-id: http://core.svn.wordpress.org/trunk@41510 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-10-02 18:38:46 +00:00
John Blackbourn 5c7a7a2989 Embeds: Documentation alignment following [41615].
See #38181

Built from https://develop.svn.wordpress.org/trunk@41616


git-svn-id: http://core.svn.wordpress.org/trunk@41451 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-27 13:27:44 +00:00
John Blackbourn 4b76c1f22f Embeds: Add support for Amazon Kindle instant previews.
Props jsepia, morganestes, adamsilverstein, swissspidy, jbpaul17, johnbillion, rugved

Fixes #38181

Built from https://develop.svn.wordpress.org/trunk@41615


git-svn-id: http://core.svn.wordpress.org/trunk@41450 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-27 13:26:45 +00:00
Dion Hulse af3c440b1d Embeds: Switch the Imgur oEmbed endpoint to use SSL as the HTTP version has been deprecated.
Props swissspidy.
Fixes #41984.

Built from https://develop.svn.wordpress.org/trunk@41599


git-svn-id: http://core.svn.wordpress.org/trunk@41434 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-26 08:33:44 +00:00
John Blackbourn 2bd20bb0db Embeds: Remove support for oEmbedded videos from Vine.
* Vine effectively shut down in December 2016.
* The oEmbed endpoint no longer works and returns a 404.
* Developer documentation for Vine has been removed.

Fixes #41817

Built from https://develop.svn.wordpress.org/trunk@41347


git-svn-id: http://core.svn.wordpress.org/trunk@41180 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-08 15:01:44 +00:00
John Blackbourn e061a432cc Embeds: Add the `dnt` (Do Not Track) query parameter to all oEmbed provider URLs.
This means that, for those providers that support this somewhat de-facto standard, visitor tracking is disabled by default for all embeds.

Props norcross, joostdevalk

Fixes #41784

Built from https://develop.svn.wordpress.org/trunk@41345


git-svn-id: http://core.svn.wordpress.org/trunk@41178 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-09-08 12:31:43 +00:00
Drew Jaynes 0860bb2771 Docs: Remove `@access` notations from method DocBlocks in wp-includes/* classes.
Prior to about 2013, many class methods lacked even access modifiers which made the `@access` notations that much more useful. Now that we've gotten to a point where the codebase is more mature from a maintenance perspective and we can finally remove these notations. Notable exceptions to this change include standalone functions notated as private as well as some classes still considered to represent "private" APIs.

See #41452.

Built from https://develop.svn.wordpress.org/trunk@41162


git-svn-id: http://core.svn.wordpress.org/trunk@41002 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-27 00:41:44 +00:00
Pascal Birchler b0fed2af63 Embeds: Update oEmbed endpoint URL for VideoPress.
Props NomNom99.
Fixes #41019.
Built from https://develop.svn.wordpress.org/trunk@40901


git-svn-id: http://core.svn.wordpress.org/trunk@40751 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-15 05:38:45 +00:00
James Nylen 589c4b4b2d REST API: Add endpoint for proxying requests to external oEmbed providers.
This endpoint is a prerequisite for the media widgets work (see https://github.com/xwp/wp-core-media-widgets).

Also use the new endpoint in the media modal instead of the `parse-embed` AJAX action.

Props westonruter, timmydcrawford, swissspidy, jnylen0.
Fixes #40450.

Built from https://develop.svn.wordpress.org/trunk@40628


git-svn-id: http://core.svn.wordpress.org/trunk@40489 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-05-11 18:18:46 +00:00
Pascal Birchler e1d5fd1c6b Embeds: Add screencast.com to oEmbed provider whitelist.
Props ENDif Media.
Fixes #38367.

Built from https://develop.svn.wordpress.org/trunk@40574


git-svn-id: http://core.svn.wordpress.org/trunk@40444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-05-06 14:25:45 +00:00
Sergey Biryukov e1906ab3f1 Embeds: After [31148], list correct method in `WP_oEmbed::$compat_methods`.
Props LewisCowles.
Fixes #39292.
Built from https://develop.svn.wordpress.org/trunk@40026


git-svn-id: http://core.svn.wordpress.org/trunk@39963 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-01-29 07:32:43 +00:00
Dominik Schilling c40eadefb2 Embeds: Realign the provider list after [38693].
See #38003.
Built from https://develop.svn.wordpress.org/trunk@38923


git-svn-id: http://core.svn.wordpress.org/trunk@38866 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-10-25 20:16:56 +00:00
Dominik Schilling b154ab767e Embeds: Add oEmbed support for User, List and Like Twitter timelines.
Props earnjam.
Fixes #38003.
Built from https://develop.svn.wordpress.org/trunk@38693


git-svn-id: http://core.svn.wordpress.org/trunk@38636 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 21:42:28 +00:00
Dominik Schilling 2e4748c544 Embeds: Add support for embedding Facebook photos of a user/page.
See #34737.
Built from https://develop.svn.wordpress.org/trunk@38691


git-svn-id: http://core.svn.wordpress.org/trunk@38634 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 20:40:28 +00:00
Sergey Biryukov 31f0fd5a54 Embeds: Escape periods in oEmbed regex.
Props jrf.
Fixes #38187.
Built from https://develop.svn.wordpress.org/trunk@38684


git-svn-id: http://core.svn.wordpress.org/trunk@38627 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 11:25:30 +00:00
Sergey Biryukov 6c2d92c19f Docs: Correct 'Since' version number for Cloudup in `oembed_providers` filter description.
Props jrf.
Fixes #38188.
Built from https://develop.svn.wordpress.org/trunk@38675


git-svn-id: http://core.svn.wordpress.org/trunk@38618 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-29 17:13:29 +00:00
John Blackbourn 94c8ca0f2e Docs: Correct various documentation around `object` and `stdClass` types.
See #37770

Built from https://develop.svn.wordpress.org/trunk@38369


git-svn-id: http://core.svn.wordpress.org/trunk@38310 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 16:49:45 +00:00
John Blackbourn f53cc848e4 Embeds: Add a missing regex delimiter for Facebook URLs.
See #34737

Built from https://develop.svn.wordpress.org/trunk@38368


git-svn-id: http://core.svn.wordpress.org/trunk@38309 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 12:17:28 +00:00
John Blackbourn 07c31a5437 Embeds: Add support for embedding Facebook posts and videos via oEmbed.
Fixes #34737
Props pento, GaryJ

Built from https://develop.svn.wordpress.org/trunk@38367


git-svn-id: http://core.svn.wordpress.org/trunk@38308 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 11:57:30 +00:00
John Blackbourn a71d445b80 Embeds: Many of our oEmbed providers now default to HTTPS embeds, redirect to the HTTPS oEmbed endpoint, or have complete support for HTTPS even if they don't default to HTTPS.
This change defaults to using HTTPS endpoints for oEmbeds for those providers that have full HTTPS support and don't redirect back to HTTP when clicking through from the embed. It covers:

* Vimeo
* SmugMug
* Scribd
* WordPress.tv
* SoundCloud
* Meetup
* issuu
* Mixcloud
* TED

See #28507

Built from https://develop.svn.wordpress.org/trunk@38366


git-svn-id: http://core.svn.wordpress.org/trunk@38307 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 11:25:29 +00:00
John Blackbourn c7884d542e Embeds: Always use the HTTPS endpoint for YouTube embeds. The `scheme` parameter is no longer required as all YouTube assets now use HTTPS.
See #36274, #28507
Props zsusag, tollmanz

Built from https://develop.svn.wordpress.org/trunk@38365


git-svn-id: http://core.svn.wordpress.org/trunk@38306 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 10:39:32 +00:00
Scott Taylor ff59281441 OEmbed: move `_wp_oembed_get_object()` to `embed.php`, where all of the other embed functions live. `WP_oEmbed` is then in a file by itself. Load `class-oembed.php` in `wp-settings.php` and remove extraneous include calls.
See #37827.

Built from https://develop.svn.wordpress.org/trunk@38361


git-svn-id: http://core.svn.wordpress.org/trunk@38302 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-26 09:49:28 +00:00
Sergey Biryukov 822db9ce1d Embeds: Fix copy/paste error in `WP_oEmbed::_add_provider_early()` description.
Props ivantedja.
Fixes #37602.
Built from https://develop.svn.wordpress.org/trunk@38230


git-svn-id: http://core.svn.wordpress.org/trunk@38171 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-08-09 14:10:30 +00:00
Sergey Biryukov d50ac5598f Embeds: In `WP_oEmbed::get_provider()` and `WP_oEmbed::get_html()`, parse the `$args` string to an array, as we treat it as an array later.
See #37071.
Built from https://develop.svn.wordpress.org/trunk@37720


git-svn-id: http://core.svn.wordpress.org/trunk@37686 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-06-15 18:52:28 +00:00
Pascal Birchler 629b43769b Embeds: Improve performance when embedding a post from the current site.
When the post being embedded is from the same site, there's no reason to do an HTTP request for it. The data can be fetched directly using `get_oembed_response_data()`.

Fixes #36767 for trunk.
Built from https://develop.svn.wordpress.org/trunk@37708


git-svn-id: http://core.svn.wordpress.org/trunk@37674 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-06-15 11:23:28 +00:00
Drew Jaynes 9cb5247392 Docs: Standardize filter docs in remaining wp-includes/* files to use third-person singular verbs per the inline documentation standards for PHP.
See #36913.

Built from https://develop.svn.wordpress.org/trunk@37518


git-svn-id: http://core.svn.wordpress.org/trunk@37486 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-22 18:50:28 +00:00
Drew Jaynes b1804afeaf Docs: Standardize on 'backward compatibility/compatible' nomenclature in core inline docs.
Also use 'back-compat' in some inline comments where backward compatibility is the subject and shorthand feels more natural.

Note: 'backwards compatibility/compatibile' can also be considered correct, though it's primary seen in regular use in British English.

Props ocean90.
Fixes #36835.

Built from https://develop.svn.wordpress.org/trunk@37431


git-svn-id: http://core.svn.wordpress.org/trunk@37397 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-13 18:41:31 +00:00
Drew Jaynes 9f48d46be3 Docs: Properly mark `$args` parameters in two `WP_oEmbed` methods as optional.
Also clarify that the `$args` parameters can accept a string (the default) in addition to an array.

Props ramiy.
See #36296.

Built from https://develop.svn.wordpress.org/trunk@37069


git-svn-id: http://core.svn.wordpress.org/trunk@37036 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-23 17:08:27 +00:00
Drew Jaynes d78762c1ef Docs: Use third-person singular verbs for summary DocBlocks in `WP_oEmbed`.
Also fixes inline `@see` formatting in appropriate places (summaries should not contain tags or markdown).

Props ramiy.
See #36296.

Built from https://develop.svn.wordpress.org/trunk@37068


git-svn-id: http://core.svn.wordpress.org/trunk@37035 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-23 16:58:26 +00:00
Drew Jaynes d6a45b15f3 Docs: Improve and add missing DocBlocks for methods and properties in `WP_oEmbed`.
Props ramiy.
See #36296.

Built from https://develop.svn.wordpress.org/trunk@37067


git-svn-id: http://core.svn.wordpress.org/trunk@37034 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-23 16:52:29 +00:00
Drew Jaynes 8e41746cb1 Docs: Change the 'HTTPS' column header to 'Supports HTTPS' in the markdown providers tables in the hook doc for the `oembed_providers` filter.
See #32246.

Built from https://develop.svn.wordpress.org/trunk@37039


git-svn-id: http://core.svn.wordpress.org/trunk@37006 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-21 00:58:25 +00:00
Drew Jaynes f4155d843b Docs: Add Twitter timelines and moments to the table in the hook doc for the `oembed_provders` filter, introduced in [36954].
See #36197. See #35986.

Built from https://develop.svn.wordpress.org/trunk@37038


git-svn-id: http://core.svn.wordpress.org/trunk@37005 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-21 00:40:29 +00:00
Dominik Schilling 337488e684 oEmbed: Extend the provider list to support moments and timelines from Twitter.
Fixes #36197.
Built from https://develop.svn.wordpress.org/trunk@36954


git-svn-id: http://core.svn.wordpress.org/trunk@36922 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-10 20:04:26 +00:00
John Blackbourn ead41790aa Embeds: Add support for `dai.ly` embeds over HTTPS.
Fixes #36189

Built from https://develop.svn.wordpress.org/trunk@36951


git-svn-id: http://core.svn.wordpress.org/trunk@36919 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-10 19:49:27 +00:00
Aaron Jorbin 04071eedea Update Twitter oEmbed URL.
Twitter moved its preferred oEmbed URL for single Tweets from api.twitter.com to publish.twitter.com. They also are deprecating XML responses. 

Props niallkennedy.
Fixes #36197.


Built from https://develop.svn.wordpress.org/trunk@36946


git-svn-id: http://core.svn.wordpress.org/trunk@36914 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-10 18:40:29 +00:00
Dion Hulse 68eb6c1593 oEmbed: During discovery, only request the first 150kb of linked content to avoid timouts requesting larger documents.
Fixes #35979.

Built from https://develop.svn.wordpress.org/trunk@36880


git-svn-id: http://core.svn.wordpress.org/trunk@36847 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-03-08 05:58:26 +00:00
Aaron Jorbin 0eaedf734f Remove RDIO from oEmbed providers
RDIO is shutting down. https://www.rdio.com/farewell/

Props swissspidy
Fixes #35152


Built from https://develop.svn.wordpress.org/trunk@36007


git-svn-id: http://core.svn.wordpress.org/trunk@35972 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-12-18 18:16:27 +00:00
John Blackbourn 1368f7d489 Add support for oEmbeds from Speaker Deck.
Fixes #28597

Built from https://develop.svn.wordpress.org/trunk@35693


git-svn-id: http://core.svn.wordpress.org/trunk@35657 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-11-18 22:05:25 +00:00
Gary Pendergast 329bec7ca1 Embeds: Add support for the www subdomain to Instagram embed URLs.
Props skithund.

Fixes #34651.


Built from https://develop.svn.wordpress.org/trunk@35634


git-svn-id: http://core.svn.wordpress.org/trunk@35598 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-11-12 23:04:27 +00:00
Scott Taylor 677762f6cf oEmbed: add Reddit Comments as a provider
Docs: https://github.com/reddit/reddit/wiki/oEmbed

Props swissspidy.
Fixes #31752.


Built from https://develop.svn.wordpress.org/trunk@35356


git-svn-id: http://core.svn.wordpress.org/trunk@35322 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-22 18:17:24 +00:00
John Blackbourn 35f613833e Update the explanatory text which accompanies the list of whitelisted oEmbed providers, following the change to the default value of the `discover` argument in `WP_oEmbed::get_provider()`.
See #32522

Built from https://develop.svn.wordpress.org/trunk@34907


git-svn-id: http://core.svn.wordpress.org/trunk@34872 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-07 13:05:25 +00:00
John Blackbourn 9d7d1508e2 Add VideoPress as a trusted oEmbed provider.
Fixes #34031
Props kraftbj

Built from https://develop.svn.wordpress.org/trunk@34785


git-svn-id: http://core.svn.wordpress.org/trunk@34750 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-10-02 23:20:28 +00:00
Drew Jaynes 6e47f2a1ee Docs: Slightly improve the readability of the data table in the DocBlock description for the `oembed_providers` hook by centering the HTTPS column.
See #32246.

Built from https://develop.svn.wordpress.org/trunk@34644


git-svn-id: http://core.svn.wordpress.org/trunk@34608 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-09-27 22:11:48 +00:00