t3blog - die neue Blog-Extension für TYPO3

CoolURI
#Keine Umschreibung, wenn Blog-Element
[userFunc = user_isBlog()]
config.tx_cooluri_enable = 0
[end]

Diese Funktion ruft die Methode user_isBlog auf. Gibt die true zurück, dann wird die URL-Umschreibung ausgeschaltet. Die entsprechende Methode in der Datei localconf.php sieht so aus:

//UserFunc um zu überprüfen, ob sich auf der Seite ein Kalender befindet
function user_isBlog() {
    $id = $GLOBALS['TSFE']->page['uid'];
    $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
    '*',
    'tt_content',
    'pid='.$id.' AND list_type = "t3blog_pi2"',
    '',
    '',
    '');
    $num = mysql_num_rows($res);
    if($num > 0) {   
        return true;
    } else {
        return false;
    }
}

Kommentar E-Mails:

Damit jeder Benutzer hier eine eigene Adresse eintragen kann, müssen wir das Flexform für die Widget-Auswahl erweitern. Dies geschieht in der Datei flexform_pi2.xml im Extension-Verzeichnis. Nach der Beschreibung des <storagePid> Feldes fügen wir folgenden Code ein:

    <commentEmail>
        <TCEforms>
            <exclude>1</exclude>
            <label>LLL:EXT:t3blog/pi2/locallang.xml:pi_flexform.commentEmail</label>
            <config>
                <type>input</type>
                <size>50</size>
            </config>
        </TCEforms>
    </commentEmail>

In der referenzierten locallang.xml Datei muss der gewünschte Text eingetragen werden:

    <label index=“pi_flexform.commentEmail“>E-Mail Adresse des Blog-Verantwortlichen (Bei Blog list- und RSS-Widget eintragen):</label>

Damit kann der Benutzer jetzt eine E-Mail Adresse angeben. Damit die dort eingegebene Adresse vom Blog bei Kommentaren auch verwendet wird, müssen wir Änderungen im Code vornehmen:

In der Datei pi2/class.tx_t3blog_pi2.php fügen wir in der init-Methode nach Zeile 75 ein:

$this->internal[‚commentEmail‘] = this->pi_getFFvalue($this->cObj->data[‘pi_flexform’], ‘commentEmail’, ‘sDEF’)

Anschließend schreiben wir so ermittelte Adresse in der main-Methode nach Zeile 54 in das globale Array. Dazu rufen wir eine Methode aus der Library auf:

    t3blog_div::setCommentEmail($this->internal[‚commentEmail‘]);

In der Datei pi1/lib/class.t3blog_div.php müssen wir die Methode natürlich implementieren. Zusätzlich implementieren wir eine Methode, die die E-Mail Adresse zurückgibt und von außen aufgerufen werden darf.

    function setCommentEmail($mail) {
        if($mail == „“) {
$GLOBALS[‚commentEmail‘] = “root”
        } else {
$GLOBALS[‚commentEmail‘] = $mail;
        }
    }

    function getCommentEmail() {
        return $GLOBALS[‚commentEmail‘];
    }

Zum Schluß ist dann im blogList-Widget die Datei class.singleFunctions.php zu ändern. In der Methode adminMailComment() ab Zeile 830 lesen wir die entsprechende Variable aus und fügen die E-Mail_Adresse als Zieladresse in den Aufruf der plainMailEncoded Methode ein.

    $mailTo = t3blog_div::getCommentEmail();

RSS-Feeds:

Damit der RSS-Feed funktioniert, sind ein paar Einstellungen nötig. RSS-Feeds werden über den speziellen Seitentyp 100 gekennzeichnet. Dieser muss definiert werden, dies geschieht im TS-Setup des Root-Templates:

#Definition des Seitentypes 100 um RSS-Feeds in Blogs anzuzeigen
xmlnews = PAGE
xmlnews {
        typeNum = 100
        config {
                disableAllHeaderCode = 1
                additionalHeaders = Content-type:text/xml
                linkVars = L
                no_cache = 1
               xhtml_cleaning = 0
               admPanel = 0
        }
        10 = USER
        10 {
                # Call the user function
                userFunc = tx_t3blog_pi1->main
                widget.rss < plugin.tx_t3blog_pi1.rss
          # Load "design" of the RSS-stuff
                # Attention! This will only work, when you are
                # using the static template "T3BLOG Layout".
                # The static template has included the full design of
                # a blog (position of widgets and much more)t
               
                template =< plugin.tx_t3blog_pi1.layoutBlog.40.80
        }
}

Weiterhin setzen wir im TS-Setup noch die folgenden Einstellungen:

#t3Blog: RSS Feed
plugin.tx_t3blog_pi1 {
  rss {
    postItemCount = 10
    feedCopyright = 2009 Universität Konstanz
    feedWebMaster = typo3@uni-konstanz.de
  }
}
plugin.tx_t3blog_pi2 {
  rss {
    _LOCAL_LANG.de.rss_click_here = Feeds!
  }
}

Der erste Block (pi1) setzt die Anzahl der Beiträge im Feed auf 10 und definiert einige Metadaten, die für alle Feeds im System gelten. Weitere Metadaten werden in einem separaten Unterkapitel behandelt. Der zweite Block (pi2) ändert die Überschrift im Frontend für die Feeds in der deutschen Sprachdatei.

Nur eigener Blog:

In der Methode getContentResult fügen wir ab Zeile 200 ein:

//Nur Beiträge/Comments aus dem zugehörigen Blog-Folder
$pid = t3blog_div::getBlogPid();

Und erweitern die where-Klausel für die Datenbankabfrage um die Abfrage der PID:

$where = ‚WHERE ‘.$table.‘deleted = 0 AND ‘.$table.’.hidden = 0 AND ‘.$table.’.pid = ‘.$pid;

Full-Feed statt Short-Feed:

Um den Benutzern einen Full-Feed anzubieten, der die kompletten Inhalte ausliefert, ist ebenfalls eine Änderung im Code notwendig. In der Methode make_xml erweitern wir in Zeile 137 & 147 den Methoden Aufruft setRecFields um den Parameter text.

    $xmlObj->setRecField(‚tx_t3blog_com‘, ‚title,author,uid,fk_post,date,text‘);

Der ausgelesene Text muss aber noch gerendert werden, ansonsten ist er unformatiert und ohne Zeilenumbrüche. Zu diesem Zweck ändert man die Abfrage der Datenbank in Zeile 227. Die SELECT-Klausel lautet neu:

    $select .= ‚, tt-content.uid AS text ‚;

Anstatt also über eine CONCAT-SQL-Funktion den Text direkt auszulesen, lassen wir nur die ID des Content Elements ausgeben.

Im weiteren Verlauf ändert man in der der fieldWrap – Methoden den case ‚text‘: Anstatt des Textes bekommen wir hier die ID übergeben und rendern das Content Element mit den folgenden zwei Zeilen manuell:

$getBodytext = array(‚tables‘ => ‚tt_content‘, ‚source‘ => $value, ‚dontCheckPid‘ => 1);
$this->item = $this->cObj->RECORDS($getBodytext);

Das ist natürlich nicht 100% sauber, da man auch einen eigenen case-Fall dafür bauen könnte.

Link-Generierung:

//Temporäre Generierung der Link-URL
$linkTempGen =
''.(stripos('http://',t3lib_div::getIndpEnv('HTTP_HOST'))?'':'http://').t3lib_div::getIndpEnv('HTTP_HOST').'/'.tslib_pibase::pi_getPageLink(t3blog_div::getBlogPid(), '', array('no_cache' => 1, 'tx_t3blog_pi1[blogList][year]' => $year, 'tx_t3blog_pi1[blogList][month]' => $month, 'tx_t3blog_pi1[blogList][day]' => $day, 'tx_t3blog_pi1[blogList][showUid]' => $this->conf['feedItemLinkPrefix'].$postid)).'';
$linkTempGen = str_replace("&","&#38;",$linkTempGen);
return '<link>'.$linkTempGen.'</link><guid>'.$linkTempGen.'</guid>';

Feed-Metadaten:

Damit der Benutzer von TypoScript verschont bleibt, ist es notwendig die FlexForm Variablen auch in den Widgets verfügbar zu machen. Dazu ist eine Methode nötig, die die FlexForm Daten manuell aus der Datenbank holt und zur Verfügung stellt. Diese Methode wird als eigene Funktion implementiert:

    function getFlexform($value) {
        //Seiten ID
        $id = intval(t3lib_div::GP(‚id‘);
        //RSS Widget ist Nummer 7
        $like = “’%<value index=\”vDEF\”>7</value>%’”;
        //Flexform Daten besorgen
        $sql = $GLOBALS[‘TYPO3_DB’]->exec_SELECTquery (
            ‚pi_flexform‘,
            ‚tt_content‘,
            ‚pid = ‚.$id.‘ AND pi_flexform LIKE ‚.$like,
            ‘’,
            ‘’,
            ‘’
        );
        $row = $GLOBALS[‘TYPO3_DB’]->sql_fetch_assoc($sql);
        //Flexform-XML in Array umwandeln
        $flex = t3lib_div::xml2array($row[‘pi_flexform’]);
        Return $this->pi_getFFvalue($flex, $value, ‘sDEF’);


Der Zugriff und die Zuweisung zu den einzelnen Feldern erfolgt dann im Kopf der renderHeader-Methode mit den folgenden Aufrufen:

    $this->conf[‚feedManagingEditor‘] = $this->getFlexform(„commentEmail“);
    $this->conf[‚feedDescription‘] = $this->getFlexform(„feedDescription“);
    $this->conf[‚feedTitle‘] = $this->getFlexform(„feedTitle“);


Wichtig ist dabei, dass der der Methode getFlexform übergebene Wert dem Wert entspricht, der auch in der flexform_pi2.xml so definiert ist. Die E-Mail Adresse wurde bereits für Kommentar-Emails definiert, die anderen Einstellungen müssen wir noch festlegen. Dies geschieht nach dem Block commentEmail.

    <feedTitle>
        <TCEforms>
            <exclude>1</exclude>
            <label>LLL:EXT:t3blog/pi2/locallang.xml:pi_flexform.feedTitle</label>
            <config>
                <type>input</type>
                <size>50</size>
            </config>
        </TCEforms>
    </feedTitle>
    <feedDescription>
        <TCEforms>
            <exclude>1</exclude>
            <label>LLL:EXT:t3blog/pi2/locallang.xml:pi_flexform.feedDescription</label>
            <config>
                <type>input</type>
                <size>50</size>
            </config>
        </TCEforms>
    </feedDescription>

In der verlinkten locallang-Datei müssen noch die Beschriftungen eingetragen werden.

    <label index=“pi_flexform.feedTitle“>Titel des RSS-Feeds (Bei RSS-Widget eintragen):</label>
    <label index=“pi_flexform.feedDescription“>Kurzbeschreibung des RSS-Feed (Bei RSS-Widget eintragen):</label>


feedLink

Der Link wird zur Startseite des Blogs generiert. Diese ermitteln wir und generieren daraus den Link mit folgender Befehlszeile am Anfang der renderHeader-Methode:

    $this->conf[‚feedLink‘] =
(stripos(‚http://‘,t3lib_div::getIndpEnv(‚HTTP_HOST’))?’’:’http://’).t3lib_div::getIndpEnv(‘HTTP_HOST’).’/’.tslib_pibase::pi_getPageLink(t3blog_div::getBlogPid(),’’,’’);

feedImage

Ein Bild zum Feed wollen wir nicht anzeigen, deshalb kommentieren wir den Teil zur Generierung des Feed-Bildes im Code aus. Das geschieht in der Methode renderHeader ab Zeile 294.