Search

Contributing to a Luggage Feature

Contributing to an individual Luggage feature requires a bit of setup before you are ready to create a pull request. You will need to fork the desired Luggage feature and create pull requests to the development branch from there. There exists already comprehensive documentation to help you understand Luggage's Git architecture. We will be following the same method as described there, but with an individual Luggage feature. So let's get started!

Luggage Site Builder

Luggage Site Builder: builds websites starting with Luggage.

We encourage Luggage Site Builders to retain the Luggage update/upgrade pathway and leverage the flexibility to extend luggage. Luggage is built to scale and stretch.

Updating Your Codebase

git checkout origin master
git remote add [luggage_branch] [luggage_repo]
git pull [luggage_branch] master
git checkout [luggage_branch]/master sites/all/modules/luggage/* .gitmodules sites/all/themes/*
git add sites/all/modules/luggage
git add .gitmodules
git add sites/all/themes

Category and Tags

Categories and tags are descriptive terms that help relate content. By creating excellent categories and tags, you can improve the searchability of your website. You can also help site visitors find what they are looking for and even what they didn't know they were looking for. This tutorial will explain characteristics of good category and tag terms and steps for how to create new terms.

 

Luggage Roles and Permissions

Anonymous User

Anonymous user a user who is not logged in to the website. This user only has the ability to view published content.

Authenticated User

Authenticated User has several permissions to add content such as a page, news article, event, etc., however, this user may only edit their own content.

Content Editor

Content Editor has the ability to add content and edit all content. This user may also publish and unpublish any content on the site. 

Determining Your Version of Luggage

As of Luggage 3.2.2 we've made it easier to query Luggage for its version number. There are two ways to get the version number: on the site status page, and via drush.

Version from status page

Go to admin/reports/status and find the version in the list of status reports

Luggage Version shown on Drupal site status page

Using Mega Panels

Mega Panels is our new layout option for the Drupal Panels module. It's quick and flexible, allowing administrators to create layouts with multiple rows and a variable number of panels in each row. 

Accessibility

Suitcase is designed with web accessibility best practices in mind, and makes it easy for content owners to create accessible content. 

For more resources and guides about web accessibility, visit ISU Digital Access.

Using Images in Mega Panels

A flexible Mega Panels layout works best when images are properly sized.  An example use-case would be having three panels in a row, each with an image that fills the width of each panel. 

Screenshot of three panels, each with an example image filling the space inside

In order for the image to fill the space allowed in the panel, create the images with the correct width to correspond with the size of the panel.

Typography

Iowa State University has digital font recommendations. One of these recommendations is to use the font called Nimbus Sans. This font is available through Adobe Typekit. ISU has a license to use the font for digital development. Nimbus Sans is the base font for the Suitcase theme. The font family is indicated in CSS as follows: 'Nimbus Sans','Helvetica Neue',Helvetica,Arial,sans-serif;

Pages