Lectures: Hide slide pages until a date

[eceeeren]

Checklist

General

• I tested all changes and their related features with all corresponding user types on a test server.
• Language: I followed the guidelines for inclusive, diversity-sensitive, and appreciative language.
• I chose a title conforming to the naming conventions for pull requests.

Server

• Important: I implemented the changes with a very good performance and prevented too many (unnecessary) and too complex database calls.
• I strictly followed the principle of data economy for all database calls.
• I strictly followed the server coding and design guidelines.
• I added multiple integration tests (Spring) related to the features (with a high test coverage).
• I added pre-authorization annotations according to the guidelines and checked the course groups for all new REST Calls (security).
• I documented the Java code using JavaDoc style.

Client

• Important: I implemented the changes with a very good performance, prevented too many (unnecessary) REST calls and made sure the UI is responsive, even with large data (e.g. using paging).
• I strictly followed the principle of data economy for all client-server REST calls.
• I strictly followed the client coding and design guidelines.
• Following the theming guidelines, I specified colors only in the theming variable files and checked that the changes look consistent in both the light and the dark theme.
• I added multiple integration tests (Jest) related to the features (with a high test coverage), while following the test guidelines.
• I added authorities to all new routes and checked the course groups for displaying navigation elements (links, buttons).
• I documented the TypeScript code using JSDoc style.
• I added multiple screenshots/screencasts of my UI changes.
• I translated all newly inserted strings into English and German.

Motivation and Context

The feature to hide slide pages (#9667) has been implemented, allowing instructors to hide pages indefinitely. However, a new feature is needed to enable instructors to hide specific pages with more flexibility to enhance functionality. This feature should provide the following options:

1. Hide Indefinitely: Maintain the current functionality to hide pages permanently until manually unhidden.
2. Hide Until a Specific Date: Allow instructors to set a manual date and time for the pages to be automatically unhidden.
3. Hide Until an Exercise's Due Date: Link the hidden pages to an exercise's due date, ensuring they are unhidden when it is due.

Additionally, a scheduled job should be implemented to automatically unhide pages once the specified conditions are met. This enhancement will improve usability and provide greater control for instructors.

Description

To enable the functionality of hiding pages until a specific date, the following changes have been implemented:

1. PDF Preview Date Box Component: A new component named PDF Preview Date Box has been created.
Date Box Accessibility: The Date Box becomes accessible by clicking the "Hide" button when hovering over a page.
2. Hide Options: The Date Box allows instructors to configure hiding options for the selected page. It provides three choices:

• Hide the page indefinitely.
• Hide the page until a specific date and time.
• Hide the page until the selected exercise's due date.

3. Configuration View: Once the hiding configuration is saved, the current settings can be viewed by clicking the "View" button.
4. Show Page Popover: In the "Show Page" popover, the selected hiding date is displayed, along with an option to unhide the page.
5. Database Integration: The selected configurations are stored in the Slide table for persistence.
6. Scheduled Job: A scheduled job runs every minute, checking the Slide repository to automatically unhide slides that have reached their specified date.

Steps for Testing

Prerequisites:

• 1 Instructor
• 1 Student

1. Log in to Artemis
2. Navigate to Course Administration
3. Go to 'Lecture Units'
4. Create one Lecture Unit with a File
5. Click "View" button
6. Hover over one of the pages and click "Hide" button
7. Confirm that you can see a popover with different options
8. Click "Hide forever" and confirm that other options are disabled
9. Uncheck "Hide forever", click "Select Date" and confirm that you can choose a date and time in the calendar
10. Click "Select Exercise" and confirm that you see "No exercises available" text when there are no exercises with due date defined
11. Click "Cancel" and confirm that popover is closed with no side effect
12. Select one of the dates and click "Submit"
13. Confirm that the page is hidden and you can see "Show" button instead
14. Click "Show" button and confirm you can see "Show Page" popover
15. Click "Cancel" to test the button and then click "Show" to show the page again
16. Repeat from steps 5-15 with dark mode enabled, language is German and when some exercises are added to the course
17. Hide one of the page to a time in the future and one for a short time (e.g. 1 or 2 minutes)
18. Observe that the page hidden for a short time is visible after the specified time has passed
19. Test that "Download" button shows the student version and "Original Version" shows the version that pages are not hidden
20. Log in as a student and go to lecture's Communication part
21. Verify that you can not reference hidden slides in the forum, only the visible slides

Testserver States

Note

These badges show the state of the test servers.
Green = Currently available, Red = Currently locked
Click on the badges to get to the test servers.

Review Progress

Performance Review

• I (as a reviewer) confirm that the client changes (in particular related to REST calls and UI responsiveness) are implemented with a very good performance even for very large courses with more than 2000 students.
• I (as a reviewer) confirm that the server changes (in particular related to database calls) are implemented with a very good performance even for very large courses with more than 2000 students.

Code Review

• Code Review 1
• Code Review 2

Manual Tests

• Test 1
• Test 2

Test Coverage

Class/File	Line Coverage	Confirmation (assert/expect)
pdf-preview.component.ts	94%	✅
pdf-preview-thumbnail-grid.component.ts	92%	✅
pdf-preview-date-box.component.ts	100%	✅

Screenshots

1. Date Box component with different options selected

2. Show Page popover with different options selected

[github-actions]

There hasn't been any activity on this pull request recently. Therefore, this pull request has been automatically marked as stale and will be closed if no further activity occurs within seven days. Thank you for your contributions.