You are here

Home » API reference » Scald: Gallery 7.2

README.txt in Scald: Gallery 7.2

Same filename and directory in other branches
  1. 7 README.txt
== Installation

1. - Install the Libraries module.
This is required by scald_gallery and scald_galleria.
Available at https://drupal.org/project/libraries.
Download, install and enable as usual. No configuration required.

2. - Install the Galleria Javascript library.
If your site doesn't have the directory sites/all/libraries, create it now.
Visit http://galleria.io/ and click the 'Free download' button.
Save the zip file.
Extract the contents, then copy the galleria directory and all its contents
to sites/all/libraries. You should end up with path sites/all/libraries/galleria

3. - Update your jQuery
Newer versions of Galleria requires jQuery 1.7 or higher. The standard
Drupal 7 installation ships with an older version of jQuery.
To update it, download, install and enable module jquery_update
from https://drupal.org/project/jquery_update.
After enabling it, go to admin/config/development/jquery_update
and choose a later version of jQuery.

4. - Install the Scald Gallery module
Download and install as usual. You will see two new modules, scald_gallery
and scald_galleria. Enable them both.
Go to admin/structure/scald/gallery/contexts and below the preferred
representation choose the Galleria, also check player settings.

Now you should be able to create a new gallery and add images to it.
When you view the Gallery atom, they are displayed in the Galleria viewer.

Possible problems when viewing the Gallery atom:
- "Notice: Undefined index: data in drupal_process_attached()"
When you view the gallery, thumbnails of the gallery's images are shown,
but no viewer is displayed. The error message shown above is displayed.
You have copied the library to the wrong path. Check step 2 above.

- No error message, but no viewer either.
When you view the gallery, thumbnails of the gallery's images are shown,
but no viewer is displayed. Checking the browser's javascript console,
I found the error message
"Uncaught TypeError: Object [object Object] has no method 'on'"
This was a sign that the wrong jQuery version was installed. Check step 3 above.

The following steps is optional and could be use with the latest Scald dev or
the upcoming Scald 1.1 for multiple and drag and drop file upload.

- Download the plupload module.
- Download the plupload library, run 'ant' to build the library. You should have
  a sites/all/libraries/plupload/js folder after the build.
- In each atom type (e.g. for Images it is admin/structure/scald/image) select
  Plupload as the default upload type.

== Using

Gallery can be created using both modal dialog (the add button in the DnD
library) or at atom/add/gallery. However when creating a gallery in a modal
dialog, you can't create another atom in another modal dialog then add it to the
gallery.

The Galleria player support title and description for each gallery item. By
default, item title is the atom title, but it can be overriden locally in the
gallery.

Galleria supports many themes. In the basic theme, title and description can by
displayed by clicking the <i> button at the top left corner.

File

README.txt
View source 
  1. == Installation

  2. 

  3. 1. - Install the Libraries module.

  4. This is required by scald_gallery and scald_galleria.

  5. Available at https://drupal.org/project/libraries.

  6. Download, install and enable as usual. No configuration required.

  7. 

  8. 2. - Install the Galleria Javascript library.

  9. If your site doesn't have the directory sites/all/libraries, create it now.

  10. Visit http://galleria.io/ and click the 'Free download' button.

  11. Save the zip file.

  12. Extract the contents, then copy the galleria directory and all its contents

  13. to sites/all/libraries. You should end up with path sites/all/libraries/galleria

  14. 

  15. 3. - Update your jQuery

  16. Newer versions of Galleria requires jQuery 1.7 or higher. The standard

  17. Drupal 7 installation ships with an older version of jQuery.

  18. To update it, download, install and enable module jquery_update

  19. from https://drupal.org/project/jquery_update.

  20. After enabling it, go to admin/config/development/jquery_update

  21. and choose a later version of jQuery.

  22. 

  23. 4. - Install the Scald Gallery module

  24. Download and install as usual. You will see two new modules, scald_gallery

  25. and scald_galleria. Enable them both.

  26. Go to admin/structure/scald/gallery/contexts and below the preferred

  27. representation choose the Galleria, also check player settings.

  28. 

  29. Now you should be able to create a new gallery and add images to it.

  30. When you view the Gallery atom, they are displayed in the Galleria viewer.

  31. 

  32. Possible problems when viewing the Gallery atom:

  33. - "Notice: Undefined index: data in drupal_process_attached()"

  34. When you view the gallery, thumbnails of the gallery's images are shown,

  35. but no viewer is displayed. The error message shown above is displayed.

  36. You have copied the library to the wrong path. Check step 2 above.

  37. 

  38. - No error message, but no viewer either.

  39. When you view the gallery, thumbnails of the gallery's images are shown,

  40. but no viewer is displayed. Checking the browser's javascript console,

  41. I found the error message

  42. "Uncaught TypeError: Object [object Object] has no method 'on'"

  43. This was a sign that the wrong jQuery version was installed. Check step 3 above.

  44. 

  45. The following steps is optional and could be use with the latest Scald dev or

  46. the upcoming Scald 1.1 for multiple and drag and drop file upload.

  47. 

  48. - Download the plupload module.

  49. - Download the plupload library, run 'ant' to build the library. You should have

  50.   a sites/all/libraries/plupload/js folder after the build.

  51. - In each atom type (e.g. for Images it is admin/structure/scald/image) select

  52.   Plupload as the default upload type.

  53. 

  54. == Using

  55. 

  56. Gallery can be created using both modal dialog (the add button in the DnD

  57. library) or at atom/add/gallery. However when creating a gallery in a modal

  58. dialog, you can't create another atom in another modal dialog then add it to the

  59. gallery.

  60. 

  61. The Galleria player support title and description for each gallery item. By

  62. default, item title is the atom title, but it can be overriden locally in the

  63. gallery.

  64. 

  65. Galleria supports many themes. In the basic theme, title and description can by

  66. displayed by clicking the  button at the top left corner.