library/HTMLPurifier/ConfigSchema/schema/URI.SafeIframeRegexp.txt

   1 URI.SafeIframeRegexp
   2 TYPE: string/null
   3 VERSION: 4.4.0
   4 DEFAULT: NULL
   5 --DESCRIPTION--
   6 <p>
   7     A PCRE regular expression that will be matched against an iframe URI.  This is
   8     a relatively inflexible scheme, but works well enough for the most common
   9     use-case of iframes: embedded video.  This directive only has an effect if
  10     %HTML.SafeIframe is enabled.  Here are some example values:
  11 </p>
  12 <ul>
  13     <li><code>%^http://www.youtube.com/embed/%</code> - Allow YouTube videos</li>
  14     <li><code>%^http://player.vimeo.com/video/%</code> - Allow Vimeo videos</li>
  15     <li><code>%^http://(www.youtube.com/embed/|player.vimeo.com/video/)%</code> - Allow both</li>
  16 </ul>
  17 <p>
  18     Note that this directive does not give you enough granularity to, say, disable
  19     all <code>autoplay</code> videos.  Pipe up on the HTML Purifier forums if this
  20     is a capability you want.
  21 </p>
  22 --# vim: et sw=4 sts=4