Datalynx create

General comments

This page will show you how to create a simple datalynx activity. It is a step by step guide how to setup an activity for collecting and discussing photos in a course. This is the most basic setup for a datalynx activity. There are far more complex usages of the module like certification workflows, or course programme catalogues.

Activity goals of this example activity

Students should upload photos with a shallow depth of field using manual settings of their digital camera. By chosing the right combination of aperture and shutter speed, the object in the foreground should be completely sharp, whereas the background should be blurred. Teachers should rate the activity and comment on the photo quality.

In order to achieve that we need the following:

Views

• A view for creating an entry
• A view for seeing all entries with thumbnail images
• A detailed view with large images

Fields

A field of type Image. And user profile fields such as Username in order to identify who has made the entry

Other components

• Comments tag
• Notifications for comments and ratings

Step 1: Add a new datalynx instance to the course

1. Click on Add an activity or resource
   

   Add a datalynx instance
2. Fill out the settings
   1. Name: The name of the acivity
   2. Introduction: Contrary to other activities, the introduction is not used to be displayed within the activity. You can use it to display additional information on the course page by checking the box "Display description on course pageHelp with Display description on course page"
   3. Timing: For this activity not applicable, you can set availability options if you want that the activity can only be acces within a certain timeframe
   4. Rating: Define how to rate the activity: Points or stars, etc.
   5. Entry settings: If it is required, that student must make one entry and not more than one entry, you can set "Required entries" and "Maximum entries" to 1.
      • Required entries
      • Entries required before viewing
      • Maximum entries
3. Common module setings: Leave default values
4. Click on "Save and display"

Step 2: Define fields

After clicking on "Save and display", there are 2 possibilities to continue.

• Either you click directly on the page on "Add fields"
  

  Go to "Datalynx -> Manage -> Field"
• You can do the same by clicking on "Manage -> Fields -> Add field"

You are then in the manage area of the datalynx activity. In the field section (field tab), there is the possibility to choose a field from a dropdown menu.

Select the field of the type "Picture".

Add picture field

General settings

For the general settings, you can use these settings:

• Name: Give the name an understandable name, what kind of picture users should upload
• Description: Optional, not really used
• Visible to: This defines who can view the picture. In some cases other students should not see some fields, but in this case "Everyone" is the correct choice
• Editable: Yes
• Field label: The field label is a "conditional text", that only appears when a the field is present in a view. For mor information see the documentation of fields
• Display dimensions: Choose a size, that would fit in a screen. Example: 400px. Only define the width, if you want, that the height as scaled in the right proportoin.
• Max dimensions: Set this, if you want to limit the max dimension instead of a fixed dimension as on the previous setting
• Size of the thumbnail view.

Picture: General settings

Field attributes

• Total size of uploaded files: Define a file limit. You can tell users to optimize photos in order to fulfill the file size limit.
• Max number of uploaded files: Choose 1 in our case, but you can also tell users to upload to variations of one photo activity.

Picture: field attributes

Step 3: Define default view

After creating the field(s), it is time to create the views. Let us begin with the default view. The default view is shown after clicking on the Datalynx-link in the course. In our case, the default view will be the list of all entries of the students. We want to have an overview of all the added pictures, so that is the best choice for the default view. In order to create the view follow these steps.

1. Go to "Manage -> Views"
2. From the dropdown select "Grid view". Grid view is the standard view. Unless there is a special reason for using another view, grid view is the best choice.
3. View settings
   1. General view settings
      • Name: Choose a name for the view. For this example: Photos overview
      • Description: Leave empty
      • Visible to: Choose roles who can see the view
      • Filter: Leave empty. This will display max. 50 entries per page
   2. Redirect on submit option: This setting is only for editing views. Leave default value.
   3. View template: This setting defines the general layout of the view. Usually you have a header section with a paging bar, and a link to add a new entry. The header is followed by the repeated entries. In this case each student will add an entry with a photo. The tag ##entries## is a placeholder for the entries made by the users. The ##entries## tag will be replaced with the list of the photos.
   4. Grid settings: leave default. This will generate a list of photos with one column.
   5. 

      View setting: Entry template
      Entry template: This defines the layout of a single entry. All the fields and other information such as the the name of the user can be defined in this area. In our case we only need the name of the user, the photo and the link to the "detailled view". In the detailled view we will add the tags for commenting and rating each entry. In order to display the name of the user, we use the following tag: ##author:name##. This tag can be chosen from the dropdown menu "Field tags" and inserted instead of the marked text, or at the curser position. The tags ##edit## and ##delete## allow the users to edit their own entries. We select the tag ##more## from the dropdown "Field tags" as placeholder for the link to the detailled view.
   6. Save the view with clicking on "Save changes". You will be redirected to the overview of all views. Currently there is only one view: The one just created.

Manage -> Views

Click in the column "D" on the icon in order to make the view the Default view. Result should look like that:

Step 4: Define "New entry view"

1. Add another view by choosing "Grid view" from the dropdown "Add a view".
2. Save with default settings, except the name: Add new photo.
3. Save changes and choose the view as "Edit View": Activate the checkbox in the column "E"

Step 5: Define "More view"

This view will be the view, where the teacher can add comments and rate the entry. In order to create the view, instead of adding a new view, this time, you duplicate the "Add a photo" view and then edit this view by clicking on the "Edit" symbol.

1. Duplicate the view
2. Edit the view: Click on the edit symbol
3. Add the tags for commenting and rating using the appropriate choices in Entry template "Field tags"
4. The "Entry template" section of the "More view" should look similar to that: