Developer Notes

Adding a new scheme

Creating structure for the scheme

1. Add an entry in the Scheme vocabulary. This should be written so that it equates to its tokenised form which will appear in urls. The easiest way to do this is to use a single word.
2. If the scheme will have content pages within this site then
   1. Create a menu for the scheme.
   2. Add a content type of Page - Scheme for pages relating to the sceme. This is to make life easier for editors so that they are less likely to create content with the wrong url or in the wrong menu. When creating the content type use the menu settings to associate it with the menu created in the previous step.
   3. Configure url alias patterns for this content type to scheme/[node:title]
   4. Create a home page for the scheme using the new content type but override the automatic url to scheme/home.
3. Create a node of type Scheme and fill out the details. Check the internal link if you have created scheme pages.
4. Tag all the relevant species nodes with the scheme name. There might be a way to use Feeds to update all nodes from a csv list.

Adding standard pages for the scheme

By using a consistent structure, as above, standard views can be reused to show content relevant to the scheme, e.g. species lists, news, photos. These are described below.

Species checklist

This employs the custom Species List module. The module provides a block, Species from Scheme, which lists species from a Drupal taxonomy that have been tagged with a scheme name. The block automatically appears on any page with url of scheme/checklist.

1. Add a new page of type Page - Scheme. Give it a title of Checklist. You may wish to add an introductory paragraph in the body. 
2. In the menu setting below the body field, check the box to Provide a menu link. It will automatically have a link title of Checklist and be automatically added to the scheme menu.
3. Save the page.

The page will automatically be given the url of scheme/checklist and will present a taxonomic list provided the species have all been tagged to the scheme (step 4 in creating structure for the scheme.)

Photo gallery

A view, Images of Scheme, is incorporated in to a block, which automatically appears on any page with url of scheme/gallery. This will show all images for species tagged as belonging to the scheme.

1. Add a new page of type Page - Scheme. Give it a title of Gallery. You may with to add an introductory paragraph to the body.
2. In the menu setting below the body field, check the box to Provide a menu link. It will automatically have a link title of Galleryand be automatically added to the scheme menu.
3. Save the page.

The page will automatically be given the url of scheme/gallery and will present photos of species in the scheme provided the species have all been tagged to the scheme and the photos have been tagged to the species.

Resources - Articles, Books & Links

There are three views, Articles of scheme by level, Books of scheme, and Websites of scheme, which are incorporated by blocks that appear appear automatically on pages with urls of scheme/articles, scheme/books and scheme/links respectively, For consistency across schemes, add these pages as sub-items below a Resources menu item.

1. In Structure > Menus >Scheme click Add link. Create a new menu item with title 'Resources' and path <nolink>
2. Add a new page of type Page - Scheme. Give it a title of Articles, Books or Links as appropriate. The body is there if an introduction is called for.
3. In the menu setting below the body field, check the box to Provide a menu link. The link title can be left as default, for consistency across the site. The parent item needs to be changed to the Resources item added in step 1.
4. Save the page.

The pages created in this way will list content of type Article, Book and Website that have been tagged with the scheme.