XHTMLCompiler/DOMFilter/News.php

   1 <?php
   2
   3 /**
   4  * Mini blog-style filter for globbing contents of another directory
   5  * and inserting summaries into a main page.
   6  * @note This filter should be run before other "cosmetic" filters, as
   7  *       it makes major changes to page content and may pull data from
   8  *       sources that have not been processed yet.
   9  */
  10 class XHTMLCompiler_DOMFilter_News extends XHTMLCompiler_DOMFilter_NewsBase
  11 {
  12     protected $name = 'News';
  13     protected $prefix = 'news';
  14     protected $xcAttr = array('news');
  15     public function process(DOMDocument $dom, $page, $manager) {
  16         // Remove the semaphore xc:news attribute, and assign to $page
  17         // appropriately
  18         if ($this->confiscateAttr($dom->documentElement, 'xc', 'news')) {
  19             $page->attr['news'] = true;
  20         }
  21
  22         $containers = $this->query("//html:div[@news:source]");
  23         foreach ($containers as $container) {
  24             $this->generateNews($container, $dom, $page, $manager);
  25         }
  26
  27     }
  28
  29     /**
  30      * Generates a particular news container.
  31      */
  32     public function generateNews($container, DOMDocument $dom, $page, $manager) {
  33
  34         // Grab variables
  35         $source = $this->confiscateAttr($container, $this->ns, 'source');
  36         $source = $page->normalizePath($source);
  37         $limit = $this->confiscateAttr($container, $this->ns, 'limit');
  38         if (!$limit) $limit = 5;
  39         $header = $this->confiscateAttr($container, $this->ns, 'header');
  40         if (!$header) $header = 'h2';
  41         $idPrefix = $this->confiscateAttr($container, $this->ns, 'idPrefix');
  42         if (!$idPrefix) $idPrefix = '';
  43         $increase = $header[1] - 1; // amount increase sub-headings
  44
  45         // Recursively glob for source files
  46         // :TODO: add DI for this
  47         $fs = new FSTools();
  48         $result = $fs->globr($source, '*.xhtml');
  49         // This doesn't work if there is more than one entry in a day
  50         rsort($result);
  51
  52         // Setup manager
  53         $xc = XHTMLCompiler::getInstance();
  54         $manager = $xc->getFilterManager();
  55
  56         for ($i = $d = 0, $c = count($result); $i < $c && $d != $limit; $i++) {
  57             $entry = $result[$i];
  58
  59             // :TODO: Add support for nested directories. Also need to modify
  60             // generateId when that happens.
  61             $base = basename($entry);
  62             if (strlen($base) < 4 || !ctype_digit(substr($base, 0, 4))) {
  63                 continue;
  64             }
  65
  66             $entryFile = new XHTMLCompiler_Page($entry);
  67             // This DOM has IDs setup, but no other processing setup.
  68             $subdom = $manager->parse($entryFile->getSource(), $entryFile);
  69
  70             $entryNode = $dom->createElement('div');
  71             $entryNode->setAttribute('class', 'item');
  72
  73             // Generate ID for this entry. The format is
  74             // year-month-date-lc-title-with-dashes
  75             $entryNode->setAttribute('id', $idPrefix . $this->generateId($entryFile->getPathStem()));
  76
  77             // Grab the title
  78             $node = $subdom->getElementsByTagName('h1')->item(0);
  79             $h1 = $dom->importNode($node, true);
  80             $hx = $dom->createElement($header);
  81             $hx->setAttribute('class', 'title');
  82             foreach ($h1->childNodes as $h1node) $hx->appendChild($h1node);
  83             $entryNode->appendChild($hx);
  84
  85             // Possible place for factoring out. Also, we can also add
  86             // a timezone to be more like ours.
  87             $dateTime = $entryFile->getCreatedTime();
  88             if ($dateTime) {
  89                 $entryNode->appendChild($this->makeDateNode($dom, $dateTime));
  90             }
  91
  92             // Grab the content
  93             // :WARNING: This code apparently leaves behind an
  94             // xmlns statement, although we're not quite sure why.
  95             $node = $subdom->getElementById('short-content');
  96             $permText = 'Read more...';
  97             if (!$node) {
  98                 $node = $subdom->getElementById('content');
  99                 $permText = 'Permalink';
 100             }
 101             $node = $dom->importNode($node, true);
 102             $this->confiscateAttr($node, 'id');
 103             $node->setAttribute('class', 'body');
 104             $entryNode->appendChild($node);
 105
 106             // Make permalink
 107             $permalink = $dom->createElement('div');
 108             $permalink->setAttribute('class', 'permalink');
 109             $a = $dom->createElement('a');
 110             $a->setAttribute('href', $entryFile->getAbsolutePath());
 111             $a->appendChild($dom->createTextNode($permText));
 112             $permalink->appendChild($a);
 113             $entryNode->appendChild($permalink);
 114
 115             $container->appendChild($entryNode);
 116
 117             $manager->addDependency($entry);
 118
 119             // increment one successful
 120             $d++;
 121         }
 122     }
 123
 124     /**
 125      * Generates an ID based on the filename of a blog entry
 126      */
 127     public function generateId($entry) {
 128         $parts = array_slice(explode('/', $entry), -2);
 129         // A very specific format: year/monthday-entry-name, like 2008/0131-foobar
 130         // Arbitrary folders before that is ok.
 131         $entry = 'entry-' . $parts[0] .
 132             '-' . substr($parts[1], 0, 2) .
 133             '-' . substr($parts[1], 2, 2) .
 134             '-' . substr($parts[1], 5);
 135         return $entry;
 136     }
 137
 138 }