{"id":20961872,"url":"https://github.com/heimrichhannot/contao-tiny-slider-bundle","last_synced_at":"2025-08-16T16:09:11.349Z","repository":{"id":46042803,"uuid":"156389079","full_name":"heimrichhannot/contao-tiny-slider-bundle","owner":"heimrichhannot","description":"Tiny slider, a vanilla javascript content slider for contao.","archived":false,"fork":false,"pushed_at":"2025-03-21T09:20:59.000Z","size":272,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-14T07:36:01.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heimrichhannot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-11-06T13:37:54.000Z","updated_at":"2025-03-21T09:20:57.000Z","dependencies_parsed_at":"2024-06-07T10:30:03.690Z","dependency_job_id":"b511e7c5-bf32-49c5-8482-f202a9bc1329","html_url":"https://github.com/heimrichhannot/contao-tiny-slider-bundle","commit_stats":{"total_commits":100,"total_committers":9,"mean_commits":11.11111111111111,"dds":0.6,"last_synced_commit":"770c6cf44d8a85efcc3d07bbcc58f431a5ddc565"},"previous_names":[],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/heimrichhannot/contao-tiny-slider-bundle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-tiny-slider-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-tiny-slider-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-tiny-slider-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-tiny-slider-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heimrichhannot","download_url":"https://codeload.github.com/heimrichhannot/contao-tiny-slider-bundle/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-tiny-slider-bundle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270735226,"owners_count":24636324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T02:18:04.548Z","updated_at":"2025-08-16T16:09:11.323Z","avatar_url":"https://github.com/heimrichhannot.png","language":"PHP","readme":"# Tiny slider bundle\n\nA slider bundle for contao based on [Tiny Slider](https://github.com/ganlanyuan/tiny-slider).\n\n## Features\n* global configuration\n* content elements for image and content sliders\n* [Encore Bundle](https://github.com/heimrichhannot/contao-encore-bundle) support\n* show [List Bundle](https://github.com/heimrichhannot/contao-list-bundle) list as slider\n* bundled config element type for [List Bundle](https://github.com/heimrichhannot/contao-list-bundle) and [Reader Bundle](https://github.com/heimrichhannot/contao-reader-bundle)\n\n## Usage\n\n### Install\n1. install bundle with composer or contao manager\n\n    ```\n    composer require heimrichhannot/contao-tiny-slider-bundle\n    ```\n1. Call contao install tool and update the database\n\n### Setup\n1. Create a tiny slider config (System -\u003e Tiny-Slider). Please consider the tiny slider documentation for more informations about the different config options.\n1. Select the created config in a content element, an reader config element or in an list config after activating \"Render as Tiny slider\".\n\n\n### Usage as config element type (list and reader bundle)\n\nThis bundle comes with an [config element type](https://github.com/heimrichhannot/contao-config-element-type-bundle), already registered for list and reader bundle. \n\n1. Add 'Slider (Tiny Slider)' as list or reader config element to your configuration\n1. your defined template variable has two keys, html and images. html contains the complete slider, images just the prepared images if you want to define your own wrapper. So your typical template code to output a slider would be:\n\n```twig\n{% if tinySlider.html is defined %}\n    {{ tinySlider.html }}\n{% endif %}\n```\n\n\n## Twig usage\n\nTiny slider comes with an `tiny_slider_wrapper.html.twig` that can be embedded inside your custom twig template like the following:\n\n```\n{% set tinySliderConfigId = 1 %}\n{% embed '@ContaoTinySlider/tiny_slider_wrapper.html.twig' with {config: tinySliderConfigId, selector: '.list-images', wrapperClass: 'overflow-hidden'} %}\n    {% block slides %}\n        \u003cdiv class=\"image-container\" {{ aos.default() }}\u003e\n        \u003cul class=\"list-images list-unstyled\"\u003e\n            {% for i, singleSRC in multiSRC %}\n                \u003cli class=\"image\"\u003e\n                    {{ singleSRC|image([240,180,'px'],{href : url, lazyload: {class: 'tns-lazy-img', src: 'data-src'}})|raw }}\n                \u003c/li\u003e\n            {% endfor %}\n        \u003c/ul\u003e\n        \u003c/div\u003e\n    {% endblock %}\n{% endembed %}\n```\n\nThere are also two twig extension available:\n\n**tiny_slider_wrapper_class**\n\nReturns the tiny slider wrapper css classes.\n\n```\n{% set tinySliderConfigId = 1 %}\n{{ tinySliderConfigId|tiny_slider_wrapper_class}}\n```\n\n**tiny_slider_container_attributes**\n\nReturns the tiny slider `data-tiny-slider-config` attribute for the container inside the wrapper. The parameter `selector` is optional and should point to the slides wrapper container. \n\n```\n{% set tinySliderConfigId = 1 %}\n{{ config|tiny_slider_container_attributes(selector|default('.tiny-slider-container'))|raw }}\n```\n\n## Custom transition effects\n\nIn order to use custom transitions for example using [animate.css](https://daneden.github.io/animate.css/) choose from the following effects.\n\n### Fade effect\n\n- import animate.css stylesheet\n- set tiny slider config parameter `Mode` to `gallery`\n- set tiny slider config parameter `Intro animation` to 'fadeIn'\n- set tiny slider config parameter`Outro animation` to 'fadeOut'\n- empty tiny slider config parameter `Normal animation`\n\n\n## Assets\n\n### NPM/Yarn Package\n\nThe assets for this bundle are provided as NPM/Yarn package `@hundh/contao-tiny-slider-bundle`. \n\n[![npm version](https://badge.fury.io/js/%40hundh%2Fcontao-tiny-slider-bundle.svg)](https://badge.fury.io/js/%40hundh%2Fcontao-tiny-slider-bundle)\n\nYou will find the sources under [src/Resources/npm-package](src/Resources/npm-package).\n\n## Known Issues\n\n### Lazyload\n\nIf you use tiny-slider together with `https://github.com/heimrichhannot/contao-speed-bundle` and its lazyload compoment enabled in page layout, ensure that you enabled `Lazy load` in tiny slider configuration as well and keep the `Lazy load selector` default value to `.tns-lazy-img`.\n\nIf you use the TwigExtension `image` that you must provide proper lazyload information in `data` attributes:\n\n```\n{{ singleSRC|image([240,120,'px'],{lazyload: {class: 'tns-lazy-img', src: 'data-src'} }}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-tiny-slider-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheimrichhannot%2Fcontao-tiny-slider-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-tiny-slider-bundle/lists"}