Documentation

# Child List Configuration

This document describes the logic behind the child sponsorship list display (opens new window).

# Child List

The default child sponsorship list (opens new window) consists of 3 featured children and 6 children for a total list of 12 children. The lifeline sponsorship list (opens new window) consist of 3 featured children and 12 children. Originally, the list displayed only non-featured children, featured children were added on, the original list of 12 was not reduced.

# Default Page (opens new window)

As of January 2023, the featured children no longer appear on the landing pages. The featured children will still display when the search returns no result. All featured list criteria was updated to pull children on the lifeline sponsorship group.

The featured children on the default page are defined by the following logic:

  1. A child that is in ICS sponsorship group and has waited the longest
    a. If the above filter doesn't return results, a random child
  2. If a featured country* is defined, a male child that's in the featured country and in ICS sponsorship group, or render a male child if the previous criteria fails
    a. If the above filter doesn't return results, a female child that's in the featured country in ICS sponsorship group, or just a female child if the previous criteria fails
    b. If the featured country is not defined, a male child
  3. A female child from a lifeline sponsorship group
    a. If the above filter doesn't return results, a male child from lifeline sponsorship group
    b. If the above filters don't return results, a child from the USA
    c. If the above filters don't return results, a random child

# Lifeline Page (opens new window)

The featured children on the lifeline page are defined by the following logic:

  1. A female child in a lifeline sponsorship group
  2. A male child in a lifeline sponsorship group
  3. A child from the USA in a lifeline sponsorship group a. If the above filter doesn't return results, a random child in a lifeline sponsorship group

# The United States Page (opens new window)

The featured children do not appear on the US sponsorship page.

*A featured country is defined with JavaScript code in the PageBuilder page api__sponsorship__child_icons which is rendered on the page. The country name must exactly match the name present in the filter dropdown menu.

# Leading Child

January 2023 redesign removed the banner & in it's place, placed a child. A child is selected at random from the list of children, that are defined and display per matrix below. On page reload a new random child will be displayed. The leading child is also displayed in the list of children, per requirements.

# Children

The children that are not featured are rendered with the following criteria per row:

  1. male, female, female
  2. female, male, male
  3. male, male, female
  4. female, female, male
  5. female, male, female
  6. male, male, female
  7. female, female, male
  8. female, male, male
  9. male, male, female
  10. female, female, male

If the user displays more than 10 additional rows, the following values will be set in random order. The list is generally limited, so only 1 such row should appear in a list.

If the marketing moment* is defined, the first entry will be replaced by a female child, so the new row logic will be as follows:

  1. female, female, female

*The marketing moment is defined by a JSON object in a script with id tpl-featured-children-marketing-moment in the PageBuilder page reus_content_catalog. If one or two properties are set to true, then we have a marketing moment.

# Filtering

When a child list is filtered, one of the options is selected & the form is submitted, the featured children are not rendered, but the list of children is still rendered. When the filter or search is executed, the filtering criteria no longer applies. The order in which the children display is the order by which ODS API returns the children.

← Child profile →