The Filter Package
Installation via Composer
Add "joomla/filter": "~2.0.*@dev"
to the require block in your composer.json and then run composer install
.
{
"require": {
"joomla/filter": "~2.0"
}
}
Alternatively, you can simply run the following from the command line:
composer require joomla/filter "~2.0"
If you want to include the test sources, use
composer require --prefer-source joomla/filter "~2.0"
Note that the Joomla\Language
package is an optional dependency and is only required if the application requires the use of OutputFilter::stringURLSafe
.
Upgrades from 1 to 2
Note the InputFilter static class constants have been renamed:
Before | After |
---|---|
InputFilter::TAGS_WHITELIST | InputFilter::ONLY_ALLOW_DEFINED_TAGS |
InputFilter::TAGS_BLACKLIST | InputFilter::ONLY_BLOCK_DEFINED_TAGS |
InputFilter::ATTR_WHITELIST | InputFilter::ONLY_ALLOW_DEFINED_ATTRIBUTES |
InputFilter::ATTR_BLACKLIST | InputFilter::ONLY_BLOCK_DEFINED_ATTRIBUTES |
The public property InputFilter::tagBlacklist
has been renamed to InputFilter::blockedTags
. Similarly InputFilter::attrBlacklist
has been renamed to InputFilter::blockedAttributes
All code usage of these properties remains unchanged.