In unserer Web-Applikation nach MVC Architektur übernimmt Smarty (Version 2.6.26) die Darstellung. Obwohl es nicht dem MVC-Konzept entspricht, übernimmt Smarty die Erstellung von Excel Reports via PHPExcel. Um in Smarty „native“ PHP Code schreiben zu können, braucht man die {php}…{/php} Anweisungen. Und da diese Code-Blöcke unter Umständen sehr lange werden können wäre es praktisch wenn meine IDE PhpStorm hier PHP Syntax-Highlighting anwenden würde.

Die perfekte Lösung – nämlich das Definieren von {php}…{/php} als Auslöser für das Highlighten analog zu <?php … ?> – habe ich leider nicht gefunden. Aber einen brauchbaren Workaround:

Bei uns haben alle Excel-Exports das Namensschema exportX.inc.tpl, wobei X eine Zahl ist. Das mache ich mir zu Nutze und erweitere in den Einstellungen (CTRL+ALT+S) die registrierten Patterns für PHP Dateien:

Die PHP Code-Blöcke werden allerdings immer noch nicht farbig hervorgehoben dargestellt. Dazu muss man einen kleinen Trick anwenden:

Die {*<?php*} Anweisung in der ersten Zeile „verwirrt“ den PhpStorm Syntax-Highlighter und sorgt dafür, dass PHP Code in der ganzen Datei (!) hervorgehoben dargestellt wird. Die Smarty Template Engine stört sich nicht an dem Tag, weil in Smarty Block-Kommentare mit {* und *} definiert werden.

Wie gesagt, das Problem ist sehr speziell und der Workaround hat auch seine Nachteile (siehe rot unterwellte Bereiche im Screenshot), aber für meine Zwecke perfekt.

Im ersten Schritt müssen Beiträge mit der Kategorie „Martha“, die bei mir die ID 36 hat, im WordPress Loop der index.php ausgeblendet werden. Die ID einer Kategorie kann man beispielsweise erfahren, in dem man im WordPress Admin-Bereich auf Artikel → Kategorien klickt und dann mit der Maus über die gewünschte Kategorie fährt. Der GET-Parameter tag_ID verrät die ID (…&tag_ID=36&…).

In der index.php muss dazu nach der have_posts() Bedingung eine Zeile (bei mir Zeile 3, hängt aber natürlich vom verwendeten Template ab) eingefügt werden. Mit dem Parameter cat=-36 werden Beiträge der Kategorie 36 ausgeschlossen. Wenn man mehrere Kategorien ausschliessen will kann man nach folgendem Schema beispielsweise zusätzlich die Kategorien 3, 6 und 7 ausschliessen: cat=-36,-3,-6,-7.

<?php get_header(); ?>
	<!?php if (have_posts()) : ?>
	    <?php query_posts($query_string . '&cat=-36'); ?>
		<?php while (have_posts()) : the_post(); ?>
		    // Darstellung des Beitrags
		<?php endwhile; ?>
	<?php else : ?>
		// Fehlermeldung, falls das Gesuchte nicht gefunden wurde
	<?php endif; >
	<?php get_sidebar(); >
<?php get_footer(); >

Marthas Beiträge sollen auf einer separaten Seite erscheinen, dazu muss erstmal ein Template erstellt werden. Dazu haben ich die index.php meines Templates kopiert und in blogmartha.php umbenannt. Danach habe ich die Datei im Texteditor bearbeitet und den Header (Zeilen 1 bis 5) ergänzt. Ähnlich wie zuvor muss die Query bearbeitet werden (Zeile 10), diesmal wird keine Kategorie ausgeschlossen sondern explizit nur die Beiträge einer Kategorie (ID 36) geladen.

<?php
/*
Template Name: Blogmartha
*/
?>

<?php get_header(); ?>
	<?php if (have_posts()) : ?>
	    <?php query_posts('cat=36'); ?>
		<?php while (have_posts()) : the_post(); ?>
			// Darstellung des Beitrags
		<?php endwhile; ?>
	<?php else : ?>
		// Fehlermeldung, falls das Gesuchte nicht gefunden wurde
	<?php endif; ?>
	<?php get_sidebar(); ?>
<?php get_footer(); ?>

Der Header ist wichtig für die Identifizierung beim Anlegen der Seite. Dazu geht man im WordPress Admin-Bereich auf Seiten → Erstellen und wählt dort im rechten Bereich unter „Template“ das entsprechende Template (in meinem Fall Blogmartha) aus. Der Inhalt der Seite ist irrelevant, da er nicht dargestellt wird. Als Titel wählt man den in der Navigation gewünschten Titel. Danach publiziert man die Seite.

Als Ergebnis erhält man am WordPress Frontend einen weiteren Eintrag in der Seitennavigation mit dem angegebenen Titel in dem alle Beiträge der eingestellten Kategorie(n) dargestellt werden.

Als zusätzlichen Eye-Catcher habe ich in der Sidebar noch das Plugin/Widget Recent Category Posts positioniert in dem die 5 letzten Beiträge der Kategorie „Martha“ dargestellt werden.

Für meine Zwecke hat es genügt unter General → Appearance → Colors and Fonts im Bereich „Basic“ die „Text Font“ zu ändern. Die Schriftgrösse habe ich nicht geändert, ich finde Consolas ist in Grösse 10 recht gut lesbar.

Gut finde ich, dass Consolas bei gleicher Schriftgrösse nicht so breit wie Courier New ist und dadurch mehr Code pro Zeile lesbar ist (siehe zum Beispiel Zeile 129 oder Zeile 136 im Code oben). Ausserdem empfinde ich das Schriftbild nun als angenehmer und das Programmieren macht noch mehr Spass.

Kurzum: Ich möchte Consolas nicht mehr missen!

Google hat mir bei der Lösung vorerst nicht wirklich geholfen, erst durch Variation des Suchterms stiess ich schliesslich auf diesen Beitrag, bei dem in den Kommentaren die Lösung zu finden war:

function smarty_function_load_file($params, &$smarty) {
    if (empty($params['file'])) {
        $smarty->trigger_error("assign: missing 'file' parameter");
        return;
    }
    else {
        $file = $params['file'];
    }

    // assemble output path here
    // ...

    return $outputPath;
}


Normalerweise wird das load_file plugin im Smarty Template mit folgender Zeile aufgerufen:

<img src="{load_file file='path/to/my/file.gif'}" />


Das folgende Codeschnipsel verwendet die load_file Funktion innerhalb eines anderen Smarty Plugins:

function smarty_function_html_table_row($params, &$smarty) {

    // include the smarty load file plugin
    require_once($smarty->_get_plugin_filepath('function', 'load_file'));

    // some code skipped

    $returnValue .= '<img src="' . smarty_function_load_file(array('file' => 'path/to/my/file.gif'), $smarty) . '" />';

    // even more skipped code

    return $returnValue;
}


Die Magie passiert in Zeile 4, wo das function.load_file.php Plugin geladen wird, und in Zeile 8, in der die Funktion dann aufgerufen wird. Die Parameter werden in Form eines assoziativen Arrays als erster Parameter übergeben. In meinem Fall übergebe ich ‚file‘. Parameter zwei ist das Smarty Objekt, das scheinbar zwingend benötigt wird.
]]>
			/2011/06/smarty-plugin-in-einem-anderen-smarty-plugin-aufrufen/feed/
		0