summaryrefslogtreecommitdiffstats
path: root/wp-includes/theme-templates.php
diff options
context:
space:
mode:
Diffstat (limited to 'wp-includes/theme-templates.php')
-rw-r--r--wp-includes/theme-templates.php231
1 files changed, 231 insertions, 0 deletions
diff --git a/wp-includes/theme-templates.php b/wp-includes/theme-templates.php
new file mode 100644
index 0000000..c01a4ec
--- /dev/null
+++ b/wp-includes/theme-templates.php
@@ -0,0 +1,231 @@
+<?php
+
+/**
+ * Sets a custom slug when creating auto-draft template parts.
+ *
+ * This is only needed for auto-drafts created by the regular WP editor.
+ * If this page is to be removed, this will not be necessary.
+ *
+ * @since 5.9.0
+ *
+ * @param int $post_id Post ID.
+ */
+function wp_set_unique_slug_on_create_template_part( $post_id ) {
+ $post = get_post( $post_id );
+ if ( 'auto-draft' !== $post->post_status ) {
+ return;
+ }
+
+ if ( ! $post->post_name ) {
+ wp_update_post(
+ array(
+ 'ID' => $post_id,
+ 'post_name' => 'custom_slug_' . uniqid(),
+ )
+ );
+ }
+
+ $terms = get_the_terms( $post_id, 'wp_theme' );
+ if ( ! is_array( $terms ) || ! count( $terms ) ) {
+ wp_set_post_terms( $post_id, get_stylesheet(), 'wp_theme' );
+ }
+}
+
+/**
+ * Generates a unique slug for templates.
+ *
+ * @access private
+ * @since 5.8.0
+ *
+ * @param string $override_slug The filtered value of the slug (starts as `null` from apply_filter).
+ * @param string $slug The original/un-filtered slug (post_name).
+ * @param int $post_id Post ID.
+ * @param string $post_status No uniqueness checks are made if the post is still draft or pending.
+ * @param string $post_type Post type.
+ * @return string The original, desired slug.
+ */
+function wp_filter_wp_template_unique_post_slug( $override_slug, $slug, $post_id, $post_status, $post_type ) {
+ if ( 'wp_template' !== $post_type && 'wp_template_part' !== $post_type ) {
+ return $override_slug;
+ }
+
+ if ( ! $override_slug ) {
+ $override_slug = $slug;
+ }
+
+ /*
+ * Template slugs must be unique within the same theme.
+ * TODO - Figure out how to update this to work for a multi-theme environment.
+ * Unfortunately using `get_the_terms()` for the 'wp-theme' term does not work
+ * in the case of new entities since is too early in the process to have been saved
+ * to the entity. So for now we use the currently activated theme for creation.
+ */
+ $theme = get_stylesheet();
+ $terms = get_the_terms( $post_id, 'wp_theme' );
+ if ( $terms && ! is_wp_error( $terms ) ) {
+ $theme = $terms[0]->name;
+ }
+
+ $check_query_args = array(
+ 'post_name__in' => array( $override_slug ),
+ 'post_type' => $post_type,
+ 'posts_per_page' => 1,
+ 'no_found_rows' => true,
+ 'post__not_in' => array( $post_id ),
+ 'tax_query' => array(
+ array(
+ 'taxonomy' => 'wp_theme',
+ 'field' => 'name',
+ 'terms' => $theme,
+ ),
+ ),
+ );
+ $check_query = new WP_Query( $check_query_args );
+ $posts = $check_query->posts;
+
+ if ( count( $posts ) > 0 ) {
+ $suffix = 2;
+ do {
+ $query_args = $check_query_args;
+ $alt_post_name = _truncate_post_slug( $override_slug, 200 - ( strlen( $suffix ) + 1 ) ) . "-$suffix";
+ $query_args['post_name__in'] = array( $alt_post_name );
+ $query = new WP_Query( $query_args );
+ ++$suffix;
+ } while ( count( $query->posts ) > 0 );
+ $override_slug = $alt_post_name;
+ }
+
+ return $override_slug;
+}
+
+/**
+ * Enqueues the skip-link script & styles.
+ *
+ * @access private
+ * @since 6.4.0
+ *
+ * @global string $_wp_current_template_content
+ */
+function wp_enqueue_block_template_skip_link() {
+ global $_wp_current_template_content;
+
+ // Back-compat for plugins that disable functionality by unhooking this action.
+ if ( ! has_action( 'wp_footer', 'the_block_template_skip_link' ) ) {
+ return;
+ }
+ remove_action( 'wp_footer', 'the_block_template_skip_link' );
+
+ // Early exit if not a block theme.
+ if ( ! current_theme_supports( 'block-templates' ) ) {
+ return;
+ }
+
+ // Early exit if not a block template.
+ if ( ! $_wp_current_template_content ) {
+ return;
+ }
+
+ $skip_link_styles = '
+ .skip-link.screen-reader-text {
+ border: 0;
+ clip: rect(1px,1px,1px,1px);
+ clip-path: inset(50%);
+ height: 1px;
+ margin: -1px;
+ overflow: hidden;
+ padding: 0;
+ position: absolute !important;
+ width: 1px;
+ word-wrap: normal !important;
+ }
+
+ .skip-link.screen-reader-text:focus {
+ background-color: #eee;
+ clip: auto !important;
+ clip-path: none;
+ color: #444;
+ display: block;
+ font-size: 1em;
+ height: auto;
+ left: 5px;
+ line-height: normal;
+ padding: 15px 23px 14px;
+ text-decoration: none;
+ top: 5px;
+ width: auto;
+ z-index: 100000;
+ }';
+
+ $handle = 'wp-block-template-skip-link';
+
+ /**
+ * Print the skip-link styles.
+ */
+ wp_register_style( $handle, false );
+ wp_add_inline_style( $handle, $skip_link_styles );
+ wp_enqueue_style( $handle );
+
+ /**
+ * Enqueue the skip-link script.
+ */
+ ob_start();
+ ?>
+ <script>
+ ( function() {
+ var skipLinkTarget = document.querySelector( 'main' ),
+ sibling,
+ skipLinkTargetID,
+ skipLink;
+
+ // Early exit if a skip-link target can't be located.
+ if ( ! skipLinkTarget ) {
+ return;
+ }
+
+ /*
+ * Get the site wrapper.
+ * The skip-link will be injected in the beginning of it.
+ */
+ sibling = document.querySelector( '.wp-site-blocks' );
+
+ // Early exit if the root element was not found.
+ if ( ! sibling ) {
+ return;
+ }
+
+ // Get the skip-link target's ID, and generate one if it doesn't exist.
+ skipLinkTargetID = skipLinkTarget.id;
+ if ( ! skipLinkTargetID ) {
+ skipLinkTargetID = 'wp--skip-link--target';
+ skipLinkTarget.id = skipLinkTargetID;
+ }
+
+ // Create the skip link.
+ skipLink = document.createElement( 'a' );
+ skipLink.classList.add( 'skip-link', 'screen-reader-text' );
+ skipLink.href = '#' + skipLinkTargetID;
+ skipLink.innerHTML = '<?php /* translators: Hidden accessibility text. */ esc_html_e( 'Skip to content' ); ?>';
+
+ // Inject the skip link.
+ sibling.parentElement.insertBefore( skipLink, sibling );
+ }() );
+ </script>
+ <?php
+ $skip_link_script = wp_remove_surrounding_empty_script_tags( ob_get_clean() );
+ $script_handle = 'wp-block-template-skip-link';
+ wp_register_script( $script_handle, false, array(), false, array( 'in_footer' => true ) );
+ wp_add_inline_script( $script_handle, $skip_link_script );
+ wp_enqueue_script( $script_handle );
+}
+
+/**
+ * Enables the block templates (editor mode) for themes with theme.json by default.
+ *
+ * @access private
+ * @since 5.8.0
+ */
+function wp_enable_block_templates() {
+ if ( wp_is_block_theme() || wp_theme_has_theme_json() ) {
+ add_theme_support( 'block-templates' );
+ }
+}