Архитектура плагинаХуки WordpressSafe Style CSS

Хук safe_style_css в WPFTS

Хук safe_style_css — это фильтр WordPress, который используется для определения списка разрешенных CSS-свойств, которые можно использовать в HTML-атрибуте style и в тегах “style”, когда WordPress очищает HTML-код с помощью функции wp_kses(). WPFTS использует этот фильтр для добавления свойства display в список разрешенных свойств.

Что делает WPFTS при вызове safe_style_css:

  1. Добавление свойства display: Плагин добавляет свойство display в массив разрешенных CSS-свойств. Это необходимо, потому что иногда HTML-код, генерируемый плагином (например, в Smart Excerpts), содержит это свойство, и без его явного разрешения оно будет удалено функцией wp_kses().

Важные функции, задействованные в обработке safe_style_css:

  • Нет специфических функций WPFTS, используется стандартный механизм WordPress.

Как это использовать в разработке аддонов:

Если ваш аддон генерирует HTML-код, содержащий атрибут style или теги “style”, и вы используете функцию wp_kses() для очистки этого кода, вам может потребоваться добавить необходимые CSS-свойства в список разрешенных с помощью фильтра safe_style_css.

Пример:

Plain textANTLR4BashCC#CSSCoffeeScriptCMakeDartDjangoDockerEJSErlangGitGoGraphQLGroovyHTMLJavaJavaScriptJSONJSXKotlinLaTeXLessLuaMakefileMarkdownMATLABMarkupObjective-CPerlPHPPowerShell.propertiesProtocol BuffersPythonRRubySass (Sass)Sass (Scss)SchemeSQLShellSwiftSVGTSXTypeScriptWebAssemblyYAMLXML // Добавляем свойство "position" в список разрешенных. add_filter( 'safe_style_css', 'add_position_to_safe_styles' ); function add_position_to_safe_styles( $styles ) { $styles[] = 'position'; return $styles; }

content_copyUse code with caution.PHP

Дополнительные замечания:

  • Фильтр safe_style_css используется для повышения безопасности сайта, предотвращая использование потенциально опасных CSS-свойств в HTML-коде.

  • Добавление свойства display в список разрешенных в WPFTS, вероятно, связано с использованием этого свойства для отображения/скрытия элементов в Smart Excerpts. Однако, более правильным решением было бы использовать CSS-классы для этих целей, что позволило бы избежать необходимости модифицировать список разрешенных CSS-свойств.

Этот пример демонстрирует, как WPFTS использует фильтр safe_style_css, и может быть полезен для разработчиков аддонов.

Pre Get PostsSave Post