mirror of
https://github.com/ezyang/htmlpurifier.git
synced 2024-11-08 23:08:42 +00:00
7a4c7b3777
+ %HTML.EnableAttrID - restores old behavior by allowing IDs + %Attr.IDPrefix - %Attr.IDBlacklist alternative that munges all user IDs so that they don't collide with your IDs + %Attr.IDPrefixLocal - Same as above, but for when there are multiple instances of user content on the page + Profuse documentation on how to use these available in id.txt git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@526 48356398-32a2-884e-a903-53898d9a118a
85 lines
3.2 KiB
PHP
85 lines
3.2 KiB
PHP
<?php
|
|
|
|
require_once 'HTMLPurifier/AttrDef.php';
|
|
require_once 'HTMLPurifier/IDAccumulator.php';
|
|
|
|
HTMLPurifier_ConfigSchema::define(
|
|
'Attr', 'IDPrefix', '', 'string',
|
|
'String to prefix to IDs. If you have no idea what IDs your pages '.
|
|
'may use, you may opt to simply add a prefix to all user-submitted ID '.
|
|
'attributes so that they are still usable, but will not conflict with '.
|
|
'core page IDs. Example: setting the directive to \'user_\' will result in '.
|
|
'a user submitted \'foo\' to become \'user_foo\' Be sure to set '.
|
|
'%HTML.EnableAttrID to true before using '.
|
|
'this. This directive was available since 1.2.0.'
|
|
);
|
|
|
|
HTMLPurifier_ConfigSchema::define(
|
|
'Attr', 'IDPrefixLocal', '', 'string',
|
|
'Temporary prefix for IDs used in conjunction with %Attr.IDPrefix. If '.
|
|
'you need to allow multiple sets of '.
|
|
'user content on web page, you may need to have a seperate prefix that '.
|
|
'changes with each iteration. This way, seperately submitted user content '.
|
|
'displayed on the same page doesn\'t clobber each other. Ideal values '.
|
|
'are unique identifiers for the content it represents (i.e. the id of '.
|
|
'the row in the database). Be sure to add a seperator (like an underscore) '.
|
|
'at the end. Warning: this directive will not work unless %Attr.IDPrefix '.
|
|
'is set to a non-empty value! This directive was available since 1.2.0.'
|
|
);
|
|
|
|
/**
|
|
* Validates the HTML attribute ID.
|
|
* @warning Even though this is the id processor, it
|
|
* will ignore the directive Attr:IDBlacklist, since it will only
|
|
* go according to the ID accumulator. Since the accumulator is
|
|
* automatically generated, it will have already absorbed the
|
|
* blacklist. If you're hacking around, make sure you use load()!
|
|
*/
|
|
|
|
class HTMLPurifier_AttrDef_ID extends HTMLPurifier_AttrDef
|
|
{
|
|
|
|
function validate($id, $config, &$context) {
|
|
|
|
$id = trim($id); // trim it first
|
|
|
|
if ($id === '') return false;
|
|
|
|
$prefix = $config->get('Attr', 'IDPrefix');
|
|
if ($prefix !== '') {
|
|
$prefix .= $config->get('Attr', 'IDPrefixLocal');
|
|
// prevent re-appending the prefix
|
|
if (strpos($id, $prefix) !== 0) $id = $prefix . $id;
|
|
} elseif ($config->get('Attr', 'IDPrefixLocal') !== '') {
|
|
trigger_error('%Attr.IDPrefixLocal cannot be used unless '.
|
|
'%Attr.IDPrefix is set', E_USER_WARNING);
|
|
}
|
|
|
|
$id_accumulator =& $context->get('IDAccumulator');
|
|
if (isset($id_accumulator->ids[$id])) return false;
|
|
|
|
// we purposely avoid using regex, hopefully this is faster
|
|
|
|
if (ctype_alpha($id)) {
|
|
$result = true;
|
|
} else {
|
|
if (!ctype_alpha(@$id[0])) return false;
|
|
$trim = trim( // primitive style of regexps, I suppose
|
|
$id,
|
|
'A..Za..z0..9:-._'
|
|
);
|
|
$result = ($trim === '');
|
|
}
|
|
|
|
if ($result) $id_accumulator->add($id);
|
|
|
|
// if no change was made to the ID, return the result
|
|
// else, return the new id if stripping whitespace made it
|
|
// valid, or return false.
|
|
return $result ? $id : false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
?>
|