From a5256ed4f668df9d32c8a2825e2f915e2e1b3811 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:30:00 +0200 Subject: [PATCH 01/12] Added new config options Added new config options: - showTitlesAsTooltips, to show the Item's title as tooltip for the images; - hidepagination, to hide the pagination buttons under the carousel; - pauseOnHover, to pause the carousel on hover --- ShortcodeCarouselPlugin.php | 42 ++++++++++++++++++++++++++++++------- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/ShortcodeCarouselPlugin.php b/ShortcodeCarouselPlugin.php index 6fd0eab..4033847 100644 --- a/ShortcodeCarouselPlugin.php +++ b/ShortcodeCarouselPlugin.php @@ -15,8 +15,8 @@ public function setUp() public function hookPublicHead($args) { queue_css_file('jcarousel.responsive'); - queue_js_file('jcarousel.responsive'); queue_js_file('jquery.jcarousel.min'); + queue_js_file('jcarousel.responsive'); } /** @@ -76,7 +76,7 @@ public static function carousel($args, $view) if (isset($args['order'])) { $params['sort_dir'] = $args['order']; } - + if (isset($args['collection'])) { $params['collection'] = $args['collection']; } @@ -89,26 +89,54 @@ public static function carousel($args, $view) $params['hasImage'] = 1; $items = get_records('Item', $params, $limit); + if (empty($args['sort']) && isset($args['ids'])) { + // use the order of the ids provided + $ids = explode(',', $args['ids']); + $idsToRecord = array(); + foreach ($items as $it) { + $id = (int)($it->id); + $idsToRecord[$id] = $it; + } + $newItems = array(); + foreach ($ids as $id) { + if (isset($idsToRecord[$id])) { + $newItems[] = $idsToRecord[$id]; + } + } + if ($newItems) { + $items = $newItems; + } + } + //handle the configs for jCarousel $configs = array('carousel' => array()); //carousel configs - if(isset($args['speed'])) { - if(is_numeric($args['speed'])) { + if (isset($args['speed'])) { + if (is_numeric($args['speed'])) { $configs['carousel']['animation'] = (int) $args['speed']; } else { $configs['carousel']['animation'] = $args['speed']; } } - if(isset($args['showtitles']) && $args['showtitles'] == 'true') { + if (isset($args['showtitles']) && $args['showtitles'] == 'true') { $configs['carousel']['showTitles'] = true; } + if (isset($args['showtitlesastooltips']) && $args['showtitlesastooltips'] == 'true') { + $configs['carousel']['showTitlesAsTooltips'] = true; + } + if (isset($args['hidepagination']) && $args['hidepagination'] == 'true') { + $configs['carousel']['hidePagination'] = true; + } //autoscroll configs - if(isset($args['autoscroll']) && $args['autoscroll'] == 'true') { + if (isset($args['autoscroll']) && $args['autoscroll'] == 'true') { $configs['autoscroll'] = array(); - if(isset($args['interval'])) { + if (isset($args['interval'])) { $configs['autoscroll']['interval'] = (int) $args['interval']; } + if (isset($args['pauseonhover'])) { + $configs['autoscroll']['pauseOnHover'] = (bool) $args['pauseonhover']; + } } $configs['carousel']['wrap'] = 'circular'; $html = $view->partial('carousel.php', array('items' => $items, 'id_suffix' => $id_suffix, 'configs' => $configs)); From b5236fd1b9c6183b82ea71fcd0c822647e1af548 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:32:02 +0200 Subject: [PATCH 02/12] Modified chevrons and their behaviour Using now FontAwesome chevrons, and changing their position and opacity on hover --- views/public/css/jcarousel.responsive.css | 73 +++++++++++------------ 1 file changed, 35 insertions(+), 38 deletions(-) diff --git a/views/public/css/jcarousel.responsive.css b/views/public/css/jcarousel.responsive.css index 741b7c2..923bf74 100644 --- a/views/public/css/jcarousel.responsive.css +++ b/views/public/css/jcarousel.responsive.css @@ -1,13 +1,13 @@ .jcarousel-wrapper { - margin: 20px 0 40px; - padding: 10px; + margin: 20px auto; position: relative; - -webkit-box-shadow: 0 0 2px #999; - -moz-box-shadow: 0 0 2px #999; - box-shadow: 0 0 2px #999; + border: 10px solid #fff; -webkit-border-radius: 5px; -moz-border-radius: 5px; border-radius: 5px; + -webkit-box-shadow: 0 0 2px #999; + -moz-box-shadow: 0 0 2px #999; + box-shadow: 0 0 2px #999; } /** Carousel **/ @@ -29,64 +29,62 @@ .jcarousel li { width: 200px; float: left; + border: 1px solid #fff; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; - list-style-type: none; } .jcarousel img { display: block; max-width: 100%; - border: 2px solid transparent; height: auto !important; - margin: auto; - -moz-box-sizing: border-box; - -webkit-box-sizing: border-box; - box-sizing: border-box; -} - -p.shortcode-carousel-title { - margin: 1em 0 0; - text-align: center; } /** Carousel Controls **/ - -.jcarousel-control-prev, -.jcarousel-control-next { - position: absolute; +.jcarousel-controls { + opacity: 0; + position: absolute; top: 50%; - margin-top: -15px; - width: 30px; - height: 30px; - text-align: center; - background: #4E443C; - color: #fff; + margin-top: -1em; + font-size: 2em; + color: white; text-decoration: none; - text-shadow: 0 0 1px #000; - font: 24px/27px Arial, sans-serif; - -webkit-border-radius: 30px; - -moz-border-radius: 30px; - border-radius: 30px; - -webkit-box-shadow: 0 0 4px #F0EFE7; - -moz-box-shadow: 0 0 4px #F0EFE7; - box-shadow: 0 0 4px #F0EFE7; + text-shadow: 1px 1px 0 rgba(255, 255, 255, 0.3); + -webkit-transition: all 0.3s ease-in-out; + -moz-transition: all 0.3s ease-in-out; + -ms-transition: all 0.3s ease-in-out; + -o-transition: all 0.3s ease-in-out; + transition: all 0.3s ease-in-out; } .jcarousel-control-prev { - left: 25px; + left: -50px; } .jcarousel-control-next { - right: 25px; + right: -50px; +} + +.jcarousel-wrapper:hover .jcarousel-control-prev { + opacity: 0.7; + left: 1em; +} + +.jcarousel-wrapper:hover .jcarousel-control-next { + opacity: 0.7; + right: 1em; +} + +.jcarousel-wrapper:hover .jcarousel-controls:hover { + opacity: 1; } /** Carousel Pagination **/ .jcarousel-pagination { position: absolute; - bottom: -30px; + bottom: -40px; left: 50%; -webkit-transform: translate(-50%, 0); -ms-transform: translate(-50%, 0); @@ -110,7 +108,6 @@ p.shortcode-carousel-title { margin-right: 7px; - -webkit-box-shadow: 0 0 2px #4E443C; -moz-box-shadow: 0 0 2px #4E443C; box-shadow: 0 0 2px #4E443C; From 560191943ed289b16f09291945330ac532ba0b31 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:34:26 +0200 Subject: [PATCH 03/12] Added more options for different screen widths --- views/public/javascripts/jcarousel.responsive.js | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/views/public/javascripts/jcarousel.responsive.js b/views/public/javascripts/jcarousel.responsive.js index eb2a62d..1c41bcc 100644 --- a/views/public/javascripts/jcarousel.responsive.js +++ b/views/public/javascripts/jcarousel.responsive.js @@ -6,10 +6,16 @@ .on('jcarousel:create jcarousel:reload', function () { var element = $(this), width = element.innerWidth(); - - if (width >= 600) { - width = width / 3; + // This shows 1 item at a time. + // Divide `width` to the number of items you want to display, + // eg. `width = width / 3` to display 3 items at a time. + if (width >= 900) { + width = width / 5; + } else if (width >= 600) { + width = width / 4; } else if (width >= 350) { + width = width / 3; + } else { width = width / 2; } From 3ec5415c93cbffa89b4bfcf6b334276f5411e24c Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:37:31 +0200 Subject: [PATCH 04/12] Added new options and changed chevrons Added new options: - chance to use Item's title as tooltip for the images; - chance to hide the pagination controls; - chance to pause on hover and resume on mouse leave. Used FontAwesome's chevrons for previous and next buttons --- views/public/carousel.php | 61 ++++++++++++++++++++++++--------------- 1 file changed, 38 insertions(+), 23 deletions(-) diff --git a/views/public/carousel.php b/views/public/carousel.php index d8a8eb2..80cdc3a 100644 --- a/views/public/carousel.php +++ b/views/public/carousel.php @@ -1,40 +1,55 @@
- ‹ - › + + -

+ +

+
From ea6ff3d4ef2d6c1cfea86a1b993ac0001e376359 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:41:46 +0200 Subject: [PATCH 05/12] Create README.md --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..bc8e11d --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# Shortcode Carousel + +## Description +Omeka Classic plugin to add a shortcode to create a carousel of items + +The plugin adds a shortcode to create a carousel of items using jCarousel + +The basic shortcode is [carousel]. + +The shortcode [recent_carousel] and [featured_carousel] are shortcuts to creating a carousel of recent and featured items, respectively. + +## Installation +Uncompress files and rename plugin folder "EmailNotification". + +Then install it like any other Omeka plugin. + +## Options +speed: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: [carousel speed=slow] or [carousel speed=500] + +autoscroll: setting autoscroll=true will make the items automatically scroll + +interval: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: [carousel autoscroll=true interval=700] + +showtitles: setting showtitles=true will display the item title in the carousel. For example [carousel showtitles=true] + + + + + +## Warning +Use it at your own risk. + +It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed. From 74eac70501030bc0c7fba6c2f907e03a12ae59e7 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:43:46 +0200 Subject: [PATCH 06/12] Update README.md --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index bc8e11d..90308b3 100644 --- a/README.md +++ b/README.md @@ -3,11 +3,11 @@ ## Description Omeka Classic plugin to add a shortcode to create a carousel of items -The plugin adds a shortcode to create a carousel of items using jCarousel +The plugin adds a shortcode to create a carousel of items using jCarousel. -The basic shortcode is [carousel]. +The basic shortcode is `[carousel]`. -The shortcode [recent_carousel] and [featured_carousel] are shortcuts to creating a carousel of recent and featured items, respectively. +The shortcode `[recent_carousel]` and `[featured_carousel]` are shortcuts to creating a carousel of recent and featured items, respectively. ## Installation Uncompress files and rename plugin folder "EmailNotification". @@ -15,13 +15,13 @@ Uncompress files and rename plugin folder "EmailNotification". Then install it like any other Omeka plugin. ## Options -speed: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: [carousel speed=slow] or [carousel speed=500] +**speed**: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: `[carousel speed=slow]` or `[carousel speed=500]` -autoscroll: setting autoscroll=true will make the items automatically scroll +**autoscroll**: setting autoscroll=true will make the items automatically scroll -interval: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: [carousel autoscroll=true interval=700] +**interval**: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: `[carousel autoscroll=true interval=700]` -showtitles: setting showtitles=true will display the item title in the carousel. For example [carousel showtitles=true] +**showtitles**: setting showtitles=true will display the item title in the carousel. For example `[carousel showtitles=true]` From 49bdc33d0c20b2cd6feca2aff917b024fddd0356 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:49:23 +0200 Subject: [PATCH 07/12] Update README.md --- README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 90308b3..ff5426e 100644 --- a/README.md +++ b/README.md @@ -14,17 +14,23 @@ Uncompress files and rename plugin folder "EmailNotification". Then install it like any other Omeka plugin. -## Options +## Plugin specific options **speed**: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: `[carousel speed=slow]` or `[carousel speed=500]` **autoscroll**: setting autoscroll=true will make the items automatically scroll **interval**: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: `[carousel autoscroll=true interval=700]` -**showtitles**: setting showtitles=true will display the item title in the carousel. For example `[carousel showtitles=true]` +**pauseonhover**: setting pauseonhover=true will temporarily pause the carousel's scrolling when mouse will be hovering over it. For example: `[carousel pauseonhover=true]` +**showtitles**: setting showtitles=true will display the item title in the carousel. For example: `[carousel showtitles=true]` +**showtitlesastooltips**: setting showtitlesastooltips=true will use the item title as text for image's tooltip in the carousel. For example: `[carousel showtitlesastooltips=true]` +**hidenavigation**: setting hidenavigation=true will hide the carousel's navigation bar. For example: `[carousel hidenavigation=true]` + +## Item shortcode general options +The carousel shortcode uses the same options as the Item: is_featured, tags, user, ids, sort, order, collection and num. ## Warning From f25bec275c9e67063932783b6171869a5fb0d335 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:50:49 +0200 Subject: [PATCH 08/12] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index ff5426e..fe0c79c 100644 --- a/README.md +++ b/README.md @@ -30,8 +30,7 @@ Then install it like any other Omeka plugin. **hidenavigation**: setting hidenavigation=true will hide the carousel's navigation bar. For example: `[carousel hidenavigation=true]` ## Item shortcode general options -The carousel shortcode uses the same options as the Item: is_featured, tags, user, ids, sort, order, collection and num. - +The carousel shortcode uses also the following options, defined for Items: **is_featured**, **tags**, **user**, **ids**, **sort**, **order**, **collection** and **num**. ## Warning Use it at your own risk. From a57248489db3f37e98f7d55bc291d48fdabb4678 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Fri, 7 May 2021 14:51:32 +0200 Subject: [PATCH 09/12] Update README.md --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fe0c79c..d781ff3 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,9 @@ # Shortcode Carousel ## Description -Omeka Classic plugin to add a shortcode to create a carousel of items - -The plugin adds a shortcode to create a carousel of items using jCarousel. - -The basic shortcode is `[carousel]`. +Omeka Classic plugin that adds a shortcode to create a carousel of items using jCarousel. +The basic shortcode is `[carousel]`. The shortcode `[recent_carousel]` and `[featured_carousel]` are shortcuts to creating a carousel of recent and featured items, respectively. ## Installation From 7487278ca9f50234ea3ea607b66c1f138f35abe3 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Sat, 8 May 2021 19:30:52 +0200 Subject: [PATCH 10/12] Update README.md --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d781ff3..0777e66 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ The basic shortcode is `[carousel]`. The shortcode `[recent_carousel]` and `[featured_carousel]` are shortcuts to creating a carousel of recent and featured items, respectively. ## Installation -Uncompress files and rename plugin folder "EmailNotification". +Uncompress files and rename plugin folder "ShortcodeCarousel". Then install it like any other Omeka plugin. @@ -29,6 +29,14 @@ Then install it like any other Omeka plugin. ## Item shortcode general options The carousel shortcode uses also the following options, defined for Items: **is_featured**, **tags**, **user**, **ids**, **sort**, **order**, **collection** and **num**. +## Usage outside of Simple Pages +Theme developers may add support for usage anywhere on their Omeka site. For example, you could create a theme setting called Carousel (as an HTML text area where a user might place the shortcode) and add the following to your homepage or other theme template. +``` +shortcodes($t); +?> +``` ## Warning Use it at your own risk. From 362e8ae3d4e774a43c93e571016c4b5d52b2c1a0 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Sat, 8 May 2021 19:38:41 +0200 Subject: [PATCH 11/12] Update README.md --- README.md | 66 +++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 52 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 0777e66..a1b7a19 100644 --- a/README.md +++ b/README.md @@ -12,22 +12,23 @@ Uncompress files and rename plugin folder "ShortcodeCarousel". Then install it like any other Omeka plugin. ## Plugin specific options -**speed**: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: `[carousel speed=slow]` or `[carousel speed=500]` - -**autoscroll**: setting autoscroll=true will make the items automatically scroll - -**interval**: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: `[carousel autoscroll=true interval=700]` - -**pauseonhover**: setting pauseonhover=true will temporarily pause the carousel's scrolling when mouse will be hovering over it. For example: `[carousel pauseonhover=true]` - -**showtitles**: setting showtitles=true will display the item title in the carousel. For example: `[carousel showtitles=true]` - -**showtitlesastooltips**: setting showtitlesastooltips=true will use the item title as text for image's tooltip in the carousel. For example: `[carousel showtitlesastooltips=true]` - -**hidenavigation**: setting hidenavigation=true will hide the carousel's navigation bar. For example: `[carousel hidenavigation=true]` +- **speed**: sets the speed for the scrolling animation. May be "fast", "slow", or a time in milliseconds. Default is 400. For example: `[carousel speed=slow]` or `[carousel speed=500]` +- **autoscroll**: setting autoscroll=true will make the items automatically scroll +- **interval**: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: `[carousel autoscroll=true interval=700]` +- **pauseonhover**: setting pauseonhover=true will temporarily pause the carousel's scrolling when mouse will be hovering over it. For example: `[carousel pauseonhover=true]` +- **showtitles**: setting showtitles=true will display the item title in the carousel. For example: `[carousel showtitles=true]` +- **showtitlesastooltips**: setting showtitlesastooltips=true will use the item title as text for image's tooltip in the carousel. For example: `[carousel showtitlesastooltips=true]` +- **hidenavigation**: setting hidenavigation=true will hide the carousel's navigation bar. For example: `[carousel hidenavigation=true]` ## Item shortcode general options -The carousel shortcode uses also the following options, defined for Items: **is_featured**, **tags**, **user**, **ids**, **sort**, **order**, **collection** and **num**. +The carousel shortcode uses also the following options, defined for Items: +- **is_featured**, with 1 or 0 +- **user**, with user id +- **ids**, with a range of id +- **sort_field**, with a sort field +- **sort_dir**, with the sort dir "a" or "d" +- **collection**, with the collection id +- **num**, with the number of items to show ## Usage outside of Simple Pages Theme developers may add support for usage anywhere on their Omeka site. For example, you could create a theme setting called Carousel (as an HTML text area where a user might place the shortcode) and add the following to your homepage or other theme template. @@ -37,7 +38,44 @@ Theme developers may add support for usage anywhere on their Omeka site. For exa echo $this->shortcodes($t); ?> ``` + ## Warning Use it at your own risk. It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed. + +## Troubleshooting + +See online issues on the [plugin issues] page on GitHub. + +## License + +This plugin is published under [GNU/GPL]. + +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 3 of the License, or (at your option) any later +version. + +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more +details. + +You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +## Copyright + +* Copyright Omeka Team, 2014-2019 +* Copyright Daniel Berthereau, 2020 (see [Daniel-KM] on GitHub) +* Copyright Daniele Binaghi, 2021 (see [DBinaghi] on GitHub) + + +[Shortcode Carousel]: https://github.com/omeka/plugin-ShortcodeCarousel +[Omeka]: https://omeka.org/classic +[plugin issues]: http://omeka.org/forums/forum/plugins +[GNU/GPL]: https://www.gnu.org/licenses/gpl-3.0.html +[Daniel-KM]: https://github.com/Daniel-KM "Daniel Berthereau" +[DBinaghi]: https://github.com/DBinaghi "Daniele Binaghi" From 7a37c3f9827a6e263e00a988508e3c72fd9f78f2 Mon Sep 17 00:00:00 2001 From: DBinaghi <39097246+DBinaghi@users.noreply.github.com> Date: Sun, 16 May 2021 22:13:59 +0200 Subject: [PATCH 12/12] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a1b7a19..0578443 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Then install it like any other Omeka plugin. - **interval**: when autoscroll is on, interval sets the interval between scrolling in milliseconds. Default is 3000. For example: `[carousel autoscroll=true interval=700]` - **pauseonhover**: setting pauseonhover=true will temporarily pause the carousel's scrolling when mouse will be hovering over it. For example: `[carousel pauseonhover=true]` - **showtitles**: setting showtitles=true will display the item title in the carousel. For example: `[carousel showtitles=true]` -- **showtitlesastooltips**: setting showtitlesastooltips=true will use the item title as text for image's tooltip in the carousel. For example: `[carousel showtitlesastooltips=true]` +- **showtitlesastooltips**: setting showtitlesastooltips=true will use the item title as text for image's tooltip in the carousel. For example: `[carousel showtitles=true showtitlesastooltips=true]` - **hidenavigation**: setting hidenavigation=true will hide the carousel's navigation bar. For example: `[carousel hidenavigation=true]` ## Item shortcode general options