Description
Wieczo’s Virus Scanner is a WordPress plugin that allows users to upload files from the WordPress admin area and scan them for viruses and malware by sending them to a ClamAV service.
Additionally, the plugin sends every upload to ClamAV first. If a virus is found, the upload is aborted.
The plugin also supports scanning your whole WordPress installation for malware and viruses.
The plugin connects to a ClamAV service using the Host and Port variables configured in the plugin settings.
Features
- File Upload: Allows file uploads through a user-friendly admin page.
- Upload Scan: Scans all uploaded files for viruses and malware.
- Full Scan: Separate page to scan the whole WordPress installation for malware and viruses.
- ClamAV Integration: Sends files via a socket connection to a ClamAV service for virus scanning.
- Easy Configuration: Configure the host and port of the ClamAV service in the plugin settings.
How to Contribute
Weβre excited to welcome contributors to Wieczo’s Virus Scanner!
Whether you’re a seasoned developer or just getting started, your input is valuable.
You can help us by reporting bugs, suggesting new features, or improving the code.
Itβs a great way to sharpen your skills and make a real impact.
Just fork the repository, work on your ideas, and submit a pull request.
Weβll review it as soon as possible and work together to make this plugin even better!
Contributors
We want to thank all of our contributors! Here’s a list of everyone who has helped make this project better:
- Thomas Wieczorek – Project Creator
- Simon Neutert – Always an inspiration and contributes with his thoughts
and well-spoken arguments.
Manual Installation:
- Upload the
wieczos-virus-scanner
directory to your WordPress installation’s/wp-content/plugins/
directory. - Activate the plugin in the WordPress Admin area under βPlugins.β
- Configure the ClamAV service under Settings -> ClamAV Settings (enter the host and port of the ClamAV service).
Configuration
After activating the plugin, you can configure the connection information for your ClamAV service as follows:
- Go to Settings -> ClamAV Scanner.
-
Enter the Host and Port of your ClamAV service, for example:
- Host:
127.0.0.1
(if the service is running locally, default:clamav
) - Port:
3310
(default port for ClamAV)
- Host:
-
Optionally, you can set a Timeout to define the maximum wait time for the connection to the ClamAV service.
Usage
1. Upload Scan
Once the plugin is activated, it automatically scans all uploads for viruses.
2. Manually Upload and Scan Files
- Navigate to ClamAV Scanner -> File Scanner in the WordPress admin menu.
- Select a file you want to scan for viruses and click βScan File.β
- The plugin sends the file via a socket to the ClamAV service, and you will receive the scan result directly in the admin dashboard.
How It Works
- The plugin uses the PHP
socket
functionality to establish a connection with a ClamAV service. - Files uploaded through the WordPress admin interface are temporarily stored on the server.
- The plugin then opens a socket connection to the configured ClamAV host and port and sends the uploaded file for analysis.
- After the scan, the plugin displays the scan results on the admin page.
Requirements
- WordPress 6.7 or higher
- A running ClamAV service that is accessible via a network socket (default port: 3310).
- PHP sockets must be enabled on the server.
Development
Local Development
-
Clone this repository into the
/wp-content/plugins/
directory of your local WordPress project:bash
git clone https://github.com/wieczo/wieczos-virus-scanner.git
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Wieczo's Virus Scanner” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Wieczo's Virus Scanner” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.0
- Adds full scan of all WordPress files
- Extends the table to log all errors which happen during a scan
- Replaces the old standard HTML table with a WP_List_Table to support sorting, multi-actions and more
1.1.0
- Adds uninstall.php
- Adds table to log virus findings
1.0.0
Initial release.