The Filter Package

Installation via Composer

Add "joomla/filter": "~3.0.*@dev" to the require block in your composer.json and then run composer install.

{
	"require": {
		"joomla/filter": "~3.0"
	}
}

Alternatively, you can simply run the following from the command line:

composer require joomla/filter "~3.0"

If you want to include the test sources, use

composer require --prefer-source joomla/filter "~3.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.