Messaging: Update the message APIs allowing teachers to send 1:1 messages to students, regardless of their messaging prefs.

It should be covered by PHPUnit tests. However, here there are also some manual tests. This should be integrated/tested at the same time (or later) than MDL-63214 . Setup Login as admin Create 2 new courses Course 1 Course 2 Create 4 new users user1 user2 user3 teacher1 Enrol user1 and user2 as students on the 'Course 1' Enrol teacher1 as a  teacher to the 'Course 1' Enrol user3 and teacher1 as students to the 'Course 2' Login as user1 Access to the teacher1 profile page (from the course participants page) and block him as a contact following these steps: Click on the 'Message' icon near to the teacher name Click on the teacher name you'll find at the top of the message area (above the Online/Offline text) Click on the 'Block contact' link Login as user2 Set the messaging preference to 'My contacts only' Login as user3 Set the messaging preference to 'My contacts only' Testing scenario 1: Send 1:1 message as a teacher Login as teacher1 Navigate to Course 1 => Participants => user1 Click the Message link at the top of the profile Send a message Confirm that the message is sent Navigate to Course 1 => Participants => user2 Click the Message link at the top of the profile Send a message Confirm that the message is sent Access to Participants list of the 'Course 2' and click over user3 Click the Message link at the top of the profile Confirm that an error was shown Testing scenario 2: Send bulk message as a teacher Login as teacher1 Navigate to Course 1 => Participants Select user1 and user2 and choose 'Send a message' from the 'With selected users...' list Write the message and click over the button to send it Login as user1 Confirm that the message was received Login as user2 Confirm that the message was received Test messaging unrelated users Login as user1 From the Message icon (next to the User menu), choose " New message " In the " Search for a user or course " field, search for "user3" Attempt to send User 3 a message Confirm that you cannot Test with site messaging for all users Navigate to Site administration => Advanced features Tick the messagingallusers setting and save changes Login as user3 From the user menu, choose Preferences Choose "Message preferences" Change the value to "Anyone on this site" Login as user1 From the Message icon (next to the User menu), choose " New message " In the " Search for a user or course " field, search for "user3" Attempt to send User 3 a message Confirm that can now send user a message