Expertiza_Wiki - User contributions [en]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-05-03T00:14:04Z

Aravich6: /* References */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

#Allowing Instructor to create new badges - which involves adding name and badge image and letting the instructor add them to the assignment
#Students must be able to suggest "Good Teammate" badges during the teammate review periods.
#Students must be able to suggest "Good Reviewer" badges, for reviews received.
#Create a pipeline to enable instructor to manually approve badges suggested by students

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Design Description =
The following steps briefly describe the implementation steps taken during the course of this project. Two major flows exist in this project , one being new badge creation and associating them with the assignment. Second one is modifying the flow for good teammate and reviewer badges to be present in appropriate question section.

== Usecase Diagram ==

[[File:Usecase.jpg|center]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

To add a new badge which is a new functionality, we display a button, at the end of the badges tab, which redirects the user to a page enabling him to create a New badge. The new form fields include ''Badge Name'', ''Image'' and ''Description''. Upon saving the user is again redirected back to the earlier assignments display display.

[[File:New Badge.png|center]]

== Adding Badges to Assignments ==

We change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. The view is changed to display all the available badges and a check box to select each of them. It was initially present as a badge vs threshold display. Once the user clicks save, entries are modified in the data base.
[[File:Badges list.png|center]]

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of this badges is done automatically based on a threshold, which is set during assignment creation. The score is calculated based on answers to questions on the review page.

In this implementation, the earlier flow was changed to allow participant to be able to suggest these badges to their fellow students. To enable this process, a new question in the format of a checkbox, was added into the teammate review questionnaire. This question appears after the Additional Comments section.

Upon selection of this check box an entry is made into the assigned badges table with the participant id and approval status being 0, implying that it is pending with the instructor, for approval before displaying.

[[File:Team_mate_review_new.png|center|]]

== Assignment of "Good Reviewer" badges by student ==

Similar to Good Teammate badge, in the existing workflow, good reviewer was also assigned based on score and threshold. This is modified in our implementation, in a similar way as that of teammate badge. We add a "Good Reviewer check box" as a question in the feedback of the reviews given page. An entry is made to the awarded badges table with the approval status as 0. Once this field is changed to 1, it would display badges in the assignment row .

[[File:Reviewer-badge.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. A db migrate was run to include this column.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:Awarded Badges.png|center]]

=Implementation Details=
== Files modified ==

=== Models ===
* expertiza/app/models/assignment_badge.rb - create badges without threshold method was added
* expertiza/app/models/assignment_form.rb - update assigned badges method was added. this method modifies the db entries for assignment_badges table based on the checkbox entries
* expertiza/app/models/awarded_badge.rb - suggest badge method was added, which is called when badge is suggested by student by checking the checkbox in questioner.
* expertiza/app/models/badge.rb - functionality to get image name from name was added

=== Controllers ===
* expertiza/app/controllers/assignments_controller.rb - Modifications were done to include the functionality of displaying all badges in the badges tab and check box based selection process
* expertiza/app/controllers/badges_controller.rb - This was a new file added in this implementation . Code on handling new badge creation, in create method was added.
* expertiza/app/controllers/response_controller.rb - Modification to process question responses from checkbox about badges were added to this file

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb - Modification to display all available badges to badges tab as checkbox was done. Also a link to creating a new badge is provided
* expertiza/app/views/badges/new.html.erb - New file to create a new badge was added to this file
* expertiza/app/views/badges/_form.html.erb - New file to create a form for badge was added to this file
* expetiza/app/views/response/response.html.erb - Modification to display checkbox questions in review questioner was added to this file

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== Routes===
* Routes for badges was added

= Test Plan =
New rspec file was added in spec/models/badge_spec.rb. Test cases were written to validate the different conditions of creating a new badge. Here are the test cases:

1. it is valid when it has a name, description and image name

2. it is invalid when it does not have a name

3. it is invalid when it does not have a description

4. it is invalid when it does not have an image name

= Future Work =
#The approval workflow is currently missing - when a student assigns a badge to a peer, the approval status is set to 0 and it will never appear in the other student’s homepage. Workflow to change the status by the instructor must be implemented.
#There is currently no way for a newly created badge to be assigned to a student through the UI, even if it has been added to an assignment. This needs to be implemented.
#Instructors cannot directly assign “Good Reviewer” badge through the UI. A separate flow to enable instructors to do that would be useful

= References=

#[https://github.com/expertiza/expertiza/pull/1176 Pull Request for present implementation]
#[https://youtu.be/GZrZTBlH7GQ Link to Screen-cast of our implementation]
#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-05-03T00:13:42Z

Aravich6: /* Test Plan */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

#Allowing Instructor to create new badges - which involves adding name and badge image and letting the instructor add them to the assignment
#Students must be able to suggest "Good Teammate" badges during the teammate review periods.
#Students must be able to suggest "Good Reviewer" badges, for reviews received.
#Create a pipeline to enable instructor to manually approve badges suggested by students

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Design Description =
The following steps briefly describe the implementation steps taken during the course of this project. Two major flows exist in this project , one being new badge creation and associating them with the assignment. Second one is modifying the flow for good teammate and reviewer badges to be present in appropriate question section.

== Usecase Diagram ==

[[File:Usecase.jpg|center]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

To add a new badge which is a new functionality, we display a button, at the end of the badges tab, which redirects the user to a page enabling him to create a New badge. The new form fields include ''Badge Name'', ''Image'' and ''Description''. Upon saving the user is again redirected back to the earlier assignments display display.

[[File:New Badge.png|center]]

== Adding Badges to Assignments ==

We change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. The view is changed to display all the available badges and a check box to select each of them. It was initially present as a badge vs threshold display. Once the user clicks save, entries are modified in the data base.
[[File:Badges list.png|center]]

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of this badges is done automatically based on a threshold, which is set during assignment creation. The score is calculated based on answers to questions on the review page.

In this implementation, the earlier flow was changed to allow participant to be able to suggest these badges to their fellow students. To enable this process, a new question in the format of a checkbox, was added into the teammate review questionnaire. This question appears after the Additional Comments section.

Upon selection of this check box an entry is made into the assigned badges table with the participant id and approval status being 0, implying that it is pending with the instructor, for approval before displaying.

[[File:Team_mate_review_new.png|center|]]

== Assignment of "Good Reviewer" badges by student ==

Similar to Good Teammate badge, in the existing workflow, good reviewer was also assigned based on score and threshold. This is modified in our implementation, in a similar way as that of teammate badge. We add a "Good Reviewer check box" as a question in the feedback of the reviews given page. An entry is made to the awarded badges table with the approval status as 0. Once this field is changed to 1, it would display badges in the assignment row .

[[File:Reviewer-badge.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. A db migrate was run to include this column.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:Awarded Badges.png|center]]

=Implementation Details=
== Files modified ==

=== Models ===
* expertiza/app/models/assignment_badge.rb - create badges without threshold method was added
* expertiza/app/models/assignment_form.rb - update assigned badges method was added. this method modifies the db entries for assignment_badges table based on the checkbox entries
* expertiza/app/models/awarded_badge.rb - suggest badge method was added, which is called when badge is suggested by student by checking the checkbox in questioner.
* expertiza/app/models/badge.rb - functionality to get image name from name was added

=== Controllers ===
* expertiza/app/controllers/assignments_controller.rb - Modifications were done to include the functionality of displaying all badges in the badges tab and check box based selection process
* expertiza/app/controllers/badges_controller.rb - This was a new file added in this implementation . Code on handling new badge creation, in create method was added.
* expertiza/app/controllers/response_controller.rb - Modification to process question responses from checkbox about badges were added to this file

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb - Modification to display all available badges to badges tab as checkbox was done. Also a link to creating a new badge is provided
* expertiza/app/views/badges/new.html.erb - New file to create a new badge was added to this file
* expertiza/app/views/badges/_form.html.erb - New file to create a form for badge was added to this file
* expetiza/app/views/response/response.html.erb - Modification to display checkbox questions in review questioner was added to this file

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== Routes===
* Routes for badges was added

= Test Plan =
New rspec file was added in spec/models/badge_spec.rb. Test cases were written to validate the different conditions of creating a new badge. Here are the test cases:

1. it is valid when it has a name, description and image name

2. it is invalid when it does not have a name

3. it is invalid when it does not have a description

4. it is invalid when it does not have an image name

= Future Work =
#The approval workflow is currently missing - when a student assigns a badge to a peer, the approval status is set to 0 and it will never appear in the other student’s homepage. Workflow to change the status by the instructor must be implemented.
#There is currently no way for a newly created badge to be assigned to a student through the UI, even if it has been added to an assignment. This needs to be implemented.
#Instructors cannot directly assign “Good Reviewer” badge through the UI. A separate flow to enable instructors to do that would be useful

= References=

#[https://github.com/expertiza/expertiza/pull/1176 Pull Request for present implementation]
#[https://youtu.be/GZrZTBlH7GQ Link to Screen-cast of out implementation]
#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-29T19:44:23Z

Aravich6: /* Test Plan */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

#Allowing Instructor to create new badges - which involves adding name and badge image and letting the instructor add them to the assignment
#Students must be able to suggest "Good Teammate" badges during the teammate review periods.
#Students must be able to suggest "Good Reviewer" badges, for reviews received.
#Create a pipeline to enable instructor to manually approve badges suggested by students

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Design Description =
The following steps briefly describe the implementation steps taken during the course of this project. Two major flows exist in this project , one being new badge creation and associating them with the assignment. Second one is modifying the flow for good teammate and reviewer badges to be present in appropriate question section.

== Usecase Diagram ==

[[File:Usecase.jpg|center]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

To add a new badge which is a new functionality, we display a button, at the end of the badges tab, which redirects the user to a page enabling him to create a New badge. The new form fields include ''Badge Name'', ''Image'' and ''Description''. Upon saving the user is again redirected back to the earlier assignments display display.

[[File:New Badge.png|center]]

== Adding Badges to Assignments ==

We change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. The view is changed to display all the available badges and a check box to select each of them. It was initially present as a badge vs threshold display. Once the user clicks save, entries are modified in the data base.
[[File:Badges list.png|center]]

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of this badges is done automatically based on a threshold, which is set during assignment creation. The score is calculated based on answers to questions on the review page.

In this implementation, the earlier flow was changed to allow participant to be able to suggest these badges to their fellow students. To enable this process, a new question in the format of a checkbox, was added into the teammate review questionnaire. This question appears after the Additional Comments section.

Upon selection of this check box an entry is made into the assigned badges table with the participant id and approval status being 0, implying that it is pending with the instructor, for approval before displaying.

[[File:Team_mate_review_new.png|center|]]

== Assignment of "Good Reviewer" badges by student ==

Similar to Good Teammate badge, in the existing workflow, good reviewer was also assigned based on score and threshold. This is modified in our implementation, in a similar way as that of teammate badge. We add a "Good Reviewer check box" as a question in the feedback of the reviews given page. An entry is made to the awarded badges table with the approval status as 0. Once this field is changed to 1, it would display badges in the assignment row .

[[File:Reviewer-badge.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. A db migrate was run to include this column.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:Awarded Badges.png|center]]

=Implementation Details=
== Files modified ==

=== Models ===
* expertiza/app/models/assignment_badge.rb - create badges without threshold method was added
* expertiza/app/models/assignment_form.rb - update assigned badges method was added. this method modifies the db entries for assignment_badges table based on the checkbox entries
* expertiza/app/models/awarded_badge.rb - suggest badge method was added, which is called when badge is suggested by student by checking the checkbox in questioner.
* expertiza/app/models/badge.rb - functionality to get image name from name was added

=== Controllers ===
* expertiza/app/controllers/assignments_controller.rb - Modifications were done to include the functionality of displaying all badges in the badges tab and check box based selection process
* expertiza/app/controllers/badges_controller.rb - This was a new file added in this implementation . Code on handling new badge creation, in create method was added.
* expertiza/app/controllers/response_controller.rb - Modification to process question responses from checkbox about badges were added to this file

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb - Modification to display all available badges to badges tab as checkbox was done. Also a link to creating a new badge is provided
* expertiza/app/views/badges/new.html.erb - New file to create a new badge was added to this file
* expertiza/app/views/badges/_form.html.erb - New file to create a form for badge was added to this file
* expetiza/app/views/response/response.html.erb - Modification to display checkbox questions in review questioner was added to this file

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== Routes===
* Routes for badges was added

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Check that all badge names are rendered in the "Badges" tab.

5. Check that an approved badge is rendered on student's assignments page if it is approved.

6. Check that a student cannot see a badge on assignments page if it is not approved.

= Future Work =
#The approval workflow is currently missing - when a student assigns a badge to a peer, the approval status is set to 0 and it will never appear in the other student’s homepage. Workflow to change the status by the instructor must be implemented.
#There is currently no way for a newly created badge to be assigned to a student through the UI, even if it has been added to an assignment. This needs to be implemented.
#Instructors cannot directly assign “Good Reviewer” badge through the UI. A separate flow to enable instructors to do that would be useful

= References=

#[https://github.com/expertiza/expertiza/pull/1176 Pull Request for present implementation]
#[https://youtu.be/GZrZTBlH7GQ Link to Screen-cast of out implementation]
#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-29T02:58:16Z

Aravich6: /* References */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

#Allowing Instructor to create new badges - which involves adding name and badge image and letting the instructor add them to the assignment
#Students must be able to suggest "Good Teammate" badges during the teammate review periods.
#Students must be able to suggest "Good Reviewer" badges, for reviews received.
#Create a pipeline to enable instructor to manually approve badges suggested by students

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Design Description =
The following steps briefly describe the implementation steps taken during the course of this project. Two major flows exist in this project , one being new badge creation and associating them with the assignment. Second one is modifying the flow for good teammate and reviewer badges to be present in appropriate question section.

== Usecase Diagram ==

[[File:Usecase.jpg|center]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

To add a new badge which is a new functionality, we display a button, at the end of the badges tab, which redirects the user to a page enabling him to create a New badge. The new form fields include ''Badge Name'', ''Image'' and ''Description''. Upon saving the user is again redirected back to the earlier assignments display display.

[[File:New Badge.png|center]]

== Adding Badges to Assignments ==

We change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. The view is changed to display all the available badges and a check box to select each of them. It was initially present as a badge vs threshold display. Once the user clicks save, entries are modified in the data base.
[[File:Badges list.png|center]]

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of this badges is done automatically based on a threshold, which is set during assignment creation. The score is calculated based on answers to questions on the review page.

In this implementation, the earlier flow was changed to allow participant to be able to suggest these badges to their fellow students. To enable this process, a new question in the format of a checkbox, was added into the teammate review questionnaire. This question appears after the Additional Comments section.

Upon selection of this check box an entry is made into the assigned badges table with the participant id and approval status being 0, implying that it is pending with the instructor, for approval before displaying.

[[File:Team_mate_review_new.png|center|]]

== Assignment of "Good Reviewer" badges by student ==

Similar to Good Teammate badge, in the existing workflow, good reviewer was also assigned based on score and threshold. This is modified in our implementation, in a similar way as that of teammate badge. We add a "Good Reviewer check box" as a question in the feedback of the reviews given page. An entry is made to the awarded badges table with the approval status as 0. Once this field is changed to 1, it would display badges in the assignment row .

[[File:Reviewer-badge.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. A db migrate was run to include this column.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:Awarded Badges.png|center]]

=Implementation Details=
== Files modified ==

=== Models ===
* expertiza/app/models/assignment_badge.rb - create badges without threshold method was added
* expertiza/app/models/assignment_form.rb - update assigned badges method was added. this method modifies the db entries for assignment_badges table based on the checkbox entries
* expertiza/app/models/awarded_badge.rb - suggest badge method was added, which is called when badge is suggested by student by checking the checkbox in questioner.
* expertiza/app/models/badge.rb - functionality to get image name from name was added

=== Controllers ===
* expertiza/app/controllers/assignments_controller.rb - Modifications were done to include the functionality of displaying all badges in the badges tab and check box based selection process
* expertiza/app/controllers/badges_controller.rb - This was a new file added in this implementation . Code on handling new badge creation, in create method was added.
* expertiza/app/controllers/response_controller.rb - Modification to process question responses from checkbox about badges were added to this file

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb - Modification to display all available badges to badges tab as checkbox was done. Also a link to creating a new badge is provided
* expertiza/app/views/badges/new.html.erb - New file to create a new badge was added to this file
* expertiza/app/views/badges/_form.html.erb - New file to create a form for badge was added to this file
* expetiza/app/views/response/response.html.erb - Modification to display checkbox questions in review questioner was added to this file

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== Routes===
* Routes for badges was added

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= Future Work =
#The approval workflow is currently missing - when a student assigns a badge to a peer, the approval status is set to 0 and it will never appear in the other student’s homepage. Workflow to change the status by the instructor must be implemented.
#There is currently no way for a newly created badge to be assigned to a student through the UI, even if it has been added to an assignment. This needs to be implemented.
#Instructors cannot directly assign “Good Reviewer” badge through the UI. A separate flow to enable instructors to do that would be useful

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[https://github.com/expertiza/expertiza/pull/1176 Pull Request for present implementation]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]
#[https://youtu.be/GZrZTBlH7GQ Link to Screencast]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-29T01:38:39Z

Aravich6: /* Future Work */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

#Allowing Instructor to create new badges - which involves adding name and badge image and letting the instructor add them to the assignment
#Students must be able to suggest "Good Teammate" badges during the teammate review periods.
#Students must be able to suggest "Good Reviewer" badges, for reviews received.
#Create a pipeline to enable instructor to manually approve badges suggested by students

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Design Description =
The following steps briefly describe the implementation steps taken during the course of this project. Two major flows exist in this project , one being new badge creation and associating them with the assignment. Second one is modifying the flow for good teammate and reviewer badges to be present in appropriate question section.

== Usecase Diagram ==

[[File:Usecase.jpg|center]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

To add a new badge which is a new functionality, we display a button, at the end of the badges tab, which redirects the user to a page enabling him to create a New badge. The new form fields include ''Badge Name'', ''Image'' and ''Description''. Upon saving the user is again redirected back to the earlier assignments display display.

[[File:New Badge.png|center]]

== Adding Badges to Assignments ==

We change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. The view is changed to display all the available badges and a check box to select each of them. It was initially present as a badge vs threshold display. Once the user clicks save, entries are modified in the data base.
[[File:Badges list.png|center]]

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of this badges is done automatically based on a threshold, which is set during assignment creation. The score is calculated based on answers to questions on the review page.

In this implementation, the earlier flow was changed to allow participant to be able to suggest these badges to their fellow students. To enable this process, a new question in the format of a checkbox, was added into the teammate review questionnaire. This question appears after the Additional Comments section.

Upon selection of this check box an entry is made into the assigned badges table with the participant id and approval status being 0, implying that it is pending with the instructor, for approval before displaying.

[[File:Team_mate_review_new.png|center|]]

== Assignment of "Good Reviewer" badges by student ==

Similar to Good Teammate badge, in the existing workflow, good reviewer was also assigned based on score and threshold. This is modified in our implementation, in a similar way as that of teammate badge. We add a "Good Reviewer check box" as a question in the feedback of the reviews given page. An entry is made to the awarded badges table with the approval status as 0. Once this field is changed to 1, it would display badges in the assignment row .

[[File:Reviewer-badge.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. A db migrate was run to include this column.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

=Implementation Details=
== Files modified ==

=== Models ===
* expertiza/app/models/assignment_badge.rb - create badges without threshold method was added
* expertiza/app/models/assignment_form.rb - update assigned badges method was added. this method modifies the db entries for assignment_badges table based on the checkbox entries
* expertiza/app/models/awarded_badge.rb - suggest badge method was added, which is called when badge is suggested by student by checking the checkbox in questioner.
* expertiza/app/models/badge.rb - functionality to get image name from name was added

=== Controllers ===
* expertiza/app/controllers/assignments_controller.rb - Modifications were done to include the functionality of displaying all badges in the badges tab and check box based selection process
* expertiza/app/controllers/badges_controller.rb - This was a new file added in this implementation . Code on handling new badge creation, in create method was added.
* expertiza/app/controllers/response_controller.rb - Modification to process question responses from checkbox about badges were added to this file

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb - Modification to display all available badges to badges tab as checkbox was done. Also a link to creating a new badge is provided
* expertiza/app/views/badges/new.html.erb - New file to create a new badge was added to this file
* expertiza/app/views/badges/_form.html.erb - New file to create a form for badge was added to this file
* expetiza/app/views/response/response.html.erb - Modification to display checkbox questions in review questioner was added to this file

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== Routes===
* Routes for badges was added

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= Future Work =
#The approval workflow is currently missing - when a student assigns a badge to a peer, the approval status is set to 0 and it will never appear in the other student’s homepage. Workflow to change the status by the instructor must be implemented.
#There is currently no way for a newly created badge to be assigned to a student through the UI, even if it has been added to an assignment. This needs to be implemented.
#Instructors cannot directly assign “Good Reviewer” badge through the UI. A separate flow to enable instructors to do that would be useful

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[https://github.com/expertiza/expertiza/pull/1176 Pull Request for present implementation]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:34:13Z

Aravich6: /* Problem Statement */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Usecase Diagram ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

== Files to be modified ==

=== Models ===
* expertiza/app/models/awarded_badge.rb

=== Controllers ===
* expertiza/app/controllers/badge_controller.rb (to be added)

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb
* expertiza/app/views/student_teams/view.html.erb
* expertiza/app/views/review_mapping/_review_report.html.erb
* expertiza/app/views/student_task/list.html.erb

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== New Files ===
* expertiza/app/views/assignments/edit/_add_new_badge.html.erb
* expertiza/app/views/assignments/edit/_approve_badge.html.erb

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:34:06Z

Aravich6: /* Background And Motivation */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:33:43Z

Aravich6: /* Previous Implementation */

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

==Motivation==

The primary motivation behind this project is to give more flexibility to the instructor to assign badges instead of relying solely on automatic scoring. Also, allowing students to suggest ''Good Teammate'' and ''Good Reviewer'' badges for their peers will give them an incentive to put in more effort towards carefully reviewing other's work, and encourage them to actively participate in team projects.

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Usecase Diagram ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

== Files to be modified ==

=== Models ===
* expertiza/app/models/awarded_badge.rb

=== Controllers ===
* expertiza/app/controllers/badge_controller.rb (to be added)

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb
* expertiza/app/views/student_teams/view.html.erb
* expertiza/app/views/review_mapping/_review_report.html.erb
* expertiza/app/views/student_task/list.html.erb

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== New Files ===
* expertiza/app/views/assignments/edit/_add_new_badge.html.erb
* expertiza/app/views/assignments/edit/_approve_badge.html.erb

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:23:33Z

Aravich6: /* Controllers */

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Usecase Diagram ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

== Files to be modified ==

=== Models ===
* expertiza/app/models/awarded_badge.rb

=== Controllers ===
* expertiza/app/controllers/badge_controller.rb (to be added)

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb
* expertiza/app/views/student_teams/view.html.erb
* expertiza/app/views/review_mapping/_review_report.html.erb
* expertiza/app/views/student_task/list.html.erb

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== New Files ===
* expertiza/app/views/assignments/edit/_add_new_badge.html.erb
* expertiza/app/views/assignments/edit/_approve_badge.html.erb

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:22:35Z

Aravich6: /* Controllers */

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Usecase Diagram ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

== Files to be modified ==

=== Models ===
* expertiza/app/models/awarded_badge.rb

=== Controllers ===
We will need to add a new controller for badge

=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb
* expertiza/app/views/student_teams/view.html.erb
* expertiza/app/views/review_mapping/_review_report.html.erb
* expertiza/app/views/student_task/list.html.erb

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== New Files ===
* expertiza/app/views/assignments/edit/_add_new_badge.html.erb
* expertiza/app/views/assignments/edit/_approve_badge.html.erb

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-14T02:20:09Z

Aravich6: /* Expertiza */

= Background And Motivation =

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name, description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Usecase Diagram ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges.

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

== Files to be modified ==

=== Models ===
* expertiza/app/models/awarded_badge.rb

=== Controllers ===
=== Views ===
* expertiza/app/views/assignments/edit/_badges.html.erb
* expertiza/app/views/student_teams/view.html.erb
* expertiza/app/views/review_mapping/_review_report.html.erb
* expertiza/app/views/student_task/list.html.erb

=== Database changes ===
* Add a new column 'approval_status' in the awarded_badges table

=== New Files ===
* expertiza/app/views/assignments/edit/_add_new_badge.html.erb
* expertiza/app/views/assignments/edit/_approve_badge.html.erb

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T15:02:38Z

Aravich6: /* Test Plan */

= Background And Motivation =

==Expertiza==
[http://expertiza.ncsu.edu/ Expertiza] is an open source web application based on [http://rubyonrails.org/ Ruby on Rails] framework, supported by the National Science Foundation.
It is a place where students can submit and peer-review learning objects (assignments, codes, write ups, websites, etc). For an instructor, expertiza allows to create and customize new or existing assignments. For students, it allows to create and work on various projects and assignments. It provides a platform to peer review other students' submissions across various document types, including the URLs and wiki pages.

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name m description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Flowchart ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

Here are some tests we have in mind:

1. Can save a badge with a valid name, description, and image.

2. Cannot save a badge with an invalid name.

3. Cannot save a badge with empty description.

4. Cannot save a badge without an image path.

5. Check that all badge names are rendered in the "Badges" tab.

6. Check that an instructor can approve student-suggested badges.

7. Check that an approved badge is rendered on student's assignments page if it is approved.

8. Check that a student can not see a badge on assignments page if it is not approved.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T14:50:14Z

Aravich6: /* Creation of new badges */

= Background And Motivation =

==Expertiza==
[http://expertiza.ncsu.edu/ Expertiza] is an open source web application based on [http://rubyonrails.org/ Ruby on Rails] framework, supported by the National Science Foundation.
It is a place where students can submit and peer-review learning objects (assignments, codes, write ups, websites, etc). For an instructor, expertiza allows to create and customize new or existing assignments. For students, it allows to create and work on various projects and assignments. It provides a platform to peer review other students' submissions across various document types, including the URLs and wiki pages.

==Previous Implementation==

The use of badges will encourage students to have a visual motivation based on their achievements and thus perform better. This has the ability to improve the overall class performance.

With such an aim of improving the over all class performance, badging system for Expertiza was implemented, as an [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly earlier project]]. In that implementation, certain students are awarded badges when certain criteria are met which may include exceptional academic performance in assignments, project submissions etc. Two such badges, Good Reviewer and Good Team mater were implemented, with students receiving them automatically based on a threshold score in those categories. This was a static system with fixed number of badges.

The team had implemented the system, by introduction of 3 new badge related tables

1. “badges” :- id , name m description

2. “assignment_badges” :- id, badge_id, assignment_id, threshold

3. “awarded_badges” :- id, badge_id,participant_id

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

4. All badges assigned, must require the approval of the instructor, who would manually accept/deny them before final posting.

= Team Members =
Students who collaborated to work on this problem statement are :

1. Akshay Ravichandran

2. Arunkumar Krishnamoorthy

3. Harish Pullagurla

4. Krithika Sekhar

Mentor:- Zhewei Hu (zhu6@ncsu.edu)

= Implementation Plan =
The following steps briefly describe the implementation steps planned to be taken during the course of this project

== Flowchart ==

[[File:Usecase.jpg]]

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes.

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

[[File:Badge_good_reviewer.png | center]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Visibility of assigned badges to Students ==

Once approved by the instructor, the badges assigned would be visible in the assignment tab of the website as shown in the image. Badges corresponding to each of the assignments will be seen on the row of that particular assignment.

[[File:badge_final_view.png|center]]

= Test Plan =
All new code to be added would be thoroughly tested using TDD methodology.

= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T01:18:51Z

Aravich6: /* Problem Statement */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Flowchart =

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T01:13:32Z

Aravich6: /* Manual assignment of "Good Reviewer" badges */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Flowchart =

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Manual assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the '''expertiza/app/views/review_mapping/_review_report.html.erb''' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T01:13:06Z

Aravich6: /* Creation of new badges */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Flowchart =

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as specified in '''expertiza/app/views/assignments/edit/_badges.html.erb'''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable to this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|center|]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Manual assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the ''expertiza/app/views/review_mapping/_review_report.html.erb'' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T01:06:34Z

Aravich6: /* Implementation Plan */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Flowchart =

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|left|alt text]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Manual assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the ''expertiza/app/views/review_mapping/_review_report.html.erb'' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T01:02:16Z

Aravich6: /* Manual assignment of "Good Reviewer" badges */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

[[File:Team_mate_review.png|200px|left|alt text]]

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Manual assignment of "Good Reviewer" badges ==

Instructors and TAs can see a review report for an assignment that they are managing as given in the ''expertiza/app/views/review_mapping/_review_report.html.erb'' view. They can add grades and comments to every reviewer. We would like to add another column to this view to allow that allows the instructor/TA to click on a checkbox to indicate if this reviewer is a "Good Reviewer". The view we have in mind will look as follows:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:57:32Z

Aravich6: /* Implementation Plan */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

== Manual assignment of "Good Reviewer" badges ==

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:56:37Z

Aravich6: /* Approval of badges by instructor */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

== Approval of badges by instructor ==

Currently, the '''awarded_badges''' table has no column to indicate the approval status of an awarded badge. We would need to run a db migration to include this column. Also, a new view needs to be created to allow instructors to approve student-suggested badges. The view we have in mind is as shown below:

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:53:27Z

Aravich6: /* Problem Statement */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Teammate" badges during the teammate review periods.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

4. Instructors and TAs must be able to manually assign "Good Reviewer" badges.

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

== Approval of badges by instructor ==

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:50:21Z

Aravich6: /* Assignment of "Good Reviewer" and "Good Teammate" badges by student */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last previously. [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly (Previous Implementation)]].

The primary objectives for this project are as follows:

1. Allowing Instructor to create new badges - which involves adding name and badge image.

2. Students must be able to assign "Good Reviewer" and "Good Teammate" badges during the author feedback and teammate review periods respectively. Initially it was automatically assigned based on pre-define score thresholdes.

3. All badges assigned by students must require the approval of the instructor, who would manually accept/deny them before final posting.

= Implementation Plan =

== Creation of new badges ==
When an assignment is created/edited, there is a checkbox called ''"Has Badges?"''. Checking this renders the ''"Badges"'' tab. This tab currently lists the two available badges namely '''"Good Reviewer"''' and '''"Good Teammate"''' as ''specified in expertiza/app/views/assignments/edit/_badges.html.erb''.

We intend to change this view to allow an instructor to add a new badge, and select all badges that will be applicable for this assignment. For this, we intend to display a link called '''"Add"''' and list all the available badges as a series checkboxes. The view we have in mind would look something similar to what is shown below:

Clicking on '''"Add"''' would redirect to a new view, where there is a simple form to add a new badge. The form fields would include ''Badge Name'', ''Image'' and ''Description''.

== Assignment of "Good Teammate" badges by student ==

Presently, the assignment of these badges is done based on a threshold, which is assigned by the TA. We would like to allow students to be able to directly add these badges to their fellow students.

In order to allow students to assign "Good Teammate" badges, the '''expertiza/app/views/student_teams/view.html.erb''' view needs to be edited. The UI we have in mind is as shown below:

== Approval of badges by instructor ==

= Test Plan =
= References=

#[https://github.com/expertiza/expertiza Expertiza on GitHub]
#[http://expertiza.ncsu.edu/ The live Expertiza website]
#[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly Previous Badge implementation page ]

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:35:15Z

Aravich6: /* Assignment of Good Reviewer and Good Teammate badges by student */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:34:44Z

Aravich6: /* Implementation Plan */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:19:57Z

Aravich6: /* Creation of new badges */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:06:22Z

Aravich6: /* Background */

= Background =

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last semester [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly]].

The project has the following objectives:

1. Instructors must be able to create new badges.

2. Instead of assigning badges to students based on some pre-defined criteria, instructors must be able to assign badges manually.

3. Students must be able to assign "Good Reviewer" and "Good Teammate" badges during the author feedback and teammate review periods respectively. These badges must require the approval of the instructor.

= Implementation Plan =

== Creation of new badges ==

== Manual assignment of badges by instructor ==

== Assignment of Good Reviewer and Good Teammate badges by student ==

= Test Plan =
= References=

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:05:25Z

Aravich6: /* Problem Statement */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-06T00:02:27Z

Aravich6: /* Implementation Plan */

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last semester [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly]].

The project has the following objectives:

1. Instructors must be able to create new badges.

2. Instead of assigning badges to students based on some pre-defined criteria, instructors must be able to assign badges manually.

3. Students must be able to assign "Good Reviewer" and "Good Teammate" badges during the author feedback and teammate review periods respectively. These badges must require the approval of the instructor.

= Implementation Plan =

== Creation of new badges ==

== Manual assignment of badges by instructor ==

== Assignment of Good Reviewer and Good Teammate badges by student ==

= Test Plan =

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:52:45Z

Aravich6: /* Problem Statement */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:52:32Z

Aravich6: /* Problem Statement */

== Problem Statement ==
The aim of this project is to extend the functionality of badging that was implemented last semester [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly]].

The project has the following objectives:

1. Instructors must be able to create new badges.

2. Instead of assigning badges to students based on some pre-defined criteria, instructors must be able to assign badges manually.

3. Students must be able to assign "Good Reviewer" and "Good Teammate" badges during the author feedback and teammate review periods respectively. These badges must require the approval of the instructor.

= Implementation Plan =

= Test Plan =

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:51:57Z

Aravich6: /* Implementation Plan */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:51:36Z

Aravich6: /* Problem Statement */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:11:47Z

Aravich6: /* Problem Statement */

CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging

2018-04-05T23:11:28Z

Aravich6: Created page with "= Problem Statement = The aim of this project is to extend the functionality of badging that was implemented last semester [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_..."

= Problem Statement =
The aim of this project is to extend the functionality of badging that was implemented last semester [[http://wiki.expertiza.ncsu.edu/index.php/CSC/ECE_517_Fall_2017/E17A2._Lightweight_badging_system_based_on_Credly]].

The project has the following objectives:

1. Instructors must be able to create new badges.
2. Instead of assigning badges to students based on some pre-defined criteria, instructors must be able to assign badges manually.
3. Students must be able to assign "Good Reviewer" and "Good Teammate" badges during the author feedback and teammate review periods respectively. These badges must require the approval of the instructor.

MainPage

2018-04-05T23:03:32Z

Aravich6: /* Expertiza */

==Expertiza==
* [[Expertiza documentation]]

* [[CSC/ECE 517 Summer 2008]]
* [[CSC/ECE 517 Fall 2010]]
* [[CSC/ECE 517 Fall 2011]]
* [[CSC/ECE 517 Fall 2012]]
* [[CSC/ECE 517 Fall 2013]]
* [[CSC/ECE 517 Fall 2014]]
* [[CSC/ECE 517 Fall 2015]]
* [[CSC/ECE 517 Fall 2016]]
* [[CSC/ECE 517 Spring 2014]]
* [[CSC/ECE 517 Spring 2015]]
* [[CSC/ECE 517 Spring 2016]]
* [[CSC/ECE 517 Spring 2017]]
* [[CSC/ECE 517 Fall 2017]]
* [[CSC/ECE 517 Spring 2018- Project Juniper:Bookmark Enhancements]]
* [[CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors]]
* [[CSC/ECE 517 Spring 2018- Project E1804: OSS project Yellow: Topic management]]
* [[CSC/ECE_517_Spring_2018- Project E1805: Convolutional data extraction from Github]]
* [[CSC/ECE 517 Spring 2018- Project E1808: Refactor review_mapping_controller.rb]]
* [[CSC/ECE 517 Spring 2018- Project E1810: Show sample submissions and reviews]]
* [[CSC/ECE 517 Spring 2018/E1814 Write unit tests for collusion cycle.rb]]
* [[CSC/ECE 517 Spring 2018- Project M1802: 2D Canvas Rendering]]
* [[CSC/ECE 517 Spring 2018 - E1800: Add past-due assignments to task list]]
* [[CSC/ECE 517 Spring 2018- Project E1812: on the fly calc.rb]]
* [[CSC/ECE 517 Spring 2018- Project M1803: Implement a web page buzzer to find rendering mismatches ]]
* [[CSC/ECE 517 Spring 2018/E1813 Test Menu Items Model]]
* [[CSC/ECE 517 Spring 2018- Project E1822: Extend the functionality of badging]]
* [[CSC 456 Spring 2011|CSC 456 Spring 2012]]
* [[ECE 633]]
* [[KCU]]
* [[Progress reports]]

==Application Behavior==
* [[Grading]]

==Metaprogramming==
* [[CSC/ECE_517_Spring_2013/ch1b_1k_hf|Lecture on Metaprogramming]]

==Development==

''Expertiza now has a Java dependency, so the machine you are using to develop Expertiza on should have the JVM installed.''

* [[Setting Up a Development Machine]]
* [[Creating a Linux Development Environment for Expertiza - Installation Guide]]
* [[Using git and github for projects]]
* [[Using heroku to deploy your projects]]
* [[How to Begin a Project from the Current Expertiza Repository]]
* [[Git]]
* [[How to Change a User's Password on a Development Machine]]
* [[Debugging Rails]]
* [http://rajanalwan.com/ui_guidelines/ Design Template]

==Production==
* [[Deploying to Production]]
* [[Downloading Production Data]]
* [[Accessing the Production Server]]

==Testing==
* [[Using Cucumber with Expertiza]]
* [[Rails Testing Overview]]
* [[Expertiza Continuous Integration]]

==References==
* [[Object-Oriented Design and Programming]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T02:53:43Z

Aravich6: /* Automated Test Plan */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===
The ''after_login'' method in this controller sets up the session object after the user logs in, so it is a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden).
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor. Enter 'instructor6' as username and 'password' as password.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
1. '''Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.'''
This test case is to check if the menu items ''Assignments'' and ''Course Evaluation'' are hidden when an instructor is in instructor view. The following lines can be added to a spec/features file:

<pre>
it " can display relevant menu items after login as an admin/instructor/TA", js: true do
create(:instructor)
login_as 'instructor6'
visit '/tree_display/list'
expect(page).to have_current_path('/tree_display/list')
expect(page).to have_content('Manage content')
expect(page).to have_content('Survey Deployments')
expect(page).not_to have_content('Assignments')
expect(page).not_to have_content('Course Evaluation')
end
</pre>

2. '''Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.'''
This test case is to check if the menu items ''Manage content'' and ''Survey Deployments'' are hidden when the instructor switches to student view. The following lines are to be added:

<pre>
it "can display relevant menu items when switching to student view", js: true do
create(:instructor)
login_as 'instructor6'
visit '/tree_display/list'
click_link 'Swtich to Student View'
expect(page).to have_current_path('/student_task/list')
expect(page).to have_content('Assignments')
expect(page).to have_content('Course Evaluation')
expect(page).not_to have_content('Manage content')
expect(page).not_to have_content('Survey Deployments')
end
</pre>

== External Links ==
# Link to forked repository [[https://github.com/akshayravichandran/expertiza]]
# Link to screen cast [[https://youtu.be/lRZT4q7YDLA]]

==References==

Expertiza
* https://expertiza.ncsu.edu/

Expertiza Github
* https://github.com/expertiza/expertiza

Expertiza Documentation
* http://wiki.expertiza.ncsu.edu/index.php/Expertiza_documentation

RSpec Documentation
* http://rspec.info/documentation/

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T02:34:45Z

Aravich6: /* Automated Test Plan */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===
The ''after_login'' method in this controller sets up the session object after the user logs in, so it is a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden).
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
1. '''Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.'''
This test case is to check if the menu items ''Assignments'' and ''Course Evaluation'' are hidden when an instructor is in instructor view. The following lines in the file spec/features/airbrake_expection_errors_feature_tests_spec.rb are to be modified:

<pre>
it "can access to '/tree_display/list' after login as an admin/instructor/TA", js: true do
create(:instructor)
login_as 'instructor6'
visit '/tree_display/list'
expect(page).to have_current_path('/tree_display/list')
expect(page).to have_content('Manage content')
expect(page).to have_content('Survey Deployments')
expect(page).not_to have_content('Assignments')
expect(page).not_to have_content('Course Evaluation')
end
</pre>

2. '''Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.'''
This test case is to check if the menu items ''Manage content'' and ''Survey Deployments'' are hidden when the instructor switches to student view. The following lines in the file spec/features/airbrake_expection_errors_feature_tests_spec.rb are to be added:

<pre>
it "can access to '/tree_display/list' when switching to student view", js: true do
create(:instructor)
login_as 'instructor6'
visit '/tree_display/list'
expect(page).to have_current_path('/tree_display/list')
expect(page).to have_content('Assignments')
expect(page).to have_content('Course Evaluation')
expect(page).not_to have_content('Manage content')
expect(page).not_to have_content('Survey Deployments')
end
</pre>

== External Links ==
# Link to forked repository [[https://github.com/akshayravichandran/expertiza]]
# Link to screen cast [[https://youtu.be/lRZT4q7YDLA]]

==References==

Expertiza
* https://expertiza.ncsu.edu/

Expertiza Github
* https://github.com/expertiza/expertiza

Expertiza Documentation
* http://wiki.expertiza.ncsu.edu/index.php/Expertiza_documentation

RSpec Documentation
* http://rspec.info/documentation/

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T01:31:50Z

Aravich6: /* External Links */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===
The ''after_login'' method in this controller sets up the session object after the user logs in, so it is a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden).
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# Link to forked repository [[https://github.com/akshayravichandran/expertiza]]
# Link to screen cast [[https://youtu.be/lRZT4q7YDLA]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T01:31:35Z

Aravich6: /* External Links */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===
The ''after_login'' method in this controller sets up the session object after the user logs in, so it is a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden).
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]
# link for screen cast [[https://youtu.be/lRZT4q7YDLA]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T01:05:50Z

Aravich6: /* expertiza/app/controllers/auth_controller.rb */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===
The ''after_login'' method in this controller sets up the session object after the user logs in, so it is a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden).
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T01:04:44Z

Aravich6: /* expertiza/app/views/menu_items/_suckerfish.html.erb */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===
This file is responsible for rendering all menu items and their children (if any).

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T01:03:16Z

Aravich6: /* expertiza/app/views/shared/_navigation.html.erb */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
This file is shared between all views and is responsible for rendering all the elements in the top-most part of the web page. (i.e Displaying the menu items, the logout button etc.)

In order to switch between '''instructor view''' and '''student view''', the following code was added. When the user is in '''instructor view''', there is a link named "Switch to Student View" to switch to '''student view''' and when the user is in '''student view''', 'here is a link named "Revert to Instructor View" to switch back to the '''instructor view'''.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:59:58Z

Aravich6: /* Problem statement */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors. When in '''student view''', an instructor must not be able to view ''"Manage content"'' and ''"Survey Deployments"'' menu items, and must be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). When in '''instructor view''', an instructor must not be able to view the ''"Assignment"'' and ''"Course Evaluation"'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:57:05Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors, which will allow an instructor to see what students see without having to actually impersonate a particular student. When in '''student view''', an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). Also when in '''instructor view''', an instructor must not be able to view the ''Assignment'' and ''Course Evaluation'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:56:54Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage content Survey Deployments Assignments Course Evaluation Profile Contact Us''

And, a student can see the following menu items across the top:

''Home Assignments Pending Surveys Profile Contact Us''

On the instructor’s “Manage content” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage content > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

Therefore, it makes sense to create a '''student view''' for instructors, which will enable them to see menu items that are only related to students. This will help resolve the confusion.

=== Problem statement ===
Create a '''student view''' for instructors, which will allow an instructor to see what students see without having to actually impersonate a particular student. When in '''student view''', an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). Also when in '''instructor view''', an instructor must not be able to view the ''Assignment'' and ''Course Evaluation'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:51:06Z

Aravich6: /* Problem statement */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage Survey Deployments Assignments Course Evaluation Profile Contact Us''

On the instructor’s “Manage” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

=== Problem statement ===
Create a '''student view''' for instructors, which will allow an instructor to see what students see without having to actually impersonate a particular student. When in '''student view''', an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the '''instructor view''' (the default view that an instructor first sees when he/she logs in). Also when in '''instructor view''', an instructor must not be able to view the ''Assignment'' and ''Course Evaluation'' menu items.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:48:47Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Currently, when an '''instructor''' logs into Expertiza, he/she sees the following menu items across the top:

''Home Manage Survey Deployments Assignments Course Evaluation Profile Contact Us''

On the instructor’s “Manage” menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu (that both students and instructors) see allows the instructor to participate in assignments.

=== Problem statement ===
Our aim is to create a student view for instructors, which will allow an instructor to see what the students see without having to actually impersonate a particular student. When in student view, an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the instructor view. Also when in instructor view, an instructor won't be able to view the 'Assignment' and 'Course Evaluation' menu items, which as of now the instructor can see.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:19:18Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

Our project is to introduce a student view to the instructors. Currently, an '''instructor''' sees the following menus across the top:

''Home Manage Survey Deployments Assignments Course Evaluation Profile Contact Us''

On the instructor’s Manage menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu that both students and instructors see allows them to participate in assignments.

Hence, to avoid confusion, when in '''instructor view''',the following menus are displayed across the top:

''Home Manage Survey Deployments Profile Contact Us''

When in '''student view''', the following menus are displayed across the top:

''Home Assignments Course Evaluations Profile Contact Us''

When the instructor first logs in, he is in '''instructor view'''. He can choose to switch to '''student view''' at any time, and also revert back to '''instructor view''' at any time.

=== Problem statement ===
Our aim is to create a student view for instructors, which will allow an instructor to see what the students see without having to actually impersonate a particular student. When in student view, an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the instructor view. Also when in instructor view, an instructor won't be able to view the 'Assignment' and 'Course Evaluation' menu items, which as of now the instructor can see.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:18:57Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh.

 Our project is to introduce a student view to the instructors. Currently, an '''instructor''' sees the following menus across the top:

''Home Manage Survey Deployments Assignments Course Evaluation Profile Contact Us''

On the instructor’s Manage menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu that both students and instructors see allows them to participate in assignments.

Hence, to avoid confusion, when in '''instructor view''',the following menus are displayed across the top:

''Home Manage Survey Deployments Profile Contact Us''

When in '''student view''', the following menus are displayed across the top:

''Home Assignments Course Evaluations Profile Contact Us''

When the instructor first logs in, he is in '''instructor view'''. He can choose to switch to '''student view''' at any time, and also revert back to '''instructor view''' at any time.

=== Problem statement ===
Our aim is to create a student view for instructors, which will allow an instructor to see what the students see without having to actually impersonate a particular student. When in student view, an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the instructor view. Also when in instructor view, an instructor won't be able to view the 'Assignment' and 'Course Evaluation' menu items, which as of now the instructor can see.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]

CSC/ECE 517 Spring 2018- Project E1803: Introducing a Student View for Instructors

2018-04-03T00:18:31Z

Aravich6: /* Background */

== Introduction ==
=== Background ===
[http://expertiza.ncsu.edu/ Expertiza] is a web based open source peer reviewing tool developed and maintained by current and past students of [https://en.wikipedia.org/wiki/North_Carolina_State_University North Carolina State University], Raleigh. Our project is to introduce a student view to the instructors. Currently, an '''instructor''' sees the following menus across the top:

''Home Manage Survey Deployments Assignments Course Evaluation Profile Contact Us''

On the instructor’s Manage menu, one of the options is “Assignments”. Having “Assignments” appear in two places is potentially confusing. “Manage > Assignments” allows the instructor to edit and create assignments, whereas the “Assignments” menu that both students and instructors see allows them to participate in assignments.

Hence, to avoid confusion, when in '''instructor view''',the following menus are displayed across the top:

''Home Manage Survey Deployments Profile Contact Us''

When in '''student view''', the following menus are displayed across the top:

''Home Assignments Course Evaluations Profile Contact Us''

When the instructor first logs in, he is in '''instructor view'''. He can choose to switch to '''student view''' at any time, and also revert back to '''instructor view''' at any time.

=== Problem statement ===
Our aim is to create a student view for instructors, which will allow an instructor to see what the students see without having to actually impersonate a particular student. When in student view, an instructor must be able to view only the menu items that a student can view and must also be able to switch back to the instructor view. Also when in instructor view, an instructor won't be able to view the 'Assignment' and 'Course Evaluation' menu items, which as of now the instructor can see.

=== Team ===
# Akshay Ravichandran
# Krithika Sekhar
# Sameer Poudwal

'''Mentor''' - Dr. Ed Gehringer

== Implementation ==
=== expertiza/app/views/shared/_navigation.html.erb ===
To switch from instructor to student view and to switch back from student to instructor view, the following code was added in the _navigation.html.erb file. When the user is in instructor view, there is a link named "Switch to Student View" to switch to student view and when the user is in student view, there is a link named "Revert to Instructor View" to switch back to Instructor View.
<% if session[:user].role.instructor? %>
<% if session.key?(:student_view) %>
<%= link_to "Revert to Instructor View", {controller: "instructor", action: "revert_to_instructor_view"},
method: :post, :style => "color: white" %>
<% else %>
<%= link_to "Switch to Student View", {controller: "instructor", action: "set_student_view"},
method: :post, :style => "color: white" %>
<% end %>
<% end %>

=== expertiza/app/views/menu_items/_suckerfish.html.erb ===

A condition was needed to check if the current menu item that is to be rendered is in the list of hidden menu items. The ''hidden_menu_items'' session variable holds the IDs of menu items that must not be rendered. This applies only when the type of user currently logged in is an instructor. Hence, the following condition was added.
<pre>
display_item_condition = (session[:user].role.instructor?)?(session[:hidden_menu_items].include?item_id)?false:true:true
</pre>

=== expertiza/app/controllers/instructor_controller.rb ===

A new instructor_controller.rb file has been added. This controller currently contains the actions to switch to student view and revert back to instructor view.
<pre>
class InstructorController < ApplicationController
# check to see if the current action is allowed
def action_allowed?
# only an instructor is allowed to perform all the actions in
# this controller
return true if session[:user].role.instructor?
end

# sets student_view in session object and redirects to
# student_task/list after updating hidden_menu_items
def set_student_view
session[:student_view] = true
MenuItemsHelper.update_hidden_menu_items_for_student_view(session)
redirect_to controller: 'student_task', action: 'list'
end

# destroys student_view in session object and redirects to
# tree_display/list after updating hidden_menu_items
def revert_to_instructor_view
session.delete(:student_view)
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
redirect_to controller: 'tree_display', action: 'list'
end
end
</pre>

=== expertiza/app/helpers/menu_items_helper.rb ===

This is a helper for deciding what menu items must be hidden.
 The ''update_hidden_menu_items_for_student_view'' method is used to hide the ''Survey Deployments'' and ''Manage Instructor Content'' menu items. It does this by including the menu item IDs of these two menus in the ''hidden_menu_items'' session variable. (The ''hidden_menu_item'' variable will be used by _suckerfish.html.erb to decide whether or not to render a given menu item).
 Similarly, the ''update_hidden_menu_items_for_instructor_view'' method is used to hide the ''Assignments'' and ''Course Evaluation'' menu items.
 The ''set_hidden_menu_items'' method is used to set check if the given user is an instructor. If it is, then the ''update_hidden_menu_items_for_instructor_view'' method is called. This method is used to ensure that only those items that must be visible to an instructor view are visible to an instructor when he logs in for the first time. The method has been designed in this way because, in the future, other menu items may need to be hidden based on the user type.
<pre>
module MenuItemsHelper
# sets hidden_menu_items for the given user if
# user is an instructor. This method is needed to set
# the hidden_menu_items during initial login by instructor.
def self.set_hidden_menu_items(user, session)
if user.role.instructor?
MenuItemsHelper.update_hidden_menu_items_for_instructor_view(session)
else
session[:hidden_menu_items] = []
end
end

# updates hidden_menu_items in session object when an instructor is
# in student view
def self.update_hidden_menu_items_for_student_view(session)
# 35 - Survey Deployments, 37 - Manage Instructor Content
session[:hidden_menu_items] = [35, 37]
end

# updates hidden_menu_items in session object when an instructor is
# in instructor view
def self.update_hidden_menu_items_for_instructor_view(session)
# 26 - Assignments, 30 - Course Evaluation
session[:hidden_menu_items] = [26, 30]
end
end
</pre>

=== expertiza/app/controllers/auth_controller.rb ===

The following lines were added to the ''after_login'' method. This call is intended to set the 'hidden_menu_items' variable in the session object when an instructor logs in for the first time. This is done so that the instructor is by default in Instructor View when he logs in. (i.e ''Assignments'' and ''Course Evaluation'' are hidden). The ''after_login'' method sets up the session object after the user logs in, so it seemed like a good candidate to include the initial set up of the ''hidden_menu_items'' session variable.
<pre>
# hide menu items based on type of user
MenuItemsHelper.set_hidden_menu_items(user,session)
</pre>

The following lines were added to the ''clear_session'' method. These lines clear the ''student_view'' and ''hidden_menu_items'' session variables.
<pre>
session[:student_view] = nil
session[:hidden_menu_items] = nil
</pre>

=== expertiza/config/routes.rb ===

New post methods are added in ''config/routes.rb''. The routes are directed to the instructor controller's ''set_student_view'' and ''revert_to_instructor_view'' actions.

<pre>
resources :instructor, only: [] do
collection do
post :set_student_view
post :revert_to_instructor_view
end
end

</pre>

== Manual UI Testing ==

The user needs to log-in as an instructor to view this functionality.

1. Log into Expertiza as an instructor.

2. Click on '''Switch to Student View''' below username to switch to student view.

[[File:Student_View_1.PNG]]

3. Click on '''Revert to Instructor View'''' below username to come back to instructor view.

[[File:Instructor_View_1.PNG]]

== Automated Test Plan ==
# Check whether ''Assignments'' and ''Course Evaluation'' are hidden when in instructor view.
# Check whether ''Manage content'' and ''Survey Deployments'' are hidden in student view.

== External Links ==
# link for forked repository [[https://github.com/akshayravichandran/expertiza]]