WordPress как на ладони
WordPress темы и плагины за 250 рублей wordpress jino

get_archives_link() WP 1.0.1

Получает ссылку архивной страницы. Собирает ссылку из переданных: УРЛ, анкор ссылки, формат вывода, текст до и после.

Это вспомогательная функцию, которая собирает HTML тег ссылки, в указанном в параметре $format формате:

Текст обрабатывается фильтрами: wptexturize() и esc_attr(), а ссылка esc_url() и результате мы получим очищенный текст, даже если в функцию передать некорректные символы.

Хуки из функции:
Возвращает

Строку. HTML тег А.

Использование

get_archives_link( $url, $text, $format, $before, $after );
$url(строка) (обязательный)
Ссылка URL: http://site.ru/2013
По умолчанию: нет
$text(строка) (обязательный)
Анкор ссылки ( описание ссылки, текст который будет показан как ссылка ).
По умолчанию: нет
$format(строка)

В каком формате выводить ссылку:

  • html - для использования в списках: ul или ol;
  • link - для использования в head части HTML кода;
  • option - для использования в элементах формы select;
  • custom - другой формат, оставьте это поле пустым и используйте параметры before и after.

По умолчанию: html

$before(строка)
Текст до ссылки, можно указывать HTML код.
По умолчанию: ''
$after(строка)
Текст после ссылки, можно указывать HTML код.
По умолчанию: ''

Примеры

#1. Примеры показывающие что возвращает функция:

echo get_archives_link( '/2013', 'Архив за 2013 год' );
// вернет: <li><a href='/2013' title='Архив за 2013 год'>Архив за 2013 год</a></li>

get_archives_link( '/2013', 'Архив за 2013 год', 'link' );
// <link rel='archives' title='Архив за 2013 год' href='/2013' />

get_archives_link( '/2013', 'Архив за 2013 год', 'option' );
// <option value='/2013'> Архив за 2013 год </option>

get_archives_link( '/2013', 'Архив за 2013 год', '', '<div>','</div>' );
// <div><a href='/2013' title='Архив за 2013 год'>Архив за 2013 год</a></div>

Код get archives link: wp-includes/general-template.php VER 4.9.6

<?php
function get_archives_link($url, $text, $format = 'html', $before = '', $after = '') {
	$text = wptexturize($text);
	$url = esc_url($url);

	if ('link' == $format)
		$link_html = "\t<link rel='archives' title='" . esc_attr( $text ) . "' href='$url' />\n";
	elseif ('option' == $format)
		$link_html = "\t<option value='$url'>$before $text $after</option>\n";
	elseif ('html' == $format)
		$link_html = "\t<li>$before<a href='$url'>$text</a>$after</li>\n";
	else // custom
		$link_html = "\t$before<a href='$url'>$text</a>$after\n";

	/**
	 * Filters the archive link content.
	 *
	 * @since 2.6.0
	 * @since 4.5.0 Added the `$url`, `$text`, `$format`, `$before`, and `$after` parameters.
	 *
	 * @param string $link_html The archive HTML link content.
	 * @param string $url       URL to archive.
	 * @param string $text      Archive text description.
	 * @param string $format    Link format. Can be 'link', 'option', 'html', or custom.
	 * @param string $before    Content to prepend to the description.
	 * @param string $after     Content to append to the description.
	 */
	return apply_filters( 'get_archives_link', $link_html, $url, $text, $format, $before, $after );
}

Cвязанные функции

Из тегов шаблона: Основные

Danya 47
Программист фрилансер. Кодингом на PHP занимаю с 2008 года.
Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться