. /** * Behat message-related steps definitions. * * @package core_message * @category test * @copyright 2013 David MonllaĆ³ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ // NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php. require_once(__DIR__ . '/../../../lib/behat/behat_base.php'); /** * Messaging system steps definitions. * * @package core_message * @category test * @copyright 2013 David MonllaĆ³ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class behat_message extends behat_base { /** * Open the messaging UI. * * @Given /^I open messaging$/ */ public function i_open_messaging() { // Visit home page and follow messages. $this->execute("behat_general::i_am_on_homepage"); $this->execute("behat_general::i_click_on", [get_string('togglemessagemenu', 'core_message'), 'link']); } /** * Open the messaging conversation list. * * @Given /^I open the "(?P(?:[^"]|\\")*)" conversations list/ * @param string $tab */ public function i_open_the_conversations_list(string $tab) { $this->execute('behat_general::i_click_on', [ $this->escape($tab), 'group_message_tab' ]); } /** * Open the messaging UI. * * @Given /^I open messaging information$/ */ public function i_open_messaging_information() { $this->execute('behat_general::i_click_on', ["[data-action='view-group-info']", 'css_element']); } /** * View the contact information of a user in the messages ui. * * @Given /^I view the "(?P(?:[^"]|\\")*)" contact in the message area$/ * @param string $userfullname */ public function i_view_contact_in_messages($userfullname) { // Visit home page and follow messages. $this->i_select_user_in_messaging($userfullname); $this->execute('behat_general::i_click_on_in_the', array( "//a[@data-action='view-contact']", "xpath_element", "//*[@data-region='message-drawer']//div[@data-region='header-container']", "xpath_element", ) ); $this->execute('behat_general::i_click_on_in_the', array( "//img[@title='Picture of ". $this->escape($userfullname) . "']", "xpath_element", "//*[@data-region='message-drawer']//*[@data-region='view-contact']", "xpath_element", ) ); $this->execute('behat_general::wait_until_the_page_is_ready'); } /** * Select a user in the messaging UI. * * @Given /^I select "(?P(?:[^"]|\\")*)" user in messaging$/ * @param string $userfullname */ public function i_select_user_in_messaging($userfullname) { $this->i_open_messaging(); $this->i_search_for_string_in_messaging($userfullname); // Need to limit the click to the search results because the 'view-contact-profile' elements // can occur in two separate divs on the page. $this->execute('behat_general::i_click_on_in_the', [ $this->escape($userfullname), 'link', "[data-region='message-drawer'] [data-region='search-results-container']", "css_element", ] ); $this->execute('behat_general::wait_until_the_page_is_ready'); } /** * Search for a string using the messaging search. * * @Given /^I search for "(?P(?:[^"]|\\")*)" in messaging$/ * @param string $string the search string. */ public function i_search_for_string_in_messaging($string) { $this->execute('behat_general::i_click_on', [get_string('search', 'core'), 'field']); $this->execute('behat_forms::i_set_the_field_with_xpath_to', [ "//*[@data-region='message-drawer']//input[@data-region='search-input']", $this->escape($string) ] ); $this->execute('behat_general::i_click_on', ['[data-action="search"]', 'css_element']); $this->execute('behat_general::wait_until_the_page_is_ready'); } /** * Sends a message to the specified user from the logged user. The user full name should contain the first and last names. * * @Given /^I send "(?P(?:[^"]|\\")*)" message to "(?P(?:[^"]|\\")*)" user$/ * @param string $messagecontent * @param string $userfullname */ public function i_send_message_to_user($messagecontent, $userfullname) { $this->i_select_user_in_messaging($userfullname); $this->execute('behat_forms::i_set_the_field_with_xpath_to', array("//textarea[@data-region='send-message-txt']", $this->escape($messagecontent)) ); $this->execute('behat_general::i_click_on_in_the', [ '[data-action="send-message"]', 'css_element', "[data-region='message-drawer'] [data-region='footer-container'] [data-region='view-conversation']", "css_element", ] ); } /** * Select messages from a user in the messaging ui. * * @Given /^I send "(?P(?:[^"]|\\")*)" message in the message area$/ * @param string $messagecontent */ public function i_send_message_in_the_message_area($messagecontent) { $this->execute('behat_general::wait_until_the_page_is_ready'); $this->execute('behat_forms::i_set_the_field_with_xpath_to', array("//textarea[@data-region='send-message-txt']", $this->escape($messagecontent)) ); $this->execute("behat_forms::press_button", get_string('sendmessage', 'message')); } /** * Navigate back in the messages ui drawer. * * @Given /^I go back in "(?P(?:[^"]|\\")*)" message drawer$/ * @param string $parentelement */ public function i_go_back_in_message_drawer($parentelement) { $this->execute('behat_general::i_click_on_in_the', array( 'a[data-route-back]', 'css_element', '[data-region="'.$this->escape($parentelement).'"]', 'css_element', ) ); } /** * Select a user in the messaging UI. * * @Given /^I select "(?P(?:[^"]|\\")*)" conversation in messaging$/ * @param string $conversationname */ public function i_select_conversation_in_messaging($conversationname) { $this->execute('behat_general::i_click_on', array( $this->escape($conversationname), 'group_message', ) ); } /** * Open the contact menu. * * @Given /^I open contact menu$/ */ public function i_open_contact_menu() { $this->execute('behat_general::wait_until_the_page_is_ready'); $this->execute('behat_general::i_click_on_in_the', array( 'button', 'css_element', '[data-region="message-drawer"] [data-region="header-container"]', 'css_element', ) ); } /** * Select a user in a specific messaging UI conversations list. * * @Given /^I select "(?P(?:[^"]|\\")*)" conversation in the "(?P(?:[^"]|\\")*)" conversations list$/ * @param string $convname * @param string $listname */ public function i_select_conversation_in_the_conversations_list(string $convname, string $listname) { $xpath = '//*[@data-region="message-drawer"]//div[@data-region="view-overview-'. $this->escape($listname). '"]//*[@data-conversation-id]//img[contains(@alt,"'. $this->escape($convname).'")]'; $this->execute('behat_general::i_click_on', array($xpath, 'xpath_element')); } /** * Open the settings preferences. * * @Given /^I open messaging settings preferences$/ */ public function i_open_messaging_settings_preferences() { $this->execute('behat_general::wait_until_the_page_is_ready'); $this->execute('behat_general::i_click_on', array( '//*[@data-region="message-drawer"]//a[@data-route="view-settings"]', 'xpath_element', '', '', ) ); } }