You are here

README.txt in jCarousel 6

Description
-----------
This module provides a central function for adding jCarousel jQuery plugin
elements. For more information about jCarousel, visit the official project:
http://sorgalla.com/jcarousel/


Installation
------------
1) Place this module directory in your modules folder (this will usually be
"sites/all/modules/").

2) Enable the module.


Usage
-----
The jcarousel_add function allows you to not only add the required jCarousel
JavaScript, but also apply the jCarousel to the elements on the page. The
arguments are as follows:

  jcarousel_add($selector, $options, $skin, $skin_path);

The $selector is the jQuery selector element to apply the jCarousel to. This
can usually be thought of as the #ID of the element (#carousel).

The $options are the configuration options that are sent during the creation
of the jCarousel element (optional). The configuration options can be found at:
http://sorgalla.com/projects/jcarousel/#Configuration

The $skin is the name of the skin to use (tango, ie7 or your own) (optional).

The $skin_path is only used if you're using a custom skin, and references the
path to the CSS file for the skin (optional).

See admin/help/jcarousel for a demonstration.
 

Example
-------
The following would add a vertical jCarousel to the page:

  <ul id="mycarousel">
    <li><img src="http://static.flickr.com/66/199481236_dc98b5abb3_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/75/199481072_b4a0d09597_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/57/199481087_33ae73a8de_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/77/199481108_4359e6b971_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/58/199481143_3c148d9dd3_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/72/199481203_ad4cdcf109_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/58/199481218_264ce20da0_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/69/199481255_fdfe885f87_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/60/199480111_87d4cb3e38_s.jpg" width="75" height="75" alt="" /></li>
    <li><img src="http://static.flickr.com/70/229228324_08223b70fa_s.jpg" width="75" height="75" alt="" /></li>
  </ul>
  <?php
    jcarousel_add('#mycarousel', array('vertical' => TRUE));
  ?>
See jcarousel_help() for more examples.


Author
------
Wim Leers (work@wimleers.com | http://wimleers.com/work)
Rob Loach (http://www.robloach.net)

File

README.txt
View source
  1. Description
  2. -----------
  3. This module provides a central function for adding jCarousel jQuery plugin
  4. elements. For more information about jCarousel, visit the official project:
  5. http://sorgalla.com/jcarousel/
  6. Installation
  7. ------------
  8. 1) Place this module directory in your modules folder (this will usually be
  9. "sites/all/modules/").
  10. 2) Enable the module.
  11. Usage
  12. -----
  13. The jcarousel_add function allows you to not only add the required jCarousel
  14. JavaScript, but also apply the jCarousel to the elements on the page. The
  15. arguments are as follows:
  16. jcarousel_add($selector, $options, $skin, $skin_path);
  17. The $selector is the jQuery selector element to apply the jCarousel to. This
  18. can usually be thought of as the #ID of the element (#carousel).
  19. The $options are the configuration options that are sent during the creation
  20. of the jCarousel element (optional). The configuration options can be found at:
  21. http://sorgalla.com/projects/jcarousel/#Configuration
  22. The $skin is the name of the skin to use (tango, ie7 or your own) (optional).
  23. The $skin_path is only used if you're using a custom skin, and references the
  24. path to the CSS file for the skin (optional).
  25. See admin/help/jcarousel for a demonstration.
  26. Example
  27. -------
  28. The following would add a vertical jCarousel to the page:
  29. jcarousel_add('#mycarousel', array('vertical' => TRUE));
  30. ?>
  31. See jcarousel_help() for more examples.
  32. Author
  33. ------
  34. Wim Leers (work@wimleers.com | http://wimleers.com/work)
  35. Rob Loach (http://www.robloach.net)