Usage

• To start, you need to have clamd running on some host accessible by your instances. collective.clamav supports either UNIX socket connections or remote connections.

• Install collective.clamav and setup the host & port or the path to the clamd socket in the control panel (default is a network connection to clamd listening on localhost at port 3310). By default Files and Images are going to be checked for viruses when added or updated.

Adding anti-virus protection to non-ATFile based content

If you want to add anti-virus protection to your custom AT content types add the isVirusFree validator to your FileField(s). For instance:

FileField('file',
  validators = (('isNonEmptyFile', V_REQUIRED),
                ('isVirusFree', V_REQUIRED),),
  widget = FileWidget(label=u'File'),
)

If you create custom Dexterity content types add only the necessary import statement to the module and all plone.namedfile fields were automatically scaned:

from Products.validation import V_REQUIRED)

Installation

Install collective.clamav by adding it to your buildout:

[buildout]

...

eggs =
    collective.clamav

and then running bin/buildout

Contribute

• Issue Tracker: https://github.com/collective/collective.clamav/issues

• Source Code: https://github.com/collective/collective.clamav

• Documentation: in the docs folder

Credits

Some code was shamelessly borrowed from pyClamd and collective.ATClamAV:

• Clam Antivirus: http://www.clamav.net

• github: https://github.com/ggozad/collective.ATClamAV

• pyClamd: http://xael.org/norman/python/pyclamd

• github: https://github.com/collective.ATClamAV

• github: https://github.com/davisagli/collective.ATClamAV

Support

If you are having issues, please let us know.

License

The project is licensed under the GPLv2.

3.0.0 (2021-01-25)

• Remove the AT schema extension and make it work within Plone 5.2 and Python 3. [Andreas Mantke]

• Increase the release number to 3 because it breaks compatibility to old Archetypes content types. [Andreas Mantke]

• Added a test for value NOT_CHANGED to the validator module because of a change in converter.py of plone.formwidget.namedfile [Andreas Mantke]

• isort and flake8 fixes in validator module [Andreas Mantke]

• Fix tests for Plone 5.2, discontinue Travis and switch to Github Actions [tschorr]

2.0a2 (2016-09-12)

• Fix ReST/pypi page syntax. [timo]

2.0a1 (2016-09-12)

• Initial release based on collective.ATClamAV with a new controlpanel module and and a configuration configlet for Plone 5 compatibility. The product and release works with Dexterity content types. [andreasma]

• Complete Plone 5 compatibility and transferring and adapting tests from collective.ATClamAV. [sneridagh]