/ Indeks dokumentacji / Rozbudowa systemu / Rejestrowanie nowych klas w systemie / Nowe elementy systemu / Pobieranie właściwości elementów dynamicznych

Pobieranie właściwości elementów dynamicznych

Na początek konieczne jest przedstawienie różnic pomiędzy atrybutami, a właściwościami. Nie są one znaczne, niemniej jednak ważne jest aby deweloper znał ją zanim przystąpi do korzystna z nich.

Różnice między właściwościami, a atrybutami

Zarówno elementy dynamiczne jak i statyczne mają atrybuty (ang. Attributes). Można je ustawić w szablonie, przykład:

<cms:Html id=”MojaTreść” Html=”Domyślny tekst” />

Powyższy przykład pokazuje jak dla elementu Html ustawić można domyślna wartość („Domyślny tekst”) dla treści. Pobieranie atrybutów opisano tutaj.

Dla dynamicznych elementów należy rozróżnić atrybuty od właściwości (ang. Properties). Atrybut to wartość wprowadzona w szablonie. Właściwość jest kopią atrybutu z tą różnicą, że jest ona zapisywana w bazie i może być zmieniana.

Dla przykładu jeżeli w szablonie znajduje się zapis (Tag):

<cms:Html id=”MojaTreść” Html=”Domyślny tekst” />

To treść „Domyślny tekst” zostanie zapisana w tabeli cms_item_html w polu html . Następnie może ona być zmieniona przez edytora na inny ciąg znaków, np. „Mój tekst”. Jeżeli chcemy pobrać aktualnie wyświetlany na stronie tekst, czyli „Mój tekst” należy to zrobić w następujący sposób:

class HtmlItem extends DynamicItem {

    public function render() {
        return "This is my Html property: ".$this->getPropery('Html');
    }    

}

Jeżeli chcielibyśmy pobrać atrybut Html, czyli początkową treść przed zmianą przez edytora („Domyślny tekst”) to należy to zrobić tak:

class HtmlItem extends DynamicItem {

    public function render() {
        return "This is my Html attribute: ".$this->getAttribute('Html');
    }

}

Istnieje możliwość bardzo szybkiego sprawdzenia jakie atrybuty posiadają elementy dynamiczne w systemie. Są one opisane w dokumentacji można także je sprawdzić klikając w nazwę elementu (patrz animacja). Można także sprawdzić atrybuty dynamicznych elementów w bazie danych, gdyż każde pole w tabelach zaczynających się od cms_item odpowiada atrybutom elementów dynamicznych.

Zobacz więcej...

Prezentacja