<?php /** * Server-side rendering of the `core/footnotes` block. * * @package WordPress */ /** * Renders the `core/footnotes` block on the server. * * @since 6.3.0 * * @param array $attributes Block attributes. * @param string $content Block default content. * @param WP_Block $block Block instance. * * @return string Returns the HTML representing the footnotes. */ function render_block_core_footnotes( $attributes, $content, $block ) { // Bail out early if the post ID is not set for some reason. if ( empty( $block->context['postId'] ) ) { return ''; } if ( post_password_required( $block->context['postId'] ) ) { return; } $footnotes = get_post_meta( $block->context['postId'], 'footnotes', true ); if ( ! $footnotes ) { return; } $footnotes = json_decode( $footnotes, true ); if ( ! is_array( $footnotes ) || count( $footnotes ) === 0 ) { return ''; } $wrapper_attributes = get_block_wrapper_attributes(); $block_content = ''; foreach ( $footnotes as $footnote ) { $block_content .= sprintf( '<li id="%1$s">%2$s <a href="#%1$s-link">↩︎</a></li>', $footnote['id'], $footnote['content'] ); } return sprintf( '<ol %1$s>%2$s</ol>', $wrapper_attributes, $block_content ); } /** * Registers the `core/footnotes` block on the server. * * @since 6.3.0 */ function register_block_core_footnotes() { foreach ( array( 'post', 'page' ) as $post_type ) { register_post_meta( $post_type, 'footnotes', array( 'show_in_rest' => true, 'single' => true, 'type' => 'string', ) ); } register_block_type_from_metadata( __DIR__ . '/footnotes', array( 'render_callback' => 'render_block_core_footnotes', ) ); } add_action( 'init', 'register_block_core_footnotes' ); /** * Saves the footnotes meta value to the revision. * * @since 6.3.0 * * @param int $revision_id The revision ID. */ function wp_save_footnotes_meta( $revision_id ) { $post_id = wp_is_post_revision( $revision_id ); if ( $post_id ) { $footnotes = get_post_meta( $post_id, 'footnotes', true ); if ( $footnotes ) { // Can't use update_post_meta() because it doesn't allow revisions. update_metadata( 'post', $revision_id, 'footnotes', wp_slash( $footnotes ) ); } } } add_action( 'wp_after_insert_post', 'wp_save_footnotes_meta' ); /** * Keeps track of the revision ID for "rest_after_insert_{$post_type}". * * @since 6.3.0 * * @global int $wp_temporary_footnote_revision_id The footnote revision ID. * * @param int $revision_id The revision ID. */ function wp_keep_footnotes_revision_id( $revision_id ) { global $wp_temporary_footnote_revision_id; $wp_temporary_footnote_revision_id = $revision_id; } add_action( '_wp_put_post_revision', 'wp_keep_footnotes_revision_id' ); /** * This is a specific fix for the REST API. The REST API doesn't update * the post and post meta in one go (through `meta_input`). While it * does fix the `wp_after_insert_post` hook to be called correctly after * updating meta, it does NOT fix hooks such as post_updated and * save_post, which are normally also fired after post meta is updated * in `wp_insert_post()`. Unfortunately, `wp_save_post_revision` is * added to the `post_updated` action, which means the meta is not * available at the time, so we have to add it afterwards through the * `"rest_after_insert_{$post_type}"` action. * * @since 6.3.0 * * @global int $wp_temporary_footnote_revision_id The footnote revision ID. * * @param WP_Post $post The post object. */ function wp_add_footnotes_revisions_to_post_meta( $post ) { global $wp_temporary_footnote_revision_id; if ( $wp_temporary_footnote_revision_id ) { $revision = get_post( $wp_temporary_footnote_revision_id ); if ( ! $revision ) { return; } $post_id = $revision->post_parent; // Just making sure we're updating the right revision. if ( $post->ID === $post_id ) { $footnotes = get_post_meta( $post_id, 'footnotes', true ); if ( $footnotes ) { // Can't use update_post_meta() because it doesn't allow revisions. update_metadata( 'post', $wp_temporary_footnote_revision_id, 'footnotes', wp_slash( $footnotes ) ); } } } } add_action( 'rest_after_insert_post', 'wp_add_footnotes_revisions_to_post_meta' ); add_action( 'rest_after_insert_page', 'wp_add_footnotes_revisions_to_post_meta' ); /** * Restores the footnotes meta value from the revision. * * @since 6.3.0 * * @param int $post_id The post ID. * @param int $revision_id The revision ID. */ function wp_restore_footnotes_from_revision( $post_id, $revision_id ) { $footnotes = get_post_meta( $revision_id, 'footnotes', true ); if ( $footnotes ) { update_post_meta( $post_id, 'footnotes', wp_slash( $footnotes ) ); } else { delete_post_meta( $post_id, 'footnotes' ); } } add_action( 'wp_restore_post_revision', 'wp_restore_footnotes_from_revision', 10, 2 ); /** * Adds the footnotes field to the revision. * * @since 6.3.0 * * @param array $fields The revision fields. * @return array The revision fields. */ function wp_add_footnotes_to_revision( $fields ) { $fields['footnotes'] = __( 'Footnotes' ); return $fields; } add_filter( '_wp_post_revision_fields', 'wp_add_footnotes_to_revision' ); /** * Gets the footnotes field from the revision. * * @since 6.3.0 * * @param string $revision_field The field value, but $revision->$field * (footnotes) does not exist. * @param string $field The field name, in this case "footnotes". * @param object $revision The revision object to compare against. * @return string The field value. */ function wp_get_footnotes_from_revision( $revision_field, $field, $revision ) { return get_metadata( 'post', $revision->ID, $field, true ); } add_filter( '_wp_post_revision_field_footnotes', 'wp_get_footnotes_from_revision', 10, 3 ); /** * The REST API autosave endpoint doesn't save meta, so we can use the * `wp_creating_autosave` when it updates an exiting autosave, and * `_wp_put_post_revision` when it creates a new autosave. * * @since 6.3.0 * * @param int|array $autosave The autosave ID or array. */ function _wp_rest_api_autosave_meta( $autosave ) { // Ensure it's a REST API request. if ( ! defined( 'REST_REQUEST' ) || ! REST_REQUEST ) { return; } $body = rest_get_server()->get_raw_data(); $body = json_decode( $body, true ); if ( ! isset( $body['meta']['footnotes'] ) ) { return; } // `wp_creating_autosave` passes the array, // `_wp_put_post_revision` passes the ID. $id = is_int( $autosave ) ? $autosave : $autosave['ID']; if ( ! $id ) { return; } update_post_meta( $id, 'footnotes', wp_slash( $body['meta']['footnotes'] ) ); } // See https://github.com/WordPress/wordpress-develop/blob/2103cb9966e57d452c94218bbc3171579b536a40/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php#L391C1-L391C1. add_action( 'wp_creating_autosave', '_wp_rest_api_autosave_meta' ); // See https://github.com/WordPress/wordpress-develop/blob/2103cb9966e57d452c94218bbc3171579b536a40/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php#L398. // Then https://github.com/WordPress/wordpress-develop/blob/2103cb9966e57d452c94218bbc3171579b536a40/src/wp-includes/revision.php#L367. add_action( '_wp_put_post_revision', '_wp_rest_api_autosave_meta' ); /** * This is a workaround for the autosave endpoint returning early if the * revision field are equal. The problem is that "footnotes" is not real * revision post field, so there's nothing to compare against. * * This trick sets the "footnotes" field (value doesn't matter), which will * cause the autosave endpoint to always update the latest revision. That should * be fine, it should be ok to update the revision even if nothing changed. Of * course, this is temporary fix. * * @since 6.3.0 * * @param WP_Post $prepared_post The prepared post object. * @param WP_REST_Request $request The request object. * * See https://github.com/WordPress/wordpress-develop/blob/2103cb9966e57d452c94218bbc3171579b536a40/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php#L365-L384. * See https://github.com/WordPress/wordpress-develop/blob/2103cb9966e57d452c94218bbc3171579b536a40/src/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php#L219. */ function _wp_rest_api_force_autosave_difference( $prepared_post, $request ) { // We only want to be altering POST requests. if ( $request->get_method() !== 'POST' ) { return $prepared_post; } // Only alter requests for the '/autosaves' route. if ( substr( $request->get_route(), -strlen( '/autosaves' ) ) !== '/autosaves' ) { return $prepared_post; } $prepared_post->footnotes = '[]'; return $prepared_post; } add_filter( 'rest_pre_insert_post', '_wp_rest_api_force_autosave_difference', 10, 2 );
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
archives | Folder | 0755 |
|
|
audio | Folder | 0755 |
|
|
avatar | Folder | 0755 |
|
|
block | Folder | 0755 |
|
|
button | Folder | 0755 |
|
|
buttons | Folder | 0755 |
|
|
calendar | Folder | 0755 |
|
|
categories | Folder | 0755 |
|
|
code | Folder | 0755 |
|
|
column | Folder | 0755 |
|
|
columns | Folder | 0755 |
|
|
comment-author-name | Folder | 0755 |
|
|
comment-content | Folder | 0755 |
|
|
comment-date | Folder | 0755 |
|
|
comment-edit-link | Folder | 0755 |
|
|
comment-reply-link | Folder | 0755 |
|
|
comment-template | Folder | 0755 |
|
|
comments | Folder | 0755 |
|
|
comments-pagination | Folder | 0755 |
|
|
comments-pagination-next | Folder | 0755 |
|
|
comments-pagination-numbers | Folder | 0755 |
|
|
comments-pagination-previous | Folder | 0755 |
|
|
comments-title | Folder | 0755 |
|
|
cover | Folder | 0755 |
|
|
details | Folder | 0755 |
|
|
embed | Folder | 0755 |
|
|
file | Folder | 0755 |
|
|
footnotes | Folder | 0755 |
|
|
freeform | Folder | 0755 |
|
|
gallery | Folder | 0755 |
|
|
group | Folder | 0755 |
|
|
heading | Folder | 0755 |
|
|
home-link | Folder | 0755 |
|
|
html | Folder | 0755 |
|
|
image | Folder | 0755 |
|
|
latest-comments | Folder | 0755 |
|
|
latest-posts | Folder | 0755 |
|
|
legacy-widget | Folder | 0755 |
|
|
list | Folder | 0755 |
|
|
list-item | Folder | 0755 |
|
|
loginout | Folder | 0755 |
|
|
media-text | Folder | 0755 |
|
|
missing | Folder | 0755 |
|
|
more | Folder | 0755 |
|
|
navigation | Folder | 0755 |
|
|
navigation-link | Folder | 0755 |
|
|
navigation-submenu | Folder | 0755 |
|
|
nextpage | Folder | 0755 |
|
|
page-list | Folder | 0755 |
|
|
page-list-item | Folder | 0755 |
|
|
paragraph | Folder | 0755 |
|
|
pattern | Folder | 0755 |
|
|
post-author | Folder | 0755 |
|
|
post-author-biography | Folder | 0755 |
|
|
post-author-name | Folder | 0755 |
|
|
post-comments-form | Folder | 0755 |
|
|
post-content | Folder | 0755 |
|
|
post-date | Folder | 0755 |
|
|
post-excerpt | Folder | 0755 |
|
|
post-featured-image | Folder | 0755 |
|
|
post-navigation-link | Folder | 0755 |
|
|
post-template | Folder | 0755 |
|
|
post-terms | Folder | 0755 |
|
|
post-title | Folder | 0755 |
|
|
preformatted | Folder | 0755 |
|
|
pullquote | Folder | 0755 |
|
|
query | Folder | 0755 |
|
|
query-no-results | Folder | 0755 |
|
|
query-pagination | Folder | 0755 |
|
|
query-pagination-next | Folder | 0755 |
|
|
query-pagination-numbers | Folder | 0755 |
|
|
query-pagination-previous | Folder | 0755 |
|
|
query-title | Folder | 0755 |
|
|
quote | Folder | 0755 |
|
|
read-more | Folder | 0755 |
|
|
rss | Folder | 0755 |
|
|
search | Folder | 0755 |
|
|
separator | Folder | 0755 |
|
|
shortcode | Folder | 0755 |
|
|
site-logo | Folder | 0755 |
|
|
site-tagline | Folder | 0755 |
|
|
site-title | Folder | 0755 |
|
|
social-link | Folder | 0755 |
|
|
social-links | Folder | 0755 |
|
|
spacer | Folder | 0755 |
|
|
table | Folder | 0755 |
|
|
tag-cloud | Folder | 0755 |
|
|
template-part | Folder | 0755 |
|
|
term-description | Folder | 0755 |
|
|
text-columns | Folder | 0755 |
|
|
verse | Folder | 0755 |
|
|
video | Folder | 0755 |
|
|
widget-group | Folder | 0755 |
|
|
archives.php | File | 2.89 KB | 0644 |
|
avatar.php | File | 5.55 KB | 0644 |
|
block.php | File | 1.57 KB | 0644 |
|
blocks-json.php | File | 156.18 KB | 0644 |
|
calendar.php | File | 6.03 KB | 0644 |
|
categories.php | File | 2.78 KB | 0644 |
|
comment-author-name.php | File | 2.05 KB | 0644 |
|
comment-content.php | File | 2.36 KB | 0644 |
|
comment-date.php | File | 1.56 KB | 0644 |
|
comment-edit-link.php | File | 1.64 KB | 0644 |
|
comment-reply-link.php | File | 1.99 KB | 0644 |
|
comment-template.php | File | 4.35 KB | 0644 |
|
comments-pagination-next.php | File | 1.81 KB | 0644 |
|
comments-pagination-numbers.php | File | 1.56 KB | 0644 |
|
comments-pagination-previous.php | File | 1.61 KB | 0644 |
|
comments-pagination.php | File | 1.13 KB | 0644 |
|
comments-title.php | File | 2.67 KB | 0644 |
|
comments.php | File | 6.47 KB | 0644 |
|
cover.php | File | 2.45 KB | 0644 |
|
file.php | File | 3.38 KB | 0644 |
|
footnotes.php | File | 8.69 KB | 0644 |
|
gallery.php | File | 4.85 KB | 0644 |
|
heading.php | File | 1.23 KB | 0644 |
|
home-link.php | File | 4.72 KB | 0644 |
|
image.php | File | 1.29 KB | 0644 |
|
index.php | File | 4.45 KB | 0644 |
|
latest-comments.php | File | 4.88 KB | 0644 |
|
latest-posts.php | File | 7.87 KB | 0644 |
|
legacy-widget.php | File | 3.81 KB | 0644 |
|
loginout.php | File | 1.35 KB | 0644 |
|
navigation-link.php | File | 11.65 KB | 0644 |
|
navigation-submenu.php | File | 9.18 KB | 0644 |
|
navigation.php | File | 37.5 KB | 0644 |
|
page-list-item.php | File | 342 B | 0644 |
|
page-list.php | File | 13.14 KB | 0644 |
|
pattern.php | File | 1.01 KB | 0644 |
|
post-author-biography.php | File | 1.41 KB | 0644 |
|
post-author-name.php | File | 1.71 KB | 0644 |
|
post-author.php | File | 2.51 KB | 0644 |
|
post-comments-form.php | File | 2.68 KB | 0644 |
|
post-content.php | File | 2.28 KB | 0644 |
|
post-date.php | File | 2.29 KB | 0644 |
|
post-excerpt.php | File | 3.33 KB | 0644 |
|
post-featured-image.php | File | 7.63 KB | 0644 |
|
post-navigation-link.php | File | 4.37 KB | 0644 |
|
post-template.php | File | 4.86 KB | 0644 |
|
post-terms.php | File | 3.27 KB | 0644 |
|
post-title.php | File | 2.02 KB | 0644 |
|
query-no-results.php | File | 1.76 KB | 0644 |
|
query-pagination-next.php | File | 2.9 KB | 0644 |
|
query-pagination-numbers.php | File | 3.73 KB | 0644 |
|
query-pagination-previous.php | File | 2.36 KB | 0644 |
|
query-pagination.php | File | 1.11 KB | 0644 |
|
query-title.php | File | 2.01 KB | 0644 |
|
query.php | File | 304 B | 0644 |
|
read-more.php | File | 1.75 KB | 0644 |
|
require-dynamic-blocks.php | File | 3.85 KB | 0644 |
|
require-static-blocks.php | File | 536 B | 0644 |
|
rss.php | File | 3.83 KB | 0644 |
|
search.php | File | 21.61 KB | 0644 |
|
shortcode.php | File | 697 B | 0644 |
|
site-logo.php | File | 5.79 KB | 0644 |
|
site-tagline.php | File | 994 B | 0644 |
|
site-title.php | File | 1.73 KB | 0644 |
|
social-link.php | File | 59.13 KB | 0644 |
|
tag-cloud.php | File | 1.37 KB | 0644 |
|
template-part.php | File | 9.71 KB | 0644 |
|
term-description.php | File | 1.27 KB | 0644 |
|
widget-group.php | File | 2.12 KB | 0644 |
|