proteusthemes/sticky-menu

适用于所有较新 PT 主题的 Sticky menu PHP composer 包。

v1.4.2 2022-05-20 00:59 UTC

This package is auto-updated.

Last update: 2024-09-20 05:54:26 UTC


README

这是一个 PT Sticky Menu 的 composer 包,也存在于 packagist 仓库中:[https://packagist.org.cn/packages/proteusthemes/sticky-menu](https://packagist.org.cn/packages/proteusthemes/sticky-menu)

工作原理

在自定义设置下的 主题选项 -> Sticky 菜单,您将找到 Sticky 菜单的设置

  • 启用/禁用 Sticky 菜单复选框,
  • 特色页面按钮设置,
  • Sticky 菜单容器背景颜色。

当用户向上滚动时,Sticky 菜单将显示,否则将保持隐藏。

说明

  1. 在您的 composer.json 文件中要求此包:"proteusthemes/sticky-menu",
  2. 运行 composer update
  3. 将基本 SCSS 文件导入到主题中(在 style.scss 文件中):@import '../../vendor/proteusthemes/sticky-menu/assets/scss/sticky-menu-minimal';
  4. 在主题中要求 js 文件(在 main.js 文件中)。只需将此路径添加到 require 调用中:'vendor/proteusthemes/sticky-menu/assets/js/sticky-menu'
  5. 运行 grunt build,以生成新的 style.css 文件(包含 Sticky 菜单 CSS),
  6. js-sticky-mobile-optionjs-sticky-desktop-option 类添加到 HTML 元素中,使 Sticky 菜单处于活动状态。例如:将 js-sticky-mobile-option 类添加到汉堡按钮,并将 js-sticky-desktop-option 类添加到页头中的导航元素。当浏览器窗口顶部滚动到这些元素时,Sticky 菜单将激活,
  7. 使用 pt-sticky-menu/theme_panel 过滤器设置自定义设置器中 Sticky 菜单将附加的面板,
  8. 实例化 Sticky 菜单类(查看 Auto 主题中的 /inc/theme-sticky-menu.php 文件,然后在 functions.php 中要求它)

这就完成了。现在您只需根据主题样式设计 Sticky 菜单。

过滤器

有几个过滤器,您可以使用它们来修改 Sticky 菜单的行为

  • pt-sticky-menu/settings_default,用于指定默认自定义设置,
  • pt-sticky-menu/logo_mod_names,更改主题_mod 的名称用于标志,
  • pt-sticky-menu/theme_menu_location,更改用于 Sticky 菜单的菜单位置名称,
  • pt-sticky-menu/cta_html_output,更改 CTA HTML 输出,
  • pt-sticky-menu/theme_panel,更改 Sticky 菜单部分将附加的自定义设置器面板名称,
  • pt-sticky-menu/mobile_menu_button_class,移动菜单按钮类,默认为 btn-primary
  • pt-sticky-menu/cta_button_class,CTA 按钮类,默认为 btn-primary