Access Log

Access Log

The Access Log answers three questions every file owner eventually asks: Is anyone actually using this? Who? And did anyone try and get turned away? It logs every view, download, and denied attempt to your own database — nothing leaves your site.

Privacy first. Log data lives in your WordPress database. It’s not sent to wpmediaguard.com or anywhere else.

Where to find it

Go to Media Guard → Access Log in your WordPress admin.

What gets logged

Three event types:

  • view — someone opened the protected viewer for a file (PDF in-page, image, or video player).
  • download — someone downloaded the actual file.
  • denied — someone tried to access a file but Media Guard turned them away (not logged in, wrong role, not in the right group, no matching purchase).

Each row records: date/time, user (email), file path, action, and IP address.

Stats at the top

The dashboard summary shows Total events and Today‘s count — a quick pulse-check of activity.

Reading the table

The table is paginated, newest events first. Each row tells you exactly who did what, to which file, from where. Use it to:

  • Confirm a delivery. “Did Sarah download the contract?” — search by file or user.
  • Spot blocked access. A run of denied events for one user usually means they’re logged in but missing a role/group/purchase. Troubleshooting guide.
  • See what’s hot. If one file dominates the log, you’ve found your popular content.
  • Audit unexpected activity. Unusual IP addresses or off-hours bursts are easy to spot.

Privacy & retention

Log data is stored in a dedicated table (wp_mediaguard_access_log). Because it includes user emails and IP addresses, it’s personal data for GDPR/CCPA purposes. A few practical notes:

  • Mention the log in your privacy policy if you operate in a regulated region.
  • If a user requests data deletion, remove their rows from the log along with their WordPress user.
  • Uninstalling Pro drops the entire log table via the bundled uninstaller — so export it first if you need to keep it.

Common questions

  • My log is empty. Have you actually opened a protected file as a logged-in user? Try it yourself in an incognito window after logging in. Each view/download writes a row.
  • I see denied events for “Unknown” users. That’s an unauthenticated visitor (no WordPress session). Usually a bot or someone with a direct file URL but no login.
  • Can I export? Yes, via WP-CLI or a direct database query against wp_mediaguard_access_log. A CSV export button is on the roadmap.

Next steps

  • Troubleshooting — what to do when “denied” events shouldn’t be happening.
  • Groups & Users — fix access by adding a user to the right group.