A plugin to scan uploaded files for viruses with ClamAV.

Kurt Payne

Upload Scanner

Scan all uploaded files with ClamAV or your favorite malware scanner

wieczo

<p><strong>Wieczo’s Virus Scanner</strong> 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.</p>
<p>Additionally, the plugin sends every upload to ClamAV first. If a virus is found, the upload is aborted.</p>
<p>The plugin also supports scanning your whole WordPress installation for malware and viruses.</p>
<p>The plugin connects to a ClamAV service using the <strong>Host</strong> and <strong>Port</strong> variables configured in the plugin settings.</p>
<h3>Features</h3>
<ul>
<li><strong>File Upload</strong>: Allows file uploads through a user-friendly admin page.</li>
<li><strong>Upload Scan</strong>: Scans all uploaded files for viruses and malware.</li>
<li><strong>Full Scan</strong>: Separate page to scan the whole WordPress installation for malware and viruses.</li>
<li><strong>ClamAV Integration</strong>: Sends files via a socket connection to a ClamAV service for virus scanning.</li>
<li><strong>Easy Configuration</strong>: Configure the host and port of the ClamAV service in the plugin settings.</li>
</ul>
<h3>How to Contribute</h3>
<p>We’re excited to welcome contributors to Wieczo’s Virus Scanner!<br />
Whether you’re a seasoned developer or just getting started, your input is valuable.<br />
You can help us by reporting bugs, suggesting new features, or improving the code.<br />
It’s a great way to sharpen your skills and make a real impact.<br />
Just fork the repository, work on your ideas, and submit a pull request.<br />
We’ll review it as soon as possible and work together to make this plugin even better!</p>
<h3>Contributors</h3>
<p>We want to thank all of our contributors! Here’s a list of everyone who has helped make this project better:</p>
<ul>
<li><a href="https://github.com/wieczo" rel="nofollow ugc">Thomas Wieczorek</a> – Project Creator</li>
<li><a href="https://github.com/simonneutert" rel="nofollow ugc">Simon Neutert</a> – Always an inspiration and contributes with his thoughts<br />
and well-spoken arguments.</li>
</ul>
<h3>Manual Installation:</h3>
<ol>
<li>Upload the <code>wieczos-virus-scanner</code> directory to your WordPress installation’s <code>/wp-content/plugins/</code> directory.</li>
<li>Activate the plugin in the WordPress Admin area under “Plugins.”</li>
<li>Configure the ClamAV service under <strong>Settings -> ClamAV Settings</strong> (enter the host and port of the ClamAV service).</li>
</ol>
<h3>Configuration</h3>
<p>After activating the plugin, you can configure the connection information for your ClamAV service as follows:</p>
<ol>
<li>Go to <strong>Settings -> ClamAV Scanner</strong>.</li>
<li>
<p>Enter the <strong>Host</strong> and <strong>Port</strong> of your ClamAV service, for example:</p>
<ul>
<li><strong>Host</strong>: <code>127.0.0.1</code> (if the service is running locally, default: <code>clamav</code>)</li>
<li><strong>Port</strong>: <code>3310</code> (default port for ClamAV)</li>
</ul>
</li>
<li>
<p>Optionally, you can set a <strong>Timeout</strong> to define the maximum wait time for the connection to the ClamAV service.</p>
</li>
</ol>
<h3>Usage</h3>
<h3>1. Upload Scan</h3>
<p>Once the plugin is activated, it automatically scans all uploads for viruses.</p>
<h3>2. Manually Upload and Scan Files</h3>
<ol>
<li>Navigate to <strong>ClamAV Scanner -> File Scanner</strong> in the WordPress admin menu.</li>
<li>Select a file you want to scan for viruses and click “Scan File.”</li>
<li>The plugin sends the file via a socket to the ClamAV service, and you will receive the scan result directly in the admin dashboard.</li>
</ol>
<h3>How It Works</h3>
<ul>
<li>The plugin uses the PHP <code>socket</code> functionality to establish a connection with a ClamAV service.</li>
<li>Files uploaded through the WordPress admin interface are temporarily stored on the server.</li>
<li>The plugin then opens a socket connection to the configured ClamAV host and port and sends the uploaded file for analysis.</li>
<li>After the scan, the plugin displays the scan results on the admin page.</li>
</ul>
<h3>Requirements</h3>
<ul>
<li>WordPress 6.7 or higher</li>
<li>A running <strong>ClamAV service</strong> that is accessible via a network socket (default port: 3310).</li>
<li>PHP sockets must be enabled on the server.</li>
</ul>
<h3>Development</h3>
<h3>Local Development</h3>
<ol>
<li>
<p>Clone this repository into the <code>/wp-content/plugins/</code> directory of your local WordPress project:</p>
<p><code>bash<br />
git clone https://github.com/wieczo/wieczos-virus-scanner.git</code></p>
</li>
</ol>


Alternatives to Wieczo's Virus Scanner

Top alternatives