템플릿 태그의 여덟 번째 배치에 대한 Tuts+ 가이드

이 시리즈의 8부에서는 WordPress 템플릿 태그의 일곱 번째 배치를 살펴봅니다. 9부에서는 거의 200개에 달하는 템플릿 태그의 최종 배치를 살펴보겠습니다. 이 튜토리얼 전반에 걸쳐 북마크용 템플릿 태그와 기타 "기타" 템플릿 태그를 볼 수 있습니다.

북마크에 대한 경고: WordPress 3.5부터 관리자 패널에서 "북마크"가 기본적으로 숨겨져 있습니다. 북마크를 사용하려면 링크 관리자 플러그인을 설치해야 합니다.

북마크 목록 가져오기 및 표시: wp_list_bookmarks()

이 템플릿 태그는 WordPress의 이전 기능인 북마크 목록을 반환하거나 에코합니다.

매개변수

이 템플릿 태그는 하나의 매개변수만 허용합니다:

<li> $args (선택 사항 - 배열) :

다음 매개변수의 배열:

<li> 'orderby'(문자열): 북마크를 정렬하는 방법입니다. "이름", "링크_ID", "url", "대상", "설명", "소유자"(책갈피를 추가한 사용자), "등급", "업데이트"(업데이트된 날짜), "rel"(XFN)을 허용합니다. 북마크 관계), 'notes', 'rss', 'length'(북마크 이름 길이), 'rand'(임의).

(기본값: '이름')

<li> 'order'(문자열): 항목을 오름차순('ASC') 또는 내림차순('DESC')으로 정렬할지 여부입니다.

(기본값: 'ASC')

<li> 'limit'(정수): 표시할 항목 수입니다.

(기본값: -1은 모든 북마크를 의미)

<li> 'category'(문자열): 항목을 가져올 쉼표로 구분된 카테고리 ID입니다.

(기본값: ''는 모든 카테고리를 의미함)

<li> 'exclude_category'(문자열): 제외할 북마크 카테고리 ID입니다.

(기본값: ' ')

<li> 'category_name'(문자열): 북마크의 카테고리 이름을 표시합니다('카테고리' 재정의).

(기본값: '')

<li> 'hide_invisible'(정수): 보이지 않는 링크를 숨길지, 표시할지 여부입니다.

(기본값: 1)

<li> 'show_updated'(정수): 마지막으로 업데이트된 타임스탬프를 표시할지 여부입니다.

(기본값: 0)

<li> 'echo'(정수): 출력을 에코할지(1) 또는 반환할지(0).

(기본값: 1)

<li> 'categorize'(정수): 북마크를 카테고리별로 그룹화할지(1) 또는 카테고리별로 그룹화하지 않을지(0) 여부.

(기본값: 1)

<li> <code>'title_li'(문자열): <code>'title_li'（字符串）：使用 <li> 태그를 사용하여 출력을 래핑하고 북마크 목록 앞에 제목을 표시합니다. 빈 문자열로 설정하고 개행을 비활성화할 수 있습니다.

(기본값: "북마크")

<li> 'title_before'(문자열): 각 제목 앞에 추가할 HTML 코드입니다.

(기본값: '

')

<li> 'title_after'(String): 각 제목 뒤에 추가할 HTML 코드입니다.

(기본값: '')

<li> 'class'(String): 각 카테고리에 추가할 CSS 클래스 이름입니다.

(기본값: 'linkcat')

<li> 'category_before'(String): 각 카테고리 앞에 추가할 HTML 코드입니다.

(기본값: '

• ')
<li> 'category_after'(String): 각 카테고리 뒤에 HTML 코드가 추가됩니다.

(기본값: '

')
<li> 'category_orderby'(문자열): 카테고리를 정렬하는 방법입니다. "이름", "ID", "슬러그" 및 "개수"를 허용합니다.

(기본값: "이름")

<li> 'category_order'(문자열): 카테고리를 오름차순('ASC') 또는 내림차순('DESC')으로 정렬할지 여부입니다.

(기본값: 'ASC')

사용법

모든 북마크 배열 가져오기: get_bookmarks()

이 템플릿 태그는 WordPress 북마크 배열을 반환합니다.

매개변수

이 템플릿 태그는 하나의 매개변수만 허용합니다:

<li> $args (선택 사항 - 배열) :

다음 매개변수의 배열:

<li> 'orderby'(문자열): 링크를 정렬하는 방법입니다. 이름, ID, 제목, 날짜 등과 같은 게시물 필드를 허용합니다.

(기본값: "이름")

<li> 'order'(문자열): 항목을 오름차순('ASC') 또는 내림차순('DESC')으로 정렬할지 여부입니다.

(기본값: 'ASC')

<li> 'limit'(정수): 표시할 항목 수입니다.

(기본값: -1은 모두를 의미)

<li> 'category'(문자열): 항목을 가져올 쉼표로 구분된 카테고리 ID입니다.

(기본값: 비어 있음)

<li> 'category_name'(String): 항목을 가져올 카테고리 이름입니다.

（默认：空）

<li> 'hide_invisible'（整数或布尔值）：是否显示或隐藏标记为“不可见”的链接。

（默认：1|TRUE）

<li> 'show_updated'（整数或布尔值）：是否显示书签上次更新时间。

（默认：0|FALSE）

<li> 'include'（字符串）：要包含的以逗号分隔的 ID 列表。

（默认：空）

<li> 'exclude'（字符串）：要排除的 ID 的逗号分隔列表。

（默认：空）

用法

<?php

$args = array(
    'orderby' => 'title',
    'order' => 'ASC',
    'limit' => 15,
    'hide_invisible' => false,
    'exclude' => '12,16,23'
);

$bookmarks_array =  get_bookmarks( $args );

?>

获取书签数据：get_bookmark()

此模板标记返回给定书签的所有数据。

参数

此模板标记接受三个参数：

<li> $bookmark （必需 - 混合）：

书签 ID 或对象。

（默认：NULL） > <li> $output （可选 - 字符串）：

OBJECT、ARRAY_N 或 ARRAY_A 常量。

（默认：OBJECT） <li> $filter （可选—字符串）：

是否转义输出。如果您想过滤输出，请将其设置为“display”。

（默认：“raw”）

用法

<?php

// Getting a specific bookmark's fields with escaping the output.
$bookmark_data( 19, OBJECT, 'display' );

?>

获取单个书签字段的数据：get_bookmark_field()

此模板标记可让您获取单个书签字段的数据。

参数

此模板标记接受三个参数：

<li> $field （必填—字符串）：

字段名称。

（默认：NULL） <li> $bookmark （必需 — 整数）：

书签 ID。

（默认：NULL） <li> $context （可选—字符串）：

如何过滤字段值—“raw”、“edit”、“attribute”、“js”、“db” '，或'显示'。

（默认：'显示'）

用法

<?php

// Get the bookmark with the id 16 and escape & echo its title.
echo get_bookmark_field( 'title', 16, 'display' );

?>

获取并显示“编辑书签”链接：get_edit_bookmark_link() & edit_bookmark_link()

这些模板标签可让您获取或回显“编辑此书签”链接以在模板中使用。

参数

get_edit_bookmark_link() 只接受一个参数：

<li> $bookmark_id （必需 - 整数）：

书签的 ID。

（默认：0）

而 edit_bookmark_link() 接受四个参数：

<li> $text （可选—字符串）：

显示链接的文本。

（默认：“编辑此”） <li> $before （可选—字符串）：

在输出之前显示的文本或 HTML 代码。

（默认：空） <li> $after （可选—字符串）：

输出后显示的文本或 HTML 代码。

（默认：空） <li> $bookmark_id （必需 - 整数）：

书签的 ID。

（默认：NULL） >

<?php

// Retrieve the current bookmark's "edit bookmark" link.
$edit_bookmark_link = get_edit_bookmark_link();

// Retrieve a specific bookmark's "edit bookmark" link.
$edit_bookmark_link = get_edit_bookmark_link( 98 );

// Display the current bookmark's "edit bookmark" link.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );

// Display a specific bookmark's "edit bookmark" link.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '', '', 98 );

?>

<?php

// Display the name of the site.
bloginfo();

// Get the stylesheet url.
$stylesheet = get_bloginfo( 'stylesheet_url' );

// Display the WordPress version.
bloginfo( 'version' );

?>

<?php

// Display the body class.
body_class();

// Retrieve the body class with an extra class.
$body_class = get_body_class( 'mytheme-body' );

?>

<?php

$args = array(
    'container_id' => 'primary-nav',
    'link_before' => '<i class="icon-link"></i>',
    'theme_location' => 'primary'
);

wp_nav_menu( $args );

?>

<?php

wp_title( ' - ', true );

// Reverse the separator location to use left-hand indicators.
$page_title = wp_title( ' &laquo ', false, 'right' );

?>

<?php

// Getting a specific blog's home url with https.
$home_url_of_petes_blog = get_home_url( 2, '', 'https' );

// Echoes the current home url with a little addition.
echo home_url( '?rel=navlink' );

?>

<?php

// Getting a specific blog's site url with https.
$site_url_of_janes_blog = get_site_url( 3, '', 'https' );

// Echoes the current site url.
echo site_url();

?>

<?php

get_current_blog_id();

?>

<?php

// Get the dashboard url of the current blog.
$admin_url = get_admin_url();

// Display the admin url and force a secure connection.
admin_url( '', 'https' );

?>

<?php

// Get default feed type's link.
get_feed_link();

// Display a link for the "atom" feed.
the_feed_link( __( 'Atom Feed', 'translation-domain' ), 'atom' );

?>

<?php

$url_to_fix = user_trailingslashit( get_home_url() . 'some-special-page' );

?>

<?php

// Umm...
echo calendar_week_mod( 199 );

// Right? (it echoes "3" by the way).

?>

<?php

// Return the calendar.
$my_calendar = get_calendar( true, false );

// Display the calendar. 
get_calendar();

?>