专注国内外云服务器
分享建站技术教程

WordPress函数:wp_page_menu()的使用

立即购买

阿里云服务器 ¥102元/年 云数据库37.5元/年 限时

个人、企业均可购买 | 更多配置0.8折特惠

吾上云WORDPRESS教程最新“WordPress函数:wp_page_menu()的使用”

使用说明

该标签显示带有链接的WordPress页面列表,并且可以选择将 Home(主页)自动显示为列表中的一员。该标签是自定义侧边栏和标题栏的好帮手,同时还可以用在其它模板中。

默认用法

<?php  $args = array(
        'depth'       => 0,
	'sort_column' => 'menu_order, post_title',
	'menu_class'  => 'menu',
	'include'     => '',
	'exclude'     => '',
	'echo'        => true,
	'show_home'   => false,
	'link_before' => '',
	'link_after'  => '' );
?>

默认情况下的显示状态:

  • 按页面菜单顺序和标题进行排列
  • DIV类为’menu’
  • 回应结果(显示)
  • 无link_before或link_after文本
  • 不将“Home”添加到页面列表中
  • 注意:用

    标签包围输出结果

参数

depth

(整数)这个参数用来控制 wp_list_pages 生成的页面列表的层次深度。默认值为 0 (显示所有页面,包括所有子页面)

  • 0(默认)使用嵌套列表显示所有层次的页面
  • -1 – 使用单一的平面列表显示所有层次的页面
  • 1 – 只显示顶级页面
  • 2,3… – 显示置顶的层次深度的页面

sort_column

(字符串)按页面标题的字母顺序排列页面列表。默认设置为sort by menu order (按菜单顺序排列)与alphabetically by page title(按页面标题的字母顺序排列)。sort_column参数可被WordPress数据库中的wp_post表中任何字段的描述符用来排列页面列表。下面是一些可用值。

  • ‘post_title’ —— 按标题的字母顺序排列页面
  • ‘menu_order’ ——按页面顺序排列页面。注意页面顺序页面ID之间的区别。页面ID是WordPress为页面/文章指定的一个唯一数字。而页面顺序则可由用于在管理面板(如仪表盘>页面>编辑页面)中设定。
  • ‘post_date’ ——按发表日期排列页面
  • ‘post_modified’ —— 按最后修改日期排列页面
  • ‘ID’ ——按页面ID排列
  • ‘post_author’ ——按页面作者的ID排列页面
  • ‘post_name’ —— 按页面别名的字母顺序排列页面

menu_class

(字符串)用以显示列表的DIV类。默认值为menu

include

(字符串)只显示符合所求ID的页面。如 wp_page_menu(‘include=2,14’) 只会列出ID为2和14的页面。

exclude

(字符串)该参数决定从列表ID列表中排除某些页面(如 ‘exclude=3,7,31’)。无默认值。参见下文中从列表中排除若干页面的示例。

exclude_tree

(字符串)确定一列将要被排除的父页面ID,各ID用逗号隔开。可用该参数删除某个父页面及其所有下属页面。如’exclude_tree=5’将会删除ID为5的父页面与该页面的所有子页面。(该参数引入于WP 2.7,在WP 2.8.1中使用该参数可能会有问题——详情请见bug报告。)

echo

(布尔型)显示生成的页面链接列表,或将列表作为HTML文本字符串返回以用在PHP中。默认值为1(显示生成的列表项)。有效值包括:

  • 0(false)
  • 1 (true)——默认值

show_home

(布尔型)将“Home”作为页面列表的第一个列表项。将管理面板>设置>常规中填写的博客地址(URL)作为这里Home的URL链接。默认值为0(不在生成的列表中加入“Home”项)。有效值包括:

  • 0(false)——默认值
  • 1 (true)
  • —— 用这里的内容代替“Home”(show_home仍然为true)

link_before

(字符串)设置标签中链接文本前的文字或html。

link_after

(字符串)设置标签中链接文本后的文字或html。

返回值

(字符串)如果“echo”参数被设置为false,输出菜单的HTML代码

示例

将主页(home)作为一个页面

下面这个例子将“Home”作为页面列表的第一个列表项。此外,所有页面名称都被div元素围绕,不显示ID为5,9,23的页面,以页面顺序排列页面。列表前有标题“Page Menu”字样。

1
2

Page Menu

<?php wp_page_menu(‘show_home=1&exclude=5,9,23&menu_class=page-navi&sort_column=menu_order’); ?>

将主页作为一个页面,并命名为Blog

下面这个例子将“Blog”(“Home”主页的替代品)作为页面列表的第一个列表项:

1 <?php wp_page_menu( array( ‘show_home’ => ‘Blog’, ‘sort_column’ => ‘menu_order’ ) ); ?>

只在页面列表中显示主页

下面这个示例在页面列表中只显示了一个主页(Home)链接。注意include=99999′引用了一个实际上并不存在的页面ID,因此列表中只会显示主页(Home)链接。

1 <?php wp_page_menu(‘show_home=1&include=9999’); ?>

菜单项的CSS类

下面的CSS类是 wp_page_menu() 生成的菜单输出的,例如HTML

  • 标签

    所有菜单项(Menu Items)

    • .page_item

      这个类被添加到菜单项中对应的静态页面

    • .page-item-$ID

      这个类被添加到菜单项中对应的静态页面,$ID 就是这个页面的ID

    当前页面菜单项

    • .current_page_item

      这个类被添加到菜单项中对应的当前显示的静态页面

    当前页面的父级菜单项

    • .current_page_parent

      这个类被添加到菜单项中对应的当前显示的静态页面的父级页面

    当前页面的祖先菜单项

    • .current_page_ancestor

      这个类被添加到菜单项中对应的当前显示的静态页面的祖先页面

    注释

    参见 wp_list_pages()

    函数历史

    始见于 2.7.0,WordPress 2.8.1 :sort_column参数的默认值由 ‘post_title’ 改为 ‘menu_order, post_title’

    源文件

    wp_page_menu() 位于 wp-includes/post-template.php

  • 文章来源于互联网WORDPRESS教程:WordPress函数:wp_page_menu()的使用,
    阿里云服务器89元起,点击购买
    腾讯云服务器95元/年起 点击购买

    相关推荐: WordPess运行环境简介

    吾上云WORDPRESS教程最新“WordPess运行环境简介”一、WordPress运行环境 1、Wordpress运行,需要怎样的环境? 2、如何搭建WordPres的本地运行环境? WordPress运行环境,可以分为:本地运行环境和真实运行环境。 本地…

    赞(0)
    未经允许不得转载:吾上云 » WordPress函数:wp_page_menu()的使用
    分享到: 更多 (0)
    • 阿里云
      基础型云服务器

      1核CPU

      2G内存

      40G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、个人站长类网站

      ¥89/1年 原价¥903.40

    • 阿里云
      超值型云服务器

      2核CPU

      4G内存

      40G硬盘

      3M带宽

      独立IP

      分布式存储

      适合企业官网、行业门户类网站

      ¥899/3年 原价¥8281

    • 阿里云
      高性能云服务器

      2核CPU

      8G内存

      40G硬盘

      5M带宽

      独立IP

      分布式存储

      适合电商、数据库等企业级应用

      ¥1399/3年¥14765

    • 腾讯云
      基础型云服务器

      1核CPU

      2G内存

      50G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、个人站长类网站

      ¥95/1年 原价¥834

    • 腾讯云
      超值型云服务器

      1核CPU

      2G内存

      50G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、行业门户类网站

      ¥288/3年 原价¥2502

    • 腾讯云
      高性能云服务器

      4核CPU

      8G内存

      50G硬盘

      5M带宽

      独立IP

      分布式存储

      适合电商、数据库等企业级应用

      ¥2188/3年¥13986

    • 阿里云
      基础型云服务器

      1核CPU

      2G内存

      40G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、个人站长类网站

      ¥89/1年 原价¥903.40

    • 阿里云
      超值型云服务器

      2核CPU

      4G内存

      40G硬盘

      3M带宽

      独立IP

      分布式存储

      适合企业官网、行业门户类网站

      ¥899/3年 原价¥8281

    • 阿里云
      高性能云服务器

      2核CPU

      8G内存

      40G硬盘

      5M带宽

      独立IP

      分布式存储

      适合电商、数据库等企业级应用

      ¥1399/3年¥14765

    • 腾讯云
      基础型云服务器

      1核CPU

      2G内存

      50G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、个人站长类网站

      ¥95/1年 原价¥834

    • 腾讯云
      超值型云服务器

      1核CPU

      2G内存

      50G硬盘

      1M带宽

      独立IP

      分布式存储

      适合企业官网、行业门户类网站

      ¥288/3年 原价¥2502

    • 腾讯云
      高性能云服务器

      4核CPU

      8G内存

      50G硬盘

      5M带宽

      独立IP

      分布式存储

      适合电商、数据库等企业级应用

      ¥2188/3年¥13986

    评论 抢沙发

    评论前必须登录!

     

    吾上云 专注服务器选购

    购买云服务器联系我们