PHPackages machwatt/sf\_filecollection\_gallery - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. machwatt/sf\_filecollection\_gallery ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) machwatt/sf\_filecollection\_gallery ==================================== Simple Image Gallery which renders a FileCollection containing static or folder based images. 1.5.0(7y ago)92.6k10[14 issues](https://github.com/machwatt/sf_filecollection_gallery/issues)GPL-2.0+PHP Since Feb 16Pushed 4y ago6 watchersCompare [ Source](https://github.com/machwatt/sf_filecollection_gallery)[ Packagist](https://packagist.org/packages/machwatt/sf_filecollection_gallery)[ Docs](https://github.com/machwatt/sf_filecollection_gallery)[ RSS](/packages/machwatt-sf-filecollection-gallery/feed)WikiDiscussions master Synced yesterday READMEChangelog (10)Dependencies (1)Versions (9)Used By (0) Simple FileCollection Gallery ============================= [](#simple-filecollection-gallery) Simple Image Gallery which renders a FileCollection containing static or folder based images. It provides a simple layout with pagination and a lightbox. Based on fluid templating the frontend layout can be edited fast and easy. Since this gallery renders a set of files from a FileCollection it may render something else than an image gallery, depending on the provided template. (e.g. List of downloadable files). Installation ------------ [](#installation) Install Simple FileCollection Gallery and include the static template. Settings -------- [](#settings) Simple FileCollection Gallery provides settings to customize the output. ``` view.templateRootPaths = The root path for templates as fallback array view.partialRootPaths = The root path for partials as fallback array view.layoutRootPaths = The root path for layouts as fallback array settings.lightbox = Additional output for lightbox settings, default 'lightbox' settings.enableLightbox = Switch if lightbox is enabled NOTE: You need some other extension (or anything else) to render that lightbox. settings.cssFile = Path to CSS File settings.image.width = Width of single image settings.image.height = Height of single image settings.image.lightboxWidth = The maxWidth of the lightbox image ``` Usage ----- [](#usage) Create a FileCollection somewhere in the page tree of your TYPO3 Installation. Select the FileCollection(s) in the plugin via wizard or page tree. The order of the images is like the sorting in the FileCollection and the order of collections in the plugin. There are some more options for the plugin: ``` fileCollection = the selected fileCollection(s) imagesPerPage = Sets the count of images to be rendered per pagination page numberOfPages = Sets the count of visible pages in the pagination list insertAbove = Switches the pagination above the images list insertBelow = Switches the pagination below the images list enableLightbox = Switches if a lightbox is enabled for the images list NOTE: You need some other extension (or anything else) to render that lightbox. enableDescription = If the metadata 'description' is provided, this switches the description below a single image ``` Templating ---------- [](#templating) Since Version 1.2.0 it is possible to use nested layouts with an preview image per included FileCollection. Thanks to [Ferhat36](https://github.com/Ferhat67) Since Version 1.1 of sf\_filecollection\_gallery it is possible to use the templateRootPaths array to provide some more template folders with fallback. Currently there are two templates used, look at them in Resources/Private/Templates: - Gallery/List.html for the Gallery View - Paginate/Index.html for the pagination widget ### Creating an own template [](#creating-an-own-template) If you want to provide an own template just add another entry to the templateRootPaths array in your TS: ``` plugin.tx_sffilecollectiongallery { view.templateRootPaths.1 = fileadmin/path/to/Templates } ``` You might want to add some slider functionality, so we used [bxSlider](http://www.bxslider.com) for this simple tutorial. All you need to do is render the FileCollection items as an unordered list and given that you included the CSS and JS for bxSlider already, add some handy JS initialization on document.ready. Your new Gallery/List.html file might look something like this: ``` {namespace s=SKYFILLERS\SfFilecollectionGallery\ViewHelpers} ``` And the JS to get this started is as following: ``` $(document).ready(function(){ $('.fadeImages').bxSlider(); }); ``` Shiny! Of course you might add some more complex fluid templating. ### Use content element uid in template [](#use-content-element-uid-in-template) Since version 1.1.4 it is possible to use the elements uid in your template. This is necessary for some JS functionality like lightboxes or sliders. The uid can be accessed via: {currentUid} Credits ------- [](#credits) This extension uses some third party code. - [Array Pagination Widget](http://blog.teamgeist-medien.de/2014/01/extbase-fluid-widget-paginate-viewhelper-mit-array-unterstuetzung.html)An Array Pagination Widget provided by Paul Beck and Armin Ruediger Vieweg - [IncludeFileViewHelper](https://github.com/georgringer/news)A ViewHelper for including the css file via the extension layout, provided by Georg Ringer in his news extension. ### Health Score 31 — LowBetter than 68% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community21 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 54.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~227 days Recently: every ~190 days Total 6 Last Release 2603d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6b20be8494bc38c30682df77dbbf5285342a0f6b7dc3a9402b88a7685ad554a0?d=identicon)[machwatt](/maintainers/machwatt) --- Top Contributors [![machwatt](https://avatars.githubusercontent.com/u/3843667?v=4)](https://github.com/machwatt "machwatt (53 commits)")[![derhansen](https://avatars.githubusercontent.com/u/2629896?v=4)](https://github.com/derhansen "derhansen (19 commits)")[![Patta](https://avatars.githubusercontent.com/u/2151127?v=4)](https://github.com/Patta "Patta (12 commits)")[![mmunz](https://avatars.githubusercontent.com/u/3017481?v=4)](https://github.com/mmunz "mmunz (3 commits)")[![runepiper](https://avatars.githubusercontent.com/u/4521147?v=4)](https://github.com/runepiper "runepiper (3 commits)")[![Ferhat67](https://avatars.githubusercontent.com/u/10166858?v=4)](https://github.com/Ferhat67 "Ferhat67 (3 commits)")[![malteriechmann](https://avatars.githubusercontent.com/u/656568?v=4)](https://github.com/malteriechmann "malteriechmann (1 commits)")[![Konafets](https://avatars.githubusercontent.com/u/363363?v=4)](https://github.com/Konafets "Konafets (1 commits)")[![a-r-m-i-n](https://avatars.githubusercontent.com/u/1275298?v=4)](https://github.com/a-r-m-i-n "a-r-m-i-n (1 commits)")[![nbebaw](https://avatars.githubusercontent.com/u/57049550?v=4)](https://github.com/nbebaw "nbebaw (1 commits)") --- Tags collectionimagesextensiongallerytypo3 ### Embed Badge ![Health badge](/badges/machwatt-sf-filecollection-gallery/health.svg) ``` [![Health](https://phpackages.com/badges/machwatt-sf-filecollection-gallery/health.svg)](https://phpackages.com/packages/machwatt-sf-filecollection-gallery) ``` ### Alternatives [friendsoftypo3/tt-address Displays a list of addresses from an address table on the page. 431.7M38](/packages/friendsoftypo3-tt-address)[quellenform/t3x-iconpack Provides an iconpack-registry for custom iconpacks. 1542.7k25](/packages/quellenform-t3x-iconpack)[georgringer/faker Faker for TYPO3 165.1k](/packages/georgringer-faker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)