Download the PHP package eab/fancy-gallery-bundle without Composer
On this page you can find all versions of the php package eab/fancy-gallery-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eab/fancy-gallery-bundle
More information about eab/fancy-gallery-bundle
Files in eab/fancy-gallery-bundle
Package fancy-gallery-bundle
Short Description A simple gallery bundle for eZ Publish, using FancyBox
License
Informations about the package fancy-gallery-bundle
EabFancyGalleryBundle
Summary
A simple gallery bundle for eZ Publish, using FancyBox.
Author
Andy Caiger [email protected]
Copyright
Copyright (C) 2014-2015 Enterprise AB Ltd
License
Licensed under GNU General Public License 2.0
Requirements
Installation
-
Install EabFancyGalleryBundle using composer:
composer require --update-no-dev --prefer-dist eab/fancy-gallery-bundle
Composer will install the bundle and its dependencies into
vendors
.You can use git to install into the
src
subtree:git clone https://github.com/eab-dev/EabFancyGalleryBundle.git src/Eab/FancyGalleryBundle
-
Enable the bundle in the kernel by editing
ezpublish/EzPublishKernel.php
: -
Install the latest version of FancyBox:
php ezpublish/console sp:bower:install php ezpublish/console assets:install --symlink
If when installing the bower assets you see an error message like:
ECMDERR Failed to execute "git ls-remote --tags --heads git://github.com/fancyapps/fancyBox.git", exit code of #128 fatal: unable to connect to github.com
the quick workaround is to disable the git:
protocol:
git config --global url."https://".insteadOf git://
and run the install command again.
Configuration
If your bundle is not extending eZDemoBundle, you need to tell EabFancyGalleryBundle which pagelayout template to use. There are two easy ways to do this:
-
Edit
ezpublish/config/config.yml
:eab_fancy_gallery: pagelayout: AcmeMyBundle::pagelayout.html.twig
-
In your own bundle, edit a file such as
src/Acme/MyBundle/Resources/config/services.yml
and add:parameters: eab_fancy_gallery.pagelayout: AcmeMyBundle::pagelayout.html.twig
With this second method make sure that your bundle is loaded after EabFancyGalleryBundle.
Customizing
The following settings can be configured in the same way as pagelayout
:
summary_in_full_view
- whether or not to show the summarypage_limit
- number of images to show per pagechildren_types
- array of content types that should be displayed in the galleryimage_variation
- the image variation to use for thumbnails
You can also override the templates by copying Resources/config/override.yaml
into your own bundle's configuration and changing the controllers or templates
(hint: change the keys e.g. change image:
to image_override:
).
The FancyBox CSS is loaded by the gallery template. If you want to load it on all pages you need to:
-
Override
full/gallery.html.twig
with your own template that doesn't load the CSS. -
Edit your
page_header_style.html.twig
template and include the FancyBox CSS asset:{% stylesheets filter='cssrewrite,?cssmin' ... 'bundles/eabfancygallery/components/fancybox/source/jquery.fancybox.css' ... %} <link rel="stylesheet" type="text/css" href="{{ asset_url }}"/> {% endstylesheets %}
Updating
After installing this bundle you can run ezpublish/console sp:bower:install
to update the Fancybox assets at any time. Take care: it will update other
bower assets as well!
Caveats
-
This bundle assumes your website uses Bootstrap 3. If it doesn't you'll need to override and modify the templates. See the example template for Bootstrap 2.
- The configuration for this bundle is not siteaccess aware. If your site has different layouts for different siteaccesses, you can either override the gallery and image templates for each of your siteaccesses, or else reprogram the way that the 'pagelayout' template variable is set. So please fork the repository, rewrite the code and issue a pull request. Thanks!