[ticket/13713] Add mention BBCode

PHPBB3-13713

phpBB/config/default/container/services_text_formatter.yml

@@ -52,6 +52,12 @@ services:
     text_formatter.s9e.link_helper:
         class: phpbb\textformatter\s9e\link_helper
 
+    text_formatter.s9e.mention_helper:
+        class: phpbb\textformatter\s9e\mention_helper
+        arguments:
+            - '%core.root_path%'
+            - '%core.php_ext%'
+
     text_formatter.s9e.parser:
         class: phpbb\textformatter\s9e\parser
         arguments:
@@ -76,6 +82,7 @@ services:
             - '@text_formatter.s9e.factory'
             - '@dispatcher'
         calls:
+            - [configure_mention_helper, ['@text_formatter.s9e.mention_helper']]
             - [configure_quote_helper, ['@text_formatter.s9e.quote_helper']]
             - [configure_smilies_path, ['@config', '@path_helper']]
             - [configure_user, ['@user', '@config', '@auth']]

phpBB/includes/constants.php

@@ -183,6 +183,7 @@ define('BBCODE_ID_LIST', 9);
 define('BBCODE_ID_EMAIL', 10);
 define('BBCODE_ID_FLASH', 11);
 define('BBCODE_ID_ATTACH', 12);
+define('BBCODE_ID_MENTION', 13);
 
 // BBCode hard limit
 define('BBCODE_LIMIT', 1511);

phpBB/phpbb/textformatter/data_access.php

@@ -138,6 +138,7 @@ class data_access
 			'email' => 10,
 			'flash' => 11,
 			'attachment' => 12,
+			'mention' => 13,
 		);
 
 		$styles = array();

phpBB/phpbb/textformatter/s9e/factory.php

@@ -84,6 +84,12 @@ class factory implements \phpbb\textformatter\cache_interface
 		'img'   => '[IMG src={IMAGEURL;useContent}]',
 		'list'  => '[LIST type={HASHMAP=1:decimal,a:lower-alpha,A:upper-alpha,i:lower-roman,I:upper-roman;optional;postFilter=#simpletext} #createChild=LI]{TEXT}[/LIST]',
 		'li'    => '[* $tagName=LI]{TEXT}[/*]',
+		'mention' =>
+			"[MENTION
+				group_id={UINT;optional}
+				profile_url={URL;optional;postFilter=#false}
+				user_id={UINT;optional}
+			]{TEXT}[/MENTION]",
 		'quote' =>
 			"[QUOTE
 				author={TEXT1;optional}

phpBB/phpbb/textformatter/s9e/renderer.php

@@ -28,6 +28,11 @@ class renderer implements \phpbb\textformatter\renderer_interface
 	*/
 	protected $dispatcher;
 
+	/**
+	* @var mention_helper
+	*/
+	protected $mention_helper;
+
 	/**
 	* @var quote_helper
 	*/
@@ -117,6 +122,16 @@ class renderer implements \phpbb\textformatter\renderer_interface
 		extract($dispatcher->trigger_event('core.text_formatter_s9e_renderer_setup', compact($vars)));
 	}
 
+	/**
+	* Configure the mention_helper object used to display extended information in mentions
+	*
+	* @param  mention_helper $mention_helper
+	*/
+	public function configure_mention_helper(mention_helper $mention_helper)
+	{
+		$this->mention_helper = $mention_helper;
+	}
+
 	/**
 	* Configure the quote_helper object used to display extended information in quotes
 	*
@@ -229,6 +244,11 @@ class renderer implements \phpbb\textformatter\renderer_interface
 	*/
 	public function render($xml)
 	{
+		if (isset($this->mention_helper))
+		{
+			$xml = $this->mention_helper->inject_metadata($xml);
+		}
+
 		if (isset($this->quote_helper))
 		{
 			$xml = $this->quote_helper->inject_metadata($xml);

phpBB/styles/prosilver/template/bbcode.html

@@ -8,6 +8,22 @@
 <!-- BEGIN listitem --><li><!-- END listitem -->
 <!-- BEGIN listitem_close --></li><!-- END listitem_close -->
 
+<!-- BEGIN mention -->
+<xsl:choose>
+	<xsl:when test="@profile_url">
+		<a>
+			<xsl:attribute name="href"><xsl:value-of select="@profile_url"/></xsl:attribute>
+			<xsl:apply-templates/>
+		</a>
+	</xsl:when>
+	<xsl:otherwise>
+		<span>
+			<xsl:apply-templates/>
+		</span>
+	</xsl:otherwise>
+</xsl:choose>
+<!-- END mention -->
+
 <!-- BEGIN quote_username_open --><blockquote><div><cite>{USERNAME} {L_WROTE}{L_COLON}</cite><!-- END quote_username_open -->
 <!-- BEGIN quote_open --><blockquote class="uncited"><div><!-- END quote_open -->
 <!-- BEGIN quote_close --></div></blockquote><!-- END quote_close -->