WordPress: Verzeichnisinhalt listen

Mit PHP kann man sich relativ problemfrei die Dateien eines Verzeichnisses auf dem Webserver listen lassen.
In WordPress kann es auch sinnvoll sein, seinen Authoren die Möglichkeit zu geben den Inhalt eines bestimmten Verzeichnisses zu listen… hier die Möglichkeit ohne PlugIn über die WP-eigene functions.php.

Ziel: In einem Artikel oder einer Seite soll ein Verzeichnis angegeben werden können, dessen Dateien dann automatisch als klickbare Liste in den Artikel integriert werden.
Dabei werden im folgenden Beispiel Unterverzeichnisse und bestimmte Dateitypen aus der Liste ausgenommen.

Hier der PHP-Code der in die functions.php eingefügt werden muß. Diese liegt im Theme-Verzeichnis, sollte es die Datei noch nicht geben, dann kann sie einfach angelegt werden.

// Verlinkte Dateiliste fuer ein vorgegebenes Directory erstellen
function insert_dateiliste ( $article )
{
  // Verzeichnispfad(e) holen
  $suche = '#(?<={dirlist}).*(?={/dirlist})#U';   
  preg_match_all($suche, $article, $verzeichnisse);
    
  if (is_array($verzeichnisse)) {
    foreach ($verzeichnisse[0] as $dirlistitem=>$value) 
    {
      $formatierteliste = "<div id='dateiliste'><ul>";
      $rootpath         = $_SERVER['DOCUMENT_ROOT'];
      $verzeichnispfad  = $rootpath.$value;   
      $dateiliste       = array();
      $name             = array();      
      $kb               = array();
      $datum            = array();
    
      // Dateiliste erstellen... 
      foreach (new DirectoryIterator( $verzeichnispfad ) as $datei)
      {
        if (!$datei->isDir() 
            && !$datei->isDot() 
            && substr($datei,-3)!='php'
            && substr($datei,-3)!='htm'
            && substr($datei,-4)!='html'
            && substr($datei,-3)!='css'
            && substr($datei,-3)!='bak' )
        {
          $dateiliste[] = array( 'name' => $datei->getFilename() , 
                                 'kb' => ceil( $datei->getSize()/1024 ) , 
                                 'datum' => date( 'd.m.Y', $datei->getMTime() ) );        
        }
      }

      // ...und sortieren
      foreach ($dateiliste as $nr => $inhalt)
      {
        $name[$nr]  = strtolower( $inhalt['name']  );
        $kb[$nr]    = strtolower( $inhalt['kb']    );
        $datum[$nr] = strtolower( $inhalt['datum'] );
      }
      array_multisort($name, SORT_ASC, $dateiliste);
    
      // Formatierte Liste aufbauen
      $anzahl = count ( $dateiliste );
      for ($x = 0; $x < $anzahl; $x++)
      {
        if ($zeilenstyle == " class="gerade"" or $zeilenstyle == "" )  
          { $zeilenstyle = " class="ungerade"";
          } else {
            $zeilenstyle = " class="gerade"";
          }
        $formatierteliste .= "<li".$zeilenstyle."><a href="".$value."/".$dateiliste[$x]['name']."" target="_blank">";
        $formatierteliste .= $dateiliste[$x]['name'];
        $formatierteliste .= "</a> (".$dateiliste[$x]['kb']."KB";
        $formatierteliste .= " - ".$dateiliste[$x]['datum'];
        $formatierteliste .= ")</li>";
      }
                 
      $formatierteliste .= "</ul></div>";
      
      $article = str_replace('{dirlist}'.$value.'{/dirlist}', $formatierteliste , $article);

    }
  }  
  return $article;
}
// Filter der die Funktion zum Einsetzen des Dateilisten aktiviert
add_filter('the_content', 'insert_dateiliste', 2);

Einige Erklärungen:
In Zeile 19 bis 25 werden verschiedene Dateitypen sowie Unterverzeichnisse und die Einträge „.“ und „..“ aus der Ergebnisliste gefiltert. Die Funktion hier soll keinen Dateibrowser ersetzen, was auch noch mehr Code verlangen würde.
In Zeile 52 – 55 wird der Listenpunkt zusammengesetzt, hier kann eingegriffen werden um zu entscheiden welche Infos und in welcher Reihenfolge bzw. Form gelistet werden sollen.

Jetzt muß nur noch an gewünschter Stelle im Artikel oder der Seite das Verzeichnis zum auslesen vorgegeben werden. Dabei wird die komplette URL, allerdings ohne Domain angegeben. Das dann in folgendem Syntax

 {dirlist}/wp-content/uploads{/dirlist}

Dieser Eintrag wird dann im Ergebnis durch die Dateiliste ersetzt… Mehrfache Angaben innerhalb eines Artikels/einer Seite sind auch möglich.

Via CSS kann man dann noch die Liste über die eingefügten IDs und Klassen ansprechen und formatieren. Z.B. durch folgenden Eintrag in die Stylesheet-Datei des Themes

li.gerade {
  background-color: #ECECEC;
}