/[drupal]/contributions/modules/og_galleries/INSTALL.txt
ViewVC logotype

Contents of /contributions/modules/og_galleries/INSTALL.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.4 - (show annotations) (download)
Fri Jul 24 12:29:05 2009 UTC (4 months ago) by karens
Branch: MAIN
CVS Tags: HEAD
Changes since 1.3: +67 -53 lines
File MIME type: text/plain
Add migration code to migrate data to Views Gallery OG. It won't work in many cases, but will work in some.
1 Organic Groups Galleries (OG Galleries)
2
3 This module will not be maintained for Drupal 6.
4 Install this package to migrate an existing site
5 to use Views Gallery OG instead. OG Galleries
6 created galleries out of taxonomy terms, and
7 integrating taxonomy access into OG node access
8 has always been difficult. The new module creates
9 galleries that are nodes, and each of them
10 can be added to the right group in the same
11 way all other nodes are handled.
12
13 The package contains nothing but the update script.
14
15 The update is not foolproof and will not work in all
16 cases but is a best effort at a migration path. Please
17 adhere exactly to the steps below or it will not
18 work at all. Be sure to make a database backup before
19 starting so you can go back to it if you run into
20 problems.
21
22 1) Upgrade from Drupal 5 to Drupal 6 before adding
23 the code for OG Galleries or Views Gallery to
24 your installation.
25
26 2) Make sure that all nodes that use imagefield are
27 completely updated and working correctly, the imagefield
28 upgrade can be problematic. You should be able to view
29 any node that you used in OG Galleries and see the
30 image and taxonomy terms before you make any attempt
31 to migrate to Views Gallery.
32
33 3) Once imagefield is successfully updated, install
34 Views Gallery and Views Gallery OG. That will create
35 the new content types you need in Views Gallery
36 (a content type called 'gallery' and a content type
37 called 'gallery_image').
38
39 4) Once Views Gallery has been installed, edit the
40 OG Galleries install file and change the following
41 line to identify the name of the image field you were
42 using in OG Galleries:
43
44 "variable_set('og_galleries_old_image_field', 'field_image');"
45
46 Change 'field_image' to the name of the current image
47 field. The migration will move the contents of that field
48 to the field that is used in Views Gallery, and will use
49 the value shown here as a way of identifying the right
50 field to move.
51
52 5) Now you are ready to migrate. Go to update.php
53 and run the '6000' update for OG Galleries. Open up
54 the fieldset on the update page to see the list of all
55 the modules that will be updated and make sure that that update
56 shows up. If it does not, find the place where it says
57 'og_galleries' and manually select update 6000 to run.
58
59 6) Submit the page to run the update. It will find all
60 the current galleries (which are taxonomy terms) and
61 create new Gallery nodes instead. Then it will find
62 all the nodes that use those terms and point them
63 to the right gallery node, migrate the image to the
64 new image field, and change the content type of the
65 node to be the new image content type.
66
67 7) If everything seems to be working well, you can
68 go ahead and disable and uninstall OG Galleries and
69 remove it from your system.

  ViewVC Help
Powered by ViewVC 1.1.2