====== Adding books to collections in Drupal ======

NNELS has various collections, which can be browsed here: [[https://nnels.ca/browse-by-collection|Browse by Collection]]. 

Most of our collections are based on literary award prizes, like the Governor General's Literary Awards, as well as library reading clubs, like the BC Summer Reading Club.

For every title that we publish on NNELS that is part of one of these awards or reading programs, we need to ensure we add a "collections tag" to the record. 

To add a collection tag to a record in Drupal: 

  - Go the the record's page (node)
  - Click ''Edit''
  - Select the ''Relations'' tab on the left side of the page
  - Add a "relation" or "collection" by 
    - selecting ''IsPartOf'' under ''DC Relation Qualifiers'' 
    - entering the name of the collection that it should be part of under ''Value(term)''
      - if the collection already exists, select it from the list of pop-up terms
      - if the collection does not yet exist, enter the name of the collection following the same naming conventions as previous collections of its type {{ :public:nnels:cataloguing:relations.png?direct&400 |}}
  - Click ''Save''
  - You should see the collection tag appear on the record's main page in the ''Details'' area under ''Collection(s)/Series''. If you click on the link it will take you to other titles also part of that collection. {{ :public:nnels:cataloguing:details.png?direct&400 |}}

----
====== Adding books to collections in bulk ======

Books in the NNELS repository can be searched for here: [[https://nnels.ca/admin/content/cals/streamlined-repo/relations?status=All&field_access_restrictions_value%5B%5D=0&field_access_restrictions_value%5B%5D=1&title=&field_system_control_number_value=&field_dc_creator_value=&field_dc_relation_qualifiers_value%5B%5D=IsPartOf&field_dc_relation_value_value=&field_dc_relation_term_value_tid=&field_subject_tid=&sort_by=created&sort_order=DESC&items_per_page=100|Drupal Repository Items Working View (Relations)]]

To filter page results by collection:
  - Select ''IsPartOf'' under ''DC Relation Qualifiers''
  - Type in the name of the collection into the ''Value (term) (field_dc_relation_term_value)'' field
  - You can also filter search results by subject terms by typing in the ''Subject (field_subject)'' field. Drupal will create a dropdown list of existing subject terms as you type into this field.
  - Click ''Apply'' {{ :public:nnels:cataloguing:addbookstocollectiondrupalbatchedit.png?400 |}}

To add collection tags to records in bulk:
  - Select the record items you want to edit
  - Select ''Modify DC Relation''
  - Add a "relation" or "collection" by
    - selecting ''IsPartOf'' under ''DC Relation Qualifiers''
    - entering the name of the collection that it should be part of under Value(term)
        - if the collection already exists, select it from the list of pop-up terms
        - if the collection does not yet exist, enter the name of the collection following the same naming conventions as previous collections of its type
  - Make sure that ''Add new value(s) to DC Relation, instead of overwriting the existing values'' checkbox is checked off <wrap em>(Very important!! Records will be removed from collections they have already been added to if this is not selected!)</wrap> {{ :public:nnels:cataloguing:addbookstocollectiondrupalbatchedit4.png?500 |}}
  - Click ''Next''
  - Click ''Confirm''
  - You should see the collection tag appear next to records on the search results page. If you click on the link it will take you to other titles also part of that collection. {{ :public:nnels:cataloguing:addbookstocollectiondrupalbatchedit6.png?400 |}}

----
<WRAP center box 100%>
As of August 2024, the NNELS [[https://nnels.ca/browse-by-collection|Browse by Collection]] page nests list items with similar names under corresponding parent terms.
For more information on <wrap hi>how to create nested lists on the collections page, [[public:nnels:cataloguing:edit-collections-page-view|click here]].</wrap>
</WRAP>