HACKATHON

Welcome to my comprehensive guide on how to manage hackathon.bz.it website. You don’t have to follow the rules I will describe in this guide, but it will make it a heck a lot easier to publish your contents. I follow the best practice convention over configuration, which should simplify the creation and publishing of new and pre-existing content. Try to follow the existing rules and your content-management duties will become semi-automated. Let’s begin.

Rules to follow when…

… creating a new Hackathon Edition

  • go to admin->Pages, there you will see the navigation with all existing sites. There will be also be a site called Editions, with its subsites, the single editions. Click on Editions and Add child page, call it with the Month and year of the edition, like for example ‘June 2018’. Choose the one column layout and click on Save. Now it should be shown under the editions page and you should be able to visit the site on by adding the site name to your domain for example ’http://hackathon.bz.it/june-2018'. It will be empty, but you haven’t added any contents yet. Let’s do that.
  • go to content->web-content and here you will find a lot of preexisting content which in certain cases you will also be able to reuse. You will find 3 different types of content:
    • static contents: these are contents which will not get archived and once changed, you will not find the old version on the website, for example FAQ, which stays the same for all editions and once you modifie it, it will be that and nothing else
    • semi-dynamic contents: these contents are being archived and therefore will be available in all editions. For each edition you create one web content of each, for example Sponsors.
    • dynamic contents: these contents are also being archived and can easily be reused every where on the website, for example and most offten Partecipant

Let’s start with something simple:

  • How to add a new Question in FAQ(static content)?

Go to web-content and click on the FAQ article. Here you will find a form which beholds all the questions and answers. You can add a question wherever you want by clicking on one of the plus-symbols you will find on each question. You can also remove question by clicking on the minus-symbol

  • How to add a new sponsor-section (semi-dynamic)?

Go to web-content section and enter the folder Sponsors, click add->Sponsors and fill out the form you get presented ther. By saving(or publishing) the content you will get an article, which will be placed in the Sponsors folder. You can also reuse old articles by clicking on the down symbol on the right you will find an action copy which will give you a complete copy of the main article.This works also for:
- Event pictures
- Event videos
- Prizes
- Schedule

  • How to add a new Jury Member?

In the Hakathon web-site you create a Participant article for every person parcitipating in the event. To do that, go to web-content add->Partecipant
Here you will be able to fill out the form data you get presented. You can add descriptions, photos, social urls … Don’t forget to check if a partecipant already exists in your partecipant folder. You can easily use the search box for that.
You can do all this the same way with Project teams

Tags

To create associations between a partecipant and a project team we use tags. For each article you can find the tags on the side panel in Categorization.
Once you create a project-team, try to create a tag which combines name of the team and the edition like for example TeamSoup-05-2016. Save this article and find or create all the teammembers and don’t forget to associate them with the same tag.

With tags you can also define which role the person had in this edition, like for example coach-05-217

  • tag user with following tags
    • role-by-year-tag: {role}-{MM}-{yyyy}}
    • (only if in project team) project-tag:{projectname}-{MM}-{yyyy}

role … can be either ‘staff’,‘jury’,‘coach’ or ‘team’.

MM … Month e.g. 11

yyyy … Year e.g. 2017

Display Contents

Once you created all your contents and tagged them the correct way you can put them on your website visible for everyone.
Go to your edition site, which you created beforehand and click on Add. There you will find an Asset Publisher which you can drag in your website. Click on Options->Configuration on the Asset Publisher you just created and go to the Filter section. There you have to choose 3 Tags:

- The 'edition tag' e.g. 05-2017
- The 'staff tag' e.g. staff-05-2017
- The 'jury tag' e.g. jury-05-2017

The last thing to do is to change the display template. In Configuration->Display Settings under Display Template, choose Edition_assets_template
This is it, now you should be able to see all the contents of the specific editions.

You might also want to change the hackathon main page. To do that you need to change the following for:

  • static contents: Nothing, for the simple reason that once you change them they will be the same everywhere
  • semi-dynamic contents: Go the the Hackathon main page and scroll to the content you want to change, for example Sponsors, click on the wheel underneath and choose the new article you created for the given section like for example Sponsors may 2017.
  • dynamic contents: For each section which contains dynamic contents like jury an asset Publisher has been created. You can change the contents, by switching the tags in the configuration you can display the content you like to.

Sorting and ordering

If your contents are displayed with an asset publisher you can also order them by their properties. Just click on the wrench Symbol and go to configuration. Go at the bottom where you can find a sort and order section. There you can choose the property to sort against and decide if ascending or descending

If you have problems creating or modifying contents, or if the site gives you exceptions, you can contact me under patrick.bertolla@idm-suedtirol.com