# ContentTrace

**Protect your WordPress content with invisible fingerprints and dual detection technology. Find who copied your posts and prove ownership.**

ContentTrace embeds unique, searchable tokens into your WordPress posts. When scrapers copy your content, they copy the fingerprint too. One search proves the theft.

## External Services

This plugin relies on external services for features that require server-side processing which cannot be performed locally within WordPress.

**ContentTrace API (api.contenttrace.app)**

- Purpose: Web scanning, similarity analysis, and takedown report generation.
- Why external: These features require large-scale web crawling, CPU-intensive content comparison algorithms, and structured legal document generation that cannot run within a WordPress installation.
- Data sent: Your site domain (for identification), post content excerpts (for similarity comparison), and URLs (for analysis). Content is processed in memory and immediately discarded.
- [Privacy Policy](https://contenttrace.app/privacy.html) | [Terms of Service](https://contenttrace.app/terms.html)

**Archive.org Wayback Machine (web.archive.org)**

- Purpose: Creating timestamped snapshots of your published posts as proof of original authorship.
- Why external: Archive.org provides independently verifiable, timestamped archives that serve as legal evidence of publication date. This cannot be replicated locally.
- Data sent: The public URL of your post.
- [Terms of Use](https://archive.org/about/terms.php)

**Google Search (via browser)**

- Purpose: One-click manual search for your content fingerprints or titles.
- Data sent: Opens a search in the user's own browser. No server-side requests are made by the plugin.

## Features

All features are available to all users. The external API service may apply usage limits based on your service plan.

### Content Protection
- **Token Generation** - Unique fingerprint per post
- **Token Dashboard** - View all posts with their tokens
- **One-Click Search** - Google search links for each token
- **CSV Export** - Export all tokens for backup
- **Visible/Hidden Mode** - Choose token visibility
- **RSS Feed Tokens** - Protect against feed scrapers
- **Token Style Presets** - Choose from predefined styles
- **Exclude Categories** - Skip tokens for certain content

### Publication Proof
- **Archive.org Auto-Submit** - Automatic archiving on publish
- **Archive.org Manual** - Manual archive with verification workflow

### Duplicate Detection
- **Automated Nightly Scanning** - Scheduled scans process posts automatically (API limits apply)
- **Manual Scan All Posts** - One-click scan of published content (API limits apply)
- **Smart Compare (URL)** - Compare specific URLs against your content
- **Smart Compare (Paste Text)** - Paste suspected content for comparison
- **Server-Side Similarity Analysis** - Via ContentTrace API
- **Scan History** - Full scan session history with details

### Takedown Notices
- **DMCA Takedown Generator** - US format notices
- **EU Takedown Generator** - EU Copyright Directive notices
- **International Takedown Generator** - Berne Convention notices
- **Contact Info Management** - Save your details for notices
- **Email Integration** - Send notices directly via WordPress email

## Installation

1. Upload the `contenttrace` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu
3. Go to ContentTrace > Settings to configure
4. Tokens are automatically added to new published posts

## How It Works

1. **Protect** - ContentTrace adds unique invisible tokens to your posts
2. **Detect** - Use manual search or API scanning to find copies
3. **Prove** - Archive.org snapshots prove you published first
4. **Act** - Generate takedown notices to remove stolen content

## Token Format

```
contenttrace_123_X7k9m2_1702649123
     |         |    |        |
     |         |    |        +-- Unix timestamp
     |         |    +-- Random unique string (searchable)
     |         +-- Post ID
     +-- Prefix
```

The random string (`X7k9m2`) is your content's DNA. If found on another site, it proves copying.

## Requirements

- WordPress 5.0+
- PHP 7.4+

## Privacy

- Tokens are stored locally in your WordPress database
- Content sent for analysis is processed and immediately discarded
- No personal data is stored on external servers beyond basic usage tracking
- Archive.org submissions use the public Wayback Machine service

## License

GPL v2 or later

## Support

- Website: https://contenttrace.app
- Email: hello@contenttrace.app

## Changelog

### 1.0.0
- Initial release
- Token generation with unique fingerprints
- Full Token Dashboard with CSV export
- Archive.org auto-submit for publication proof
- Smart Compare (URL and Text)
- Quick Google Search for tokens
- Takedown notice generation (DMCA/EU/International)
- ContentTrace API integration