Dokumentation

Die ausführliche Dokumentation folgt in Kürze. Im Moment liegt der Fokus ganz auf der Entwicklung.

Installation

Plenta Casa lässt sich in wenigen Schritten in eine bestehende Contao-Installation einbinden.

Via Composer

composer require plenta/plenta-casa-core-bundle

Via Contao Manager

m Contao Manager nach Plenta Casa suchen, das Paket auswählen und über den Reiter "Pakete" installieren.

Nach der Installation das Contao-Installtool aufrufen und die Datenbank aktualisieren.

Systemvoraussetzungen

  • PHP ^8.1
  • MySQL >5.7 oder MariaDB
  • Contao ^5.7
  • Symfony ^7.4

Konfiguration

NEU Badge

Objekte können automatisch mit einem „NEU"-Badge versehen werden. Die Anzahl der Tage, nach denen das Badge nicht mehr angezeigt wird, lässt sich in der config/config.yaml konfigurieren:

plenta_casa:
new_badge_days: 7

Der Standardwert beträgt 7 Tage. Das Badge wird angezeigt, solange das Veröffentlichungsdatum des Objektes innerhalb des konfigurierten Zeitraums liegt.

Insert-Tags

Insert-Tags sind Platzhalter, die bei der Ausgabe durch bestimmte Werte ersetzt werden. Mit den Insert-Tags von Plenta Casa bindest du Objektdaten direkt in deine Inhalte ein - ohne Template-Anpassung.

casa_objects_count

{{ casa_objects_count }} = Anzahl der veröffentlichten Objekte (15).

casa_objects_count_by_type

{{ casa_objects_count_by_type::* }} = Anzahl der veröffentlichten Objekte eines bestimmten Objekttyps. * wird durch die ID des Objekttyps ersetzt.

casa_featured_objects_count

{{ casa_featured_objects_count }} = Anzahl der veröffentlichten hervorgehobenen Objekte (1).

casa::object::*

Diese Insert-Tags lassen sich beispielsweise in einem versteckten Formularfeld (Hidden Field) einsetzen, um eine Nachricht automatisch mit zusätzlichen Objektinformationen anzureichern.

{{ casa::object::id }} = ID des Objekts
{{ casa::object::alias }} = Alias des Objekts
{{ casa::object::title }} = Titel des Objekts
{{ casa::object::name }} = Titel des Objekts
{{ casa::object::address }} = Adresse des Objekts
{{ casa::object::object_number }} = Objektnummer des Objekts
{{ casa::object::unit_number }} = Einheitennummer des Objekts

Twig Filter

Twig-Filter werden direkt im Template auf Variablen angewendet und wandeln Werte in ein gewünschtes Format um. Plenta Casa bringt eigene Filter mit - zum Beispiel für Preisformatierung, Datumsangaben oder die Bezeichnung von Objekttypen.

casaObjectTypeName = Name des Objekttypen (casaObjectTypeName(true) zeigt den Pfad des Objekttypen an. z.B. Wohnen > Wohnung > Etagenwohnung)
casaObjectType = Objekttype
casaFormatNumber = Formatiert die Zahlen entsprechend der Spacheinstellung

CSS-Grundgerüst

Plenta Casa wird mit einem CSS-Grundgerüst ausgeliefert - einer soliden Basis für das Webdesign deiner Immobilien-Website, auf der du aufbauen kannst. Für einfache Anpassungen stehen CSS Custom Properties (Root-Variablen) zur Verfügung. Wer volle Kontrolle möchte, kann das Styling auch komplett eigenständig aufbauen. Weitere fertige Themes sind in Planung und werden nach und nach ergänzt.

Wer das CSS-Grundgerüst nutzen möchte, aktiviert dafür im Seitenlayout die entsprechende Checkbox.