Topic: Components

Review the guides for tasks in the component topic.

Hero banner guide

The Hero Banner is a page title component for Panel pages. It outputs a <h1> element for the page title overlaying an image, and can optionally have 1-3 action buttons. Only one Hero Banner should be used per page and it should ideally be the first component on the page.

hero

Step 1

Hover the mouse pointer over the right-hand corner of the hero banner pane to display the Edit cog (Edit menu icon). Click the icon to display the menu and click Edit to open.

edit hero banner

Step 2

The configuration form for the hero banner component displays.  

  1. Title - the title of the home page can contain a message.  Words on hero banners on other panel pages should be minimised to one single words where possible.
  2. Image - the minimum image dimensions should be 2560px X 560px.
  3. Caption - for the purposes of attributing the image as per the copyright of the image.
  4. Layout - select between the default and thin banner
  5. Theme (tint) - choose between none, dark or light tint to overlay the image.
  6. Text - depending on the selected tint, choose the text light or dark to ensure sufficient contrast between the text and image to improve legibility.

Edit the hero banner

  1. Links - insert relative path links when linking to content on the site. If required, select between 1, 2 or 3 links.
  2. Save the changes.

save hero banner

Step 1

Click Customize this page to start adding components to a panel page.

Customise this page

Step 2

The available regions where components can be added are displayed as blue shaded fields. Click the plus (+) button to open the list of available components grouped by category. 

Click plus to add a component

Step 3

The available components display. Click on the UQ category and then select the Hero Banner component to open the configuration form.

Select Hero Banner from the UQ Content types category

Step 4

The configuration form for the Hero Banner displays.  Complete the fields before clicking Finish.

  1. Title - insert a title for the component
  2. Image - select an upload an image from your computer

configure hero banner 1-2

 

  1. Layout - retain the default banner or select a thinner banner.
  2. Theme - retain the theme or add a dark or light tint.
  3. Text - retain light text or change to dark text

dark theme light text

 
  1. If the Hero banner has three links, insert the title and URL for the links and click Finish.

Tip:  Use a relative reference when linking to content on your website.

Configure hero links

Step 5

The system returns to the panel page In-Place Editor.  Click Save to complete process of adding the component.

Save panel page changes

 

The completed component displays.

completed hero banner

 

Hero images

Recommended image dimensions: 2560px wide by 560px high

Best practice

  • Apply a dark tint to ensure the white text stands out with enough contrast. Dark tint does not need to be a part of the actual image. It is an option when creating the hero banner component.
  • Recommended image size should be adhered to. This will remove the possibility of the image being stretched, which will result in a poor image appearance.
  • If possible, choose an image which is free of other distractions, where the person/object or theme is the focal point.

best practice image

Avoid these mistakes

Too much text

  • Banners should contain a short message that is quick and easy to read. Users are more likely to read the text if your messages are short and succinct.

Image to avoid

    Busy imagery

    • Avoid using banner images that are overly bright, which diminishes the ability of the copy to stand out sufficiently.
    • Avoid using images which have very busy imagery, which may detract further from the banners messaging.

    avoid busy images

    Too small images

    • Images smaller than recommended dimensions will be stretched to fill the space, which will result in a poor image quality.

      avoid small images

      Image source and attribution

      Conditions and attribution

      It is your responsibility to understand and comply with any conditions of use associated with images on your website.  Ideally, attribution appears as a caption under an image or if this is not practical, at the end of the page.

      It is recommended that you avoid: 

      • original works which do not permit modification as the image in UQ Drupal may display differently on different devices or in a featured view
      • photos of people where there is not permission to use their image.

      UQ image sources

      • UQ Images (uq login required)
      • local school or faculty storage drives
      • Google search 'UQ' plus your keywords or search UQ news to see if your School or Faculty already has images on your topic.  If in doubt check with the owning organisational unit as to whether you can use it.
      • eSpace advanced search using display type 'image'.

      Externally sourced images

      Stock images should be avoided as they detract from the authenticity of your messages. However, you can purchase stock images from sites such as iStock or Shutterstock. It's possible that there is a stock image account in use in your local marketing and communications unit.

      Wikimedia commons

      Wikimedia commons is the largest single repository of media which can be reused without charge on the web with over 27 million files.  Wikimedia offers images of art, antiquities, historical events, places, buildings and nature.  The image must be pubilc domain or creative commons licensed for you to use it.  It is recommended that you cite the image using the Wikimedia format which includes a name or short title, the name of the photographer or artist if available, via Wikimedia Commons, and the legal status (expressed as public domain or CC2.0, 3.0 etc).

      Examples:

      The Young Student by Ozias Leduc, via Wikimedia Commons, Public Domain.

      High magnification micrograph of a liver with cirrhosis. Trichrome stain. Nephron via Wikimedia Commons CC 3.0

      Topic: Basic page

      Review the guides relating to creating and editing basic pages.

      Guides for Task: format content

      Basic pages are the simplest and most common type of page. The majority of general content pages on a site will be either Basic page or Structured pages.

      Step 1

      In the administration menu, go to Content > Add content > Basic page.

      Basic page menu selection

      Step 2

      The edit screen displays.

      1. Title - Page title
      2. Summary - Optional. Displays in teaser and card views where the page is referenced in a list. Doesn't appear on the page.
      3. Body - Content of the page

      Basic page fields 1 to 3

      1. Teaser image - Optional. Displays in card and teaser views. Advice on images.
      2. Hero image - Optional. Replaces the default page header with a hero banner header.

      Basic page image fields

      1. Aside - Optional. Used for content that is tangentially related to the Body content, such reminders or contact details.
        Click Add new paragraph to create an Aside.
        Note - Headings used in the aside, should start at heading level 3.

      Basic page aside

      The Aside field displays.

      aside rich-text paragraph

      1. Related content - Optional. Allows other pages on the site to be referenced in a short list. The relationship is manually created, not inferred from any data such as tags.
        Click Add new paragraph to create a related content group.

      click add new paragraph

      The Related Content fields display.

      Title - Optional. Heading to label the related pages. e.g. "Associated research", or "See also"

      Related content - Reference to other pages on the site. Type the first few letters of a page title to look-up the desired page. Multiple related pages can be added.

      related content

      1. Tags - Click the dropdown arrow to select a tag from the list of vocabularies and their terms to categorise the content.

      Basic page tags

      1. Menu Settings  - Tick provide a menu link to display the menu settings options. Adding a page to the menu ensures it will appear in the site map.

      Tick provide a menu link

      Enter the menu settings fields.

      Menu link title - The menu link title is automatically populated from the basic page title. The menu link title can be edited.

      Description - Content entered in the description field will be displayed when hovering the cursor over the menu link.

      Parent item - Selection of a parent item ensures improved website navigation by displaying a breadcrumb trail at the top of the page.

      Weight - Select a weight to determine the order of the menu link in the Parent Item. Menu links with smaller weights are displayed before links with larger weights.  Tip: easier to drag the links into position to change the order. Review
      re-order menu links.

      Basic page menu

      1. URL path settings - a friendly URL is generated automatically if the tick box remains ticked.

      URL path settings

      1. Revision information - if create new revision remains ticked, a new version of the basic page is saved each time after it is published. The versions are accessible from the revisions tab.

      revision information

      1. Authoring information - The information of the author is recorded. After the basic page is saved, the "Authored on" field is updated.

      authoring information

      1. Publishing options - Click the tab Publishing options to finalise the publishing settings.
        To publish - The published field is automatically ticked. Keep it tick to publish
         To create a draft - untick published to save as a draft.

      publishing options

      1. Save - Click Save to update the basic page. 
      1. Hero image, including the page title
      2. Breadcrumb. Displays when the page is added to the menu under another item.
      3. Body
      4. Aside
      5. Side menu. Includes siblings and child pages.
      6. Related content.

      Large device display

      Headings are used to structure sections of content on a page. They enable skimming and add semantic value which is used by screen readers and search engines.

      Heading levels range from 1 - 6. Referred to as h1, h2, h3, etc

      Heading 1 <h1> is reserved for the page title. It should be the first heading on the page, and there should generally only be one h1 per page.

      Headings provide semantic structure to a document and need to follow the numerical order. The first content heading should be h2. If that section has a sub-heading it will be a h3.

      What to avoid

      • Don't use bold instead of a heading as it doesn't have the same semantic meaning.
      • Don't skip heading levels.

      Heading 2

      Heading 3

      Heading 4

      Heading 5
      Heading 6

      Guides for Task: insert links

      Guides for Task: in-line images

      In-line images refer to any image added to the body field via the WYSIWYG editor as opposed to a specific file upload field such as "Teaser image".

      Step 1

      1. Position the cursor where the image should be inserted.
      2. On the WYSIWYG editor, click the image button.

      Select image button on WYSISYG

      Step 2

      The image properties window displays. Click browse server to select an image.

      Select browse server on Image properties

      Step 3

      The file browser image folder displays. Select the image if it is already on the server (skip to Step 5), or click upload to upload a new image from your computer.

      File browser upload

      Step 4

      The window to your computer opens. Navigate to the location where the image is stored.  

      1. Click on the image to select it
      2. Click open to upload the image.
        1. Mulitple images can be uploaded at one time. Select all images before clicking open.

      Image upload

      Upload finished displays if the image is successfully uploaded.

      Step 5

      Select the image by clicking on it. Click choose or double click the image to insert it in the WYSIWYG field.

      Insert image

      Step 6

      The image properties window opens.

      1. Insert alternative text to describe the image for screen readers and search engines. This text doesn't display on the front-end, but is required for accessibility.
      2. Select the alignment of the image
      3. Select captioned image to display a caption below the image. The caption field will appear after OK is clicked.
      4. Click OK to save the image properties.

      completed Image properties

      You are returned to the body field to complete the rest of the content.

      Topic: Structured page

      Review the guides related to creating a structured page.

      Guide for Task: structured page

      Structured pages are similar to Basic pages, but are designed for long content that needs to be split up into sections or steps. The majority of general content pages on a site will be either Basic page or Structured pages.

      Step 1

      In the administration menu, go to Content > Add content > Structured page.

      menu selection for structured page

      Step 2

      The edit screen displays.

      1. Title - The page title.
      2. Introduction - Displays above the structured content paragraphs.

        Structured page fields 1 to 3

      3. View mode selector - Determines how the structured content fields will display.

        Tabs view
        Each paragraph is a separate tab. Recommend 2-4 tabs maximum.

        Tabs display in horizontal format


        Accordion view
        Each paragraph is a separate accordion toggle. All are collapsed by default, and only one is active at a time.

        Accordion display



        Step by step view
        Each paragraph becomes a step in a process and behaves like a separate page. Index of steps is listed at the top of the page, and previous/next buttons display at the bottom.

        Step by step display


        Table of contents view
        Each paragraph is displayed one below the other. A jump list to each paragraph displays at the top of the page.

        Table of contents

      1. Structured Content - Add a new paragraph for each section of content to be displayed using one of the view modes.

      Add new paragrahp

      Each structured content paragraph contains a Title and Body field.

      Structured content paragraph

      1. Teaser image - Optional. Displays in card and teaser views. Advice on images.
      2. Hero image - Optional. Replaces the default page header with a hero banner header.

      Teaser image and hero image uploaded

      1. Aside - Optional. Used for content that is tangentially related to the main page content, such reminders or contact details.

       aside

      The Aside field displays.

      aside rich-text paragraph

      1. Related content - Optional. Allows other pages on the site to be referenced in a short list. The relationship is manually created, not inferred from any data such as tags.

      click add new paragraph

      The Related Content fields display.

      Title - Optional. Heading to label the related pages. e.g. "Associated research", or "See also"

      Related content - Reference to other pages on the site. Type the first few letters of a page title to look-up the desired page. Multiple related pages can be added.

      related content

      1. Tags - Click the dropdown arrow to select a tag from the list of vocabularies and their terms to categorise the content.

      tags

      1. Menu Settings  - Tick provide a menu link to display the menu settings options. Adding a page to the menu ensures it will appear in the site map.

      Tick provide a menu link

      Enter the menu settings fields.

      Menu Link Title - The menu link title is automatically populated from the page title. The menu link title can be edited.

      Description - Content entered in the description field will be displayed when hovering the cursor over the menu link.

      Parent Item - Selection of a parent item ensures improved website navigation by displaying a breadcrumb trail at the top of the page.

      Weight - Select a weight to determine the order of the menu link in the Parent Item. Menu links with smaller weights are displayed before links with larger weights.  Tip: easier to drag the links into position to change the order. Review
      re-order menu links.

      Basic page menu

      1. URL path settings - a friendly URL is generated automatically if the tick box remains ticked.

      URL path settings

      1. Revision Information - if create new revision remains ticked, a new version of the structured page is saved each time. The versions are accessible from the revisions tab.

      revision information

      1. Authoring Information - The information of the author is recorded. After the structured page is saved, the "authored on field" is updated.

      authoring information

      1. Publishing Options - Click the tab Publishing options to finalise the publishing settings.
        To publish - The published field is automatically ticked. Keep it tick to publish
         To create a draft - untick published to save as a draft.

      publishing options

      1. Save - Click Save to update the structured page. 
      • Header - Optional hero image.
      • Introduction
      • Structured content paragraphs - Displayed as either; tabs, accordion, step-by-step or table of contents.
      • Aside - Optional.
      • Side menu
      • Related content - Optional.

      Structured page layout

      Topic: Person and team

      Review the guides relating to creating a person and team profiles.

      Guides for Task: create a person (professional and academic)

      The Person content type is used to display a biograph page, most commonly for staff. People can be grouped into Teams and listed in the Staff Directory.

      People can be manually added on the site, or imported automatically from authorative central data.

      Imported data must be updated at its source of origin to feed through to UQ Drupal.

      Step 1

      In the administration menu, go to Content > Add content > Person.

      select person from the add content menu options

      Step 2

      The edit screen displays.

      1. Display name - Full name and title as preferred for publication. e.g. Mr John Citizen
      2. Firstname - Used in the page url
      3. Surname - Used in the page url
      4. Postnominal

      first 4 fields in person page
       

      1. Position - Paragraph containing multiple fields. A person can have multiple positions.

      Add position button
       

      The Position fields display.

      Organisation ID
      Organisation Title
      Position Title - Imported from Aurion.
      Staff group - Optional. Groups staff by type for filtering in the Staff Directory
      Phone
      Fax - Imported from UQ Researchers

      position fields

      To add additional positions, click Add another Position.

      1. Email - Imported from the primary email field in Webprism.

      enter the email address
       

      1. Areas of responsibility

      Areas of responsibiliity
       

      1. Biography - Imported from UQ Researchers.

      Biography
       

      1. Photo - See profile picture guidance for advice. Imported from UQ Researchers for UQ staff.

      image of browse button to upload an image
       

      1. UQ Username

      blank UQ username field
       

      1. UQ Researcher ID - Optional. Allows a link to the profile on UQ Researchers
      2. Research profile is public - If ticked, and a UQ Researcher ID is provided, the link to the profile will display on the Person page.
      3. Is a supervisor - If ticked, a paragraph is inserted in the page to provide a link to view current and completed supervisions on UQ Researchers.
      4. eSpace Author ID - Optional. If provided, an automated feed of publications for that author will display on the Person profile page.

      position fields linking to UQ researchers and eSpace
       

      1. Research Area - select the research area that the researcher works in.  The research areas are added as terms to the Research area vocabulary.  A Site coordinator can add a term to a vocabulary. For further information about terms and vocabularies, review Taxonomy.

      Research area selection drop-down
       

      1. URL path settings - a friendly URL is generated automatically if the tick box remains ticked.

      URL path settings
       

      1. Revision Information - if create new revision remains ticked, a new version of the basic page is saved each time. The versions are accessible from the revisions tab.

      revision information
       

      1. Meta tags

      Meta tags
       

      1. Authoring Information - The information of the author is recorded. After the basic page is saved, the "authored on field" is updated.

      authoring information
       

      1. Publishing Options - Click the tab Publishing options to finalise the publishing settings.
        To publish - The published field is automatically ticked. Keep it tick to publish
         To create a draft - untick published to save as a draft.

      publishing options
       

      1. Save - Click Save to update the person content type.

      Finding a UQ Researcher ID

      1. Go to http://researchers.uq.edu.au and search for the reseacher.
      2. The researcher's profile page displays. The UQ Researcher ID appears at the end of the URL:
        https://researchers.uq.edu.au/researcher/{UQ Research ID}

      Finding an eSpace author ID

      1. Go to http://espace.library.uq.edu.au and search for the author.
      2. A list of publications by that author displays.
      3. Click on the name of the author in one of the results to view results for specifically that author. The eSpace ID appears at the end of the URL:
        http://espace.library.uq.edu.au/list/author_id/{eSpace ID}

      The feed of publications from eSpace is cached on Drupal websites for 1 hour for performance reasons.

      1. Display name
      2. Position title
      3. Organisation title
      4. Telephone
      5. Email
      6. UQ Researcher profile link
      7. Profile image
      8. UQ Researcher biography
      9. Areas of responsibility
      10. Supervision block linking to UQ Researchers
      11. eSpace publications
      12. Research areas

      Person display layout

      How does it work?

      • Provide your organisation unit ID.
      • A number of profiles of the staff who have a position in your organisation unit will be created on the site. Casual and part-time staff can be ignored at your request.
      • A daily import will be triggered automatically every night to ensure the profiles on the website are kept up to date.

      If you wish to import person profiles to your sites, please send your request to webservices@uq.edu.au.

      Where does the data come from?

      The data comes from the UQ HR system. All imported data will be locked and cannot be overridden. If you wish to update any personal or position details, please contact HR to update the corresponding staff record.

      Can I still use custom profiles on my site?

      Yes. If you wish to create a custom profile for your staff, please unpublish (not remove) the imported profile to ensure no duplicated profiles are published at the same time. Any profile which is created manually will not be overridden by the daily import.

      Any removed profiles will be re-created during the daily import, therefore we recommend you to unpublish instead of deleting the imported profile if you wish to replace an imported profile with a custom created profile.

      Guides for Task: create a team (professional and academic)

      Teams are manually managed groups of people. They can be used to represent organisational structure, research teams, or any other ad-hoc grouping.

      It is recommended to create people pages first, and then create the teams to assign them to.

      Step 1

      In the administration menu, go to Content > Add content > Team.

      Add content team page

      Step 2

      The edit screen displays.

      1. Title - Page title
      2. Description - Optional. DescibDescribeseam's role, purpose, etc.

      team create page

      1. Members - Multiple groups of people can be added to a team.
        • Description - Optional. Describes the title, role, function of these members in the team.
        • Members - Entity reference to each Person node. Order is set manually by dragging.

      Add team members

      1. Staff group - Optional. Categorise the Team to allow sorting/filtering on listing pages such as the Staff Directory.
      2. Email - Optional. General contact email for the team. e.g. team-name@org.uq.edu.au
      3. Phone - Optional. General team phone number.
      4. Location - Optional. Physical location of the team if they are accessible publicly.
      5. Tags - Click the dropdown arrow to select a tag from the list of vocabularies and their terms to categorise the content.

      Team Training Staff Grouping and tags image

      Topic: Event

      Review the guides related to creating an event.

      Guide for Task: Event with and without sessions.

      Guide: Events

      For task: promote event in a card grid

      Guide: Card grid