Tworzenie układów zawartości

Układy zawartości ułatwiają użytkownikom wyświetlanie danych w elementach zawartości za pomocą składników "lista zawartości" lub "element zastępczy zawartości", używanych na stronach serwisów. Tworząc różne układy zawartości dla typu zawartości, można utworzyć różne widoki lub zaprezentować różne części elementu zawartości.

Na przykład typ zawartości "Blog-Post" może wymagać różnych układów zawartości w zależności od przewidywanego sposobu i miejsca używania zawartości "Blog-Post". Na stronie startowej serwisu może być wyświetlana lista elementów "Blog-Post" i — gdy użytkownik kliknie na którymś z nich — zostanie wyświetlona strona Szczegóły wpisu na blogu.

Na stronie startowej znajduje się listę zawartości skonfigurowana tak, aby wyświetlała — za pomocą układu zawartości "Blog-Post-Summary" służącego za widok elementów — elementy zawartości typu "Blog-Post".

Strona "Szczegóły" do wyświetlania obrazu i tytułu nagłówka używa układu zawartości "Blog-Post-Header" (w elemencie zastępczym zawartości). Dwukolumnowy układ sekcji obejmuje dwa elementy zastępcze zawartości (o szerokości 70% i 30%), używające układów zawartości "Blog-Post-Content" i "Blog-Post-Author". Jak widać, do wizualizacji tego samego typu zawartości można użyć czterech różnych układów zawartości.

Układ zawartości można utworzyć na dwa sposoby:

• W usłudze Oracle Content Management wybrać kolejno opcje Programista > Wyświetl wszystkie składniki > Utwórz > Utwórz układ zawartości.

• W projekcie OCE Toolkit użyć polecenia cec create-contentlayout.

Oracle Content Management tworzy domyślny układ zawartości dla typu zawartości. Aby zmodyfikować domyślny układ zawartości, należy zmodyfikować następujące pliki:

• assets/layout.html

  Należy edytować ten plik, aby zmienić widok HTML.

• assets/design.css

  Należy edytować ten plik, aby nadać styl układowi zawartości.

• assets/render.js

  Należy edytować ten plik, aby zmienić dane używane w pliku layout.html lub zapewnić dynamiczne działanie układu zawartości.

Składniki "układ zawartości" renderują elementy zawartości z serwera Oracle Content Management. Większość zasobów jest przechowywanych na serwerze Oracle Content Management. Niekiedy trzeba jednak użyć zasobu statycznego, który jest dostępny lokalnie w samym układzie zawartości, taki jak obraz używany na tło. Na przykład w poniższym układzie zawartości bezwzględny URL obrazu images/background.jpg można wygenerować w pliku render.js, a następnie użyć w pliku layout.html.

Najprostszym sposobem generowania bezwzględnego adresu URL jest użycie wbudowanego pliku require.js. Należy zdefiniować 'require' jako zależność, a następnie wygenerować URL za pomocą funkcji require.toURL(), jak pokazano w następującym kodzie:

define([
    'require',
    'jquery',
    'mustache',
    'text!./layout.html',
    'css!./design.css'
], function (require, $, Mustache, templateHtml, css) {
    'use strict';

   var imageURL = req.toUrl('./images/background.jpg');

W poniższych rozdziałach opisano, w jaki sposób tworzyć układy zawartości:

• Tworzenie układów zawartości za pomocą Oracle Content Management

• Przekazywanie widoku układu do układu zawartości

• Generowanie adresu URL strony ze szczegółami serwisu przy użyciu API

• Tworzenie układów zawartości lokalnie za pomocą usługi Developer Cloud Service

• Rozwijanie makra w zapytaniach dotyczących listy zawartości

• Tworzenie odpornych układów zawartości

• Tworzenie przykładowego szablonu bloga

• Dodawanie odwzorowań układu zawartości do szablonów

• Testowanie układów zawartości przy użyciu lokalnego zestawu testów

• Importowanie szablonów z układami zawartości do Oracle Content Management