Review the event template and review how the discussion screen works because these instructions reference the code used there. 

Precursor: the app must have a login (see this article), the app must have a form to manage the content (see this article)

Discussion lists provide a place for users to interact with each other and share their opinions.

Features

A discussion list offers the following features:

  1. Users can produce content and add it to the discussion.
  2. Users can like, bookmark, and comment on content.
  3. Users can edit their own content.

Get Started

To create a news feed or discussion list you will need to:

  1. Create a screen with the list from data source component.
  2. Link it to a data source.
  3. Turn on all the social features.
  4. Turn on the edit entry features.
  5. Test the discussion list in preview mode.

 

Step 1 – Create a screen with the list from data source component

  1. Click on the blue “Add screens” button in the bottom left corner.
  2. Select the “Lists” option from the list of options at the top of the page.
  3. Click on the “List – news feed” template or the “List – discussion forum” template. You can select either of these two layouts.
  4. Click the blue “Add 1 new screen” button.
  5. Name it “Discussion” or “News feed”  and click “Add screen”.

 

Step 2 – Link it to a data source

  1. Open the component settings and click the button to “Create list data” or “Use Existing data”.
  2. For this example, “Create list data” and open the data source. Click on the “Add new field” button at the bottom if you wish to add more fields to the data.
  3. The data source comes with sample data. Required: Click on the “Add new field”  button and add a field called “Email”.
  4. Add or remove columns depending on what data you want to include in the list. 
  5. If you add/remove data, you need to update the data view settings. For more information about data view settings, read this article

 

Step 3 – Turn on all the social features

  1.  Go back to the settings.
  2. Scroll down until you see the “Social features” dropdown.
  3. Select “likes”, “bookmarks” and comments.
  4. For commenting, the app needs to have a login so the app can recognise which user posts the comment.
  5. If you selected “comments”, you need to identify which data source you are storing all of the users information. (For example, choose the “Registration” data source.)
  6. Under “Username data fields” type in the field which holds the user’s name.  If you have two fields for the user’s name that are represented in two separate columns for first and last names, type in both names.
  7. Under “User email data field” select the field which holds the users email address in the login data source.

  8. Under “User email data field”, select which field you would like the user’s photo to appear in, or if you do not want to use photos, choose “Don’t show user photos from the dropdown.

 

Step 4 – Turn on the edit entry features

  1.  In the settings, Click on the “Entry management” dropdown. 
  2. Select the “Add list items” option. 
  3. If you chose the discussion template earlier, select “Everyone can add”. For a news feed, select “Everyone can add” or “Only admins can add” if you wish to restrict it to admins.
  4. Select the screen where the user can manage the content. To learn how to set up a screen to manage content read this article.
  5. Select “Edit list items”
  6. Select “Users can edit their own list items” so that only the user can edit their own work.  Select the “Email” field from the “Select a data field” options. 
  7. Select the screen where the user can manage the content again.
  8. Select “Delete list items”.
  9. Select “Users can delete their own list items”.
  10. Select the “Email” field from the “Select a data field” options.
  11. Click “Save and Close” 

 

Step 5 – Test the discussion list in preview mode

  1.  Go to “Preview” mode.
  2. Click on one of the list items and try to like, bookmark, and comment. You will need to be logged in to comment. The test was successful if you were able to do all three when logged in. 
  3. Test to submit a new discussion by clicking the + and confirm you are taken to the correct screen.
  4. Test the edit functionality. If users should only be able to edit their own items, test that only those items are editable.
  5. Test the delete functionality.