kunoichi/set-menu

缓存 WordPress 的 ready nav-menu

1.0.3 2023-12-27 03:41 UTC

This package is auto-updated.

Last update: 2024-08-27 05:21:37 UTC


README

缓存 WordPress 的菜单和小工具。

安装

使用 composer 与你的主题配合使用。

composer require kunoichi/set-menu

使用方法

步骤 1: 初始化

functions.php 中启用

reuqire __DIR__ . '/vendor/autoload.php';
Kunoichi\SetMenu::enable();

步骤 2: 启用缓存菜单

wp_nav_menu 替换为 Kunoich\SetMenu::nav_menu。建议使用 has_nav_menu 进行检查。

if ( has_nav_menu( 'header'  ) ) {
	Kunoichi\SetMenu::nav_menu( [
		'container'      => false,
		'menu_class'     => 'footer-social-menu',
		'depth'          => 1,
		'theme_location' => 'social-menu',
	] );
}

步骤 3: 启用缓存小工具

将你的 dynamic_sidebar 替换为 Kunoichi\SetMenu::sidebar

<footer class="footer">
	<?php if ( is_active_sidebar( 'footer-widgets' ) ) : ?>
		<div class="container">
			<div class="row" id="footer-widgets">
				<?php Kunoichi\SetMenu::sidebar( 'footer-widgets' ); ?>
			</div>
		</div>
	<?php endif; ?>
</footer>

步骤 4: 检查设置

设置页面已添加到 wp-admin 中,可以通过 "外观 > 主题缓存设置" 访问。

如果你需要更改默认值,可以在这里进行。

  • 导航菜单缓存
    • 排除缓存动态菜单位置
    • 缓存有效期(默认为 60 分钟)
  • 小工具缓存
    • 排除缓存动态侧边栏
    • 缓存有效期(默认为 60 分钟)

自定义

过滤器

set_menu_default_ignored_locations

set_menu_default_menu_lifetime

set_menu_default_sidebar_lifetime

许可证

GPL 3.0 或更高版本。