No OneTemporary
Actions

Size

6 KB

Referenced Files

None

Subscribers

None

View Options

	diff --git a/src/applications/phriction/storage/PhrictionDocument.php b/src/applications/phriction/storage/PhrictionDocument.php
	index 7bd6d057cf..c609dd5250 100644
	--- a/src/applications/phriction/storage/PhrictionDocument.php
	+++ b/src/applications/phriction/storage/PhrictionDocument.php
	@@ -1,249 +1,250 @@
	<?php

	final class PhrictionDocument extends PhrictionDAO
	implements
	PhabricatorPolicyInterface,
	PhabricatorSubscribableInterface,
	PhabricatorFlaggableInterface,
	PhabricatorTokenReceiverInterface,
	PhabricatorDestructibleInterface {

	protected $slug;
	protected $depth;
	protected $contentID;
	protected $status;
	protected $mailKey;

	private $contentObject = self::ATTACHABLE;
	private $ancestors = array();

	// TODO: This should be `self::ATTACHABLE`, but there are still a lot of call
	// sites which load PhrictionDocuments directly.
	private $project = null;

	public function getConfiguration() {
	return array(
	self::CONFIG_AUX_PHID => true,
	self::CONFIG_TIMESTAMPS => false,
	self::CONFIG_COLUMN_SCHEMA => array(
	'slug' => 'sort128',
	'depth' => 'uint32',
	'contentID' => 'id?',
	'status' => 'uint32',
	+ 'mailKey' => 'bytes20',
	),
	self::CONFIG_KEY_SCHEMA => array(
	'key_phid' => null,
	'phid' => array(
	'columns' => array('phid'),
	'unique' => true,
	),
	'slug' => array(
	'columns' => array('slug'),
	'unique' => true,
	),
	'depth' => array(
	'columns' => array('depth', 'slug'),
	'unique' => true,
	),
	),
	) + parent::getConfiguration();
	}

	public function generatePHID() {
	return PhabricatorPHID::generateNewPHID(
	PhrictionDocumentPHIDType::TYPECONST);
	}

	public static function initializeNewDocument(PhabricatorUser $actor, $slug) {
	$document = new PhrictionDocument();
	$document->setSlug($slug);

	$content = new PhrictionContent();
	$content->setSlug($slug);

	$default_title = PhabricatorSlug::getDefaultTitle($slug);
	$content->setTitle($default_title);
	$document->attachContent($content);

	return $document;
	}

	public function save() {
	if (!$this->getMailKey()) {
	$this->setMailKey(Filesystem::readRandomCharacters(20));
	}
	return parent::save();
	}

	public static function getSlugURI($slug, $type = 'document') {
	static $types = array(
	'document' => '/w/',
	'history' => '/phriction/history/',
	);

	if (empty($types[$type])) {
	throw new Exception("Unknown URI type '{$type}'!");
	}

	$prefix = $types[$type];

	if ($slug == '/') {
	return $prefix;
	} else {
	// NOTE: The effect here is to escape non-latin characters, since modern
	// browsers deal with escaped UTF8 characters in a reasonable way (showing
	// the user a readable URI) but older programs may not.
	$slug = phutil_escape_uri($slug);
	return $prefix.$slug;
	}
	}

	public function setSlug($slug) {
	$this->slug = PhabricatorSlug::normalize($slug);
	$this->depth = PhabricatorSlug::getDepth($slug);
	return $this;
	}

	public function attachContent(PhrictionContent $content) {
	$this->contentObject = $content;
	return $this;
	}

	public function getContent() {
	return $this->assertAttached($this->contentObject);
	}

	public function getProject() {
	return $this->assertAttached($this->project);
	}

	public function attachProject(PhabricatorProject $project = null) {
	$this->project = $project;
	return $this;
	}

	public function hasProject() {
	return (bool)$this->getProject();
	}

	public function getAncestors() {
	return $this->ancestors;
	}

	public function getAncestor($slug) {
	return $this->assertAttachedKey($this->ancestors, $slug);
	}

	public function attachAncestor($slug, $ancestor) {
	$this->ancestors[$slug] = $ancestor;
	return $this;
	}

	public static function isProjectSlug($slug) {
	$slug = PhabricatorSlug::normalize($slug);
	$prefix = 'projects/';
	if ($slug == $prefix) {
	// The 'projects/' document is not itself a project slug.
	return false;
	}
	return !strncmp($slug, $prefix, strlen($prefix));
	}

	public static function getProjectSlugIdentifier($slug) {
	if (!self::isProjectSlug($slug)) {
	throw new Exception("Slug '{$slug}' is not a project slug!");
	}

	$slug = PhabricatorSlug::normalize($slug);
	$parts = explode('/', $slug);
	return $parts[1].'/';
	}


	/* -( PhabricatorPolicyInterface )----------------------------------------- */


	public function getCapabilities() {
	return array(
	PhabricatorPolicyCapability::CAN_VIEW,
	PhabricatorPolicyCapability::CAN_EDIT,
	);
	}

	public function getPolicy($capability) {
	if ($this->hasProject()) {
	return $this->getProject()->getPolicy($capability);
	}

	return PhabricatorPolicies::POLICY_USER;
	}

	public function hasAutomaticCapability($capability, PhabricatorUser $user) {
	if ($this->hasProject()) {
	return $this->getProject()->hasAutomaticCapability($capability, $user);
	}
	return false;
	}

	public function describeAutomaticCapability($capability) {
	if ($this->hasProject()) {
	return pht(
	"This is a project wiki page, and inherits the project's policies.");
	}

	switch ($capability) {
	case PhabricatorPolicyCapability::CAN_VIEW:
	return pht(
	'To view a wiki document, you must also be able to view all '.
	'of its parents.');
	}

	return null;
	}


	/* -( PhabricatorSubscribableInterface )----------------------------------- */


	public function isAutomaticallySubscribed($phid) {
	return false;
	}

	public function shouldShowSubscribersProperty() {
	return true;
	}

	public function shouldAllowSubscription($phid) {
	return true;
	}


	/* -( PhabricatorTokenReceiverInterface )---------------------------------- */


	public function getUsersToNotifyOfTokenGiven() {
	return PhabricatorSubscribersQuery::loadSubscribersForPHID($this->phid);
	}


	/* -( PhabricatorDestructibleInterface )----------------------------------- */


	public function destroyObjectPermanently(
	PhabricatorDestructionEngine $engine) {

	$this->openTransaction();

	$this->delete();

	$contents = id(new PhrictionContent())->loadAllWhere(
	'documentID = %d',
	$this->getID());
	foreach ($contents as $content) {
	$content->delete();
	}

	$this->saveTransaction();
	}

	}

File Metadata

Mime Type: text/x-diff
Expires: Jan 19 2025, 23:03 (6 w, 3 d ago)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 1129679
Default Alt Text: (6 KB)

No OneTemporaryActions

View Options

File Metadata

Event Timeline

No OneTemporary
Actions