? patch_file
Index: INSTALL
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/taxonomy_image/INSTALL,v
retrieving revision 1.9
diff -u -r1.9 INSTALL
--- INSTALL	18 Jan 2007 04:43:13 -0000	1.9
+++ INSTALL	21 Jan 2011 20:19:27 -0000
@@ -1,53 +1,40 @@
-NOTE:  These instructions have not been updated yet for Drupal 5.0.
-Patches are welcome.
-
+$Id: INSTALL,v 1.9.2.4 2009/02/03 16:55:59 nancyw Exp $
 
 The following are instructions on how to install and configure the
-taxonomy_image.module with Drupal 4.5 or 4.6:
+taxonomy_image.module:
 
 INSTALLATION:
 
 Step 1)
   Properly configure Drupal's built in file system support by following the
   directions at 'administer >> settings' in the File system settings area.
+  Taxonomy Image will create another directory within the default file directory.
 
 
 Step 2)
-  Copy the 'taxonomy_image.module' and 'taxonomy_image.install' files into
-a 'taxonomy_image' subdirectory within your 'modules' directory.
+  Ensure that your web server is able to resolve your site's URL. When an
+  image is uploaded Taxonomy Image uses your site's URL to access it. In most
+  cases this will "just work", but if your web server is behind a load
+  balancer, firewall, etc. that may not be the case.  The easiest method is
+  to edit the web server's /etc/hosts file and add an entry like:
 
+  127.0.0.1  www.example.com
 
-Step 3)
-  Enable the taxonomy_image module.  
 
-  Go to "administer >> modules" and put a checkmark in the 'status' column next
-to 'taxonomy_image'.  This will automatically create the necessary database 
-tables.
+Step 3)
+  Untar (or unzip) the Taxonomy Image module files into a
+  'taxonomy_image' subdirectory within your appropriate 'modules' directory.
 
 
 Step 4)
-  Configure the taxonomy_image module.
+  Enable the taxonomy_image module.
 
-  Go to "administer >> settings >> taxonomy_image" to configure the module.
-If you properly followed Step 0 above, this module will automatically create
-the 'picture image path' which defaults to 'files/category_pictures'.  You can
-also configure the module to force pictures to be within a certain size,
-automatically resizing if needed.
-
-  If you're using taxonomy hierarchies, and you wish to assign one image to
-an entire tree of terms, enable 'recursive image display'.  If you're not
-sure what this means, don't enable this option.
+  Go to "administer >> site building >> modules" and put a check mark in the
+  'enabled' column next to 'taxonomy_image'.  This will automatically create
+  the necessary database table.
 
 
 Step 5)
-  Associate taxonomy terms with images.
-
-  Go to "administer >> categories >> images" and click 'upload image' next to
-the term(s) that you wish to associate an image.  You can preview uploaded
-images on the same page.
-
-
-Step 6)
   Enable permissions appropriate to your site.
 
   The taxonomy_image.module provides three permissions:
@@ -59,7 +46,31 @@
 should see the taxonomy images.
 
 
+Step 6)
+  Configure the taxonomy_image module.
+
+  Go to "administer >> settings >> taxonomy_image" to configure the module.
+If you properly followed Step 0 above, this module will automatically create
+the 'picture image path' which defaults to 'files/category_pictures'.  You can
+also configure the module to force pictures to be within a certain size,
+automatically resizing if needed.
+
+  If you're using taxonomy hierarchies, and you wish to assign one image to
+an entire tree of terms, enable 'recursive image display'.  If you're not
+sure what this means, don't enable this option.
+
+
 Step 7)
+  Associate taxonomy terms with images. This is done within the normal term edit page.
+
+
+Step 8)
+  NOTE: This may not be needed. See the documentation pages for the add-on
+    features. These add-ons are designed to largely eliminate the need for
+    any theme changes.
+  ------------------------------------------------------------------------
+                          --- DEPRECATED ---
+                          --- DEPRECATED ---
   Update your theme or other php code to display taxonomy images.
 
   To display a taxonomy image from your theme or other php code, add
@@ -70,17 +81,17 @@
 
   This will return an <img> tag with the appropriate values for source=,
 height=, width= and alt=.  For example, it may return something like:
-   <img src='files/image.jpg' width='75' height='75' / alt='term name'>
+   <img src="files/image.jpg" width="75" height="75" alt="term name" title="term name" />
 
   If you wish to set other img attributes, you can pass them in through a
 second (optional) function paramter.  For example, to put a 2 pixel border
 around the images being displayed and to set the alt text, you could call as
 follows:
-   taxonomy_image_display($term->tid, "border='2', target='new'")
+   taxonomy_image_display($term->tid, array('border' => "2", 'target' => 'new'))
 
   This would then return the following <img> tag:
-   <img src='files/image.jpg' width='75' height='75' alt='term name' border='2'
-    target='new' />
+   <img src="files/image.jpg" width="75" height="75" alt="term name"
+     title="term name" border="2" target="new" />
 
   See the included theme patches (in the 'contributed' folder) for more
 examples.