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

$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 ↑

Source Source

File: wp-includes/general-template.php

View on Trac


Top ↑

Changelog 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.