The homefeed

Kate Santo Updated by Kate Santo

When a user opens a Padoq app, and depending on how the app is set up, they are often met with a homefeed. This feed is a collection of posts from all the padoqs the user is a member of.

Find out more about how the homefeed works in this guide.

See for yourself

  • You can download the iOS or Android app on your phone to follow this journey along. And you can also log in or sign up to the web app here
  • You can also follow along by checking out the images or code snippets in this guide
  • And you will find the relevant endpoints linked and explained in this guide, but the full API is documented in Swagger UI

The homefeed

The homefeed is a collection of posts from the padoqs that the user is a member of. So it's unique to the user and it's not linked to the padoq feed.

Posts in the homefeed are retrieved via the getHomeFeed endpoint. The app calls this endpoint and updates the homefeed every 30 minutes. By default, this endpoint will pull in posts from all padoqs using the effectiveTimestamp property: presenting the most recent posts first and going back from there.

This endpoint can take 3 optional parameters:

  • filter: this can take only one value, score. Posts can be scored based on the count of reactions (likeCount, dislikeCount and commentCount). So posts with greater engagement will take priority in the homefeed. If the filter parameter is not used, the homefeed will use the default effectiveTimestamp instead
  • search: some apps use this field, although it's not common. This allows the app to serve a homefeed that matches the value of this parameter. For example, a customer can create a homefeed that only shows posts containing the word "update" or "news" to serve a specific purpose. "update" or "news" would be the values for search
  • If-Modified-Since: this is another way to filter posts. If there is a date specified here, the homefeed will only present posts from padoqs that were modified on or after that date

In any case, the posts that come up in the homefeed are always basic posts, and they always carry the display properties from the original post. For example, if a post was created in a padoq with no header, and not allowing comments or reactions, that post will keep those properties in the homefeed too. Find out more about posts overall in our guide: Post types.

Here's how a post in the homefeed might look like. Note properties that are crucial for the homefeed such as effectiveTimestamp, display and score:

{
"posts":[
{
"id":"a04cca1d-8c88-11eb-9c76-7427ea56e821",
"title":"",
"text":"Body of the post",
"type":"BASIC",
"posted":"2021-03-24T10:06:39.775Z",
"effectiveTimestamp":"2021-03-24T10:06:39.775Z",
"modifiedTimestamp":"2021-03-24T10:06:39.775Z",
"uri":"https://app.dev.padoq.com/resrc/padoq/The-Padoq-Name/post/a04cca1d-8c88-11eb-9c76-7427ea56e821/version/1",
"authorId":"75ccc221-a065-47af-b99a-a1a61142d665",
"authorDisplayName":"Jane Adisa",
"recipientIds":null,
"recipientRoles":null,
"status":"OPEN",
"canLike":true,
"canDislike":true,
"canComment":true,
"likeCount":0,
"isAdmin":false,
"dislikeCount":0,
"isNew":true,
"commentCount":0,
"version":1,
"structuredContent":{},
"mentions":[],
"tags":[],
"metadata":{},
"display":{
"hideDisplayHeader":false,
"hideDisplayFooter":false,
"summarise":true,
"allowDetails":true
},
"attachments":[],
"score":100,
"padoqName":"The-Padoq-Name"
},

How did we do?

Explore

Padoq feed and menus

Contact