[PL] DSP 2017 – Co, jest czym w Umbraco?

O tym dlaczego Umbraco skradło moje serce mogliście przeczytać w poprzednim wpisie. Teraz przyjrzyjmy się elementom, które warto poznać zanim rzucimy się na głęboką wodę. Zrozumienie zasad i relacji, które rządzą poszczególnymi z nich jest kluczowe, aby przygody z Umbraco nie zakończyć w ekspresowym tempie, rzucając pod nosem soczystą wiązanką przekleństw.

Co, jest czym w Umbraco?

W Umbraco wyróżniamy kilka podstawowych elementów, które pozwalają zorganizować i zbudować strukturę treści. Poniżej spróbuję je pokrótce omówić, natomiast w późniejszych postach pokażę ich zastosowanie na konkretnych przykładach.

Data Type

Jest to podstawowa jednostka systemu określająca typ danych. Można powiedzieć, że jest to najmniejszy z klocków, z których zbudowana jest nasza aplikacja. Jako Data Type możemy zdefiniować zarówno pole tekstowe, edytor WYSIWYG, listę rozwijaną, itd. Co ważne, możemy tworzyć całkowicie własne typy, posiadające niestandardowe metod wprowadzania danych lub przechowujące te dane w niestandardowy sposób. Podczas tworzenia mojego projektu postaram się pokazać przynajmniej jeden przykład w 100% własnego typu danych.

Listę wszystkich zdefiniowanych typów danych można znaleźć w panelu administracyjnym, w sekcji Developer:

Document Type

Typy dokumentów to kluczowy element całej układanki. To dzięki nim możliwe jest późniejsze zbudowanie struktury treści. Document Type składa się ze zbioru elementów typu Data Type (właściwości), można więc powiedzieć, że pełni on funkcję kontenera na dane. Typy dokumentów można ze sobą komponować – składać kilka tak, żeby powstał nowy, oraz dziedziczyć – wówczas typ podrzędny otrzymuje wszystkie cechy typu nadrzędnego, z możliwością dodania własnych. Co również bardzo ważne, można określać jak dany typ dokumentu może zachowywać się w strukturze treści oraz jakie szablony widoków można z nim powiązać.

Listę wszystkich zdefiniowanych typów dokumentów można znaleźć w sekcji Settings:

Przykładowa definicja Document Type:

  • Site – zakładka, umożliwia grupowanie właściwości
  • Site Description – właściwość
  • Textarea – Data Type powiązany z właściwością Site Description

Content Node

Content node stanowi element w drzewie treści (Content Tree) i jest tak naprawdę wypełnionym danymi typem dokumentu. Na podstawie pozycji w drzewie treści generowany jest adres url każdego z węzłów. Węzły mogą posiadać dwa stany, zapisany oraz opublikowany. Węzeł zapisany porównać można do wersji roboczej, draftu, będzie on zapisany w bazie danych, jednak do momentu opublikowania nie będzie widoczny na naszej stronie.

Przykład wypełnionego Content Node:

Template

Template to szablon widoku, który pozwala określić w jaki sposób chcemy wyświetlić dane wypełnione w Content Node. Standardowo Umbraco używa widoków domyślnych dla ASP.NET MVC, a co za tym idzie do wskazywania miejsc, w których wyświetlić ma się dana wartość wykorzystywana jest składnia Razor. W kolejnych wpisach pokażę w jaki sposób tworzyć szablony widoków od podstaw, na chwilę obecną wystarczy nam informacja, że listę aktualnie zdefiniowanych szablonów można znaleźć w sekcji Settings:

Podsumowanie

  • Data Type – najmniejsza komórka przechowująca dane
  • Document Type – zbiór elementów Data Type, kontener na dane
  • Content Node – treść, to co chcemy wyświetlić, właściwe dane uzupełnione na podstawie wybranego Document Type
  • Template – szablon widoku, w jaki sposób chcemy chcemy wyświetlić dane z Content Node

Zdjęcie w nagłówku pochodzi z pexels.com



 


Related articles

  • Kamil Hadas

    Hej, coś widzę, że zapszestałeś, mam nadzieję ze tylko chwilow. Dobrze się czyta to co piszesz no i chętnie bym się dowiedział więcej o Umbraco. Ja wskoczyłem odrazu na głęboką wodę z umbraco i często o prostych rzeczach nie wiem (jak np ostatnio musiałem googlać co trzeba zrobić by node był twoim homepage 😉 ). Jakby co, ja cały czas tu zerkam 🙂

    • Dzięki Kamil, kilka draftów mam gotowych także pewnie niedługo sypnę nowymi wpisami 🙂