Utility::UcFirstAndToLower()   A
last analyzed

Complexity

Conditions 1
Paths 1

Size

Total Lines 3
Code Lines 1

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 1
nc 1
nop 1
dl 0
loc 3
rs 10
c 0
b 0
f 0
1
<?php
2
3
namespace XoopsModules\Modulebuilder;
4
5
/*
6
 Utility Class Definition
7
8
 You may not change or alter any portion of this comment or credits of
9
 supporting developers from this source code or any supporting source code
10
 which is considered copyrighted (c) material of the original comment or credit
11
 authors.
12
13
 This program is distributed in the hope that it will be useful, but
14
 WITHOUT ANY WARRANTY; without even the implied warranty of
15
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
16
 */
17
18
/**
19
 * Module:  modulebuilder
20
 *
21
 * @package      \module\modulebuilder\class
22
 * @license      http://www.fsf.org/copyleft/gpl.html GNU public license
23
 * @copyright    https://xoops.org 2001-2017 &copy; XOOPS Project
24
 * @author       ZySpec <[email protected]>
25
 * @author       Mamba <[email protected]>
26
 * @since
27
 */
28
29
use XoopsModules\Modulebuilder;
30
31
/**
32
 * Class Utility
33
 */
34
class Utility
35
{
36
    use Common\VersionChecks;
0 ignored issues
show
introduced by
The trait XoopsModules\Modulebuilder\Common\VersionChecks requires some properties which are not provided by XoopsModules\Modulebuilder\Utility: $tag_name, $prerelease
Loading history...
37
38
    //checkVerXoops, checkVerPhp Traits
39
40
    use Common\ServerStats;
41
42
    // getServerStats Trait
43
44
    use Common\FilesManagement;
45
46
    // Files Management Trait
47
48
    /**
49
     * truncateHtml can truncate a string up to a number of characters while preserving whole words and HTML tags
50
     * www.gsdesign.ro/blog/cut-html-string-without-breaking-the-tags
51
     * www.cakephp.org
52
     *
53
     * @param string $text         String to truncate.
54
     * @param int    $length       Length of returned string, including ellipsis.
55
     * @param string $ending       Ending to be appended to the trimmed string.
56
     * @param bool   $exact        If false, $text will not be cut mid-word
57
     * @param bool   $considerHtml If true, HTML tags would be handled correctly
58
     *
59
     * @return string Trimmed string.
60
     */
61
    public static function truncateHtml($text, $length = 100, $ending = '...', $exact = false, $considerHtml = true)
62
    {
63
        if ($considerHtml) {
64
            // if the plain text is shorter than the maximum length, return the whole text
65
            if (\mb_strlen(\preg_replace('/<.*?' . '>/', '', $text)) <= $length) {
66
                return $text;
67
            }
68
            // splits all html-tags to scanable lines
69
            \preg_match_all('/(<.+?' . '>)?([^<>]*)/s', $text, $lines, \PREG_SET_ORDER);
70
            $total_length = \mb_strlen($ending);
71
            $open_tags    = [];
72
            $truncate     = '';
73
            foreach ($lines as $line_matchings) {
74
                // if there is any html-tag in this line, handle it and add it (uncounted) to the output
75
                if (!empty($line_matchings[1])) {
76
                    // if it's an "empty element" with or without xhtml-conform closing slash
77
                    if (\preg_match('/^<(\s*.+?\/\s*|\s*(img|br|input|hr|area|base|basefont|col|frame|isindex|link|meta|param)(\s.+?)?)>$/is', $line_matchings[1])) {
78
                        // do nothing
79
                        // if tag is a closing tag
80
                    } elseif (\preg_match('/^<\s*\/([^\s]+?)\s*>$/s', $line_matchings[1], $tag_matchings)) {
81
                        // delete tag from $open_tags list
82
                        $pos = \array_search($tag_matchings[1], $open_tags, true);
83
                        if (false !== $pos) {
84
                            unset($open_tags[$pos]);
85
                        }
86
                        // if tag is an opening tag
87
                    } elseif (\preg_match('/^<\s*([^\s>!]+).*?' . '>$/s', $line_matchings[1], $tag_matchings)) {
88
                        // add tag to the beginning of $open_tags list
89
                        \array_unshift($open_tags, \mb_strtolower($tag_matchings[1]));
90
                    }
91
                    // add html-tag to $truncate'd text
92
                    $truncate .= $line_matchings[1];
93
                }
94
                // calculate the length of the plain text part of the line; handle entities as one character
95
                $content_length = mb_strlen(\preg_replace('/&[0-9a-z]{2,8};|&#[0-9]{1,7};|[0-9a-f]{1,6};/i', ' ', $line_matchings[2]));
96
                if ($total_length + $content_length > $length) {
97
                    // the number of characters which are left
98
                    $left            = $length - $total_length;
99
                    $entities_length = 0;
100
                    // search for html entities
101
                    if (\preg_match_all('/&[0-9a-z]{2,8};|&#[0-9]{1,7};|[0-9a-f]{1,6};/i', $line_matchings[2], $entities, \PREG_OFFSET_CAPTURE)) {
102
                        // calculate the real length of all entities in the legal range
103
                        foreach ($entities[0] as $entity) {
104
                            if ($left >= $entity[1] + 1 - $entities_length) {
105
                                $left--;
106
                                $entities_length += mb_strlen($entity[0]);
107
                            } else {
108
                                // no more characters left
109
                                break;
110
                            }
111
                        }
112
                    }
113
                    $truncate .= \mb_substr($line_matchings[2], 0, $left + $entities_length);
114
                    // maximum lenght is reached, so get off the loop
115
                    break;
116
                }
117
                $truncate     .= $line_matchings[2];
118
                $total_length += $content_length;
119
120
                // if the maximum length is reached, get off the loop
121
                if ($total_length >= $length) {
122
                    break;
123
                }
124
            }
125
        } else {
126
            if (\mb_strlen($text) <= $length) {
127
                return $text;
128
            }
129
            $truncate = \mb_substr($text, 0, $length - mb_strlen($ending));
130
        }
131
        // if the words shouldn't be cut in the middle...
132
        if (!$exact) {
133
            // ...search the last occurance of a space...
134
            $spacepos = \mb_strrpos($truncate, ' ');
135
            if (isset($spacepos)) {
136
                // ...and cut the text in this position
137
                $truncate = \mb_substr($truncate, 0, $spacepos);
138
            }
139
        }
140
        // add the defined ending to the text
141
        if ('' != $truncate) {
142
            $truncate .= $ending;
143
        }
144
        if ($considerHtml) {
145
            // close all unclosed html-tags
146
            foreach ($open_tags as $tag) {
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $open_tags does not seem to be defined for all execution paths leading up to this point.
Loading history...
147
                $truncate .= '</' . $tag . '>';
148
            }
149
        }
150
151
        return $truncate;
152
    }
153
154
    /**
155
     * @param \Xmf\Module\Helper $helper
156
     * @param array|null         $options
157
     * @return \XoopsFormDhtmlTextArea|\XoopsFormEditor
158
     */
159
    public static function getEditor($helper = null, $options = null)
160
    {
161
        /** @var Modulebuilder\Helper $helper */
162
        if (null === $options) {
163
            $options           = [];
164
            $options['name']   = 'Editor';
165
            $options['value']  = 'Editor';
166
            $options['rows']   = 10;
167
            $options['cols']   = '100%';
168
            $options['width']  = '100%';
169
            $options['height'] = '400px';
170
        }
171
172
        $isAdmin = $helper->isUserAdmin();
173
174
        if (\class_exists('XoopsFormEditor')) {
175
            if ($isAdmin) {
176
                $descEditor = new \XoopsFormEditor(\ucfirst($options['name']), $helper->getConfig('editor_admin'), $options, $nohtml = false, $onfailure = 'textarea');
177
            } else {
178
                $descEditor = new \XoopsFormEditor(\ucfirst($options['name']), $helper->getConfig('editor_user'), $options, $nohtml = false, $onfailure = 'textarea');
179
            }
180
        } else {
181
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], '100%', '100%');
0 ignored issues
show
Bug introduced by
'100%' of type string is incompatible with the type integer expected by parameter $rows of XoopsFormDhtmlTextArea::__construct(). ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

181
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], /** @scrutinizer ignore-type */ '100%', '100%');
Loading history...
Bug introduced by
'100%' of type string is incompatible with the type integer expected by parameter $cols of XoopsFormDhtmlTextArea::__construct(). ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

181
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], '100%', /** @scrutinizer ignore-type */ '100%');
Loading history...
182
        }
183
184
        //        $form->addElement($descEditor);
185
186
        return $descEditor;
187
    }
188
189
    //--------------- Custom module methods -----------------------------
190
191
    /**
192
     * @param $about
193
     * @return string
194
     */
195
    public static function makeDonationForm($about)
196
    {
197
        $donationform = [
198
            0   => '<form name="donation" id="donation" action="https://xoops.org/modules/xdonations/" method="post" onsubmit="return xoopsFormValidate_donation();">',
199
            1   => '<table class="outer" cellspacing="1" width="100%"><tbody><tr><th colspan="2">'
200
                   . \_AM_MODULEBUILDER_ABOUT_MAKE_DONATION
201
                   . '</th></tr><tr align="left" valign="top"><td class="head"><div class="xoops-form-element-caption-required"><span class="caption-text">'
202
                   . \_AM_MODULEBUILDER_DONATION_AMOUNT
203
                   . '</span><span class="caption-marker">*</span></div></td><td class="even"><select size="1" name="item[A][amount]" id="item[A][amount]" title="Donation Amount"><option value="5">5.00 EUR</option><option value="10">10.00 EUR</option><option value="20">20.00 EUR</option><option value="40">40.00 EUR</option><option value="60">60.00 EUR</option><option value="80">80.00 EUR</option><option value="90">90.00 EUR</option><option value="100">100.00 EUR</option><option value="200">200.00 EUR</option></select></td></tr><tr align="left" valign="top"><td class="head"></td><td class="even"><input class="formButton" name="submit" id="submit" value="'
204
                   . \_SUBMIT
205
                   . '" title="'
206
                   . \_SUBMIT
207
                   . '" type="submit"></td></tr></tbody></table>',
208
            2   => '<input name="op" id="op" value="createinvoice" type="hidden"><input name="plugin" id="plugin" value="donations" type="hidden"><input name="donation" id="donation" value="1" type="hidden"><input name="drawfor" id="drawfor" value="Chronolabs Co-Operative" type="hidden"><input name="drawto" id="drawto" value="%s" type="hidden"><input name="drawto_email" id="drawto_email" value="%s" type="hidden"><input name="key" id="key" value="%s" type="hidden"><input name="currency" id="currency" value="EUR" type="hidden"><input name="weight_unit" id="weight_unit" value="kgs" type="hidden"><input name="item[A][cat]" id="item[A][cat]" value="XDN%s" type="hidden"><input name="item[A][name]" id="item[A][name]" value="Donation for %s" type="hidden"><input name="item[A][quantity]" id="item[A][quantity]" value="1" type="hidden"><input name="item[A][shipping]" id="item[A][shipping]" value="0" type="hidden"><input name="item[A][handling]" id="item[A][handling]" value="0" type="hidden"><input name="item[A][weight]" id="item[A][weight]" value="0" type="hidden"><input name="item[A][tax]" id="item[A][tax]" value="0" type="hidden"><input name="return" id="return" value="https://xoops.org/modules/xdonations/success.php" type="hidden"><input name="cancel" id="cancel" value="https://xoops.org/modules/xdonations/success.php" type="hidden"></form>',
209
            'D' => '',
210
            3   => '',
211
            4   => '<!-- Start Form Validation JavaScript //-->
212
<script type="text/javascript">
213
<!--//
214
function xoopsFormValidate_donation() { var myform = window.document.donation; 
215
var hasSelected = false; var selectBox = myform.item[A][amount];for (i = 0; i < selectBox.options.length; i++ ) { if (selectBox.options[i].selected === true && selectBox.options[i].value != \'\') { hasSelected = true; break; } }if (!hasSelected) { window.alert("Please enter Donation Amount"); selectBox.focus(); return false; }return true;
216
}
217
//--></script>
218
<!-- End Form Validation JavaScript //-->',
219
        ];
220
        $paypalform   = [
221
            0 => '<form action="https://www.paypal.com/cgi-bin/webscr" method="post">',
222
            1 => '<input name="cmd" value="_s-xclick" type="hidden">',
223
            2 => '<input name="hosted_button_id" value="%s" type="hidden">',
224
            3 => '<img alt="" src="https://www.paypal.com/fr_FR/i/scr/pixel.gif" height="1" border="0" width="1">',
225
            4 => '<input src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" name="submit" alt="PayPal - The safer, easier way to pay online!" border="0" type="image">',
226
            5 => '</form>',
227
        ];
228
        for ($key = 0; $key <= 4; ++$key) {
229
            switch ($key) {
230
                case 2:
231
                    $donationform[$key] = \sprintf(
232
                        $donationform[$key],
233
                        $GLOBALS['xoopsConfig']['sitename'] . ' - ' . ('' != $GLOBALS['xoopsUser']->getVar('name') ? $GLOBALS['xoopsUser']->getVar('name') . ' [' . $GLOBALS['xoopsUser']->getVar('uname') . ']' : $GLOBALS['xoopsUser']->getVar('uname')),
234
                        $GLOBALS['xoopsUser']->getVar('email'),
235
                        \XOOPS_LICENSE_KEY,
236
                        \mb_strtoupper($GLOBALS['xoopsModule']->getVar('dirname')),
237
                        \mb_strtoupper($GLOBALS['xoopsModule']->getVar('dirname')) . ' ' . $GLOBALS['xoopsModule']->getVar('name')
238
                    );
239
                    break;
240
            }
241
        }
242
        $aboutRes = '';
243
        $istart   = \mb_strpos($about, $paypalform[0], 1);
244
        $iend     = \mb_strpos($about, $paypalform[5], $istart + 1) + mb_strlen($paypalform[5]) - 1;
245
        $aboutRes .= \mb_substr($about, 0, $istart - 1);
246
        $aboutRes .= \implode("\n", $donationform);
247
        $aboutRes .= \mb_substr($about, $iend + 1, mb_strlen($about) - $iend - 1);
248
249
        return $aboutRes;
250
    }
251
252
    /**
253
     * @param $str
254
     *
255
     * @return string
256
     */
257
    public static function UcFirstAndToLower($str)
258
    {
259
        return \ucfirst(\mb_strtolower(\trim($str)));
260
    }
261
}
262