Search

Contributing to Luggage

Where to Find the Developers

If you would like to contribute to Luggage, please jump into the IRC channel #luggage and introduce yourself. If you are unfamiliar you can read about IRC.

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 as a sub-site of another CMS

How to set up Luggage within a Wordpress root:

  • Separate the DocumentRoot(s):
    Luggage sites should be installed outside of the wordpress document root. For example, on one LAS web server, we are doing this in /srv/luggage/<deptcode>/<site>.
  • The Virtualhost should be modified to add an alias for the site under (and yet outside of) the wordpress installation.
###
# Drupal Luggage Aliasses
###

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

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.

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;

Table Examples

Table without headers

banana cucumber
apple green bean
orange squash

 


Table with top row header

Fruit Vegetable
banana cucumber
apple green bean
orange squash

 

Luggage Feature Examples

Note: For an overview of the many sites using Luggage, click the Showcase menu.

Below is a list of the various features available in the Luggage platform, with a few website examples for each.

Pages