Pearl - Events iCal, Posts filtering, Project Images

[dChiamp]

Project-specific additions built for the Pearl site. Parking this as a PR per team convention until we decide what should land on main vs. stay Pearl-only.

Events iCal feed

Adds GET /wp-json/fuxt/v1/events.ics, serving the Events CPT as an RFC 5545 iCalendar feed for the frontend calendar (FullCalendar's icalendar plugin), Google Calendar, or any webcal-compatible app. Reads start/end/venue from the event_details ACF group.

Posts endpoint: multi-term filtering, priority ordering, ID lookup

Extends term_slug filtering on the Posts endpoint:

• Comma-separated multi-slug lookups, scoped to specific taxonomies via a new taxonomy param (needed when a slug like price-1 exists in more than one taxonomy)
• term_operator (IN/AND) to control how multiple slugs within a taxonomy combine
• priority_term_slug to pin matching posts first, with remaining filtered posts following
• include param for ID-list lookups (comma-separated, order-preserving) across all exposed post types

Project Images upload endpoint

New POST/GET /wp-json/fuxt/v1/project-images for accepting externally-submitted images outside the normal authenticated media library flow:

• POST requires an API key (X-Fuxt-Api-Key header or Authorization: Bearer, configurable via Settings → Project Images API or the FUXT_PROJECT_IMAGES_API_KEY constant), rate-limited to 20 uploads/hour per IP
• Validates real file size and image content server-side (filesize() + getimagesize()) rather than trusting client-supplied headers
• GET is public, paginated, with a submissions_only filter to scope to images uploaded via this endpoint

Also

• Adds .gitignore for .DS_Store