Home

phpWCMS & YAML - eine Kurzanleitung

dieGrundlagen

phpWCMS

Schnelleinstieg
Dokumentation
Forum

YAML

YAML
YAML:Builder

derVerzeichnisbaum

Verzeichnissbaum.gif

dasSeitenlayout

seitenlayout.gif

Profileinstellungen

Profil.gif

dieSubtemplates

Vorlagenwahl.gif

"War es für Dich auch so gut … ?"

Ich freue mich über jegliche Unterstützung.

CSS ist valide!

ALL-INKL.COM Webhosting

Als ich mich für ein Projekt damit auseinandersetzen musste, wie diese beiden ausserordentlichen Werkzeuge gemeinsam zu nutzen sind, fand ich es sehr mühselig, die dafür benötigten Informationen zusammen zu suchen.

Aus diesem Grund entschloss ich mich, selbst eine Kurzanleitung zur Verwendung von YAML mit phpWCMS zu schreiben.

Dieses Tutorial kann und will sich jedoch nicht mit den Grundlagen der einzelnen Projekte beschäftigen. Wer auf der Suche nach diesen Grundlagen ist, findet sie nach einem Blick auf die rechtsstehende Linkliste.

Dieses Tutorial beschäftigt sich im wesentlichen mit folgenden Fragen:

Dieser Teil erklärt, wo die yaml Daten abgelegt werden, welche Verzeichnisse & Dateien angelegt werden müssen & auch warum:
Dieser Teil zeigt, wie das Seitenlayout und die Vorlage in phpWCMS eingestellt werden.
In diesem Teil wird die Anpassung des FCKeditors an die Arbeit mit YAML erklärt.
1
YAML in phpWCMS einbinden!

Einfach den kompletten Ordner yaml, der sich im Downloadpaket von YAML findet, in das template-Verzeichnis kopieren.

Dadurch befindet sich das yaml-Verzeichnis in der gleichen Ebene wie das inc_css-Verzeichnis, wodurch sichergestellt wird, dass Verweise zu yaml in der my_layout.css nicht mehr bearbeitet werden müssen.

In inc_css werden nun zwei neue Verzeichnisse angelegt:
  1. my_patches: hierher kommt dann später patch_my_layout.css, in der die angepassten Anweisungen für den Internet Explorer hinterlegt sind.
  2. screen: in diesem Verzeichnis werden die CSS Dateien abgelegt, die das Aussehen der Website festlegen - basemod.css & content.css. Als content.css kann ruhig erstmal die content_default.css verwendet werden, welche sich in yaml/screen findet. Sie kann ja dann ganz leicht an die eigenen Bedürfnisse angepasst werden.

Die my_layout.css muss direkt in inc_css abgelegt werden.

Wenn alle Dateien wie hier beschrieben abgelegt wurden, ist eine Nachbearbeitung der Pfadangaben in my_layout.css nicht erforderlich.

Damit ist der erste Teil auch schon abgeschlossen!

2
Erstellen der Vorlage!

Als erstes muss nun das Seitenlayout eingerichtet werden:

Zwingend dabei ist eigentlich nur, das unter dem Punkt Seitenaufbau: die Option Eigener (aus Vorlage Haupt-Block)gewählt wird.

Soll ein Layout mit TEASER (ich beziehe mich hier auf die von YAML:Builder angebotenen 2 bzw. 3 spaltigen Layouts mit TEASER Block) eingerichtet werden, ist es u.U. sinvoll einen solchen Block auch hier anzulegen, damit die Inhalte dieses Blockes später über die Artikelzentrale eingepflegt werden können.

Danach geht es jetzt direkt mit den Vorlagen weiter:

Hier wird nun als erstes die my_layout.css ausgewählt.

In den HTML Kopf: <head> gehören die Anweisungen, die die Dateien laden, welche das Layout für den Internet Explorer korrigieren.

Beispiel:

<!--[if lte IE 7]>  
<link href="template/inc_css/patches/patch_my_layout.css" rel="stylesheet" type="text/css" />  
<![endif]-->

 

Und nun wird der ganze (X)HTML-Code aus der markup_draft.html (oder besser noch den von YAML:Builder generierten) der sich zwischen den <body></body> Tags findet, einfach in den Haupt: Bereich der Vorlage hineinkopiert.

Jetzt müssen nur noch die Platzhalter von phpWCMS in die richtigen Container gelegt werden, und schon ist die Vorlage fertig!

Beispiel:

<div id="col1">
  <div id="col1_content" class="clearfix">
    { LEFT }
  </div>
</div>
<div id="col2">
  <div id="col2_content" class="clearfix">
    { RIGHT }
  </div>
</div>
<div id="col3">
  <div id="col3_content" class="clearfix">
    { CONTENT }
  </div>
</div>
3
Die Arbeit erleichtern!

Eine sehr einfache Möglichkeit der Arbeitserleichterung bietet sich durch die Anpassung des WYSIWYG-Editors FCKeditor an die Bedürfnisse von YAML:

Um diese auch nutzen zu künnen, muss im Profil unter dem Punkt WYSIWYG editor folgendes ausgewählt sein:
- FCKeditor (IE/Gecko)
- FCKeditor: Default

Jetzt stehen alle Funktionen des Editors zur Verfügung, vor allem auch die Funktion Vorlagen ().

Diese können in der Datei: include/inc_ext/fckeditor/fcktemplates.xml an die eigenen Bedürfnisse angepasst werden.

Der Einfachheit halber, habe ich alle Subtemplates des YAML:Builder in den Vorlagen hinterlegt, so dass diese auf Knopfdruck bereitstehen.

Achtung: standardmäßig ist hier die Option "Aktuellen Inhalt ersetzen" vorausgewählt. Wenn man da nicht aufpasst, kann das zu wirklich ärgerlichen Erlebnissen führen!

 

fckeditor.zip


Hier die modifizierten Dateien um den FCKeditor für die Arbeit mit YAML zu optimieren zum Download - einfach in das Verzeichnis include/inc_ext entpacken!

zip, 8.9 KB, 19.07.08, 213 downloads

Diese Seite bookmarken:

Wong It! DiggIt! Furl It Spurl! TechnoratiFaves Del.icio.us Save to Yahoo! My Web Google Bookmark Ma.gnolia Newsvine Reddit Diese Nachricht bei Webnews einstellen Wikio YiGG it Share on Facebook folk it! oneview - das merk ich mir!

Kommentare:

Für Kritik, Fragen und Anregungen bin ich dankbar!









Captcha


Mit * gekennzeichnete Angaben sind obligatorisch!


Eintrag #1 vom 03.02.2009 - 12:57
Jochen Kubik — (jochen.kubik (at) googlemail (dot) com)

Hi,
ich stecke ein wenig an Punkt 3 fest:
- Wenn ich eine Vorlage einfüge sehe ich z.B.nur:

Left side (50%) / Linke Seite (50%)
Right side (50%) / Rechte Seite (50%)

Wo wird hier der Inhalt eingetragen?
Sorry, blick es gerade nicht!

Dann ist alles richtig! Einfach den Text markieren und überschreiben. Das Resultat kannst Du dann im Frontend bewundern! - Schau Dir den "Quellcode" an (2. links neben den Vorlagen), dann sollte alles verständlich sein.