mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-25 08:12:40 +01:00
21de2b1a0c
Summary: Ref T4379. I want project subscriptions to work like this (yell if this seems whacky, since it makes subscriptions mean somethign a little different for projects than they do for other objects): - You can only subscribe to a project if you're a project member. - When you're added as a member, you're added as a subscriber. - When you're removed as a member, you're removed as a subscriber. - While you're a member, you can optionally unsubscribe. From a UI perspective: - We don't show the subscriber list, since it's going to be some uninteresting subset of the member list. - We don't show CC transactions in history, since they're an uninteresting near-approximation of the membership transactions. - You only see the subscription controls if you're a member. To do this, I've augmented `PhabricatorSubscribableInterface` with two new methods. It would be nice if we were on PHP 5.4+ and could just use traits for this, but we should get data about version usage before we think about this. For now, copy/paste the default implementations into every implementing class. Then, I implemented the interface in `PhabricatorProject` but with alternate defaults. Test Plan: - Used the normal interaction on existing objects. - This has no actual effect on projects, verified no subscription stuff mysteriously appeared. - Hit the new error case by fiddling with the UI. Reviewers: btrahan Reviewed By: btrahan CC: chad, aran Maniphest Tasks: T4379 Differential Revision: https://secure.phabricator.com/D8165
156 lines
4 KiB
PHP
156 lines
4 KiB
PHP
<?php
|
|
|
|
final class LegalpadDocument extends LegalpadDAO
|
|
implements
|
|
PhabricatorPolicyInterface,
|
|
PhabricatorSubscribableInterface,
|
|
PhabricatorApplicationTransactionInterface {
|
|
|
|
protected $title;
|
|
protected $contributorCount;
|
|
protected $recentContributorPHIDs = array();
|
|
protected $creatorPHID;
|
|
protected $versions;
|
|
protected $documentBodyPHID;
|
|
protected $viewPolicy;
|
|
protected $editPolicy;
|
|
protected $mailKey;
|
|
|
|
private $documentBody = self::ATTACHABLE;
|
|
private $contributors = self::ATTACHABLE;
|
|
private $signatures = self::ATTACHABLE;
|
|
|
|
public static function initializeNewDocument(PhabricatorUser $actor) {
|
|
$app = id(new PhabricatorApplicationQuery())
|
|
->setViewer($actor)
|
|
->withClasses(array('PhabricatorApplicationLegalpad'))
|
|
->executeOne();
|
|
|
|
$view_policy = $app->getPolicy(LegalpadCapabilityDefaultView::CAPABILITY);
|
|
$edit_policy = $app->getPolicy(LegalpadCapabilityDefaultEdit::CAPABILITY);
|
|
|
|
return id(new LegalpadDocument())
|
|
->setVersions(0)
|
|
->setCreatorPHID($actor->getPHID())
|
|
->setContributorCount(0)
|
|
->setRecentContributorPHIDs(array())
|
|
->attachSignatures(array())
|
|
->setViewPolicy($view_policy)
|
|
->setEditPolicy($edit_policy);
|
|
}
|
|
|
|
public function getConfiguration() {
|
|
return array(
|
|
self::CONFIG_AUX_PHID => true,
|
|
self::CONFIG_SERIALIZATION => array(
|
|
'recentContributorPHIDs' => self::SERIALIZATION_JSON,
|
|
),
|
|
) + parent::getConfiguration();
|
|
}
|
|
|
|
public function generatePHID() {
|
|
return PhabricatorPHID::generateNewPHID(
|
|
PhabricatorLegalpadPHIDTypeDocument::TYPECONST);
|
|
}
|
|
|
|
public function getDocumentBody() {
|
|
return $this->assertAttached($this->documentBody);
|
|
}
|
|
|
|
public function attachDocumentBody(LegalpadDocumentBody $body) {
|
|
$this->documentBody = $body;
|
|
return $this;
|
|
}
|
|
|
|
public function getContributors() {
|
|
return $this->assertAttached($this->contributors);
|
|
}
|
|
|
|
public function attachContributors(array $contributors) {
|
|
$this->contributors = $contributors;
|
|
return $this;
|
|
}
|
|
|
|
public function getSignatures() {
|
|
return $this->assertAttached($this->signatures);
|
|
}
|
|
|
|
public function attachSignatures(array $signatures) {
|
|
$this->signatures = $signatures;
|
|
return $this;
|
|
}
|
|
|
|
public function save() {
|
|
if (!$this->getMailKey()) {
|
|
$this->setMailKey(Filesystem::readRandomCharacters(20));
|
|
}
|
|
return parent::save();
|
|
}
|
|
|
|
public function getMonogram() {
|
|
return 'L'.$this->getID();
|
|
}
|
|
|
|
|
|
/* -( PhabricatorSubscribableInterface )----------------------------------- */
|
|
|
|
|
|
public function isAutomaticallySubscribed($phid) {
|
|
return ($this->creatorPHID == $phid);
|
|
}
|
|
|
|
public function shouldShowSubscribersProperty() {
|
|
return true;
|
|
}
|
|
|
|
public function shouldAllowSubscription($phid) {
|
|
return true;
|
|
}
|
|
|
|
|
|
/* -( PhabricatorPolicyInterface )----------------------------------------- */
|
|
|
|
|
|
public function getCapabilities() {
|
|
return array(
|
|
PhabricatorPolicyCapability::CAN_VIEW,
|
|
PhabricatorPolicyCapability::CAN_EDIT,
|
|
);
|
|
}
|
|
|
|
public function getPolicy($capability) {
|
|
switch ($capability) {
|
|
case PhabricatorPolicyCapability::CAN_VIEW:
|
|
$policy = $this->viewPolicy;
|
|
break;
|
|
case PhabricatorPolicyCapability::CAN_EDIT:
|
|
$policy = $this->editPolicy;
|
|
break;
|
|
default:
|
|
$policy = PhabricatorPolicies::POLICY_NOONE;
|
|
break;
|
|
}
|
|
return $policy;
|
|
}
|
|
|
|
public function hasAutomaticCapability($capability, PhabricatorUser $user) {
|
|
return ($user->getPHID() == $this->getCreatorPHID());
|
|
}
|
|
|
|
public function describeAutomaticCapability($capability) {
|
|
return pht(
|
|
'The author of a document can always view and edit it.');
|
|
}
|
|
|
|
|
|
/* -( PhabricatorApplicationTransactionInterface )------------------------- */
|
|
|
|
public function getApplicationTransactionEditor() {
|
|
return new LegalpadDocumentEditor();
|
|
}
|
|
|
|
public function getApplicationTransactionObject() {
|
|
return new LegalpadTransaction();
|
|
}
|
|
|
|
}
|