Project Listing Code Generator

ID:

Generated Code



Project Listing Overview

{% include projectListing/\[imageGrid|summary|summaryAndValueOutcomes|learnMore\]
\[projectIds='###,###,...'|campaignId='###'|themeIds='...'|countryIds='...'\]
\[random='true'|fixedOrder='true'\]
\[limit='##''\]
\[align='left'|'center'|'right'\]
\[rewardsLevels='superstar,leader,partner,nominal,emerging'\]
%}

Required Parameters

  • Template: You must specify a template/style for the projectListing
  • IDs: You can include either a list of projectIds, a single campaignId, a list of themeIds, or a list of countryIds
    • Valid Theme Ids: For example, Mental Health and Physical Health would be mentalhealth,health.
      Look up more here:

    • Valid Country Ids: For example, North America would be canada,unista,mexico. Look up more here:

Optional Parameters

  • Random, Fixed Order: You can select to random sort the listings, or to display the projects in the fixedOrder the IDs were typed. fixedOrder will win if you set both to true. If you do not select random or fixedOrder, projects will be sorted according to their project ranking. Project ranking changes at least daily. Random is updated once per day as of 2021, unless tech is asked to refresh it more regularly for a specific page.
  • Limit: You can limit the total projects displayed. Helpful if you are showing a campaign and only want to show 5 projects at a time. Pairs well with random=true.
  • Align: You can align the projects using left, center, or right. If you do not specify a value, the default behavior is to left align summary listings, but center align image grids.
  • Rewards Levels: You can filter by rewardsLevel. Provide a comma delimited list of the rewards levels that you want to show. It will automatically update the listing. Your list could contain a single level (e.g. rewardsLevels='superstar'), or it could contain several levels to include (e.g. rewardsLevels='superstar,leader'). Pairs well with random and limit.

Computer Science Lesson 102: Documentation

  • This shows you all of the parameters you can set when including projects.
  • Note that you don’t type the bracket characters [ ] in the CMS
  • The things in the [ ] show the different parameters. The | shows you different options available for each parameter. For example, random and fixedOrder are both options, but you should only do one or the other.
  • When entering multiple project IDs as a comma separated list, do not include spaces.
WARNING: Javascript is currently disabled or is not available in your browser. GlobalGiving makes extensive use of Javascript and will not function properly with Javascript disabled. Please enable Javascript and refresh this page.