kitsguru/piwigo-bootstrap-darkroom

A mobile-ready and feature-rich theme for Piwigo photo gallery, based on Bootstrap Default

Piwigo Bootstrap Darkroom with Home

Forked from https://github.com/tkuther/piwigo-bootstrap-darkroom Adds a Home -> back to main site link in menu

A mobile-ready Piwigo theme based on Bootstrap Default by Phil Bayfield.

Features

• Various color styles and sub-themes
  • Bootswatch support
  • Material Design included
  • A custom dark color scheme based on Lightroom® colors (the default)
• Full screen slideshow view using PhotoSwipe
  • Supports auto play
  • Supports HTML5 video
  • Album thumbnails can be linked to PhotoSwipe directly (like smartpocket)
• Configurable carousel album navigation on the picture page using slick slider
• Video support on both the picture page and inside the slideshow, using native HTML 5 video widget
• 100% mobile ready
  • fully responsive Navbars, Carousel, PhotoSwipe slideshow, video content
  • async/ondemand loading of carousel & PhotoSwipe content, adaptive image size selection, swipe & tap events
• Various configuration options

Usage

1. Installation. Use one of:

• Git clone and move to piwigo/themes/bootstrap_darkroom
• Download from http://piwigo.org/ext/extension_view.php?eid=831
• Or just use the Extension Manager

2. Install the Bootstrap Default theme, too
3. Enable Bootstrap Darkroom
4. To use it as the standard theme for mobile devices, you need to disable the Smartpocket theme (if enabled). In combination with the recommended plugins and by setting "Thumbnail link target" to "PhotoSwipe" or "PhotoSwipe (mobile devices only)" it will behave like smartpocket (click on thumbnail opens the slideshow, masonry style thumbnail page with ajax loading).

Demo

A demo is available at https://pwgdemo.kuther.net

Documentation

• Github Wiki
• Forum thread
• Issue tracker

Recommended Plugins for best mobile user experience

• GThumb+ or gdThumb: this will give you masonry-style thumbnail pages that make most use of valuable space.
• RV Thumbnail Scroller: this one will load items on the thumbnails page as they are requested using ajax, ideal for swiping through albums while keeping the initial page load size small. Avoids pagination.

Known issues

• The secondary navbar on the picture page might span several lines, depending on the length of the category/picture name. As a workaround, the number of nested levels is truncated to max 2 levels by default.
• On iOS the PhotoSwipe fullscreen mode isn't supported. On iPhone it does work in landscape orientation only, on iPad it doesn't work at all. That's an iOS bug. Works just fine on Android
• Plugins that add buttons to the Navbar might not (yet) be supported, see Plugin Support Matrix
• The Sidebar, if enabled in settings, doesn't play well with Bootswatch Themes. You need to CSS-style the sidebar yourself.
• Portrait mode videos (e.g. from mobile phones) need to be recoded in actual portrait orientation, rotation tags won't work.

Preview

License

Copyright 2016 Thomas Kuther

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.