/ Indeks dokumentacji / Wdrożenie / Szabon strony / Plik XHTML / Znaczniki w systemie / Dynamiczne elementy / cms:Library

cms:Library

<cms:Library id = "identyfikator" [Publish = "yes|no"] [Lock = "yes|no"] [Origin = ""] [Cache = ""] />

Atrybuty:

id - Dowolny ciąg znaków wyróżniający dany element spośród pozostałych pozostałych elementów tego samego modułu. Musi być on unikalny dla pojedynczego szablonu. Elementy tego samego typu (np. tekst) o identycznych identyfikatorach informują system o tym, że element na stronie ma swoją kopię (oba elementy są takie same). Identyfikator może posiadać polskie znaki i w sposób opisowy identyfikować element strony.
Publish - Opcjonalny: Publikuj/Nie publikuj/Prawa dostępu [yes|no|rights]
Lock - Opcjonalny: Blokuj dostęp. Edycja możliwa tylko przez użytkownika root lub właściciela strony. Przyjmuje wartości yes|no|rights.
Cache - Opcjonalny: Cache treść elementu.
Origin - Opcjonalny: Miejsce pochodzenia. Można ograniczyć publikację tylko do wskazanego miejsca pochodzenia. Np. mimo, iż element jest edytowany na stronie matce to może on być widoczny tylko w abstrakcie (Origin="abstract"), np. miniatura zdjęcia, albo treść zajawki w artykule.

Opis elementu:

Moduł library służy do budowania strony internetowej z gotowych elementów, które umieszczone są w tzw. bibliotece. Załóżmy, że nasza witryna składa się z powtarzalnych elementów, np. zdjęcia prezesa z jego podpisem. Gdy będziemy tworzyć każdą stronę trzeba będzie za każdym razem przygotować ten element i wprowadzić go na stronę. Moduł library zapobiega temu. Wystarczy raz w systemie utworzyć element np. "prezes" i wskazać gdzie na tworzonej stronie ma się on znajdować. Korzystając z elementów z biblioteki ułatwiamy sobie budowanie strony, gdyż tworzenie strony będzie przypominać wklejanie gotowych objektów.

Proces tworzenia elementu

Aby na podstawie wybranego szablonu stworzyć element strony, a nie całą stronę należy podczas dodawania nowej strony wybrać typ strony jako element. Utworzona w ten sposób strona będzie mogła być elementem innej strony. Możemy też zmienić istniejącą już w systemie stronę na element, czyli część innej strony. Aby to zrobić kliknij w menu "Strona" i "Właściwości strony". Następnie kliknij "Ustawienia" i wybierz Yes w pozycji "Strona jest elementem biblioteki".

Podpinanie elementów na stronie

Umieszczenie elementu biblioteki na stronie zaczynamy od wskazania w szablonie strony pozycji w której będzie się on znajdować. Robimy to wprowadzając w szablonie następujący wpis:

<cms:Library id="Identyfikator" />

Po przeładowaniu strony zbudowanej na podstawie zmienionego szablonu w miejscu komendy cms::Library pojawi się konsola do dodawania nowych lub podpinania gotowych obiektów z biblioteki.

Element dodajemy przez wprowadzenie nr id elementu we właściwościach - w pozycji LibraryId.

Przykład

Szablon elementu Prezes:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<head>
<title>Prezes</title>
</head>
<body>
<center>
<cms:Image id="Zdjęcie" /><br>
<cms:Plaintext id="Imię i nazwisko" /><br>
</center>
</body>
</html>

Na podstawie tego szablonu tworzymy element strony. Będzie on wykorzystywany na wielu stronach.

Szablon strony:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<body>
<head />
<h1>Nasz szef</h1>
<cms:Library id="Element z biblioteki" />
</body>
</html>

Podpięcie przez konsole w +CMSie pod tag <cms:Library id="Element z biblioteki" /> obiektu Prezes spowoduje, że szablon po uruchomieniu w CMSie będzie miał postać:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<body>
<head />
<h1>Nasz szef</h1>
<center>
<cms:Image id="Zdjęcie" /><br>
<cms:Plaintext id="Imię i nazwisko" /><br>
</center>
</body>
</html>

System automatycznie podstawi pod tag <cms:Library id="Element z biblioteki" /> dane z przypisanego elementu.

Zagnieżdżone odwoływanie się do elementów z biblioteki

Załóżmy, że nasza strona składa się z elementu" Spis Prezesów". A "Spis Prezesów" składa się z kolejnych obiektów (elementów), np. "Prezes". Wówczas można skonstruować tak stronę, aby w bibliotece znajdowały się następujące obiekty: Prezes 1, Prezes 2, Prezes 3. Wykorzystywały by one szablon "prezes". Dodatkowo byłby element "Spis Prezesów" w którego skład wchodziliby prezesi.

Konstrukcja takich szablonów wyglądałaby następująco:

Szablon "Prezes":

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<head>
<title>Prezes</title>
</head>
<body>
<center>
<cms:Image id="Zdjęcie" /><br>
<cms:Plaintext id="Imię i nazwisko" /><br>
</center>
</body>
</html>

Szablon "Spis Prezesów":

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<head />
<body>
<h2>Spis prezesów</h2>
<cms:Library id="Prezes 1" />
<cms:Library id="Prezes 2" />
<cms:Library id="Prezes 3" />
</body>
</html>

Szablon strony:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns:cms="http://manual.pluscms.net">
<head />
<body>
<h1>Nasz Zarząd</h1>
<cms:Library id="Spis prezesów" />
</body>
</html>

Spowoduje to umieszczenie elementu biblioteki w innej bibliotece i ostatecznie podpięcie to pod stronę www. Należy uważać jednak, aby nie spowodować utworzenia nieskończonej pętli która by nie miała końca. Przykład. Element pierwszy umieszcza zawartość elementu drugiego, a element drugi umieszcza ponownie zawartość elementu pierwszego - i sytuacja się powtarza. System informuje o wystąpieniu takiej sytuacji.

Zobacz więcej...

Metryka dokumentu
Tytuł:	Indeks dokumantacji
Opis:	Spis stron dokumentacji
Źródło:	+CMS Content Management
Prawa autorskie:	+CMS Content Management Platform
Autor:	root	Zmodyfikowany przez:	root
Data utworzenia:	2008-09-07 18:06:57	Data modyfikacji:	2008-09-10 17:09:47
Data publikacji:	2008-09-07 18:18:25