You are here

Home » API reference » PhotoSwipe 7

README.txt in PhotoSwipe 7

Same filename and directory in other branches
  1. 8.2 README.txt
  2. 8 README.txt
  3. 6 README.txt
  4. 7.2 README.txt
  5. 3.x README.txt
DESCRIPTION 
===========

jQuery-based lightbox library offers very nice mobile browsing features (in
particular swiping to the next picture)!


INSTALLATION 
============

1. Download and install the "Libraries API" module: uncompress the "libraries"
folder, copy it to your "modules" directory, and enable it under Administer >>
Site building >> Modules.
http://drupal.org/project/libraries

2. Place the "photoswipe" folder in your "modules" directory (e.g.
sites/all/modules/photoswipe).

3. Install third party PhotoSwipe software
     Download PhotoSwipe 2.0.0 source from PhotoSwipe website 
     (e.g. http://github.com/downloads/codecomputerlove/PhotoSwipe/code.photoswipe-2.0.0.zip)
     Unarchive it into your "libraries" directory (e.g. sites/all/libraries).
     You may need to create the "libraries" directory first.
     Rename it to "photoswipe" (lower case).
NB: Relying on libraries module to locate 'photoswipe' folder allows you to place
it in a site specific (e.g. sites/mysite/libraries) or default folder
(e.g. sites/all/libraries). Site-specific versions are selected preferentially.

4. Enable the PhotoSwipe module under Administer >> Site building >> Modules.


USAGE
=====

In order to use this module, you must install and activate ImageCache and 
ImageField modules.
After adding an image field to any content type (e.g. 'article'), you can select
'PhotoSwipe: Preset1 to Preset2' as a display mode in Administer >> Content
management >> MyContentType in the tab 'Display fields'. All possible
combinations of imagecache presets (as thumbnails and link targets) are proposed.


ADVANCED CONFIGURATION
======================

You can pass a javascript string to override the default option of Photoswipe
(documented in the file README.md of PhotoSwipe).

If you want better desktop browser compatibility, you can choose to load
PhotoSwipe using jQuery.
Warning: Since this module is based on a much newer version of jQuery (even than
the one proposed by jQuery Update), it is likely to create heavy compatibility
problems with other modules and cannot be used in admin or edit pages.
Nonetheless it can be used without Drupal or jQuery errors on standard pages!


AUTHOR 
======

Module written by Thomas Julou. http://drupal.org/user/273952
ImageCache and ImageField integration taken from Shadowbox module (D6 version).

PhotoSwipe http://www.photoswipe.org/


TO DO 
=====

?Does not disable admin by default if standard ps is used?

Drush integration


CHANGE LOG 
==========

File

README.txt
View source 
  1. DESCRIPTION 

  2. ===========

  3. 

  4. jQuery-based lightbox library offers very nice mobile browsing features (in

  5. particular swiping to the next picture)!

  6. 

  7. 

  8. INSTALLATION 

  9. ============

  10. 

  11. 1. Download and install the "Libraries API" module: uncompress the "libraries"

  12. folder, copy it to your "modules" directory, and enable it under Administer >>

  13. Site building >> Modules.

  14. http://drupal.org/project/libraries

  15. 

  16. 2. Place the "photoswipe" folder in your "modules" directory (e.g.

  17. sites/all/modules/photoswipe).

  18. 

  19. 3. Install third party PhotoSwipe software

  20.      Download PhotoSwipe 2.0.0 source from PhotoSwipe website 

  21.      (e.g. http://github.com/downloads/codecomputerlove/PhotoSwipe/code.photoswipe-2.0.0.zip)

  22.      Unarchive it into your "libraries" directory (e.g. sites/all/libraries).

  23.      You may need to create the "libraries" directory first.

  24.      Rename it to "photoswipe" (lower case).

  25. NB: Relying on libraries module to locate 'photoswipe' folder allows you to place

  26. it in a site specific (e.g. sites/mysite/libraries) or default folder

  27. (e.g. sites/all/libraries). Site-specific versions are selected preferentially.

  28. 

  29. 4. Enable the PhotoSwipe module under Administer >> Site building >> Modules.

  30. 

  31. 

  32. USAGE

  33. =====

  34. 

  35. In order to use this module, you must install and activate ImageCache and 

  36. ImageField modules.

  37. After adding an image field to any content type (e.g. 'article'), you can select

  38. 'PhotoSwipe: Preset1 to Preset2' as a display mode in Administer >> Content

  39. management >> MyContentType in the tab 'Display fields'. All possible

  40. combinations of imagecache presets (as thumbnails and link targets) are proposed.

  41. 

  42. 

  43. ADVANCED CONFIGURATION

  44. ======================

  45. 

  46. You can pass a javascript string to override the default option of Photoswipe

  47. (documented in the file README.md of PhotoSwipe).

  48. 

  49. If you want better desktop browser compatibility, you can choose to load

  50. PhotoSwipe using jQuery.

  51. Warning: Since this module is based on a much newer version of jQuery (even than

  52. the one proposed by jQuery Update), it is likely to create heavy compatibility

  53. problems with other modules and cannot be used in admin or edit pages.

  54. Nonetheless it can be used without Drupal or jQuery errors on standard pages!

  55. 

  56. 

  57. AUTHOR 

  58. ======

  59. 

  60. Module written by Thomas Julou. http://drupal.org/user/273952

  61. ImageCache and ImageField integration taken from Shadowbox module (D6 version).

  62. 

  63. PhotoSwipe http://www.photoswipe.org/

  64. 

  65. 

  66. TO DO 

  67. =====

  68. 

  69. ?Does not disable admin by default if standard ps is used?

  70. 

  71. Drush integration

  72. 

  73. 

  74. CHANGE LOG 

  75. ==========

  76.