access.php
2 years ago
behavior.php
5 months ago
bootstrap.php
5 months ago
contentlanguage.php
2 years ago
date.php
1 month ago
form.php
2 years ago
formbehavior.php
5 months ago
grid.php
2 years ago
jquery.php
2 years ago
list.php
2 years ago
number.php
2 years ago
select.php
2 years ago
user.php
2 years ago
bootstrap.php
304 lines
| 1 | <?php |
| 2 | /** |
| 3 | * @package VikWP - Libraries |
| 4 | * @subpackage adapter.html |
| 5 | * @author E4J s.r.l. |
| 6 | * @copyright Copyright (C) 2023 E4J s.r.l. All Rights Reserved. |
| 7 | * @license http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL |
| 8 | * @link https://vikwp.com |
| 9 | */ |
| 10 | |
| 11 | // No direct access |
| 12 | defined('ABSPATH') or die('No script kiddies please!'); |
| 13 | |
| 14 | /** |
| 15 | * Utility class for Bootstrap elements. |
| 16 | * |
| 17 | * @since 10.1.16 |
| 18 | */ |
| 19 | abstract class JHtmlBootstrap |
| 20 | { |
| 21 | /** |
| 22 | * Array containing information for loaded files. |
| 23 | * |
| 24 | * @var array |
| 25 | */ |
| 26 | protected static $loaded = array(); |
| 27 | |
| 28 | /** |
| 29 | * Add javascript support for Bootstrap modals. |
| 30 | * |
| 31 | * @param string $selector The ID selector for the modal. |
| 32 | * @param array $params An array of options for the modal. |
| 33 | * Options for the modal can be: |
| 34 | * - backdrop boolean Includes a modal-backdrop element. |
| 35 | * - keyboard boolean Closes the modal when escape key is pressed. |
| 36 | * - show boolean Shows the modal when initialized. |
| 37 | * - remote string An optional remote URL to load. |
| 38 | * |
| 39 | * @return void |
| 40 | */ |
| 41 | public static function modal($selector = 'modal', $params = array()) |
| 42 | { |
| 43 | // do nothing here |
| 44 | } |
| 45 | |
| 46 | /** |
| 47 | * Method to render a Bootstrap modal. |
| 48 | * |
| 49 | * @param string $selector The ID selector for the modal. |
| 50 | * @param array $params An array of options for the modal. |
| 51 | * Options for the modal can be: |
| 52 | * - title string The modal title. |
| 53 | * - backdrop mixed A boolean select if a modal-backdrop element should be included (default = true). |
| 54 | * The string 'static' includes a backdrop which doesn't close the modal on click. |
| 55 | * - keyboard boolean Closes the modal when escape key is pressed (default = true). |
| 56 | * - closeButton boolean Display modal close button (default = true). |
| 57 | * - animation boolean Fade in from the top of the page (default = true). |
| 58 | * - footer string Optional markup for the modal footer. |
| 59 | * - url string URL of a resource to be inserted as an `<iframe>` inside the modal body. |
| 60 | * - height string height of the `<iframe>` containing the remote resource. |
| 61 | * - width string width of the `<iframe>` containing the remote resource. |
| 62 | * @param string $body Markup for the modal body. Appended after the `<iframe>` if the URL option is set. |
| 63 | * |
| 64 | * @return string HTML markup for a modal. |
| 65 | */ |
| 66 | public static function renderModal($selector = 'modal', $params = array(), $body = '') |
| 67 | { |
| 68 | if (is_array($params)) |
| 69 | { |
| 70 | $width = isset($params['width']) ? abs($params['width']) : 96; |
| 71 | $height = isset($params['height']) ? abs($params['height']) : 90; |
| 72 | $left = isset($params['left']) ? abs($params['left']) : $width / 2; |
| 73 | |
| 74 | $style = "width:$width%;height:$height%;margin-left:-$left%;"; |
| 75 | |
| 76 | if (isset($params['top'])) |
| 77 | { |
| 78 | if ($params['top'] === true) |
| 79 | { |
| 80 | $top = (100 - $height) / 2; |
| 81 | } |
| 82 | else |
| 83 | { |
| 84 | $top = $params['top']; |
| 85 | } |
| 86 | |
| 87 | $style .= "top:$top%;"; |
| 88 | } |
| 89 | } |
| 90 | else if (is_string($params)) |
| 91 | { |
| 92 | // we probably received a style string, use it directly |
| 93 | $style = $params; |
| 94 | |
| 95 | // then, reset the params array |
| 96 | $params = array(); |
| 97 | } |
| 98 | else |
| 99 | { |
| 100 | // use some default styles |
| 101 | $style = "width:96%;height:90%;margin-left:-48%;top:5%;"; |
| 102 | |
| 103 | // cast params to array in case of non-scalar argument |
| 104 | if (!is_scalar($params)) |
| 105 | { |
| 106 | $params = (array) $params; |
| 107 | } |
| 108 | else |
| 109 | { |
| 110 | $params = array(); |
| 111 | } |
| 112 | } |
| 113 | |
| 114 | // remove initial "jmodal-" if set from ID |
| 115 | $params['id'] = preg_replace('/^jmodal-/', '', $selector); |
| 116 | $params['body'] = $body; |
| 117 | $params['style'] = $style; |
| 118 | |
| 119 | // render modal layout |
| 120 | return JHtml::fetch('layoutfile', 'html.plugins.modal')->render($params); |
| 121 | } |
| 122 | |
| 123 | /** |
| 124 | * Adds javascript support for Bootstrap popovers. |
| 125 | * |
| 126 | * @param string $selector Selector for the popover. |
| 127 | * @param array $options An array of options for the popover. |
| 128 | * Options for the popover can be: |
| 129 | * - animation boolean apply a css fade transition to the popover |
| 130 | * - html boolean Insert HTML into the popover. If false, jQuery's text method will be used to insert |
| 131 | * content into the dom. |
| 132 | * - placement string|function how to position the popover - top | bottom | left | right |
| 133 | * - selector string If a selector is provided, popover objects will be delegated to the specified targets. |
| 134 | * - trigger string how popover is triggered - hover | focus | manual |
| 135 | * - title string|function default title value if `title` tag isn't present |
| 136 | * - content string|function default content value if `data-content` attribute isn't present |
| 137 | * - delay number|object delay showing and hiding the popover (ms) - does not apply to manual trigger type |
| 138 | * If a number is supplied, delay is applied to both hide/show |
| 139 | * Object structure is: delay: { show: 500, hide: 100 } |
| 140 | * - container string|boolean Appends the popover to a specific element: { container: 'body' } |
| 141 | * |
| 142 | * @return void |
| 143 | */ |
| 144 | public static function popover($selector = '.wpPopover', $params = array()) |
| 145 | { |
| 146 | $sign = serialize(array($selector, $params)); |
| 147 | |
| 148 | // only load once |
| 149 | if (isset(static::$loaded[__METHOD__][$sign])) |
| 150 | { |
| 151 | return; |
| 152 | } |
| 153 | |
| 154 | /** |
| 155 | * Always disable HTML sanitizing to allow any kind of tags. |
| 156 | * |
| 157 | * @since 10.1.27 |
| 158 | */ |
| 159 | $params['sanitize'] = false; |
| 160 | |
| 161 | /** |
| 162 | * In case the "container" attribute is not set, |
| 163 | * always place the popover within the body. |
| 164 | * |
| 165 | * @since 10.1.28 |
| 166 | */ |
| 167 | if (!isset($params['container'])) |
| 168 | { |
| 169 | $params['container'] = 'body'; |
| 170 | } |
| 171 | |
| 172 | $data = $params ? json_encode($params) : '{}'; |
| 173 | JFactory::getDocument()->addScriptDeclaration( |
| 174 | <<<JAVASCRIPT |
| 175 | jQuery(function() { |
| 176 | jQuery('$selector').popover($data); |
| 177 | }); |
| 178 | JAVASCRIPT |
| 179 | ); |
| 180 | |
| 181 | // set static array |
| 182 | static::$loaded[__METHOD__][$sign] = true; |
| 183 | } |
| 184 | |
| 185 | /** |
| 186 | * Add javascript support for Bootstrap tooltips. |
| 187 | * |
| 188 | * Add a title attribute to any element in the form: |
| 189 | * title="title::text" |
| 190 | * |
| 191 | * @param string $selector The ID selector for the tooltip. |
| 192 | * @param array $params An array of options for the tooltip. |
| 193 | * Options for the tooltip can be: |
| 194 | * - animation boolean Apply a CSS fade transition to the tooltip |
| 195 | * - html boolean Insert HTML into the tooltip. If false, jQuery's text method will be used to insert |
| 196 | * content into the dom. |
| 197 | * - placement string|function How to position the tooltip - top | bottom | left | right |
| 198 | * - selector string If a selector is provided, tooltip objects will be delegated to the specified targets. |
| 199 | * - title string|function Default title value if `title` tag isn't present |
| 200 | * - trigger string How tooltip is triggered - hover | focus | manual |
| 201 | * - delay integer Delay showing and hiding the tooltip (ms) - does not apply to manual trigger type |
| 202 | * If a number is supplied, delay is applied to both hide/show |
| 203 | * Object structure is: delay: { show: 500, hide: 100 } |
| 204 | * - container string|boolean Appends the popover to a specific element: { container: 'body' } |
| 205 | * |
| 206 | * @return void |
| 207 | */ |
| 208 | public static function tooltip($selector = '.hasTooltip', $params = array()) |
| 209 | { |
| 210 | $sign = serialize(array($selector, $params)); |
| 211 | |
| 212 | // only load once |
| 213 | if (isset(static::$loaded[__METHOD__][$sign])) |
| 214 | { |
| 215 | return; |
| 216 | } |
| 217 | |
| 218 | /** |
| 219 | * If the container has not been specified, |
| 220 | * always append tooltips at the end of the body. |
| 221 | * |
| 222 | * @since 10.1.30 |
| 223 | */ |
| 224 | if (!isset($params['container'])) |
| 225 | { |
| 226 | $params['container'] = 'body'; |
| 227 | } |
| 228 | |
| 229 | $data = $params ? json_encode($params) : '{}'; |
| 230 | JFactory::getDocument()->addScriptDeclaration( |
| 231 | <<<JAVASCRIPT |
| 232 | jQuery(function() { |
| 233 | jQuery('$selector').tooltip($data); |
| 234 | }); |
| 235 | JAVASCRIPT |
| 236 | ); |
| 237 | |
| 238 | // set static array |
| 239 | static::$loaded[__METHOD__][$sign] = true; |
| 240 | } |
| 241 | |
| 242 | /** |
| 243 | * Creates a tab pane. |
| 244 | * |
| 245 | * @param string $selector The pane identifier. |
| 246 | * @param array $params The parameters for the pane. |
| 247 | * |
| 248 | * @return string |
| 249 | */ |
| 250 | public static function startTabSet($selector = 'myTab', $params = array()) |
| 251 | { |
| 252 | $sign = md5(serialize(array($selector, $params))); |
| 253 | |
| 254 | if (!isset(static::$loaded[__METHOD__][$sign])) |
| 255 | { |
| 256 | $opt = array(); |
| 257 | // setup options object |
| 258 | $opt['active'] = (isset($params['active']) && $params['active']) ? (string) $params['active'] : ''; |
| 259 | |
| 260 | // Set static array |
| 261 | static::$loaded[__METHOD__][$sign] = true; |
| 262 | static::$loaded[__METHOD__][$selector] = $opt; |
| 263 | } |
| 264 | |
| 265 | return JHtml::fetch('layoutfile', 'html.bootstrap.starttabset')->render(array('selector' => $selector)); |
| 266 | } |
| 267 | |
| 268 | /** |
| 269 | * Closes the current tab pane. |
| 270 | * |
| 271 | * @return string HTML to close the pane. |
| 272 | */ |
| 273 | public static function endTabSet() |
| 274 | { |
| 275 | return JHtml::fetch('layoutfile', 'html.bootstrap.endtabset')->render(); |
| 276 | } |
| 277 | |
| 278 | /** |
| 279 | * Begins the display of a new tab content panel. |
| 280 | * |
| 281 | * @param string $selector Identifier of the panel. |
| 282 | * @param string $id The ID of the div element. |
| 283 | * @param string $title The title text for the new UL tab. |
| 284 | * |
| 285 | * @return string HTML to start a new panel. |
| 286 | */ |
| 287 | public static function addTab($selector, $id, $title) |
| 288 | { |
| 289 | $active = (static::$loaded['JHtmlBootstrap::startTabSet'][$selector]['active'] == $id) ? ' active' : ''; |
| 290 | |
| 291 | return JHtml::fetch('layoutfile', 'html.bootstrap.addtab')->render(array('id' => $id, 'active' => $active, 'selector' => $selector, 'title' => $title)); |
| 292 | } |
| 293 | |
| 294 | /** |
| 295 | * Closes the current tab content panel. |
| 296 | * |
| 297 | * @return string HTML to close the pane. |
| 298 | */ |
| 299 | public static function endTab() |
| 300 | { |
| 301 | return JHtml::fetch('layoutfile', 'html.bootstrap.endtab')->render(); |
| 302 | } |
| 303 | } |
| 304 |