PRC Datasets

Canonical docs: docs/plugins/prc-datasets/

Manages the dataset post type and datasets taxonomy as a linked pair (via prc/term-data-store, namespace PRC\TDS), providing a digital-rights-management layer for file downloads, an ATP legal-acceptance gate, download telemetry, and newsletter audience building via Firebase Cloud Functions.

What it does

• Registers the dataset CPT and datasets taxonomy and binds them via prc/term-data-store so each taxonomy term has a corresponding post that holds the content and metadata.
• Adds prc-datasets post type support to post, feature, and chart so those post types can be tagged with dataset terms.
• Gated downloads — resolves the download file URL (media library attachment or legacy dataset_download_url meta) only after verifying Firebase identity (X-PRC-User-Id / X-PRC-User-Token headers) and per-IP rate limiting on get-download. Page-baked WordPress nonces are not used (they expire on edge-cached pages). A failed public resolve stamps _download_unavailable so editors can filter those datasets in DataViews.
• ATP (American Trends Panel) legal gate — marks individual datasets as ATP-restricted; users must accept the ATP Terms of Service before a download URL is returned.
• Download telemetry — tracks a cumulative total (_total_downloads), a per-year monthly breakdown (_downloads_{year}), and (from 2026-08-01) day buckets in _downloads_daily_{year}; also logs each download against the Firebase user record. Replacing a dataset file can set new_data_uploaded so the editor stats panel splits the affected month into before/after counts.
• Newsletter audiences — Dataset Options sidebar can Generate / Rebuild / Delete downloader audiences (async job; no draft email). wp prc datasets build-audience starts the same job, waits at the terminal, and can still create a draft transactional email.
• Custom rewrite rules for /datasets/, /datasets/{year}/, and research-team-prefixed URLs like /politics/dataset/{slug}/.
• Includes datasets in sitewide search results and ElasticPress-backed archive faceting.
• Injects dataset terms into prc_platform_post_report_package_materials so datasets appear in report package sidebars.
• Block editor sidebar panel (Dataset Options) for uploading the download file, toggling the ATP flag, viewing the monthly download heatmap, and managing downloader audiences.
• Three Gutenberg blocks and one block bindings source (see below).
• DataViews admin list — Datasets > All Datasets (prc-datasets-library) registers on the shared @prc/wp-admin-dataview shell. Rows expose hasZip, downloadUnavailable, totalDownloads, and isAtp columns; ZIP-status and download-unavailable filters map to _download_attachment_id and _download_unavailable meta. Provider assets live in build/admin-dataview/.

Key files

Blocks

REST API endpoints

All endpoints are registered under prc-api/v3 on rest_api_init.

The dataset post type also gets a _downloads REST field that exposes the same stats structure on the standard WP REST response.

WP Abilities API

Authenticated download requests

User-facing endpoints (get-download, check-atp, accept-atp, log-download) require Firebase identity via request headers (not query args or page nonces):

get-download additionally enforces per-IP rate limiting via PRC\Platform\rate_limit_hit().

Filters and hooks

Filters this plugin exposes

Filters and actions this plugin consumes

Post meta

WP-CLI commands

Registered as wp prc datasets <subcommand>.

# Aggregate ATP download counts by year (WordPress post meta)
wp prc datasets atp-downloads [--year=<year>] [--detailed] [--per-dataset] [--format=<table|csv|json|yaml>]

# Build newsletter audience from Firebase users who downloaded a dataset
wp prc datasets build-audience --dataset-id=<id> [--dry-run] [--no-create-post] [--label=<text>] [--include-unverified]

# Find datasets missing an attached download file
wp prc datasets missing-files [--dry-run]

Dependencies

Notes

• The datasets taxonomy slug is dataset (singular), so taxonomy archive URLs are /dataset/{slug}/, not /datasets/{slug}/. The /datasets/ path is the CPT archive, handled by custom rewrite rules.
• ATP acceptance state lives on the user's Firebase record, not in WordPress. The check-atp and accept-atp endpoints delegate entirely to User_Data.
• Download stats are cached per-dataset for 24 hours (dataset_downloads_{id} transient). The stats panel in the editor sidebar bypasses this cache by calling the endpoint directly.
• The admin bar "Edit" link on taxonomy archive pages is replaced with a direct link to the related dataset post edit screen.
• Build targets two separate entry points: build:blocks (three blocks via @wordpress/scripts) and build:inspector-panel (the sidebar plugin). Run both with npm run build -w @prc/datasets.