Events Calendar

Overview

The Events Calendar showcases the vibrant cultural life of Dzaleka Refugee Camp - from festivals and performances to educational workshops and community gatherings. The platform helps organizers promote events and helps community members discover what’s happening.

Events automatically categorize as “upcoming” or “past” based on their date, with TBA (To Be Announced) events handled specially.

User Workflows

Discovering Events

Browse Upcoming Events

View chronologically sorted upcoming events on /events homepage or dedicated /events/upcoming/[page] pages.

Explore Past Events

Browse event history at /events/past to see photos and recaps of previous gatherings.

Filter by Type

Navigate to /events/[type]/[page] to see events by category (cultural, educational, workshop, etc.).

Find by Organizer

View all events from a specific organizer at /events/organizer/[organizer].

Event Detail Page

Each event (/events/[slug]) displays:

Hero image with event title and date
Event details: Description, location, organizer info
Date & time: Start and end times with timezone
Registration: Link to RSVP or registration form (if required)
Contact: Organizer email, phone, and WhatsApp
Category badge: Visual indicator of event type
Status indicator: Upcoming, past, or TBA designation

Automatic Status

Events automatically transition from “upcoming” to “past” based on date

TBA Support

Handle events with dates “To Be Announced” without breaking chronological sorting

Rich Media

Feature high-quality images to promote visual engagement

Schema Markup

Google Calendar and search engine integration via structured data

Content Schema

Events are stored in src/content/events/ as Markdown files with the following schema:

title: "Event Name"                          # Required
description: "Brief event overview"           # Required
date: 2024-06-29T10:00:00Z                   # Required - ISO 8601 format
endDate: 2024-06-29T22:00:00Z                # Optional - defaults to same day
location: "Dzaleka Refugee Camp"              # Required
category: "Cultural Event"                    # Required
image: "/images/event-photo.jpg"              # Required - relative or absolute URL
organizer: "Organization Name"                # Required
organizerUrl: "https://org.com"               # Optional
status: "upcoming"                            # upcoming | past | cancelled
featured: true                                # Boolean - homepage display
contact:
  email: "[email protected]"
  phone: "+265 XXX XXX XXX"
  whatsapp: "+265 XXX XXX XXX"
registration:
  required: true
  url: "https://registration-link.com"
  deadline: 2024-06-25T23:59:59Z
tags: ["pageant", "culture", "talent"]        # Array of keywords
isTBA: false                                  # Boolean - marks date as TBA

Real Example from Source

From Miss Culture Dzaleka 2024.md:

title: "Miss Culture Dzaleka 2024"
description: "Annual cultural pageant celebrating diversity and talent in Dzaleka Refugee Camp"
date: 2024-06-29T10:00:00Z
endDate: 2024-06-29T22:00:00Z
location: "Dzaleka Refugee Camp"
category: "Cultural Event"
featured: true
image: "/images/481465050_632224406175859_7536536813728888727_n.jpg"
organizer: "Dzaleka Youth Organization"
status: "past"
contact:
  email: "[email protected]"
  phone: "+265 212 095 097"
  whatsapp: "+265 212 095 097"
registration:
  required: true
  url: "https://dzalekaculture.org/register"
tags: ["pageant", "culture", "talent", "community"]

With markdown content:

## Event Overview

Miss Culture Dzaleka is an annual event celebrating the vibrant cultural 
diversity found within the Dzaleka Refugee Camp in Malawi. This event showcases 
traditional music, dance, art, and fashion, providing a platform for residents 
to express their heritage and talents.

How to Add an Event

Create Event File

Create a Markdown file in src/content/events/ with a descriptive slug:

touch src/content/events/coding-workshop-march-2025.md

Add Event Metadata

Fill in the frontmatter with event details:

---
title: "Introduction to Coding Workshop"
description: "Learn web development basics with hands-on exercises"
date: 2025-03-15T14:00:00Z
endDate: 2025-03-15T17:00:00Z
location: "Dzaleka Community Center"
category: "Workshop"
image: "/images/coding-workshop.jpg"
organizer: "Tech Hub Dzaleka"
status: "upcoming"
featured: false
contact:
  email: "[email protected]"
  phone: "+265 999 123 456"
registration:
  required: true
  url: "https://forms.gle/xyz123"
  deadline: 2025-03-14T23:59:59Z
tags: ["coding", "education", "technology"]
---

Write Event Details

Add rich markdown content below the frontmatter:

## What You'll Learn

- HTML & CSS fundamentals
- Building your first webpage
- Introduction to JavaScript

## Who Should Attend

Beginners with no prior coding experience welcome!

## What to Bring

- Laptop (limited loaners available)
- Notebook and pen

Preview & Test

Start the dev server and navigate to your event:

npm run dev
# Visit: http://localhost:4321/events/coding-workshop-march-2025

Date Handling & Sorting

Upcoming vs Past Events

The platform automatically determines event status:

Event Status Logic

export const prerender = false;

const events = await getCollection('events');

// Function to determine if an event is upcoming
function isUpcoming(date: Date) {
  const today = new Date();
  today.setHours(0, 0, 0, 0);
  const eventDate = new Date(date);
  eventDate.setHours(0, 0, 0, 0);
  return eventDate >= today;
}

// Filter upcoming events
const upcomingEvents = events
  .filter(event => isUpcoming(event.data.date))
  .sort((a, b) => 
    new Date(a.data.date).getTime() - new Date(b.data.date).getTime()
  );

TBA Event Handling

Events marked as TBA are always sorted last:

TBA Sorting Logic

function isTBA(title: string) {
  return title.toLowerCase().includes('tba');
}

const sortedEvents = events.sort((a, b) => {
  // TBA events go to the end
  if (a.data.isTBA && !b.data.isTBA) return 1;
  if (!a.data.isTBA && b.data.isTBA) return -1;
  
  // Otherwise sort by date
  return new Date(a.data.date).getTime() - new Date(b.data.date).getTime();
});

Submit Event Flow

Users can submit events via /events/organize:

Form Submission: Fill out event details through web form
Image Upload: Provide event poster/photo (uploaded to cloud storage)
Email Notification: Admin receives submission details
Review: Admin verifies information and creates content file
Publication: Event appears on the platform
Promotion: Featured events highlighted on homepage

Technical Implementation

Dynamic Routes

Events use multiple dynamic routing patterns:

// src/pages/events/[...slug].astro
export async function getStaticPaths() {
  const events = await getCollection('events');
  return events.map(event => ({
    params: { slug: event.id },
    props: { event }
  }));
}

const { event } = Astro.props;
const { Content } = await render(event);

SEO & Rich Snippets

Events include comprehensive Schema.org markup for Google Calendar integration:

Event Structured Data

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "Miss Culture Dzaleka 2024",
  "description": "Annual cultural pageant celebrating diversity...",
  "startDate": "2024-06-29T10:00:00Z",
  "endDate": "2024-06-29T22:00:00Z",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
  "location": {
    "@type": "Place",
    "name": "Dzaleka Refugee Camp",
    "address": {
      "@type": "PostalAddress",
      "addressLocality": "Dzaleka",
      "addressRegion": "Central Region",
      "addressCountry": "MW"
    }
  },
  "organizer": {
    "@type": "Organization",
    "name": "Dzaleka Youth Organization",
    "url": "https://services.dzaleka.com"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://dzalekaculture.org/register",
    "price": "0",
    "priceCurrency": "MWK",
    "availability": "https://schema.org/InStock"
  }
}

Event Categories

Supported event types:

Cultural Event - Festivals, pageants, cultural celebrations
Workshop - Educational sessions, training programs
Webinar - Online presentations and discussions
Performance - Music, dance, theater shows
Community Meeting - Gatherings, town halls, forums
Sports - Tournaments, competitions, games
Fundraiser - Charity events, donation drives
Other - Miscellaneous community events

Best Practices

Use High-Quality Images

Recommended size: 1200x630px (16:9 aspect ratio) for optimal display across devices.

Clear Event Titles

Make titles descriptive and searchable. Include the main topic/activity.

Accurate Dates & Times

Always use ISO 8601 format with timezone (UTC): 2025-03-15T14:00:00Z

Detailed Descriptions

Include what attendees will learn/experience, who should attend, and what to bring.

Troubleshooting

Event not showing in upcoming list

Verify the date is in the future: date: 2025-XX-XXT00:00:00Z
Check that status is set to "upcoming" (not required but recommended)
Ensure the date format is valid ISO 8601
Rebuild the site: npm run build

Registration link not clickable

Ensure the registration section has proper YAML formatting:

registration:
  required: true
  url: "https://full-url-with-https.com"

The URL must be a complete, valid link.

Image not displaying

Images can be:

Relative paths: /images/event.jpg (stored in public/images/)
Absolute URLs: https://example.com/image.jpg

Verify the file exists and the path/URL is correct.

Services

Organizations that host events

Community Voices

Share event stories and recaps

Marketplace

Sell event tickets or merchandise

Get Started

Core Features

Cultural Heritage

Content Management

Overview

User Workflows

Discovering Events

Event Detail Page

Automatic Status

TBA Support

Rich Media

Schema Markup

Content Schema

Real Example from Source

How to Add an Event

Date Handling & Sorting

Upcoming vs Past Events

TBA Event Handling

Submit Event Flow

Technical Implementation

Dynamic Routes

SEO & Rich Snippets

Event Categories

Best Practices

Use High-Quality Images

Clear Event Titles

Accurate Dates & Times

Detailed Descriptions

Troubleshooting

Services

Community Voices

Marketplace

Build docs developers (and LLMs) love

Get Started

Core Features

Cultural Heritage

Content Management

​Overview

​User Workflows

​Discovering Events

​Event Detail Page

Automatic Status

TBA Support

Rich Media

Schema Markup

​Content Schema

​Real Example from Source

​How to Add an Event

​Date Handling & Sorting

​Upcoming vs Past Events

​TBA Event Handling

​Submit Event Flow

​Technical Implementation

​Dynamic Routes

​SEO & Rich Snippets

​Event Categories

​Best Practices

Use High-Quality Images

Clear Event Titles

Accurate Dates & Times

Detailed Descriptions

​Troubleshooting

​Related Features

Services

Community Voices

Marketplace

Build docs developers (and LLMs) love

Overview

User Workflows

Discovering Events

Event Detail Page

Content Schema

Real Example from Source

How to Add an Event

Date Handling & Sorting

Upcoming vs Past Events

TBA Event Handling

Submit Event Flow

Technical Implementation

Dynamic Routes

SEO & Rich Snippets

Event Categories

Best Practices

Troubleshooting

Related Features