Integration of Cycle2 jQuery plugin in Plone.
Project description
Life, the Universe, and Everything
Cycle2 is a versatile slideshow plugin for jQuery built around ease-of-use. It supports a declarative initialization style that allows full customization without any scripting. Simply include the plugin, declare your markup, and Cycle2 does the rest.
This package adds a browser resource to use Cycle2 and its plugins on a Plone site.
Mostly Harmless
Got an idea? Found a bug? Let us know by opening a support ticket.
Don’t Panic
Installation
To enable this package in a buildout-based installation:
Edit your buildout.cfg and add add the following to it:
[buildout]
...
eggs =
collective.js.cycle2
After updating the configuration you need to run ‘’bin/buildout’’, which will take care of updating your system.
Usage
If your page template inherits from main_template, just include the resources on it by usign the following syntax:
<metal:block fill-slot="javascript_head_slot">
<script tal:attributes="src string:$portal_url/++resource++collective.js.cycle2/jquery.cycle2.min.js"></script>
</metal:block>
Alternatively you can add them into your site’s JavaScript Registry directly or by using GenericSetup:
<?xml version="1.0"?>
<object name="portal_javascripts">
<javascript
cacheable="True" compression="none" cookable="True" enabled="True"
id="++resource++collective.js.cycle2/jquery.cycle2.min.js" />
</object>
Plugins
The package also includes the code for the following plugins:
- Transition
Carousel
Flip
IE-Fade
ScrollVert
Shuffle
Tile
- Functional
Caption2
Center
Swipe
YouTube
Check Cycle2 download page for more information.
Utility
The utils.js script has an utility that:
fix the player size according with the width of the container and the aspect ratio
vertically center images
sync the player, description and thumbnails when click in other picture or next/prev buttons
Usage
To use the utility, you need to add the script in the same way you add Cycle2 resources:
If your page template inherits from main_template, just include the script on it by usign the following syntax:
<metal:block fill-slot="javascript_head_slot">
<script tal:attributes="src string:$portal_url/++resource++collective.js.cycle2/utils.min.js"></script>
</metal:block>
Alternatively you can add it directly into your site’s JavaScript Registry or by using GenericSetup:
<?xml version="1.0"?>
<object name="portal_javascripts">
<javascript
cacheable="True" compression="none" cookable="True" enabled="True"
id="++resource++collective.js.cycle2/utils.min.js" />
</object>
And in your script you should call the utility object passing the gallery element:
$(window).load(function() {
var i, len, ref, slideshow;
ref = $('.slideshow-container');
for (i = 0, len = ref.length; i < len; i++) {
slideshow = ref[i];
new cycle2SlideShow(slideshow);
}
});
The script is currently used in sc.photogallery and collective.nitf.
Not entirely unlike
- collective.js.galleria
Galleria is a JavaScript image gallery framework built on top of the jQuery library. The aim is to simplify the process of creating professional image galleries for the web and mobile devices.
Changelog
There’s a frood who really knows where his towel is.
1.0b2 (2016-07-20)
Fade in slideshows to avoid showing them before Cycle2 is loaded. [rodfersou]
Add utils.js script; this script can be used by third party add-ons to easily create responsive slideshows. [rodfersou]
1.0b1 (2015-05-27)
Remove browser layer and JS resource registry registrations. Include all Cycle2 and plugins code as browser resources (closes #1). [rodfersou]
1.0a1 (2014-10-20)
Initial release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.js.cycle2-1.0b2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6107becb18687e329c5710f54756c4df998eb87dca5863eff48c3dae13ebf0d0 |
|
MD5 | cc4caba23d2277965811eb62ad8d3f54 |
|
BLAKE2b-256 | 249d7fa246f08e4258a39f6f119d17e971c82f3b2cfab9ba479152cc84879b29 |