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.


$link_html string
The archive HTML link content.
$url string
URL to archive.
$text string
Archive text description.
$format string
Link format. Can be 'link', 'option', 'html', or custom.
$before string
Content to prepend to the description.
$after string
Content to append to the description.
$selected bool
True if the current page is the selected archive.

Top ↑


File: wp-includes/general-template.php. View all references

return apply_filters( 'get_archives_link', $link_html, $url, $text, $format, $before, $after, $selected );

Top ↑


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

  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.