Extract locators and steps for sharing in Files app to their own context

Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>

3 files changed, 519 insertions, 489 deletions

diff --git a/tests/acceptance/config/behat.yml b/tests/acceptance/config/behat.yml
index 3108ea41407..7d64e6a207c 100644
--- a/tests/acceptance/config/behat.yml
+++ b/tests/acceptance/config/behat.yml
@@ -16,6 +16,7 @@ default:
         - FeatureContext
         - FileListContext
         - FilesAppContext
+        - FilesAppSharingContext
         - FilesSharingAppContext
         - LoginPageContext
         - NotificationContext
@@ -42,6 +43,7 @@ default:
         - FeatureContext
         - FileListContext
         - FilesAppContext
+        - FilesAppSharingContext
         - FilesSharingAppContext
         - LoginPageContext
         - NotificationContext
diff --git a/tests/acceptance/features/bootstrap/FilesAppContext.php b/tests/acceptance/features/bootstrap/FilesAppContext.php
index b6c4e465ecb..880303fe1d6 100644
--- a/tests/acceptance/features/bootstrap/FilesAppContext.php
+++ b/tests/acceptance/features/bootstrap/FilesAppContext.php
@@ -229,221 +229,6 @@ class FilesAppContext implements Context, ActorAwareInterface {
 	}
 
 	/**
-	 * @return Locator
-	 */
-	public static function sharedByLabel() {
-		return Locator::forThe()->css(".reshare")->
-				descendantOf(self::detailsView())->
-				describedAs("Shared by label in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareWithInput() {
-		return Locator::forThe()->css(".shareWithField")->
-				descendantOf(self::detailsView())->
-				describedAs("Share with input in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareeList() {
-		return Locator::forThe()->css(".shareeListView")->
-				descendantOf(self::detailsView())->
-				describedAs("Sharee list in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function sharedWithRow($sharedWithName) {
-		// "username" class is used for any type of share, not only for shares
-		// with users.
-		return Locator::forThe()->xpath("//span[contains(concat(' ', normalize-space(@class), ' '), ' username ') and normalize-space() = '$sharedWithName']/ancestor::li")->
-				descendantOf(self::shareeList())->
-				describedAs("Shared with $sharedWithName row in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareWithMenuButton($sharedWithName) {
-		return Locator::forThe()->css(".share-menu > .icon")->
-				descendantOf(self::sharedWithRow($sharedWithName))->
-				describedAs("Share with $sharedWithName menu button in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareWithMenu($sharedWithName) {
-		return Locator::forThe()->css(".share-menu > .menu")->
-				descendantOf(self::sharedWithRow($sharedWithName))->
-				describedAs("Share with $sharedWithName menu in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function canReshareCheckbox($sharedWithName) {
-		// forThe()->checkbox("Can reshare") can not be used here; that would
-		// return the checkbox itself, but the element that the user interacts
-		// with is the label.
-		return Locator::forThe()->xpath("//label[normalize-space() = 'Can reshare']")->
-				descendantOf(self::shareWithMenu($sharedWithName))->
-				describedAs("Can reshare checkbox in the share with $sharedWithName menu in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function canReshareCheckboxInput($sharedWithName) {
-		return Locator::forThe()->checkbox("Can reshare")->
-				descendantOf(self::shareWithMenu($sharedWithName))->
-				describedAs("Can reshare checkbox input in the share with $sharedWithName menu in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareLinkRow() {
-		return Locator::forThe()->css(".linkShareView .shareWithList:first-child")->
-				descendantOf(self::detailsView())->
-				describedAs("Share link row in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareLinkAddNewButton() {
-		// When there is no link share the "Add new share" item is shown instead
-		// of the menu button as a direct child of ".share-menu".
-		return Locator::forThe()->css(".share-menu > .new-share")->
-				descendantOf(self::shareLinkRow())->
-				describedAs("Add new share link button in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function copyLinkButton() {
-		return Locator::forThe()->css("a.clipboard-button")->
-				descendantOf(self::shareLinkRow())->
-				describedAs("Copy link button in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareLinkMenuButton() {
-		return Locator::forThe()->css(".share-menu > .icon")->
-				descendantOf(self::shareLinkRow())->
-				describedAs("Share link menu button in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function shareLinkMenu() {
-		return Locator::forThe()->css(".share-menu > .menu")->
-				descendantOf(self::shareLinkRow())->
-				describedAs("Share link menu in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function hideDownloadCheckbox() {
-		// forThe()->checkbox("Hide download") can not be used here; that would
-		// return the checkbox itself, but the element that the user interacts
-		// with is the label.
-		return Locator::forThe()->xpath("//label[normalize-space() = 'Hide download']")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Hide download checkbox in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function hideDownloadCheckboxInput() {
-		return Locator::forThe()->checkbox("Hide download")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Hide download checkbox input in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function allowUploadAndEditingRadioButton() {
-		// forThe()->radio("Allow upload and editing") can not be used here;
-		// that would return the radio button itself, but the element that the
-		// user interacts with is the label.
-		return Locator::forThe()->xpath("//label[normalize-space() = 'Allow upload and editing']")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Allow upload and editing radio button in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectCheckbox() {
-		// forThe()->checkbox("Password protect") can not be used here; that
-		// would return the checkbox itself, but the element that the user
-		// interacts with is the label.
-		return Locator::forThe()->xpath("//label[normalize-space() = 'Password protect']")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect checkbox in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectCheckboxInput() {
-		return Locator::forThe()->checkbox("Password protect")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect checkbox input in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectField() {
-		return Locator::forThe()->css(".linkPassText")->descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect field in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectWorkingIcon() {
-		return Locator::forThe()->css(".linkPassMenu .icon-loading-small")->descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect working icon in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectByTalkCheckbox() {
-		// forThe()->checkbox("Password protect by Talk") can not be used here;
-		// that would return the checkbox itself, but the element that the user
-		// interacts with is the label.
-		return Locator::forThe()->xpath("//label[normalize-space() = 'Password protect by Talk']")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect by Talk checkbox in the details view in Files app");
-	}
-
-	/**
-	 * @return Locator
-	 */
-	public static function passwordProtectByTalkCheckboxInput() {
-		return Locator::forThe()->checkbox("Password protect by Talk")->
-				descendantOf(self::shareLinkMenu())->
-				describedAs("Password protect by Talk checkbox input in the details view in Files app");
-	}
-
-	/**
 	 * @Given I open the Files app
 	 */
 	public function iOpenTheFilesApp() {
@@ -472,44 +257,6 @@ class FilesAppContext implements Context, ActorAwareInterface {
 	}
 
 	/**
-	 * @Given I share the link for :fileName
-	 */
-	public function iShareTheLinkFor($fileName) {
-		$this->actor->find(FileListContext::shareActionForFile(self::currentSectionMainView(), $fileName), 10)->click();
-
-		$this->actor->find(self::shareLinkAddNewButton(), 5)->click();
-
-		// Wait until the menu was opened after the share creation to continue.
-		if (!WaitFor::elementToBeEventuallyShown(
-				$this->actor,
-				self::shareLinkMenu(),
-				$timeout = 5 * $this->actor->getFindTimeoutMultiplier())) {
-			PHPUnit_Framework_Assert::fail("The share link menu is not open yet after $timeout seconds");
-		}
-	}
-
-	/**
-	 * @Given I share :fileName with :shareWithName
-	 */
-	public function iShareWith($fileName, $shareWithName) {
-		$this->actor->find(FileListContext::shareActionForFile(self::currentSectionMainView(), $fileName), 10)->click();
-
-		$this->actor->find(self::shareWithInput(), 5)->setValue($shareWithName . "\r");
-	}
-
-	/**
-	 * @Given I write down the shared link
-	 */
-	public function iWriteDownTheSharedLink() {
-		$this->actor->find(self::copyLinkButton(), 10)->click();
-
-		// Clicking on the menu item copies the link to the clipboard, but it is
-		// not possible to access that value from the acceptance tests. Due to
-		// this the value of the attribute that holds the URL is used instead.
-		$this->actor->getSharedNotebook()["shared link"] = $this->actor->find(self::copyLinkButton(), 2)->getWrappedElement()->getAttribute("data-clipboard-text");
-	}
-
-	/**
 	 * @When I mark the file as favorite in the details view
 	 */
 	public function iMarkTheFileAsFavoriteInTheDetailsView() {
@@ -546,81 +293,6 @@ class FilesAppContext implements Context, ActorAwareInterface {
 	}
 
 	/**
-	 * @When I set the download of the shared link as hidden
-	 */
-	public function iSetTheDownloadOfTheSharedLinkAsHidden() {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->iSeeThatTheDownloadOfTheLinkShareIsShown();
-
-		$this->actor->find(self::hideDownloadCheckbox(), 2)->click();
-	}
-
-	/**
-	 * @When I set the download of the shared link as shown
-	 */
-	public function iSetTheDownloadOfTheSharedLinkAsShown() {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->iSeeThatTheDownloadOfTheLinkShareIsHidden();
-
-		$this->actor->find(self::hideDownloadCheckbox(), 2)->click();
-	}
-
-	/**
-	 * @When I set the shared link as editable
-	 */
-	public function iSetTheSharedLinkAsEditable() {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->actor->find(self::allowUploadAndEditingRadioButton(), 2)->click();
-	}
-
-	/**
-	 * @When I protect the shared link with the password :password
-	 */
-	public function iProtectTheSharedLinkWithThePassword($password) {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->actor->find(self::passwordProtectCheckbox(), 2)->click();
-
-		$this->actor->find(self::passwordProtectField(), 2)->setValue($password . "\r");
-	}
-
-	/**
-	 * @When I set the password of the shared link as protected by Talk
-	 */
-	public function iSetThePasswordOfTheSharedLinkAsProtectedByTalk() {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->iSeeThatThePasswordOfTheLinkShareIsNotProtectedByTalk();
-
-		$this->actor->find(self::passwordProtectByTalkCheckbox(), 2)->click();
-	}
-
-	/**
-	 * @When I set the password of the shared link as not protected by Talk
-	 */
-	public function iSetThePasswordOfTheSharedLinkAsNotProtectedByTalk() {
-		$this->showShareLinkMenuIfNeeded();
-
-		$this->iSeeThatThePasswordOfTheLinkShareIsProtectedByTalk();
-
-		$this->actor->find(self::passwordProtectByTalkCheckbox(), 2)->click();
-	}
-
-	/**
-	 * @When I set the share with :shareWithName as not reshareable
-	 */
-	public function iSetTheShareWithAsNotReshareable($shareWithName) {
-		$this->showShareWithMenuIfNeeded($shareWithName);
-
-		$this->iSeeThatCanReshareTheShare($shareWithName);
-
-		$this->actor->find(self::canReshareCheckbox($shareWithName), 2)->click();
-	}
-
-	/**
 	 * @Then I see that the current page is the Files app
 	 */
 	public function iSeeThatTheCurrentPageIsTheFilesApp() {
@@ -741,165 +413,4 @@ class FilesAppContext implements Context, ActorAwareInterface {
 			PHPUnit_Framework_Assert::fail("The $tabName tab in the details view has not been loaded after $timeout seconds");
 		}
 	}
-
-	/**
-	 * @Then I see that the file is shared with me by :sharedByName
-	 */
-	public function iSeeThatTheFileIsSharedWithMeBy($sharedByName) {
-		PHPUnit_Framework_Assert::assertEquals(
-				$this->actor->find(self::sharedByLabel(), 10)->getText(), "Shared with you by $sharedByName");
-	}
-
-	/**
-	 * @Then I see that the file is shared with :sharedWithName
-	 */
-	public function iSeeThatTheFileIsSharedWith($sharedWithName) {
-		PHPUnit_Framework_Assert::assertTrue(
-				$this->actor->find(self::sharedWithRow($sharedWithName), 10)->isVisible());
-	}
-
-	/**
-	 * @Then I see that resharing the file is not allowed
-	 */
-	public function iSeeThatResharingTheFileIsNotAllowed() {
-		PHPUnit_Framework_Assert::assertEquals(
-				$this->actor->find(self::shareWithInput(), 10)->getWrappedElement()->getAttribute("disabled"), "disabled");
-		PHPUnit_Framework_Assert::assertEquals(
-				$this->actor->find(self::shareWithInput(), 10)->getWrappedElement()->getAttribute("placeholder"), "Resharing is not allowed");
-	}
-
-	/**
-	 * @Then I see that :sharedWithName can reshare the share
-	 */
-	public function iSeeThatCanReshareTheShare($sharedWithName) {
-		$this->showShareWithMenuIfNeeded($sharedWithName);
-
-		PHPUnit_Framework_Assert::assertTrue(
-				$this->actor->find(self::canReshareCheckboxInput($sharedWithName), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that :sharedWithName can not reshare the share
-	 */
-	public function iSeeThatCanNotReshareTheShare($sharedWithName) {
-		$this->showShareWithMenuIfNeeded($sharedWithName);
-
-		PHPUnit_Framework_Assert::assertFalse(
-				$this->actor->find(self::canReshareCheckboxInput($sharedWithName), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that the download of the link share is hidden
-	 */
-	public function iSeeThatTheDownloadOfTheLinkShareIsHidden() {
-		$this->showShareLinkMenuIfNeeded();
-
-		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::hideDownloadCheckboxInput(), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that the download of the link share is shown
-	 */
-	public function iSeeThatTheDownloadOfTheLinkShareIsShown() {
-		$this->showShareLinkMenuIfNeeded();
-
-		PHPUnit_Framework_Assert::assertFalse($this->actor->find(self::hideDownloadCheckboxInput(), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that the working icon for password protect is shown
-	 */
-	public function iSeeThatTheWorkingIconForPasswordProtectIsShown() {
-		PHPUnit_Framework_Assert::assertNotNull($this->actor->find(self::passwordProtectWorkingIcon(), 10));
-	}
-
-	/**
-	 * @Then I see that the working icon for password protect is eventually not shown
-	 */
-	public function iSeeThatTheWorkingIconForPasswordProtectIsEventuallyNotShown() {
-		if (!WaitFor::elementToBeEventuallyNotShown(
-				$this->actor,
-				self::passwordProtectWorkingIcon(),
-				$timeout = 10 * $this->actor->getFindTimeoutMultiplier())) {
-			PHPUnit_Framework_Assert::fail("The working icon for password protect is still shown after $timeout seconds");
-		}
-	}
-
-	/**
-	 * @Then I see that the link share is password protected
-	 */
-	public function iSeeThatTheLinkShareIsPasswordProtected() {
-		$this->showShareLinkMenuIfNeeded();
-
-		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectCheckboxInput(), 10)->isChecked(), "Password protect checkbox is checked");
-		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectField(), 10)->isVisible(), "Password protect field is visible");
-	}
-
-	/**
-	 * @Then I see that the password of the link share is protected by Talk
-	 */
-	public function iSeeThatThePasswordOfTheLinkShareIsProtectedByTalk() {
-		$this->showShareLinkMenuIfNeeded();
-
-		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectByTalkCheckboxInput(), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that the password of the link share is not protected by Talk
-	 */
-	public function iSeeThatThePasswordOfTheLinkShareIsNotProtectedByTalk() {
-		$this->showShareLinkMenuIfNeeded();
-
-		PHPUnit_Framework_Assert::assertFalse($this->actor->find(self::passwordProtectByTalkCheckboxInput(), 10)->isChecked());
-	}
-
-	/**
-	 * @Then I see that the checkbox to protect the password of the link share by Talk is not shown
-	 */
-	public function iSeeThatTheCheckboxToProtectThePasswordOfTheLinkShareByTalkIsNotShown() {
-		$this->showShareLinkMenuIfNeeded();
-
-		try {
-			PHPUnit_Framework_Assert::assertFalse(
-					$this->actor->find(self::passwordProtectByTalkCheckbox())->isVisible());
-		} catch (NoSuchElementException $exception) {
-		}
-	}
-
-	/**
-	 * @Given I share the link for :fileName protected by the password :password
-	 */
-	public function iShareTheLinkForProtectedByThePassword($fileName, $password) {
-		$this->iShareTheLinkFor($fileName);
-		$this->iProtectTheSharedLinkWithThePassword($password);
-		$this->iSeeThatTheWorkingIconForPasswordProtectIsShown();
-		$this->iSeeThatTheWorkingIconForPasswordProtectIsEventuallyNotShown();
-	}
-
-	private function showShareLinkMenuIfNeeded() {
-		// In some cases the share menu is hidden after clicking on an action of
-		// the menu. Therefore, if the menu is visible, wait a little just in
-		// case it is in the process of being hidden due to a previous action,
-		// in which case it is shown again.
-		if (WaitFor::elementToBeEventuallyNotShown(
-				$this->actor,
-				self::shareLinkMenu(),
-				$timeout = 2 * $this->actor->getFindTimeoutMultiplier())) {
-			$this->actor->find(self::shareLinkMenuButton(), 10)->click();
-		}
-	}
-
-	private function showShareWithMenuIfNeeded($shareWithName) {
-		// In some cases the share menu is hidden after clicking on an action of
-		// the menu. Therefore, if the menu is visible, wait a little just in
-		// case it is in the process of being hidden due to a previous action,
-		// in which case it is shown again.
-		if (WaitFor::elementToBeEventuallyNotShown(
-				$this->actor,
-				self::shareWithMenu($shareWithName),
-				$timeout = 2 * $this->actor->getFindTimeoutMultiplier())) {
-			$this->actor->find(self::shareWithMenuButton($shareWithName), 10)->click();
-		}
-	}
-
 }
diff --git a/tests/acceptance/features/bootstrap/FilesAppSharingContext.php b/tests/acceptance/features/bootstrap/FilesAppSharingContext.php
new file mode 100644
index 00000000000..4ae8659d2d1
--- /dev/null
+++ b/tests/acceptance/features/bootstrap/FilesAppSharingContext.php
@@ -0,0 +1,517 @@
+<?php
+
+/**
+ *
+ * @copyright Copyright (c) 2018, Daniel Calviño Sánchez (danxuliu@gmail.com)
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+
+use Behat\Behat\Context\Context;
+
+class FilesAppSharingContext implements Context, ActorAwareInterface {
+
+	use ActorAware;
+
+	/**
+	 * @return Locator
+	 */
+	public static function sharedByLabel() {
+		return Locator::forThe()->css(".reshare")->
+				descendantOf(FilesAppContext::detailsView())->
+				describedAs("Shared by label in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareWithInput() {
+		return Locator::forThe()->css(".shareWithField")->
+				descendantOf(FilesAppContext::detailsView())->
+				describedAs("Share with input in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareeList() {
+		return Locator::forThe()->css(".shareeListView")->
+				descendantOf(FilesAppContext::detailsView())->
+				describedAs("Sharee list in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function sharedWithRow($sharedWithName) {
+		// "username" class is used for any type of share, not only for shares
+		// with users.
+		return Locator::forThe()->xpath("//span[contains(concat(' ', normalize-space(@class), ' '), ' username ') and normalize-space() = '$sharedWithName']/ancestor::li")->
+				descendantOf(self::shareeList())->
+				describedAs("Shared with $sharedWithName row in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareWithMenuButton($sharedWithName) {
+		return Locator::forThe()->css(".share-menu > .icon")->
+				descendantOf(self::sharedWithRow($sharedWithName))->
+				describedAs("Share with $sharedWithName menu button in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareWithMenu($sharedWithName) {
+		return Locator::forThe()->css(".share-menu > .menu")->
+				descendantOf(self::sharedWithRow($sharedWithName))->
+				describedAs("Share with $sharedWithName menu in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function canReshareCheckbox($sharedWithName) {
+		// forThe()->checkbox("Can reshare") can not be used here; that would
+		// return the checkbox itself, but the element that the user interacts
+		// with is the label.
+		return Locator::forThe()->xpath("//label[normalize-space() = 'Can reshare']")->
+				descendantOf(self::shareWithMenu($sharedWithName))->
+				describedAs("Can reshare checkbox in the share with $sharedWithName menu in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function canReshareCheckboxInput($sharedWithName) {
+		return Locator::forThe()->checkbox("Can reshare")->
+				descendantOf(self::shareWithMenu($sharedWithName))->
+				describedAs("Can reshare checkbox input in the share with $sharedWithName menu in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareLinkRow() {
+		return Locator::forThe()->css(".linkShareView .shareWithList:first-child")->
+				descendantOf(FilesAppContext::detailsView())->
+				describedAs("Share link row in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareLinkAddNewButton() {
+		// When there is no link share the "Add new share" item is shown instead
+		// of the menu button as a direct child of ".share-menu".
+		return Locator::forThe()->css(".share-menu > .new-share")->
+				descendantOf(self::shareLinkRow())->
+				describedAs("Add new share link button in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function copyLinkButton() {
+		return Locator::forThe()->css("a.clipboard-button")->
+				descendantOf(self::shareLinkRow())->
+				describedAs("Copy link button in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareLinkMenuButton() {
+		return Locator::forThe()->css(".share-menu > .icon")->
+				descendantOf(self::shareLinkRow())->
+				describedAs("Share link menu button in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function shareLinkMenu() {
+		return Locator::forThe()->css(".share-menu > .menu")->
+				descendantOf(self::shareLinkRow())->
+				describedAs("Share link menu in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function hideDownloadCheckbox() {
+		// forThe()->checkbox("Hide download") can not be used here; that would
+		// return the checkbox itself, but the element that the user interacts
+		// with is the label.
+		return Locator::forThe()->xpath("//label[normalize-space() = 'Hide download']")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Hide download checkbox in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function hideDownloadCheckboxInput() {
+		return Locator::forThe()->checkbox("Hide download")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Hide download checkbox input in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function allowUploadAndEditingRadioButton() {
+		// forThe()->radio("Allow upload and editing") can not be used here;
+		// that would return the radio button itself, but the element that the
+		// user interacts with is the label.
+		return Locator::forThe()->xpath("//label[normalize-space() = 'Allow upload and editing']")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Allow upload and editing radio button in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectCheckbox() {
+		// forThe()->checkbox("Password protect") can not be used here; that
+		// would return the checkbox itself, but the element that the user
+		// interacts with is the label.
+		return Locator::forThe()->xpath("//label[normalize-space() = 'Password protect']")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect checkbox in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectCheckboxInput() {
+		return Locator::forThe()->checkbox("Password protect")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect checkbox input in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectField() {
+		return Locator::forThe()->css(".linkPassText")->descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect field in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectWorkingIcon() {
+		return Locator::forThe()->css(".linkPassMenu .icon-loading-small")->descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect working icon in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectByTalkCheckbox() {
+		// forThe()->checkbox("Password protect by Talk") can not be used here;
+		// that would return the checkbox itself, but the element that the user
+		// interacts with is the label.
+		return Locator::forThe()->xpath("//label[normalize-space() = 'Password protect by Talk']")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect by Talk checkbox in the details view in Files app");
+	}
+
+	/**
+	 * @return Locator
+	 */
+	public static function passwordProtectByTalkCheckboxInput() {
+		return Locator::forThe()->checkbox("Password protect by Talk")->
+				descendantOf(self::shareLinkMenu())->
+				describedAs("Password protect by Talk checkbox input in the details view in Files app");
+	}
+
+	/**
+	 * @Given I share the link for :fileName
+	 */
+	public function iShareTheLinkFor($fileName) {
+		$this->actor->find(FileListContext::shareActionForFile(FilesAppContext::currentSectionMainView(), $fileName), 10)->click();
+
+		$this->actor->find(self::shareLinkAddNewButton(), 5)->click();
+
+		// Wait until the menu was opened after the share creation to continue.
+		if (!WaitFor::elementToBeEventuallyShown(
+				$this->actor,
+				self::shareLinkMenu(),
+				$timeout = 5 * $this->actor->getFindTimeoutMultiplier())) {
+			PHPUnit_Framework_Assert::fail("The share link menu is not open yet after $timeout seconds");
+		}
+	}
+
+	/**
+	 * @Given I share :fileName with :shareWithName
+	 */
+	public function iShareWith($fileName, $shareWithName) {
+		$this->actor->find(FileListContext::shareActionForFile(FilesAppContext::currentSectionMainView(), $fileName), 10)->click();
+
+		$this->actor->find(self::shareWithInput(), 5)->setValue($shareWithName . "\r");
+	}
+
+	/**
+	 * @Given I write down the shared link
+	 */
+	public function iWriteDownTheSharedLink() {
+		$this->actor->find(self::copyLinkButton(), 10)->click();
+
+		// Clicking on the menu item copies the link to the clipboard, but it is
+		// not possible to access that value from the acceptance tests. Due to
+		// this the value of the attribute that holds the URL is used instead.
+		$this->actor->getSharedNotebook()["shared link"] = $this->actor->find(self::copyLinkButton(), 2)->getWrappedElement()->getAttribute("data-clipboard-text");
+	}
+
+	/**
+	 * @When I set the download of the shared link as hidden
+	 */
+	public function iSetTheDownloadOfTheSharedLinkAsHidden() {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->iSeeThatTheDownloadOfTheLinkShareIsShown();
+
+		$this->actor->find(self::hideDownloadCheckbox(), 2)->click();
+	}
+
+	/**
+	 * @When I set the download of the shared link as shown
+	 */
+	public function iSetTheDownloadOfTheSharedLinkAsShown() {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->iSeeThatTheDownloadOfTheLinkShareIsHidden();
+
+		$this->actor->find(self::hideDownloadCheckbox(), 2)->click();
+	}
+
+	/**
+	 * @When I set the shared link as editable
+	 */
+	public function iSetTheSharedLinkAsEditable() {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->actor->find(self::allowUploadAndEditingRadioButton(), 2)->click();
+	}
+
+	/**
+	 * @When I protect the shared link with the password :password
+	 */
+	public function iProtectTheSharedLinkWithThePassword($password) {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->actor->find(self::passwordProtectCheckbox(), 2)->click();
+
+		$this->actor->find(self::passwordProtectField(), 2)->setValue($password . "\r");
+	}
+
+	/**
+	 * @When I set the password of the shared link as protected by Talk
+	 */
+	public function iSetThePasswordOfTheSharedLinkAsProtectedByTalk() {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->iSeeThatThePasswordOfTheLinkShareIsNotProtectedByTalk();
+
+		$this->actor->find(self::passwordProtectByTalkCheckbox(), 2)->click();
+	}
+
+	/**
+	 * @When I set the password of the shared link as not protected by Talk
+	 */
+	public function iSetThePasswordOfTheSharedLinkAsNotProtectedByTalk() {
+		$this->showShareLinkMenuIfNeeded();
+
+		$this->iSeeThatThePasswordOfTheLinkShareIsProtectedByTalk();
+
+		$this->actor->find(self::passwordProtectByTalkCheckbox(), 2)->click();
+	}
+
+	/**
+	 * @When I set the share with :shareWithName as not reshareable
+	 */
+	public function iSetTheShareWithAsNotReshareable($shareWithName) {
+		$this->showShareWithMenuIfNeeded($shareWithName);
+
+		$this->iSeeThatCanReshareTheShare($shareWithName);
+
+		$this->actor->find(self::canReshareCheckbox($shareWithName), 2)->click();
+	}
+
+	/**
+	 * @Then I see that the file is shared with me by :sharedByName
+	 */
+	public function iSeeThatTheFileIsSharedWithMeBy($sharedByName) {
+		PHPUnit_Framework_Assert::assertEquals(
+				$this->actor->find(self::sharedByLabel(), 10)->getText(), "Shared with you by $sharedByName");
+	}
+
+	/**
+	 * @Then I see that the file is shared with :sharedWithName
+	 */
+	public function iSeeThatTheFileIsSharedWith($sharedWithName) {
+		PHPUnit_Framework_Assert::assertTrue(
+				$this->actor->find(self::sharedWithRow($sharedWithName), 10)->isVisible());
+	}
+
+	/**
+	 * @Then I see that resharing the file is not allowed
+	 */
+	public function iSeeThatResharingTheFileIsNotAllowed() {
+		PHPUnit_Framework_Assert::assertEquals(
+				$this->actor->find(self::shareWithInput(), 10)->getWrappedElement()->getAttribute("disabled"), "disabled");
+		PHPUnit_Framework_Assert::assertEquals(
+				$this->actor->find(self::shareWithInput(), 10)->getWrappedElement()->getAttribute("placeholder"), "Resharing is not allowed");
+	}
+
+	/**
+	 * @Then I see that :sharedWithName can reshare the share
+	 */
+	public function iSeeThatCanReshareTheShare($sharedWithName) {
+		$this->showShareWithMenuIfNeeded($sharedWithName);
+
+		PHPUnit_Framework_Assert::assertTrue(
+				$this->actor->find(self::canReshareCheckboxInput($sharedWithName), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that :sharedWithName can not reshare the share
+	 */
+	public function iSeeThatCanNotReshareTheShare($sharedWithName) {
+		$this->showShareWithMenuIfNeeded($sharedWithName);
+
+		PHPUnit_Framework_Assert::assertFalse(
+				$this->actor->find(self::canReshareCheckboxInput($sharedWithName), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that the download of the link share is hidden
+	 */
+	public function iSeeThatTheDownloadOfTheLinkShareIsHidden() {
+		$this->showShareLinkMenuIfNeeded();
+
+		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::hideDownloadCheckboxInput(), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that the download of the link share is shown
+	 */
+	public function iSeeThatTheDownloadOfTheLinkShareIsShown() {
+		$this->showShareLinkMenuIfNeeded();
+
+		PHPUnit_Framework_Assert::assertFalse($this->actor->find(self::hideDownloadCheckboxInput(), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that the working icon for password protect is shown
+	 */
+	public function iSeeThatTheWorkingIconForPasswordProtectIsShown() {
+		PHPUnit_Framework_Assert::assertNotNull($this->actor->find(self::passwordProtectWorkingIcon(), 10));
+	}
+
+	/**
+	 * @Then I see that the working icon for password protect is eventually not shown
+	 */
+	public function iSeeThatTheWorkingIconForPasswordProtectIsEventuallyNotShown() {
+		if (!WaitFor::elementToBeEventuallyNotShown(
+				$this->actor,
+				self::passwordProtectWorkingIcon(),
+				$timeout = 10 * $this->actor->getFindTimeoutMultiplier())) {
+			PHPUnit_Framework_Assert::fail("The working icon for password protect is still shown after $timeout seconds");
+		}
+	}
+
+	/**
+	 * @Then I see that the link share is password protected
+	 */
+	public function iSeeThatTheLinkShareIsPasswordProtected() {
+		$this->showShareLinkMenuIfNeeded();
+
+		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectCheckboxInput(), 10)->isChecked(), "Password protect checkbox is checked");
+		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectField(), 10)->isVisible(), "Password protect field is visible");
+	}
+
+	/**
+	 * @Then I see that the password of the link share is protected by Talk
+	 */
+	public function iSeeThatThePasswordOfTheLinkShareIsProtectedByTalk() {
+		$this->showShareLinkMenuIfNeeded();
+
+		PHPUnit_Framework_Assert::assertTrue($this->actor->find(self::passwordProtectByTalkCheckboxInput(), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that the password of the link share is not protected by Talk
+	 */
+	public function iSeeThatThePasswordOfTheLinkShareIsNotProtectedByTalk() {
+		$this->showShareLinkMenuIfNeeded();
+
+		PHPUnit_Framework_Assert::assertFalse($this->actor->find(self::passwordProtectByTalkCheckboxInput(), 10)->isChecked());
+	}
+
+	/**
+	 * @Then I see that the checkbox to protect the password of the link share by Talk is not shown
+	 */
+	public function iSeeThatTheCheckboxToProtectThePasswordOfTheLinkShareByTalkIsNotShown() {
+		$this->showShareLinkMenuIfNeeded();
+
+		try {
+			PHPUnit_Framework_Assert::assertFalse(
+					$this->actor->find(self::passwordProtectByTalkCheckbox())->isVisible());
+		} catch (NoSuchElementException $exception) {
+		}
+	}
+
+	/**
+	 * @Given I share the link for :fileName protected by the password :password
+	 */
+	public function iShareTheLinkForProtectedByThePassword($fileName, $password) {
+		$this->iShareTheLinkFor($fileName);
+		$this->iProtectTheSharedLinkWithThePassword($password);
+		$this->iSeeThatTheWorkingIconForPasswordProtectIsShown();
+		$this->iSeeThatTheWorkingIconForPasswordProtectIsEventuallyNotShown();
+	}
+
+	private function showShareLinkMenuIfNeeded() {
+		// In some cases the share menu is hidden after clicking on an action of
+		// the menu. Therefore, if the menu is visible, wait a little just in
+		// case it is in the process of being hidden due to a previous action,
+		// in which case it is shown again.
+		if (WaitFor::elementToBeEventuallyNotShown(
+				$this->actor,
+				self::shareLinkMenu(),
+				$timeout = 2 * $this->actor->getFindTimeoutMultiplier())) {
+			$this->actor->find(self::shareLinkMenuButton(), 10)->click();
+		}
+	}
+
+	private function showShareWithMenuIfNeeded($shareWithName) {
+		// In some cases the share menu is hidden after clicking on an action of
+		// the menu. Therefore, if the menu is visible, wait a little just in
+		// case it is in the process of being hidden due to a previous action,
+		// in which case it is shown again.
+		if (WaitFor::elementToBeEventuallyNotShown(
+				$this->actor,
+				self::shareWithMenu($shareWithName),
+				$timeout = 2 * $this->actor->getFindTimeoutMultiplier())) {
+			$this->actor->find(self::shareWithMenuButton($shareWithName), 10)->click();
+		}
+	}
+}