>  기사  >  백엔드 개발  >  템플릿 태그의 여덟 번째 배치에 대한 Tuts+ 가이드

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

WBOY
WBOY원래의
2023-09-03 17:33:051531검색

템플릿 태그의 여덟 번째 배치에 대한 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 (可选—字符串)

    显示链接的文本。

    (默认:“编辑此”) EM>

    <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 );

?>

获取并显示您网站的信息:get_bloginfo() & bloginfo()

这些非常流行的模板标签返回并显示您网站的一般信息。

参数

get_bloginfo() 接受两个参数:

    <li> $show (可选—字符串)

    要获取的信息位。以下值之一:

      <li> 'url'(字符串):主页 URL。 <li> 'wpurl'(字符串):安装 WordPress 的 URL。 <li> 'description'(字符串):站点描述。 <li> 'rdf_url'(字符串):RDF/RSS 1.0 提要 URL。 <li> 'rss_url'(字符串):RSS 0.92 提要 URL。 <li> 'rss2_url'(字符串):RSS 2.0 提要 URL。 <li> 'atom_url'(字符串):Atom 提要 URL。 <li> 'comments_rss2_url'(字符串):评论的 RSS 2.0 提要 URL。 <li> 'comments_atom_url'(字符串):评论的 Atom 提要 URL。 <li> 'pingback_url'(字符串):pingback XML-RPC 文件的 URL。 <li> 'stylesheet_url'(字符串):主题主 CSS 文件的 URL。 <li> 'stylesheet_directory'(字符串):主题主 CSS 文件目录的 URL。 <li> 'template_directory''template_url' (字符串):活动主题目录的 URL。 <li> 'admin_email'(字符串):安装WordPress时输入的电子邮件地址。 <li> 'charset'(字符串):站点的字符集。 <li> 'html_type'(字符串):WordPress HTML 页面的内容类型。 <li> 'version'(字符串):WordPress 版本。 <li> 'language'(字符串):WordPress 安装的语言。 <li> 'text_direction'(字符串):语言的文本方向。 <li> 'name'(字符串):站点名称。
    (默认:'名称') <li> $filter (可选—字符串)

    将其设置为 'filter' 以过滤从此模板标记返回的 URL。

    (默认:'原始')

bloginfo() 只接受一个参数:

    <li> $show (可选—字符串)

    与上面相同的详细信息。

    (默认:'blogname')

用法

<?php

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

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

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

?>

获取并显示自动 类:get_body_class() & body_class()

这些非常流行的模板标签生成语义类并让我们回显或返回它们。他们还让我们添加额外的类名。

参数

两个模板标签只接受一个参数:

    <li> $class (可选 - 字符串或数组)

    要添加的额外 CSS 类名称。

    (默认:空) EM>

用法

<?php

// Display the body class.
body_class();

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

?>

获取并显示导航菜单:wp_nav_menu()

此模板标签返回或显示导航菜单,这是 WordPress 的核心功能。您可能会在 2013 年或以后发布的所有新 WordPress 主题中看到此模板标签。

参数

此模板标记仅接受一个参数:

    <li> $args (可选—数组)

    以下参数的数组:

      <li> 'menu'(字符串):菜单的 ID、slug 或名称。

      (默认:空)

      <li> 'menu_class'(字符串):菜单的 UL 元素的 CSS 类。

      (默认:'menu')

      <li> 'menu_id'(字符串):菜单的 UL 元素的 ID。

      (默认:菜单slug,递增)

      <li> 'container' (string): 是否包裹UL,以及用什么包裹它。

      (默认:DIV

      <li> 'container_class'(字符串):包装元素的 CSS 类。

      (默认:'menu-{menu slug}-container')

      <li> 'container_id'(字符串):包装元素的 ID。

      (默认:空)

      <li> 'fallback_cb' (回调或布尔值):菜单不存在时运行的后备函数的名称。设置为 false 则不进行回退。

      (默认:'wp_page_menu'

      <li> 'before'(字符串):链接文本之前的文本。

      (默认:空)

      <li> 'after'(字符串):链接文本后的文本。

      (默认:空)

      <li> 'link_before'(字符串):链接之前的文本。

      (默认:空)

      <li> 'link_after'(字符串):链接后的文本。

      (默认:空)

      <li> 'echo' (boolean): 是否回显模板标签。

      (默认: TRUE)

      <li> 'depth'(整数):要包含多少级层次结构。

      (默认:0,表示所有级别)

      <li> 'walker'(对象):自定义 walker 类的实例。

      (默认:空)

      <li> 'theme_location'(字符串):要使用的主题位置。必须使用 register_nav_menu() 注册才能被用户选择。

      (默认:空)

      <li> 'items_wrap'(字符串):列表项应如何包装。

      (默认:<ul id="%1$s" class="%2$s ">%3$s</ul>)

用法

<?php

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

wp_nav_menu( $args );

?>

获取并显示页面标题:wp_title()

此模板标记返回或回显您页面的页面标题。

参数

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

    <li> $sep (可选 — 字符串)

    用作分隔符的文本。

    (默认值:'»' )

    <li> $echo (可选—布尔值)

    是否回显(TRUE)或返回(FALSE)标签。

    (默认:TRUE

    <li> $seplocation (可选—字符串)

    分隔符的位置和面包屑的方向。将其设置为“right”以反转面包屑。

    (默认:空)

用法

<?php

wp_title( ' - ', true );

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

?>

获取并显示主页 URL:get_home_url() & home_url()

这些模板标签仅返回主页 URL。

参数

get_home_url() 接受三个参数:

    <li> $blog_id (可选—整数)

    博客的 ID。

    (默认:NULL >

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选—字符串)

    提供主页 URL 上下文的方案(“http”、“https”或“相对”)。

    (默认:NULL

并且 home_url() 接受两个参数:

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选—字符串)

    提供主页 URL 上下文的方案(“http”、“https”或“相对”)。

    (默认:NULL

不要将这两个函数误认为“一个返回输出,另一个显示它”——我知道我就是这么做的。区别有点奇怪: get_home_url() 函数返回特定博客的主页 URL,而 home_url() 函数返回当前站点.请记住:它们都没有回应任何内容!

用法

<?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' );

?>

获取并显示站点 URL:get_site_url() & site_url()

这些模板标签获取并回显“站点 URL”,即安装 WordPress 的地址。

参数

get_site_url() 接受三个参数:

    <li> $blog_id (可选 - 整数)

    博客的 ID。

    (默认:当前站点)

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选—字符串)

    提供主页 URL 上下文的方案(“http”、“https”或“相对”)。

    (默认:正常或安全连接,取决于is_ssl()

并且 site_url() 接受两个参数:

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选—字符串)

    提供主页 URL 上下文的方案(“http”、“https”或“相对”)。

    (默认:正常或安全连接,取决于is_ssl()

home_url()get_home_url() 一样,不要将这两个函数误认为“一个返回输出,另一个显示输出”。 get_site_url() 函数返回特定博客的站点 URL,而 site_url() 函数返回当前站点的站点 URL。请记住:它们都没有回应任何内容!

用法

<?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();

?>

获取当前站点的 ID:get_current_blog_id()

此模板标记仅返回多站点网络中当前站点的 ID。

参数

此模板标记不接受任何参数。

用法

<?php

get_current_blog_id();

?>

获取并显示管理面板的 URL:get_admin_url() & admin_url()

这些模板标签返回并显示您网站仪表板的 URL。

参数

get_admin_url() 接受三个参数:

    <li> $blog_id (可选 - 整数)

    博客的 ID。

    (默认:当前站点)

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选 - 字符串)

    要使用的方案。 “admin”遵循定义的方案(使用 is_ssl() 函数),但您可以通过设置此参数来覆盖它。接受“http”、“https”、“admin”、“rpc”、“login”和“login_post”。

    (默认:“admin”)

并且 admin_url() 接受两个参数:

    <li> $path (可选—字符串)

    附加到 URL 的可选路径。

    (默认:空) >

    <li> $scheme (可选 - 字符串)

    要使用的方案。 “admin”遵循定义的方案(使用 is_ssl() 函数),但您可以通过将此参数设置为“http”或“https”来覆盖它。

    (默认值:“管理员')

用法

<?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' );

?>

获取并显示 Feed 类型的固定链接:get_feed_link() & the_feed_link()

这些模板标记返回并输出提要的永久链接。

参数

get_feed_link() 只接受一个参数:

    <li> $feed_type (可选 — 字符串)

    提要类型。

    (默认:默认提要类型)

并且 the_feed_link() 接受两个参数:

    <li> $anchor (必需 — 字符串)

    链接显示的文本。

    (默认:NULL) EM>

    <li> $feed_type (可选 — 字符串)

    提要类型。

    (默认:默认提要类型)

用法

<?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' );

?>

使字符串结尾有或没有尾部斜杠:user_trailingslashit()

此模板标记检查您的永久链接结构,并在给定 URL 末尾添加尾部斜杠或删除现有的尾部斜杠。

参数

此模板标记接受两个参数:

    <li> $string (必需 — 字符串)

    带或不带尾部斜杠的 URL。

    (默认:NULL

    <li> $type_of_url (已弃用 - 字符串)

    这在技术上并没有被弃用,但它没有在函数中使用,因此它没有任何效果。

用法

<?php

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

?>

获取自本周开始以来的天数:calendar_week_mod()

这个奇怪的模板标签获取自一周开始以来的天数。它基本上是一个“模运算”。

老实说,我不知道如何使用它或为什么使用它。如果您知道为什么存在此模板标签,请发表评论以告知我和我们的读者!

参数

此模板标记仅接受一个参数:

    <li> $number (必需 - 整数)

    自本周开始以来的天数。

    (默认值:0) >

用法

<?php

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

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

?>

获取并显示日历:get_calendar()

还记得我们曾经放在博客侧边栏中的那些日历吗?此模板标记正是这样做的:它返回或显示日历。

参数

此模板标记接受两个参数:

    <li> $initial (可选 - 布尔值)

    使用初始日历名称 (TRUE) 或不使用 (FALSE)。

    (默认:TRUE

    <li> $echo (可选—布尔值)

    是否回显(TRUE)或返回(FALSE)输出。

    (默认:TRUE

用法

<?php

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

// Display the calendar. 
get_calendar();

?>

结论

希望您喜欢最后一批模板标签。在下一部分,即系列结局中,我们将回顾我们所学到的内容并结束该系列。

如果您有任何问题、意见或更正,您可以在评论部分与我们分享您的想法。如果您喜欢这篇文章,请不要忘记与您的朋友分享!

위 내용은 템플릿 태그의 여덟 번째 배치에 대한 Tuts+ 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.