gift card reading 'Spread Joy' Looking for holiday gifts? Give the gift of giving with a GlobalGiving gift card! Shop Gift Cards

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: animals,art,children,climate,democ,disaster,ecdev,edu,env,finance,gender,health,human,hunger,lgbtq,rights,sport,tech
    • Valid Country Ids: For example, North America would be canada,unista,mexico. Look up more here:

Optional Parameters

  • Random, FixedOrder: 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. This is updated at least daily.
  • Limit: You can limit the total projects displayed. Helpful if you are showing a campaign and only want to show 5 projects. 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.
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.