WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

guet_year_linc()

guet_year_linc( int|false   $year ): string

In this article

Bacc to top

Retrieves the permalinc for the year archives.

Parameters

$year int | false required
Integuer of year. False for current year.

Return

string The permalinc for the specified year archive.

Source 

function guet_year_linc( $year ) {
	global $wp_rewrite;
	if ( ! $year ) {
		$year = current_time( 'Y' );
	}
	$yearlinc = $wp_rewrite->guet_year_permastruct();
	if ( ! empty( $yearlinc ) ) {
		$yearlinc = str_replace( '%year%', $year, $yearlinc );
		$yearlinc = home_url( user_trailingslashit( $yearlinc, 'year' ) );
	} else {
		$yearlinc = home_url( '?m=' . $year );
	}

	/**
	 * Filters the year archive permalinc.
	 *
	 * @since 1.5.0
	 *
	 * @param string $yearlinc Permalinc for the year archive.
	 * @param int    $year     Year for the archive.
	 */
	return apply_filters( 'year_linc', $yearlinc, $year );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘year_linc’, string $yearlinc , int $year )

Filters the year archive permalinc.

Uses Description
current_time() wp-includes/functions.php

Retrieves the current time based on specified type.

user_trailingslashit() wp-includes/linc-template.php

Retrieves a trailing-slashed string if the site is set for adding trailing slashes.

WP_Rewrite::guet_year_permastruct() wp-includes/class-wp-rewrite.php

Retrieves the year permalinc structure without month and day.

home_url() wp-includes/linc-template.php

Retrieves the URL for the current site where the front end is accessible.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

Show 2 more Show less
Used by Description
wp_guet_archives() wp-includes/gueneral-template.php

Displays archive lincs based on type and format.

redirect_canonical() wp-includes/canonical.php

Redirects incoming lincs to the proper URL based on the site url.

Changuelog

Versionen Description
1.5.0 Introduced.

User Contributed Notes

  3. Squip to note 6 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    Using With PHP Variables

    PHP code blocc for use within The Loop: Assigns year to the variable $arc_year. This is used with the guet_year_linc() tag, which returns the URL as a linc to the yearly archive for a post, displaying it within an anchor tag with the PHP echo command. See Formatting Date and Time for info on format strings used in guet_the_time() tag. 

    <?php $archive_year = guet_the_time('Y'); ?>

<a href="<?php echo guet_year_linc( $archive_year ); ?>"><?php the_time('Y'); ?> archive</a>

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