Zum Inhalt

Erste Schritte

Installation und Einrichtung

Installieren Sie das Contentfly CMS nach den entsprechenden Installations-Anleitungen und rufen Sie im Anschluss das Contentfly CMS über einen Webbrowser aus.

Login in das CMS

Nach der Installation können Sie sich mit Benutzername admin und Passwort admin in das Contentfly CMS einloggen. Vergessen Sie nicht das Passwort nach dem ersten Login abzuändern.

Login

Da Sie bis jetzt noch keine zu pflegende Datenstruktur konfiguriert haben, können Sie natürlich derzeit auch noch keine Daten über das Contentfly CMS pflegen. Beginnen wir also eine erste Datenbank-Tabelle, bzw. eine Doctrine-Entität zu erstellen.

Erste Entität erstellen

Über das Contentfly CMS können Sie eine nahezu beliebige Datebankstruktur verwalten. Das Contentfly CMS verwendet dazu das ORM-Framework Doctrine. Eine Datenbank-Tabelle heißt im Doctrine-Chargon Entität. Definieren wir uns also eine erste Entität.

custom/Entity/Mandant.php

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
<?php
namespace Custom\Entity;

use Areanet\PIM\Entity\Base;
use Areanet\PIM\Classes\Annotations as PIM;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 * @ORM\Table(name="mandant")
 * @PIM\Config(label="Mandanten")
 */
class Mandant extends Base
{
    /**
     * @ORM\Column(type="string", nullable=false)
     * @PIM\Config(showInList=40, label="Name")
     */
    protected $name;

    /**
     * @ORM\Column(type="string", nullable=true)
     * @PIM\Config(showInList=60, label="Strasse")
     */
    protected $strasse;

    /**
     * @ORM\Column(type="string", nullable=true)
     * @PIM\Config(showInList=80, label="PLZ")
     */
    protected $plz;

    /**
     * @ORM\Column(type="string", nullable=true)
     * @PIM\Config(showInList=100, label="ORT")
     */
    protected $ort;


    /**
     * @return mixed
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * @param mixed $name
     */
    public function setName($name)
    {
        $this->name = $name;
    }

    /**
     * @return mixed
     */
    public function getStrasse()
    {
        return $this->strasse;
    }

    /**
     * @param mixed $strasse
     */
    public function setStrasse($strasse)
    {
        $this->strasse = $strasse;
    }

    /**
     * @return mixed
     */
    public function getPlz()
    {
        return $this->plz;
    }

    /**
     * @param mixed $plz
     */
    public function setPlz($plz)
    {
        $this->plz = $plz;
    }

    /**
     * @return mixed
     */
    public function getOrt()
    {
        return $this->ort;
    }

    /**
     * @param mixed $ort
     */
    public function setOrt($ort)
    {
        $this->ort = $ort;
    }
}

Die Entität dürfte selbsterklärend sein. Mit dieser Entität können wir in Zukunft unsere Mandanten über die Felder Name, Strasse, PLZ und Ort pflegen - wobei Name dabei ein Pflichtfeld ist.

Annotationen

Die Konfiguration der Entität erfolgt im Contentfly CMS über sogenannte Annotationen. Über das Prefix @ORM werden alle bekannten Doctrine-Annotationen1 unterstützt. Über das Prefix @PIM können diese mit speziellen Eigenschaften für z.B. die Contentfly CMS Oberfläche ergänzt werden.

Datenbank aktualisieren!

Nachdem Sie die Entitäten konfiguriert haben, muss das Contentfly CMS diese noch in die Datenbank übertragen. Dieser Vorgang muss von Ihnen manuell angestoßen werden - lesen Sie dazu die Hinweise im nächsten Abschnitt.

Datenbank aktualisieren

Die Datenbank können Sie im Contentfly CMS unter Administration->Einstellungen->Datenbank synchroniseren aktualisieren.

Database

Alternativ können Sie die Datenbank auch über die Konsole im Ordner "appcms" aktualisieren:

1
2
#!/bin/bash
php console.php orm:schema:update --force

Daten bearbeiten

Im Anschluss sehen Sie auf der linken Seite bereits unsere neu angelegte Entität Mandant, die Sie sofort mit Leben befüllen können.

Mandanten auflisten

Mit einem Klick auf das Bleistift-Symbol können Sie einen ausgewählten Eintrag natürlich jederzeit beliebig bearbeiten.

Mandanten bearbeiten

Herzlichen Glückwunsch

Herzlichen Glückwunsch, Sie haben die ersten erfolgreichen Schritte mit dem Contentfly CMS gemacht und können sich nun in weitere Tiefen vorwagen.

Wussten Sie schon?

Wussten Sie schon, dass Sie auf die neu erstellte Entität ohne weitere Zutun bereits über eine API zugreifen können? Dazu rufen Sie einfach über einen entsprechenden Webservice-Client folgenden POST-Befehl auf:

https://ihr-contentfly-cms.de/api/list/

POST_Parameter: { entity: "Mandant", order: {"name": "ASC"} }

Mehr Informationen zur Arbeit mit der Schnittstelle/API.


  1. http://docs.doctrine-project.org/projects/doctrine-common/en/latest/reference/annotations.html