WordPress.org

Make WordPress Core

Ticket #21995: 21995.8.diff

File 21995.8.diff, 3.8 KB (added by obenland, 7 years ago)
  • src/wp-includes/general-template.php

     
    10961096}
    10971097
    10981098/**
     1099 * Display the archive title based on the queried object.
     1100 *
     1101 * @since 4.1.0
     1102 *
     1103 * @param string $before Optional. Content to prepend to the title.
     1104 * @param string $after  Optional. Content to append to the title.
     1105 */
     1106function the_archive_title( $before = '', $after = '' ) {
     1107        $title = get_the_archive_title();
     1108
     1109        if ( ! empty( $title ) ) {
     1110                echo $before . $title . $after;
     1111        }
     1112}
     1113
     1114/**
     1115 * Retrieve the archive title based on the queried object.
     1116 *
     1117 * @since 4.1.0
     1118 *
     1119 * @return string Archive title.
     1120 */
     1121function get_the_archive_title() {
     1122        if ( is_category() ) {
     1123                $title = sprintf( __( 'Category: %s' ), single_cat_title( '', false ) );
     1124        } elseif ( is_tag() ) {
     1125                $title = sprintf( __( 'Tag: %s' ), single_tag_title( '', false ) );
     1126        } elseif ( is_author() ) {
     1127                $title = sprintf( __( 'Author: %s' ), '<span class="vcard">' . get_the_author() . '</span>' );
     1128        } elseif ( is_year() ) {
     1129                $title = sprintf( __( 'Year: %s' ), get_the_date( _x( 'Y', 'yearly archives date format' ) ) );
     1130        } elseif ( is_month() ) {
     1131                $title = sprintf( __( 'Month: %s' ), get_the_date( _x( 'F Y', 'monthly archives date format' ) ) );
     1132        } elseif ( is_day() ) {
     1133                $title = sprintf( __( 'Day: %s' ), get_the_date() );
     1134        } elseif ( is_tax( 'post_format', 'post-format-aside' ) ) {
     1135                $title = __( 'Asides' );
     1136        } elseif ( is_tax( 'post_format', 'post-format-gallery' ) ) {
     1137                $title = __( 'Galleries' );
     1138        } elseif ( is_tax( 'post_format', 'post-format-image' ) ) {
     1139                $title = __( 'Images' );
     1140        } elseif ( is_tax( 'post_format', 'post-format-video' ) ) {
     1141                $title = __( 'Videos' );
     1142        } elseif ( is_tax( 'post_format', 'post-format-quote' ) ) {
     1143                $title = __( 'Quotes' );
     1144        } elseif ( is_tax( 'post_format', 'post-format-link' ) ) {
     1145                $title = __( 'Links' );
     1146        } elseif ( is_tax( 'post_format', 'post-format-status' ) ) {
     1147                $title = __( 'Statuses' );
     1148        } elseif ( is_tax( 'post_format', 'post-format-audio' ) ) {
     1149                $title = __( 'Audios' );
     1150        } elseif ( is_tax( 'post_format', 'post-format-chat' ) ) {
     1151                $title = __( 'Chats' );
     1152        } elseif ( is_post_type_archive() ) {
     1153                $title = sprintf( __( 'Archives: %s' ), post_type_archive_title( '', false ) );
     1154        } elseif ( is_tax() ) {
     1155                $tax = get_taxonomy( get_queried_object()->taxonomy );
     1156                /* translators: 1: Taxonomy singular name, 2: Current taxonomy term */
     1157                $title = sprintf( __( '%1$s: %2$s' ), $tax->labels->singular_name, single_term_title( '', false ) );
     1158        } else {
     1159                $title = __( 'Archives' );
     1160        }
     1161
     1162        /**
     1163         * Filter the archive title.
     1164         *
     1165         * @since 4.1.0
     1166         *
     1167         * @param string $title Archive title to be displayed.
     1168         */
     1169        return apply_filters( 'get_the_archive_title', $title );
     1170}
     1171
     1172/**
     1173 * Display category, tag, or term description.
     1174 *
     1175 * @since 4.1.0
     1176 *
     1177 * @param string $before Optional. Content to prepend to the description.
     1178 * @param string $after  Optional. Content to append to the description.
     1179 */
     1180function the_archive_description( $before = '', $after = '' ) {
     1181        $description = get_the_archive_description();
     1182
     1183        if ( ! empty( $description ) ) {
     1184                echo $before . $description . $after;
     1185        }
     1186}
     1187
     1188/**
     1189 * Retrieve category, tag, or term description.
     1190 *
     1191 * @since 4.1.0
     1192 *
     1193 * @return string Archive description.
     1194 */
     1195function get_the_archive_description() {
     1196
     1197        /**
     1198         * Filter the archive description.
     1199         *
     1200         * @since 4.1.0
     1201         *
     1202         * @param string $description Archive description to be displayed.
     1203         */
     1204        return apply_filters( 'get_the_archive_description', term_description() );
     1205}
     1206
     1207/**
    10991208 * Retrieve archive link content based on predefined or custom code.
    11001209 *
    11011210 * The format can be one of four styles. The 'link' for head element, 'option'