钩子文档

theme_scandir_exclusions

💡 云策文档标注

概述

theme_scandir_exclusions 是一个 WordPress 过滤器,用于在扫描主题文件夹时自定义排除的目录和文件数组。它允许开发者修改默认排除项,以优化主题扫描过程。

关键要点

  • 这是一个过滤器 Hook,名称为 'theme_scandir_exclusions',用于过滤扫描主题文件夹时排除的目录和文件数组。
  • 默认排除的目录包括 'CVS', 'node_modules', 'vendor', 'bower_components',开发者可以通过此过滤器添加或移除排除项。
  • 该过滤器在 WP_Theme::scandir() 方法中使用,用于扫描目录以查找特定扩展名的文件。
  • 自 WordPress 4.7.4 版本引入。

📄 原文内容

Filters the array of excluded directories and files while scanning theme folder.

Parameters

$exclusionsstring[]
Array of excluded directories and files.

Source

$exclusions = (array) apply_filters( 'theme_scandir_exclusions', array( 'CVS', 'node_modules', 'vendor', 'bower_components' ) );

Changelog

Version Description
4.7.4 Introduced.