summaryrefslogtreecommitdiffstats
path: root/README.txt
blob: 704986b879f18da71e55fe34a6b71e1ebb59d81f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
Views Gallery Module
--------------------

NOTE! This module has been reworked to take advantage of the Features
module and it is now a feature.

Views Gallery pulls together the techniques Jeff Eaton outlined in 
http://www.lullabot.com/articles/photo-galleries-views-attach to automatically
create a simple gallery where each gallery is a node with an embedded view of
images that were assigned to that gallery.

The feature creates the content types, sets up the imagecache presets, creates
the default gallery view that is embedded into the gallery nodes by Views
Attach, adds custom back/next pagers, and adds css to make it all look nice.

This technique also works well to create individual image galleries for Organic
Groups, since the gallery and image content types can be configured as group
nodes. Views Gallery OG, included in this package, provides a setup page to
make it easy to automatically create a gallery for every group and adds group
context to the forms wherever possible so the right groups and group galleries
are pre-selected when you create gallery images.

The following modules provide the nuts and bolts for this to work.
It is a long list of modules, but there is little or nothing you need to do
except make sure the latest versions of all these modules are available when
you install Views Gallery and everything will be installed and configured for
you. Plus, most of them are modules you will probably use elsewhere.

* Features (http://drupal.org/project/features)
* Strongarm (http://drupal.org/project/strongarm)
* CTools (http://drupal.org/project/ctools)
* CCK (http://drupal.org/project/cck)
* Views (http://drupal.org/project/views)
* Views Attach (http://drupal.org/project/views_attach)
* Nodereference URL (http://drupal.org/project/nodereference_url)
* Filefield (http://drupal.org/project/filefield)
* Imagefield (http://drupal.org/project/imagefield)
* ImageAPI (http://drupal.org/project/imageapi)
* Imagecache (http://drupal.org/project/imagecache)
* Token (http://drupal.org/project/token)
* Custom Pagers (http://drupal.org/project/custom_pagers)

If the Lightbox2 (http://drupal.org/project/lightbox2) module is enabled, a
'View Slideshow' link will be added to the gallery view, which will bring up a
lightshow of the gallery images.

If the Views Slideshow module (http://drupal.org/project/views_slideshow,
version 6.2) is enabled, a Views Slideshow block is added to the default view.

This module has been sponsored by Buzzr (http://buzzr.com/).


Installation
------------

Chekc the module's requirements, download the 'views_gallery' module and enable
it. Then go to the Features page and turn the feature on. If you have Context
and Spaces installed, you can set the feature up to appear only in selected
contexts or spaces.

You should not have to do anything else, it will create the content types and
views and an initial gallery node for you and configure everything else that
needs to be done.

The following content types will be created by the module:
* gallery
* gallery_image

The following views will be created by the module:
* gallery
* gallery_list

The following initial gallery node will be created by the module:
* gallery


Upgrading instructions
----------------------

This module implements the techniques show in Jeff's screencast but has
implemented numerous tweaks and adjustments to fix bugs or add new
features. If you have created content types and views from that
screencast they WILL NOT WORK in this module because of subsequent changes.
Delete them and start over, this module will create the right types
and views.

To upgrade from the 6.1 to the 6.2 version of this code, please do the following:

1) Make sure the gallery content type has a machine name of 'gallery' and the
image content type has a machine name of 'gallery_image'. These are the 
defaults unless you changed them. If you changed them, you can go to the
content types page and edit the content type to change the name.
Features requires that we have a single, known, content type name.

2) Back up your database. The Backup Migrate module (http://drupal.org/project/backup_migrate)
provides an easy way to backup and restore the database.

3) If you made any changes to the field settings or display options,
you will have to re-apply your changes. If you are not sure, you can
enable the Content Copy module and export the Gallery and Gallery Image
content types and fields so you have a reference of how they were configured.

4) Replace the old Views Gallery code with the new code. Be sure to completely
empty the old folder so none of the old files remain.

5) Go to the modules page and enable Features, CTools, Strongarm, and Views Gallery.

6) Go to the content types page and find the Gallery and Gallery Image
content types. Go to the Manage Fields and Display Fields screens
and check that the fields still have the right settings. They will if
you never changed any of those values, otherwise you will need to
change them to match what you had before. You can use the export
of the older code as a help to see what you had set up before.

7) Clear the caches and confirm that everything is working as desired.

More documentation
------------------

To understand what you can accomplish with Node-based galleries with CCK and
Views, you can have a look at Jeff Eatons screencast at Lullabot:

http://www.lullabot.com/articles/photo-galleries-views-attach

This screencast has been partially transcribed as an (incomplete) Howto:

http://drupal.org/node/599672

The screencast and the Howto will give you a basic understand what's going
on under the hood if you install the 'views_gallery' module.


Troubleshooting
---------------

If the module behaves unexpectd, please check first the Drupal status report
at Admin -> Reports -> Status (./admin/reports/status).


Author and Copyright
--------------------

Author: Karen Stevenson <http://drupal.org/user/45874>

For further copyright information please see the included LICENSE.txt.