来源： 标签/6.5/型钢混凝土/wp包括/小部件/类wp-widget-custom-html.php

<?php（电话）
/**
*小工具API:WP_Widget_Custom_HTML类
 *
*@package WordPress
*@subpackage小工具
*@自4.8.1起
 */

/**
*用于实现自定义HTML小部件的核心类。
 *
*@自4.8.1起
 *
*@参见WP_Widget
 */
班 WP_小部件_自定义_HTML 延伸 WP_小工具 {

       /**
*小部件是否已注册。
         *
*@自4.9.0起
*@var bool
         */
       受保护的 $已注册 = 假;

       /**
*默认实例。
         *
*@自4.8.1起
*@var数组
         */
       受保护的 $默认实例 = 阵列(
               '标题'   => '',
               '内容' => '',
       );

       /**
*设置新的自定义HTML小部件实例。
         *
*@自4.8.1起
         */
       公众的 功能 __构造() {
               $widget_ops = 阵列(
                       '类名'                   => “widget_custom_html”,
                       '说明'                 => __( “任意HTML代码。” ),
                       '自定义_选择_刷新' => 真的,
                       “show_instance_in_rest”       => 真的,
               );
               $控制选项 = 阵列(
                       '宽度' => 400,
                       “高度” => 350,
               );
               父母时间：__构造( '自定义html', __( '自定义HTML' ), $小部件_操作, $控制选项 );
       }

       /**
*注册此小部件类的所有小部件实例时，添加用于排队资产的挂钩。
         *
*@自4.9.0起
         *
*@param int$number可选。此小部件实例的唯一订单号
*与同一类的其他实例进行比较。默认值为1。
         */
       公众的 功能 _寄存器_一( $个 = -1 ) {
               父母时间：_寄存器_一( $个 );
               如果 ( $这个->已注册 ) {
                       返回;
               }
               $这个->已注册 = 真的;

               /*
*请注意，自定义程序中的小部件组件也可以
*WP_Customize_widgets:：print_scripts（）中的“admin_print_scripts-widgets.php”操作。
                 */
               添加操作（_A）( “admin_print_scripts-widgets.php”, 阵列( $这个, '排队管理员脚本' ) );

               /*
*请注意，自定义程序中的小部件组件也可以
*WP_Customize_widgets:：print_footer_scripts（）中的“admin_footer-widgets.php”操作。
*/
               添加操作（_A）( 'admin_footer-widgets.php', 阵列( “WP_Widget_Custom_HTML”, 'render_control_template_scripts' ) );

               //请注意，此操作用于确保帮助文本添加到末尾。
               添加操作（_A）( 'admin_head-widgets.php', 阵列( “WP_Widget_Custom_HTML”, '添加帮助文本' ) );
       }

       /**
*筛选库短代码属性。
         *
*阻止网站的所有附件显示在
*$post上下文不可用的非奇异模板。
         *
*@自4.9.0起
         *
*@param array$attrs属性。
*@return数组属性。
         */
       公众的 功能 _过滤器库短代码属性( $属性 ) {
               如果 ( ! 是奇异的（_S）() && 空的( $属性[“id”] ) && 空的( $属性[“包含”] ) ) {
                       $属性[“id”] = -1;
               }
               返回 $属性;
       }

       /**
*输出当前自定义HTML小部件实例的内容。
         *
*@自4.8.1起
         *
*@global WP_Post$Post全局发布对象。
         *
*@param array$args显示参数，包括“before_title”、“after_title”、，
*'before_widget'和'after_widget]。
*当前自定义HTML小部件实例的@param array$instance设置。
         */
       公众的 功能 小装置( $个参数, $实例 ) {
               全球的 $帖子;

               //覆盖全局$post，以便在一致的上下文中应用筛选器（和短代码）。
               $original_post（原始_发布） = $帖子;
               如果 ( 是奇异的（_S）() ) {
                       //确保post始终是单个查询中的查询对象（而不是来自未能清理全局$post的另一个子查询）。
                       $帖子 = 获取查询对象();
               } 其他的 {
                       //在小部件渲染期间将$post全局设置为null，以防止在存档查询中使用意外上下文运行短代码。
                       $帖子 = 无效的;
               }

               //防止从媒体库中转储所有附件。
               添加筛选器( “shortcode_atts_gallery”, 阵列( $这个, '过滤库短代码属性' ) );

               $实例 = 阵列_合并( $这个->默认实例（_I）, $实例 );

               /**这个过滤器记录在wp-includs/widget/class-wp-widget-pages.php中*/
               $标题 = 应用筛选器( '小部件_标题', $实例['标题'], $实例, $这个->id基础（_B） );

               //准备看起来像普通文本小部件的实例数据。
               $模拟_文本_小部件_实例 = 阵列_合并(
                       $实例,
                       阵列(
                               “文本”   => 发行( $实例['内容'] ) ? $实例['内容'] : '',
                               '筛选器' => 假, //因为没有应用wpauto。
                               “可视化” => 假, //因为它不是在TinyMCE中创建的。
                       )
               );
               未设置( $模拟_文本_小部件_实例['内容'] ); //已移至“文本”属性。

               /**该过滤器记录在wp-includes/widgets/class-wp-widget-text.php中*/
               $内容 = 应用筛选器( '小部件_文本', $实例['内容'], $simulated_text_widget_instance（模拟文本桥实例）, $这个 );

               //将“noopener”关系添加到具有目标的所有HTMLA元素中，而不重复值。
               $内容 = wp_目标链接_rel( $内容 );

               /**
*过滤自定义HTML小部件的内容。
                 *
*@自4.8.1起
                 *
*@param string$content小部件内容。
*@param array$instance当前小部件的设置数组。
*@param WP_Widget_Custom_HTML$Widget当前自定义HTML小部件实例。
                 */
               $内容 = 应用筛选器( '小部件自定义内容', $内容, $实例, $这个 );

               //还原全局日志。
               $帖子 = $original_post（原始_发布）;
               删除过滤器( “shortcode_atts_gallery”, 阵列( $这个, '过滤库短代码属性' ) );

               //将Text小部件的容器类名与该小部件的类名一起注入，以实现主题样式兼容性。
               $args美元[“before_widget”] = preg_替换( '/（？<=\sclass=[“\']）/', '小部件_文本', $个参数[“before_widget”] );

               回声 $个参数[“before_widget”]；
               如果 ( ! 空的( $标题 ) ) {
                       回声 $个参数[“before_title”] . $标题 . $args美元['标题之后']；
               }
               回声 '<div class=“textwidget custom-html-widget”>'; //textwidget类用于主题样式兼容性。
               回声 $内容;
               回声 '</div>';
               回声 $个参数[“after_widget”]；
       }

       /**
*处理当前自定义HTML小部件实例的更新设置。
         *
*@自4.8.1起
         *
*@param array$new_instance用户通过输入此实例的新设置
*WP_Widget:：form（）。
*@param array$old_instance此实例的旧设置。
*@return array Settings可保存，bool false可取消保存。
         */
       公众的 功能 更新( $新实例, $old_instance（旧实例） ) {
               $实例         = 阵列_合并( $这个->默认实例（_I）, $old_instance（旧实例） );
               $实例['标题'] = 清理文本字段( $新实例['标题'] );
               如果 ( 当前用户can( '未感兴趣.html' ) ) {
                       $实例['内容'] = $新实例['内容']；
               } 其他的 {
                       $实例['内容'] = wp_kses_post（服务器）( $新实例['内容'] );
               }
               返回 $实例;
       }

       /**
*加载小部件控件所需的脚本和样式。
         *
*@自4.9.0起
         */
       公众的 功能 队列管理员脚本() {
               $设置 = wp_enqueue_code_editor(
                       阵列(
                               “类型”       => '文本/html',
                               '代码镜像' => 阵列(
                                       '缩进单位' => 2,
                                       '选项卡大小'   => 2,
                               ),
                       )
               );

               wp_排队_脚本( '自定义html小部件' );
               wp_add_inline脚本( '自定义html小部件', 把格式数据写成串( 'wp.customHtmlWidgets.idBases.push（%s）；', wp_json编码( $这个->id基础（_B） ) ) );

               如果 ( 空的( $设置 ) ) {
                       $设置 = 阵列(
                               “已禁用” => 真的,
                       );
               }
               wp_add_inline脚本( '自定义html小部件', 把格式数据写成串( 'wp.customHtmlWidgets.init（%s）；', wp_json编码( $设置 ) ), '之后' );

               1100亿美元 = 阵列(
                       '错误通知' => 阵列(
                               /*转换器：%d：错误计数*/
                               “单数” => _n个( '有%d个错误，必须先修复才能保存。', '有%d个错误必须先修复，然后才能保存。', 1 ),
                               /*转换器：%d：错误计数*/
                               “复数”   => _n个( '有%d个错误，必须先修复才能保存。', '有%d个错误必须先修复，然后才能保存。', 2 ),
                               //@todo这是缺乏的，因为有些语言有专用的双重形式。有关JS中复数的正确处理，请参阅#20491。
                       ),
               );
               wp_add_inline脚本( '自定义html小部件', 把格式数据写成串( 'jQuery.extend（wp.customHtmlWidgets.l10n，%s）；', wp_json编码( 1100亿美元 ) ), “之后” );
       }

       /**
*输出自定义HTML小部件设置表单。
         *
*@自4.8.1起
*@自4.9.0起表单仅包含隐藏的同步输入。有关控件UI的信息，请参见“WP_Widget_Custom_HTML:：render_control_template_scripts（）”。
         *
*@请参阅WP_Widget_Custom_HTML:：render_control_template_scripts（）
         *
*@param array$instance当前实例。
         */
       公众的 功能 形式( $实例 ) {
               $实例 = wp_parse_args( (阵列) $实例, $这个->默认实例（_I） );
               ?>
<输入id=“<?php（电话） 回声 $这个->获取字段id( '标题' ); ?>“name=”<?php（电话） 回声 $这个->获取字段名称( '标题' ); ?>“class=”title sync-input“type=”hidden“value=”<?php（电话） 回声 esc属性( $实例['标题'] ); ?>" />
<textarea id=“<?php（电话） 回声 $这个->获取字段id( '内容' ); ?>“name=”<?php（电话） 回声 $这个->获取字段名称( '内容' ); ?>“class=”content sync-input“隐藏><?php（电话） 回声 esc_文本区域( $实例['内容'] ); ?></text区域>
               <?php（电话）
       }

       /**
*呈现表单模板脚本。
         *
*@自4.9.0起
         */
       公众的 静止的 功能 渲染控制模板脚本() {
               ?>
<script type=“text/html”id=“tmpl-widget-custom-html-control-fields”>
<#var elementIdPrefix='el'+字符串（Math.random（））.replace（/\D/g，''）+'_'#>
<p>
<label for=“{{elementIdPrefix}}title”><?php（电话） esc_html_e( '标题：' ); ?></label>
<input id=“{{elementIdPrefix}}title”type=“text”class=“widefat title”>
</p>

<p>
<label for=“｛｛elementIdPrefix｝｝content”id=“｛｛elementIdPrefix｝｝content label”><?php（电话） esc_html_e文件( '内容£º' ); ?></label>
<textarea id=“{{elementIdPrefix}}-content”class=“widefat-code-content”rows=“16”cols=“20”></textarea>
</p>

                       <?php（电话） 如果 ( ! 当前用户can( '未筛选_html' ) ) : ?>
                               <?php（电话）
                               $probably_unsafe_html = 阵列( '脚本', “iframe”, '表单', “输入”, “样式” );
                               $allowed_html         = wp_kses_allowed_html( “发布” );
                               $不允许_html     = 阵列差异( $probably_unsafe_html, 数组键( $allowed_html ) );
                               ?>
                               <?php（电话） 如果 ( ! 空的( $不允许_html ) ) : ?>
<#if（data.codeEditorDisabled）{#>
<p>
                                                       <?php（电话） _e（电子）( '不允许使用某些HTML标记，包括：' ); ?>
<代码><?php（电话） 回声 内爆( “</code>，<code>”, $不允许_html ); ?></code>
</p>
<#｝#>
                               <?php（电话） 结尾; ?>
                       <?php（电话） 结尾; ?>

<div class=“code-editor-error-container”>
</script>
               <?php（电话）
       }

       /**
*将帮助文本添加到小部件管理屏幕。
         *
*@自4.9.0起
         */
       公众的 静止的 功能 添加帮助文本() {
               $屏幕 = 获取当前屏幕();

               $内容 = “<p>”;
               $内容 .= __( '使用自定义HTML小部件将任意HTML代码添加到小部件区域。' );
               $内容 .= “</p>”;

               如果 ( “false” !== wp_获取当前用户()->语法突出显示 ) {
                       $内容 .= “<p>”;
                       $内容 .= 把格式数据写成串(
                               /*翻译人员：1：链接到用户配置文件，2：其他链接属性，3：辅助功能文本*/
                               __( '编辑字段自动突出显示代码语法。您可以在<a href=“%1$s”%2$s>用户配置文件%3$s中禁用此功能，以便在纯文本模式下工作。' ),
                               esc_url( 获取编辑配置文件url() ),
                               'class=“external-link”target=“_blank”',
                               把格式数据写成串(
                                       '<span class=“screen-reader-text”>%s</span>',
                                       /*翻译器：隐藏的辅助功能文本*/
                                       __( '（在新选项卡中打开）' )
                               )
                       );
                       $内容 .= “</p>”;

                       $内容 .= '<p id=“editor-keyboard-trap-help-1”>' . __( '使用键盘导航时：' ) . “</p>”;
                       $内容 .= “<ul>”;
                       $内容 .= '<li id=“editor-keyboard-trap-help-2”>' . __( '在编辑区域中，Tab键输入制表符。' ) . “</li>”;
                       $内容 .= '<li id=“editor-keyboard-trap-help-3”>' . __( '要离开此区域，请按Esc键，然后按Tab键。' ) . “</li>”;
                       $内容 .= '<li id=“editor-keyboard-trap-help-4”>' . __( '屏幕阅读器用户：在窗体模式下，可能需要按两次Esc键。' ) . “</li>”;
                       $内容 .= “</ul>”;
               }

               $屏幕->添加帮助标签(
                       阵列(
                               “id”     => '自定义html_widget',
                               '标题'   => __( '自定义HTML小工具' ),
                               '内容' => $内容,
                       )
               );
       }
}