twentynineteen_get_the_archive_title()
- Source
wp-content/themes/twentynineteen/inc/template-functions.php:76
Compatibility
- WordPress
- core
- PHP
- 7.4–8.6-dev
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.
Performance profile
How much work a call to twentynineteen_get_the_archive_title() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.
- Cost class
- Heavy
- Scaling
- Constant
- Instructions
- 15–44
- Plugin surface
- None
- Called by
- 0
Reaches the database via get_post().
No loop in the body: the same number of instructions runs whatever you pass in.
Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 139.
Nothing here hands control to plugin code.
Nothing in core calls this; the cost is only what you spend yourself.
What it touches
- hookthird-party callbacks
apply_filters()one call below twentynineteen_get_the_archive_title() - querycontent query
get_post()one call below twentynineteen_get_the_archive_title() - optionoption read or write
get_option()one call below twentynineteen_get_the_archive_title()
Further down the call graph this can also reach cache, serialize and transient. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.
What one call costs · 9 distinct outcomes
One number would be a lie: the work depends on which branch runs. These are every distinct cost twentynineteen_get_the_archive_title() can have, taken from its control-flow graph on PHP 8.5.
| When | Instructions | Calls it makes |
|---|---|---|
is_category() | 15 | is_category(), __(), single_term_title() |
!is_category() && is_tag() | 18 | is_category(), is_tag(), __(), single_term_title() |
!is_category() && !is_tag() && is_author() | 20 | is_category(), is_tag(), is_author(), __(), get_the_author_meta() |
!is_category() && !is_tag() && !is_author() && is_year() | 28 | is_category(), is_tag(), is_author(), is_year(), __(), _x(), get_the_date() |
!is_category() && !is_tag() && !is_author() && !is_year() && !is_month() && is_day() | 28 | is_category(), is_tag(), is_author(), is_year(), is_month(), is_day(), __(), get_the_date() |
!is_category() && !is_tag() && !is_author() && !is_year() && !is_month() && !is_day() && !is_post_type_archive() && !is_tax() | 30 | is_category(), is_tag(), is_author(), is_year(), is_month(), is_day(), is_post_type_archive(), is_tax(), __() |
!is_category() && !is_tag() && !is_author() && !is_year() && is_month() | 31 | is_category(), is_tag(), is_author(), is_year(), is_month(), __(), _x(), get_the_date() |
!is_category() && !is_tag() && !is_author() && !is_year() && !is_month() && !is_day() && is_post_type_archive() | 33 | is_category(), is_tag(), is_author(), is_year(), is_month(), is_day(), is_post_type_archive(), __(), post_type_archive_title() |
!is_category() && !is_tag() && !is_author() && !is_year() && !is_month() && !is_day() && !is_post_type_archive() && is_tax() | 44 | is_category(), is_tag(), is_author(), is_year(), is_month(), is_day(), is_post_type_archive(), is_tax(), get_queried_object(), get_taxonomy(), esc_html__(), sprintf() |
Across PHP versions
| PHP | Compiled | Executed | Branches | Notes |
|---|---|---|---|---|
| 8.6-dev | 139 | 15–44 | 8 | |
| 8.5 | 139 | 15–44 | 8 | |
| 8.4 | 139 | 15–44 | 8 | |
| 8.3 | 139 | 15–44 | 8 | |
| 8.2 | 139 | 15–44 | 8 | |
| 8.1 | 139 | 15–44 | 8 | 1 fewer instruction than PHP 7.4 |
| 7.4 | 140 | 15–45 | 8 |
An instruction is not a fixed amount of time, so a matching count is not necessarily the same speed; what it rules out is a difference in the work itself.
Uses · 17
- is_category()Determines whether the query is for an existing category archive page.
- __()Retrieves the translation of $text.
- single_term_title()Displays or retrieves page title for taxonomy term archive.
- is_tag()Determines whether the query is for an existing tag archive page.
- is_author()Determines whether the query is for an existing author archive page.
- get_the_author_meta()Retrieves the requested data of the author of the current post.
- is_year()Determines whether the query is for an existing year archive.
- get_the_date()Retrieves the date of the post.
- _x()Retrieves translated string with gettext context.
- is_month()Determines whether the query is for an existing month archive.
- is_day()Determines whether the query is for an existing day archive.
- is_post_type_archive()Determines whether the query is for an existing post type archive page.
Show all 17
- post_type_archive_title()Displays or retrieves title for a post type archive.
- is_tax()Determines whether the query is for an existing custom taxonomy archive page.
- get_taxonomy()Retrieves the taxonomy object of $taxonomy.
- get_queried_object()Retrieves the currently queried object.
- esc_html__()Retrieves the translation of $text and escapes it for safe use in HTML output.
Source code
function twentynineteen_get_the_archive_title() { if ( is_category() ) { $title = __( 'Category Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>'; } elseif ( is_tag() ) { $title = __( 'Tag Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>'; } elseif ( is_author() ) { $title = __( 'Author Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_author_meta( 'display_name' ) . '</span>'; } elseif ( is_year() ) { $title = __( 'Yearly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'Y', 'yearly archives date format', 'twentynineteen' ) ) . '</span>'; } elseif ( is_month() ) { $title = __( 'Monthly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'F Y', 'monthly archives date format', 'twentynineteen' ) ) . '</span>'; } elseif ( is_day() ) { $title = __( 'Daily Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date() . '</span>'; } elseif ( is_post_type_archive() ) { $title = __( 'Post Type Archives: ', 'twentynineteen' ) . '<span class="page-description">' . post_type_archive_title( '', false ) . '</span>'; } elseif ( is_tax() ) { $tax = get_taxonomy( get_queried_object()->taxonomy ); /* translators: %s: Taxonomy singular name. */ $title = sprintf( esc_html__( '%s Archives:', 'twentynineteen' ), $tax->labels->singular_name ); } else { $title = __( 'Archives:', 'twentynineteen' ); } return $title;}Changelog
Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 7.1.0 tag, from
src/wp-content/themes/twentynineteen/inc/template-functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it. - Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.