mirror of
https://we.phorge.it/source/phorge.git
synced 2024-09-22 18:28:47 +02:00
ef85f49adc
Summary: This commit doesn't change license of any file. It just makes the license implicit (inherited from LICENSE file in the root directory). We are removing the headers for these reasons: - It wastes space in editors, less code is visible in editor upon opening a file. - It brings noise to diff of the first change of any file every year. - It confuses Git file copy detection when creating small files. - We don't have an explicit license header in other files (JS, CSS, images, documentation). - Using license header in every file is not obligatory: http://www.apache.org/dev/apply-license.html#new. This change is approved by Alma Chao (Lead Open Source and IP Counsel at Facebook). Test Plan: Verified that the license survived only in LICENSE file and that it didn't modify externals. Reviewers: epriestley, davidrecordon Reviewed By: epriestley CC: aran, Korvin Maniphest Tasks: T2035 Differential Revision: https://secure.phabricator.com/D3886
120 lines
2.6 KiB
PHP
120 lines
2.6 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Render the body of an application email by building it up section-by-section.
|
|
*
|
|
* @task compose Composition
|
|
* @task render Rendering
|
|
* @group metamta
|
|
*/
|
|
final class PhabricatorMetaMTAMailBody {
|
|
|
|
private $sections = array();
|
|
|
|
|
|
/* -( Composition )-------------------------------------------------------- */
|
|
|
|
|
|
/**
|
|
* Add a raw block of text to the email. This will be rendered as-is.
|
|
*
|
|
* @param string Block of text.
|
|
* @return this
|
|
* @task compose
|
|
*/
|
|
public function addRawSection($text) {
|
|
if (strlen($text)) {
|
|
$this->sections[] = rtrim($text);
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Add a block of text with a section header. This is rendered like this:
|
|
*
|
|
* HEADER
|
|
* Text is indented.
|
|
*
|
|
* @param string Header text.
|
|
* @param string Section text.
|
|
* @return this
|
|
* @task compose
|
|
*/
|
|
public function addTextSection($header, $text) {
|
|
$this->sections[] = $header."\n".$this->indent($text);
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Add a Herald section with a rule management URI and a transcript URI.
|
|
*
|
|
* @param string URI to rule management.
|
|
* @param string URI to rule transcripts.
|
|
* @return this
|
|
* @task compose
|
|
*/
|
|
public function addHeraldSection($rules_uri, $xscript_uri) {
|
|
if (!PhabricatorEnv::getEnvConfig('metamta.herald.show-hints')) {
|
|
return $this;
|
|
}
|
|
|
|
$this->addTextSection(
|
|
pht('MANAGE HERALD RULES'),
|
|
PhabricatorEnv::getProductionURI($rules_uri));
|
|
$this->addTextSection(
|
|
pht('WHY DID I GET THIS EMAIL?'),
|
|
PhabricatorEnv::getProductionURI($xscript_uri));
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Add a section with reply handler instructions.
|
|
*
|
|
* @param string Reply handler instructions.
|
|
* @return this
|
|
* @task compose
|
|
*/
|
|
public function addReplySection($instructions) {
|
|
if (!PhabricatorEnv::getEnvConfig('metamta.reply.show-hints')) {
|
|
return $this;
|
|
}
|
|
if (!strlen($instructions)) {
|
|
return $this;
|
|
}
|
|
|
|
$this->addTextSection(pht('REPLY HANDLER ACTIONS'), $instructions);
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/* -( Rendering )---------------------------------------------------------- */
|
|
|
|
|
|
/**
|
|
* Render the email body.
|
|
*
|
|
* @return string Rendered body.
|
|
* @task render
|
|
*/
|
|
public function render() {
|
|
return implode("\n\n", $this->sections)."\n";
|
|
}
|
|
|
|
|
|
/**
|
|
* Indent a block of text for rendering under a section heading.
|
|
*
|
|
* @param string Text to indent.
|
|
* @return string Indented text.
|
|
* @task render
|
|
*/
|
|
private function indent($text) {
|
|
return rtrim(" ".str_replace("\n", "\n ", $text));
|
|
}
|
|
|
|
}
|