Trotzdem wollte ich Euch mal darauf aufmerksam machen, dass hier eine fleißige TYPo3 Programmiererin aus Berlin viele Stunden investiert.

Wenn Ihr mich also unterstützen wollt, stimmt doch bei der Wahl des TYPO3 Blog des Jahres für mich:
Wahl zum TYPO3 Blog 2008

Oder bewertet meine Firma bei Google freundlich:
TYPO3 ^{+ me}

Oder hinterlasst mir einfach auf dieser Seite unten einen lieben Kommentar.

Alles Liebe von Lina - Eurer leidenschaftlichen TYPO3 Programmiererin

Das Styling des tt_news Kategoriemenüs plugin.tt_news.displayCatMenu statt.

Bevor man ans Styling des CATMENU geht sollte man erst noch die richtige pid für das CATMENU einstellen, damit die Links des CATMENU auf die richtige Seite verweisen:

plugin.tt_news.catSelectorTargetPid = 1

Folgende Einstellungen fand ich sinnvoll:

Das CATMENU von tt_news komplett wrappen

Das CATMENU von tt_news wrappen ist häufig sinnvoll, zum Beispiel um das Kategoriemenü per CSS zu stylen oder um es als eine Liste darzustellen. Dies geschieht über die Einstellung von catmenu_stdWrap.
Beispiel für das wrappen des CATMENU von tt_news in TYPO3 (TypoScript ins Setup):

plugin.tt_news.displayCatMenu.catmenu_stdWrap.wrap = <ul>|</ul>

Den Header des CATMENU, “Select a category” ausblenden / entfernen

Häufig möchte man das CATMENU als reines Menü der Kategorien aus TYPO3 nutzen. Da kann es sinnvoll sein, den Header mit Link auf die Artikelseite auszublenden.
So kann man den Header des CATMENU entfernen:

#den CATMENU HEader mit leerem TEXT-Object überschreiben
plugin.tt_news.displayCatMenu. catmenuHeader_stdWrap.cObject = TEXT

Den Text im Header ändern

Möchte man den Header der tt_news Kategorienanzeige doch verwenden, so kann man den TEXT - auch lokalisiert für verschiedene Sprachversionen - ändern. Achtung! dies geschieht außerhalb von displayCatMenu!

plugin.tt_news. _LOCAL_LANG.default.catmenuHeader = alle Kategorien

Die Menüpunkte der Kategorien im tt_news Menü einzeln wrappen

Es ist auch möglich, die Menüpunkte des CATMENU einzeln zu wrappen und zwar abhängig davon, ob die Kategorie grade aktivist oder nicht:
Beispiel für das wrappen der Menüpunkte des CATMENU:

plugin.tt_news.displayCatMenu{
    catmenuItem_NO_stdWrap.wrap = <li>|</li>
    catmenuItem_ACT_stdWrap.wrap = <li class="act">|</li>
}

Das Bild / Symbol vor den Kategorien im CATMENU ändern oder löschen

Es ist möglich, das automatisch erscheinende Bild vor den einzelnen CATMENU Menüeinträgen zu ändern, zu entfernen, in der Größe anzupassen oder zu entfernen:

plugin.tt_news.displayCatMenu{
  catmenuIconMode = 2 # 0= Standartbild; 1= Bild aus Record; 2=Pfeilsymbol; -1=kein Bild
  catmenuIconFile {
     width = 100
     height = 65
  }
}

Viel Spass beim Konfigurieren des CATMENU von tt_news. Die Möglichkeiten sind vielfältig.

Diskusionen und Hilfen zum Thema CATMENU stylen

• CATMENU im tt_news Handbuch (engl)
• Diskusion im typo3forum: “Select a category:” Link aus CATMENU entfernen?
• Diskusion auf TYPO3 Jack: tt_news catmenu verändert andere tt_news Objekte
• Diskusion im Mittwald ForumCATMENU - Template?

Bei der Kombination der beiden TYPO3 Extensions tt_news und RealURL (zur statischen Pfadsimmulation) besteht das Problem, dass die TYPo3 News Extension tt_news eine ganze Reihe von Parametern fordert. Da die Extension zur Erzeugung menschenlesbarer Benutzer- und Suchmaschinenfreundlicher Pfade, RealURL, nun aber leider jeden Parameter in ein bis zwei Pfadsegmente umsetzt entstehen schnell sehr lange Pfade die auch nicht grade menschenlesbarer sind. Beispiel: http://www.beispiel.com/news/news/article/196/ende-der-dur.html

Lösungsversuche verschiedener TYPo3 Programmierer

Viele TYPO3 Programmierer haben versucht diesen Pfad zu verkuerzen oder zumindest Teile des Pfades umzubennen. Grade hinsichtlich von Suchmaschinenoptimierung ist nciht nur die Länge des Pfades schädlich, nein es kommt hinzu, dass auch noch verschiedene Pfade zur selben News Singleansicht führen je nach übergebenen Parametern. Dadurch erzeugt aber tt_news in Kombination mit RealURL bei Google Doppelte Pfade.

Georg Ringers Lösung des RealURL Pfadproblems in TYPO3

Georg Ringer, der von mir hochgeschätzte TYPO3 Programmierer und Extensionentwickler aus Österreich hat nun eine geniale Lösung zum Problem der Verwendung von RealURL und tt_news: Kombination tt_news, realUrl & TS Leider sind die genialen Inhalte in eine viel zu kleine Seite gequetscht. Es hilft eigentlich nur das CSS von Georgs der Seite abzuschalten oder einfach die Inhalte rauszukopieren.

3 Schritte zum Pfade Glück bei tt_news

Im Grunde genommen sind nach Georg Ringers Methode der Kombination von RealURL und tt_news 3 Schritte notwendig.

1. BackPid per TypoScript abschalten

Die Übertragung der Backpid, also der Seiten ID welche beim Klicken auf “zurück zur Newsliste” angezeigt werden soll, unterdrücken. Das macht den Pfad sofort kürzer:

plugin.tt_news {
  dontUseBackPid = 1
}

BackPid und ArchivePid per TypoScript Konstante definieren.

Die tt_news BackPid kann entweder über den Konstanten Editor des TYPO3 Templates oder über eine textuelle Eingabe im Konstantenteil geschehen:

  plugin.tt_news.archiveTypoLink.parameter = 5
  plugin.tt_news.backPid = 1

Die RealUrl Konfiguration anpassen

Nun muss noch so wie auf der Webseite von Georg Ringer beschrieben die RealUrl Konfiguration für den Betrieb mit Suchmaschinen- und Menschenfreundlichen URL’s angepasst werden. Dies geschieht entweder über die RealURL Konfiguration in der localconf.php oder über die spezielle RealURL Konfigurationsdatei. Diese Datei zur Anpassung von RealURL heißt bei mir meistens realurl_conf.php und liegt im Ordner typo3conf.

Bei den fixedPostVars muss nun folgendes hinzugefügt werden:

//....
    'fixedPostVars' => array(
      'news' => array(
        array(
          'GETvar' => 'tx_ttnews[pointer]‘,
          ‘valueMap’ => array(),
          ‘noMatch’ => ‘bypass’,
        ),
        array(
          ‘GETvar’ => ‘tx_ttnews[tt_news]‘,
          ‘lookUpTable’ => array(
            ‘table’ => ‘tt_news’,
            ‘id_field’ => ‘uid’,
            ‘alias_field’ => ‘title’,
            ‘addWhereClause’ => ‘ AND NOT deleted’,
            ‘useUniqueCache’ => 1,
            ‘useUniqueCache_conf’ => array(
              ’strtolower’ => 1,
              ’spaceCharacter’ => ‘-’,
            ),
            ‘languageGetVar’ => ‘L’,
            ‘languageExceptionUids’ => ”,
            ‘languageField’ => ’sys_language_uid’,
            ‘transOrigPointerField’ => ‘l18n_parent’,
            ‘autoUpdate’ => 1,
            ‘expireDays’ => 180,
          ),
        ),
      ),

    ),

//….

Zusätzlich müssen ncoh folgende Zeilen in die RealURL Konfigurationsdatei eingefügt werden:

// RealURL - valueMap Ertzeugung für tt-news
for($x=1; $x<=100; $x++) {
$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT']['fixedPostVars']['news'][0]['valueMap'][$x+1] = $x;
}

// Definiert, dass die Singleanzeige der News sich auf Seite 82 befindet
$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT']['fixedPostVars']['82'] = ‘news’;

Der Code stammt von Georg Ringer.

Hier kann man meine eigene RealURL Konfiguration herunterladen:
RealURL Konfiguration für tt_news

Nach Pfadumstellung werden die tt_news Pfade als Parameter dargestellt?

Folgende Fehlerquellen können dafür sorgen, dass die Pfade als Parameter (http://example-blog.net/blog.html?tx_ttnews[tt_news]=1&tx_ttnews[backPid]=3&cHash=2268a0dba9) und nicht als schöner, statischer Pfad (http://example-blog.net/blog/typo3-blog-mit-extension-timtab-erstellen.html) dargestellt werden:

• Die realurl_conf.php wird von RealURL nicht gefunden: In den Extension Manager gehen, Real URL heraussuchen (eventuell muss man schüchterne “Shy” extensions anzeigen lassen) und dann den Pfad zur richtigen Konfigurationsdatei “Path to configuration file” eingeben. Notfalls Konfiguration in localkonfig.php übernehmen.
• RealURL ist nicht angeschaltet (werden die anderen Pfade alle umgesetzt)
• Bei
  $TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT']['fixedPostVars']['2'] = ‘news’; wurde nicht die richtige pageid für die singleseite angegeben.

Zunächst einmal ist wichtig, das auf dem Server oder Hosting TYPO3 überhaupt lauffähig ist. Dazu müssen auf dem Hosting eine aktuelle PHP Version und eine freie MYSQL Datenbank vorhanden sein.

Die maximale Skriptlaufzeit von PHP sollte zur TYPO3 Installation mindestens 30 Sekunden betragen. Möchte man später mit TYPO3 auch größere Dateien (Bilder, gespeicherte Projekte) etc bearbeiten sollte die maximale Skriptlaufzeit höher, idealerweise bei 120 Sekunden liegen.

Es sind momentan mindestens 32 MB Hauptspeicher - besser 64 MB erforderlich.

Möchte man RealURL, CoolURi oder Simmulate Statics verwenden ist ModRewrite wichtig.

Es ist wichtig, dass auf Linux Systemen der PHP Benutzer, der Dateien erstellt und der FTP Benutzer entweder identisch sind oder zumindestens der selben Linux Benutzergruppe angehören. Sonst kann es passieren, dass TYPO3 bei der Installation Dateien für Exensions, Cache etc erstellt die man selbst per FTP nicht löschen kann! In diesem Fall muss man in der Localkonfig oder im Installtool angeben, dass neue Dateien immer mit dem Recht 777 erstellt werden, was ein Sicherheitsrisiko darstellt. Dieses kann man einstellen, in dem man in der localconf.php im Ordner typo3conf folgende Zeilen hinzufügt:

$TYPO3_CONF_VARS['BE']['fileCreateMask'] = ‘0777′;
$TYPO3_CONF_VARS['BE']['folderCreateMask'] = ‘0777′;

Achtung es handelt sich um ein Sicherheitsrisiko. Die Einstellung muss vor der TYSPO3 Installation erfolgen. Sonst hat TYPO3 schon durch den FTP Benutzer unveränderliche Dateien erzeugt.

Wichtig ist auch ein gutes Serverbackup. Es sollte mindestens einmal täglich ein automatisches Backup geschehen und die Backups mindestens zwei Wochen aufgehoben werden. Sonst kann es passieren, das man zu spät merkt, dass man gehackt wurde. Die eigenen Daten wären in einem solchen Fall verloren.

Für mehr Sicherheit ist es sinnvoll wenn https zumindest fpür das TYPO3 Backend eingesetzt werden kann.

Um einen Blog in TYPO3 zu erstellen installiert man zunächst die TYPO3 Extensions tt_news (für die Artikel) und Modern Guestbook (ve_guestbook, für die Kommentare) und dann die TYPO3 Blog Extension “TIMTAB Weblog”.

Die schnellste Methode nun einen TYPO3 Blog zu Erstellen ist mein kostenloses TYPO3 Blog Template zu nutzen.

Um den TYPO3 Blog zum Laufen zu bringen einfach in einer neuen TYPO3 Installation nach Installtion von tt_news, ve_guestbook und timtab auf die Weltkugel neben “New TYPO3 site” klicken.

Im Menü der TYPO3 Rootseite “Import from .t3d” / “Importieren aus .t3d” Dann auf dem Reiter “Upload” / “Hochladen” klicken und die Datei typo3-blog.t3d hochladen. Im Reiter Import alle UID-Werte erzwingen (ist unproblematisch bei einem leeren TYPO3) und auf importieren klicken und sich freuen…

So fügt man News zum TYPO3 Blog hinzu

Einfach in Seite 6, Blog Posts, in der Listenansich einen neuen Datensatz erstellen (Symbol mit grünem Pluszeichen) eine neue News vom Typ tt_news erstellen. Unter Typ “Blog Post” auswählen und News wie gewohnt erstellen. Achtung neu erstellte News sind standartmässig versteckt!

Der lange Weg zum TYPO3 Blog

Mehr lernen tut man natürlich, wenn man die Schritte zum TYPO3 Blog einzeln vornimmt. Dazu erzeugt man zunächst ein Menü wie links im Bild dargestellt. Seiten 1 bis 5 sind vom Seitentyp Standart, 6 ist ein Backend Benutzerbereich und 7 bis 9 sind Sysordner.

Dann erzeugt man auf Seite 1 ein neues Roottemplate. In der Template Ansicht Info/Modify klickt man unter dem Kasten auf “Click here to edit whole template record” und wählt im Reiter “enthält” im Kasten “Einzubindende statische Template-Dateien Statische einschließen (aus Erweiterungen)” folgende TYP03 Extension Templates aus:

1. CSS Styled Content (css_styled_content)
2. CSS-based tmpl (tt_news)
3. News-feed (RSS,RDF,ATOM) (tt_news)
4. Blog Webservices (timtab)
5. Kubrick (default weblog template) (timtab)

Wichtig! Die Templates müssen genau in dieser Reihenfolge eingebunden werden.

Dann muss man noch den Standart “Hello World” eintrag entfernen, den TYPO3 beim Neuerstellen eines Root-Templates automatisch anlegt. Sonst zeigt die Seite nur “Hello World” an.
Auf Seite 2 müssen nun noch zwei Front-End Plugins vom typ Modern Guestbook angelegt werden.
Bei dem ersten Modern Guestbook Plugin unter “Plugin” im Reiter “Allgemein” unter “Was soll angezeigt werden?” “LIST auswählen. Als Ausgangspunkt den “Comments” Sysordner auswählen. Bei dem zweiten Modern Guestbook Plugin “FORM” auswählen aber denselben Ausgangspunkt angeben.

Dann müssen im Template auf der Rootseite (1) noch die Konstanten anpassen. Dies geht am besten in der Ansicht “Konstanten Editor”.

Bei timtab müssen folgende Konstanten gesetzt werden:
pid to store posts in: 6
pid to store comments in: 7
Blog pid: 2
Home pid: 1
Blog homepage: http://www.example.com

oder auch in der Text-Ansicht der Konstanten in dem man ffolgendes hinzufügt:
plugin.tx_timtab_pi2.pidStorePosts = 6
plugin.tx_timtab_pi2.pidStoreComments = 7
plugin.tx_timtab.homepage = http://neu.typo3-blog.net
plugin.tx_timtab.blogPid = 2
plugin.tx_timtab.homePid = 1

Bei tt_news müssen noch folgende Konstanten gesetzt werden:
backPid: 1
pid_list: 6
Als Text für den Konstanten Bereich:
plugin.tt_news.pid_list = 6
plugin.tt_news.backPid = 1

Damit der Blogroll des TYPO3 Blogs funktioniert muss noch
plugin.tx_timtab_pi1.pid_list = 8
gesetzt werden

Um einen RSS Feed in TYPO3 mit Hilfe von tt_news einzurichten muss man jedoch einige Schritte beachten:

Das Template des RSS-Feeds von tt_news einbinden

In dem Template der Seite das ganze Template bearbeiten (”Click here to edit whole template record”) und dann unter Tab “Enthält” des Templates “News-feed (RSS,RDF,ATOM) (tt_news)” zur Liste der “Einzubindende statische Template-Dateien (aus Erweiterungen)” hinzufügen.

Das ganze TYPO3 Template bearbeiten.

RSS Template einbinden.

Folgende Fehlermeldungen erscheinen bei nicht eingebundenem RSS Template:

Hat man das Template des RSS Feeds nicht eingebunden wird eine leere XML Datei erzeugt und im Firefox kommt folgende Meldung: “XML-Verarbeitungsfehler: Kein Element gefunden
” Der Internetexplorer meldet: “Die XML-Seite kann nicht angezeigt werden
” und “Ein XML-Dokument muss ein Element der obersten Ebene enthalten. Fehler beim Bearbeiten der Ressource [..]” Lösung: das Template korrekt einbinden.

Die RSS-Feed Seite erzeugen

Dann erzeugt man eine Seite für den RSS Feed. möchte man das diese Seite nicht im Menü erscheint, so wählt man “nicht im Menü” aus. So oder so soll es sich aber um eine normale Seite (keinen Sysordner) handeln.

Dieser Seite fügt man folgendes TypoScriptTemplate hinzu:

page >

page = PAGE
page {
  10 >
  10 < plugin.tt_news
  10.pid_list >
  #Seite, die die tt_news Records enthält. Mehrere durch komma trennen.
  10.pid_list = 46
  #Seite die zur Anzeige der News im RSS Feed genutzt werden soll
  10.singlePid = 49
  10.defaultCode = XML
  config {
    disableAllHeaderCode = 1
    additionalHeaders = Content-type:text/xml
    no_cache = 1
    xhtml_cleaning = 0
  }
}

Linkbeziehung auf RSS Feed per TypoScript setzen

Nun muss der RSS-Feed nur noch per <link> Tag in den HTML-Header der Seite eingebunden werden:

page.headerData.500 = TEXT
page.headerData.500 {
  typolink{
    #uid der Seite, die als RSS-Feed funktionieren soll.
    parameter = 44
    returnLast= url
  }
  wrap = <link rel="alternate" type="application/rss+xml" title="RSS-Feed" href="http://beispiel.com/|" //gt;
}

RSS-Feed von tt_news per TypoScript in den Template Konstanten konfigurieren

plugin.tt_news.displayXML {
  xmlTitle = RSS Titel für tt_news wir hier gesetzt.
  xmlLink = http://beispiel.com
  xmlDesc = Hier muss der RSS-Feed beschrieben werden
  xmlLang = de
}

In der Regel wird tt_news als Plugin und Seiteninhalt eingebunden. Dabei fügt man in der Seitenansicht des TYPO3 Backends einfach ein neues Plugin vom Typ tt_news hinzu. Möchte man jedoch, dass die News aus der TYPO3 Extension tt_news auf jeder Seite der Website erscheinen ist dieser Weg zum Teil nicht hilfreich.

Es gibt zwei Wege, dieses Problem zu lösen. Man kann entweder das News Plugin auf einer Seite außerhalb des Menüs erzeugen und extern einbinden oder tt_news direkt per TypoScript einbinden und konfigurieren.

tt_news per TypoScript einbinden und konfigurieren

Wenn wir davon ausgehen, dass page.15 die Linke Spalte im TYPO3 Frontend repräsentiert und diese linke Spalte die 3 aktuellsten News aus tt_news enthalten soll, dann kann man das auf folgernde Weise in TypoScript konfigurieren:

  page. 15 < plugin.tt_news
  page. 15 {
        #Wenn Sie kein eigenes Template für Ihre Newsliste wollen können Sie dies weglassen
	templateFile = fileadmin/news_startseite_latest.html
	pid_list >
        #Seite, die die tt_news records enthält
	pid_list = 460
	code >
	code = LATEST
        #Seite auf der die Einzelnews angezeigt werden sollen
	singlePid = 492
        #Seite auf der auf die komplette Liste der News  zugegriffen werden soll.
	archiveTypoLink.parameter = 460
 }

tt_news Plugin (durch den Redakteur konfigurierbar) einbinden

Die andere Möglichkeit ist eine Seite anzulegen, die im Menü nicht ereichbar ist und auf dieser Seite ganz normal ein durch die Redakteure konfigurierbares tt_news Plugin als Inhaltselement anzulegen. Dieses kann dann über den folgenden Code per TypoScript eingebunden werden:
page. 15 = CONTENT
page. 15 {
table = tt_content
select {
#uid der Seite, die das tt_news Plugin enthält
pidInList = 14
orderBy = sorting
#Spalte von oben genanter Seite
#0 is Spalte “normal”; 1 = links, 2=rechts, 3=rand
where = colPos= 0
}
}
Diese Möglichkeit ist zu bevorzugen wenn es Redakteure gibt die an dem tt_news Inhaltselement Änderungen vornehmen können sollen. Außerdem können auf diesem Weg auch zusätzliche Elemente in die Linke Spalte des TYPO3 Frontends eingefügt werden z.B ein Text über der Newsanzeige.

Die TYPO3 Podcasts können hier abonniert werden: Kaspars TYPO3 Podcasts.

In der Regel drehen sich Kasper Skårhøjs TYPO3 Podcasts um eines der folgenden drei Themen:

• TYPO3 Technologien und TYPO3 Extensions
• Die TYPO3 Community
• Das private Leben von TYPO3 Gründer Kasper Skårhøj

Jedoch ist die Produktion der TYPO3 Podcasts Zeit- und Materialaufwendig. Daher sucht Kasper Skårhøj dringend Sponsoren für seine 14 tägigen TYPO3 Podcasts. Die Produktion einer Episode der TYPO3 Videos kostet 600€. Der Sponsor erhält 5 Sekunden Video oder Standbild am Anfang des TYPO3 Videos und wird auch auf der Webseite namentlich genannt.

Jede Video Episode wird zur Zeit durchschnittlich 5000 mal von der TYPO3 Webseite heruntergeladen.

Das TYPO3 Podcast Programm zu sponsoren ist ein guter Weg, Kasper Skårhøj in seinem Leben nach TYPO3 zu unterstützen und ist auch eine gute Werbemöglichkeit.

Wer am TYPO3 Video Sponsoring Interesse hat sollte sich an info(at)typo3.org wenden.

Verwendet man die TYPO3 Extension CSS-Styled-Content zu CSS basierten Anzeige des Inhalts ist die Lösung für dieses Problem recht einfach. Dem Typoscript der Seite mus folgende Zeile hinzugefügt werden um die Unterleilung der Bildunterschriften, Alttags und Titletags zu aktivieren:

styles.content.imgtext.imageTextSplit = 1

Dann müssen die Texte für die Bilder zeilenweise geschrieben werden. Also Bildunterschrift, Alttag und Titletag für Bild 1 in Zeile 1, Bild 2 in Zeile 2 etc.

Möchte bzw kann man die TYPO3 Extension CSS-Styled-Content nicht nutzen so sind eineige Anpassungen notwendig: Unterteilte Bildunterschriften mit TYPO3 Version 4 nutzen.

In der komplizierten Variante werden die Modifikationen des TYPO3 Backends in einer eigenen TYPO3 Extension gekapselt, in der Quick & Dirty Methode der TYPO3 Backend Modifizierung werden die Änderungen Am TCA Array in der Datei typo3conf/extTables.php vorgenommen. Wenn diese Datei nicht vorhanden ist kann man Sie einfach erzeugen. Eine leere PHP Datei reicht völlig.

Eingebunden wird die extTables.php über folgende Codezeile in der typo3conf/localconf.php:

$typo_db_extTableDef_script = "extTables.php";

Die Standartbildpositionen sind einfach von 0 bis 10 durchnummeriert. Um das TYPO3 Backend durch Ausblenden von möglichen Bildpositionen zu personalisieren reicht es aus folgenden Code in die extTables.php zu übernehmen:

$TCA['tt_content']['columns']['imageorient']['config']['items']['9'] = ”;
//Blendet Bildposition “linke Spalte” im TYPO3 Backend aus

Auf demselben Weg kann man auch eine andere Standardbildposition angeben:

$TCA['tt_content']['columns']['imageorient']['config']['default'] = 3;
//Bildposition “unten mitte” als Standard Bildposition