钩子文档

customize_allowed_urls

💡 云策文档标注

概述

customize_allowed_urls 是一个 WordPress 过滤器,用于在 Customizer 预览中控制允许点击和跟随的 URL 列表。它允许开发者修改这些 URL 数组,以增强预览功能的安全性或灵活性。

关键要点

  • 这是一个过滤器,用于过滤 Customizer 预览中允许的 URL 数组。
  • 参数 $allowed_urls 是一个字符串数组,表示允许的 URL 列表。
  • 通过 apply_filters 调用,开发者可以添加、移除或修改 URL。
  • 相关函数 WP_Customize_Manager::get_allowed_urls() 用于获取允许预览的 URL。
  • 自 WordPress 3.4.0 版本引入。

📄 原文内容

Filters the list of URLs allowed to be clicked and followed in the Customizer preview.

Parameters

$allowed_urlsstring[]
An array of allowed URLs.

Source

$allowed_urls = array_unique( apply_filters( 'customize_allowed_urls', $allowed_urls ) );

Changelog

Version Description
3.4.0 Introduced.