Department Item - Developer

Use the arrow keys or spacebar to go to the next slide.

Make this presentation full screen for best effect.

go to index

The very first step would be to turn on/enable the department item module. This can be done through the Drupal admin UI or if that doesn't go smoothly, Drush can be used. In the admin menu, click on "Extend". On this page, search for the department item module, check the item, and then click install. It has several dependencies so this may take a few minutes. Once that completes, run updates on the Drupal site. If you get an error message, that is when we would recommend using drush to install:

composer require hmswarp/hms_department_item:[version]

go to index

Where you begin

Once you confirm everything with the basic configuration automatically through the logs and on the extend page, we can now go through with setting up the department item for the user. First, go to - /admin/config/content/department-item-overrides

For this example, we are going to set up the department item overrides to be Courses

go to index

Department Item Configuration

1. Department item content type label override - This is the label that would be found under the content types in the Drupal admin menu where users would add content. It is recommended to have this be a singular noun, so this would be Course in our example.
2. Department item taxonomy vocabulary override - With this module, it actually creates an associated top level taxonomy vocabulary. By default, it will be Department Items, so this would be replaced by Courses. It is recommended to have this override field contain a plural noun.
3. Department item URL alias pattern override - Very similar to the above field, the module creates an alias pattern for department item which we can change. Doing this before users enter content is important so they will not have to worry about node URLs when creating pieces of content. This is also recommended to be singular.

go to index

Department Item Configuration

1

2

3

Once the page on the previous slide was saved, clear the site's full cache in order to see the updated settings and configuration. Next, we will need to go into the block layout to update a few display settings for a few blocks. First, configure the Hero Block. Under the content type tab, make sure your department item (in this example, it would be Courses) is checked and then hit save.

go to index

Department Item Block Configuration

The next block we want to check on the configuration is the page title block. This should not need any updating, however double check that the page title is not duplicating on department item nodes. If it is, exclude page title from the node and view displays. The last block to check is under the left  sidebar. Here is where you would add the associated view and filter blocks created within the view. This could be different per microsite, and for this example there are three blocks to add. Make sure you configure each block you need to show on the pages you need. For the filter blocks, they will need the following CSS class to be added to the field on the configure page:

.js-form-item-no-icon

go to index

Department Item Block Configuration

There is one additional block to add, and that would be the related items block. This block () is to be placed in the content section if it is not already done. By default, everything is set to department item, however the block title can be overwritten. To do that, check the two boxes for Display Title, and Override Title. A new field will appear where you can update the title. Before hitting save, change the visibility in the content type tab to have your department item checked. In this example, it would be Course.

go to index

Department Item Block Configuration

Congratulations!
You have completed the

Department Item Walkthrough

use the back button to go back to where you were