Lecteur Markdown
CAPPARSER_DOCUMENTATION_EN
Feature: CAPParser #
Real-time disaster alert monitor. Aggregates CAP (Common Alerting Protocol) alerts from multiple global sources (NOAA, Environment Canada, BOM Australia, GDACS) with caching and priority sorting.
---
Installation and Configuration #
Via FTP: Upload the `capparser/` directory into `/plugins/`.
Via package manager: Select `capparser` from the available plugins list.
Paths:
- Main plugin: `/plugins/capparser/capparser.php`
- Configuration: `/plugins/capparser/conf/capparser.conf.inc.php`
- Classes: `/plugins/capparser/lib/CAPParser.class.php`, `CAPFetcher.class.php`, `CAPCache.class.php`, `CAPFilterService.class.php`
Configuration parameters:
| Variable | Default | Description |
|---|---|---|
| `$basedatadisplay` | `'yes'` | Display in management interface |
| `$basedisplevel` | `BASE_LEVEL_USER` | Minimum required level |
| `$ftype` | `1` | Plugin type (content) |
Cache TTL per source:
- NOAA: 5 minutes
- Environment Canada: 10 minutes
- BOM: 15 minutes
- GDACS: 15 minutes
Cache backend: Redis if available, otherwise file-based.
---
Usage #
The dashboard displays:
- Total active alerts
- High priority alerts (level 7+/10)
- Affected countries
- Detail table: source, type, severity, urgency, geographic area, priority
Priority is calculated by combining the alert's severity and urgency (scale 1–10).
Force refresh: the `?force=1` parameter bypasses the cache.
---
Hooks and Entry Points #
?obj=capparser.php — Alert dashboard
?obj=capparser.php&force=1 — Force refresh
---
Dependencies #
- PHP cURL extension — fetching CAP feeds
- PHP SimpleXML extension — XML feed parsing
- Redis (optional) — high-performance cache
- `Beamreactor\Sanitizer\Parser`