Weblabor

Manapság sok olyan magyar weblapot látunk, ami rendelkezik hírcsatornával, ezeket viszont kevés felhasználó olvassa, használja. Pedig hasznosak a hírfolyamok, ha nem az átlag internetezőknek, akkor nekünk, fejlesztőknek, mikor más oldalakról akarunk bizonyos tartalmakat kölcsönözni.

Léteznek egymással kapcsolatban lévő intézmények (klubok, egyesületek stb.), melyek szívesen megosztanák egymással híreiket, programajánlójukat, egyebet. (Régebben divat volt az időjárás is.) Ezt legegyszerűbben úgy lehet megvalósítani, ha feldolgozzák egymás hírforrásait. Igen, de milyen a jó feldolgozó? Igényeim a következők voltak:

1. A lehető legtöbb hírfolyamtípust képes legyen feldolgozni,
2. mégis egységes eredményhalmazt adjon vissza, használata során lehetőleg egyáltalán ne kelljen a formátummal foglalkozni;
3. szűrje a tartalmat beállítások szerint (pl. képek, egyes HTML elemek);
4. ha akarom, rendezze az elemeket dátum szerint csökkenő sorrendbe;
5. a dátumokat magyarul, a hét napjaival jelenítse meg;
6. rövidítsen a túl hosszú bevezetőkön, a benne esetleg szereplő HTML elemek helyes lezárásával;
7. lehetőleg egyszerűbb PHP függvényeket használjon, a minél jobb hordozhatóság érdekében.

Nos, olyan feldolgozót nem találtam, ami mindezt tudná, ezért fogtam a fejszét és belevágtam.

A legnagyobb feladatnak a különböző szabványok szerint készült XML dokumentumok egységes struktúrába rendezése látszott, ezért először jó sokat olvastam róluk a Wikipédián és különböző RFC-k között. Számomra úgy tűnik, hogy az RSS 2.0 a legelterjedtebb szabvány, ezért az egységesített struktúra és a változók nevei többnyire ezt követik.

class RssReader
{
    var $title;
    var $link;
    var $description;
    var $lastBuildDate;
    var $pubDate;
    var $ttl;
    var $items;
    var $errors;
    
    private $document;
    private $root;
    private $itemCount;
    
    private $tags1 = array(
        '<a>',      '<ol>', '<h5>',
        '<b>',      '<dl>', '<h6>',
        '<i>',      '<dt>', '<pre>',
        '<u>',      '<dd>', '<span>',
        '<cite>',   '<li>', '<th>',
        '<code>',   '<p>',  '<td>',
        '<q>',      '<h1>', '<tr>',
        '<strong>', '<h2>', '<tbody>',
        '<div>',    '<h3>', '<table>',
        '<ul>',     '<h4>',
    );
    
    private $tags2 = array(
        '</a>',      '</ol>', '</h5>',
        '</b>',      '</dl>', '</h6>',
        '</i>',      '</dt>', '</pre>',
        '</u>',      '</dd>', '</span>',
        '</cite>',   '</li>', '</th>',
        '</code>',   '</p>',  '</td>',
        '</q>',      '</h1>', '</tr>',
        '</strong>', '</h2>', '</tbody>',
        '</div>',    '</h3>', '</table>',
        '</ul>',     '</h4>', 
    );
    
    private $days = array(
        'Vasárnap',
        'Hétfő',
        'Kedd',
        'Szerda',
        'Csütörtök',
        'Péntek',
        'Szombat'
    );
    
    function RssReader()
    {
        $this->errors = array();
        
        if (version_compare(phpversion(), '5.1.0', '>=')) {
            if (!date_default_timezone_set('Europe/Budapest')) {
                $this->errors[] = 'Nem sikerült az időzónát beállítani.';
            }
        }
        
        if (extension_loaded('mbstring') === false) {
            $this->errors[] = 'Nincs betöltve az "mbstring" modul.';
        }
        
        unset($this->document);
        unset($this->root);
        
        $this->document = new DomDocument();
        $this->items    = array();
    }
    
    private function resetAll()
    {
        $this->title         = '';
        $this->link          = '';
        $this->description   = '';
        $this->lastBuildDate = '';
        $this->pubDate       = '';
        $this->ttl           = 60;
        
        unset($this->items);
        $this->errors = array();
        
        $this->itemCount = 0;
    }
    
    function getItemCount()
    {
        return $this->itemCount;
    }
    
    // …
    
}

A hírfolyam egészére vonatkozó mezők:

title

a csatorna címe;

link

általában a forrásweblap főoldalának a címe, ritkábban egy aloldalé vagy a hírfolyamé;

description

a csatorna leírása, sok esetben üres;

lastBuildDate

a hírfolyam utolsó összeállításának ideje (pl. 2011-12-15 Csütörtök, 19:20:58);

pubDate

a hírfolyam közzétételének ideje (sok esetben csak egyik dátumot hozza a folyam, ilyenkor a két változó azonos értékű)

ttl

a csatorna ajánlott frissítési ideje (másodpercben) – sokszor nincs (vagy rosszul van) megadva, jobb, ha mi döntjük el a feldolgozás gyakoriságát.

A hírfolyam majdani elemeinek száma a getItemCount() függvénnyel kérdezhető le.

A konstruktor mindössze beállítja az időzónát (ha a PHP kiadás későbbi, mint 5.1.0), ellenőrzi az mbstring kiterjesztés meglétét (az UTF-8 kódolás miatt szükséges), létrehoz egy DomDocument objektumot, és egyes változókat alaphelyzetbe állít. Ha valami hiba történik – itt és a többi függvénynél is – arról az errors tömbben olvashatunk (magyarul).

Ezután következhet a hírfolyam betöltése fájlból (ha a tartalmat időzítve mentjük egy könyvtárunkba), XML sztringből (ha egy változóba mentettük előzőleg) vagy közvetlenül URL alapján (ha rábízzuk az osztályra a távoli nyitást – ehhez be kell legyen kapcsolva az allow_url_fopen):

function loadFile($filename)
{
    $this->resetAll();
    
    if (!isset($filename) or (!file_exists($filename))) {
        $this->errors[] = 'Nincs megadva fájlnév, vagy a fájl nem létezik.';
        return false;
    }
    
    if ($this->document->load($filename) === false) {
        $this->errors[] = 'Nem sikerült a fájl betöltése, valószínűleg nem megfelelő XML dokumentum.';
        return false;
    }
    
    $this->read();
    
    return true;
}

function loadXml($xml)
{
    $this->resetAll();
    
    if ($this->document->loadXML($xml) === false) {
        $this->errors[] = 'Nem megfelelő a betöltött XML sztring.';
        return false;
    }
    
    $this->read();
    
    return true;
}

function loadUrl($url)
{
    $this->resetAll();
    
    if (!allow_url_fopen) {
        $this->errors[] = 'Nincs engedélyezve a távoli fájlnyitás (allow_url_fopen), így nem lehet URL-ről betölteni.';
        return false;
    }
    
    $xml = file_get_contents($url);
    
    if ($xml === false) {
        $this->errors[] = 'Sikertelen a távoli fájl olvasása a "file_get_contents()" függvénnyel.';
        return false;
    } else {
        return $this->loadXml($xml);
    }
}

Mindhárom függvény false-szal tér vissza sikertelenség esetén, ilyenkor az errors tömböt érdemes megnézni a fent említett módon. Sikeres betöltés után meghívódik a rejtett read() függvény, mely a gyökérelem tagName tulajdonsága alapján eldönti, hogy a dokumentum RSS, Atom vagy RDF típusú, és meghívja az ennek megfelelő feldolgozót:

private function read()
{
    $this->root = $this->document->documentElement;
    
    if ($this->root->tagName == 'rss') {
        $this->readRss();
    }
    
    if ($this->root->tagName == 'feed') {
        $this->readAtom();
    }
    
    if (
           (stristr($this->root->tagName, 'rdf'))
        or (stristr($this->root->tagName, 'RDF'))
    ) {
        $this->readRdf();
    }
}

private function readRss()
{
    $channels = $this->root->getElementsByTagName('channel');
    $channel  = $channels->item(0);
    
    foreach ($channel->getElementsByTagName('title') as $s) {
        if ($s->nodeValue > '') {
            $this->title = htmlspecialchars($s->nodeValue);
            break;
        }
    }
    
    foreach ($channel->getElementsByTagName('link') as $s) {
        if ($s->nodeValue > '') {
            $this->link = $s->nodeValue;
            break;
        }
    }
    
    $this->description = '';
    
    if (isset(
        $channel
        ->getElementsByTagName('description')
        ->item(0)
        ->nodeValue
    )) {
        $this->description =
            $channel
            ->getElementsByTagName('description')
            ->item(0)
            ->nodeValue
        ;
    }
    
    $time = false;
    
    foreach ($channel->getElementsByTagName('lastBuildDate') as $s) {
        if ($s->nodeValue > '') {
            $time = strtotime($s->nodeValue);
            break;
        }
    }
    
    if ($time) {
        $this->lastBuildDate =
              date('Y-m-d ', $time)
            . $this->days[date('w', $time)]
            . date(', H:i:s', $time)
        ;
    } else {
        $this->lastBuildDate = '';
    }
    
    $time = false;
    
    foreach ($channel->getElementsByTagName('pubDate') as $s) {
        if ($s->nodeValue > '') {
            $time = strtotime($s->nodeValue);
            break;
        }
    }
    
    if ($time) {
        $this->pubDate =
              date('Y-m-d ', $time)
            . $this->days[date('w', $time)]
            . date(', H:i:s', $time)
        ;
    } else {
        $this->pubDate = '';
    }
    
    if ($this->pubDate == '') {
        $this->pubDate = $this->lastBuildDate;
    }
    
    if ($this->lastBuildDate == '') {
        $this->lastBuildDate = $this->pubDate;
    }
    
    foreach ($channel->getElementsByTagName('ttl') as $s) {
        if ($s->nodeValue > '') {
            $this->ttl = $s->nodeValue;
            break;
        }
    }
    
    foreach ($channel->getElementsByTagName('item') as $s) {
        $this->items[$this->itemCount]['title'] = '';
        
        if (isset($s->getElementsByTagName('title')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['title'] = htmlspecialchars(
                $s
                ->getElementsByTagName('title')
                ->item(0)
                ->nodeValue
            );
        }
        
        $this->items[$this->itemCount]['link'] = '';
        
        if (isset($s->getElementsByTagName('link')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['link'] =
                $s
                ->getElementsByTagName('link')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->items[$this->itemCount]['author'] = '';
        
        if (isset($s->getElementsByTagName('author')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['author'] =
                $s
                ->getElementsByTagName('author')
                ->item(0)
                ->nodeValue
            ;
        } else if (isset(
            $s
            ->getElementsByTagName('creator')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['author'] =
                $s
                ->getElementsByTagName('creator')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $time = false;
        
        if (isset(
            $s
            ->getElementsByTagName('pubDate')
            ->item(0)
            ->nodeValue
        )) {
            $time = strtotime(
                $s
                ->getElementsByTagName('pubDate')
                ->item(0)
                ->nodeValue
            );
        }
        
        if ($time) {
            $this->items[$this->itemCount]['pubDate'] =
                  date('Y-m-d ', $time)
                . $this->days[date('w', $time)]
                . date(', H:i:s', $time)
            ;
        } else {
            $this->items[$this->itemCount]['pubDate'] = '';
        }
        
        $this->items[$this->itemCount]['comments'] = '';
        
        if (isset(
            $s
            ->getElementsByTagName('comments')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['comments'] =
                $s
                ->getElementsByTagName('comments')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->items[$this->itemCount]['description'] = '';
        
        if (isset(
            $s
            ->getElementsByTagName('description')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['description'] =
                $s
                ->getElementsByTagName('description')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->itemCount++;
    }
}

private function readAtom() {
    $feed = $this->root;
    
    $this->title = '';
    
    if (isset($feed->getElementsByTagName('title')->item(0)->nodeValue)) {
        $this->title = htmlspecialchars(
            $feed
            ->getElementsByTagName('title')
            ->item(0)
            ->nodeValue
        );
    }
    
    foreach ($feed->getElementsByTagName('link') as $s) {
        if (
                (
                        ($s->getAttribute('rel')  == 'alternate')
                    and ($s->getAttribute('type') == 'text/html')
                )
            or  ($s->getAttribute('rel') == 'self')
        ) {
            $this->link = $s->getAttribute('href');
            break;
        }
    }
    
    $this->description = '';
    
    if (isset(
        $feed
        ->getElementsByTagName('subtitle')
        ->item(0)
        ->nodeValue
    )) {
        $this->description = htmlspecialchars(
            $feed
            ->getElementsByTagName('subtitle')
            ->item(0)
            ->nodeValue
        );
    }
    
    $time = false;
    
    if (isset($feed->getElementsByTagName('updated')->item(0)->nodeValue)) {
        $time = strtotime(
            $feed
            ->getElementsByTagName('updated')
            ->item(0)
            ->nodeValue
        );
    }
    
    if ($time) {
        $this->pubDate =
              date('Y-m-d ', $time)
            . $this->days[date('w', $time)]
            . date(', H:i:s', $time)
        ;
    } else {
        $this->pubDate = '';
    }
    
    $this->lastBuildDate = $this->pubDate;
    
    foreach ($feed->getElementsByTagName('entry') as $s) {
        if (isset($s->getElementsByTagName('title')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['title'] = htmlspecialchars(
                $s
                ->getElementsByTagName('title')
                ->item(0)
                ->nodeValue
            );
        } else {
            $this->items[$this->itemCount]['title'] = '';
        }
        
        foreach ($s->getElementsByTagName('link') as $ss) {
            if ($ss->getAttribute('rel') == 'alternate') {
                $this->items[$this->itemCount]['link'] =
                    $ss->getAttribute('href')
                ;
                
                break;
            }
        }
        
        $time = false;
        
        if (isset(
            $s
            ->getElementsByTagName('published')
            ->item(0)
            ->nodeValue
        )) {
            $time = strtotime(
                $s
                ->getElementsByTagName('published')
                ->item(0)
                ->nodeValue
            );
        }
        
        if ($time) {
            $this->items[$this->itemCount]['pubDate'] =
                  date('Y-m-d ', $time)
                . $this->days[date('w', $time)]
                . date(', H:i:s', $time)
            ;
        } else {
            $this->items[$this->itemCount]['pubDate'] = '';
        }
        
        if ($this->items[$this->itemCount]['pubDate'] == '') {
            $time = false;
            
            if (isset(
                $s
                ->getElementsByTagName('updated')
                ->item(0)
                ->nodeValue
            )) {
                $time = strtotime(
                    $s
                    ->getElementsByTagName('updated')
                    ->item(0)
                    ->nodeValue
                );
            }
            
            if ($time) {
                $this->items[$this->itemCount]['pubDate'] =
                      date('Y-m-d ', $time)
                    . $this->days[date('w', $time)]
                    . date(', H:i:s', $time)
                ;
            } else {
                $this->items[$this->itemCount]['pubDate'] = '';
            }
        }
    
        $this->items[$this->itemCount]['author'] = '';
        
        if (isset(
            $s
            ->getElementsByTagName('author')
            ->item(0)
            ->getElementsByTagName('name')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['author'] =
                $s
                ->getElementsByTagName('author')
                ->item(0)
                ->getElementsByTagName('name')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->items[$this->itemCount]['comments']    = '';
        $this->items[$this->itemCount]['description'] = '';
        
        if (isset(
            $s
            ->getElementsByTagName('content')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['description'] =
                $s
                ->getElementsByTagName('content')
                ->item(0)
                ->nodeValue
            ;
        }
        
        if (isset(
            $s
            ->getElementsByTagName('summary')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['description'] .=
                $s
                ->getElementsByTagName('summary')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->itemCount++;
    }
}

private function readRdf() {
    $xmlns = $this->root->getAttribute('xmlns');
    $rdf   = $this->root->getAttribute('xmlns:rdf');
    $dc    = $this->root->getAttribute('xmlns:dc');
    
    if (($xmlns == '') or ($rdf == '') or ($dc == '')) {
        $this->errors[] = 'Nem szabványos RDF dokumentum.';
        return false;
    }
    
    $channel = $this->root->getElementsByTagName('channel')->item(0);
    
    $this->title = '';
    
    if (isset(
        $channel
        ->getElementsByTagName('title')
        ->item(0)
        ->nodeValue
    )) {
        $this->title = htmlspecialchars(
            $channel
            ->getElementsByTagName('title')
            ->item(0)
            ->nodeValue
        );
    }
    
    $this->link = $channel->getAttribute('rdf:about');
    
    if (
            ($this->link == '')
        and (isset($channel->getElementsByTagName('link')->item(0)->nodeValue))
    ) {
        $this->link =
            $channel
            ->getElementsByTagName('link')
            ->item(0)
            ->nodeValue
        ;
    }
    
    $this->description = '';
    
    if (isset(
        $channel
        ->getElementsByTagName('description')
        ->item(0)
        ->nodeValue)
    ) {
        $this->description =
            $channel
            ->getElementsByTagName('description')
            ->item(0)
            ->nodeValue
        ;
    }
    
    $time = false;
    
    if (isset(
        $channel
        ->getElementsByTagNameNS('*','date')
        ->item(0)
        ->nodeValue
    )) {
        $time = strtotime(
            $channel
            ->getElementsByTagNameNS('*','date')
            ->item(0)
            ->nodeValue
        );
    }
    
    if ($time) {
        $this->pubDate =
              date('Y-m-d ', $time)
            . $this->days[date('w', $time)]
            . date(', H:i:s', $time)
        ;
    } else {
        $this->pubDate = '';
    }
    
    $this->lastBuildDate = $this->pubDate;
    
    foreach ($this->root->getElementsByTagName('item') as $s) {
        $this->items[$this->itemCount]['title'] = '';
        
        if (isset($s->getElementsByTagName('title')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['title'] = htmlspecialchars(
                $s
                ->getElementsByTagName('title')
                ->item(0)
                ->nodeValue
            );
        }
        
        $this->items[$this->itemCount]['link'] = '';
        
        if (isset($s->getElementsByTagName('link')->item(0)->nodeValue)) {
            $this->items[$this->itemCount]['link'] =
                $s
                ->getElementsByTagName('link')
                ->item(0)
                ->nodeValue
            ;
        }
        
        if (isset(
            $s
            ->getElementsByTagName('creator')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['author'] =
                $s
                ->getElementsByTagName('creator')
                ->item(0)
                ->nodeValue
            ;
        } else if (isset(
            $s
            ->getElementsByTagName('author')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['author'] =
                $s
                ->getElementsByTagName('author')
                ->item(0)
                ->nodeValue
            ;
        } else {
            $this->items[$this->itemCount]['author'] = '';
        }
        
        $this->items[$this->itemCount]['comments'] = '';
        
        $time = false;
        
        if (isset($s->getElementsByTagName('date')->item(0)->nodeValue)) {
            $time = strtotime(
                $s
                ->getElementsByTagName('date')
                ->item(0)
                ->nodeValue
            );
        }
        
        if ($time) {
            $this->items[$this->itemCount]['pubDate'] =
                  date('Y-m-d ', $time)
                . $this->days[date('w', $time)]
                . date(', H:i:s', $time)
            ;
        } else {
            $this->items[$this->itemCount]['pubDate'] = '';
        }
        
        $this->items[$this->itemCount]['description'] = '';
        
        if (isset(
            $s
            ->getElementsByTagName('description')
            ->item(0)
            ->nodeValue
        )) {
            $this->items[$this->itemCount]['description'] =
                $s
                ->getElementsByTagName('description')
                ->item(0)
                ->nodeValue
            ;
        }
        
        $this->itemCount++;
    }
}

Ekkortól a csatorna teljes hírtartalma elérhető az items tömb elemein keresztül:

title

az elem címe;

link

az elem eredetijének elérhetősége;

pubDate

a közzététel dátuma (ez is magyarul)

author

az elem szerzője (név, de akár e-mail is lehet)

description

a hír szövege, ez sok esetben HTML-t is tartalmaz;

comments

ha az elemhez tartoznak hozzászólások, akkor azok elérhetősége (a Weblabor hírfolyamába például az új fórumtémák kerülnek így).

A betöltés után, ha nem minden elemet akarunk megjeleníteni, javaslom az rsortDate() függvény használatát, mely megfordítja az elemek (pubDate szerinti) sorrendjét:

function rsortDate() {
    for ($n = 0; $n < $this->itemCount - 1; $n++) {
        for ($m = $this->itemCount - 1; $m > 0; $m--) {
            if (
                $this->items[$m]['pubDate']
                >
                $this->items[$m - 1]['pubDate']
            ) {
                $s = $this->items[$m];
                $this->items[$m] = $this->items[$m - 1];
                $this->items[$m - 1] = $s;
            }
        }
    }
}

Kitérnék itt még a a getShortText() függvényre, mely egy elem szövegét rövidítve, szűrve adja vissza:

function getShortText($itemIndex = -1, $length = 0, $allowTags = 'all') {
    $row = chr(13) . chr(10);
    
    if (
           ($itemIndex < 0)
        or ($itemIndex >= $this->itemCount)
        or ($length < 1)
        or (!isset($allowTags))
    ) {
        $this->errors[] = 'Hibás paraméter(ek) a getShortText() függvényben.';
        return false;
    }
    
    $input = $this->items[$itemIndex]['description'];
    $maxlength = mb_strlen(strip_tags($input));
    
    if ($maxlength > $length) {
        $cut    = $length;
        $found  = false;
        $s2     = strip_tags($input);
        $source = mb_substr($s2, $cut, 8);
        
        while ($found === false) {
            $position = mb_strpos($input, $source, $cut - 1);
            
            if ($position === false) {
                $cut += 5;
                
                if ($cut >= $maxlength) {
                    $found = true;
                    $cut   = false;
                    $s1    = $input;
                } else {
                    $source = mb_substr($s2, $cut, 8);
                }
            } else {
                $found = true;
                $s1 = mb_substr($input, 0, $position);
            }
        }
    } else {
        $s1  = $input;
        $cut = false;
    }
    
    if ($allowTags <> 'all') {
        $s2 = strip_tags($s1, $allowTags);
    } else {
        $s2 = $s1;
    }
    
    $position = mb_strrpos($s2, '<');
    
    if ($position >= mb_strlen($s2) - 8) {
        $s2 = mb_substr($s2, 0, $position);
    } else if ($cut) {
        $position = mb_strrpos($s2, ' ');
        $s2       = mb_substr($s2, 0, $position);
        $position = mb_strrpos($s2, '<');
        
        if ($position >= mb_strlen($s2) - 8) {
            $s2 = mb_substr($s2, 0, $position);
        }
    }
    
    if ($cut) {
        $s2 .= '…';
    }
    
    for ($n = 0; $n < count($this->tags1); $n++) {
        $open  = mb_substr_count($s2, $this->tags1[$n], 'utf-8');
        $close = mb_substr_count($s2, $this->tags2[$n], 'utf-8');
        
        if ($open > $close) {
            for ($m = 0; $m < ($open - $close); $m++) {
                $s2 .= $this->tags2[$n] . $row;
            }
        }
    }
    
    return $s2;
}

Paraméterei:

itemIndex

ezen sorszámú elem szövegét fogja használni;

length

a kívánt hossz karakterben;

allowTags

megengedett HTML elemek, ezek maradhatnak a szövegben, a többit kiveszi (ha 'all'-t adunk meg, mindent benthagy).

A length hosszt közelítésekkel keresi a függvény, ebbe nem számítanak bele a címkék, de a szóköz stb. igen; az esetleges entitások, speciális karakterek miatt lehet némi eltérés (kb. 5-12 karakter) a megadott és a tényleges (hasznos) hossz között. Ha a rövidítendő description rövidebb length-nél, akkor nem történik levágás. Egyébként a szöveg szóvégnél lesz elvágva, a függvény pótolja a szükséges záró címkéket, a szöveg végéhez pedig …-t fűz. A címkék számolásához és zárásához a $tags1 és $tags2 rejtett tömböket használja, ezeket bárki kiegészítheti szükség szerint. (Én kb. 30 db, különböző helyről származó hírforrással teszteltem, sikerrel.)

Végül – a példa kedvéért – betöltés után írjunk ki maximum öt elemet, 150 karakter maximális hosszal:

$rss->rsortDate();

if ($rss->getItemCount() > 5) {
    $m = 5;
} else {
    $m = $rss->getItemCount();
}

for ($n = 0; $n < $m; $n++) {
    echo '<div class="feed_item">';
    echo '	<h3><a href="' . $rss->items[$n]['link'] . '">' . $rss->items[$n]['title'] . '</a></h3>';
    echo '	<p><strong>' . $rss->items[$n]['author'] . ' </strong> ' . $rss->items[$n]['pubDate'] . '</p>';
    
    echo $rss->getShortText($n, 150, '<p><i><b><span><strong>');
    
    if ($rss->items[$n]['comments'] > '') {
        echo '	<p><a href="' . $rss->items[$n]['comments'] . '">Hozzászólások</a></p>');
    }
    
    echo "</div>\r\n";
}

Megfontolásra érdemes, hogy egyes webhelyek nem követik azt az ajánlást, miszerint egy hírcsatornában maximum húsz elemet jelenítsenek meg, teljes mérete pedig ne haladja meg a 300 kB-ot. Ez az osztály az egész dokumentumot egyszerre tölti be, ezért a nagyobb méretű hírfolyamok feldolgozása lassú lehet, extrém esetben memóriafoglalási hibát is előidézhet.

Fontos tudni: a hírcsatornák felhasználása nem mindig ingyenes! Minden esetben alaposan járjunk utána, hogy az adott oldal hírcsatornáját milyen feltételekkel használhatjuk fel! Ha az XML dokumentum forrásában nem találunk erre vonatkozó információt, még nem jelenti azt, hogy szabadon felhasználhatjuk. Érdeklődjünk az üzemeltetőnél.

Köszönöm Poetronak a sok hasznos információt, amely segítségével elindultam, Hidvégi Gábornak, aki a készülő osztályt ellenőrizve ellátott ötletekkel a javításhoz, valamint Joó Ádámnak, aki ezt a cikket olvashatóvá varázsolta.

A cikkben bemutatott osztály, és a hírfolyamok közzétételére szolgáló párjának forráskódja egyben letölthető. A bélyegképen a szerző fényképe látható.