wordpress 常用的模板标签使用

4，wordpress 模板标签使用

wp_title() 系统标题

wp_title(参数一，参数二，参数三) 首页使用参数无效，默认分隔符">>"
 
参数一：自定义分隔符
 
参数二：true 和  false
 
参数三：分隔符的作用 left 和 right

the_title() 标题

注意：该函数只能在主循环里面使用，如果在index.php调用的是所有文章标题，在singer.php里面只显示一篇文章标题，在page.php调用的是页面的标题
the_title($before, $after, $bool)
参数一：在标题前面追加字符串 
参数二：在参数后面追加字符串
参数三：true：直接输出标题，false：需要用标量接收或者echo输出
例如：the_title("<b style='color:red;'>", '</b>', true)
 
<?php if(have_posts()): ?>
	<?php while(have_posts()): the_post(); ?>
	// 在这里调用数据 文章标题
		<?php the_title();?>
	<?php endwhile;?>
 
<?php else:?>
	// 如果没有在这里提示一个信息
<?php endif;?>
 

the_permalink() 获取文章的链接

1，没有参数，没有返回值
2，获取文章的链接

the_content() 显示当前页面的文章内容

# 显示当前页面的文章内容
参数一：$more_link_text  ，文章内容太多的时候，只显示部分内容会出现一个更多按钮点击更多可以显示全文 默认为[更多...] 可替换为你自己的参数[点击展示更多]
参数二：使用不到
例如：the_content("点击显示更多")

the_excerpt()

# 获取文章的摘要，如果文章没有摘要获取文章的部分内容当中的55个字符当做摘要
# 无参数

get_post_meta() 获取文章自定义的字段

# 获取文章自定义的字段
例如：
<?php global $post; ?>
<p><?php echo get_post_meta($post->ID, 'offer', true); ?></p>

the_category() 分类

# 该函数只能在主循环里面使用，获取文章对应的分类，并且是超链接的形式，点击可以跳到当前分类的文章列表
参数一：多个分类的分隔符
参数二：multiple (如果未勾选父分类，自动加上父分类，展示的是多个分类超链接) 通常不需要
			 single (如果未勾选父分类，自动加上父分类，展示的是一个整体超链接)
参数三：要调取哪篇文章的所属分类，一般不需要			 
 

get_the_category() 获取分类返回值

<?PHP
	$categories = get_the_category();
	$tags = get_the_tags();
	if ( ! empty( $categories ) ) {
		// echo '<a href="'.esc_url(get_category_link( $categories[0]->term_id )).'">'.esc_html( $categories[0]->name ).'</a>';
		echo '<a href="' . esc_url( get_category_link( $categories[0]->term_id ) ) . '">' . esc_html( $tags[0]->name ) . '</a>';
	}
?>

the_tags() 标签

# 该函数只能在主循环里面使用，获取文章对应的标签，以超链接的方式给出
参数一：追加内容到标签的前面，默认值是标签
参数二：标签之间的分隔符默认逗号分开
参数三：在标签之后追加内容
the_tags('所属标签:', '-')

get_the_tags() 获取标签返回值

<?PHP
	$categories = get_the_category();
 	$tags = get_the_tags();
  if ( ! empty( $categories ) ) {
		 echo '<a href="' . esc_url( get_tag_link( $tags[0]->term_id ) ) . '">' . esc_html( $tags[0]->name ) . '</a>';		
  }
?>

get_template_directory_uri() 当前主题路径

# 获取当前主题的根路径
<?php echo get_template_directory_uri(); ?> 

the_author()

# 该函数只能在主循环里面使用，获取文章的作者

the_author_posts_link()

# 该函数只能在主循环里面使用，获取作者的链接，点击返回所有的作者文章列表

the_time()

# 该函数只能在主循环里面使用，获取文章的发布时间
参数一：Y：年 m：月 d：日  h：时 i：分 s：秒
 <p>发布时间：<?php the_time('Y-m-d h:i:s');?></p>

comments_popup_link() 评论链接

# 该函数只能在主循环里面使用，生成一个链接，调到评论框
参数一：（参数为任何值）当没有任何评论的时候修改wordpress的默认值 【hahaha无评论】可以改成 【0条评论】
参数二：（参数为任何值）当只有一条评论的时候可以修改提示的默认值
参数三：（参数为任何值）当有多条评论的时候修改默认值 % 号标识评论的条数
参数四：添加一个class属性
参数五：当评论被关闭显示的内容，只有在没有评论的文章里面生效，有评论的文章此参数无效
例如：comments_popup_link('0条评论','1条评论', '%条评论', 'tiaoshu', '评论关闭')
 

edit_post_link() 文章编辑

# 该函数只能在主循环里面使用，生成跳到编辑的链接
参数一：改超链接的文本内容：默认是编辑可以改成自己想要的名称
参数二：before 追加内容在默认文本前面
参数三：after 追加内容在默认文本后面
参数四：指定编辑的文章ID

next_post_link() 文章链接

# 获取更新一篇的文章链接
参数一：默认参数'>'' next_post_link('%link>>') 修改指示符
参数二：改变超文本链接内容 next_post_link('%title')
参数三：bool值  true在同一分类下 改成 false 显示不同分类的下一篇
参数四：排除某些分类下面的文章字符串或者数据，内容为分类的ID
参数五：同一个标签的下一篇
 

previous_post_link() 文章链接

# 获取上一篇的文章链接
 

next_posts_link() 下一页

# 分页文章-可以使用在主循环之外-下一页
参数一：默认标题前面追加内容
参数二：默认显示页数

previous_posts_link() 上一页

# 分页文章-可以使用在主循环之外-上一页
参数一：默认标题前面追加内容
参数二：默认显示页数

bloginfo($show)

show(不填默认就是 'name') 
(string)关于你的博客的详细信息。有效的参数值：
	'name' - 站点的标题）
	'description' - 站点的副标题
	'url' -你的博客的网站地址的URL。
	'rdf_url' -RDF/RSS 1.0 feed的URL。
	'rss_url' -RSS 0.92 feed的URL。
	'rss2_url' - RSS 2.0 feed的URL。
	'atom_url' -Atom feed的URL。
	'comments_rss2_url' - URL for comments RSS 2.0 feed.
	'pingback_url' -Pingback (XML-RPC 文件)的URL。
	'admin_email' - 管理员的电子邮件地址；设置在一般选项中。
	'charset' -你的博客的字符编码；设置在阅读选项中。
	'version' - 你的博客使用的WordPress版本。
	'text_direction' - 从右到左，返回'rtl'，从左到右返回'ltr'（默认）。
下面的，在WordPress1.5版本或者以后的版本中运行：:
 
	'html_type' - 你的博客的 "内容类型" 。
	'wpurl' - WordPress安装的URL。
	'template_url' - 使用的模板的URL。
	'template_directory' - 模板的目录的URL。
	'stylesheet_url' - 主要的CSS文件的URL。返回： http//example.com/wp-content/themes/ + your-active-theme-name(value from wp_options, "stylesheet" row) + "/style.css"(hardcoded in wp-includes/theme.php)
取消的参数
	'stylesheet_directory' - 样式表目录的URL。 (2.3.1版本中这个已经取消了)
 

5，主循环

<?php if(have_posts()): ?>
	<?php while(have_posts()): the_post(); ?>
	// 在这里调用数据 文章标题
		<?php the_title();?>
	<?php endwhile;?>
 
<?php else:?>
	// 如果没有在这里提示一个信息
<?php endif;?>

6，wordpress主题特色功能

开启Feed自动链接

bloginfo('rss_url'); // 获取链接 

add_theme_support() 特色图（即缩列图）

// 开启特色功能即：缩列图 添加文章的时候会显示特色图片
参数一：post-thumbnails
add_theme_support('post-thumbnails');  在主题下面的functions.php 里面添加此参数
 
参数二：array() 告诉wordpress哪些页面需要开启特色图片
add_theme_support('post-thumbnails', array('post'));  在主题下面的functions.php 里面添加此参数
add_theme_support( 'post-formats', array( 'aside', 'gallery' ) ); //添加日志与相册文章类型
add_theme_support( 'post-thumbnails' ); //常规用法，在所有样式的文章、页面中使用缩略图功能
add_theme_support( 'post-thumbnails', array( 'post' ) ); //仅在post中使用缩略图功能
add_theme_support( 'post-thumbnails', array( 'page' ) );//仅在page中使用缩略图功能
add_theme_support( 'post-thumbnails', array( 'post', 'movie' ) ); //仅在 post 和 movies 中使用 
 
// 调用文章特色图像 在主循环里面使用
the_post_thumbnail(); 
 
 
// 自定义尺寸
the_post_thumbnail(array(100,300)); 
 
// 所有参数 Default WordPress
the_post_thumbnail( 'thumbnail' );     // Thumbnail (150 x 150 hard cropped)
the_post_thumbnail( 'medium' );        // Medium resolution (300 x 300 max height 300px)
the_post_thumbnail( 'medium_large' );  // Medium Large (added in WP 4.4) resolution (768 x 0 infinite height)
the_post_thumbnail( 'large' );         // Large resolution (1024 x 1024 max height 1024px)
the_post_thumbnail( 'full' );          // Full resolution (original size uploaded)
 
//With WooCommerce
the_post_thumbnail( 'shop_thumbnail' ); // Shop thumbnail (180 x 180 hard cropped)
the_post_thumbnail( 'shop_catalog' );   // Shop catalog (300 x 300 hard cropped)
the_post_thumbnail( 'shop_single' );    // Shop single (600 x 600 hard cropped)

has_post_thumbnail() 判断有没有缩略图

参数一：指定文章的ID

register_nav_menu()导航菜单

register_nav_menu($location, $description);
// 开启导航功能 $location, $description
register_nav_menu('header_menu', '网站顶部导航');
register_nav_menu('sidebar_menu', '网站侧部导航');
register_nav_menu( 'footer_menu', '网站底部导航');
 

wp_nav_menu() 调用导航

wp_nav_menu($args=array())
$defaults = array(
	'theme_location'  => '',  	 	// 调用哪个位置的导航,使用导航菜单的名称调用菜单，可以是 id, slug, name (按顺序匹配的) 。
	'menu'            => '',			// 管理位置-》编辑 导航里面 menu 的值
	'container'       => 'div',		// 需不需要设置一个html元素包围ul元素,默认值: div
	'container_class' => '',			// ul 父节点的 class 属性值 默认值: menu-{menu slug}-container
	'container_id'    => '',			// ul 父节点的 id 属性值  默认值: None
	'menu_class'      => 'menu',		// ul 节点的 class 属性值。  默认值: menu
	'menu_id'         => '',				// ul 节点的 id 属性值。
	'echo'            => true,  		// 确定直接显示导航菜单还是返回 HTML 片段, 默认值: true (直接显示)
	'fallback_cb'     => 'wp_page_menu',  // 用于没有在后台设置导航时调的回调函数。默认值: wp_page_menu (显示页面列表作为菜单)
	'before'          => '',  // 显示在每个菜单链接前的文本。默认值: None
	'after'           => '',  // 显示在每个菜单链接后的文本。
	'link_before'     => '',  // 显示在每个菜单链接文本前的文本。(a链接里面的文案前面显示)
	'link_after'      => '',	// 显示在每个菜单链接文本后的文本。(a链接里面的文案后面显示)
	'items_wrap'      => '<ul id="%1$s" class="%2$s">%3$s</ul>',  // 使用字符串替换修改ul的class。
	'depth'           => 0, 	// 显示菜单的深度, 当数值为 0 时显示所有深度的菜单。
	'walker'          => ''	  // 默认值:  new Walker_Nav_Menu
);
wp_nav_menu( $defaults );
 
# 简单使用
$defaults = array(
	'theme_location'  => 'header_menu'  // 开启导航设置的key值
);
wp_nav_menu( $defaults );

register_sidebar() 侧边栏小工具的开启

// 开启主题侧边栏的功能 小工具 参数: register_sidebar(array());
 
name: 				侧边栏的名字（默认是 ‘Sidebar’ 加 数字 ID）
id:         	侧边栏 ID，必须全部小写，不带空格（默认是一个自动递增的数字 ID）
description:	用来说明侧边栏是什么，在哪里显示的文字。会在小工具管理界面显示。（默认为空）
class:				配到小工具 HTML输出 中的CSS选择器名字（默认为空）
before_widget:在每个小工具前面输出的 HTML代码（默认： '<li id="%1$s" class="widget %2$s">'）注：使用sprintf的变量替换
after_widget:	在每个小工具后面输出的 HTML代码（默认： “</li>\n“）
before_title:	在标题前输出的 HTML代码（默认： <h2 class="widgettitle">）
after_title:	在标题后输出的 HTML代码 （默认：”</h2>\n“）
 
<?php 
		$args = array(
        'name'          => __( 'Sidebar name', 'theme_text_domain' ),  
        'id'            => 'unique-sidebar-id',
        'description'   => '',
        'class'         => '',
        'before_widget' => '<li id="%1$s" class="widget %2$s">',
        'after_widget'  => '</li>',
        'before_title'  => '<h2 class="widgettitle">',
        'after_title'   => '</h2>' 
     ); 
	?>
	
	
	
	# 使用案例：在主题下面的functions.php文件里面注册
    register_sidebar(array(
        "name" => '主侧边栏',
        "id" => 'sidebar-1'
    ));
 
    register_sidebar(array(
        "name" => '左侧边栏',
        "id" => 'sidebar-2'   // 多个侧边栏 id 一定要改
    ));
	

dynamic_sidebar() 调用开启的小工具

if(dynamic_sidebar("sidebar-1")) {  // 有效小工具返回真，没有小工具返回假
	dynamic_sidebar("sidebar-1")  // 侧边栏返回为真的时候显示侧边栏
}
 
 
参数主要传：开启工具的 id 值 或者 name 值