PHPackages                             markocupic/gallery-creator-bundle - 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. markocupic/gallery-creator-bundle

ActiveContao-bundle[Utility & Helpers](/categories/utility)

markocupic/gallery-creator-bundle
=================================

gallery extension for Contao CMS

3.1.3(3mo ago)86.1k↓50%4[1 issues](https://github.com/markocupic/gallery-creator-bundle/issues)[1 PRs](https://github.com/markocupic/gallery-creator-bundle/pulls)1LGPL-3.0+PHPPHP ^8.1CI failing

Since Dec 25Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/markocupic/gallery-creator-bundle)[ Packagist](https://packagist.org/packages/markocupic/gallery-creator-bundle)[ RSS](/packages/markocupic-gallery-creator-bundle/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelogDependencies (4)Versions (65)Used By (1)

[![Marko Cupic](docs/img/logo.png?raw=true "Marko Cupic")](docs/img/logo.png?raw=true)

Gallery Creator Bundle
======================

[](#gallery-creator-bundle)

Frontend and backend extension for [Contao CMS](https://www.contao.org)
-----------------------------------------------------------------------

[](#frontend-and-backend-extension-for-contao-cms)

This extension can be used to create, display and manage photo albums in your [Contao](https://www.contao.org) installation. The Gallery Creator Bundle offers an album listing and an album detail view. Since version 2.0.0 [markdown](https://www.markdownguide.org/) can be used to create the album description.

    Gallery.Creator.mp4    Installation
------------

[](#installation)

Please use the Contao Manager or run `composer require markocupic/gallery-creator-bundle`in your CLI to install the extension.

CHMOD
-----

[](#chmod)

Go to the **Contao Backend Settings** and select a default **album owner**, a **default album owner group** and set the default **access rights**

**Important**: If you keep the "album owner" field empty, the currently logged in backend user automatically becomes the album owner when creating a new album.

[![chmod](docs/img/chmod.png)](docs/img/chmod.png)

Lightbox
--------

[](#lightbox)

As a lightbox we strongly recommend [Glightbox](https://biati-digital.github.io/glightbox/). Simply run the `composer require inspiredminds/contao-glightbox` command in your CLI. Please ensure, that you have activated the lightbox template in the layout settings of your theme in the Contao backend.

CSS
---

[](#css)

Gallery Creator will add the `.gc-listing-view` and/or the `.gc-detail-view` to the body tag. This will help you display or hide items you don't want to show in both modes (listing- & detail-view).

```
/** SASS
 * Do not display ce elements headline in detail mode
 *
 */
body.gc-detail-view {
  .ce_gallery_creator {
    h2:not([class^="gc-album-detail-name"]) {
      display: none;
    }
  }
}

```

Configuration
-------------

[](#configuration)

This gallery extension is shipped with a default configuration. If you want to override these settings, you can do this in your common configuration file located in `config/config.yml`.

```
# config/config.yml
# Gallery Creator (default settings)
markocupic_gallery_creator:
  upload_path: 'files/gallery_creator_albums'
  copy_images_on_import: true
  read_exif_meta_data: false
  valid_extensions: ['jpg', 'jpeg', 'gif', 'png', 'webp', 'svg', 'svgz']

# Contao configuration
contao:
 url_suffix: ''
 #....
```

"galleryCreatorGenerateFrontendTemplate" - Hook
-----------------------------------------------

[](#gallerycreatorgeneratefrontendtemplate---hook)

Use the "galleryCreatorGenerateFrontendTemplate" hook to adapt the frontend output.

The "galleryCreatorGenerateFrontendTemplate" hook is triggered before the gallery creator front end template is parsed. It passes the content element object, the template object and the album object of the active album (if there is one). The "galleryCreatorGenerateFrontendTemplate" hook expects no return value.

```