Seiten-Inhalte

Content Items erstellen

Weil Content Items nicht nur für Seiten verwendet werden, erstellen wir ein eigenes Modul. Du wirst dieses für die meisten deiner Projekte verwenden können! Für das neue Modul (Namespace ci) legen wir wieder die drei bekannten Verzeichnisse an:

• app/ci
• var/etc/ci
• public/assets/ci

Content Items speichern wir wie unsere BusinessObjects unter app/ci/bo. Erstelle die Content Items CiArticle, CiAttachment, CiImage, CiWysiwyg. Wir stellen sie dir hier zum Download zur Verfügung:

Content Items registrieren

Alle Entitäten müssen in n2n registriert werden. Wir eröffnen dazu var/etc/ci/app.ini mit folgendem Inhalt:

[orm]
entities[] = "ci\bo\CiWysiwyg"
entities[] = "ci\bo\CiImage"
entities[] = "ci\bo\CiArticle"
entities[] = "ci\bo\CiAttachment"

EiSpecs erstellen

Dieser Abschnitt wiederholt EiSpec erstellen aus dem Rocket Quickstart. Wir gehen darum nicht nochmals auf die Details ein. Starte den Hangar von deinem Projekt:

http://localhost/[pfad-zu-deinem-projekt]/hangar/

Zuerst müssen wir unter den Entitäten die EiSpecs für Rocket erstellen. Dies machen wir, indem wir in Hangar die Content Item Klassen unter den Entitäten suchen, Rechts-klicken und Generate EiSpec klicken.

Jetzt ist es wichtig, dass du bei jeder EiSpec folgende Schritte ausführst:

• General: korrekte Labels aussuchen. Beispiel: "Ci Wysiwyg" ist ein schlechtes Label für deine Content Editoren. Wir schlagen "Freitext" vor.
• Fields: Klicke auf "add auto EiFields", um die Eigenschaften der Content Items zu erkennen
• Fields: Jetzt kontrolliere alle Eigenschaften der Felder. Welche Felder müssen obligatorisch (mandatory) sein? Beachte, dass CiArticle, CiImage und CiAttachment zwingend ein File brauchen. Wo hast du String Felder mit begrenzten Längen? Beim Attachment könntest du die erlaubten Formate begrenzen.
• Speichere alles (Save all)

Der Hangar hat dir jetzt var/etc/ci/rocket/specs.json gespeichert. Du kannst sie mit unseren vergleichen:

Panels registrieren

Wir wollen mit Content Items Seiteninhalte erfassen. Content Items werden in Panels ausgegeben. Bisher haben wir aber noch keine Panels registriert. Für die Anzeige unserer Seiten haben wir app/template/TemplatePageController erstellt. Um unsere Pannels zu registrieren, kannst du die Annotations-Methode von TemplatePageController wie folgt anpassen:

    private static function _annos(AnnoInit $ai) {
        $ai->m('startPage', new AnnoPage(), new AnnoPageCiPanels('hero', 'main'));
        $ai->m('standardPage', new AnnoPage(), new AnnoPageCiPanels('main'));
    }

Wir fügen einfach eine zweite Annotation AnnoPageCiPanels() hinzu. Als Parameter geben wir die Namen all unserer Panels mit.

Wenn du jetzt ins Rocket gehst und die Startseite oder eine Contentseite bearbeitest, kannst du bei diesen Seiten die Panels mit Content Items befüllen. Damit die Inhalte unserer Panels aber ausgegeben werden, müssen wir die Views anpassen.

Views anpassen

Unsere Seiten werden von app/template/TemplatePageController ausgegeben. Dieser ruft wiederum  app/template/view/startPage.html.php und app/template/view/standardPage.html.php auf. Hier müssen wir die Content Items nun auslesen.

app/template/view/startPage.html.php schaut neu so aus:

<?php
    use n2n\impl\web\ui\view\html\HtmlView;
    use n2n\web\ui\view\View;
    use page\ui\PageHtmlBuilder;

    $view = HtmlView::view($view);
    $pageHtml = new PageHtmlBuilder($view);
    
    $view->useTemplate('boilerplate.html');
?>
<div class="jumbotron">
    <div class="container">
        <h1><?php $pageHtml->title() ?></h1>
        <?php $pageHtml->contentItems('hero') ?>
    </div>
</div>

<div class="container">
    <?php $pageHtml->contentItems('main') ?>
</div>

Das einzige was sich verändert hat, ist dass wir $pageHtml->contentItems() zweimal eingebaut haben. In app/template/view/standardPage.html.php ist die Anpassung analog:

<?php
    use n2n\impl\web\ui\view\html\HtmlView;
    use n2n\web\ui\view\View;
    use page\ui\PageHtmlBuilder;

    $view = HtmlView::view($view);
    $pageHtml = new PageHtmlBuilder($view);
    
    $view->useTemplate('boilerplate.html');
?>
<div class="container">
    <h1><?php $pageHtml->title() ?></h1>
    <?php $pageHtml->contentItems('main') ?>
</div>

Hier müssen wir nur einmal die Content Items einbauen. $pageHtml->contentItems() macht nichts anders, als über die angehängten Content Items zu iterieren und die HTML Ausgaben zusammen zu setzen.

Wenn du soweit bist, kannst du das Page Modul einmal ausführlich testen, indem du den verschiedenen Seiten Inhalte hinzufügst. Ebenfalls ist es natürlich denkbar, dass du eigene Content Items entwickelst und verwendest!