이 시리즈의 8부에서는 WordPress 템플릿 태그의 일곱 번째 배치를 살펴봅니다. 9부에서는 거의 200개에 달하는 템플릿 태그의 최종 배치를 살펴보겠습니다. 이 튜토리얼 전반에 걸쳐 북마크용 템플릿 태그와 기타 "기타" 템플릿 태그를 볼 수 있습니다.
북마크에 대한 경고: WordPress 3.5부터 관리자 패널에서 "북마크"가 기본적으로 숨겨져 있습니다. 북마크를 사용하려면 링크 관리자 플러그인을 설치해야 합니다.
wp_list_bookmarks()
이 템플릿 태그는 WordPress의 이전 기능인 북마크 목록을 반환하거나 에코합니다.
이 템플릿 태그는 하나의 매개변수만 허용합니다:
$args
(선택 사항 - 배열) : 다음 매개변수의 배열:
'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 코드입니다. (기본값: '')
'title_after'
(String): 각 제목 뒤에 추가할 HTML 코드입니다. (기본값: '')
<li>'class'
(String): 각 카테고리에 추가할 CSS 클래스 이름입니다. (기본값: 'linkcat')
<li>'category_before'
(String): 각 카테고리 앞에 추가할 HTML 코드입니다. (기본값: '
'category_after'
(String): 각 카테고리 뒤에 HTML 코드가 추가됩니다. (기본값: '
')'category_orderby'
(문자열): 카테고리를 정렬하는 방법입니다. "이름", "ID", "슬러그" 및 "개수"를 허용합니다. (기본값: "이름")
<li>'category_order'
(문자열): 카테고리를 오름차순('ASC') 또는 내림차순('DESC')으로 정렬할지 여부입니다. (기본값: 'ASC')
get_bookmarks()
이 템플릿 태그는 WordPress 북마크 배열을 반환합니다.
이 템플릿 태그는 하나의 매개변수만 허용합니다:
$args
(선택 사항 - 배열) : 다음 매개변수의 배열:
'orderby'
(문자열): 링크를 정렬하는 방법입니다. 이름, ID, 제목, 날짜 등과 같은 게시물 필드를 허용합니다. (기본값: "이름")
<li>'order'
(문자열): 항목을 오름차순('ASC') 또는 내림차순('DESC')으로 정렬할지 여부입니다. (기본값: 'ASC')
<li>'limit'
(정수): 표시할 항목 수입니다. (기본값: -1은 모두를 의미)
<li>'category'
(문자열): 항목을 가져올 쉼표로 구분된 카테고리 ID입니다. (기본값: 비어 있음)
<li>'category_name'
(String): 항목을 가져올 카테고리 이름입니다. (默认:空)
<li>'hide_invisible'
(整数或布尔值):是否显示或隐藏标记为“不可见”的链接。(默认:1|TRUE
)
'show_updated'
(整数或布尔值):是否显示书签上次更新时间。(默认:0|FALSE
)
'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()
此模板标记返回给定书签的所有数据。
此模板标记接受三个参数:
$bookmark
(必需 - 混合):书签 ID 或对象。
(默认:NULL
) >
$output
(可选 - 字符串):OBJECT、ARRAY_N 或 ARRAY_A 常量。
(默认:OBJECT
)
$filter
(可选—字符串):是否转义输出。如果您想过滤输出,请将其设置为“display”。
(默认:“raw”)
<?php // Getting a specific bookmark's fields with escaping the output. $bookmark_data( 19, OBJECT, 'display' ); ?>
get_bookmark_field()
此模板标记可让您获取单个书签字段的数据。
此模板标记接受三个参数:
$field
(必填—字符串):字段名称。
(默认:NULL
)
$bookmark
(必需 — 整数):书签 ID。
(默认:NULL
)
$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()
只接受一个参数:
$bookmark_id
(必需 - 整数):书签的 ID。
(默认:0)
而 edit_bookmark_link()
接受四个参数:
$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()
接受两个参数:
$show
(可选—字符串):要获取的信息位。以下值之一:
'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'
(字符串):站点名称。
$filter
(可选—字符串):将其设置为 'filter'
以过滤从此模板标记返回的 URL。
(默认:'原始')
而 bloginfo()
只接受一个参数:
$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()
这些非常流行的模板标签生成语义类并让我们回显或返回它们。他们还让我们添加额外的类名。
两个模板标签只接受一个参数:
$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 主题中看到此模板标签。
此模板标记仅接受一个参数:
$args
(可选—数组):以下参数的数组:
'menu'
(字符串):菜单的 ID、slug 或名称。(默认:空)
<li>'menu_class'
(字符串):菜单的 UL
元素的 CSS 类。(默认:'menu')
<li>'menu_id'
(字符串):菜单的 UL
元素的 ID。(默认:菜单slug,递增)
<li>'container'
(string): 是否包裹UL
,以及用什么包裹它。(默认:DIV
)
'container_class'
(字符串):包装元素的 CSS 类。(默认:'menu-{menu slug}-container')
<li>'container_id'
(字符串):包装元素的 ID。(默认:空)
<li>'fallback_cb'
(回调或布尔值):菜单不存在时运行的后备函数的名称。设置为 false 则不进行回退。(默认:'wp_page_menu'
)
'before'
(字符串):链接文本之前的文本。(默认:空)
<li>'after'
(字符串):链接文本后的文本。(默认:空)
<li>'link_before'
(字符串):链接之前的文本。(默认:空)
<li>'link_after'
(字符串):链接后的文本。(默认:空)
<li>'echo'
(boolean): 是否回显模板标签。(默认: TRUE
)
'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()
此模板标记返回或回显您页面的页面标题。
此模板标记接受三个参数:
$sep
(可选 — 字符串):用作分隔符的文本。
(默认值:'»' )
<li>$echo
(可选—布尔值):是否回显(TRUE
)或返回(FALSE
)标签。
(默认:TRUE
)
$seplocation
(可选—字符串):分隔符的位置和面包屑的方向。将其设置为“right”以反转面包屑。
(默认:空)
<?php wp_title( ' - ', true ); // Reverse the separator location to use left-hand indicators. $page_title = wp_title( ' « ', false, 'right' ); ?>
get_home_url()
& home_url()
这些模板标签仅返回主页 URL。
get_home_url()
接受三个参数:
$blog_id
(可选—整数):博客的 ID。
(默认:NULL
) >
$path
(可选—字符串):附加到 URL 的可选路径。
(默认:空) >
<li>$scheme
(可选—字符串):提供主页 URL 上下文的方案(“http”、“https”或“相对”)。
(默认:NULL
)
并且 home_url()
接受两个参数:
$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' ); ?>
get_site_url()
& site_url()
这些模板标签获取并回显“站点 URL”,即安装 WordPress 的地址。
get_site_url()
接受三个参数:
$blog_id
(可选 - 整数):博客的 ID。
(默认:当前站点)
<li>$path
(可选—字符串):附加到 URL 的可选路径。
(默认:空) >
<li>$scheme
(可选—字符串):提供主页 URL 上下文的方案(“http”、“https”或“相对”)。
(默认:正常或安全连接,取决于is_ssl()
)
并且 site_url()
接受两个参数:
$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(); ?>
get_current_blog_id()
此模板标记仅返回多站点网络中当前站点的 ID。
此模板标记不接受任何参数。
<?php get_current_blog_id(); ?>
get_admin_url()
& admin_url()
这些模板标签返回并显示您网站仪表板的 URL。
get_admin_url()
接受三个参数:
$blog_id
(可选 - 整数):博客的 ID。
(默认:当前站点)
<li>$path
(可选—字符串):附加到 URL 的可选路径。
(默认:空) >
<li>$scheme
(可选 - 字符串):要使用的方案。 “admin”遵循定义的方案(使用 is_ssl()
函数),但您可以通过设置此参数来覆盖它。接受“http”、“https”、“admin”、“rpc”、“login”和“login_post”。
(默认:“admin”)
并且 admin_url()
接受两个参数:
$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' ); ?>
get_feed_link()
& the_feed_link()
这些模板标记返回并输出提要的永久链接。
get_feed_link()
只接受一个参数:
$feed_type
(可选 — 字符串):提要类型。
(默认:默认提要类型)
并且 the_feed_link()
接受两个参数:
$anchor
(必需 — 字符串):链接显示的文本。
(默认:NULL
) EM>
$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 末尾添加尾部斜杠或删除现有的尾部斜杠。
此模板标记接受两个参数:
$string
(必需 — 字符串):带或不带尾部斜杠的 URL。
(默认:NULL
)
$type_of_url
(已弃用 - 字符串):这在技术上并没有被弃用,但它没有在函数中使用,因此它没有任何效果。
<?php $url_to_fix = user_trailingslashit( get_home_url() . 'some-special-page' ); ?>
calendar_week_mod()
这个奇怪的模板标签获取自一周开始以来的天数。它基本上是一个“模运算”。
老实说,我不知道如何使用它或为什么使用它。如果您知道为什么存在此模板标签,请发表评论以告知我和我们的读者!
此模板标记仅接受一个参数:
$number
(必需 - 整数):自本周开始以来的天数。
(默认值:0) >
<?php // Umm... echo calendar_week_mod( 199 ); // Right? (it echoes "3" by the way). ?>
get_calendar()
还记得我们曾经放在博客侧边栏中的那些日历吗?此模板标记正是这样做的:它返回或显示日历。
此模板标记接受两个参数:
$initial
(可选 - 布尔值):使用初始日历名称 (TRUE
) 或不使用 (FALSE
)。
(默认:TRUE
)
$echo
(可选—布尔值):是否回显(TRUE
)或返回(FALSE
)输出。
(默认:TRUE
)
<?php // Return the calendar. $my_calendar = get_calendar( true, false ); // Display the calendar. get_calendar(); ?>
希望您喜欢最后一批模板标签。在下一部分,即系列结局中,我们将回顾我们所学到的内容并结束该系列。
如果您有任何问题、意见或更正,您可以在评论部分与我们分享您的想法。如果您喜欢这篇文章,请不要忘记与您的朋友分享!
위 내용은 템플릿 태그의 여덟 번째 배치에 대한 Tuts+ 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!