Decisions — Direction Selection

Events Page — Design Decisions

Date: 2026-03-16

Architecture

Static HTML + JS page — lightweight, no WordPress dependency, can be hosted anywhere. Fetches directly from api2.almaghrib.org/v1/wp/mega-menu-events.

Navigation Pattern

Two-level filter tabs:

• Top row: Continent tabs (North America, Europe, All)
• Second row: City pills that update based on selected continent
• Events list filters live below

Detail Level

Summary cards + expand:

• Default: Title, instructor, date, city, image
• Expand: Full description, pricing, venue, registration details
• Each event also links out to its full page on almaghrib.org

Data Source

• Primary API: GET https://api2.almaghrib.org/v1/wp/mega-menu-events (public, no auth)
• GeoIP for auto-sorting by proximity (via Request-IP-Address header)
• Continent endpoint: GET /v1/wp/get-continents

Adjacent Page

• Sits alongside /weekend-seminars/ but with richer information
• Focuses on discoverability: find events by location quickly
• Shows ALL upcoming events, not just a carousel