Package: sc.galleria.support
Table of ContentsOverviewUsing in a Plone SiteStep 1: Activate itStep 2: Setting preferencesStep 3: Seeing it in actionFunctionalityDefault optionsYouTube, Vimeo & DailyMotion supportedFlickr, Picasa & Facebook PluginsHistory PluginMostly HarmlessInstallationPlone 3.3.x Buildout Installation:Plone 4.0.x Buildout Installation:Plone 4.1.x or greater Buildout Installation:UninstallContributorsChangelog1.0.1 (2017-01-11)1.0 (2013-01-27)1.0rc1 (2012-09-07)1.0b4 (2012-06-21)1.0b3 (2012-05-28)1.0b2 (2012-05-19)1.0b1 (2012-05-18)Overviewsc.galleria.supportprovides simple gallery integration for Plone.Using in a Plone SiteStep 1: Activate itGo to the ‘Site Setup’ page in the Plone interface and click on the
‘Add/Remove Products’ link.Choose the productsc.galleria.support(check checkbox at its left side)
and click the ‘Activate’ button.Step 2: Setting preferencesIn ‘Site setup’ below on ‘Add-on Configuration’ click on ‘Galleria’ option. In
this section you can see several options wich are categorized in different
types. Each type is visualized in a tab. You have options for ‘Default’,
‘Flickr Plugin’, ‘Picasa Plugin’, ‘FaceBook Plugin’ and ‘History Plugin’.
To know how to setup this preferences in a way to go better to your needs seeFunctionalitysection.Step 3: Seeing it in actionGalleria will be rendered through a set of the display action in a container
content type. For example, if you have a folder named “My folder” and you are
standing there, click on “Display” (you need permissions for the edit bar) and
then in “Galleria”. Of course, this will only have an effect if you have
images inside that folder. If you do, you will see the images render with the
Galleria plugin.For the case that you want to fetch pictures located in flickr or picasa seeFlickr, Picasa & Facebook Plugins. To activate Galleria in the Link just follow the
same procedure with the display action.FunctionalityThe next explanations about different options must be applied in the control
panel of Galleria add-on. SeeStep 2: Setting preferences.Default optionsIn this section you have all the basic options to set how the layout of your
galleria will look like.Auto play:This will start playing the slideshow with 5 seconds interval.Show informations:Displays the caption.Gallery width:You can use this option to set a gallery width manually. Default is 500
px.Gallery height:You can use this option to set a gallery height manually. Default is 500
px.Image css position:Positions the main image inside the stage container. Works like the CSS
background-position property, f.ex ‘top right’ or ‘20% 100%’. You can use keywords, percents or pixels. The first
value is the horizontal position and the second is the vertical.Read more about positioning athttp://www.w3.org/TR/REC-CSS1/#background-positionEnable lightbox:This option acts as a helper for attaching a lightbox when the user clicks
on an image. If you have a link defined for the image, the link will take
precedence.Show counting:Displays the counter.Transitions:The transition that is used when displaying the images. There are
different transitions in Galleria.Flavors are:fade- crossfade betweens images.flash- fades into background color between images.pulse- quickly removes the image into background color, then fades the next image.slide- slides the images depending on image position.fadeslide- fade between images and slide slightly at the same time.Transition Speed:The milliseconds used in the animation when applying the transition. The
higher number, the slower transition.Wait:Sets how long Galleria should wait when trying to extract measurements,
before throwing an error. Default is 5000Show image navigation:Displays the image navigation (next/prev arrows).Swipe:Enables a swipe movement for flicking through images on touch devices.Selector jQuery:Eg. ‘#content-core’ or ‘#content’ or ‘.galleria’. Do not change if you do
not know what I mean.Show Thumbnails:Sets the creation of thumbnails.Enable image crop:Defines how the main image will be cropped inside it’s container. This option
also is valid to fullscreen mode.true means that all images will be scaled to fill the stage, centered and cropped.
false will scale down so the entire image fits.Sets Gallery in responsive mode:This option sets thew Gallery in responsive mode. That means that it will resize
the entire container if your CSS is dynamic. In other words, you can add media
queries or dynamic proportions in your CSS and the gallery will follow these proportions
as the window resizes.Enable debug mode:This option is for turning debug on/off. By default, Galleria displays
errors by printing them out in the gallery container and sometimes throw
exceptions. For deployment you can turn debug off to generate a more
generic error message if a fatal error is raised.YouTube, Vimeo & DailyMotion supportedTo use this supports you have to create a ‘Link’ content type and in the ‘url’
field set the movie url.YouTube:Sets options for the YouTube player.Vimeo:Sets options for the Vimeo player.DailyMotionAdds player options for the Daliymotion video player.Flickr, Picasa & Facebook PluginsTo use this plugins you have to create a ‘Link’ content type and in the ‘url’
field set the galleria url that looks something like:Flickr:‘http://www.flickr.com/photos/user_id/sets/galleria_id/’Picasa:‘https://picasaweb.google.com/user_id/galleria_id’FaceBook:‘http://www.facebook.com/media/set/?set=a.album_id’Enable plugin:activate this function.Maximum number of photos:you can set the maximum of photos to show.Show description:Fetch the description. The plugin fetches the title per
default.History PluginThe Galleria History plugin is a simple extension to create Galleria add hash
tags for permalinks and back button functionality enabled. This is useful on
fullscreen views and other use cases. The plugin simply adds a #/[id] hash to
the URL and then applies the necessary code for all browsers to enable the
back button. It also makes permalinks possible by simply bookmarking f.exhttp://mygalleria.com/#/4and the user will be shown the 5th image in the
gallery (index starts at 0).Browser support includes Firefox 2+, IE6+, Ipad, Opera and Chrome.You enable it with theEnable history pluginoption.Mostly HarmlessHave an idea? Found a bug? Let us know byopening a support ticket.InstallationTo enable this product, on a buildout based installation.Plone 3.3.x Buildout Installation:To installsc.galleria.support, the following code to your
buildout.cfg:[buildout]
...
extends =
    http://good-py.appspot.com/release/plone.app.registry/1.0b2?plone=3.3.6

...
eggs =
    sc.galleria.supportPlone 4.0.x Buildout Installation:To installsc.galleria.support, the following code to your
buildout.cfg:[buildout]
...
extends =
    http://good-py.appspot.com/release/plone.app.registry/1.0b2?plone=4.0.2

...
eggs =
    sc.galleria.supportPlone 4.1.x or greater Buildout Installation:To installsc.galleria.support, the following code to your
buildout.cfg:[buildout]
...
eggs =
    sc.galleria.supportNoteSince Plone 3.3 is not is necessary to explictly inform
plone.recipe.zope2instance recipe to install the ZCML slugAfter updating the configuration you need to run the ‘’bin/buildout’’,
which will take care of updating your system.UninstallGo to the ‘Site Setup’ page in the Plone interface and click on the
‘Add/Remove Products’ link.Choose the productsc.galleria.support, which should be underActivated
add-ons, (check checkbox at its left side) and click the ‘Deactivate’ button.NoteYou may have to empty your browser cache and save your resource
registries in order to see the effects of the product installation.ContributorsCleber J. SantosHéctor VelardeGustavo LepriAlejandro PereiraAino (http://galleria.aino.se) - JavaScript galleriaChangelog1.0.1 (2017-01-11)Deprecate package.
[hvelarde]Fix package uninstall.
[rodfersou, hvelarde]1.0 (2013-01-27)Refactor travis-ci integration and tests.
[cleberjsantos]Add upgrade steps.
[cleberjsantos]Refactor to integration of collective.js.galleria.
[cleberjsantos]Fix FaceBook plugin.
[cleberjsantos]1.0rc1 (2012-09-07)Added toggle full screen.
[cleberjsantos]Added FaceBook Plugins.
[cleberjsantos]Galleria upgrade version to 1.2.8 and templates fixes.
[cleberjsantos]Refactoring tests.
[cleberjsantos]Corrected thumb and image generation.
[cleberjsantos]Added Galleria template to new collection.
[cleberjsantos]Upgrade Picasa, Flickr and History Plugins.
[cleberjsantos]1.0b4 (2012-06-21)Added image crop and responsive options.
[cleberjsantos]Refactored and optimized code.
[cleberjsantos]Refactoring browser test cases.
[aleGpereira]Fixed Title and Description data, modification of the method call.
[cleberjsantos]Resolves (issue#25).
[cleberjsantos]Added template with ZPT macro.
[cleberjsantos]Updated documentation.
[cleberjsantos]Updated templates.
[cleberjsantos]Some tests were fixed and some others, refactored.
[hvelarde]Fixed package distribution and documentation.
[hvelarde]1.0b3 (2012-05-28)Fixed NameError: name ‘test’ is not defined (issue#17).
[cleberjsantos]PEP 8.
[hvelarde]Portuguese translation updated.
[lepri]1.0b2 (2012-05-19)Fixed Picasa and Flickr plugins (issue#11).
[cleberjsantos]Added validation for Vimeo and DailyMotion (issue#12).
[cleberjsantos]Patch for bug in Picasa plugin (issue#13).
[cleberjsantos]Added tests.
[aleGpereira]Updated i18n and Brazilian Portuguese translation.
[hvelarde]1.0b1 (2012-05-18)Initial release.