{"id":848,"date":"2017-05-29T09:00:16","date_gmt":"2017-05-29T13:00:16","guid":{"rendered":"https:\/\/inlibro.com\/?page_id=848\/"},"modified":"2025-06-18T11:56:54","modified_gmt":"2025-06-18T15:56:54","slug":"carousel-instructions","status":"publish","type":"page","link":"https:\/\/inlibro.com\/en\/carousel-instructions\/","title":{"rendered":"Carousel Instructions"},"content":{"rendered":"<p>[et_pb_section fb_built=&#8221;1&#8243; admin_label=&#8221;section&#8221; _builder_version=&#8221;4.16&#8243; global_colors_info=&#8221;{}&#8221;][et_pb_row admin_label=&#8221;row&#8221; _builder_version=&#8221;4.16&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.16&#8243; custom_padding=&#8221;|||&#8221; global_colors_info=&#8221;{}&#8221; custom_padding__hover=&#8221;|||&#8221;][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h1>Carousel Instructions<\/h1>\n<h2>Description<\/h2>\n<p>This handy extension is designed to promote your OPAC&#8217;s collections. In just a few clicks you can generate multiple cover image carousels from lists, reports or collection codes (952 $8 code &#8211; of items) to increase their visibility.<\/p>\n<p>&nbsp;<\/p>\n<p>This extension also offers several configurations:<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>carousel display styles<\/li>\n<li>carousel appearance order<\/li>\n<li>title, text and background color<\/li>\n<li>autorotation<\/li>\n<li>single display per library<\/li>\n<li>external URLs that allow redirection to an external source contained within the 856 $ u of records.<\/li>\n<li>URL suffixes used for integration of statistical analysis tools.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>[\/et_pb_text][et_pb_code _builder_version=&#8221;4.16&#8243; global_colors_info=&#8221;{}&#8221;]<a class=\"et_pb_button et_pb_custom_button_icon download_carroussel_btl et_pb_button_0 et_pb_module et_pb_bg_layout_light\" href=\"\/wp-content\/uploads\/koha-plugins\/Carrousel\/koha-plugin-carrousel-4.3.6.kpz\" data-icon=\"\ue092\" download>Download<\/a>[\/et_pb_code][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.23.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.23.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text _builder_version=&#8221;4.27.0&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<div class='et-box et-warning'>\n\t\t\t\t\t<div class='et-box-content'><strong>Warning<\/strong><\/p>\n<p>If your Koha system currently has a carousel plugin installed, begin by uninstalling the previous version. Next, upload and install the latest version (4.3.5+).<\/div><\/div>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.23.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.23.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_text _builder_version=&#8221;4.23.4&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<div class='et-box et-info'>\n\t\t\t\t\t<div class='et-box-content'><strong>Info<\/strong><\/p>\n<p><strong>Koha 19.05 and older versions<\/strong><\/p>\n<p>While generating the carousel, the plugin will insert the code in the OpacMainUserBlock system preference surrounded by HTML tags.<\/p>\n<p><strong>Koha 20.05 and newer versions<\/strong><\/p>\n<p>In the most recent Koha version, the carousel content code will be added in an OpacMainUserBlock within the HTML customization tools.<\/div><\/div>\n<p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#8221;4.16&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; global_colors_info=&#8221;{}&#8221;][et_pb_column type=&#8221;4_4&#8243; _builder_version=&#8221;4.16&#8243; custom_padding=&#8221;|||&#8221; global_colors_info=&#8221;{}&#8221; custom_padding__hover=&#8221;|||&#8221;][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>Carousel Configurations<\/h3>\n<p>\u00a0To access the configurations page, click on the &#8216;Action &gt; Configure&#8217; button of the Carousel extension in the Koha plugin page.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carousel_configs_en.png&#8221; title_text=&#8221;carousel_configs_en&#8221; align=&#8221;center&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>Add carousels<\/h3>\n<p>First, choose a carousel source:<\/p>\n<p style=\"padding-left: 40px;\">&#8211; Lists: select one or more lists.<\/p>\n<p style=\"padding-left: 40px;\">&#8211; Reports: Check one or more reports.<\/p>\n<p style=\"padding-left: 120px;\"><em>Important notes<\/em>:<br \/>&#8212;&gt; <em>The report must have a &#8216;biblionumber&#8217; column (without AS &#8216;&#8230;&#8217;) and no drop-down menu at runtime. If these criteria are not met, the report will not appear in the report choices<\/em>.<\/p>\n<p style=\"padding-left: 40px;\">&#8211; Collection code (952$ 8 in the item record): Check one or more codes.<\/p>\n<p>Once these options have been selected, choose your carousel preferences at the top of the page&#8230;<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>Carousel options<\/h3>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4>Title:<\/h4>\n<p>Text to be displayed as the carousel title. If this field is left empty, the list name will be used instead.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carousel_title_en.png&#8221; alt=&#8221;example of the carousel mode view&#8221; title_text=&#8221;carousel_title_en&#8221; align=&#8221;center&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>Carousel type<\/h3>\n<p>Select a display style&#8230;<\/p>\n<p>[\/et_pb_text][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4>Carousel mode<\/h4>\n<p>The images are arranged in a circle with a 3D perspective effect, this is the classic carousel view.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/type_carrousel-1.png&#8221; alt=&#8221;example of the carousel mode view&#8221; title_text=&#8221;type_carrousel&#8221; align=&#8221;center&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4><strong>Carousel &#8211; scrolling mode<\/strong><\/h4>\n<p>This mode is a modernized version of the carousel, with images presented horizontally.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carrousel_defilement-1.png&#8221; alt=&#8221;example of the scrolling mode view&#8221; title_text=&#8221;carrousel_defilement&#8221; align=&#8221;center&#8221; _builder_version=&#8221;4.27.0&#8243; _module_preset=&#8221;default&#8221; width=&#8221;70%&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; _module_preset=&#8221;default&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h4><strong>Carousel &#8211; scrolling with title mode<\/strong><\/h4>\n<p>This mode is an alternative to the &#8220;Scrolling&#8221; view, and it also shows the document title below the image.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carrousel_defilement-titre2-1.png&#8221; alt=&#8221;example of the scrolling mode view&#8221; title_text=&#8221;carrousel_defilement-titre2&#8243; align=&#8221;center&#8221; _builder_version=&#8221;4.27.0&#8243; _module_preset=&#8221;default&#8221; width=&#8221;86%&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>External URL<\/h3>\n<p>This function redirects the user after a click on one of the images in the carousel. When enabled, Koha opens the URL link indicated in the 856$u field of the record. If the record does not contain a link in this zone, or if the function is deactivated, the image will lead directly to the corresponding record in your catalog.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carousel_url.png&#8221; alt=&#8221;view of the %22external url%22 carousel parameter&#8221; title_text=&#8221;carousel_url&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>URL suffix<\/h3>\n<p>This parameter allows you to add a suffix to the URLs of a particular carousel. It can be used to integrate analytics tools into your OPAC and track which images users click on.<\/p>\n<p>suffix examples:<\/p>\n<ul>\n<li>?clickAnalyse=1<\/li>\n<li>?utm_source=carousel<\/li>\n<\/ul>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/caroussel_suffix_en.png&#8221; alt=&#8221;view of %22?clickAnalyse=1%22 in the suffix text box &#8221; title_text=&#8221;caroussel_suffix_en&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][et_pb_text _builder_version=&#8221;4.27.0&#8243; background_size=&#8221;initial&#8221; background_position=&#8221;top_left&#8221; background_repeat=&#8221;repeat&#8221; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; global_colors_info=&#8221;{}&#8221;]<\/p>\n<h3>Carousel Generation<\/h3>\n<p>To generate your new carousels:<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>In the Koha plugins page (Administration &gt; Koha plugins page), click on the &#8216;Action&#8217;, and select &#8216;Execute&#8217; button<\/li>\n<li>Then, click on &#8216;Generate&#8217;. <\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p>This should add your carousels to your OPAC.<\/p>\n<p>[\/et_pb_text][et_pb_image src=&#8221;https:\/\/inlibro.com\/wp-content\/uploads\/2025\/05\/carousel_generate_en.png&#8221; title_text=&#8221;carousel_generate_en&#8221; align_tablet=&#8221;center&#8221; align_phone=&#8221;&#8221; align_last_edited=&#8221;on|desktop&#8221; _builder_version=&#8221;4.27.0&#8243; use_border_color=&#8221;off&#8221; border_color=&#8221;#ffffff&#8221; border_style=&#8221;solid&#8221; animation=&#8221;off&#8221; sticky=&#8221;off&#8221; always_center_on_mobile=&#8221;on&#8221; global_colors_info=&#8221;{}&#8221;][\/et_pb_image][\/et_pb_column][\/et_pb_row][\/et_pb_section]<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Carousel Instructions Description This handy extension is designed to promote your OPAC&#8217;s collections. In just a few clicks you can generate multiple cover image carousels from lists, reports or collection codes (952 $8 code &#8211; of items) to increase their visibility. &nbsp; This extension also offers several configurations: carousel display styles carousel appearance order title, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","inline_featured_image":false,"twitterCardType":"summary_large_image","cardImageID":0,"cardImage":"","cardTitle":"","cardDesc":"","cardImageAlt":"","cardPlayer":"","cardPlayerWidth":0,"cardPlayerHeight":0,"cardPlayerStream":"","cardPlayerCodec":"","footnotes":""},"class_list":["post-848","page","type-page","status-publish","hentry"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/pages\/848","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/comments?post=848"}],"version-history":[{"count":48,"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/pages\/848\/revisions"}],"predecessor-version":[{"id":21465,"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/pages\/848\/revisions\/21465"}],"wp:attachment":[{"href":"https:\/\/inlibro.com\/en\/wp-json\/wp\/v2\/media?parent=848"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}