Completed
Push — master ( 8bb2ce...66f74b )
by Mikael
02:20
created

TTextUtilities::createAnchor4Header()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 11
Code Lines 7

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 2

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 11
ccs 0
cts 7
cp 0
rs 9.4285
cc 1
eloc 7
nc 1
nop 3
crap 2
1
<?php
2
3
namespace Mos\TextFilter;
4
5
/**
6
 * Utilities when working with text.
7
 *
8
 */
9
trait TTextUtilities
10
{
11
    /**
12
     * Get text until <!--stop--> or all text.
13
     *
14
     * @param string $text with content
15
     *
16
     * @return string with text
17
     */
18 8
    public function getUntilStop($text)
19
    {
20 8
        $pos = stripos($text, "<!--stop-->");
21 8
        if ($pos) {
22 2
            $text = substr($text, 0, $pos);
23 2
        }
24 8
        return $text;
25
    }
26
27
28
29
    /**
30
     * Get text until <!--more--> or all text.
31
     *
32
     * @param string $text with content
33
     *
34
     * @return array with text and boolean if more was detected.
35
     */
36 8
    public function getUntilMore($text)
37
    {
38 8
        $pos = stripos($text, "<!--more-->");
39 8
        $hasMore = $pos;
40 8
        if ($pos) {
41 1
            $text = substr($text, 0, $pos);
42 1
        }
43 8
        return [$text, $hasMore];
44
    }
45
46
47
48
    /**
49
     * Wrap HTML element with with start and end.
50
     *
51
     * @param string  $text  with content
52
     * @param string  $tag   HTML tag to search for
53
     * @param string  $start wrap start part
54
     * @param string  $end   wrap end part
55
     * @param number  $count hits to search for
56
     *
57
     * @return array with text and boolean if more was detected.
58
     */
59
    public function wrapElementWithStartEnd($text, $tag, $start, $end, $count)
60
    {
61
        return preg_replace(
62
            "#(<$tag>)(.*?)(</$tag>)#",
63
            "$start$1$2$3$end</a>",
64
            $text,
65
            $count
66
        );
67
    }
68
69
70
71
    /**
72
    * Wrap content of a HTML element with start and end.
73
     *
74
     * @param string  $text  with content
75
     * @param string  $tag   HTML tag to search for
76
     * @param string  $start wrap start part
77
     * @param string  $end   wrap end part
78
     * @param number  $count hits to search for
79
     *
80
     * @return array with text and boolean if more was detected.
81
     */
82
    public function wrapElementContentWithStartEnd($text, $tag, $start, $end, $count)
83
    {
84
        return preg_replace(
85
            "#(<$tag>)(.*?)(</$tag>)#",
86
            "$1$start$2$end$3</a>",
87
            $text,
88
            $count
89
        );
90
    }
91
92
93
94
    /**
95
     * Create a TOC of HTML headings from and to a certain level.
96
     *
97
     * @param string  $text  with content
98
     * @param integer $start level of headings to use for toc.
99
     * @param integer $stop  level of headings to use for toc.
100
     *
101
     * @return array with entries to generate a TOC.
102
     */
103
    public function createToc($text, $start = 2, $stop = 4)
104
    {
105
        $level = "$start-$stop";
106
        $pattern = "/<(h[$level])([^>]*)>(.*)<\/h[$level]>/";
107
        preg_match_all($pattern, $text, $matches, PREG_SET_ORDER);
108
109
        $toc = [];
110
        foreach ($matches as $val) {
0 ignored issues
show
Bug introduced by
The expression $matches of type null|array<integer,array<integer,string>> is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
111
            preg_match("/id=['\"]([^>\"']+)/", $val[2], $id);
112
            $id = isset($id[1]) ? $id[1] : null;
113
            $toc[] = [
114
                "level" => isset($val[1])
115
                    ? $val[1]
116
                    : null,
117
                "title" => isset($val[3])
118
                    ? $val[3]
119
                    : null,
120
                "id" => $id,
121
            ];
122
        }
123
124
        return $toc;
125
    }
126
127
128
129
    /**
130
     * Create a anchor for each header having an id.
131
     *
132
     * @param string  $text  with content
133
     * @param integer $start level of headings to use.
134
     * @param integer $stop  level of headings to use.
135
     *
136
     * @return string with modified text.
137
     */
138
    public function createAnchor4Header($text, $start = 1, $stop = 4)
139
    {
140
        $level = "$start-$stop";
141
        $pattern = "#(<h[$level] id=\"([\w-_]+)\">)(.+)(</h[$level]>)#";
142
143
        return preg_replace(
144
            $pattern,
145
            "$1<a class=\"header-anchor\" href=\"#$2\">#</a>$3$4",
146
            $text
147
        );
148
    }
149
150
151
152
    /**
153
     * Add baseurl to all relative links.
154
     *
155
     * @param string   $text     with content.
156
     * @param string   $baseurl  as string to prepend relative link.
157
     * @param callable $callback Use to create url from route.
158
     *
159
     * @return string with modified text.
160
     */
161
    public function addBaseurlToRelativeLinks($text, $baseurl, $callback)
162
    {
163
        $pattern = "#<a(.+)href=\"([^\"]+)\"(.*)>#";
164
165
        return preg_replace_callback(
166
            $pattern,
167
            function ($matches) use ($baseurl, $callback) {
168
                $url = $callback($matches[2], $baseurl);
169
                return "<a${matches[1]}href=\"$url\"${matches[3]}>";
170
            },
171
            $text
172
        );
173
    }
174
175
176
177
    /**
178
     * Get content as pure text.
179
     *
180
     * @return string with the pure text.
181
     */
182
/*    public function GetPureText() {
183
      return preg_replace('/\s+/', ' ', strip_tags($this->GetFilteredData()));
184
    }
185
*/
186
187
188
189
    /**
190
     * Returns the excerpt of the text with at most the specified amount of characters.
191
     *
192
     * @param int $chars the number of characters to return.
193
     * @param boolean $hard do a hard break at exactly $chars characters or find closest space.
194
     * @return string as the excerpt.
195
     */
196
/*    public function GetExcerpt($chars=139, $hard=false) {
197
      if(!isset($this->data['data_filtered'])) {
198
        return null;
199
      }
200
      $excerpt = strip_tags($this->data['data_filtered']);
201
202
      if(strlen($excerpt) > $chars) {
203
        $excerpt   = substr($excerpt, 0, $chars-1);
204
      }
205
206
      if(!$hard) {
207
        $lastSpace = strrpos($excerpt, ' ');
208
        $excerpt   = substr($excerpt, 0, $lastSpace);
209
      }
210
211
      return $excerpt;
212
    }
213
    
214
    
215
    /**
216
     * Returns the first paragraph ot the text.
217
     * 
218
     * @return string as the first paragraph.
219
     */
220
/*    public function GetFirstParagraph() {
221
      if(!isset($this->data['data_filtered'])) {
222
        return null;
223
      }
224
      $excerpt = $this->data['data_filtered'];
225
226
      $firstPara = strpos($excerpt, '</p>');
227
      $excerpt   = substr($excerpt, 0, $firstPara + 4);
228
229
      return $excerpt;
230
    }
231
*/
232
}
233