Use the Project content type to showcase NSW Government projects on nsw.gov.au.
Projects use detailed pages that are displayed in listing pages.
Projects detailed page
Editors can use projects detailed page to cover all key details for a project. It can be created by selecting Manage > Add Content > Project.
You will need to work through the following tabs to create the page (Content, Project, Quick Facts, Media, Tags). Some fields are mandatory. The Governance accordion on the right will also need to be completed.
Project name (mandatory): it will appear as the title on the hero banner.
Summary: it will appear under the title on the hero banner, and on the project's clickable card on the list view of the listing page. Has a 160 character limit for better front-end user experience.
Note: the following components are added to the page by selecting them from the dropdown next to 'Add Callout'.
Callout: can be used for alerting users of any important information. For example, 'detour'.
Block: can be used for adding project information and related documents.
Media list: can be used for adding related project videos using the media list block.
Gallery: can be used for adding any project images using the gallery block. Remember to use a text block to add a title to the block.
Statistics: can be used to add quick facts about the project. Can be set up alongside footnotes.
Sequence: can be used to add timelines about the project.
Accordion/tabs: can be used to add FAQs about the project.
Contact information: can be used to share contact details, such as phone number and operating hours, and social media channels.
Cards: can be used to add card links to any related projects. Remember to use a text block to add a title to the block.
Last updated (mandatory): the last time the project details were updated. Also used on the listing page for sorting projects by 'last updated' date. Any projects with the latest updated date will appear on the top of the list in this sorting.
Master project: uses taxonomy tags from the category. Request support from a content administrator if you need tags added to this category.
Project types: uses taxonomy tags from the category. Can add multiple values.
Address: type in an address for the project and select it from the dropdown list of recommended addresses.
If the Google API does not return an address, the project location may not be registered yet. If so, enter the lat/long coordinates on the respective fields. The coordinates will show as a pin on the map.
- Editors can hide the map from the detailed page by enabling the 'hide map' checkbox.
- Map description is recommended for enhancing accessibility.
Project status: can be one of 5 values – Construction, Planning, Design, In progress or Completed. Will turn green when status is completed.
Have your say: can be used to add internal or external links for any public feedbacks for the project.
Start and end date: the start and end dates for the project. Will only show month and year on the frontend.
Short title and URL slug: refer to Using titles, short titles, URL slugs and meta tag fields for guidance.
Lead (mandatory): the agency looking after the project. Multiple agencies can be added if required.
Total cost: cost of the project. Must be in $235 million format.
Attributes: can be used to add key attributes for the project.
Banner: the image displayed on the hero banner of the detailed page and on the card of the listing page. If no image is specified, it will stay blank with a white background.
Region: council or local health districts for the project.
Editorial group (mandatory): the editorial group responsible for maintaining the page. Can have multiple groups. Only editors part of these groups can access and update the page's contents.
Projects listing page
The project listing block can be added on landing pages by selecting Add block > App: Project Finder.
Features of the listing page:
- It has list view (default) and map view options like other listing pages.
- Projects are sorted by last updated date or by project name.
- The filtered choices are appended into the URL once a search is performed/filters are applied on the page. The URL then becomes a deep link which users can save and share wherever needed.
Options section
The listing page can be configured with the following options. Each option is optional.
- Agency: choose which agency's projects are shown on the listing page. Can include multiple agencies.
- Topic, Categories, Master projects: the listing page can be set up to show projects belonging to a specific topic, category or master project.
- Project statuses: choose to show projects with a specific project status. For example, the listing page may exclude projects that are completed.
- Enable map display: enables map view for the listing page. If this is left disabled/unchecked, the page will only be available in list view.
Results section
Editors can use this to customise the 'No results' message when a user's search does not match any projects. Leaving this blank will keep the message as 'No results'.
Keyword search
This is the only mandatory filter for the listing page. Keyword search is related to the project's title, summary or master project.
Location search
This filter is pre-populated with set placeholder text. For consistency across other listing pages on nsw.gov.au it is best to keep this section as-is.
Otherwise, location search can be disabled by toggling the 'enable location search' checkbox off.
Note: by default, the listing page will show projects within a 10km radius of the location being searched for.
Date filter
This filter allows the user to search for projects within a range of dates. It is related to the project start and end dates.
This can be enabled by toggling the 'enable date filters' checkbox on.
Tip: use this to make the date label easier for the user to use. For example, Project timelines rather than 'date'.
Project status
This filter configures the project status search section. Project status allows users to search for projects based on their statuses.
This can be enabled by toggling the 'enable status filters' checkbox on.
Note: project statuses must be added on the Project status field of the Options section if you are using this filter.
Tag filters
This filter configures the tag search section. Tag filters allow users to search for projects based on taxonomy tags linked with projects.
More tag filters can be set up by selecting the 'Add more' button.
Sample detailed page
Sample listing page
Need any more help?
If you have any questions, or require assistance with anything mentioned in this article, submit a request via the webform.