Commit Graph

54 Commits

Author SHA1 Message Date
Drew Jaynes f8657d5890 Remove redundant and erroneous `@uses` tag from most core inline documentation.
Per our inline documentation standards, no further use of the `@uses` tag is recommended as used and used-by relationships can be derived through other means. This removes most uses of the tag in core documentation, with remaining tags to be converted to `@global` or `@see` as they apply.

Fixes #30191.

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


git-svn-id: http://core.svn.wordpress.org/trunk@30105 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-30 01:05:24 +00:00
Jon Cave 37377f57aa Allow has_post_format() to be used to check for any format.
Calling has_post_format() with an empty list of $format will check if the
provided post has any associated format at all.

Props obenland, DrewAPicture, nacin. Fixes #24906.

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


git-svn-id: http://core.svn.wordpress.org/trunk@26251 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-11-24 13:45:10 +00:00
Andrew Nacin 02b214cd85 Allow has_post_format() to accept an array of formats to check. props ericmann. fixes #17320.
git-svn-id: http://core.svn.wordpress.org/trunk@24817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-07-28 20:48:09 +00:00
Andrew Nacin 098ea1a759 Revert title auto-generation for asides and statuses.
Reverts [24043] and related.

fixes #24011.



git-svn-id: http://core.svn.wordpress.org/trunk@24693 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-07-12 22:35:38 +00:00
Andrew Nacin 7690d7fbeb Move get_url_in_content() out of post-formats.php. see #24202.
git-svn-id: http://core.svn.wordpress.org/trunk@24683 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-07-12 19:38:37 +00:00
Andrew Nacin 4a1e326c1f Simplify and reduce the new media/content extraction functions.
The URL extraction function is now get_url_in_content(). For more, see #24202.

Also adds filters to get_post_galleries() and get_post_gallery(). fixes #24309.



git-svn-id: http://core.svn.wordpress.org/trunk@24682 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-07-12 19:34:59 +00:00
Dominik Schilling 6ba7413fbd Lose content removal and splitting from get_content_url(). And remove unneeded lines from [24400].
fixes #24484.

git-svn-id: http://core.svn.wordpress.org/trunk@24554 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-07-03 22:36:13 +00:00
Mark Jaquith fe5b462eea Remove a bunch of Post Format template functions.
* get_post_format_meta()
* add_chat_detection_format()
* get_content_chat()
* get_the_post_format_chat()
* the_post_format_chat()
* get_content_quote()
* get_the_post_format_quote()
* the_post_format_quote()
* get_the_post_format_url()
* the_post_format_url()
* get_the_remaining_content()
* the_remaining_content()

see #24452

git-svn-id: http://core.svn.wordpress.org/trunk@24399 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-06-02 16:26:10 +00:00
Mark Jaquith c5530f9fc6 Revert [23450]. Removes post format compat.
see #23347, #24452. closes #24454.

git-svn-id: http://core.svn.wordpress.org/trunk@24387 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-30 17:55:22 +00:00
Sergey Biryukov 063b1d4cb8 Use correct variable. props tollmanz. fixes #24419.
git-svn-id: http://core.svn.wordpress.org/trunk@24353 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-25 11:35:43 +00:00
Ryan Boren a2b4bc456f * Introduce wp_parse_post_content() and use it in setup_postdata(), get_the_content(), and get_the_remaining_content().
* Add a post ID argument to the_content(), get_the_content(), the_remaining_content(), and get_the_remaining_content().
* Pass the post ID to the the_content filter.
* Remove the format_pages global.
* Declare format_content and split_content as vars in WP_Post.
* phpdoc for the the_content filter that documents the new ID argument and denotes it as not-so-portable.

Props gcorne, DrewAPicture, duck_, aaroncampbell
see #24330


git-svn-id: http://core.svn.wordpress.org/trunk@24301 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-20 11:05:50 +00:00
Ryan Boren f14b0c3e13 Remove redundant post ID validation.
Props SergeyBiryukov
fixes #24199


git-svn-id: http://core.svn.wordpress.org/trunk@24249 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-14 13:57:59 +00:00
Mark Jaquith 0a67245cfd Revert change to get_post_format() introduced in [24226].
see #24291

git-svn-id: http://core.svn.wordpress.org/trunk@24242 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-10 23:22:51 +00:00
Mark Jaquith 74c6071b9d Improve regular expressions by using a backreference to match right quote of quote pair when matching attributes.
props kovshenin. see #24225.

git-svn-id: http://core.svn.wordpress.org/trunk@24241 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-10 22:54:33 +00:00
Sergey Biryukov 4f2a58e3df Update _post_formats_fix_empty_title() description. Make it clear that 'wp_insert_post_data' is a filter, not an action. props DrewAPicture. fixes #24303.
git-svn-id: http://core.svn.wordpress.org/trunk@24233 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-10 14:53:34 +00:00
Mark Jaquith f63001eb2c Improve the UX and flow of the Image post format.
* Drag-and-drop
* Textarea for HTML/URL hidden to start
* Bigger click target for entering Media modal
* Image preview height-contrained to 300 pixels
* Hid the alignment, size, etc options that didn't have an effect anyway
* Got wp-format-{format} into the <body> class

props DrewAPicture, aaroncampbell, markjaquith, azaozz. see #24291.

git-svn-id: http://core.svn.wordpress.org/trunk@24226 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-09 22:45:14 +00:00
Sergey Biryukov 57c10eadbb Use ellipsis instead of three dots. props tjsingleton, jordie23, wojtek.szkutnik, DrewAPicture, SergeyBiryukov. see #8714.
git-svn-id: http://core.svn.wordpress.org/trunk@24207 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-08 21:27:31 +00:00
Mark Jaquith 22c80c1a99 Add a 'quote_source_format' filter and make the default an em-dash and a space preceding the source.
fixes #24243

git-svn-id: http://core.svn.wordpress.org/trunk@24170 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-05-03 19:08:47 +00:00
Sergey Biryukov 4705c96648 Make $post_id argument optional for _post_formats_title(). props kovshenin. fixes #24233. see #24011.
git-svn-id: http://core.svn.wordpress.org/trunk@24146 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-30 23:48:18 +00:00
Andrew Nacin 3139a0451e Variables passed by reference do not need to be set first.
props kovshenin.
see #24222.



git-svn-id: http://core.svn.wordpress.org/trunk@24129 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-29 14:48:31 +00:00
Mark Jaquith 644e5b7bd6 Prevent a PHP Warning for $post_format.
props MZAWeb, kovshenin. see #24011.

git-svn-id: http://core.svn.wordpress.org/trunk@24094 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-25 08:02:38 +00:00
Mark Jaquith 759b3f5e82 Fix redundant use of array_keys() around get_post_format_slugs().
props SergeyBirkukov, wonderboymusic. fixes #24089.

git-svn-id: http://core.svn.wordpress.org/trunk@24082 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-25 03:06:31 +00:00
Mark Jaquith c546e83a58 Add a post_format_meta filter.
props alexkingorg. fixes #24162.

git-svn-id: http://core.svn.wordpress.org/trunk@24080 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-25 02:31:42 +00:00
Mark Jaquith cd0bbd830c Fix mangled image output in compat function.
props wonderboymusic. see #24175.

git-svn-id: http://core.svn.wordpress.org/trunk@24078 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-25 02:18:49 +00:00
Helen Hou-Sandí e5cf5ca63d Respect $compat values for the link format fallback output. props wonderboymusic. see #23347.
git-svn-id: http://core.svn.wordpress.org/trunk@24075 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-23 23:19:29 +00:00
Mark Jaquith 8ec637b13d Fix some mangled HTML in image format posts compat.
props SergeyBiryukov. fixes #24147.

git-svn-id: http://core.svn.wordpress.org/trunk@24062 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-22 21:01:03 +00:00
Andrew Nacin 84c41080f5 Return false in get_post_format() if the post does not exist.
props adamsilverstein, ericlewis.
fixes #23255.



git-svn-id: http://core.svn.wordpress.org/trunk@24057 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-22 20:41:16 +00:00
Sergey Biryukov b8805d7f22 Correct phpdoc for get_content_quote(). props kovshenin. see #24009.
git-svn-id: http://core.svn.wordpress.org/trunk@24045 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-22 14:36:43 +00:00
Mark Jaquith 18aab9531a Hide the post title and auto-generate based on the post body, for the status and aside post formats.
props kovshenin. see #24011.

git-svn-id: http://core.svn.wordpress.org/trunk@24043 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-22 04:00:25 +00:00
Mark Jaquith 2d382c1a5c Post Formats: use the content body for the body of the Quote post format.
* Searchable, better editing tools
* Less cluttered Post Format UI

props kovshenin, DrewAPicture. see #24009

git-svn-id: http://core.svn.wordpress.org/trunk@24034 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-18 18:07:58 +00:00
Mark Jaquith 412161de03 Standardize post format postmeta keys around the ones already used by the Crowd Favorite plugin.
props wonderboymusic. fixes #24010.

git-svn-id: http://core.svn.wordpress.org/trunk@24021 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-17 20:57:44 +00:00
Mark Jaquith df5e61ad54 Link post format images if a URL is provided. Make the URL available via get_the_post_format_url().
props wonderboymusic, obenland. fixes #23964.

git-svn-id: http://core.svn.wordpress.org/trunk@23992 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-14 16:59:52 +00:00
Mark Jaquith 79075d6f6e Fix some Skype chat parsing issues.
props wonderboymusic. see #23625.

git-svn-id: http://core.svn.wordpress.org/trunk@23978 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-12 22:22:41 +00:00
Sergey Biryukov b4859e8411 PHPDoc fixes and additions for post formats. props c3mdigital, DrewAPicture. fixes #23974.
git-svn-id: http://core.svn.wordpress.org/trunk@23935 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-09 09:38:25 +00:00
Sergey Biryukov 7412235232 Pass the post ID to the_title filter in post_formats_compat(). props danielbachhuber. see #23347.
git-svn-id: http://core.svn.wordpress.org/trunk@23924 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-06 08:11:23 +00:00
Sergey Biryukov f7e2bb59d6 Check for [\r\n\t ] instead of \s in get_content_chat() to avoid UTF-8 issues. see #23625.
git-svn-id: http://core.svn.wordpress.org/trunk@23914 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-04 23:43:59 +00:00
Mark Jaquith 15dc5a3718 Standardize the post format theme API functions with the_post_format_THING() and get_the_post_format_THING().
fixes #23927

git-svn-id: http://core.svn.wordpress.org/trunk@23899 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-04-04 08:09:02 +00:00
Mark Jaquith 4b50a68937 Avoid PHP notice on blank chat lines. props SergeyBiryukov. see #23625
git-svn-id: http://core.svn.wordpress.org/trunk@23880 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-30 17:04:08 +00:00
Mark Jaquith 6d085d83d5 Chat post format code cleanup.
see #23625. props obenland.

git-svn-id: http://core.svn.wordpress.org/trunk@23876 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-29 21:06:37 +00:00
Mark Jaquith 22b45b2fbb Add compat code for 'image' post format.
see #19570. props wonderboymusic.

git-svn-id: http://core.svn.wordpress.org/trunk@23847 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-29 05:21:23 +00:00
Mark Jaquith c93e0231af Post Format UI.
* Icons
* Selection
* Prompt text
* Special fields
* Styling
* Sparkles

This is going to need testing, polish, and love.

see #19570. props melchoyce, helen, wonderboymusic, lessbloat, rachelbaker, aaroncampbell, DrewAPicture, ryelle.

git-svn-id: http://core.svn.wordpress.org/trunk@23843 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-29 03:35:41 +00:00
Mark Jaquith 816618be68 Rename the_extra_content() to the_remaining_content().
fixes #23877.

git-svn-id: http://core.svn.wordpress.org/trunk@23836 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-28 05:59:18 +00:00
Mark Jaquith d1d2a3a3ff Better default quote markup for post format fallbacks.
props obenland. see #23347

git-svn-id: http://core.svn.wordpress.org/trunk@23822 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-27 19:21:56 +00:00
Mark Jaquith 1b83157127 Give themers tangible, user-friendly template functions to take full advantage of structured post formats.
* the_audio()
* the_video()
* the_image()
* get_the_media()

Also introduces:

* get_the_extra_content()
* the_extra_content()

Those two functions are like their non-extra versions, except that they
will have any post-format bits extracted. e.g. It's an image post, for
which the_image() will extract an <img /> tag. the_extra_content() will
output the content *without* that image.

props wonderboymusic. Herculean effort. fixes #23572

git-svn-id: http://core.svn.wordpress.org/trunk@23819 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-27 18:34:59 +00:00
Mark Jaquith e11cb17f77 Extract chats as structured data.
* add_chat_detection_format() — to add a chat regex pattern
* get_content_chat() — to grab a chat from content
* get_the_chat() — grab the chat from the current (or passed) post
* the_chat() — output the chat in formatted HTML
* paginate_content() — puts the <!--nextpage--> splitting stuff into a function
* get_paged_content() — grabs a page of raw content, needed to paginate chats properly

see #23625. props wonderboymusic, lancewillett.

git-svn-id: http://core.svn.wordpress.org/trunk@23804 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-27 08:31:12 +00:00
Sergey Biryukov b4dbe1907d Fix order of in_array() parameters. props lancewillett. see #23570.
git-svn-id: http://core.svn.wordpress.org/trunk@23789 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-22 18:58:55 +00:00
Helen Hou-Sandí 3f5f4fa62e Add a filter for get_the_url(). Make sure get_the_url() also checks for the quote post format, as it currently has a URL field. see #23570.
git-svn-id: http://core.svn.wordpress.org/trunk@23775 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-22 07:28:56 +00:00
Mark Jaquith dd07ebb9b9 Add functions to extract a URL from an arbitrary string, HTML, or the current $post
props wonderboymusic. see #23570

git-svn-id: http://core.svn.wordpress.org/trunk@23773 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-22 05:25:20 +00:00
Helen Hou-Sandí 25c272856b Remove separate meta fields for image and gallery post formats. These are proving to be more confusing and labor-intensive from both a user and dev perspective than entering into the regular content editor. We will rely on good content parsing instead. See #19570, #23347.
git-svn-id: http://core.svn.wordpress.org/trunk@23753 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-19 17:18:07 +00:00
Mark Jaquith 53d12e91bc Introduce [audio] and [video] shortcodes, and use MediaElement.js to play them.
props wonderboymusic. see #23282.

git-svn-id: http://core.svn.wordpress.org/trunk@23729 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2013-03-16 05:25:44 +00:00