- Introduction
- Supported Components
- Roadmap
- Requirements
- Recommended modules
- Installation
- Configuration
- Maintainers
- Credits
The Paragraphs for Indiana University module provides custom Paragraph types for building complex pages comprised of IU Pattern Library elements like section, grids, and chunks that conform to the design standards in the IU Web Style Guide.
This module should be used in combination with the IU Drupal Theme.
-
For a full description of the module, visit the project page: https://www.drupal.org/project/iu_paragraphs
-
To submit bug reports and feature suggestions, or track changes: https://www.drupal.org/project/issues/iu_paragraphs
The Paragraph types currently available with this module include:
- Section - the top-level Paragraph type that you should add as a field on your content types; it supports background colors & images, parallax, as well as other display settings like height/width/padding, text alignment, and visibility rules, all from the standard IU Framework CSS.
- Text chunk
- Image chunk
- Panels chunk & Interactive Panel chunk
- Feature chunk & Feature Carousel chunk
- Call To Action chunk
- Callout & Pullquote chunks
- Accordion chunk
- Stats chunk
- Tabs - Not mentioned in the IU Pattern Library, but code was found in the IU Framework CSS for these. The implementation is based on Zurb Foundation Tabs and styling is completed via the IU Drupal theme.
- Grid Buider - Build rows of equal-width grid item columns.
- Drupal Block - Embed a Drupal block inside a Paragraph.
- Drupal View - Embed a Drupal view in a Paragraph via viewsreference module.
- Form - Embeds a Drupal webform via the included iu_paragraphs_webform submodule.
- Banners - a top-level Paragraph type that may be added as a field in your content types; it can be used to place banner images, videos and text to the top of the page content.
The following widgets still need to be implemented to completely support the IU Framework:
- Image Essay chunk
- Social Media Item chunk
- Video & Audio chunk
This module requires the following modules:
- IU theme
- Paragraphs (with patch from Issue #2946856)
- Field Group
- ViewsReference
- SVG Image Field (dev version or patch from Issue #2920329)
- Download and enable the module and the required dependencies (see above). Install as you would normally install a contributed Drupal module. Visit https://www.drupal.org/docs/8/extending-drupal-8/overview for further information.
-
Open Admin > Structure > Content types > Basic Page > Manage fields.
-
Add a field named Sections of type Paragraph (aka Entity Reference Revision); For Reference Type, include only the Section type;
-
Add a field named Banner of type Paragraph (aka Entity Reference Revision); For Reference Type, include only the Banner type;
-
We recommend the Paragraphs Experimental field widget for Form Display. Note that the IU Paragraphs implements a nested Paragraphs architecture, so it is highly recommended to install the Sortable.js library to leverage the advanced Drag & Drop feature in the Experimental widget because the basic tabledrag feature only allows you to reorder items within a single level. Follow Sortable.js installation instructions in the Paragraphs module's README.
-
Ensure your Sections field and node type display is configured in an Edge-to-edge layout. See Layout settings on the Manage display tab of your content type. (Field Layout and Layout Discovery modules must be enabled). We recommend leveraging the IU Page Layout from the IU theme for your field layouts. This custom layout provides two regions: Constrained and Edge-to-edge. Place the Body field in the Constrained region and the Sections field in the Edge-to-edge region. An alternative approach would be to use the Page Manager module to handle field layouts, but Page Manager is outside the scope of this instruction manual.
-
Ensure your theme is configured to display the Main page content in a region that spans the width of the screen (aka, edge-to-edge). We recommend using the IU theme which contains appropriately labeled regions to support both edge-to-edge (for node pages) and constrained for non-node page content. The theme comes preloaded upon installation with two Main page content blocks; one for node pages and one for non-node pages. The Main page content block for nodes is placed in the IU theme's Edge-to-edge region, while non-node Main page content block is in the standard Content region which has a constrained maximum width.
- James Wilson - [email protected]
- Indiana University Libraries - for sponsoring initial development.
- Bluespark - for sponsoring ongoing development.
Special thanks to Paragraphs Pack and Bootstrap Paragraphs, both of which provided the initial code from which this module was forked.