无限滚动

type 接受两种不同的值：scroll 或 click。该选项控制“无限滚动”功能的默认行为。scroll 将在访客到达当前文章列表底部时自动加载文章，而 click 显示加载更多文章按钮，允许用户在加载更多文章时进行控制。

scroll 为默认值，但是如果主题有注脚小组件，则该值会被 click 覆盖，以便用户可以访问小组件。

footer_widgets 参数接受各种值，并且指明主题是否有注脚小组件。如果存在注脚小组件，则滚动类型将设为 click，这样小组件才可访问。

简单地说，如果注脚应该始终显示或永远不显示，那么可以分别设置布尔值 true 或 false。
此外，footer_widgets 参数可以接受代表一个边栏 ID（例如 'sidebar-1'）或一组边栏 ID 的字符串。“无限滚动”功能代码将检查边栏是否包含小组件，并据此设置相应的 footer_widgets 参数值。

如果主题将小组件区域置于文章列表下方，我们强烈建议您尽可能提供边栏 ID。这样一来，通过动态确定滚动类型应为 scroll 还是 click，从而为主题用户提供最佳体验。也就是说，如果主题从一开始就指定 click 作为滚动类型，那么您可以安全地省略 footer_widgets 参数。

如果这些选项仍不能满足您的需求，则可以使用 infinite_scroll_has_footer_widgets 过滤器，实现高级逻辑。过滤器必须返回布尔值，并且可用于检测是否存在导航菜单或使用移动设备的访客。

wrapper 参数的运行与 footer_widgets 类似，因为它接受几种不同的值。当附加到前一个参数指定的容器时，该参数确定 div 元素是否包含每组附加文章。
如果已指定布尔值（true 或 false），附加文章周围是否放置了使用 infinite-wrap 类的 div。

要使用自定义类将文章包括在 div 中，请将 wrapper 参数设置为代表自定义类的字符串。
请注意，wrapper 参数仅接受不含空格的单一字符串。

通常情况下，最好将追加文章包含在 div 中，除非这样做会导致无效的标记。例如，如果主题使用列表元素（ol、ul）显示文章，则应该禁用封装容器，这样 div 元素才不会在非其所属的位置显示。

“无限滚动”功能使用标准的 WordPress 循环呈现其追加的附加文章，并且在 content-{post format}.php 表单中利用模板部分。如果主题至少包含 content.php，那么 render 参数可以省略。以下是“无限滚动”功能使用的默认呈现函数：

while( have_posts() ) {
the_post();
get_template_part( 'content', get_post_format() );
}

如果需要进行更丰富的自定义，或者主题没有使用 content 模板部分，则应该为 render 参数指定函数名称，并且该函数将用于为“无限滚动”功能生成标记。该函数必须包含 WordPress 循环的 while() 部分，并且可以在呈现文章时利用主题可用的任何函数。

默认情况下，type 参数控制每次“无限滚动”功能运行时可加载的文章数。对于 scroll 类型，“无限滚动”功能每次激活后可加载七 (7) 篇文章。对于 click 类型，您可以在“设置”→“阅读”下面找到站点“博客页面中最多显示”值。
但是，如果主题的布局需要一定数量的文章，则 posts_per_page 参数将覆盖前面讨论的默认值。例如，在三栏布局的主题中，大于或小于三篇文章会导致布局不均匀，因此该控制选项会很有帮助。

/**
* 为“无限滚动”功能添加主题支持。
*
* @uses add_theme_support
* @return void
*/
function twenty_twelve_infinite_scroll_init() {
add_theme_support( 'infinite-scroll', array(
'container' => 'content',
) );
}
add_action( 'after_setup_theme', 'twenty_twelve_infinite_scroll_init' );

对于不熟悉“Twenty Twelve”主题的用户，它使用 content-{post format}.php 模板部分，并且在文章下面没有小组件区域，因此我们省略了 footer_widgets 和 render 参数。实际上，由于 container 值与默认值匹配，因此该参数也可以忽略；为了清楚起见，我们暂且保留了。

/**
* 为“无限滚动”功能添加主题支持。
*/
function twenty_eleven_infinite_scroll_init() {
add_theme_support( 'infinite-scroll', array(
'container' => 'content',
'footer_widgets' => array( 'sidebar-3', 'sidebar-4', 'sidebar-5', ),
'footer' => 'page',
) );
}
add_action( 'after_setup_theme', 'twenty_eleven_infinite_scroll_init' );

“Twenty Eleven”附带注脚小组件区域，但是由于只要您到达文章底部，系统就会添加新文章，因此当您向下滚动时，无法访问此区域。为解决此问题，我们会将包含这些小组件区域的 ID 的数组传递给 footer_widgets。现在，如果其中某个边栏包含小组件，“无限滚动”功能插件将会检测到此组件，并且自动切换到 click 类型（点击此处即可按需加载更多文章），因此您的注脚内容仍然可以完全访问。如果您的主题包含注脚小组件，可考虑这种方法，这样您可以大大改善用户的体验。

/**
* 为“无限滚动”功能添加主题支持
*/
function twenty_ten_infinite_scroll_init() {
add_theme_support( 'infinite-scroll', array(
'container' => 'content',
'render' => 'twenty_ten_infinite_scroll_render',
'footer' => 'wrapper',
) );
}
add_action( 'after_setup_theme', 'twenty_ten_infinite_scroll_init' );
/**
* 设置为调用文章而呈现的代码，
* 尽可能连接到模板部分。
*
* 注意：必须定义一个循环。
*
function twenty_ten_infinite_scroll_render() {
get_template_part( 'loop' );
}

“Twenty Ten”使用略微不同的模板结构呈现文章，因此我们需要为无限滚动提供自定义呈现函数。

您的主题是否有注脚小组件？如果注脚小组件区域有任何小组件，“无限滚动”功能将自动切换使用“早前文章”按钮，确保注脚小组件可以在您的站点上显示。如果您希望在向下滚动页面的同时加载文章，您可以将小组件置于其他小组件区域，例如边栏。如果您的主题只有注脚小组件区域，您可能需要寻找其他包含更多小组件区域选项的主题。