README.txt 2.28 KB
Newer Older
1 2
$Id$

3
README file for the CCK Facets Drupal module package.
4 5 6 7 8


Description
***********

9
CCK Facets is a bundle of modules that integrate with Faceted Search to expose
David Lesieur's avatar
David Lesieur committed
10 11
Content Construction Kit (CCK) fields as facets. This allows users to browse
field values and to filter search results with those values.
12

David Lesieur's avatar
David Lesieur committed
13 14 15 16 17 18 19 20
The supported CCK field types are:

- Text
- Number
- Node Reference
- User Reference
- Date
- Datestamp
21
- Computed Field
David Lesieur's avatar
David Lesieur committed
22

23 24 25 26

Requirements
************

David Lesieur's avatar
David Lesieur committed
27
- Drupal 6.x (http://drupal.org/project/drupal).
28 29 30 31 32 33 34 35 36

- Faceted Search (http://drupal.org/project/faceted_search).

- Content Construction Kit (CCK) (http://drupal.org/project/cck).


Installation
************

37
1. Extract the cck_facets package directory into your Drupal modules directory.
38

39 40 41 42 43
2. Go to the Administer > Site building > Modules page, and enable the CCK
   Facets module.

3. Enable any of the following modules, depending on the types of CCK fields you
   wish to expose as facets:
44

45 46 47 48 49 50 51
   - CCK Text Facets (for Text fields).
   - CCK Number Facets (for Number fields).
   - CCK Reference Facets (for Node Reference or User Reference fields).
   - CCK Date Facets (for Date or Datestamp fields).
   - CCK Computed Facets (for Computed fields). Note that in order to be
     accessible to CCK Computed Facets, a computed field must be configured to
     store its values in the database.
52

53
   Only the above types of fields are supported at the moment.
54

55
4. Go to the Administer > Site configuration > Faceted Search page, edit the
56 57 58 59
   faceted search environment that shall expose CCK-based facets. In the
   environment editing form, check each facet you wish to expose.

   CAUTION: This system hands you over the responsibility of deciding what field
60 61
   is appropriate for use as a facet. Long text fields should never be used as
   facets, since their values are too long to be usable in the Guided search,
62 63
   and might exceed the maximum URL length in browsers or servers when used as
   search criteria.
64 65 66 67 68 69 70 71 72 73 74 75 76 77 78


Support
*******

For support requests, bug reports, and feature requests, please use the
project's issue queue on http://drupal.org/project/issues/cck_facets.

Please DO NOT send bug reports through e-mail or personal contact forms, use the
aforementioned issue queue instead.


Credits
*******

David Lesieur's avatar
David Lesieur committed
79
- Sponsored in part by Laboratoire NT2 (http://www.labo-nt2.uqam.ca).
80