[
'start' => '\[comment(=.*?)\](.*?)\[\/comment\]',
'end' => '',
'callback' => 'WikiFormat::markupWikiComments',
'before' => ''
],
'wiki-links' => [
'start' => '\[\[(.*?)(?:\|(.*?))?\]\]',
'end' => '',
'callback' => 'WikiFormat::markupWikiLinks',
'before' => 'links'
],
];
/**
* Adds a new markup rule to the wiki markup set. This can
* also be used to replace an existing markup rule. The end regular
* expression is optional (i.e. may be NULL) to indicate that this
* rule has an empty content model. The callback is called whenever
* the rule matches and is passed the following arguments:
*
* - $markup the markup parser object
* - $matches match results of preg_match for $start
* - $contents (parsed) contents of this markup rule
*
* Sometimes you may want your rule to apply before another specific rule
* will apply. For this case the parameter $before defines a rulename of
* existing markup, before which your rule should apply.
*
* @param string $name name of this rule
* @param string $start start regular expression
* @param string $end end regular expression (optional)
* @param callback $callback function generating output of this rule
* @param string $before mark before which rule this rule should be appended
*/
public static function addWikiMarkup($name, $start, $end, $callback, $before = null)
{
$inserted = false;
foreach (self::$wiki_rules as $rule_name => $rule) {
if ($rule_name === $before) {
self::$wiki_rules[$name] = compact('start', 'end', 'callback');
$inserted = true;
}
if ($inserted) {
unset(self::$wiki_rules[$rule_name]);
self::$wiki_rules[$rule_name] = $rule;
}
}
if (!$inserted) {
self::$wiki_rules[$name] = compact('start', 'end', 'callback');
}
}
/**
* Returns a single markup-rule if it exists.
* @return array: array('start' => "...", 'end' => "...", 'callback' => "...")
*/
public static function getWikiMarkup($name)
{
return self::$wiki_rules[$name];
}
/**
* Removes a markup rule from the wiki markup set.
*
* @param string $name Name of the rule
*/
public static function removeWikiMarkup($name)
{
unset(self::$wiki_rules[$name]);
}
/**
* Initializes a new WikiFormat instance.
*/
public function __construct()
{
parent::__construct();
foreach (self::$wiki_rules as $name => $rule) {
$this->addMarkup(
$name,
$rule['start'],
$rule['end'],
$rule['callback'],
$rule['before'] ?: null
);
}
}
/**
* Stud.IP markup for wiki-comments
*
* @param StudipFormat $markup Markup object
* @param array $matches Found matches
* @return string
*/
protected static function markupWikiComments($markup, $matches)
{
$from = mb_substr($matches[1], 1);
$comment = $matches[2];
if (Request::get('wiki_comments') === 'none') {
return '';
} else if ($GLOBALS['user']->cfg->WIKI_COMMENTS_ENABLE) {
$commenttmpl = "
"._("Kommentar von")." %1\$s:
%2\$s
";
return sprintf(
$commenttmpl,
$from,
$comment
);
} else {
$from = decodeHTML($from);
$comment = decodeHTML($comment); //because tooltip already escapes
return sprintf(
'%s',
tooltip(sprintf("%s %s: %s", _("Kommentar von"), $from, $comment), true, true),
Icon::create('chat2', Icon::ROLE_STATUS_YELLOW)
);
}
}
/**
* Stud.IP markup for wiki links
*
* @param StudipFormat $markup Markup object
* @param array $matches Found matches
* @return string
*/
protected static function markupWikiLinks($markup, $matches)
{
$keyword = decodeHTML($matches[1]);
$display_page = !empty($matches[2]) ? $markup->format($matches[2]) : htmlReady($keyword);
$page = WikiPage::findLatestPage(Context::getId(), $keyword);
// Page does not exist
if (!$page) {
return sprintf('%s(?)',
URLHelper::getLink('wiki.php', [
'keyword' => $keyword,
'origin' => Request::get('keyword') ?: 'WikiWikiWeb',
'view' => 'editnew'
]),
$display_page
);
}
// Page is visible to current user
if ($page->isVisibleTo($GLOBALS['user'])) {
return sprintf(
'%s',
URLHelper::getLink('wiki.php', compact('keyword')),
$display_page
);
}
// Page is not visible to current user and show be displayed accordingly
return sprintf(
'%s',
URLHelper::getLink('wiki.php', compact('keyword')),
sprintf(
_('Sie haben keine Berechtigung, die Seite %s zu lesen!'),
htmlReady($keyword)
),
$display_page
);
}
}