aboutsummaryrefslogtreecommitdiffstats
path: root/phpBB/phpbb/textformatter/s9e/link_helper.php
blob: 483794a83e1440fc0a926fa4034a176f667f51a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<?php
/**
*
* This file is part of the phpBB Forum Software package.
*
* @copyright (c) phpBB Limited <https://www.phpbb.com>
* @license GNU General Public License, version 2 (GPL-2.0)
*
* For full copyright and license information, please see
* the docs/CREDITS.txt file.
*
*/

namespace phpbb\textformatter\s9e;

class link_helper
{
	/**
	* Clean up and invalidate a LINK_TEXT tag if applicable
	*
	* Will invalidate the tag if its replacement text is the same as the original
	* text and would have no visible effect
	*
	* @param  \s9e\TextFormatter\Parser\Tag $tag    LINK_TEXT tag
	* @param  \s9e\TextFormatter\Parser     $parser Parser
	* @return void
	*/
	public function cleanup_tag(\s9e\TextFormatter\Parser\Tag $tag, \s9e\TextFormatter\Parser $parser)
	{
		// Invalidate if the content of the tag matches the text attribute
		$text = substr($parser->getText(), $tag->getPos(), $tag->getLen());
		if ($text === $tag->getAttribute('text'))
		{
			$tag->invalidate();
		}
	}

	/**
	* Create a LINK_TEXT tag inside of a link
	*
	* Meant to only apply to linkified URLs and [url] BBCodes without a parameter
	*
	* @param  \s9e\TextFormatter\Parser\Tag $tag    URL tag (start tag)
	* @param  \s9e\TextFormatter\Parser     $parser Parser
	* @return void
	*/
	public function generate_link_text_tag(\s9e\TextFormatter\Parser\Tag $tag, \s9e\TextFormatter\Parser $parser)
	{
		// Only create a LINK_TEXT tag if the start tag is paired with an end
		// tag, which is the case with tags from the Autolink plugins and with
		// the [url] BBCode when its content is used for the URL
		if (!$tag->getEndTag() || !$this->should_shorten($tag, $parser->getText()))
		{
			return;
		}

		// Capture the text between the start tag and its end tag
		$start  = $tag->getPos() + $tag->getLen();
		$end    = $tag->getEndTag()->getPos();
		$length = $end - $start;
		$text   = substr($parser->getText(), $start, $length);

		// Create a tag that consumes the link's text and make it depends on this tag
		$link_text_tag = $parser->addSelfClosingTag('LINK_TEXT', $start, $length);
		$link_text_tag->setAttribute('text', $text);
		$tag->cascadeInvalidationTo($link_text_tag);
	}

	/**
	* Test whether we should shorten this tag's text
	*
	* Will test whether the tag either does not use any markup or uses a single
	* [url] BBCode
	*
	* @param  \s9e\TextFormatter\Parser\Tag $tag  URL tag
	* @param  string                        $text Original text
	* @return bool
	*/
	protected function should_shorten(\s9e\TextFormatter\Parser\Tag $tag, $text)
	{
		return ($tag->getLen() === 0 || strtolower(substr($text, $tag->getPos(), $tag->getLen())) === '[url]');
	}

	/**
	* Remove the board's root URL from a the start of a string
	*
	* @param  \s9e\TextFormatter\Parser\Tag $tag       LINK_TEXT tag
	* @param  string                        $board_url Forum's root URL (with trailing slash)
	* @return void
	*/
	public function truncate_local_url(\s9e\TextFormatter\Parser\Tag $tag, $board_url)
	{
		$text = $tag->getAttribute('text');
		if (stripos($text, $board_url) === 0 && strlen($text) > strlen($board_url))
		{
			$tag->setAttribute('text', substr($text, strlen($board_url)));
		}
	}

	/**
	* Truncate the replacement text set in a LINK_TEXT tag
	*
	* @param  \s9e\TextFormatter\Parser\Tag $tag LINK_TEXT tag
	* @return void
	*/
	public function truncate_text(\s9e\TextFormatter\Parser\Tag $tag)
	{
		$text = $tag->getAttribute('text');
		if (utf8_strlen($text) > 55)
		{
			$text = utf8_substr($text, 0, 39) . ' ... ' . utf8_substr($text, -10);
			$tag->setAttribute('text', $text);
		}
	}
}