README

=== S3 Uploads Audit ===
Contributors: humanmade
Tags: s3, audit, uploads, logging, humanmade
Requires at least: 5.8
Tested up to: 6.7
Stable tag: 0.1.0
Requires PHP: 8.1
Requires Plugins: s3-uploads
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds audit functionality for S3 Uploads actions, e.g., ACL changes. This plugin is an add-on for the S3 Uploads plugin.

== Description ==

The S3 Uploads Audit plugin extends the functionality of the [S3 Uploads](https://wordpress.org/plugins/s3-uploads/) plugin by adding an audit trail for specific actions. This helps administrators track changes and maintain security for their S3-hosted media.

Current audited actions:
* ACL changes on objects

It integrates with the [Stream](https://wordpress.org/plugins/stream/) plugin to log those actions, providing a comprehensive audit trail within your WordPress admin area.

This plugin is developed and maintained by [Human Made](https://humanmade.com/).

== Installation ==

1. Ensure the "S3 Uploads" plugin is installed and activated. You can download it from the [WordPress plugin repository](https://wordpress.org/plugins/s3-uploads/).
2. Upload the `s3-upload-audit` folder to the `/wp-content/plugins/` directory on your WordPress installation.
3. Activate the "S3 Uploads Audit" plugin through the 'Plugins' menu in WordPress.

== Frequently Asked Questions ==

= What actions does this plugin audit? =
Currently, the plugin is set up to audit ACL changes on objects. Future versions may include more actions.

= Does this plugin work without S3 Uploads? =
No, this plugin is an add-on for S3 Uploads and requires it to be active.

= Does this plugin integrate with other audit logging plugins? =
Currently, the primary integration is with the Stream plugin. We welcome contributions to integrate with other popular audit logging plugins. Please see our development repository for more information on contributing.

== Changelog ==

= 0.1.0 - 2025-06-02 =
* Initial release and integration to Stream.

== Upgrade Notice ==

= 0.1.0 =
* Stream audit logging support.