mirror of
https://we.phorge.it/source/phorge.git
synced 2024-09-22 18:28:47 +02:00
126 lines
2.9 KiB
PHP
126 lines
2.9 KiB
PHP
|
<?php
|
||
|
|
||
|
/*
|
||
|
* Copyright 2012 Facebook, Inc.
|
||
|
*
|
||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
* you may not use this file except in compliance with the License.
|
||
|
* You may obtain a copy of the License at
|
||
|
*
|
||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
*
|
||
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
* See the License for the specific language governing permissions and
|
||
|
* limitations under the License.
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* 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) {
|
||
|
$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 (strlen($instructions)) {
|
||
|
$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));
|
||
|
}
|
||
|
|
||
|
}
|