# Partners, Gallery & Supporter Voices

## Partners, Gallery & Supporter Voices

**Files:** `src/content/pages/<language>/partners.md`, `src/content/gallery/<language>/-index.md`, `src/content/reviews/<language>/` · **Skill level:** Beginner

Three pages that show who stands behind your work: companies and foundations on `/partners/`, photos from your programs on `/gallery/`, and quotes from donors, volunteers, partners, and the people you serve on `/testimonials/`.

<Aside type="caution" title="Real names only, with permission">
  The partner names, logos, sponsorship amounts, case study, and quotes in the
  theme are samples. Replace them with real ones, used with each person's or
  company's permission, or remove them.
</Aside>

### The Partners Page
`/partners/` is for companies and foundations who want to support you. Its own blocks are under `partnersPage` in `src/content/pages/<language>/partners.md`:

| Block | What it shows |
| --- | --- |
| `ways` | Ways to partner (sponsorship, matched giving, gifts in kind, cause-related campaigns), each with what the partner receives |
| `levels` | A table of sponsorship levels with an amount each, and a note |
| `caseStudy` | One partnership told in a few lines, with a photo, a small table, and a partner's quote (`review`: a file name in `src/content/reviews/<language>/`) |
| `partners` | A list of partner names |
| `contact` | "Talk to our partnerships team", with a button to `/contact/?topic=partnerships#write-to-us` and your email from `[organization]` (`showEmail: true`) |

The `levels` amounts are text you type (`"$2,500"`), so write them with your currency. Remove any way to partner you don't offer.

### Partner Logos
The row of partner names at the bottom of the homepage and `/home-appeal/` is the partners section, `src/content/sections/<language>/clients.md`:

```yaml
title: "Partners"
list:
  - alt: "Northfield Trust logo" # sample
    icon: "Mountain" # Lucide icon name
    name: "Northfield Trust"
options:
  layout: "plain"
  link:
    enable: true
    label: "Partner with us"
    url: "/partners/"
```

Each sample partner is drawn as an icon beside a name. For a real logo, add `src: "/images/partners/your-logo.svg"` to the item and put the file in `src/assets/images/partners/`: the logo shows in grayscale instead of the icon and name. A page changes the list with a `clientsSection:` block.

### The Gallery Page
`/gallery/` shows your photos in a grid with category filters. Everything is in `src/content/gallery/<language>/-index.md`:

```yaml
filterLabel: "Filter photos by program"
allLabel: "All photos"
credit: "sample credit" # default photographer for every photo
categories:
  - id: "education"
    label: "Education"
  - id: "water"
    label: "Clean water"
items:
  - image: "/images/photos/gallery-produce-crates.jpg"
    alt: "Crates of peppers and lemons sorted for the food bank"
    category: "food"
    place: "Market street hall"
    caption: "Sorting donated produce for the food bank"
    # credit: "Name" # replaces the default credit for this photo
```

- Each photo's caption line reads "place · caption · Photo: credit". Set `credit` once at the top, and per photo where it differs.
- Every `category` of a photo must be an `id` in `categories`. `/gallery/?category=water` opens one category.
- `alt` describes what is in the photo, for screen readers. It is not the caption.
- Put your photos in `src/assets/images/` and write their path from `/images/`. See [Icons & Images](/givo/customization/icons-images/).
- Without JavaScript, every photo shows and the filters are plain links.

The first six photos also fill the gallery strip on `/home-community/` (the gallery section, `gallery-section.md`, with `limit` and an optional `category`).

### The Lightbox
Selecting a photo on `/gallery/` or in a cause's photos opens it full size in a viewer:

- The large photo with its caption and a counter such as "3 of 12".
- Previous and next buttons, the arrow keys, or a swipe on phones move between photos. Only the photos the filter shows are counted.
- **Esc** or the close button closes it, and focus returns to the photo you opened.
- With reduced motion, the viewer opens without its fade.

There is nothing to set up. The viewer's labels ("Photo viewer", "Close", "Previous photo", "Next photo", `{index} of {total}`) are under `lightbox` in `src/i18n/<language>.json`. Without JavaScript, each photo is a link to the large file.

### Supporter Voices
Quotes live in `src/content/reviews/<language>/`, one file each:

```yaml
---
name: "Sam K." # sample: first name and last initial
role: "volunteer" # donor | volunteer | partner | beneficiary
text: "I came for one Tuesday evening shift and stayed for three years."
cause: "community-kitchen" # cause id in src/content/causes/
date: 2026-08-02
featured: true
# image: "" # optional portrait; no photo shows the name only
draft: false
---
```

- `role` sets the label and the filter group on `/testimonials/`.
- `cause` links the quote to a cause, so a section can show only the quotes about that cause.
- `featured: true` puts the quote in the featured band at the top of `/testimonials/`.
- Without an `image`, the quote shows the name only. No placeholder face is drawn.
- Publish only real quotes from people who agreed, and keep names short (first name and last initial) if they prefer.

The quotes appear through the reviews section (`reviews-section.md`), with four layouts: `story` (one quote beside a large photo, the homepage), `default` (a grid of quotes, `/home-community/`), `wall` (featured band, role filters, and every quote, `/testimonials/`), and `overlay` (`/home-appeal/`). Its `filter` chooses which quotes a page shows:

```yaml
filter:
  role: "" # donor | volunteer | partner | beneficiary; empty = every role
  cause: "" # cause id; empty = every cause
```

`/testimonials/` also opens with a longer quote beside a photo and a short film (`videoSection` in `src/content/pages/<language>/testimonials.md`). The film is a placeholder YouTube video, not a story: set `video.src` in `src/content/sections/<language>/video-section.md` (or in the page block) to your own YouTube or Vimeo id or a file in `public/videos/`, or set `enable: false`.

### Do It With AI
```text
Replace the sample partners with my real partners: [NAME, LOGO FILE if any]. Edit list in
src/content/sections/<language>/clients.md and partnersPage.partners.names in
src/content/pages/<language>/partners.md, in every language. For each logo file I put in
src/assets/images/partners/, add src: "/images/partners/<file>". Remove every sample name.
```

```text
Add these photos to my gallery: [FILE: what it shows, place, category]. Add one item each to
src/content/gallery/<language>/-index.md in every language, with a short alt text and caption in
that language, and remove the sample photos I list: [FILES].
```