VoteMotta2028 Creator Rolodex v1.0

Public:
  /creator-directory/

Admin:
  /creator-directory/admin.php?token=PRIVATE_TOKEN

Automation:
  cPanel Cron every 15 minutes:
  */15 * * * * /usr/local/bin/php -q /home/votehhhm/public_html/creator-directory/cron/sync.php >/dev/null 2>&1

Core behavior
-------------
1. Scans public VoteMotta2028 HTML/PHP pages for supported YouTube and social post URLs.
2. Normalizes platform IDs and stores UNIQUE(platform, content_key) so the same video/post is never duplicated.
3. Stores UNIQUE(platform, account_key) for creator accounts.
4. If a creator account does not exist, a creator record is automatically created.
5. YouTube cards immediately use the real video thumbnail:
   https://i.ytimg.com/vi/VIDEO_ID/hqdefault.jpg
6. YouTube sync keeps the most recent 5 channel videos.
7. Each creator page also shows the five newest unique items across all platforms.
8. YouTube API (optional but recommended) adds title, description, publish date, duration,
   views, likes, comments, embeddable status, channel avatar, subscriber/view/video counts.
9. Creator-published URLs in YouTube descriptions are classified into:
   tip/support, store/merch, newsletter, podcast, social, website.
10. Tip Creator is displayed only when a creator-published/approved support link exists.
11. Claim/correction form lets creators request ownership or corrections.
12. Admin duplicate-creator merge is provided for creators who use different handles on different platforms.

Supported content normalization
-------------------------------
YouTube, X/Twitter, TikTok, Instagram, Facebook, Truth Social, Threads, Reddit.
Facebook post rendering is supported when a Facebook content record is ingested by a future adapter.

Recommended next-phase connectors
---------------------------------
YouTube Data API: implemented.
YouTube recent uploads: implemented via uploads playlist and feed fallback.
X: dedupe + embed from public status URLs; API sync can be added if X API credentials are supplied.
Instagram/TikTok/Facebook/Threads/Truth/Reddit: public URL ingestion and official-style embed/link rendering;
official API sync requires the appropriate platform app credentials/permissions.

Important
---------
Do not scrape or invent tip/store URLs. The directory only shows support/store links that are
creator-published, auto-discovered from creator content, or approved by a claimed creator.

YouTube near-real-time push
---------------------------
The module includes /creator-directory/websub.php as a YouTube PubSubHubbub/WebSub callback.
After YouTube channels have resolved channel IDs, use Creator Admin -> Subscribe all YouTube channels.
The regular 15-minute cron remains the backup scanner/synchronizer and renews subscriptions periodically.