Support for location on Calendar

Testing backup and restore NOTE:     This set up part should be tested BEFORE upgrading to this issue's branch, since it requires a backup from a site without location support. ** Set up (creating an 'old' backup) Open your terminal and go to your Moodle instance's root directory and checkout the latest weekly release: git checkout f61ee4e857a894a5b8b69516b00be88ae499964b Log into your test Moodle site as an admin. Note: If ever you encounter an error indicating that you are running an older version of the code, simply run "mdk run version" and refresh the page. Create a course called calcourse1. Open the course, and click on Calendar, to open the course's calendar. Click New event, add an event with title 'backup event', Type of event 'Course' and click Save. Navigate to the calcourse1 course view page. Click the settings cog at the top right and click Backup from the dropdown options. Ensure 'Include calendar events' is checked, then click 'Jump to final step'. Once the backup is created, click continue. Under Course backup area, note down the Filename of the backup you have just performed. Navigate back to the Calendar for calcourse1. Click on the 'backup event' event you created earlier. In the modal popup, click Delete and then Delete event in the confirmation prompt. CONFIRM the event no longer exists in the calendar. Check out this issue's branch ( MDL-37624 -master). Testing old backups can be restored Reset the codebase with the patch now applied. git checkout master Log into your test Moodle site as an admin, performing the site upgrade steps that will prompt you after switching to the latest version of the branch. Navigate to the calcourse1 course view page. Click the settings cog at the top right and click Restore from the dropdown options. Under Course backup area, find the filename of the backup you performed in the setup above. Click Restore for that backup. Scroll down and click Continue on the page that loads. Under 'Restore into this course', click Continue. Ensure 'Include calendar events' is checked, then click Next. Scroll down and click Next. Scroll down and click Perform restore. Once the restore completes, click Continue, which will redirect you to the course view page. Open the Calendar. CONFIRM the 'backup event' event is displayed in the calendar. Click the 'backup event' event, CONFIRM the details appear correct in the modal popup, and CONFIRM the location row is NOT visible. Click Edit, then click 'Show more...'. CONFIRM the Location input is visible, but empty. Type 'Test location' into the location input, then click Save. Click the 'backup event' event again, and CONFIRM the location row is now visible, with the text 'Test location'. Note: Keep this course/event to be used for the next test. Testing location is backed up and restored Set up (Creating a backup with location) Note: This follows on directly from the above test. Log into your test Moodle site as an admin (if you are not still logged in from the previous test). Repeat steps 6-14 of "Set up (creating an 'old' backup)" above. (You result should be you perform a backup, then delete the 'backup event' calendar event). Testing backups restore events with location Repeat steps 1-13 from "Testing old backups can be restored" above (this should restore the 'backup event' event into the course calendar). Click the 'backup event' event, and CONFIRM the details appear correct in the modal popup, and CONFIRM location row is visible, with the text 'Test location'. Testing add/edit calendar entries Log into your test Moodle site as an admin user, ensure Boost theme is active. Click calendar in the navigation on the left of the page. Click New event button. Click Show more... and populate as follows: Event title 'user event', Date (today's date), Type of event 'User', Description 'user description', Event location 'https://moodle.org, event location'. Click Save button. CONFIRM 'user event' appears in the calendar for today's date. Click 'user event' event, to open the event. CONFIRM modal popup appears, including the location. Location should have an icon, and the text you typed above in plain text. Return to the test site tab, and click the edit button in the modal popup, then click Show more... CONFIRM all details appear as you input them earlier. Switch the site theme to Clean. Return to the calendar, and click on your test 'user event'. Click the Edit button, then Show more... . Remove all text from Event location and click the Save button. Click 'user event' event, to reopen the modal popup, and CONFIRM the location row is not showing at all, now that no location is set. Create events for the remaining 3 event types, Course, Category and Site, using the details from step 4 above, replacing the title/description as appropriate. View the calendar entries for each, with a user that has appropriate access to view them (for example Course, using a student enrolled in the course). In each case, CONFIRM they appear as expected in all cases. Log in as the admin user. Switch the site theme to Clean. Open a calendar event containing a location, CONFIRM the modal popup, as well as Edit screens still show the location correctly (the modal should show a map tag icon for both Clean and Boost themes). Remove the location from the event and save. Reopen the even and CONFIRM the modal popup no longer shows a location row, now the location has been removed from the event. Testing import calendar Download the attached testimport.ics file, which contains some sample events. Log into your test Moodle site as any user (referred to below as user1) that has no existing User calendar events in June 2018 (or remove any that exist - this is to make the next test easier). Click the calendar navigation item. On the calendar screen, click the Manage subscriptions button at the bottom of the page. Set _Calendar name' as 'Test calendar import', Import from as _Calendar file (.ics). For Calender file, click the Choose a file... button, Browse... and find/select the testimport.ics you downloaded earlier, click open , then click the Upload this file button. Click the _Add_button at the bottom of the page. CONFIRM the confirmation at the top of the page says "Events imported: 2" and "Events updated: 0". Click Calendar in the left navigation to return to the calendar page. If the calendar does not display June 2018, navigate to that month, where you should see tests 1 and 2 listed in order, one in 2nd and one in 3rd June. Open each test, first looking at the modal popup, then clicking Edit>Show more..., CONFIRMING as follows: Test 1- Has location: CONFIRM modal popup and edit both show location as 'Some text location'. Test 2 - Empty location: CONFIRM location row is omitted from modal popup, Edit screen shows an empty input for Event location . Testing export calendar Log into your test Moodle site as user1 from above (since they only have two test events in June 2018, with and without location). Navigate to Calendar in the left site navigation. Ensure you are viewing the June 2018 calendar. Click the Export calendar button at the bottom of the page. Select Events to export My personal events , and Time period This month . Click the Export button and save the .ics file. Find the icalexport.ics file you have just downloaded on your computer. Import the .ics file into your preferred calendar/email app, and CONFIRM the two events exist, and contain the same details that exist within the calendar on your test Moodle site. NOTE: If you do not wish to import these, you can open the .ics file in a text editor and confirm the details, it is just harder to read in that format. You can then delete the two events from your calendar app. Testing export request (GDPR) Log into your test Moodle site as an admin user. Visit https://docs.moodle.org/35/en/Data_privacy_plugin (referred to below as link1) Follow the instructions from link1 under Privacy Officer role . Add two new User calendar events to your admin's calendar, one with a location and one without. Follow the Data requests instructions from link1. Run the cron on your Moodle site (so the request is submitted). This is executed by navigating to your wwwroot, and running: php admin/cli/cron.php Follow the Responding to data requests instructions from link1, and approve your request. Run the cron on your moodle site again, using the command mentionded above. (this completes the approval). On the top right of the page, click the admin user's name, and then click Profile in the dropdown. Under Privacy and policies , click Data requests . Your recent request should apper with the Complete status. On that row, click Actions , and then Download from the dropdown. Save the export.zip file. Open the zip file, find the "User {Admin User n}/Calendar/Events" folder. This will list folders for each date/time where a user calendar exists. Find and open the entries for the two User calendar events you created for this test. CONFIRM the details match your calendar entries (in particular, that the location field exists for both, matches your entry for location, and has empty string where you did not enter a location).