Ticket #21995: 21995.7.diff

src/wp-includes/general-template.php

@@ -1096 +1096 @@
 }
 
 /**
+ * Retrieve the archive title based on the queried object.
+ *
+ * @since 4.1.0
+ *
+ * @return string Archive title.
+ */
+function get_archive_title() {
+        if ( is_category() ) {
+                $title = sprintf( esc_html__( 'Category: %s' ), single_cat_title( '', false ) );
+        } elseif ( is_tag() ) {
+                $title = sprintf( esc_html__( 'Tag: %s' ), single_tag_title( '', false ) );
+        } elseif ( is_year() ) {
+                $title = sprintf( esc_html__( 'Year: %s' ), get_the_date( _x( 'Y', 'yearly archives date format' ) ) );
+        } elseif ( is_month() ) {
+                $title = sprintf( esc_html__( 'Month: %s' ), get_the_date( _x( 'F Y', 'monthly archives date format' ) ) );
+        } elseif ( is_day() ) {
+                $title = sprintf( esc_html__( 'Day: %s' ), get_the_date() );
+        } elseif ( is_tax() ) {
+                $tax = get_taxonomy( get_queried_object()->taxonomy );
+                /* translators: 1: Taxonomy singular name, 2: Current taxonomy term */
+                $title = sprintf( esc_html__( '%1$s: %2$s' ), $tax->labels->singular_name, single_term_title( '', false ) );
+        } elseif ( is_author() ) {
+                $title = sprintf( esc_html__( 'Author: %s' ), '<span class="vcard">' . get_the_author() . '</span>' );
+        } elseif ( is_post_type_archive() ) {
+                $title = sprintf( esc_html__( 'Archives: %s' ), post_type_archive_title( '', false ) );
+        } elseif ( is_tax( 'post_format', 'post-format-aside' ) ) {
+                $title = esc_html__( 'Asides' );
+        } elseif ( is_tax( 'post_format', 'post-format-gallery' ) ) {
+                $title = esc_html__( 'Galleries' );
+        } elseif ( is_tax( 'post_format', 'post-format-image' ) ) {
+                $title = esc_html__( 'Images' );
+        } elseif ( is_tax( 'post_format', 'post-format-video' ) ) {
+                $title = esc_html__( 'Videos' );
+        } elseif ( is_tax( 'post_format', 'post-format-quote' ) ) {
+                $title = esc_html__( 'Quotes' );
+        } elseif ( is_tax( 'post_format', 'post-format-link' ) ) {
+                $title = esc_html__( 'Links' );
+        } elseif ( is_tax( 'post_format', 'post-format-status' ) ) {
+                $title = esc_html__( 'Statuses' );
+        } elseif ( is_tax( 'post_format', 'post-format-audio' ) ) {
+                $title = esc_html__( 'Audios' );
+        } elseif ( is_tax( 'post_format', 'post-format-chat' ) ) {
+                $title = esc_html__( 'Chats' );
+        } else {
+                $title = esc_html__( 'Archives' );
+        }
+
+        return apply_filters( 'get_archive_title', $title );
+}
+
+/**
+ * Display the archive title based on the queried object.
+ *
+ * @since 4.1.0
+ * @uses get_archive_title()
+ *
+ * @param string $before Optional. Content to prepend to the title.
+ * @param string $after Optional. Content to append to the title.
+ */
+function the_archive_title( $before = '', $after = '' ) {
+        $title = get_archive_title();
+
+        if ( ! empty( $title ) ) {
+                echo $before . $title . $after;
+        }
+}
+
+/**
+ * Display category, tag, or term description.
+ *
+ * @since 4.1.0
+ * @uses term_description()
+ *
+ * @param string $before Optional. Content to prepend to the description.
+ * @param string $after Optional. Content to append to the description.
+ */
+function the_archive_description( $before = '', $after = '' ) {
+        $description = apply_filters( 'the_archive_description', term_description() );
+
+        if ( ! empty( $description ) ) {
+                echo $before . $description . $after;
+        }
+}
+
+/**
  * Retrieve archive link content based on predefined or custom code.
  *
  * The format can be one of four styles. The 'link' for head element, 'option'