Current staff

Federated news

  1. Home
  2. Information and services
  3. Information technology
  4. Web and intranet sites
  5. Updating new Drupal websites
  6. Content types
  7. Landing page

Federating news allows articles to be 'pushed' to other websites.

Instead of duplicating content, you can select news articles you would like to display on your website. You can choose to select articles based on tags, or manually curate articles you want to appear.

Federation is only available between the UQ News website and other New Drupal websites.

Tag logic

Federated article components use tag logic to determine what articles to display.

  • Within fields: Uses 'or' logic. For example, selecting ‘Home’ and ‘About’ will show articles tagged with either. 
  • Between fields: Uses 'and' logic. For example, selecting ‘About’ in Topics and ‘Business and Economics’ in Publish to will show articles tagged with both.

Displaying federated news

Federated news articles can be added to a New Drupal site as a block of articles, or as a listing page.

Federation articles block

The News federation article block displays a block of articles on other New Drupal websites. 

Features 

  • Displays 1-4 news cards. 
  • Federates articles from UQ News.
  • Option to curate articles for display, or filter by tag.
  • Option to exclude articles based on tags.

Guidelines 

  • Only available on landing pages.
  • Limit of one block per page.
  • Articles available for selection are based on the 'Publish to' tags relevant to your site. 

How to add a News articles block 

Create a Section (Design System) section, then add your News federation articles block to the section. 

1. Add section 

  1. Select 'Add section'.  
  2. Choose the layout ‘Section (Design System)’.  
  3. Complete the fields:   
    1. Administrative label (optional) – This label isn’t visible to users. Use it to help other people editing your page understand the intent of the section.  
    2. Student type – Only applies to the Study website.
  4. Select 'Add section'. This adds your section to the landing page.  

2. Add News federation articles block  

  1. Select ‘Add block’ in your new section.  
  2. Select ‘Create content block’.  
  3. Choose 'News federation articles’ block.  
  4. Choose which fields to complete depending on the purpose of your content
    • 'Title' (optional) – add a title for your block. Use titles to contextualise what is listed below.
    • 'Summary' (optional) – add a summary to appear above your article cards if you need to provide context.
    • 'See more link' (optional) – add link URL and link text to link to a relevant news listing.  
    • 'Quantity' (mandatory) – choose to display 1-4 articles in your block. We recommend maximum 3 articles.
    • 'Selected articles' (optional) – Select specific articles to display. Results will filter by any Topic or Publish to tags selected below.
    • 'Topic tags' (optional) – choose topic tags to filter articles. Choose any of the topics from the UQ News website.
    • 'Publish to tags' (mandatory) – choose custom tags to filter articles. Only tags available for your site will be shown.
    • 'Exclude articles' (optional) – select any articles you don't want to display. Exclusions only apply to articles shown through the 'Topics' and 'Publish to' filters. If an article is selected manually and excluded, it will still be displayed.
  5.  Select 'Add block'. This adds your News federation articles block to the section.
Top of page

Federation listing 

The News federation listing block displays a listing of news articles on other New Drupal websites.

Features  

  • Displays 10 or 20 articles per page.
  • If your listing has more than 20 news articles, the listing will paginate.

Guidelines

How to add a News listing 

First you'll need to create a Section (Design System) section, then add your News federation listing block to the section.   

1. Add section

  1. Select 'Add section'.  
  2. Choose the layout ‘Section (Design System)’.  
  3. Complete the fields:   
    • Administrative label (optional) – This label isn’t visible to users. Use it to help other people editing your page understand the intent of the section.
    • Student type – Not applicable on the UQ News site. 
  4. Select 'Add section'. This adds your section to the landing page. 

2. Add News federation listing block  

  1. Select ‘Add block’ in your new section.  
  2. Select ‘Create content block’.  
  3. Choose 'News federation listing’.  
  4. Choose which fields to complete depending on the purpose of your content.  
    • ‘Title’ (optional) –  add a title for your listing. Use titles to contextualise what is listed below.   
    • ‘Display’ – choose to display 10 or 20 articles per page (pagination will occur for lists that exceed the display number). 
    • 'Topics' – choose a topic tag to display articles from.  
    • 'Publish to' – choose custom tags to display articles from.   
    • 'Excluded publish to' – select custom tags to exclude items from.   
  5. Select 'Add block'. 
Top of page

Tagging articles for federation

To make an article appear in the federation block or listing, it needs to be tagged with a relevant 'Publish to' tag for your site. 'Publish to’ terms are managed on the News website.

If you're unable to see a 'publish to' tag in the federation block:

  • for new local articles, you'll need to apply the ‘publish to’ tag to the article.
  • for new UQ News articles, request the M&C Media and content team adds the ‘publish to’ tag at the point of publishing.
  • for existing UQ News articles that do not have the relevant ‘publish to’ tag, ask the M&C Media and content team to add the relevant tag to the article. 

Request a new tag

If a relevant tag does not exist, submit a request to the M&C Web team.

In your request, outline why you need a custom tag and flag any existing articles that are suitable for the tag.

Top of page