apply_filters( 'get_archives_link', string $link_html, string $url, string $text, string $format, string $before, string $after, bool $selected )

Filters the archive link content.

Description Description

Parameters Parameters


(string) The archive HTML link content.


(string) URL to archive.


(string) Archive text description.


(string) Link format. Can be 'link', 'option', 'html', or custom.


(string) Content to prepend to the description.


(string) Content to append to the description.


(bool) True if the current page is the selected archive.

Top ↑

Source Source

File: wp-includes/general-template.php

View on Trac

Top ↑

Changelog Changelog

Version Description
5.2.0 Added the $selected parameter.
4.5.0 Added the $url, $text, $format, $before, and $after parameters.
2.6.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Mário Valney

    You can use this filter to add current-archive class to element (as current-cat in wp_list_categories() function):

    function example_get_archives_link($link_html) {
        if (is_day() || is_month() || is_year()) {
            if (is_day()) {
                $data = get_the_time('Y/m/d');
            } elseif (is_month()) {
                $data = get_the_time('Y/m');
            } elseif (is_year()) {
                $data = get_the_time('Y');
            // Link to archive page
            $link = home_url($data);
            // Check if the link is in string
            $strpos = strpos($link_html, $link);
            // Add class if link has been found
            if ($strpos !== false) {
                $link_html = str_replace('<li>', '<li class="current-archive">', $link_html);
        return $link_html;
    add_filter("get_archives_link", "example_get_archives_link");

You must log in before being able to contribute a note or feedback.