# GPL Times - Automatic Updates Plugin

GPL Times is a WordPress plugin that enables automatic updates for GPL licensed plugins and themes directly from GPL Times.

## Features

- **API Key Activation**: Activate using a single API key from your GPL Times account — simpler and more secure than username/password
- **Backward Compatible Auth**: Legacy username/password (JWT) login still supported for existing installs
- **Seamless Migration**: Sites on older versions automatically receive and switch to API key authentication on their next update check — no manual re-activation needed
- **Automatic Updates**: Receive updates for GPL licensed plugins and themes automatically
- **Auto-Update Scheduling**: Schedule automatic updates at specific times (daily, weekly, or custom days)
- **Selective Update Control**: Choose which plugins/themes receive updates
- **Per-Item Auto-Update Control**: Set individual items to auto or manual update mode
- **Safety Rules**: Skip major updates, beta versions, and limit updates per run
- **Email Notifications**: Get notified when scheduled updates complete or fail
- **Update History**: Track all automatic updates with detailed logs
- **Whitelabel Options**: Rebrand the plugin with your company's identity
- **Beta Updates**: Option to receive beta versions of products
- **Export/Import Settings**: Easily transfer settings between sites
- **Translations**: 7 languages included — French (`fr_FR`), Portuguese Brazil (`pt_BR`), German (`de_DE`), Italian (`it_IT`), Dutch (`nl_NL`), Russian (`ru_RU`), Chinese Simplified (`zh_CN`), and Spanish (`es_ES`). Set your site language under **Settings → General** to activate automatically.

## Requirements

- WordPress 5.0 or higher
- PHP 7.4 or higher

## Installation

1. Download the plugin zip file from your GPL Times account
2. Log in to your WordPress admin area
3. Go to Plugins > Add New > Upload Plugin
4. Upload the zip file and click Install Now
5. Activate the plugin
6. Navigate to GPL Times in the admin menu
7. Enter your API key (found at My Account → API Key on gpltimes.com) and click Activate
8. Alternatively, use the "Username & Password" tab for legacy login

## Directory Structure

```
gpltimes/
├── gpltimes.php              # Main plugin file
├── includes/
│   ├── autoload.php          # PSR-4 autoloader
│   ├── admin/                # Admin functionality
│   │   ├── class-ajax.php    # AJAX handlers
│   │   ├── class-enqueue.php # Asset enqueuing
│   │   └── class-pages.php   # Admin pages
│   ├── api/
│   │   └── class-client.php  # API communication
│   ├── compatibility/
│   │   └── class-third-party.php # Third-party fixes
│   ├── core/
│   │   ├── class-activator.php   # Activation logic
│   │   ├── class-deactivator.php # Deactivation logic
│   │   └── class-plugin.php      # Main plugin class
│   ├── cron/
│   │   └── class-handler.php # Cron job handler
│   ├── autoupdate/
│   │   ├── class-scheduler.php  # Auto-update scheduler
│   │   ├── class-executor.php   # Update executor
│   │   └── class-notifier.php   # Email notifications
│   └── updater/
│       ├── class-item-updater.php # Individual item updater
│       └── class-manager.php      # Update manager
├── templates/                # Admin templates
├── assets/                   # CSS and JS files
├── languages/                # Translation templates (.pot) and locales (.po / .mo)
├── uninstall.php            # Clean uninstall
└── CHANGELOGS.md            # Version history
```

## Options Reference

The plugin uses the following WordPress options:

| Option | Description |
|--------|-------------|
| `gpltimes_api_key` | API key (preferred auth — v5.9.0+) |
| `gplstatus` | JWT authentication token (legacy, still supported) |
| `gpltokenid` | User ID |
| `username` | Stored username (legacy JWT path) |
| `password` | Stored password (legacy JWT path) |
| `gplcrondata` | Cached update data |
| `gpldiffslug` | Managed plugin/theme slugs |
| `gpluncheckdata` | Disabled updates list |
| `gpltimes_whitelabel_settings` | Whitelabel configuration |
| `gpltimes_beta_updates` | Beta updates preference |
| `gpltimes_version` | Current plugin version |
| `gpltimes_last_update_check` | Last update check timestamp |
| `gpltimes_autoupdate_settings` | Auto-update schedule configuration |
| `gpltimes_autoupdate_items` | Per-item auto-update preferences |
| `gpltimes_update_log` | History of automatic updates |

## Cron Jobs

| Hook | Frequency | Description |
|------|-----------|-------------|
| `gpl_plugin_update_check` | Hourly | Check for updates |
| `gpltimes_auth_recheck` | Twice daily | Revalidate authentication |
| `gpltimes_auto_update` | Scheduled | Run automatic updates (user-configured) |

## Support

For support, please visit [GPL Times](https://www.gpltimes.com) or contact our support team.

## License

This plugin is licensed under GPL v2 or later.